|
1 | 1 | # PyWormbase |
2 | | -This package is an interface to the WormBase REST API. You can use it in your Python programs to retrieve data from the WormBase API without needing to learn the details of REST API interactions. The function names are intelligent and documentation is provided. This package is targeted toward Wormbase users who want to get data from Wormbase faster than using the web site. |
| 2 | +This package is an interface to the WormBase ParaSite REST API. You can use it in your Python programs to retrieve data from the WormBase API without needing to learn the details of REST API interactions. The function names are intelligent and documentation is provided. This package is targeted toward Wormbase users who want to get data from Wormbase faster than using the web site. |
3 | 3 |
|
4 | 4 | ## Installation |
5 | | -Coming soon! |
6 | | -<!-- Installation is simple with `pip`. Simply run |
| 5 | +Installation is simple with `pip`. Simply run |
7 | 6 |
|
8 | 7 | ```Python |
9 | 8 | > pip install pywormbase |
10 | 9 | ``` |
11 | 10 |
|
12 | | -to retrieve this package from the PyPI package index. --> |
| 11 | +to retrieve this package from the PyPI package index. |
13 | 12 |
|
14 | 13 | ## Usage |
15 | | -Wormbase's API is free and open. No credentials, keys, or tokens are needed to access it. This makes PyWormbase easy to use in scripts, too. First, import PyWormbase, then instantiate a PyWormbase object: |
| 14 | +Wormbase's API is free and open. No credentials, keys, or tokens are needed to access it. This makes PyWormbase easy to use in scripts, too. First, import PyWormbase, then instantiate a WormbaseClient object: |
16 | 15 |
|
17 | 16 | ```Python |
18 | 17 | >>> import pywormbase |
19 | 18 | >>> api = pywormbase.WormbaseClient() |
20 | 19 | ``` |
21 | 20 |
|
22 | | -A `WormbaseClient` object will have a variety of member functions that provide access to Wormbase API endpoints. You can use `dir(api)` to see all functions available (or read the associated documentation in `docs`). |
| 21 | +A `WormbaseClient` object will have a variety of member functions that provide access to Wormbase API endpoints. You can use `dir(api)` to see all functions available (or read the associated documentation in the Github wiki). |
23 | 22 |
|
24 | 23 | ## Support |
25 | 24 | If you use PyWormbase and are experiencing problems with the package, or if you have a request for an additional feature, please file an issue at https://github.com/c-anna/PyWormbase/issues. |
26 | 25 |
|
| 26 | +A note: `PyWormbase` is a wrapper around the WormBase ParaSite REST API. This API is subject to change and so both the content and format of the responses may change infrequently. While every effort will be made to keep this package aligned with the output of the REST API, it is still possible for scripts relying on this package to change their execution results even if no code changes were made. If you use `PyWormbase` and notice a change in a function's execution, please open an issue on Github. |
| 27 | + |
27 | 28 | ## License |
28 | | -PyWormbase is free and open-source, licensed under the MIT license. If you are using this software academically or professionally, please acknowledge this package and my Github page, https://github.com/c-anna, somewhere in your final product. |
| 29 | +PyWormbase is free and open-source, licensed under the MIT license. If you are using this software academically or professionally, please acknowledge this package and my Github page, https://github.com/c-anna, somewhere in your final product. |
| 30 | + |
| 31 | +``` |
| 32 | + . . . . . . . |
| 33 | + . . _.-/`/`'-._ |
| 34 | + . Thanks for using!. /_..--''''_-' |
| 35 | + . PyWormbase! . // \ |
| 36 | + . . . . .` //-.__\_\.-' |
| 37 | + `..' _\\\// --.___ // ___.---.._ |
| 38 | + _- /@/@\ \ ||`` `-_ |
| 39 | + .' ,\_\_/ | \_||_/ ,-._ `. |
| 40 | + ; { o / } "" `-._`. ; |
| 41 | + ; `-==-' / \_| ; |
| 42 | + | |>o<| }@@@} | |
| 43 | + | <(___<) }@@@@} | |
| 44 | + | <(___<) }@@@@@} | |
| 45 | + | <\___<) \_.?@@} | |
| 46 | + ; V`--V`__./@} ; |
| 47 | + \ tx ooo@} / |
| 48 | + \ / |
| 49 | + `. .' |
| 50 | + `-._ _.-' |
| 51 | + ``------'''''''''------`` |
| 52 | +``` |
| 53 | + |
0 commit comments