datagouv-python 0.1.0

No project description provided

datagouv-python

Unofficial python client for data.gouv.fr.

Official documentation is here: https://guides.data.gouv.fr/guide-data.gouv.fr/api/reference.

Current API version supported = "1".

Getting Started

from datagouv import DatagouvClient

client = DatagouvClient(MY_API_KEY)

# Get a dataset
dataset = client.datasets.get(my_dataset_id)
dataset_resources = dataset.get('resources')

# Upload a new resource from a file
client.datasets.post_resource_file(my_dataset_id, filename)

# Update a resource file 
client.datasets.put_resource_file(my_dataset_id, filename, resource_id)

# Update a resource
client.datasets.put_resource(my_dataset_id, resource)

Download all resources

from datagouv import ResourcesDownloader

# Get a dataset: https://meteo.data.gouv.fr/datasets/656dab84db1bdf627a40eaae
dataset_id = "656dab84db1bdf627a40eaae"

# Instanciate ResourcesDownloader
downloader = ResourcesDownloader(dataset_id)

# Download to current directory
downloader.download()

Development

poetry run start
poetry run black datagouv/
poetry run flake8

Build

poetry version
poetry version -s

poetry version [patch, minor, major]

poetry build

https://pypi.org/project/datagouv-python/

Publish

poetry config repositories.test-pypi https://test.pypi.org/legacy/
poetry config pypi-token.test-pypi MY_TOKEN
poetry config pypi-token.pypi MY_TOKEN

poetry publish -r test-pypi 
poetry publish

Roadmap

• Handle /datasets routes
• Handle other routes
  • /site
  • /reuses
  • /discussions
  • /organizations
  • /spatial
  • /users
  • /me
  • /workers
  • /tags
  • /topics
  • /posts
  • /transfer
  • /notifications
  • /avatars
  • /harvest