# library_of_life
`library_of_life` is a Python package that provides a client interface for interacting with the Global Biodiversity Information Facility (GBIF) API. The library is organized into submodules representing different APIs within the GBIF service, making it easy to access various resources related to biodiversity data.
## Table of Contents
- [Installation](#installation)
- [Quick Start](#quick-start)
- [Modules](#modules)
- [Registry](#registry)
- [Species](#species)
- [Occurrence](#occurrences)
- [Maps](#maps)
- [Literature](#literature)
- [Vocabulary](#vocabulary)
- [Caching](#caching)
- [Authentication](#authentication)
- [Contributing](#contributing)
- [Donating$$$](#donating)
- [License](#license)
- [Documentation](#documentation)
## Installation
You can install `library_of_life` via pip:
```bash
pip install library_of_life
```
## Quick Start
Here's a quick example to get you started with `library_of_life`:
```python
from library_of_life.registry.datasets import Datasets
from library_of_life.species.name_usage import NameUsage
# Initialize the Datasets and NameUsage classes
dataset_client = Datasets()
name_usage_client = NameUsage()
# List current datasets matching specified parameters
dataset = dataset_client.list_datasets(dataset_type="SAMPLING_EVENT", limit=10)
print(dataset)
# Return all vernacular species names by a specific usage key
vernacular_names= name_usage_client.get_usage_vernacular_names_by_usage_key(5231190)
print(vernacular_names)
```
## Modules
Each module is composed of separate submodules reflecting the divisions in the GBIF APIs. Within each of these submodules is a class and appropriate methods for accessing the data and resources available for the respective endpoints.
### Registry
For now the registry module only contains the principal methods, but it will be updated in the future to include all of the methods.
#### Submodules
- `datasets`
- `publishing_orgs`
- `participant_nodes`
- `networks`
- `tech_installations`
- `collections`
- `institutions`
- `institutions_and_collections`
- `derived_datasets`
### Species
#### Submodules
- `name_usage`
- `name_search`
- `name_parser`
### Occurrence
#### Submodules
- `single_occurrence`
- `search`
- `downloads`
- `download_format`
- `download_stats`
- `metrics`
- `inventories`
- `gadm_regions`
- `country_usages`
- `organization_usages`
### Maps
#### Submodules
- `maps`
### Literature
#### Submodules
- `literature`
### Vocabulary
#### Submodules
- `vocabularies`
- `concepts`
- `tags`
- `languages`
## Caching
Each class contains an optional caching feature using requests_cache. Simply set use_caching to True when initializing the respective class.
## Authentication
As some features of the GBIF API require authentication (POST, PUT, DETETE methods), this package handles both basic authentication (username and password) and OAuth2 authentication. This is dealt with at the class level. The default is for basic authentication, but if OAuth is desired, simply pass auth_type="OAuth" when initializing the class, as wellas the necessary credentials. Future versions may handle this with a config file.
## Contributing
Contributions are welcome! If you would like to contribute to the development of `library_of_life`, please follow these steps:
1. Fork the repository.
2. Create a new branch (`git checkout -b feature/your-feature`).
3. Commit your changes (`git commit -am 'Add new feature'`).
4. Push to the branch (`git push origin feature/your-feature`).
5. Create a new Pull Request.
## Donating$$$
If you find this project helpful and would like to support its development, consider making a donation.
[Donate via Paypal](https://www.paypal.com/donate/?hosted_button_id=N8HR4SN2J6FPG)
## License
This project is licensed under the MIT License. See the [LCENSE](LICENSE) file for more details.
## Documentation
For more information, read the [docs](#https://library-of-life.readthedocs.io/en/latest/modules.html)
Raw data
{
"_id": null,
"home_page": "https://github.com/SpyderRex/library-of-life",
"name": "library-of-life",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": "API, requests, client, gbif, biodata, biology, life, species",
"author": "Spyder Rex",
"author_email": "billyjohnsonauthor@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/4b/bc/87aa22ac80122e1d145c6eb4dce42d2d7d8d0248f7ad2d46fe86053406b7/library_of_life-0.4.2.tar.gz",
"platform": null,
"description": "# library_of_life\n`library_of_life` is a Python package that provides a client interface for interacting with the Global Biodiversity Information Facility (GBIF) API. The library is organized into submodules representing different APIs within the GBIF service, making it easy to access various resources related to biodiversity data.\n\n## Table of Contents\n\n- [Installation](#installation)\n- [Quick Start](#quick-start)\n- [Modules](#modules)\n - [Registry](#registry)\n - [Species](#species)\n - [Occurrence](#occurrences)\n - [Maps](#maps)\n - [Literature](#literature)\n - [Vocabulary](#vocabulary)\n- [Caching](#caching)\n- [Authentication](#authentication)\n- [Contributing](#contributing)\n- [Donating$$$](#donating)\n- [License](#license)\n- [Documentation](#documentation)\n\n## Installation\n\nYou can install `library_of_life` via pip:\n\n```bash\npip install library_of_life\n```\n\n## Quick Start\n\nHere's a quick example to get you started with `library_of_life`:\n\n```python\nfrom library_of_life.registry.datasets import Datasets\nfrom library_of_life.species.name_usage import NameUsage\n\n# Initialize the Datasets and NameUsage classes\ndataset_client = Datasets()\nname_usage_client = NameUsage()\n\n# List current datasets matching specified parameters\ndataset = dataset_client.list_datasets(dataset_type=\"SAMPLING_EVENT\", limit=10)\nprint(dataset)\n\n# Return all vernacular species names by a specific usage key\nvernacular_names= name_usage_client.get_usage_vernacular_names_by_usage_key(5231190)\nprint(vernacular_names)\n```\n\n## Modules\n\nEach module is composed of separate submodules reflecting the divisions in the GBIF APIs. Within each of these submodules is a class and appropriate methods for accessing the data and resources available for the respective endpoints.\n\n### Registry\n\nFor now the registry module only contains the principal methods, but it will be updated in the future to include all of the methods.\n\n#### Submodules\n\n- `datasets`\n- `publishing_orgs`\n- `participant_nodes`\n- `networks`\n- `tech_installations`\n- `collections`\n- `institutions`\n- `institutions_and_collections`\n- `derived_datasets`\n\n### Species\n\n#### Submodules\n\n- `name_usage`\n- `name_search`\n- `name_parser`\n\n### Occurrence\n\n#### Submodules\n\n- `single_occurrence`\n- `search`\n- `downloads`\n- `download_format`\n- `download_stats`\n- `metrics`\n- `inventories`\n- `gadm_regions`\n- `country_usages`\n- `organization_usages`\n\n### Maps\n\n#### Submodules\n\n- `maps`\n\n### Literature\n\n#### Submodules\n\n- `literature`\n\n### Vocabulary\n\n#### Submodules\n\n- `vocabularies`\n- `concepts`\n- `tags`\n- `languages`\n\n## Caching\n\nEach class contains an optional caching feature using requests_cache. Simply set use_caching to True when initializing the respective class.\n\n## Authentication\n\nAs some features of the GBIF API require authentication (POST, PUT, DETETE methods), this package handles both basic authentication (username and password) and OAuth2 authentication. This is dealt with at the class level. The default is for basic authentication, but if OAuth is desired, simply pass auth_type=\"OAuth\" when initializing the class, as wellas the necessary credentials. Future versions may handle this with a config file.\n\n## Contributing\n\nContributions are welcome! If you would like to contribute to the development of `library_of_life`, please follow these steps:\n\n1. Fork the repository.\n2. Create a new branch (`git checkout -b feature/your-feature`).\n3. Commit your changes (`git commit -am 'Add new feature'`).\n4. Push to the branch (`git push origin feature/your-feature`).\n5. Create a new Pull Request.\n\n## Donating$$$\n\nIf you find this project helpful and would like to support its development, consider making a donation.\n\n[Donate via Paypal](https://www.paypal.com/donate/?hosted_button_id=N8HR4SN2J6FPG)\n\n## License\n\nThis project is licensed under the MIT License. See the [LCENSE](LICENSE) file for more details.\n\n## Documentation\nFor more information, read the [docs](#https://library-of-life.readthedocs.io/en/latest/modules.html)\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A python client for the Global Biological Information Facility (GBIF) API",
"version": "0.4.2",
"project_urls": {
"Homepage": "https://github.com/SpyderRex/library-of-life",
"Repository": "https://github.com/SpyderRex/library-of-life"
},
"split_keywords": [
"api",
" requests",
" client",
" gbif",
" biodata",
" biology",
" life",
" species"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "79fd0499cdc10edb28e2d84fccebb1144b6ee089d8ad6bacc9c1fa111b2b8940",
"md5": "db439fb4a1e780e1e259d3073deff698",
"sha256": "21cbe809d9307e4f9324a6224f12c79307ae30f98e5dbce7f46a2ca3facd627c"
},
"downloads": -1,
"filename": "library_of_life-0.4.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "db439fb4a1e780e1e259d3073deff698",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 80251,
"upload_time": "2024-06-16T00:11:29",
"upload_time_iso_8601": "2024-06-16T00:11:29.804992Z",
"url": "https://files.pythonhosted.org/packages/79/fd/0499cdc10edb28e2d84fccebb1144b6ee089d8ad6bacc9c1fa111b2b8940/library_of_life-0.4.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4bbc87aa22ac80122e1d145c6eb4dce42d2d7d8d0248f7ad2d46fe86053406b7",
"md5": "699f8a260a3d59f442fada991cfe64ae",
"sha256": "466691b8087ec7f886ee939d5d56d9396c5c99aaeac624ed8340f2fa5c581a01"
},
"downloads": -1,
"filename": "library_of_life-0.4.2.tar.gz",
"has_sig": false,
"md5_digest": "699f8a260a3d59f442fada991cfe64ae",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 49850,
"upload_time": "2024-06-16T00:11:31",
"upload_time_iso_8601": "2024-06-16T00:11:31.643981Z",
"url": "https://files.pythonhosted.org/packages/4b/bc/87aa22ac80122e1d145c6eb4dce42d2d7d8d0248f7ad2d46fe86053406b7/library_of_life-0.4.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-16 00:11:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SpyderRex",
"github_project": "library-of-life",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "sphinx",
"specs": [
[
"==",
"7.2.6"
]
]
},
{
"name": "sphinx-rtd-theme",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "requests-cache",
"specs": [
[
"==",
"1.2.0"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.31.0"
]
]
},
{
"name": "pillow",
"specs": [
[
"==",
"10.2.0"
]
]
}
],
"lcname": "library-of-life"
}
JSON
