readmerator 0.1.0__tar.gz

readmerator-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Arved Klöhn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

readmerator-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+include LICENSE

readmerator-0.1.0/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: readmerator
+Version: 0.1.0
+Summary: Fetch and cache README files for Python dependencies to use with AI assistants
+Author: Arved Klöhn
+License: MIT
+Project-URL: Homepage, https://github.com/Redundando/readmerator
+Project-URL: Repository, https://github.com/Redundando/readmerator
+Keywords: ai,documentation,readme,pypi,github,context,assistant
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Dynamic: license-file
+
+# readmerator
+
+> Supercharge your AI coding assistant with instant access to all your dependency documentation.
+
+Fetch and cache README files for Python dependencies, making them instantly available to AI assistants like Amazon Q, GitHub Copilot, and Cursor.
+
+## Why?
+
+AI coding assistants are powerful, but they don't automatically know about the packages you're using. You end up:
+- Manually looking up documentation
+- Copy-pasting docs into context
+- Getting generic answers instead of package-specific help
+
+**readmerator** solves this by automatically fetching all your dependency READMEs into a local folder that your AI can reference.
+
+## Installation
+
+```bash
+pip install readmerator
+```
+
+## Quick Start
+
+```bash
+# In your project directory
+readmerator
+
+# Then in your AI assistant
+@folder .ai-docs
+```
+
+That's it! Your AI now has full context on all your dependencies.
+
+## How It Works
+
+1. **Finds** your `requirements.txt`
+2. **Fetches** README files from PyPI and GitHub for each package
+3. **Saves** them to `.ai-docs/` with metadata headers
+4. **You reference** the folder in your AI assistant
+
+## Usage
+
+### Basic
+
+```bash
+readmerator
+```
+
+### With Options
+
+```bash
+# Custom output directory
+readmerator --output-dir docs/packages
+
+# Specify requirements file
+readmerator --source requirements.txt
+
+# Verbose output (shows source: PyPI vs GitHub)
+readmerator --verbose
+```
+
+### Example Output
+
+```bash
+$ readmerator --verbose
+Found 16 packages in requirements.txt
+Fetching READMEs to .ai-docs/
+
+Fetching flask...
+  ✓ flask: Saved (12453 bytes) from PyPI
+Fetching fastapi...
+  ✓ fastapi: Saved (23891 bytes) from GitHub
+...
+
+✓ Successfully fetched: 15
+✗ Failed: 1
+  Failed packages: private-internal-package
+
+READMEs saved to .ai-docs/
+Use '@folder .ai-docs' in your AI assistant to include documentation
+```
+
+## Output Format
+
+Each package gets a markdown file with metadata:
+
+```markdown
+---
+Package: requests
+Version: 2.32.5
+Source: https://github.com/psf/requests
+Fetched: 2024-01-15 10:30:00
+---
+
+# Requests
+
+**Requests** is a simple, yet elegant, HTTP library.
+...
+```
+
+## Features
+
+- **Smart Fetching**: Tries PyPI first, falls back to GitHub
+- **Fast**: Async/concurrent fetching
+- **Reliable**: Graceful error handling for missing packages
+- **Informative**: Progress indicators and detailed verbose mode
+- **Lightweight**: Minimal dependencies (just aiohttp)
+
+## AI Assistant Integration
+
+### Amazon Q
+```
+@folder .ai-docs
+```
+
+### GitHub Copilot
+```
+#file:.ai-docs/*
+```
+
+### Cursor
+```
+@Docs .ai-docs
+```
+
+## Requirements
+
+- Python 3.8+
+- aiohttp
+
+## Contributing
+
+Contributions welcome! Feel free to open issues or PRs on [GitHub](https://github.com/Redundando/readmerator).
+
+## License
+
+MIT © Arved Klöhn

readmerator-0.1.0/README.md

@@ -0,0 +1,137 @@
+# readmerator
+
+> Supercharge your AI coding assistant with instant access to all your dependency documentation.
+
+Fetch and cache README files for Python dependencies, making them instantly available to AI assistants like Amazon Q, GitHub Copilot, and Cursor.
+
+## Why?
+
+AI coding assistants are powerful, but they don't automatically know about the packages you're using. You end up:
+- Manually looking up documentation
+- Copy-pasting docs into context
+- Getting generic answers instead of package-specific help
+
+**readmerator** solves this by automatically fetching all your dependency READMEs into a local folder that your AI can reference.
+
+## Installation
+
+```bash
+pip install readmerator
+```
+
+## Quick Start
+
+```bash
+# In your project directory
+readmerator
+
+# Then in your AI assistant
+@folder .ai-docs
+```
+
+That's it! Your AI now has full context on all your dependencies.
+
+## How It Works
+
+1. **Finds** your `requirements.txt`
+2. **Fetches** README files from PyPI and GitHub for each package
+3. **Saves** them to `.ai-docs/` with metadata headers
+4. **You reference** the folder in your AI assistant
+
+## Usage
+
+### Basic
+
+```bash
+readmerator
+```
+
+### With Options
+
+```bash
+# Custom output directory
+readmerator --output-dir docs/packages
+
+# Specify requirements file
+readmerator --source requirements.txt
+
+# Verbose output (shows source: PyPI vs GitHub)
+readmerator --verbose
+```
+
+### Example Output
+
+```bash
+$ readmerator --verbose
+Found 16 packages in requirements.txt
+Fetching READMEs to .ai-docs/
+
+Fetching flask...
+  ✓ flask: Saved (12453 bytes) from PyPI
+Fetching fastapi...
+  ✓ fastapi: Saved (23891 bytes) from GitHub
+...
+
+✓ Successfully fetched: 15
+✗ Failed: 1
+  Failed packages: private-internal-package
+
+READMEs saved to .ai-docs/
+Use '@folder .ai-docs' in your AI assistant to include documentation
+```
+
+## Output Format
+
+Each package gets a markdown file with metadata:
+
+```markdown
+---
+Package: requests
+Version: 2.32.5
+Source: https://github.com/psf/requests
+Fetched: 2024-01-15 10:30:00
+---
+
+# Requests
+
+**Requests** is a simple, yet elegant, HTTP library.
+...
+```
+
+## Features
+
+- **Smart Fetching**: Tries PyPI first, falls back to GitHub
+- **Fast**: Async/concurrent fetching
+- **Reliable**: Graceful error handling for missing packages
+- **Informative**: Progress indicators and detailed verbose mode
+- **Lightweight**: Minimal dependencies (just aiohttp)
+
+## AI Assistant Integration
+
+### Amazon Q
+```
+@folder .ai-docs
+```
+
+### GitHub Copilot
+```
+#file:.ai-docs/*
+```
+
+### Cursor
+```
+@Docs .ai-docs
+```
+
+## Requirements
+
+- Python 3.8+
+- aiohttp
+
+## Contributing
+
+Contributions welcome! Feel free to open issues or PRs on [GitHub](https://github.com/Redundando/readmerator).
+
+## License
+
+MIT © Arved Klöhn

readmerator-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "readmerator"
+version = "0.1.0"
+description = "Fetch and cache README files for Python dependencies to use with AI assistants"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "Arved Klöhn"}
+]
+keywords = ["ai", "documentation", "readme", "pypi", "github", "context", "assistant"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "aiohttp>=3.8.0",
+]
+
+[project.scripts]
+readmerator = "readmerator.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/Redundando/readmerator"
+Repository = "https://github.com/Redundando/readmerator"

