simple-module-datasets 0.0.3

Geospatial + tabular dataset upload, parsing (shapely) and slugging for simple_module apps

simple_module_datasets

Geospatial + tabular dataset upload module for simple_module apps. Users upload CSV/GeoJSON/Shapefile; the module parses, slugs a canonical name, and stores geometry using shapely.

Install

pip install simple_module_datasets

Also needs simple_module_file_storage + simple_module_background_tasks (declared as deps).

What it provides

• POST /api/datasets — multipart upload; the file is staged via simple_module_file_storage, then a Celery job parses it in the background.
• Dataset SQLModel record with name, slug (via python-slugify), geometry_type, row_count, bbox.
• Shapely-backed parsers for GeoJSON, CSV with lat/lon columns, and zipped Shapefiles.
• Admin UI for browsing + deleting datasets.

Usage

Upload from a form:

curl -X POST -F "file=@cities.geojson" http://localhost:8000/api/datasets

Query parsed datasets:

from datasets.service import DatasetService   # type: ignore[import-not-found]

async def list_by_bbox(svc: DatasetService = Depends(DatasetService), ...):
    return await svc.intersects(bbox=(-74.1, 40.6, -73.8, 40.9))

Depends on

• simple_module_core, simple_module_db, simple_module_hosting
• simple_module_file_storage, simple_module_background_tasks
• shapely>=2.0, python-slugify>=8.0, celery>=5.4

License

MIT — see LICENSE.