feat(melodi): tests, docstrings, fix measures parsing

.gitignore

@@ -5,6 +5,9 @@ pynsee.egg-info
 settings.json
 .coverage
 .venv/
+uv.lock
+.vscode/
+notebooks/
 *.html
 *.pyc
 *.rtc

docs/conf.py

@@ -20,7 +20,6 @@
 
 import pynsee
 
-
 # -- Project information -----------------------------------------------------
 
 project = "pynsee"
@@ -82,6 +81,7 @@
     "examples/example_cadre_iris_idf": "_static/upper_middle_class_worker_idf.png",
     "examples/example_marie_firstname": "_static/firstname.png",
     "examples/example_rp_logement_2017": "_static/housing.png",
+    "examples/example_internet_usage_melodi": "_static/internet_usage_melodi.png",
 }
 
 

docs/examples.rst

@@ -24,3 +24,4 @@ Examples
    examples/example_doctors_idf.ipynb
    examples/example_automotive_industry_sirene.ipynb
    examples/example_commute_paris.ipynb
+   examples/example_internet_usage_melodi.ipynb

docs/get_data.rst

@@ -97,3 +97,18 @@ Get data from INSEE files
 
 .. autofunction:: pynsee.download.get_column_metadata
     :no-index:
+
+Get MELODI data
+---------------
+
+.. autofunction:: pynsee.melodi.get_catalog
+    :no-index:
+
+.. autofunction:: pynsee.melodi.get_dataset
+    :no-index:
+
+.. autofunction:: pynsee.melodi.get_range
+    :no-index:
+
+.. autofunction:: pynsee.melodi.get_idbank
+    :no-index:

docs/modules.rst

@@ -29,10 +29,10 @@ Macro data
     :members:
 
 
-Metadata
---------
+MELODI
+------
 
-.. automodule:: pynsee.metadata
+.. automodule:: pynsee.melodi
     :members:
 
 
@@ -48,3 +48,10 @@ Utils
 
 .. automodule:: pynsee.utils
     :members:
+
+
+Metadata (deprecated)
+---------------------
+
+.. automodule:: pynsee.metadata
+    :members:

pynsee/__init__.py

@@ -1,9 +1,10 @@
+from pynsee.download import *
 from pynsee.geodata import *
-from pynsee.macrodata import *
 from pynsee.localdata import *
-from pynsee.sirene import *
+from pynsee.macrodata import *
+from pynsee.melodi import *
 from pynsee.metadata import *
+from pynsee.sirene import *
 from pynsee.utils import *
-from pynsee.download import *
 
-__version__ = "0.2.5"
+__version__ = "0.2.6"

pynsee/geodata/_add_insee_dep.py

@@ -50,7 +50,7 @@ def _add_insee_dep_from_id_com(gdf):
                     "geometry": "insee_dep_geometry",
                     "code_insee": "code_insee_du_departement",
                 },
-                inplace=True
+                inplace=True,
             )
 
             gdf = gdf.merge(
@@ -85,7 +85,7 @@ def _add_insee_dep_region(gdf):
                 columns={
                     "geometry": "insee_dep_geometry",
                 },
-                inplace=True
+                inplace=True,
             )
 
             gdf = gdf.merge(dep, on="insee_reg", how="left")

pynsee/melodi/catalog.py

@@ -16,7 +16,9 @@
 
 
 @save_df(day_lapse_max=30)
-def get_catalog(language: str = "all") -> pd.DataFrame:
+def get_catalog(
+    language: str = "all", update: bool = False, silent: bool = False
+) -> pd.DataFrame:
     """
     Retrieve MELODI's full catalog.