Sobre o projeto

# odp-stockholm Um cliente Python assíncrono para os conjuntos de dados abertos de Estocolmo, Suécia. Ele se comunica com a API da Open Data Platform da cidade para que aplicações Python possam extrair conjuntos de dados sem a necessidade de escrever requisições HTTP manualmente. ## O que ele faz O pacote foi originalmente construído para buscar apenas dados de estacionamento, mas a base de código é deliberadamente organizada para que outros conjuntos de dados da mesma plataforma possam ser adicionados posteriormente. O README documenta atualmente um conjunto de dados: - **Estacionamentos para deficientes** (rörelsehindrade förare med särskilt tillstånd) — aproximadamente 2045 locais. ## Requisitos e acesso O uso dos dados requer uma chave de API, que pode ser solicitada no site da plataforma. O projeto visa o Python 3.12 ou superior e é distribuído no PyPI como `odp-stockholm`. ## Instalação e uso ```bash pip install odp-stockholm ``` O cliente é utilizado como um gerenciador de contexto async. O exemplo documentado instancia `ParkingStockholm` com uma chave de API e chama `disabled_parkings(limit=10)`, imprimindo os locais retornados. ## Campos do conjunto de dados As requisições aceitam um parâmetro `limit` (padrão 10). Os registros retornados incluem: - `location_id`, `location_type`, `number` de vagas de estacionamento - `street`, `address`, `district` - `parking_rate` e `parking_rules` (uma URL para as regulamentações de estacionamento de Estocolmo) - `valid_from` e `valid_to` (este último pode ser `None`) - `coordinates` como uma lista de floats ## Configuração de desenvolvimento O projeto utiliza Poetry para gerenciamento de dependências e pode ser aberto em um VS Code Dev Container ou GitHub CodeSpace. Os commits são analisados e testados através do framework de hooks `prek` (`poetry run prek install`, `poetry run prek run --all-files`). Os testes utilizam pytest, incluindo testes de snapshot syrupy que podem ser atualizados com `poetry run pytest --snapshot-update`. ## Licenciamento Lançado sob a Licença MIT, copyright Klaas Schoute (2023–2026). ## Notas para avaliadores Esta é uma biblioteca de acesso a dados focada, e não uma aplicação completa: seu valor está em fornecer acesso assíncrono e tipado a uma fonte de dados abertos municipal e um modelo que pode ser estendido para outros conjuntos de dados de Estocolmo. Não é afiliada nem endossada pela Cidade de Estocolmo; os usuários fornecem sua própria chave de API e estão sujeitos aos termos da plataforma.