Metadata-Version: 2.1
Name: the-datagarden-models
Version: 1.6.8
Summary: Base data models for the datagarden.
Author-email: Maarten de Ruyter <info@the-datagarden.io>
Project-URL: Read the Docs, https://dg-the-datagarden-models.readthedocs.io/en/latest/
Project-URL: The-DataGarden, https://www.the-datagarden.io/
Project-URL: Data Models, https://www.the-datagarden.io/data-docs
Project-URL: Source, https://github.com/OlivettaDataGarden/dg-the-datagarden-models
Keywords: geojson,demographics,economics
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Healthcare Industry
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
Requires-Dist: click>=8.1.7
Requires-Dist: pydantic>=2.9.2

=====================
the-datagarden-models
=====================

The-datagarden-models package is supporting package for the-datagarden api (see `The DataGarden Website <https://www.the-datagarden.io>`_) and
the-datagarden package (see `the-datagarden package <https://pypi.org/project/the-datagarden/>`_). The-datagarden api and package
are developed to give data professionals easy access to regional data from public sources without having to understand the sources, api's and data formats
from those public data sources.

The-datagarden-models package contains the Pydantic models for the data returned by the-datagarden api and can be used to work with the data
returned by the api in a more pythonic way than only using the json.

A quick example
---------------
If you have a user account at the-datagarden.io, you can start using the SDK right away:

.. code-block:: python

    # Retrieve a country object from the datagarden API
    >>> from the-datagarden import TheDataGardenAPI
    >>> the_datagarden_api = TheDataGardenAPI(email='your-email@example.com', password='your-password')
    >>> nl = the_datagarden_api.netherlands()
    >>> nl_demographics = nl.demographics(from_period="2010-01-01", source="united nations")
    >>> nl_demographics
        TheDataGardenRegionalDataModel : Demographics : (count=15)

this returns a `TheDataGardenRegionalDataModel` containimg the demographics data in this case 15 records.
Each of those records will contain a Demographics object for the region for the specified period.


Read more
---------

* `The DataGarden Website <https://www.the-datagarden.io>`_
* `API Documentation <https://www.the-datagarden.io/api-docs>`_
* `Documentation on the Datagarden Models <https://www.the-datagarden.io/data-docs>`_
* `GitHub Repository for the-datagarden-models <https://github.com/MaartendeRuyter/dg-the-datagarden-models>`_

Access to The DataGarden API
----------------------------
To use the DataGarden SDK, you need access to the The DataGarden API. Simply register for free at https://www.the-datagarden.io
and you will have an inital free access account to the API with access to country and continent data.

Visit https://www.the-datagarden.io for to register for free.