readmerator-0.1.0/readmerator/__init__.py

@@ -0,0 +1,3 @@
+"""Fetch and cache README files for Python dependencies."""
+
+__version__ = "0.1.0"

readmerator-0.1.0/readmerator/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running readmerator as a module: python -m readmerator"""
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()

readmerator-0.1.0/readmerator/cli.py

@@ -0,0 +1,77 @@
+"""Command-line interface for readmerator."""
+
+import asyncio
+import argparse
+from pathlib import Path
+import sys
+
+from .parser import parse_requirements_txt, find_dependency_file
+from .fetcher import fetch_all_readmes
+
+
+def main():
+    """Main CLI entry point."""
+    parser = argparse.ArgumentParser(
+        description="Fetch and cache README files for Python dependencies"
+    )
+    parser.add_argument(
+        "--output-dir",
+        type=Path,
+        default=Path(".ai-docs"),
+        help="Output directory for README files (default: .ai-docs)",
+    )
+    parser.add_argument(
+        "--source",
+        type=Path,
+        help="Path to requirements.txt (default: auto-detect)",
+    )
+    parser.add_argument(
+        "--verbose",
+        "-v",
+        action="store_true",
+        help="Show detailed progress",
+    )
+    
+    args = parser.parse_args()
+    
+    # Find dependency file
+    if args.source:
+        dep_file = args.source
+        if not dep_file.exists():
+            print(f"Error: {dep_file} not found", file=sys.stderr)
+            sys.exit(1)
+    else:
+        dep_file = find_dependency_file(Path.cwd())
+        if not dep_file:
+            print("Error: No requirements.txt found in current directory", file=sys.stderr)
+            sys.exit(1)
+    
+    # Parse dependencies
+    packages = parse_requirements_txt(dep_file)
+    if not packages:
+        print(f"No packages found in {dep_file}")
+        sys.exit(0)
+    
+    print(f"Found {len(packages)} packages in {dep_file}")
+    print(f"Fetching READMEs to {args.output_dir}/")
+    
+    # Fetch READMEs
+    results = asyncio.run(fetch_all_readmes(packages, args.output_dir, args.verbose))
+    
+    # Summary
+    success_count = sum(1 for v in results.values() if v)
+    fail_count = len(results) - success_count
+    
+    print(f"\n✓ Successfully fetched: {success_count}")
+    if fail_count > 0:
+        print(f"✗ Failed: {fail_count}")
+        if not args.verbose:
+            failed = [pkg for pkg, success in results.items() if not success]
+            print(f"  Failed packages: {', '.join(failed)}")
+    
+    print(f"\nREADMEs saved to {args.output_dir}/")
+    print(f"Use '@folder {args.output_dir}' in your AI assistant to include documentation")
+
+
+if __name__ == "__main__":
+    main()

readmerator-0.1.0/readmerator/fetcher.py

@@ -0,0 +1,126 @@
+"""Core functionality for fetching package READMEs."""
+
+import asyncio
+import re
+from pathlib import Path
+from typing import Optional, Dict, List
+from datetime import datetime
+import aiohttp
+
+
+async def fetch_pypi_metadata(session: aiohttp.ClientSession, package: str) -> Optional[Dict]:
+    """Fetch package metadata from PyPI."""
+    url = f"https://pypi.org/pypi/{package}/json"
+    try:
+        async with session.get(url, timeout=aiohttp.ClientTimeout(total=10)) as resp:
+            if resp.status == 200:
+                return await resp.json()
+    except Exception:
+        pass
+    return None
+
+
+async def fetch_github_readme(session: aiohttp.ClientSession, repo_url: str) -> Optional[str]:
+    """Fetch README from GitHub repository."""
+    match = re.search(r"github\.com/([^/]+)/([^/]+)", repo_url)
+    if not match:
+        return None
+    
+    owner, repo = match.groups()
+    repo = repo.rstrip("/").removesuffix(".git")
+    
+    for branch in ["main", "master"]:
+        url = f"https://raw.githubusercontent.com/{owner}/{repo}/{branch}/README.md"
+        try:
+            async with session.get(url, timeout=aiohttp.ClientTimeout(total=10)) as resp:
+                if resp.status == 200:
+                    return await resp.text()
+        except Exception:
+            continue
+    return None
+
+
+async def fetch_package_readme(session: aiohttp.ClientSession, package: str) -> Optional[tuple[str, str, str, str]]:
+    """Fetch README for a package. Returns (content, version, source_url, source_type)."""
+    metadata = await fetch_pypi_metadata(session, package)
+    if not metadata:
+        return None
+    
+    info = metadata.get("info", {})
+    version = info.get("version", "unknown")
+    
+    # Try PyPI long_description first
+    description = info.get("description", "")
+    if description and len(description) > 100:
+        pypi_url = f"https://pypi.org/project/{package}/"
+        return (description, version, pypi_url, "PyPI")
+    
+    # Try GitHub README
+    project_urls = info.get("project_urls", {})
+    for key in ["Source", "Homepage", "Repository", "GitHub"]:
+        url = project_urls.get(key, "")
+        if "github.com" in url:
+            readme = await fetch_github_readme(session, url)
+            if readme:
+                return (readme, version, url, "GitHub")
+    
+    # Fallback to short description
+    summary = info.get("summary", "")
+    if summary:
+        pypi_url = f"https://pypi.org/project/{package}/"
+        return (f"# {package}\n\n{summary}\n\nSee: {pypi_url}", version, pypi_url, "PyPI summary")
+    
+    return None
+
+
+def create_readme_content(package: str, content: str, version: str, source_url: str) -> str:
+    """Create formatted README with metadata header."""
+    header = f"""---
+Package: {package}
+Version: {version}
+Source: {source_url}
+Fetched: {datetime.now().strftime("%Y-%m-%d %H:%M:%S")}
+---
+
+"""
+    return header + content
+
+
+async def fetch_all_readmes(packages: List[str], output_dir: Path, verbose: bool = False) -> Dict[str, bool]:
+    """Fetch READMEs for all packages. Returns dict of package: success."""
+    output_dir.mkdir(parents=True, exist_ok=True)
+    results = {}
+    
+    async with aiohttp.ClientSession() as session:
+        tasks = []
+        for package in packages:
+            tasks.append(fetch_and_save(session, package, output_dir, verbose))
+        
+        results_list = await asyncio.gather(*tasks)
+        for package, success in results_list:
+            results[package] = success
+    
+    return results
+
+
+async def fetch_and_save(session: aiohttp.ClientSession, package: str, output_dir: Path, verbose: bool) -> tuple[str, bool]:
+    """Fetch and save README for a single package."""
+    if verbose:
+        print(f"Fetching {package}...")
+    
+    result = await fetch_package_readme(session, package)
+    if not result:
+        if verbose:
+            print(f"  ✗ {package}: Failed to fetch")
+        return (package, False)
+    
+    content, version, source_url, source_type = result
+    readme_content = create_readme_content(package, content, version, source_url)
+    
+    output_file = output_dir / f"{package}.md"
+    output_file.write_text(readme_content, encoding="utf-8")
+    
+    if verbose:
+        print(f"  ✓ {package}: Saved ({len(content)} bytes) from {source_type}")
+    
+    return (package, True)

readmerator-0.1.0/readmerator/parser.py

@@ -0,0 +1,41 @@
+"""Parse Python dependency files."""
+
+import re
+from pathlib import Path
+from typing import List, Set
+
+
+def parse_requirements_txt(file_path: Path) -> List[str]:
+    """Parse requirements.txt and extract package names."""
+    packages: Set[str] = set()
+    
+    if not file_path.exists():
+        return []
+    
+    content = file_path.read_text(encoding="utf-8")
+    
+    for line in content.splitlines():
+        line = line.strip()
+        
+        # Skip comments and empty lines
+        if not line or line.startswith("#"):
+            continue
+        
+        # Skip -r, -e, --hash, etc.
+        if line.startswith("-"):
+            continue
+        
+        # Extract package name (before any version specifier)
+        match = re.match(r"^([a-zA-Z0-9_-]+)", line)
+        if match:
+            packages.add(match.group(1).lower())
+    
+    return sorted(packages)
+
+
+def find_dependency_file(directory: Path) -> Path | None:
+    """Find requirements.txt in directory."""
+    req_file = directory / "requirements.txt"
+    if req_file.exists():
+        return req_file
+    return None

readmerator-0.1.0/readmerator.egg-info/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: readmerator
+Version: 0.1.0
+Summary: Fetch and cache README files for Python dependencies to use with AI assistants
+Author: Arved Klöhn
+License: MIT
+Project-URL: Homepage, https://github.com/Redundando/readmerator
+Project-URL: Repository, https://github.com/Redundando/readmerator
+Keywords: ai,documentation,readme,pypi,github,context,assistant
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Dynamic: license-file
+
+# readmerator
+
+> Supercharge your AI coding assistant with instant access to all your dependency documentation.
+
+Fetch and cache README files for Python dependencies, making them instantly available to AI assistants like Amazon Q, GitHub Copilot, and Cursor.
+
+## Why?
+
+AI coding assistants are powerful, but they don't automatically know about the packages you're using. You end up:
+- Manually looking up documentation
+- Copy-pasting docs into context
+- Getting generic answers instead of package-specific help
+
+**readmerator** solves this by automatically fetching all your dependency READMEs into a local folder that your AI can reference.
+
+## Installation
+
+```bash
+pip install readmerator
+```
+
+## Quick Start
+
+```bash
+# In your project directory
+readmerator
+
+# Then in your AI assistant
+@folder .ai-docs
+```
+
+That's it! Your AI now has full context on all your dependencies.
+
+## How It Works
+
+1. **Finds** your `requirements.txt`
+2. **Fetches** README files from PyPI and GitHub for each package
+3. **Saves** them to `.ai-docs/` with metadata headers
+4. **You reference** the folder in your AI assistant
+
+## Usage
+
+### Basic
+
+```bash
+readmerator
+```
+
+### With Options
+
+```bash
+# Custom output directory
+readmerator --output-dir docs/packages
+
+# Specify requirements file
+readmerator --source requirements.txt
+
+# Verbose output (shows source: PyPI vs GitHub)
+readmerator --verbose
+```
+
+### Example Output
+
+```bash
+$ readmerator --verbose
+Found 16 packages in requirements.txt
+Fetching READMEs to .ai-docs/
+
+Fetching flask...
+  ✓ flask: Saved (12453 bytes) from PyPI
+Fetching fastapi...
+  ✓ fastapi: Saved (23891 bytes) from GitHub
+...
+
+✓ Successfully fetched: 15
+✗ Failed: 1
+  Failed packages: private-internal-package
+
+READMEs saved to .ai-docs/
+Use '@folder .ai-docs' in your AI assistant to include documentation
+```
+
+## Output Format
+
+Each package gets a markdown file with metadata:
+
+```markdown
+---
+Package: requests
+Version: 2.32.5
+Source: https://github.com/psf/requests
+Fetched: 2024-01-15 10:30:00
+---
+
+# Requests
+
+**Requests** is a simple, yet elegant, HTTP library.
+...
+```
+
+## Features
+
+- **Smart Fetching**: Tries PyPI first, falls back to GitHub
+- **Fast**: Async/concurrent fetching
+- **Reliable**: Graceful error handling for missing packages
+- **Informative**: Progress indicators and detailed verbose mode
+- **Lightweight**: Minimal dependencies (just aiohttp)
+
+## AI Assistant Integration
+
+### Amazon Q
+```
+@folder .ai-docs
+```
+
+### GitHub Copilot
+```
+#file:.ai-docs/*
+```
+
+### Cursor
+```
+@Docs .ai-docs
+```
+
+## Requirements
+
+- Python 3.8+
+- aiohttp
+
+## Contributing
+
+Contributions welcome! Feel free to open issues or PRs on [GitHub](https://github.com/Redundando/readmerator).
+
+## License
+
+MIT © Arved Klöhn

readmerator-0.1.0/readmerator.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+readmerator/__init__.py
+readmerator/__main__.py
+readmerator/cli.py
+readmerator/fetcher.py
+readmerator/parser.py
+readmerator.egg-info/PKG-INFO
+readmerator.egg-info/SOURCES.txt
+readmerator.egg-info/dependency_links.txt
+readmerator.egg-info/entry_points.txt
+readmerator.egg-info/requires.txt
+readmerator.egg-info/top_level.txt
+tests/test_parser.py

readmerator-0.1.0/readmerator.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

readmerator-0.1.0/readmerator.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+readmerator = readmerator.cli:main

readmerator-0.1.0/readmerator.egg-info/requires.txt

@@ -0,0 +1 @@
+aiohttp>=3.8.0

readmerator-0.1.0/readmerator.egg-info/top_level.txt

@@ -0,0 +1 @@
+readmerator

readmerator-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

readmerator-0.1.0/tests/test_parser.py

@@ -0,0 +1,31 @@
+"""Basic tests for readmerator."""
+
+from pathlib import Path
+from readmerator.parser import parse_requirements_txt
+
+
+def test_parse_requirements():
+    """Test parsing a simple requirements file."""
+    test_file = Path("test_req.txt")
+    test_file.write_text("requests>=2.0.0\nclick==8.0.0\n# comment\naiohttp")
+    
+    packages = parse_requirements_txt(test_file)
+    
+    assert "requests" in packages
+    assert "click" in packages
+    assert "aiohttp" in packages
+    assert len(packages) == 3
+    
+    test_file.unlink()
+
+
+def test_parse_empty_file():
+    """Test parsing empty requirements file."""
+    test_file = Path("empty_req.txt")
+    test_file.write_text("# only comments\n\n")
+    
+    packages = parse_requirements_txt(test_file)
+    
+    assert len(packages) == 0
+    
+    test_file.unlink()