python-check-updates — Copilot Instructions

• Name: Python Check Updates • Summary: A CLI tool for checking and updating Python package dependencies across projects with a focus on real-time insights, robust logging, and seamless user experience. --- --- --- --- ---

• Core Technologies: • CLI Framework: Typer • Logging: Loguru + Rich for enhanced visualization • Dependency Management: Poetry and pyproject.toml • Testing: Pytest with coverage, benchmarking, and advanced plugins • Documentation: Docusaurus for structured, searchable project documentation • Data Analysis: Pandas, Matplotlib, Seaborn, and Plotly for advanced visualizations • Application Structure: • Configuration Management: YAML-based configurations with pyyaml and pydantic-settings • CLI Commands: Organized using Typer with type validation • Logging: Configurable with Loguru and RichHandler for real-time feedback • Testing: Modular unit tests covering all core functionalities with advanced pytest plugins • Data Visualization: Create interactive, dynamic plots for dependency reports • Documentation: Full-featured documentation site generated with Docusaurus • Extensibility: Modular architecture supporting multiple Python package management systems --- --- --- --- ---

• Core CLI Commands: • Check updates: Identify outdated dependencies. • Update dependencies: Apply updates with version constraints. • Export report: Generate visual and tabular reports of outdated packages. • Customizable Behavior: • Configurable via config.yaml. • Support for ignore lists, version constraints, and environment-based overrides. • Enable or disable features dynamically via CLI flags. • Enhanced Logging: • Rich integration for color-coded output. • Comprehensive, structured logs for debugging, analytics, and tracking. • Log rotation, archival, and real-time streaming options. • Detailed execution timelines and error stack traces. • Dynamic verbosity levels configurable via CLI or environment. • Comprehensive Reporting: • Generate exportable CSV, JSON, and visualized PDF reports. • Include charts and graphs using Matplotlib, Plotly, and Seaborn. • Provide package-specific insights, dependency trends, and change logs. • Configurable report templates for different use cases. • Multi-Package Manager Support: • Modular design to support Poetry and Pip. • Unified interface for interacting with various Python package managers. • Dynamic Dependency Graphs: • Visualize dependency trees with annotations for outdated packages. • Extensibility: • Abstracted architecture for adding new Python package management systems easily. • Hooks for custom pre- and post-processing logic. --- --- --- --- ---

• CLI Commands: • Built with Typer for simplicity and robustness. • Support for argument validation and type hints. • Descriptive help messages with examples. • Advanced subcommands for flexible workflows. • Logging: • Configurable Loguru setup with RichHandler. • Real-time feedback for long-running operations. • Debugging logs with full stack trace support. • Log streaming to file and console with real-time filters. • Configuration Management: • YAML-based settings validated with pydantic-settings. • Dynamic overrides via CLI flags or environment variables. • Support .env files for sensitive settings. • Data Visualization: • Use Pandas, Matplotlib, and Plotly for generating charts and insights. • Integrate Seaborn for enhanced visual analytics. • Add heatmaps and trend lines for historical dependency analysis. • Error Handling: • Graceful handling of invalid configurations. • Descriptive user-facing error messages. • Fallback mechanisms for partial updates. • Testing: • Comprehensive unit test coverage using Pytest. • Benchmarking with pytest-benchmark. • Parallel execution with pytest-xdist. • Coverage reporting with pytest-cov. • Hypothesis for property-based testing of edge cases. • Documentation: • Use Docusaurus to generate a searchable, interactive documentation site. • Include API references, user guides, and contribution documentation. • Ensure seamless updates and versioning of the docs. • Extensibility: • Add new Python package manager integrations with minimal code changes. • Modular package management logic in package_managers folder. --- --- --- --- ---