feat(analytics): add local validation analytics and CLI

[adisingh396]

📌 Pull Request

Description

This PR introduces a local, opt-in analytics feature to help developers monitor postal code validation usage within their projects. It tracks valid and invalid counts per country and provides both a CLI dashboard and Python functions for interaction, as outlined in the issue. All data is stored locally in the user's home directory (~/.postalregex_stats.json) with no network requests.

Related Issue

Fixes #8

Changes Made

• Added src/postal_regex/analytics.py to handle all stat tracking logic (load, save, reset).
• Added src/postal_regex/cli.py to create the postal-regex stats command.
• Updated pyproject.toml to register the new CLI command.
• Modified core.validate() to automatically call record_validation() on every attempt.
• Exposed the new analytics functions in __init__.py.

Checklist

• Tests added/updated
• Code follows project style guidelines
• pytest -v passes locally
• Documentation updated (if needed)

Additional Notes

Some Screenshots

[ankitgadling]

Remove print() from core analytics and keep validate() pure; use record_validation() optionally and let the CLI handle all output/visualization.

[adisingh396]

Hey @ankitgadling,
thanks for the feedback, it makes sense:

I've pushed up the changes:

1. The call to record_validation() has been removed from core.validate() to keep it pure and make the analytics opt-in.
2. I've refactored the analytics module, creating a new get_stats() function that returns the raw data. The show_stats() function and the CLI now use this, separating the logic from the presentation.
   Let me know what you think

[ankitgadling]

all changes looks good. Do Format and lint your code

[adisingh396]

@ankitgadling alright removed the unused import and added the new get_stats function in __init__.py imports.

[ankitgadling]

@zendrix396 Thanks for the update! but tests on Python 3.12 are failing Please check the CI logs, run tests locally, and update the PR so we can merge.

[adisingh396]

@ankitgadling fixed the tests!