bachtrackapi 0.1.0__tar.gz

bachtrackapi-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clark Maio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bachtrackapi-0.1.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md
+include LICENSE
+include requirements.txt
+include pyproject.toml
+recursive-exclude * __pycache__
+recursive-exclude * *.py[cod]
+recursive-exclude * .DS_Store

bachtrackapi-0.1.0/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: bachtrackapi
+Version: 0.1.0
+Summary: A Python web scraper and REST API for extracting classical music opera events from Bachtrack.com
+Author-email: Clark Maio <clark@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/clarkmaio/bachtrackapi
+Project-URL: Repository, https://github.com/clarkmaio/bachtrackapi.git
+Project-URL: Documentation, https://github.com/clarkmaio/bachtrackapi#readme
+Project-URL: Issues, https://github.com/clarkmaio/bachtrackapi/issues
+Keywords: scraper,api,opera,classical-music,fastapi,bachtrack
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi==0.104.1
+Requires-Dist: uvicorn[standard]==0.24.0
+Requires-Dist: pydantic==2.5.0
+Requires-Dist: pydantic-settings==2.1.0
+Requires-Dist: requests==2.31.0
+Requires-Dist: beautifulsoup4==4.12.2
+Requires-Dist: selenium==4.15.2
+Requires-Dist: webdriver-manager==4.0.1
+Requires-Dist: python-dotenv==1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest==7.4.3; extra == "dev"
+Requires-Dist: pytest-asyncio==0.21.1; extra == "dev"
+Requires-Dist: black==23.12.0; extra == "dev"
+Requires-Dist: flake8==6.1.0; extra == "dev"
+Requires-Dist: mypy==1.7.0; extra == "dev"
+Dynamic: license-file
+Dynamic: requires-python
+
+# BachtrackAPI
+
+A Python web scraper and REST API for extracting classical music opera events from [Bachtrack.com](https://bachtrack.com/).
+
+## Overview
+
+BachtrackAPI provides two complementary ways to access opera event data:
+
+1. **Scraper Module** - Direct web scraping of Bachtrack opera listings
+2. **FastAPI Backend** - RESTful API endpoints for searching and filtering events
+
+Search by work ID (e.g., `12285` for Gianni Schicchi) or freetext (e.g., `"La Traviata"`).
+
+## Installation
+
+```bash
+pip install -r requirements.txt
+```
+
+## Quick Start
+
+### 1. Using the Scraper Directly
+
+```python
+from scraper.scraper import BachtrackScraper
+
+scraper = BachtrackScraper()
+
+# Search by work ID
+events = scraper.search_operas(12285)  # Gianni Schicchi
+print(f"Found {len(events)} events")
+
+# Search by freetext
+events = scraper.search_operas("La Traviata")
+for event in events:
+    print(f"{event['title']} - {event['city']} @ {event['venue']}")
+```
+
+**Output:**
+```
+Found 28 events
+Gianni Schicchi - Berlin @ Deutsche Oper
+Gianni Schicchi - Winterthur @ Stadttheater Winterthur
+...
+```
+
+### 2. Using the FastAPI Backend
+
+Start the server:
+```bash
+uvicorn api.main:app --reload
+```
+
+**Example API Requests:**
+
+```bash
+# Freetext search
+curl "http://localhost:8000/api/v1/events/get_operas?q=gianni%20schicchi"
+
+# Work ID search
+curl "http://localhost:8000/api/v1/events/get_operas?q=12285"
+
+# POST search
+curl -X POST "http://localhost:8000/api/v1/events/search" \
+  -H "Content-Type: application/json" \
+  -d '{"work_id": 12285}'
+```
+
+**Response:**
+```json
+{
+  "query": "12285",
+  "total_results": 28,
+  "results": [
+    {
+      "title": "Gianni Schicchi",
+      "city": "Berlin",
+      "date": "2026-04-05T00:00:00",
+      "venue": "Deutsche Oper",
+      "detail_url": "https://bachtrack.com/opera-event/..."
+    }
+  ]
+}
+```
+
+## Available Endpoints
+
+- `GET /api/v1/events/get_operas?q=<search>` - Raw scraper output
+- `GET /api/v1/events/search?work_id=<id>` - Search by work ID
+- `GET /api/v1/events/search?q=<term>` - Freetext search
+- `POST /api/v1/events/search` - JSON body search
+- `GET /docs` - Interactive API documentation
+- `GET /health` - Health check
+
+## Testing
+
+```bash
+# Run scraper tests
+python tests/test_scraper.py
+
+# Run full API integration tests
+pytest tests/test_api.py -v -s
+```
+
+## Project Structure
+
+```
+scraper/scraper.py           # Core scraping logic
+api/
+  ├── main.py                    # FastAPI app factory
+  ├── routes/events.py           # API endpoints
+  ├── models/event.py            # Pydantic models
+  └── services/opera_service.py  # Service layer
+tests/                           # Unit and integration tests
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details
+

bachtrackapi-0.1.0/README.md

@@ -0,0 +1,120 @@
+# BachtrackAPI
+
+A Python web scraper and REST API for extracting classical music opera events from [Bachtrack.com](https://bachtrack.com/).
+
+## Overview
+
+BachtrackAPI provides two complementary ways to access opera event data:
+
+1. **Scraper Module** - Direct web scraping of Bachtrack opera listings
+2. **FastAPI Backend** - RESTful API endpoints for searching and filtering events
+
+Search by work ID (e.g., `12285` for Gianni Schicchi) or freetext (e.g., `"La Traviata"`).
+
+## Installation
+
+```bash
+pip install -r requirements.txt
+```
+
+## Quick Start
+
+### 1. Using the Scraper Directly
+
+```python
+from scraper.scraper import BachtrackScraper
+
+scraper = BachtrackScraper()
+
+# Search by work ID
+events = scraper.search_operas(12285)  # Gianni Schicchi
+print(f"Found {len(events)} events")
+
+# Search by freetext
+events = scraper.search_operas("La Traviata")
+for event in events:
+    print(f"{event['title']} - {event['city']} @ {event['venue']}")
+```
+
+**Output:**
+```
+Found 28 events
+Gianni Schicchi - Berlin @ Deutsche Oper
+Gianni Schicchi - Winterthur @ Stadttheater Winterthur
+...
+```
+
+### 2. Using the FastAPI Backend
+
+Start the server:
+```bash
+uvicorn api.main:app --reload
+```
+
+**Example API Requests:**
+
+```bash
+# Freetext search
+curl "http://localhost:8000/api/v1/events/get_operas?q=gianni%20schicchi"
+
+# Work ID search
+curl "http://localhost:8000/api/v1/events/get_operas?q=12285"
+
+# POST search
+curl -X POST "http://localhost:8000/api/v1/events/search" \
+  -H "Content-Type: application/json" \
+  -d '{"work_id": 12285}'
+```
+
+**Response:**
+```json
+{
+  "query": "12285",
+  "total_results": 28,
+  "results": [
+    {
+      "title": "Gianni Schicchi",
+      "city": "Berlin",
+      "date": "2026-04-05T00:00:00",
+      "venue": "Deutsche Oper",
+      "detail_url": "https://bachtrack.com/opera-event/..."
+    }
+  ]
+}
+```
+
+## Available Endpoints
+
+- `GET /api/v1/events/get_operas?q=<search>` - Raw scraper output
+- `GET /api/v1/events/search?work_id=<id>` - Search by work ID
+- `GET /api/v1/events/search?q=<term>` - Freetext search
+- `POST /api/v1/events/search` - JSON body search
+- `GET /docs` - Interactive API documentation
+- `GET /health` - Health check
+
+## Testing
+
+```bash
+# Run scraper tests
+python tests/test_scraper.py
+
+# Run full API integration tests
+pytest tests/test_api.py -v -s
+```
+
+## Project Structure
+
+```
+scraper/scraper.py           # Core scraping logic
+api/
+  ├── main.py                    # FastAPI app factory
+  ├── routes/events.py           # API endpoints
+  ├── models/event.py            # Pydantic models
+  └── services/opera_service.py  # Service layer
+tests/                           # Unit and integration tests
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details
+

bachtrackapi-0.1.0/api/__init__.py

@@ -0,0 +1 @@
+"""FastAPI backend for Bachtrack opera events API."""

bachtrackapi-0.1.0/api/main.py

@@ -0,0 +1,35 @@
+"""FastAPI application factory."""
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from api.routes.events import router as events_router
+
+
+def create_app() -> FastAPI:
+    """Create and configure FastAPI application."""
+    app = FastAPI(
+        title="BachtrackAPI",
+        description="API to search and retrieve opera events from Bachtrack.com",
+        version="0.1.0",
+    )
+    
+    # Add CORS middleware
+    app.add_middleware(
+        CORSMiddleware,
+        allow_origins=["*"],
+        allow_credentials=True,
+        allow_methods=["*"],
+        allow_headers=["*"],
+    )
+    
+    # Include routers
+    app.include_router(events_router)
+    
+    # Health check endpoint
+    @app.get("/health")
+    async def health_check():
+        return {"status": "ok"}
+    
+    return app
+
+
+app = create_app()

bachtrackapi-0.1.0/bachtrackapi.egg-info/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: bachtrackapi
+Version: 0.1.0
+Summary: A Python web scraper and REST API for extracting classical music opera events from Bachtrack.com
+Author-email: Clark Maio <clark@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/clarkmaio/bachtrackapi
+Project-URL: Repository, https://github.com/clarkmaio/bachtrackapi.git
+Project-URL: Documentation, https://github.com/clarkmaio/bachtrackapi#readme
+Project-URL: Issues, https://github.com/clarkmaio/bachtrackapi/issues
+Keywords: scraper,api,opera,classical-music,fastapi,bachtrack
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi==0.104.1
+Requires-Dist: uvicorn[standard]==0.24.0
+Requires-Dist: pydantic==2.5.0
+Requires-Dist: pydantic-settings==2.1.0
+Requires-Dist: requests==2.31.0
+Requires-Dist: beautifulsoup4==4.12.2
+Requires-Dist: selenium==4.15.2
+Requires-Dist: webdriver-manager==4.0.1
+Requires-Dist: python-dotenv==1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest==7.4.3; extra == "dev"
+Requires-Dist: pytest-asyncio==0.21.1; extra == "dev"
+Requires-Dist: black==23.12.0; extra == "dev"
+Requires-Dist: flake8==6.1.0; extra == "dev"
+Requires-Dist: mypy==1.7.0; extra == "dev"
+Dynamic: license-file
+Dynamic: requires-python
+
+# BachtrackAPI
+
+A Python web scraper and REST API for extracting classical music opera events from [Bachtrack.com](https://bachtrack.com/).
+
+## Overview
+
+BachtrackAPI provides two complementary ways to access opera event data:
+
+1. **Scraper Module** - Direct web scraping of Bachtrack opera listings
+2. **FastAPI Backend** - RESTful API endpoints for searching and filtering events
+
+Search by work ID (e.g., `12285` for Gianni Schicchi) or freetext (e.g., `"La Traviata"`).
+
+## Installation
+
+```bash
+pip install -r requirements.txt
+```
+
+## Quick Start
+
+### 1. Using the Scraper Directly
+
+```python
+from scraper.scraper import BachtrackScraper
+
+scraper = BachtrackScraper()
+
+# Search by work ID
+events = scraper.search_operas(12285)  # Gianni Schicchi
+print(f"Found {len(events)} events")
+
+# Search by freetext
+events = scraper.search_operas("La Traviata")
+for event in events:
+    print(f"{event['title']} - {event['city']} @ {event['venue']}")
+```
+
+**Output:**
+```
+Found 28 events
+Gianni Schicchi - Berlin @ Deutsche Oper
+Gianni Schicchi - Winterthur @ Stadttheater Winterthur
+...
+```
+
+### 2. Using the FastAPI Backend
+
+Start the server:
+```bash
+uvicorn api.main:app --reload
+```
+
+**Example API Requests:**
+
+```bash
+# Freetext search
+curl "http://localhost:8000/api/v1/events/get_operas?q=gianni%20schicchi"
+
+# Work ID search
+curl "http://localhost:8000/api/v1/events/get_operas?q=12285"
+
+# POST search
+curl -X POST "http://localhost:8000/api/v1/events/search" \
+  -H "Content-Type: application/json" \
+  -d '{"work_id": 12285}'
+```
+
+**Response:**
+```json
+{
+  "query": "12285",
+  "total_results": 28,
+  "results": [
+    {
+      "title": "Gianni Schicchi",
+      "city": "Berlin",
+      "date": "2026-04-05T00:00:00",
+      "venue": "Deutsche Oper",
+      "detail_url": "https://bachtrack.com/opera-event/..."
+    }
+  ]
+}
+```
+
+## Available Endpoints
+
+- `GET /api/v1/events/get_operas?q=<search>` - Raw scraper output
+- `GET /api/v1/events/search?work_id=<id>` - Search by work ID
+- `GET /api/v1/events/search?q=<term>` - Freetext search
+- `POST /api/v1/events/search` - JSON body search
+- `GET /docs` - Interactive API documentation
+- `GET /health` - Health check
+
+## Testing
+
+```bash
+# Run scraper tests
+python tests/test_scraper.py
+
+# Run full API integration tests
+pytest tests/test_api.py -v -s
+```
+
+## Project Structure
+
+```
+scraper/scraper.py           # Core scraping logic
+api/
+  ├── main.py                    # FastAPI app factory
+  ├── routes/events.py           # API endpoints
+  ├── models/event.py            # Pydantic models
+  └── services/opera_service.py  # Service layer
+tests/                           # Unit and integration tests
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details
+

bachtrackapi-0.1.0/bachtrackapi.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+requirements.txt
+setup.py
+api/__init__.py
+api/main.py
+bachtrackapi.egg-info/PKG-INFO
+bachtrackapi.egg-info/SOURCES.txt
+bachtrackapi.egg-info/dependency_links.txt
+bachtrackapi.egg-info/requires.txt
+bachtrackapi.egg-info/top_level.txt
+scraper/__init__.py
+scraper/scraper.py
+tests/test_api.py
+tests/test_api_v2.py
+tests/test_datetime.py
+tests/test_freetext.py
+tests/test_scraper.py

bachtrackapi-0.1.0/bachtrackapi.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bachtrackapi-0.1.0/bachtrackapi.egg-info/requires.txt

@@ -0,0 +1,16 @@
+fastapi==0.104.1
+uvicorn[standard]==0.24.0
+pydantic==2.5.0
+pydantic-settings==2.1.0
+requests==2.31.0
+beautifulsoup4==4.12.2
+selenium==4.15.2
+webdriver-manager==4.0.1
+python-dotenv==1.0.0
+
+[dev]
+pytest==7.4.3
+pytest-asyncio==0.21.1
+black==23.12.0
+flake8==6.1.0
+mypy==1.7.0

bachtrackapi-0.1.0/bachtrackapi.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+api
+scraper

bachtrackapi-0.1.0/pyproject.toml

@@ -0,0 +1,76 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bachtrackapi"
+version = "0.1.0"
+description = "A Python web scraper and REST API for extracting classical music opera events from Bachtrack.com"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "Clark Maio", email = "clark@example.com"}
+]
+keywords = ["scraper", "api", "opera", "classical-music", "fastapi", "bachtrack"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = [
+    "fastapi==0.104.1",
+    "uvicorn[standard]==0.24.0",
+    "pydantic==2.5.0",
+    "pydantic-settings==2.1.0",
+    "requests==2.31.0",
+    "beautifulsoup4==4.12.2",
+    "selenium==4.15.2",
+    "webdriver-manager==4.0.1",
+    "python-dotenv==1.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest==7.4.3",
+    "pytest-asyncio==0.21.1",
+    "black==23.12.0",
+    "flake8==6.1.0",
+    "mypy==1.7.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/clarkmaio/bachtrackapi"
+Repository = "https://github.com/clarkmaio/bachtrackapi.git"
+Documentation = "https://github.com/clarkmaio/bachtrackapi#readme"
+Issues = "https://github.com/clarkmaio/bachtrackapi/issues"
+
+[tool.setuptools]
+packages = ["api", "scraper"]
+
+[tool.setuptools.package-data]
+api = ["py.typed"]
+
+[tool.black]
+line-length = 100
+target-version = ["py38", "py39", "py310", "py311"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+addopts = "-v --strict-markers"
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false

bachtrackapi-0.1.0/requirements.txt

@@ -0,0 +1,11 @@
+fastapi==0.104.1
+uvicorn[standard]==0.24.0
+pydantic==2.5.0
+pydantic-settings==2.1.0
+requests==2.31.0
+beautifulsoup4==4.12.2
+selenium==4.15.2
+webdriver-manager==4.0.1
+python-dotenv==1.0.0
+pytest==7.4.3
+pytest-asyncio==0.21.1

bachtrackapi-0.1.0/scraper/__init__.py

@@ -0,0 +1,3 @@
+
+
+from .scraper import BachtrackScraper