woolly 0.2.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

woolly-0.4.0.dist-info/METADATA

@@ -0,0 +1,324 @@
+Metadata-Version: 2.4
+Name: woolly
+Version: 0.4.0
+Summary: Check if package dependencies are available in Fedora. Supports Rust, Python, and more.
+Author-email: Rodolfo Olivieri <rodolfo.olivieri3@gmail.com>
+License-File: LICENSE
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: cyclopts>=4.3.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: rich>=14.2.0
+Provides-Extra: template
+Requires-Dist: jinja2>=3.1.0; extra == 'template'
+Description-Content-Type: text/markdown
+
+# 🐑 Woolly
+
+**Check if package dependencies are available in Fedora.**
+
+Woolly analyzes package dependencies from various language ecosystems and checks their availability in Fedora repositories, helping packagers estimate the effort needed to bring a package to Fedora.
+
+> ⚠️ **Experimental Software**
+>
+> This project is still experimental and may not get things right all the time.
+> Results should be verified manually, especially for complex dependency trees.
+> Platform-specific dependencies (like `windows-*` crates) may be flagged as missing
+> even though they're not needed on Linux.
+
+## What does "woolly" mean?
+
+Nothing. I just liked the name. 🐑
+
+## Features
+
+- **Multi-language support** — Analyze dependencies from Rust (crates.io) and Python (PyPI)
+- **Multiple output formats** — Console output, JSON, and Markdown reports
+- **Optional dependency tracking** — Optionally include and separately track optional dependencies
+- **Smart caching** — Caches API responses and dnf queries to speed up repeated analyses
+- **Progress tracking** — Real-time progress bar showing analysis status
+- **Debug logging** — Verbose logging mode for troubleshooting
+- **Extensible architecture** — Easy to add new languages and report formats
+
+## Supported Languages
+
+| Language | Registry  | CLI Flag              | Aliases                 |
+|----------|-----------|-----------------------|-------------------------|
+| Rust     | crates.io | `--lang rust`         | `-l rs`, `-l crate`     |
+| Python   | PyPI      | `--lang python`       | `-l py`, `-l pypi`      |
+
+## Output Formats
+
+| Format   | Description                      | CLI Flag             | Aliases              |
+|----------|----------------------------------|----------------------|----------------------|
+| stdout   | Rich console output (default)    | `--report stdout`    | `-r console`         |
+| json     | JSON file for programmatic use   | `--report json`      |                      |
+| markdown | Markdown file for documentation  | `--report markdown`  | `-r md`              |
+
+## Installation
+
+```bash
+# Using uv (recommended)
+uv pip install .
+
+# Or run directly without installing
+uv run woolly --help
+
+# Using pip
+pip install .
+```
+
+### Requirements
+
+- Python 3.10+
+- `dnf` available on the system (for Fedora package queries)
+
+## Usage
+
+### Basic Usage
+
+```bash
+# Check a Rust crate (default language)
+woolly check ripgrep
+
+# Check a Python package
+woolly check --lang python requests
+
+# Use language aliases
+woolly check -l py flask
+woolly check -l rs tokio
+```
+
+### Options
+
+```bash
+# Check a specific version
+woolly check serde --version 1.0.200
+
+# Include optional dependencies in the analysis
+woolly check --optional requests -l python
+
+# Limit recursion depth
+woolly check --max-depth 10 tokio
+
+# Disable progress bar
+woolly check --no-progress serde
+
+# Enable debug logging
+woolly check --debug flask -l py
+
+# Output as JSON
+woolly check --report json serde
+
+# Output as Markdown
+woolly check -r md requests -l py
+```
+
+### Other Commands
+
+```bash
+# List available languages
+woolly list-languages
+
+# List available output formats
+woolly list-formats
+
+# Clear the cache
+woolly clear-cache
+```
+
+## Example Output
+
+### Rust
+
+```bash
+$ woolly check cliclack
+
+Analyzing Rust package: cliclack
+Registry: crates.io
+Cache directory: /home/user/.cache/woolly
+
+  Analyzing Rust dependencies ━━━━━━━━━━━━━━━━━ 100% • 0:00:15 complete!
+
+  Dependency Summary for 'cliclack' (Rust)
+╭────────────────────────────┬───────╮
+│ Metric                     │ Value │
+├────────────────────────────┼───────┤
+│ Total dependencies checked │     7 │
+│ Packaged in Fedora         │     0 │
+│ Missing from Fedora        │     1 │
+╰────────────────────────────┴───────╯
+
+Missing packages that need packaging:
+  • cliclack
+
+Dependency Tree:
+cliclack v0.3.6 • ✗ not packaged
+├── console v0.16.1 • ✓ packaged (0.16.1)
+│   ├── encode_unicode v1.0.0 • ✓ packaged (1.0.0)
+│   └── windows-sys v0.61.2 • ✗ not packaged
+...
+```
+
+### Python
+
+```bash
+$ woolly check --lang python requests
+
+Analyzing Python package: requests
+Registry: PyPI
+Cache directory: /home/user/.cache/woolly
+
+  Analyzing Python dependencies ━━━━━━━━━━━━━━ 100% • 0:00:05 complete!
+
+  Dependency Summary for 'requests' (Python)
+╭────────────────────────────┬───────╮
+│ Metric                     │ Value │
+├────────────────────────────┼───────┤
+│ Total dependencies checked │     5 │
+│ Packaged in Fedora         │     5 │
+│ Missing from Fedora        │     0 │
+╰────────────────────────────┴───────╯
+
+Dependency Tree:
+requests v2.32.3 • ✓ packaged (2.32.3) [python3-requests]
+├── charset-normalizer v3.4.0 • ✓ packaged (3.4.0) [python3-charset-normalizer]
+├── idna v3.10 • ✓ packaged (3.10) [python3-idna]
+├── urllib3 v2.2.3 • ✓ packaged (2.2.3) [python3-urllib3]
+└── certifi v2024.8.30 • ✓ packaged (2024.8.30) [python3-certifi]
+```
+
+### With Optional Dependencies
+
+```bash
+$ woolly check --lang python --optional flask
+
+  Dependency Summary for 'flask' (Python)
+╭────────────────────────────┬───────╮
+│ Metric                     │ Value │
+├────────────────────────────┼───────┤
+│ Total dependencies checked │    15 │
+│ Packaged in Fedora         │    12 │
+│ Missing from Fedora        │     3 │
+│                            │       │
+│ Optional dependencies      │     4 │
+│   ├─ Packaged              │     2 │
+│   └─ Missing               │     2 │
+╰────────────────────────────┴───────╯
+```
+
+## Adding a New Language
+
+To add support for a new language, create a new provider in `woolly/languages/`:
+
+```python
+# woolly/languages/go.py
+from typing import Optional
+
+from woolly.languages.base import Dependency, LanguageProvider, PackageInfo
+
+
+class GoProvider(LanguageProvider):
+    """Provider for Go modules."""
+
+    # Required class attributes
+    name = "go"
+    display_name = "Go"
+    registry_name = "Go Modules"
+    fedora_provides_prefix = "golang"
+    cache_namespace = "go"
+
+    # Required methods to implement:
+
+    def fetch_package_info(self, package_name: str) -> Optional[PackageInfo]:
+        """Fetch package info from proxy.golang.org."""
+        ...
+
+    def fetch_dependencies(self, package_name: str, version: str) -> list[Dependency]:
+        """Fetch dependencies from go.mod."""
+        ...
+
+    # Optional: Override these if your language has special naming conventions
+
+    def normalize_package_name(self, package_name: str) -> str:
+        """Normalize package name for Fedora lookup."""
+        return package_name
+
+    def get_alternative_names(self, package_name: str) -> list[str]:
+        """Alternative names to try if package not found."""
+        return []
+```
+
+Then register it in `woolly/languages/__init__.py`:
+
+```python
+from woolly.languages.go import GoProvider
+
+PROVIDERS: dict[str, type[LanguageProvider]] = {
+    "rust": RustProvider,
+    "python": PythonProvider,
+    "go": GoProvider,  # Add new provider
+}
+
+ALIASES: dict[str, str] = {
+    # ... existing aliases
+    "golang": "go",
+}
+```
+
+## Adding a New Output Format
+
+To add a new output format, create a reporter in `woolly/reporters/`:
+
+```python
+# woolly/reporters/html.py
+from woolly.reporters.base import Reporter, ReportData
+
+
+class HtmlReporter(Reporter):
+    """HTML report with interactive tree."""
+
+    name = "html"
+    description = "HTML report with interactive dependency tree"
+    file_extension = "html"
+    writes_to_file = True
+
+    def generate(self, data: ReportData) -> str:
+        """Generate HTML content."""
+        ...
+```
+
+Then register it in `woolly/reporters/__init__.py`.
+
+## Notes
+
+- Results should be verified manually — some packages may have different names in Fedora
+- Platform-specific dependencies (like `windows-*` crates) are shown as missing but aren't needed on Linux
+- The tool uses `dnf repoquery` to check Fedora packages, so it must run on a Fedora system or have access to Fedora repos
+- Cache is stored in `~/.cache/woolly` and can be cleared with `woolly clear-cache`
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.
+
+## Credits
+
+- **[Rodolfo Olivieri (@r0x0d)](https://github.com/r0x0d)** — Creator and maintainer
+- **[Claude](https://claude.ai)** — AI pair programmer by [Anthropic](https://anthropic.com)

woolly-0.4.0.dist-info/RECORD

@@ -0,0 +1,26 @@
+woolly/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+woolly/__main__.py,sha256=em9-CiwyaP3N5FKr_Srv6Eh8Vm6TOC3VWSwXR1BjzV8,304
+woolly/cache.py,sha256=tzZE0FrymWQZSpJ5ZFgv2G17CVYq7SzsxpVWsF7ByXI,2405
+woolly/debug.py,sha256=85_0_lsqccT8TAkyWFinOIqkPVPpcmrKuNfIYQOEqZ4,5294
+woolly/http.py,sha256=xPFbHPWEWTN4mjEONyJ9hERmb62mMWun0jRjTAaaNE8,872
+woolly/progress.py,sha256=Ij-K3-6-qeVLFKD_WdSfuclZh6uiso9XSSVRlpbB4jA,2040
+woolly/commands/__init__.py,sha256=3xzeIPYD0dmVWwRXHkdPmsF2IIRU6KyvDwgemKdyghI,840
+woolly/commands/check.py,sha256=6E61LJnVzkMbJDdk90eH9mFD34qemve4h15SButcthU,15975
+woolly/commands/clear_cache.py,sha256=nCS52v_hNvKTwj62CKrQRfjX53fGpZnWpfB0GMmi8e4,1039
+woolly/commands/list_formats.py,sha256=f4UAWjoBbDu8YhobQyccErwpmOqElrCxBg0xcnJVDUQ,695
+woolly/commands/list_languages.py,sha256=VFjvMgXnvaW3O-MBEpzf5nd89yQ9TqLqcULPDCDUthg,857
+woolly/languages/__init__.py,sha256=CwcPDIMvFpCK1tFbx5rew_5mLrrMy6s4HT6C-ZZz_7M,2527
+woolly/languages/base.py,sha256=Sjm9wXWeM36w6eYx_YyHm0jM6TqAUshlCiSPczW1_IA,12365
+woolly/languages/python.py,sha256=aA1fmHO0VWV_sHjZF92G30frv916Veh6cqjIj354UgM,6723
+woolly/languages/rust.py,sha256=DdhflO0PDvpgGy41lst9vUW9vF1Xrf94RJIMAsWSRDc,4508
+woolly/reporters/__init__.py,sha256=-85BHuDAQwyrgWtJqME76FT4jyrvS4cuas7CxaWDODU,3301
+woolly/reporters/base.py,sha256=3j_tHH-epyYg-KGNW_ApsOCp_p_hJwAG_Azx1jUoDjs,6318
+woolly/reporters/json.py,sha256=Zh0OpOIEKlJiUHTr_FZF_Ys-hJN0drLi1mZg5zZL6LM,5915
+woolly/reporters/markdown.py,sha256=_lXzoFDkQXzBgpg7EX0Fl4U_Oj3NUtAMUOw8u6GuPec,4520
+woolly/reporters/stdout.py,sha256=IOE8gk3U85gpDsZXRWCHBxxCYRieR6PqUhVhZplYGcM,2869
+woolly/reporters/template.py,sha256=U48rP9DMwk4p-fk26jldfU_uXllHBT5N1LHTVomFTFI,7702
+woolly-0.4.0.dist-info/METADATA,sha256=nVgVJAKQA1fsWXmfmyYUzDMY3f1zrVGs-3081Lo85a8,10477
+woolly-0.4.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+woolly-0.4.0.dist-info/entry_points.txt,sha256=tMSCR0PXsaIWiiY5fwQ5eowwNqPSrH0j9QriPDoE75k,48
+woolly-0.4.0.dist-info/licenses/LICENSE,sha256=TnfrdmTYydTTenujKk2LdAuDuLSMwjpXhW7EU2VR0e8,1064
+woolly-0.4.0.dist-info/RECORD,,

woolly-0.2.0.dist-info/METADATA

@@ -1,213 +0,0 @@
-Metadata-Version: 2.4
-Name: woolly
-Version: 0.2.0
-Summary: Check if package dependencies are available in Fedora. Supports Rust, Python, and more.
-Author-email: Rodolfo Olivieri <rodolfo.olivieri3@gmail.com>
-License-File: LICENSE
-Classifier: Development Status :: 2 - Pre-Alpha
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Information Technology
-Classifier: Intended Audience :: System Administrators
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: English
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: System :: Systems Administration
-Classifier: Topic :: Utilities
-Requires-Python: >=3.10
-Requires-Dist: cyclopts>=4.3.0
-Requires-Dist: httpx>=0.28.0
-Requires-Dist: pydantic>=2.10.0
-Requires-Dist: rich>=14.2.0
-Description-Content-Type: text/markdown
-
-# Woolly
-
-Check if package dependencies are available in Fedora. Supports multiple languages including Rust and Python.
-
-> This tool is merely a starting point for figuring out how much packaging
-> effort you will need to bring a package over to Fedora.
-
-## What does "woolly" means?
-
-Nothing. I just liked the name.
-
-## Supported Languages
-
-| Language | Registry | CLI Flag |
-|----------|----------|----------|
-| Rust | crates.io | `--lang rust` (default) |
-| Python | PyPI | `--lang python` |
-
-More languages can be easily added by implementing the `LanguageProvider` interface.
-
-## Installation
-
-```bash
-# Using uv
-uv pip install .
-
-# Or run directly
-uv run woolly --help
-```
-
-## Usage
-
-```bash
-# Check a Rust crate (default)
-woolly ripgrep
-
-# Check a Rust crate explicitly
-woolly --lang rust serde
-
-# Check a Python package
-woolly --lang python requests
-
-# Use language aliases
-woolly -l py flask
-woolly -l rs tokio
-
-# List available languages
-woolly --list-languages
-
-# Clear cache
-woolly --clear-cache
-```
-
-## Example Output
-
-### Rust
-
-```bash
-$ woolly cliclack
-
-Analyzing Rust package: cliclack
-Registry: crates.io
-Cache directory: /home/user/.cache/woolly
-
-  Analyzing Rust dependencies ━━━━━━━━━━━━━━━━━ 100% • 0:00:15 complete!
-
-  Dependency Summary for 'cliclack' (Rust)   
-╭────────────────────────────┬───────╮
-│ Metric                     │ Value │
-├────────────────────────────┼───────┤
-│ Total dependencies checked │     7 │
-│ Packaged in Fedora         │     0 │
-│ Missing from Fedora        │     1 │
-╰────────────────────────────┴───────╯
-
-Missing packages that need packaging:
-  • cliclack
-
-Dependency Tree:
-cliclack v0.3.6 • ✗ not packaged
-├── console v0.16.1 • ✓ packaged (0.16.1) 
-│   ├── encode_unicode v1.0.0 • ✓ packaged (1.0.0) 
-│   └── windows-sys v0.61.2 • ✗ not packaged
-...
-```
-
-### Python
-
-```bash
-$ woolly --lang python requests
-
-Analyzing Python package: requests
-Registry: PyPI
-Cache directory: /home/user/.cache/woolly
-
-  Analyzing Python dependencies ━━━━━━━━━━━━━━ 100% • 0:00:05 complete!
-
-  Dependency Summary for 'requests' (Python)   
-╭────────────────────────────┬───────╮
-│ Metric                     │ Value │
-├────────────────────────────┼───────┤
-│ Total dependencies checked │     5 │
-│ Packaged in Fedora         │     5 │
-│ Missing from Fedora        │     0 │
-╰────────────────────────────┴───────╯
-
-Dependency Tree:
-requests v2.32.3 • ✓ packaged (2.32.3) [python3-requests]
-├── charset-normalizer v3.4.0 • ✓ packaged (3.4.0) [python3-charset-normalizer]
-├── idna v3.10 • ✓ packaged (3.10) [python3-idna]
-├── urllib3 v2.2.3 • ✓ packaged (2.2.3) [python3-urllib3]
-└── certifi v2024.8.30 • ✓ packaged (2024.8.30) [python3-certifi]
-```
-
-## Adding a New Language
-
-To add support for a new language, create a new provider in `woolly/languages/`:
-
-```python
-# woolly/languages/go.py
-from typing import Optional
-
-import requests
-
-from woolly.cache import DEFAULT_CACHE_TTL, read_cache, write_cache
-from woolly.languages.base import Dependency, LanguageProvider, PackageInfo
-
-
-class GoProvider(LanguageProvider):
-    """Provider for Go modules."""
-    
-    # Required class attributes
-    name = "go"
-    display_name = "Go"
-    registry_name = "Go Modules"
-    fedora_provides_prefix = "golang"
-    cache_namespace = "go"
-    
-    # Only these two methods are required to implement:
-    
-    def fetch_package_info(self, package_name: str) -> Optional[PackageInfo]:
-        """Fetch package info from proxy.golang.org."""
-        # Your implementation here
-        ...
-    
-    def fetch_dependencies(self, package_name: str, version: str) -> list[Dependency]:
-        """Fetch dependencies from go.mod."""
-        # Your implementation here
-        ...
-    
-    # Optional: Override these if your language has special naming conventions
-    
-    def normalize_package_name(self, package_name: str) -> str:
-        """Normalize package name for Fedora lookup."""
-        return package_name
-    
-    def get_alternative_names(self, package_name: str) -> list[str]:
-        """Alternative names to try if package not found."""
-        return []
-```
-
-Then register it in `woolly/languages/__init__.py`:
-
-```python
-from woolly.languages.go import GoProvider
-
-PROVIDERS: dict[str, type[LanguageProvider]] = {
-    "rust": RustProvider,
-    "python": PythonProvider,
-    "go": GoProvider,  # Add new provider
-}
-
-ALIASES: dict[str, str] = {
-    # ... existing aliases
-    "golang": "go",
-}
-```
-
-## Notes
-
-Keep in mind that you may not need all of the packages to be present in Fedora.
-For example, Rust crates may have platform-specific dependencies (like `windows*` crates)
-that aren't used on Linux.

woolly-0.2.0.dist-info/RECORD

@@ -1,24 +0,0 @@
-woolly/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-woolly/__main__.py,sha256=em9-CiwyaP3N5FKr_Srv6Eh8Vm6TOC3VWSwXR1BjzV8,304
-woolly/cache.py,sha256=n8zYDs4k4WTgbeGKb-1hZ-raleCFyZijK8kwpoY8-ZU,2166
-woolly/debug.py,sha256=85_0_lsqccT8TAkyWFinOIqkPVPpcmrKuNfIYQOEqZ4,5294
-woolly/progress.py,sha256=Ij-K3-6-qeVLFKD_WdSfuclZh6uiso9XSSVRlpbB4jA,2040
-woolly/commands/__init__.py,sha256=3xzeIPYD0dmVWwRXHkdPmsF2IIRU6KyvDwgemKdyghI,840
-woolly/commands/check.py,sha256=sPy9ROqRLKEvqh2ALOZn8btg3Q_xyjThV-e1qAt-uu0,10645
-woolly/commands/clear_cache.py,sha256=nCS52v_hNvKTwj62CKrQRfjX53fGpZnWpfB0GMmi8e4,1039
-woolly/commands/list_formats.py,sha256=RINiD7o1AWdOHEFmqS5zAdU2AiK3rh0Wy9RULceFx0s,702
-woolly/commands/list_languages.py,sha256=xigFQfdPv_y-Fm2ewom0k6SSkkQTHUFxg_Ac1we4Xtc,850
-woolly/languages/__init__.py,sha256=O_9WBiG50yXWs_-2jScmqzjFVwyhTexq0WN7h_3IIUk,1975
-woolly/languages/base.py,sha256=gNqWDiwYlZ0t7Lxa4VNNpgd-zYQ0ZmF_zSJNWscWB5g,12173
-woolly/languages/python.py,sha256=UZLf2PgnfdLgO2FIViUNSas89bNmbIDRa7bVsrjNQJc,6765
-woolly/languages/rust.py,sha256=cbUrh3ZXTzQwSSuKGbEYIan2HA11wpcA18zsQLa9Y6Q,4609
-woolly/reporters/__init__.py,sha256=_8_sEl7OhKwjlUN2B3mFIVVkO816zbbyO0o_PhoAOSw,2444
-woolly/reporters/base.py,sha256=TC0T01-zL2kNcHmps_VyKHm0M822TaqoCaGAlGJB4Ug,3719
-woolly/reporters/json.py,sha256=sZYQCwFyECYiwI1RyS3_-tCHNWkZZWjzZQiD6dByUQY,5225
-woolly/reporters/markdown.py,sha256=LWqttjtCCiwq78kQ2IGfiJ8i1rLXtYIT0utU7RYGjbU,4852
-woolly/reporters/stdout.py,sha256=iXEJMhjDbxGHwsh3iA0_YvFxiFKcpyKNrFoqeMLF0BY,1802
-woolly-0.2.0.dist-info/METADATA,sha256=4qfu-ke1Ax859OQDtIhdEFOq0AH-YCISNqm1Pdlmdkg,6528
-woolly-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-woolly-0.2.0.dist-info/entry_points.txt,sha256=tMSCR0PXsaIWiiY5fwQ5eowwNqPSrH0j9QriPDoE75k,48
-woolly-0.2.0.dist-info/licenses/LICENSE,sha256=TnfrdmTYydTTenujKk2LdAuDuLSMwjpXhW7EU2VR0e8,1064
-woolly-0.2.0.dist-info/RECORD,,