lunar-times 1.0.0

Calculate lunar rise and set times for any location

Lunar Times

A command-line Python application that calculates moonrise and moonset times for any location. The application integrates with external APIs to provide accurate astronomical data with proper timezone handling.

Features

• 🌙 Calculate moonrise and moonset times for any US city and state
• 📍 Automatic coordinate resolution using OpenStreetMap geocoding
• 🕐 Timezone-aware calculations with proper daylight saving time handling
• 🔧 Debug mode for development and testing
• 🚀 Clean command-line interface with clear output formatting
• ✅ Enterprise-grade CI/CD with automated testing across multiple Python versions and platforms

Quick Start

# Install dependencies
make install

# Run the application
make run

# Or use debug mode (defaults to El Paso, TX)
make run-debug

# Run tests
make test

# Check code quality
make check

Example Usage

$ lunar-times
Enter the city: Austin
Enter the state: TX
# Moon rise/set times in (Timezone: America/Chicago -6.0) on 2024-01-15:
-  RISE: 10:45 PM
-  SET: 11:30 AM

Documentation

• Usage Guide - Detailed usage instructions and examples
• Testing Documentation - Comprehensive testing documentation and coverage analysis
• Setup Guide - Installation and configuration instructions
• Invisible Character Detection - Tools for detecting and removing invisible characters in AI-generated code
• Architecture - Technical architecture and design documentation
• Changelog - Version history and release notes
• Failure Analysis - Troubleshooting and known issues

Development & CI/CD

This project uses GitHub Actions for comprehensive automated testing and deployment. All workflows are live and operational:

Continuous Integration ✅

• Multi-Python Testing: Automated testing on Python 3.8, 3.9, 3.10, 3.11, and 3.12
• Cross-Platform: Tests run on Ubuntu, Windows, and macOS
• Quality Gates: Linting, type checking, test coverage, and security scanning
• Fast Feedback: Quick validation jobs provide rapid feedback on pull requests

Automated Deployment ✅

• PyPI Publishing: Automatic package publishing on version tags
• GitHub Releases: Automated release creation with changelog integration
• Health Monitoring: Weekly API health checks with automatic issue creation

Operational Workflows

• CI Pipeline (.github/workflows/ci.yml) - 212 lines of comprehensive testing automation
• Release Pipeline (.github/workflows/release.yml) - 104 lines of deployment automation
• Health Monitoring (.github/workflows/health-check.yml) - 57 lines of API monitoring

Development Workflow

# All development commands work with CI
make test          # Runs same tests as CI
make check         # Runs all quality checks  
make build-package # Builds package like CI

View live workflow runs and automation details.

Requirements

• Python 3.8+
• uv package manager
• Internet connection for API calls
• Dependencies: requests, geopy, timezonefinder, pytz

License

This project is licensed under the terms in the LICENSE file.