프로젝트 소개

# odp-stockholm 스웨덴 스톡홀름의 공개 데이터셋을 위한 비동기 Python 클라이언트입니다. 이 라이브러리는 시의 Open Data Platform API와 통신하여 Python 애플리케이션이 HTTP 요청을 직접 작성하지 않고도 데이터셋을 가져올 수 있게 합니다. ## 주요 기능 이 패키지는 원래 주차 데이터만 가져오기 위해 구축되었으나, 나중에 동일한 플랫폼의 다른 데이터셋을 추가할 수 있도록 코드 베이스가 의도적으로 구성되었습니다. 현재 README에는 다음 데이터셋 하나가 문서화되어 있습니다: - **장애인 주차 구역** (rörelsehindrade förare med särskilt tillstånd) — 약 2045개 위치. ## 요구 사항 및 액세스 데이터를 사용하려면 플랫폼 웹사이트에서 요청한 API 키가 필요합니다. 이 프로젝트는 Python 3.12 이상을 대상으로 하며, PyPI에 `odp-stockholm`으로 배포됩니다. ## 설치 및 사용법 ```bash pip install odp-stockholm ``` 클라이언트는 비동기 컨텍스트 매니저로 사용됩니다. 문서화된 예제에서는 API 키로 `ParkingStockholm`을 인스턴스화하고 `disabled_parkings(limit=10)`를 호출하여 반환된 위치를 출력합니다. ## 데이터셋 필드 요청 시 `limit` 매개변수(기본값 10)를 사용할 수 있습니다. 반환되는 레코드에는 다음이 포함됩니다: - `location_id`, `location_type`, 주차 공간 `number` - `street`, `address`, `district` - `parking_rate` 및 `parking_rules` (스톡홀름 주차 규정 URL) - `valid_from` 및 `valid_to` (후자는 `None`일 수 있음) - float 리스트 형태의 `coordinates` ## 개발 설정 이 프로젝트는 의존성 관리를 위해 Poetry를 사용하며, VS Code Dev Container 또는 GitHub CodeSpace에서 열 수 있습니다. 커밋은 `prek` 훅 프레임워크(`poetry run prek install`, `poetry run prek run --all-files`)를 통해 린팅 및 테스트됩니다. 테스트에는 pytest가 사용되며, `poetry run pytest --snapshot-update`로 갱신 가능한 syrupy 스냅샷 테스트가 포함되어 있습니다. ## 라이선스 MIT 라이선스 하에 출시되었으며, 저작권은 Klaas Schoute (2023–2026)에게 있습니다. ## 평가자를 위한 참고 사항 이 라이브러리는 전체 애플리케이션이 아닌 집중적인 데이터 액세스 라이브러리입니다. 그 가치는 시의 공개 데이터 소스에 대해 타입이 지정된 비동기 액세스를 제공하고, 다른 스톡홀름 데이터셋으로 확장 가능한 템플릿을 제공하는 데 있습니다. 이 프로젝트는 스톡홀름 시와 제휴하거나 승인받지 않았으며, 사용자는 자체 API 키를 제공해야 하며 플랫폼의 약관을 준수해야 합니다.