New commands: import, import --scan, fmt

[tony]

Changes

New: Added vcspull import

• Unified command for importing repositories into vcspull configuration, following the infrastructure-as-code pattern similar to Terraform's import command.
• Manual import: Register a single repository with vcspull import <name> <url>
  • Optional --dir/--path helpers for base directory detection
  • Example: uv run vcspull import myrepo [email protected]:user/myrepo.git --dir ~/code
• Filesystem scan: Discover and import existing repositories with vcspull import --scan <dir>
  • Recursively scan with --recursive/-r
  • Interactive confirmation prompt or --yes for unattended runs
  • Custom base directory with --base-dir-key
  • Example: uv run vcspull import --scan ~/study/typescript --recursive --yes

New: Added vcspull fmt

• Introduces a fmt subcommand to normalize configuration files (sort directories/repos, convert compact entries to verbose {repo: ...} form, and standardize keys).
• Example: uv run vcspull fmt --config ~/.vcspull.yaml --write

Logging Improvements

• Enhanced logging system with better CLI module propagation and StreamHandler configuration.
• Improved output visibility in tests and CLI usage with proper handler management.
• Ensure handlers survive pytest stream rotation via safe flush/reset logic.
• Added regression test test_import_scan_stream_output to guarantee user-facing output remains visible.

Config & CLI Enhancements

• ConfigReader now reads files using UTF-8 explicitly.
• Shared helper save_config_yaml centralizes YAML writes with UTF-8 encoding.
• CLI parser now wires in the new subcommands and routes to dedicated modules.
• Module naming: _import.py (leading underscore) avoids Python's import keyword conflict.

Fixes: #25, #333

Testing

• uv run ruff check . --fix --show-fixes
• uv run mypy
• uv run pytest (132 tests passing)

Additional Notes

• Extensive new CLI tests cover import/fmt behaviors, including duplicate detection, confirmation prompts, and formatting summaries.
• Logging test suite expanded to validate handler configuration, propagation, and formatter integration.
• Command naming aligns with IaC terminology: import clearly communicates bringing repositories under vcspull management, whether manually specified or discovered from the filesystem.

[codecov]

Codecov Report

❌ Patch coverage is 78.50000% with 43 lines in your changes missing coverage. Please review.
✅ Project coverage is 80.23%. Comparing base (e6d2c45) to head (e4eca51).
⚠️ Report is 4 commits behind head on master.

Files with missing lines	Patch %	Lines
src/vcspull/cli/fmt.py	74.80%	20 Missing and 13 partials ⚠️
src/vcspull/log.py	87.30%	3 Missing and 5 partials ⚠️
src/vcspull/cli/sync.py	0.00%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #465      +/-   ##
==========================================
+ Coverage   78.93%   80.23%   +1.29%     
==========================================
  Files           8        9       +1     
  Lines         413      597     +184     
  Branches       85      134      +49     
==========================================
+ Hits          326      479     +153     
- Misses         52       67      +15     
- Partials       35       51      +16     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.