{"id":13724561,"url":"https://github.com/ghislainv/pywdpa","last_synced_at":"2025-10-29T15:49:21.660Z","repository":{"id":53802132,"uuid":"237216231","full_name":"ghislainv/pywdpa","owner":"ghislainv","description":"📦🐍 pywda Python package for simple access to world's protected areas","archived":false,"fork":false,"pushed_at":"2024-09-03T22:48:07.000Z","size":3976,"stargazers_count":7,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-22T03:37:07.128Z","etag":null,"topics":["api","country-iso-code","protected-areas","protected-planet","python-package","shapefiles","wdpa","world"],"latest_commit_sha":null,"homepage":"https://ecology.ghislainv.fr/pywdpa","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ghislainv.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.rst","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-01-30T13:13:37.000Z","updated_at":"2024-08-16T07:02:55.000Z","dependencies_parsed_at":"2024-06-13T04:18:05.791Z","dependency_job_id":"12a1ca55-b2c5-4da9-8903-e2cb6ff5a92e","html_url":"https://github.com/ghislainv/pywdpa","commit_stats":{"total_commits":91,"total_committers":1,"mean_commits":91.0,"dds":0.0,"last_synced_commit":"359dc9992727aee9d81a2dc1b091e5202b4994fe"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/ghislainv/pywdpa","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghislainv%2Fpywdpa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghislainv%2Fpywdpa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghislainv%2Fpywdpa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghislainv%2Fpywdpa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ghislainv","download_url":"https://codeload.github.com/ghislainv/pywdpa/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghislainv%2Fpywdpa/sbom","scorecard":{"id":425732,"data":{"date":"2025-08-11","repo":{"name":"github.com/ghislainv/pywdpa","commit":"359dc9992727aee9d81a2dc1b091e5202b4994fe"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.5,"checks":[{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 0/19 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/github-pages.yml:1","Warn: no topLevel permission defined: .github/workflows/python-package.yml:1","Warn: no topLevel permission defined: .github/workflows/wheel-pypi.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github-pages.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/github-pages.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github-pages.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/github-pages.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github-pages.yml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/github-pages.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/python-package.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/python-package.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/python-package.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/python-package.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/wheel-pypi.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/wheel-pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/wheel-pypi.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/wheel-pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/wheel-pypi.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/wheel-pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/wheel-pypi.yml:52: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/wheel-pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/wheel-pypi.yml:60: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/wheel-pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/wheel-pypi.yml:61: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/wheel-pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/wheel-pypi.yml:71: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/wheel-pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/wheel-pypi.yml:80: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/wheel-pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/wheel-pypi.yml:88: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/wheel-pypi.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/wheel-pypi.yml:107: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/wheel-pypi.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/wheel-pypi.yml:111: update your workflow using https://app.stepsecurity.io/secureworkflow/ghislainv/pywdpa/wheel-pypi.yml/master?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/github-pages.yml:29","Warn: pipCommand not pinned by hash: .github/workflows/github-pages.yml:31","Warn: pipCommand not pinned by hash: .github/workflows/github-pages.yml:35","Warn: pipCommand not pinned by hash: .github/workflows/github-pages.yml:36","Warn: pipCommand not pinned by hash: .github/workflows/github-pages.yml:37","Warn: pipCommand not pinned by hash: .github/workflows/github-pages.yml:38","Warn: pipCommand not pinned by hash: .github/workflows/python-package.yml:31","Warn: pipCommand not pinned by hash: .github/workflows/python-package.yml:32","Warn: pipCommand not pinned by hash: .github/workflows/python-package.yml:34","Warn: pipCommand not pinned by hash: .github/workflows/python-package.yml:38","Warn: pipCommand not pinned by hash: .github/workflows/python-package.yml:39","Warn: pipCommand not pinned by hash: .github/workflows/python-package.yml:40","Warn: pipCommand not pinned by hash: .github/workflows/wheel-pypi.yml:48","Warn: pipCommand not pinned by hash: .github/workflows/wheel-pypi.yml:67","Warn: pipCommand not pinned by hash: .github/workflows/wheel-pypi.yml:86","Warn: pipCommand not pinned by hash: .github/workflows/wheel-pypi.yml:87","Info:   0 out of  14 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 third-party GitHubAction dependencies pinned","Info:   0 out of  16 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU General Public License v3.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":0,"reason":"13 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2019-241","Warn: Project is vulnerable to: PYSEC-2018-34 / GHSA-2fc2-6r4j-p65h","Warn: Project is vulnerable to: PYSEC-2021-856 / GHSA-5545-2q6w-2gh6","Warn: Project is vulnerable to: PYSEC-2019-108 / GHSA-9fq2-x9r6-wfmf","Warn: Project is vulnerable to: PYSEC-2018-33 / GHSA-cw6w-4rcx-xphc","Warn: Project is vulnerable to: PYSEC-2021-857 / GHSA-f7c7-j99h-c22f","Warn: Project is vulnerable to: GHSA-fpfv-jqm9-f5jm","Warn: Project is vulnerable to: PYSEC-2017-1 / GHSA-frgw-fgh6-9g52","Warn: Project is vulnerable to: PYSEC-2014-14 / GHSA-652x-xj99-gmcc","Warn: Project is vulnerable to: GHSA-9hjg-9r4m-mvj7","Warn: Project is vulnerable to: GHSA-9wx4-h78v-vm56","Warn: Project is vulnerable to: PYSEC-2014-13 / GHSA-cfj3-7x9c-4p3h","Warn: Project is vulnerable to: PYSEC-2018-28 / GHSA-x84v-xcm2-53pg"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 19 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-19T02:11:28.662Z","repository_id":53802132,"created_at":"2025-08-19T02:11:28.662Z","updated_at":"2025-08-19T02:11:28.662Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281397336,"owners_count":26493908,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-28T02:00:06.022Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","country-iso-code","protected-areas","protected-planet","python-package","shapefiles","wdpa","world"],"created_at":"2024-08-03T01:01:59.393Z","updated_at":"2025-10-29T15:49:21.620Z","avatar_url":"https://github.com/ghislainv.png","language":"Python","funding_links":[],"categories":["Biosphere"],"sub_categories":["Conservation and Restoration"],"readme":"..\n   # ==============================================================================\n   # author          :Ghislain Vieilledent\n   # email           :ghislain.vieilledent@cirad.fr, ghislainv@gmail.com\n   # web             :https://ecology.ghislainv.fr\n   # license         :GPLv3\n   # ==============================================================================\n\n.. image:: https://ecology.ghislainv.fr/pywdpa/_static/logo-pywdpa.svg\n   :align: right\n   :target: https://ecology.ghislainv.fr/pywdpa\n   :alt: Logo pywdpa\n   :width: 140px\n\t   \n``pywdpa`` Python package\n*************************\n\n\n|Python version| |PyPI version| |GitHub Actions| |License| |Zenodo|\n\n\nOverview\n========\n\nThe ``pywdpa`` Python package is an interface to the World Database on\nProtected Areas (WDPA) hosted on the Protected Planet website at\n`\u003chttps://www.protectedplanet.net\u003e`_. The ``pywdpa`` package provides\nfunctions to download shapefiles of protected areas (PA) for any\ncountries with an iso3 code using the Protected Planet API at\n`\u003chttps://api.protectedplanet.net\u003e`_. The ``pywdpa`` package\ntranslates some functions of the R package ``worldpa``\n(`\u003chttps://github.com/FRBCesab/worldpa\u003e`_) in the Python language.\n\n.. image:: https://ecology.ghislainv.fr/pywdpa/_static/banner_pywdpa.png\n   :align: center\n   :target: https://ecology.ghislainv.fr/pywdpa\n   :alt: protected-planet\n\nTerms and conditions\n====================\n\nYou must ensure that the following citation is always clearly\nreproduced in any publication or analysis involving the Protected\nPlanet Materials in any derived form or format:\n\n..\n   \n    UNEP-WCMC and IUCN (\\ ``YEAR``\\ ) Protected Planet: The World\n    Database on Protected Areas (WDPA). Cambridge, UK: UNEP-WCMC and\n    IUCN. Available at: www.protectedplanet.net (dataset downloaded the\n    ``YEAR/MONTH``\\ ).\n\n\nFor further details on terms and conditions of the WDPA usage, please\nvisit the page: `\u003chttps://www.protectedplanet.net/en/legal\u003e`_.\n\nPrerequisites\n=============\n\nAccess to Protected Planet API\n------------------------------\n\nThis package uses the Protected Planet API to access data on world\nprotected areas. You must first have obtained a Personal API Token by\nfilling in the form available at\n`\u003chttps://api.protectedplanet.net/request\u003e`_. Then you need to set an\nenvironment variable (we recommend using the name ``WDPA_KEY``\\ )\nusing either the command ``os.environ[\"WDPA_KEY\"]=\"your_token\"`` or\n`python-dotenv \u003chttps://github.com/theskumar/python-dotenv\u003e`_.\n\nGDAL\n----\n\nGDAL must be installed on your system.\n\nTo install GDAL on Windows, use the `OSGeo4W \u003chttps://trac.osgeo.org/osgeo4w/\u003e`_ network installer. OSGeo4W is a binary distribution of a broad set of open source geospatial software for Windows environments (Windows 11 down to 7). Select *Express Install* and install GDAL. Several Gb of space will be needed on disk to install this programs. This will also install *OSGeo4W Shell* to execute command lines.\n\nTo install GDAL on other systems, use your package manager, for example ``apt`` for Debian/Ubuntu Linux distributions.\n\n.. code:: shell\n\n    sudo apt update\n    sudo apt install gdal-bin libgdal-dev\n\nAfter installing GDAL, you can test the installation by running ``gdalinfo --version`` in the command prompt or terminal, which should display the installed GDAL version.\n\n\nInstallation\n============\n\nThe easiest way to install the ``pywdpa`` Python package is via `pip \u003chttps://pip.pypa.io/en/stable/\u003e`_ in the *OSGeo4W Shell* for Windows or in a virtual environment for Linux.\n\nFor Linux, create and activate a virtual environment before install ``pywdpa`` with ``pip``:\n\n.. code-block:: shell\n\n   cd ~\n   # Create a directory for virtual environments\n   mkdir venvs\n   # Create the virtual environment with venv\n   python3 -m venv ~/venvs/venv-pywdpa\n   # Activate (start) the virtual environment\n   source ~/venvs/venv-pywdpa/bin/activate\n\nInstall Python dependencies and ``pywdpa`` in the *OSGeo4W Shell* or in the newly created virtual environment:\n   \n.. code-block:: shell\n   \n   # Upgrade pip, setuptools, and wheel\n   python3 -m pip install --upgrade pip setuptools wheel\n   # Install numpy\n   python3 -m numpy\n   # Install gdal Python bindings (the correct version)\n   python3 -m pip install gdal==$(gdal-config --version)\n   # Install pywdpa. This will install all other dependencies\n   python3 -m pip install pywdpa\n\nIf you want to install the development version of ``pywdpa``, replace the last line with:\n\n.. code-block:: shell\n\n   python3 -m pip install https://github.com/ghislainv/pywdpa/archive/master.zip\n\nTo deactivate and delete the virtual environment:\n\n.. code-block:: shell\n\t\t\n   deactivate\n   rm -R ~/venvs/venv-pywdpa # Just remove the repository\n\nIn case of problem while installing GDAL Python bindings, try the following command:\n\n.. code-block:: shell\n\t\t\n   python3 -m pip install  --no-cache-dir --force-reinstall gdal==$(gdal-config --version)\n\n\nContributing\n============\n\nThe ``pywdpa`` Python package is Open Source and released under\nthe `GNU GPL version 3 license\n\u003chttps://ecology.ghislainv.fr/pywdpa/license.html\u003e`__. Anybody\nwho is interested can contribute to the package development following\nour `Community guidelines\n\u003chttps://ecology.ghislainv.fr/pywdpa/contributing.html\u003e`__. Every\ncontributor must agree to follow the project's `Code of conduct\n\u003chttps://ecology.ghislainv.fr/pywdpa/code_of_conduct.html\u003e`__.\n   \n.. |Python version| image:: https://img.shields.io/pypi/pyversions/pywdpa?logo=python\u0026logoColor=ffd43b\u0026color=306998\n   :target: https://pypi.org/project/pywdpa\n   :alt: Python version\n\n.. |PyPI version| image:: https://img.shields.io/pypi/v/pywdpa\n   :target: https://pypi.org/project/pywdpa\n   :alt: PyPI version\n\n.. |GitHub Actions| image:: https://github.com/ghislainv/pywdpa/workflows/PyPkg/badge.svg\n   :target: https://github.com/ghislainv/pywdpa/actions\n   :alt: GitHub Actions\n\t \n.. |License| image:: https://img.shields.io/badge/licence-GPLv3-8f10cb.svg\n   :target: https://www.gnu.org/licenses/gpl-3.0.html\n   :alt: License GPLv3\n\n.. |Zenodo| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.4275513.svg\n   :target: https://doi.org/10.5281/zenodo.4275513\n   :alt: Zenodo\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghislainv%2Fpywdpa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fghislainv%2Fpywdpa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghislainv%2Fpywdpa/lists"}