woolly 0.1.0__tar.gz → 0.2.0__tar.gz

woolly-0.2.0/.github/workflows/lint.yml

@@ -0,0 +1,68 @@
+name: Lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  ruff:
+    name: Ruff (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --group dev --python ${{ matrix.python-version }}
+
+      - name: Run ruff check
+        run: uv run ruff check woolly tests
+
+      - name: Run ruff format check
+        run: uv run ruff format --check woolly tests
+
+  pyright:
+    name: Pyright (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --group dev --group test --python ${{ matrix.python-version }}
+
+      - name: Run pyright
+        run: uv run pyright woolly --pythonversion ${{ matrix.python-version }}
+

woolly-0.2.0/.github/workflows/tests.yml

@@ -0,0 +1,111 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  unit-tests:
+    name: Unit Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --group test
+
+      - name: Run unit tests with coverage
+        run: uv run pytest tests/unit --cov=woolly --cov-report=xml --cov-report=term-missing
+
+      - name: Upload coverage reports
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false
+          env_vars: OS,PYTHON
+          disable_search: true
+          flags: unit
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  functional-tests:
+    name: Functional Tests (Fedora)
+    runs-on: ubuntu-latest
+    container:
+      image: fedora:latest
+
+    steps:
+      - name: Install system dependencies
+        run: |
+          dnf install -y \
+            git \
+            python3 \
+            python3-pip \
+            dnf-plugins-core \
+            findutils
+
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sh
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Install dependencies
+        run: |
+          export PATH="$HOME/.local/bin:$PATH"
+          uv sync --group test
+
+      - name: Run fast functional tests
+        run: |
+          export PATH="$HOME/.local/bin:$PATH"
+          uv run pytest tests/functional --cov=woolly --cov-report=xml --cov-report=term-missing -v --tb=short -m "not slow"
+
+      - name: Run slow functional tests (API + Fedora integration)
+        run: |
+          export PATH="$HOME/.local/bin:$PATH"
+          uv run pytest tests/functional --cov=woolly --cov-report=xml --cov-report=term-missing -v --tb=short -m "slow"
+
+      - name: Upload coverage reports
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false
+          env_vars: OS,PYTHON
+          disable_search: true
+          flags: functional
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  all-tests-pass:
+    name: All Tests Pass
+    runs-on: ubuntu-latest
+    needs: [unit-tests, functional-tests]
+    if: always()
+    steps:
+      - name: Check all jobs passed
+        run: |
+          if [[ "${{ needs.unit-tests.result }}" != "success" ]] || \
+             [[ "${{ needs.functional-tests.result }}" != "success" ]]; then
+            echo "Some tests failed"
+            echo "  unit-tests: ${{ needs.unit-tests.result }}"
+            echo "  functional-tests: ${{ needs.functional-tests.result }}"
+            exit 1
+          fi
+          echo "All tests passed!"

woolly-0.2.0/PKG-INFO

@@ -0,0 +1,213 @@
+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/README.md

@@ -0,0 +1,183 @@
+# 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.1.0 → woolly-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "woolly"
-description = "Recursively search for RPMs in Fedora for Rust crates."
+description = "Check if package dependencies are available in Fedora. Supports Rust, Python, and more."
 readme = "README.md"
 authors = [
     { name = "Rodolfo Olivieri", email = "rodolfo.olivieri3@gmail.com"}
@@ -12,7 +12,9 @@ authors = [
 dynamic = ["version"]
 requires-python = ">=3.10"
 dependencies = [
-    "requests>=2.32.5",
+    "cyclopts>=4.3.0",
+    "httpx>=0.28.0",
+    "pydantic>=2.10.0",
     "rich>=14.2.0",
 ]
 classifiers = [
@@ -47,4 +49,42 @@ woolly = "woolly.__main__:main"
 packages = ["woolly"]
 
 [tool.hatch.version]
-source = "vcs"
+source = "vcs"
+
+[dependency-groups]
+dev = [
+    "pyright>=1.1.407",
+    "ruff>=0.14.7",
+]
+
+test = [
+    "pytest>=8.0.0",
+    "pytest-cov>=4.1.0",
+    "pytest-mock>=3.14.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+markers = [
+    "unit: Unit tests with mocking",
+    "functional: Functional tests without mocking (may require network)",
+    "slow: Slow tests that make real API calls",
+]
+addopts = "-v --tb=short"
+
+[tool.coverage.run]
+source = ["woolly"]
+branch = true
+omit = [
+    "woolly/__main__.py",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "if __name__ == .__main__.:",
+    "raise NotImplementedError",
+]

woolly-0.2.0/tests/__init__.py

@@ -0,0 +1 @@
+"""Test suite for woolly."""