Metadata-Version: 2.1
Name: uoapi
Version: 0.1.0
Summary: A robust Python client for interacting with the Newcastle Urban Observatory API (v1.1). This package provides a comprehensive interface for accessing and analyzing urban sensor data with built-in caching, configuration management, and data analysis capabilities.
License: MIT
Author: carrowmw
Author-email: c.morris-wiltshire@newcastle.ac.uk
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: pandas (>=2.2.3,<3.0.0)
Requires-Dist: pyyaml (>=6.0.2,<7.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Description-Content-Type: text/markdown

# Urban Observatory API Client

A robust Python client for interacting with the Newcastle Urban Observatory API (v1.1). This package provides a comprehensive interface for accessing and analyzing urban sensor data with built-in caching, configuration management, and data analysis capabilities. Pacakge documentation, installation instructions and examples can be found at [TODO](TODO)   

## Key Features
- Flexible Configuration: Support for YAML-based configuration and runtime parameter updates
- Intelligent Caching: Built-in caching system with customizable retention periods
- Comprehensive Data Access:
  - Sensor metadata retrieval
  - Raw sensor data access
  - Theme and variable information
  - Spatial and temporal filtering
- Error Handling: Robust error handling and logging
- Data Analysis Tools: JSON structure analysis and data formatting utilities
- DataFrame Export: Easy conversion of metadata to Pandas DataFrames

## Use Cases
- Urban data analysis
- Environmental monitoring
- Research and data collection
- Smart city applications
- Sensor network analysis

## Technical Highlights
- Type-hinted for modern Python development
- Decorator-based caching system
- Dataclass-driven configuration
- Pandas integration for data manipulation
- Comprehensive logging system
- RESTful API interaction with request retry handling
The package is designed for researchers, data scientists, and developers working with urban sensor data, providing a clean and intuitive interface to the Urban Observatory's extensive sensor network.
