Skip to content

Simple Python wrapper for the spanish Catastro API endpoint

License

Notifications You must be signed in to change notification settings

adrivn/catastronaut

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Catastronaut 🧑🚀

Simple Python wrapper to retrieve data from the spanish Land Registry ("Catastro") API endpoint.

✨ Features

  • JSON default response can be traversed/modelled using JMESPath syntax. You can choose which data you want to access, how deep, and how to name/label it. More details in the utils/models.py file.
  • Choose how you want to output the data: raw or in DataFrame (using Polars library)
    • By returning a Polars DataFrame, the user can access its API directly, allowing for further wrangling, transformation or saving the data to disk (JSON, CSV, Parquet, databases, etc.)
  • Supports single parameter requests and bulk requests (by passing lists of parameters)
  • Verbose error logging and traceback
  • Auto-retry and rate limiting
  • Caching (TBD)

⚡️ Requirements

  • JMESPath (allows for easy and custom flattening of nested JSON responses)
  • Polars Pandas replacement written in Rust; multithreaded, vectorized and fast like no other.

⚙️ Usage

Heavily inspired by Pycatastro. Like it? Let me know. Have ideas? Submit a pull request or open an issue. Issues to report? Open an issue.

About

Simple Python wrapper for the spanish Catastro API endpoint

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages