winebox 0.1.0__py3-none-any.whl

winebox-0.1.0.dist-info/METADATA

@@ -0,0 +1,283 @@
+Metadata-Version: 2.4
+Name: winebox
+Version: 0.1.0
+Summary: Wine Cellar Management Application with OCR label scanning
+Project-URL: Homepage, https://github.com/jdrumgoole/winebox
+Project-URL: Repository, https://github.com/jdrumgoole/winebox
+Project-URL: Issues, https://github.com/jdrumgoole/winebox/issues
+Author-email: Joe Drumgoole <joe@joedrumgoole.com>
+License: MIT
+License-File: LICENSE
+Keywords: cellar,fastapi,inventory,ocr,wine
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Home Automation
+Requires-Python: >=3.11
+Requires-Dist: aiofiles>=23.0.0
+Requires-Dist: aiosqlite>=0.19.0
+Requires-Dist: bcrypt<4.1.0,>=4.0.0
+Requires-Dist: fastapi>=0.109.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: passlib>=1.7.4
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pytesseract>=0.3.10
+Requires-Dist: python-jose[cryptography]>=3.3.0
+Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: uvicorn[standard]>=0.27.0
+Provides-Extra: dev
+Requires-Dist: greenlet>=3.0.0; extra == 'dev'
+Requires-Dist: httpx>=0.26.0; extra == 'dev'
+Requires-Dist: invoke>=2.2.0; extra == 'dev'
+Requires-Dist: myst-parser>=2.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: sphinx>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# WineBox
+
+A wine cellar management application with OCR label scanning.
+
+## Features
+
+- **Label Scanning**: Upload wine label images for automatic text extraction via OCR
+- **Inventory Tracking**: Check-in and check-out bottles with full history
+- **Smart Parsing**: Automatically identifies vintage, grape variety, region, and more
+- **Search**: Find wines by any criteria
+- **Web Interface**: Simple, mobile-friendly interface
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.11+
+- [Tesseract OCR](https://github.com/tesseract-ocr/tesseract)
+
+### Installation
+
+**From PyPI:**
+```bash
+pip install winebox
+```
+
+**From source:**
+```bash
+# Clone the repository
+git clone https://github.com/jdrumgoole/winebox.git
+cd winebox
+
+# Install dependencies
+uv sync --all-extras
+
+# Install Tesseract OCR
+# macOS:
+brew install tesseract
+
+# Ubuntu/Debian:
+sudo apt-get install tesseract-ocr
+```
+
+### Running the Server
+
+```bash
+# Development mode with auto-reload
+invoke start --reload
+
+# Background mode
+invoke start-background
+
+# Check status
+invoke status
+
+# Stop server
+invoke stop
+```
+
+### Access the Application
+
+- **Web Interface**: http://localhost:8000/static/index.html
+- **API Documentation**: http://localhost:8000/docs
+- **Health Check**: http://localhost:8000/health
+
+## Usage
+
+### Check In Wine
+
+1. Navigate to the Check In page
+2. Upload front label image (required)
+3. Optionally upload back label image
+4. Review/edit auto-detected wine details
+5. Set quantity and add notes
+6. Click "Check In Wine"
+
+### Check Out Wine
+
+1. Go to the Cellar view
+2. Click "Check Out" on a wine card
+3. Enter quantity to remove
+4. Add optional notes (tasting notes, occasion)
+5. Confirm checkout
+
+### Search
+
+Use the Search page to find wines by:
+- Text search (name, winery, region)
+- Vintage year
+- Grape variety
+- Region or country
+- Stock status
+
+## API
+
+Full REST API available at `/api`:
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/wines/checkin` | POST | Add wine to cellar |
+| `/api/wines/{id}/checkout` | POST | Remove wine from cellar |
+| `/api/wines` | GET | List all wines |
+| `/api/wines/{id}` | GET | Get wine details |
+| `/api/cellar` | GET | Current inventory |
+| `/api/cellar/summary` | GET | Cellar statistics |
+| `/api/transactions` | GET | Transaction history |
+| `/api/search` | GET | Search wines |
+
+See `/docs` for interactive API documentation.
+
+## Data Storage
+
+### Database
+
+The SQLite database is stored at `data/winebox.db` by default. This can be configured via the `WINEBOX_DATABASE_URL` environment variable.
+
+### Images
+
+Wine label images are stored in the `data/images/` directory by default. Each image is saved with a UUID filename to avoid conflicts.
+
+| Item | Default Location | Environment Variable |
+|------|------------------|---------------------|
+| Database | `data/winebox.db` | `WINEBOX_DATABASE_URL` |
+| Images | `data/images/` | `WINEBOX_IMAGE_STORAGE_PATH` |
+
+Images are served via the API at `/api/images/{filename}`.
+
+**Note:** The `data/` directory is excluded from git (see `.gitignore`). Make sure to back up this directory to preserve your wine collection data.
+
+## Authentication
+
+WineBox requires authentication for all API endpoints (except `/health`).
+
+### Creating Users
+
+Use the `winebox-admin` command to manage users:
+
+```bash
+# Create an admin user
+uv run winebox-admin add admin --email admin@example.com --admin --password yourpassword
+
+# Create a regular user
+uv run winebox-admin add username --email user@example.com --password yourpassword
+
+# List all users
+uv run winebox-admin list
+
+# Disable/enable a user
+uv run winebox-admin disable username
+uv run winebox-admin enable username
+
+# Change password
+uv run winebox-admin passwd username --password newpassword
+
+# Remove a user
+uv run winebox-admin remove username
+```
+
+### Server Management
+
+Use the `winebox-server` command to manage the server:
+
+```bash
+# Start server (foreground)
+uv run winebox-server start --foreground
+
+# Start server (background)
+uv run winebox-server start
+
+# Stop server
+uv run winebox-server stop
+
+# Restart server
+uv run winebox-server restart
+
+# Check status
+uv run winebox-server status
+```
+
+### API Authentication
+
+The API uses JWT bearer tokens. To authenticate:
+
+1. POST to `/api/auth/token` with `username` and `password` (form-urlencoded)
+2. Include the returned token in subsequent requests: `Authorization: Bearer <token>`
+
+Tokens expire after 24 hours.
+
+## Development
+
+### Running Tests
+
+```bash
+# Run all tests
+invoke test
+
+# With verbose output
+invoke test --verbose
+
+# With coverage
+invoke test --coverage
+```
+
+### Project Structure
+
+```
+winebox/
+├── winebox/          # Application package
+│   ├── main.py       # FastAPI app
+│   ├── models/       # Database models
+│   ├── schemas/      # API schemas
+│   ├── routers/      # API endpoints
+│   ├── services/     # Business logic
+│   └── static/       # Web interface
+├── tests/            # Test suite
+├── docs/             # Documentation
+└── tasks.py          # Build tasks
+```
+
+### Building Documentation
+
+```bash
+invoke docs-build
+invoke docs-serve
+```
+
+## Tech Stack
+
+- **FastAPI**: Web framework
+- **SQLAlchemy**: ORM
+- **SQLite**: Database
+- **Tesseract**: OCR engine
+- **Vanilla JS**: Frontend (no frameworks)
+
+## License
+
+MIT License

winebox-0.1.0.dist-info/RECORD

@@ -0,0 +1,34 @@
+winebox/__init__.py,sha256=bAd30zPrCJ2BYtbyxoRUvXt6m6Z4ivEOSdT3HD5uyos,75
+winebox/config.py,sha256=IJ9NzNyX0_g7ji3EmVxZRRL0csB7N5iGxsYStO25hI8,1007
+winebox/database.py,sha256=jTdf9mb48D8644THo6Mx6lHCKDFlAZ18P8Dvuk2eROI,1128
+winebox/main.py,sha256=wlXrBwMvJQhG3g8mmOGWp-QbEEbR805SaElBryR61t0,2398
+winebox/cli/__init__.py,sha256=FOUoclklBXVfsfON3ohA8v_coJ9p5LSbVYvTucyXieg,29
+winebox/cli/server.py,sha256=aN4znSvQRCZFZlQ1gcGag7OCFngwzUJdi084ZdNrnNI,8416
+winebox/cli/user_admin.py,sha256=xwkd4-YN9uL6hX7-AuiDUNekG7x45l1lKor7AsOUxds,8549
+winebox/models/__init__.py,sha256=2avQWHx53-5Z6jnzFlhh5u10Dw99w7en2nqCXEbwqRI,312
+winebox/models/inventory.py,sha256=VLxpEIdYbD-oG9OfIGkHKDKm-cbSSo_aZGx66wRqR7Y,1324
+winebox/models/transaction.py,sha256=9k1AAK0unYNseDubTaiFnGUGDVtuOqrjNUjIDukFDbc,1812
+winebox/models/user.py,sha256=VP7NvbQDJMygTtt9Q5zPiBmtvtOCW5Cvaidi8zXDp98,1570
+winebox/models/wine.py,sha256=R40TTRunPcTG4_D8kEWhopM2k6ne_awET7ctY4fk-HE,2503
+winebox/routers/__init__.py,sha256=TEjBLPCkG007ItXMONZ2TsjOxl_TvHis1v84IOkXm1A,167
+winebox/routers/auth.py,sha256=7rmld-TOIHmCMJfQKuQfkZFoNAAZd0zuj-mKqmAbHeg,2446
+winebox/routers/cellar.py,sha256=QSyAnPQ2hiNaoojLk-5hJy95OnG8RMHOD0h5LV6bAWM,3404
+winebox/routers/search.py,sha256=aIqwsjnB9e-D84VVcuye-01V_9WBUjFKzXNsX0gkRak,4971
+winebox/routers/transactions.py,sha256=K0UDIJbVSTjV7NdI_CS0pvoTflH3Yp89DmneyFyl9ok,2055
+winebox/routers/wines.py,sha256=4Jp1IGDCH2_jJfeAvy1ItfaNmmagUv20r_NTNmEYnew,9385
+winebox/schemas/__init__.py,sha256=R4j1wdV1F-6kA45rHA8NUP2cqxBmLb2CMklo8tFjzGQ,357
+winebox/schemas/transaction.py,sha256=GV_AZGeuFp_nOkg902UUhrHGwB1DxcQmGoG82m1UccI,899
+winebox/schemas/wine.py,sha256=xHWDiV5bvEJuLPN2qWgOhqVMOTdlDSmfan5mtEy3Nvw,2301
+winebox/services/__init__.py,sha256=rlAd5FBcqZJ7rsrFqR8MwTqGJVerlQHVUleEmoIaz1Y,277
+winebox/services/auth.py,sha256=RDXP26hL3cGGxKcniXWMZ0sPUP6ew4LLMnfo4dv4P2E,3854
+winebox/services/image_storage.py,sha256=ftiX54dVuDT0DVLpyBOL9N7zhZkapI0l1TFknfPedno,2393
+winebox/services/ocr.py,sha256=X9lk1dkcH7xRrfYU5ArOakW4qavlRHQIkDD9nbPtzz4,3881
+winebox/services/wine_parser.py,sha256=n5ldv2x2XsTfpK3acYDyMNyZHdJ_8WQU0keOql14MJ0,10456
+winebox/static/index.html,sha256=57uWE1XQXIjP5a1lXMLqwZR2l7w5QaVMH5Qpp0DC4A0,12900
+winebox/static/css/style.css,sha256=xzDVgl0-zT4yLtHWsuU3ASk0YImMnMGP5a8vKpYK6gA,19561
+winebox/static/js/app.js,sha256=GabcNGSn7yQv7_KC7Ew5VjHmdiCjeAWxK2YtTkktVTc,23557
+winebox-0.1.0.dist-info/METADATA,sha256=NsuThjFE0TKjf6SVbFuktb-7VcB5kIuBht9jYk7-k6s,7150
+winebox-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+winebox-0.1.0.dist-info/entry_points.txt,sha256=XY-GMf023m8Iof3rmokkITONECm8gCOVkTX0rCkze30,103
+winebox-0.1.0.dist-info/licenses/LICENSE,sha256=3popbhCShFhWVwTLKeQE-JNDYuPOYfmCiz-LoQpizTA,1070
+winebox-0.1.0.dist-info/RECORD,,

winebox-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

winebox-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+winebox-admin = winebox.cli.user_admin:main
+winebox-server = winebox.cli.server:main

winebox-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Joe Drumgoole
+
+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.