zebra-day 0.3.9.1__tar.gz → 2.0.0__tar.gz

zebra_day-2.0.0/MANIFEST.in

@@ -0,0 +1,25 @@
+# Include documentation
+include README.md
+include LICENSE
+include MODERNIZE.md
+
+# Include package data
+recursive-include zebra_day/bin *
+recursive-include zebra_day/etc *
+recursive-include zebra_day/static *
+recursive-include zebra_day/files *
+recursive-include zebra_day/logs *
+
+# Include requirements files
+include requirements.txt
+include requirements-dev.txt
+include pyproject.toml
+
+# Exclude compiled files and caches
+global-exclude *.pyc
+global-exclude *.pyo
+global-exclude __pycache__
+global-exclude *.so
+global-exclude .git*
+global-exclude .DS_Store
+

zebra_day-2.0.0/MODERNIZE.md

@@ -0,0 +1,76 @@
+# MODERNIZE.md - zebra_day Modernization Status
+
+> **Status**: ALL PHASES COMPLETE as of 1.0.0
+
+This document tracked the modernization of zebra_day from 0.5.0 to 1.0.0.
+
+---
+
+## Completed Modernization Summary
+
+### Phase 0 - Hygiene + Guardrails
+- [x] Removed duplicate dependencies
+- [x] Moved dev-only deps to optional extras
+- [x] Implemented structured logging
+- [x] Created custom exceptions
+- [x] Added comprehensive unit tests (16 tests passing)
+
+### Phase 1 - Packaging Modernization
+- [x] Migrated to pyproject.toml (PEP 517/518)
+- [x] Defined optional extras: dev, lint, docs, auth, all
+- [x] Package builds correctly as wheel and sdist
+- [x] PyPI-ready (twine check passes)
+
+### Phase 2 - XDG Filesystem Safety
+- [x] Implemented zebra_day/paths.py with XDG Base Directory support
+- [x] Config: ~/.config/zebra_day/ (Linux) or ~/Library/Preferences/zebra_day/ (macOS)
+- [x] Data: ~/.local/share/zebra_day/ (Linux) or ~/Library/Application Support/zebra_day/ (macOS)
+- [x] Logs: ~/.local/state/zebra_day/ (Linux) or ~/Library/Logs/zebra_day/ (macOS)
+- [x] Replaced os.system() calls with pathlib + shutil
+
+### Phase 3 - Web Stack Modernization
+- [x] Migrated from CherryPy to FastAPI + Uvicorn
+- [x] Implemented Jinja2 templates (26 templates total)
+- [x] Created versioned API (/api/v1/...)
+- [x] Added OpenAPI documentation (/docs, /redoc)
+- [x] Implemented optional Cognito authentication
+- [x] Created modern UI with Ursa-inspired design system
+- [x] Preserved legacy UI at /legacy prefix
+
+### Phase 4 - Observability
+- [x] Added health endpoints (/healthz, /readyz)
+- [x] Implemented request logging middleware
+- [x] Added structured logging with timestamps
+
+### Phase 5 - CI/CD
+- [x] GitHub Actions workflow with lint, test, build, publish jobs
+- [x] Python version matrix (3.10, 3.11, 3.12, 3.13)
+- [x] Ruff linting, Black formatting, mypy type checking
+- [x] Automated PyPI publishing on release
+
+### Bonus: Local ZPL Rendering
+- [x] Replaced external Labelary API with local renderer
+- [x] Implemented zebra_day/zpl_renderer.py using Pillow + zint-bindings
+
+---
+
+## Commands Reference
+
+```bash
+# Development
+pytest -v                           # Run tests
+ruff check zebra_day tests          # Lint
+black --check zebra_day tests       # Format check
+mypy zebra_day                      # Type check
+
+# CLI
+zday --help                         # Show all commands
+zday info                           # Show config paths and status
+zday bootstrap                      # First-time setup
+zday gui start                      # Start web server
+zday gui stop                       # Stop web server
+
+# Build
+python -m build                     # Build wheel and sdist
+twine check dist/*                  # Verify package
+```