<img src="https://raw.githubusercontent.com/centrebalearbiodiversitat/biodumpy/refs/heads/master/docs/source/static/Biodumpy_logo.png" alt="Project Logo" width="200">
# biodumpy: A Comprehensive Biological Data Downloader
## Overview
``biodumpy`` is a powerful and versatile Python package designed to simplify the process of retrieving biological information from several public databases. With ``biodumpy``, researchers can easily download and manage data from multiple sources, ensuring access to the most up to date and comprehensive biological information available.
> **Note:** This package is currently under development.
## Key Features
``biodumpy`` offers dedicated modules for each supported database, with each module featuring functions specifically designed for retrieving information from its respective source. The modules implemented so far are:
- Barcode of life data system v4 (BOLD)
- Catalogue of life (COL)
- Crossref
- Global biodiversity information facility (GBIF)
- iNaturalist
- International union for the conservation of nature (IUCN)
- National center for biotechnology information (NCBI)
- Ocean biodiversity information system (OBIS)
- World register of marine species (WoRMS)
- ZooBank
This list can be expanded, thus suggestions and feedback are greatly appreciated.
## Main functionalities and workflow
Before using ``biodumpy``, users need to install the package in their Python environment with the following command:
```
pip install biodumpy
```
### Usage
To simplify the use of ``biodumpy``, we create a general structure common among the modules:
1) **Load the package.** Import ``biodumpy`` into your Python environment.
2) **Load the desired modules.** Import one or more specific modules needed to retrieve the data.
3) **Set up the configuration of one or more modules.** Configure the ``biodumpy`` function/s with the required parameters.
4) **Start the download.** Execute the function to begin retrieving the data.
Here, we provide two examples illustrating the general structure of a ``biodumpy`` script:
In detail, we described:
- **Single Module Example**: This example demonstrates how to use a single ``biodumpy`` module (for example, GBIF).
- **Multiple Modules Example**: This example shows how to use multiple ``biodumpy`` modules (for example, GBIF and IUCN).
**Example N.1**
``` python
# Import biodumpy package
from biodumpy import Biodumpy
# Import GBIF module
from biodumpy.inputs import GBIF
# Create a list of taxa
taxa = ['Alytes muletensis (Sanchíz & Adrover, 1979)', 'Bufotes viridis (Laurenti, 1768)',
'Hyla meridionalis Boettger, 1874', 'Anax imperator Leach, 1815']
# Set the Biodumpy function with the specific parameters
bdp = Biodumpy([GBIF(sleep=3, bulk=False, accepted_only=True)])
# Start the download
bdp.start(taxa, output_path='./downloads/{date}/{module}/{name}')
```
**Example N.2**
``` python
# Import biodumpy package
from biodumpy import Biodumpy
# Import GBIF and IUCN modules
from biodumpy.inputs import GBIF, IUCN
api_key = 'YOUR_IUCN_API_KEY'
# Create a list of taxa
taxa = ['Alytes muletensis', 'Bufotes viridis', 'Hyla meridionalis', 'Anax imperator']
# Set the Biodumpy functions with the specific parameters
bdp = Biodumpy([GBIF(bulk=False, accepted_only=True),
IUCN(api_key=api_key, bulk=True, region=['Global'])])
# Start the download
bdp.start(taxa, output_path='./downloads/{date}/{module}/{name}')
```
## Documentation and Support
For detailed documentation and tutorials, please visit the ``biodumpy`` Read the Docs documentation.
## Contribution
``biodumpy`` is an open-source project, and contributions are welcome!
If you have ideas for new features, bug fixes, or improvements, please submit an issue or pull request in our GitHub repository or contact with the support team
[✉️ here](mailto:t.cancellario@uib.eu?subject=biodumpy_support).
## License
``biodumpy`` is licensed under the MIT License for its software components. Additionally, any creative works associated with this project—such as documentation, visual assets, or other non-code materials—are licensed under the Creative Commons Attribution (CC BY 4.0) license. See the [LICENSE](LICENSE.md) file for full details.
## Acknowledgments
The project is developed by the "Centre Balear de Biodiversitat" (CBB) at the University of the Balearic Islands, with support from MCIN and funding from the European Union—NextGenerationEU (PRTR-C17.I1), as well as the Government of the Balearic Islands.
<hr>
<div style="display: flex; justify-content: center">
<img src='https://raw.githubusercontent.com/centrebalearbiodiversitat/biodumpy/refs/heads/master/docs/source/static/founding.png' alt='logo_cbb' width='200'>
</div>
Raw data
{
"_id": null,
"home_page": "https://github.com/centrebalearbiodiversitat/biodumpy",
"name": "biodumpy",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "biodiversity, data, ecology, science, genetics, download, wrapper, bibliography",
"author": "Cancellario, T.; Golomb, T.; Rold\u00e1n, A.; Far, A.",
"author_email": "t.cancellario@uib.eu",
"download_url": "https://files.pythonhosted.org/packages/2e/b1/51f28b11630a30468e416296bfda5d407346b61f1cde1a3cf5f80a6d829f/biodumpy-0.1.8.tar.gz",
"platform": null,
"description": "<img src=\"https://raw.githubusercontent.com/centrebalearbiodiversitat/biodumpy/refs/heads/master/docs/source/static/Biodumpy_logo.png\" alt=\"Project Logo\" width=\"200\">\n\n# biodumpy: A Comprehensive Biological Data Downloader\n\n\n\n\n\n\n\n## Overview\n``biodumpy`` is a powerful and versatile Python package designed to simplify the process of retrieving biological information from several public databases. With ``biodumpy``, researchers can easily download and manage data from multiple sources, ensuring access to the most up to date and comprehensive biological information available.\n\n> **Note:** This package is currently under development.\n\n\n## Key Features\n``biodumpy`` offers dedicated modules for each supported database, with each module featuring functions specifically designed for retrieving information from its respective source. The modules implemented so far are:\n\n- Barcode of life data system v4 (BOLD)\n- Catalogue of life (COL)\n- Crossref\n- Global biodiversity information facility (GBIF)\n- iNaturalist\n- International union for the conservation of nature (IUCN)\n- National center for biotechnology information (NCBI)\n- Ocean biodiversity information system (OBIS)\n- World register of marine species (WoRMS)\n- ZooBank\n\nThis list can be expanded, thus suggestions and feedback are greatly appreciated.\n\n\n## Main functionalities and workflow\nBefore using ``biodumpy``, users need to install the package in their Python environment with the following command:\n\n```\npip install biodumpy\n```\n\n### Usage\nTo simplify the use of ``biodumpy``, we create a general structure common among the modules:\n\n1) **Load the package.** Import ``biodumpy`` into your Python environment.\n2) **Load the desired modules.** Import one or more specific modules needed to retrieve the data.\n3) **Set up the configuration of one or more modules.** Configure the ``biodumpy`` function/s with the required parameters.\n4) **Start the download.** Execute the function to begin retrieving the data.\n\nHere, we provide two examples illustrating the general structure of a ``biodumpy`` script:\n\nIn detail, we described:\n- **Single Module Example**: This example demonstrates how to use a single ``biodumpy`` module (for example, GBIF).\n- **Multiple Modules Example**: This example shows how to use multiple ``biodumpy`` modules (for example, GBIF and IUCN).\n\n**Example N.1**\n\n``` python\n\n # Import biodumpy package\n from biodumpy import Biodumpy\n\n # Import GBIF module\n from biodumpy.inputs import GBIF\n\n # Create a list of taxa\n taxa = ['Alytes muletensis (Sanch\u00edz & Adrover, 1979)', 'Bufotes viridis (Laurenti, 1768)',\n 'Hyla meridionalis Boettger, 1874', 'Anax imperator Leach, 1815']\n\n # Set the Biodumpy function with the specific parameters\n bdp = Biodumpy([GBIF(sleep=3, bulk=False, accepted_only=True)])\n\n # Start the download\n bdp.start(taxa, output_path='./downloads/{date}/{module}/{name}')\n```\n\n**Example N.2**\n\n``` python\n\n # Import biodumpy package\n from biodumpy import Biodumpy\n\n # Import GBIF and IUCN modules\n from biodumpy.inputs import GBIF, IUCN\n\n api_key = 'YOUR_IUCN_API_KEY'\n\n # Create a list of taxa\n taxa = ['Alytes muletensis', 'Bufotes viridis', 'Hyla meridionalis', 'Anax imperator']\n\n # Set the Biodumpy functions with the specific parameters\n bdp = Biodumpy([GBIF(bulk=False, accepted_only=True),\n IUCN(api_key=api_key, bulk=True, region=['Global'])])\n\n # Start the download\n bdp.start(taxa, output_path='./downloads/{date}/{module}/{name}')\n```\n\n## Documentation and Support\nFor detailed documentation and tutorials, please visit the ``biodumpy`` Read the Docs documentation.\n\n\n## Contribution\n``biodumpy`` is an open-source project, and contributions are welcome! \nIf you have ideas for new features, bug fixes, or improvements, please submit an issue or pull request in our GitHub repository or contact with the support team\n[\u2709\ufe0f here](mailto:t.cancellario@uib.eu?subject=biodumpy_support).\n\n\n## License\n``biodumpy`` is licensed under the MIT License for its software components. Additionally, any creative works associated with this project\u2014such as documentation, visual assets, or other non-code materials\u2014are licensed under the Creative Commons Attribution (CC BY 4.0) license. See the [LICENSE](LICENSE.md) file for full details.\n\n\n## Acknowledgments\nThe project is developed by the \"Centre Balear de Biodiversitat\" (CBB) at the University of the Balearic Islands, with support from MCIN and funding from the European Union\u2014NextGenerationEU (PRTR-C17.I1), as well as the Government of the Balearic Islands.\n\n\n<hr>\n<div style=\"display: flex; justify-content: center\">\n<img src='https://raw.githubusercontent.com/centrebalearbiodiversitat/biodumpy/refs/heads/master/docs/source/static/founding.png' alt='logo_cbb' width='200'>\n</div>\n\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "A Comprehensive Biological Data Downloader.",
"version": "0.1.8",
"project_urls": {
"Documentation": "https://biodumpy.readthedocs.io/",
"Homepage": "https://github.com/centrebalearbiodiversitat/biodumpy",
"Issue Tracker": "https://github.com/centrebalearbiodiversitat/cbbdb/issues"
},
"split_keywords": [
"biodiversity",
" data",
" ecology",
" science",
" genetics",
" download",
" wrapper",
" bibliography"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5fa6d15b947d8ba2b19bdf9dbe2828de107d1e57b91188320c4369bc6da87ef9",
"md5": "bcc38e12445cd10d38882ad9da149612",
"sha256": "da4520c6374293aa42e6e34bf985c3c79ea272048102b9204e6d4c80689b11ff"
},
"downloads": -1,
"filename": "biodumpy-0.1.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bcc38e12445cd10d38882ad9da149612",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 53305,
"upload_time": "2025-10-24T13:37:07",
"upload_time_iso_8601": "2025-10-24T13:37:07.806364Z",
"url": "https://files.pythonhosted.org/packages/5f/a6/d15b947d8ba2b19bdf9dbe2828de107d1e57b91188320c4369bc6da87ef9/biodumpy-0.1.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2eb151f28b11630a30468e416296bfda5d407346b61f1cde1a3cf5f80a6d829f",
"md5": "cd23ed23e1558470177ee4cc0d6c1a7d",
"sha256": "5956de9b263e4f381ace0d0f69da128b0b80d0635cfa68dad9a4b33190fab75b"
},
"downloads": -1,
"filename": "biodumpy-0.1.8.tar.gz",
"has_sig": false,
"md5_digest": "cd23ed23e1558470177ee4cc0d6c1a7d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 39631,
"upload_time": "2025-10-24T13:37:09",
"upload_time_iso_8601": "2025-10-24T13:37:09.052026Z",
"url": "https://files.pythonhosted.org/packages/2e/b1/51f28b11630a30468e416296bfda5d407346b61f1cde1a3cf5f80a6d829f/biodumpy-0.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-24 13:37:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "centrebalearbiodiversitat",
"github_project": "biodumpy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "biopython",
"specs": []
},
{
"name": "numpy",
"specs": [
[
"==",
"1.26.4"
]
]
},
{
"name": "tqdm",
"specs": [
[
"==",
"4.66.4"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.32.3"
]
]
},
{
"name": "pandas",
"specs": [
[
"==",
"2.2.2"
]
]
},
{
"name": "beautifulsoup4",
"specs": [
[
"==",
"4.12.3"
]
]
},
{
"name": "pytest",
"specs": [
[
"==",
"8.3.2"
]
]
}
],
"lcname": "biodumpy"
}
JSON
