pysentry-rs 0.1.3__cp310-cp310-macosx_11_0_arm64.whl → 0.1.4__cp310-cp310-macosx_11_0_arm64.whl

pysentry/__init__.py

@@ -1,9 +1,9 @@
 """pysentry: Security vulnerability auditing tool for Python packages."""
 
-from ._internal import audit_python, audit_with_options
+from ._internal import audit_python, audit_with_options, check_resolvers, check_version
 
-__version__ = "0.1.3"
-__all__ = ["audit_python", "audit_with_options", "main"]
+__version__ = "0.1.4"
+__all__ = ["audit_python", "audit_with_options", "check_resolvers", "check_version", "main"]
 
 
 def main():
@@ -11,46 +11,147 @@ def main():
     import sys
     import argparse
 
+    # Handle the case where first argument is 'resolvers'
+    if len(sys.argv) > 1 and sys.argv[1] == "resolvers":
+        # Parse resolvers subcommand
+        parser = argparse.ArgumentParser(
+            prog="pysentry-rs resolvers",
+            description="Check available dependency resolvers",
+        )
+        parser.add_argument(
+            "--verbose", "-v", action="store_true", help="Enable verbose output"
+        )
+
+        # Remove 'resolvers' from args and parse the rest
+        args = parser.parse_args(sys.argv[2:])
+
+        try:
+            result = check_resolvers(args.verbose)
+            print(result)
+        except Exception as e:
+            print(f"Error: {e}", file=sys.stderr)
+            sys.exit(1)
+        return
+
+    # Handle the case where first argument is 'check-version'
+    if len(sys.argv) > 1 and sys.argv[1] == "check-version":
+        # Parse check-version subcommand
+        parser = argparse.ArgumentParser(
+            prog="pysentry-rs check-version",
+            description="Check if a newer version is available",
+        )
+        parser.add_argument(
+            "--verbose", "-v", action="store_true", help="Enable verbose output"
+        )
+
+        # Remove 'check-version' from args and parse the rest
+        args = parser.parse_args(sys.argv[2:])
+
+        try:
+            result = check_version(args.verbose)
+            print(result)
+        except Exception as e:
+            print(f"Error: {e}", file=sys.stderr)
+            sys.exit(1)
+        return
+
+    # Default audit command parser
     parser = argparse.ArgumentParser(
-        prog="pysentry-rs", description="Audit Python packages for vulnerabilities"
+        prog="pysentry-rs",
+        description="Security vulnerability auditing for Python packages",
+    )
+
+    parser.add_argument(
+        "path",
+        nargs="?",
+        default=".",
+        help="Path to the project directory to audit (default: current directory)",
     )
-    parser.add_argument("path", help="Path to Python project")
     parser.add_argument(
         "--format",
         choices=["human", "json", "sarif"],
         default="human",
-        help="Output format",
+        help="Output format (default: human)",
     )
     parser.add_argument(
-        "--source",
-        choices=["pypa", "pypi", "osv"],
-        default="pypa",
-        help="Vulnerability data source",
-    )
-    parser.add_argument(
-        "--min-severity",
+        "--severity",
         choices=["low", "medium", "high", "critical"],
         default="low",
-        help="Minimum severity level",
+        help="Minimum severity level to report (default: low)",
     )
     parser.add_argument(
         "--ignore",
         action="append",
         dest="ignore_ids",
-        help="Vulnerability IDs to ignore (can be used multiple times)",
+        metavar="ID",
+        help="Vulnerability IDs to ignore (can be specified multiple times)",
+    )
+    parser.add_argument(
+        "--output", "-o", metavar="FILE", help="Output file path (defaults to stdout)"
+    )
+    parser.add_argument(
+        "--dev", action="store_true", help="Include development dependencies"
+    )
+    parser.add_argument(
+        "--optional", action="store_true", help="Include optional dependencies"
+    )
+    parser.add_argument(
+        "--direct-only",
+        action="store_true",
+        help="Only check direct dependencies (exclude transitive)",
+    )
+    parser.add_argument("--no-cache", action="store_true", help="Disable caching")
+    parser.add_argument("--cache-dir", metavar="DIR", help="Custom cache directory")
+    parser.add_argument(
+        "--source",
+        choices=["pypa", "pypi", "osv"],
+        default="pypa",
+        help="Vulnerability data source (default: pypa)",
+    )
+    parser.add_argument(
+        "--resolver",
+        choices=["uv", "pip-tools"],
+        default="uv",
+        help="Dependency resolver for requirements.txt files (default: uv)",
+    )
+    parser.add_argument(
+        "--requirements-files",
+        nargs="+",
+        metavar="FILE",
+        help="Specific requirements files to audit (disables auto-discovery)",
+    )
+    parser.add_argument(
+        "--verbose", "-v", action="store_true", help="Enable verbose output"
+    )
+    parser.add_argument(
+        "--quiet", "-q", action="store_true", help="Suppress non-error output"
     )
 
     args = parser.parse_args()
 
     try:
-        if args.source != "pypa" or args.min_severity != "low" or args.ignore_ids:
-            result = audit_with_options(
-                args.path, args.format, args.source, args.min_severity, args.ignore_ids
-            )
-        else:
-            result = audit_python(args.path, args.format)
-
-        print(result)
+        # Main audit functionality
+        result = audit_with_options(
+            path=args.path,
+            format=args.format,
+            source=args.source,
+            min_severity=args.severity,
+            ignore_ids=args.ignore_ids,
+            output=args.output,
+            dev=args.dev,
+            optional=args.optional,
+            direct_only=args.direct_only,
+            no_cache=args.no_cache,
+            cache_dir=args.cache_dir,
+            resolver=args.resolver,
+            requirements_files=args.requirements_files,
+            verbose=args.verbose,
+            quiet=args.quiet,
+        )
+
+        if not args.output:
+            print(result)
+
     except Exception as e:
         print(f"Error: {e}", file=sys.stderr)
         sys.exit(1)

pysentry/__main__.py

@@ -3,4 +3,4 @@
 from . import main
 
 if __name__ == "__main__":
-    main()
+    main()

{pysentry_rs-0.1.3.dist-info → pysentry_rs-0.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pysentry-rs
-Version: 0.1.3
+Version: 0.1.4
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
@@ -11,6 +11,7 @@ Classifier: Programming Language :: Python :: 3.9
 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: Topic :: Security
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 License-File: LICENSE
@@ -51,7 +52,65 @@ PySentry audits Python projects for known security vulnerabilities by analyzing
 
 ## Installation
 
-### From Source
+Choose the installation method that works best for you:
+
+### ⚡ Via uvx (Recommended for occasional use)
+
+Run directly without installing (requires [uv](https://docs.astral.sh/uv/)):
+
+```bash
+uvx pysentry-rs /path/to/project
+```
+
+This method:
+
+- Runs the latest version without installation
+- Automatically manages Python environment
+- Perfect for CI/CD or occasional security audits
+- No need to manage package versions or updates
+
+### 📦 From PyPI (Python Package)
+
+For Python 3.8+ on Linux and macOS:
+
+```bash
+pip install pysentry-rs
+```
+
+Then use it with Python:
+
+```bash
+python -m pysentry /path/to/project
+# or directly if scripts are in PATH
+pysentry-rs /path/to/project
+```
+
+### ⚡ From Crates.io (Rust Package)
+
+If you have Rust installed:
+
+```bash
+cargo install pysentry
+```
+
+### 💾 From GitHub Releases (Pre-built Binaries)
+
+Download the latest release for your platform:
+
+- **Linux x64**: `pysentry-linux-x64.tar.gz`
+- **Linux x64 (musl)**: `pysentry-linux-x64-musl.tar.gz`
+- **Linux ARM64**: `pysentry-linux-arm64.tar.gz`
+- **macOS x64**: `pysentry-macos-x64.tar.gz`
+- **macOS ARM64**: `pysentry-macos-arm64.tar.gz`
+- **Windows x64**: `pysentry-windows-x64.zip`
+
+```bash
+# Example for Linux x64
+curl -L https://github.com/nyudenkov/pysentry/releases/latest/download/pysentry-linux-x64.tar.gz | tar -xz
+./pysentry-linux-x64/pysentry --help
+```
+
+### 🔧 From Source
 
 ```bash
 git clone https://github.com/nyudenkov/pysentry
@@ -61,20 +120,36 @@ cargo build --release
 
 The binary will be available at `target/release/pysentry`.
 
-### System Requirements
+### Requirements
+
+- **For uvx**: Python 3.8+ and [uv](https://docs.astral.sh/uv/) installed (Linux/macOS only)
+- **For binaries**: No additional dependencies
+- **For Python package**: Python 3.8+ (Linux/macOS only)
+- **For Rust package and source**: Rust 1.79+
+
+### Platform Support
 
-- Rust 1.70+ (for building from source)
-- Internet connection (for vulnerability database updates)
+| Installation Method | Linux | macOS | Windows |
+| ------------------- | ----- | ----- | ------- |
+| uvx                 | ✅    | ✅    | ❌      |
+| PyPI (pip)          | ✅    | ✅    | ❌      |
+| Crates.io (cargo)   | ✅    | ✅    | ✅      |
+| GitHub Releases     | ✅    | ✅    | ✅      |
+| From Source         | ✅    | ✅    | ✅      |
+
+**Note**: Windows Python wheels are not available due to compilation complexity. Windows users should use the pre-built binary from GitHub releases, install via cargo and build from source.
 
 ## Quick Start
 
 ### Basic Usage
 
 ```bash
-# Audit current directory
-pysentry
+# Using uvx (recommended for occasional use)
+uvx pysentry-rs
+uvx pysentry-rs /path/to/python/project
 
-# Audit specific project
+# Using installed binary
+pysentry
 pysentry /path/to/python/project
 
 # Include development dependencies
@@ -90,10 +165,14 @@ pysentry --format json --output audit-results.json
 ### Advanced Usage
 
 ```bash
-# Comprehensive audit with all dependency types
-pysentry --dev --optional --format sarif --output security-report.sarif
+# Using uvx for comprehensive audit
+uvx pysentry-rs --dev --optional --format sarif --output security-report.sarif
 
 # Check only direct dependencies using OSV database
+uvx pysentry-rs --direct-only --source osv
+
+# Or with installed binary
+pysentry --dev --optional --format sarif --output security-report.sarif
 pysentry --direct-only --source osv
 
 # Ignore specific vulnerabilities

pysentry_rs-0.1.4.dist-info/RECORD

@@ -0,0 +1,8 @@
+pysentry/__init__.py,sha256=TcB6vZ9qN_6fa0HZnuiNiv7VQKwf6jA-kUdWP4ZSwho,5066
+pysentry/__main__.py,sha256=FJdFFQuSE8TYsZtY_vb00oCE2nvq9hB6MhMLBxnn7Ns,117
+pysentry/_internal.cpython-310-darwin.so,sha256=0ybE6f2mHFS7DVeljUu3EFx62mSRi6xe-tv8Tj2aJ6g,6137840
+pysentry_rs-0.1.4.dist-info/METADATA,sha256=vl4tTeCjqbM0zh8h-6Z1lfdwVmVfme57xTyeIqrhP20,10992
+pysentry_rs-0.1.4.dist-info/WHEEL,sha256=XiGjjeJC2k7oCSYs1QNLi9iFDhofhstbUV6w7vMmp_k,104
+pysentry_rs-0.1.4.dist-info/entry_points.txt,sha256=3bJguekVEbXTn-ceDCWJaSIZScquPPP1Ux9TPVHHanE,44
+pysentry_rs-0.1.4.dist-info/licenses/LICENSE,sha256=TAMtDCoJuavXz7pCEklrzjH55sdvsy5gKsXY9NsImwY,34878
+pysentry_rs-0.1.4.dist-info/RECORD,,

pysentry_rs-0.1.3.dist-info/RECORD

@@ -1,8 +0,0 @@
-pysentry/__init__.py,sha256=XweE7o45pHx2rmO523WkjFJFEjGDwwESMQtXQFZ2d6k,1633
-pysentry/__main__.py,sha256=yzx36hW8FIWKDCOkP409c8wIXnK-A5tIRMw86eueJ_Q,116
-pysentry/_internal.cpython-310-darwin.so,sha256=rRXuTQizg_0CTMKtZQovhOIUEMyW_J3oC1Re7-xdxhk,5695376
-pysentry_rs-0.1.3.dist-info/METADATA,sha256=Wpgd9n5P8ZJa8jO_0Ry9O1eiUF1-pJDplZndnc5SHg4,8644
-pysentry_rs-0.1.3.dist-info/WHEEL,sha256=XiGjjeJC2k7oCSYs1QNLi9iFDhofhstbUV6w7vMmp_k,104
-pysentry_rs-0.1.3.dist-info/entry_points.txt,sha256=3bJguekVEbXTn-ceDCWJaSIZScquPPP1Ux9TPVHHanE,44
-pysentry_rs-0.1.3.dist-info/licenses/LICENSE,sha256=TAMtDCoJuavXz7pCEklrzjH55sdvsy5gKsXY9NsImwY,34878
-pysentry_rs-0.1.3.dist-info/RECORD,,