omnipkg 1.0.0__tar.gz

omnipkg-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2025  1minds3t
+
+This file is part of `omnipkg`.
+
+omnipkg is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+omnipkg is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with omnipkg. If not, see <https://www.gnu.org/licenses/>.
+
+---
+
+For commercial licensing options or general inquiries, contact:
+📧  omnipkg@proton.me

omnipkg-1.0.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+include requirements.txt

omnipkg-1.0.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: omnipkg
+Version: 1.0.0
+Summary: The Intelligent Python Dependency Resolver
+Author-email: minds3t <omnipkg@proton.me>
+License: AGPL-3.0-or-later
+Project-URL: Homepage, https://github.com/1minds3t/omnipkg
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: redis
+Requires-Dist: packaging
+Requires-Dist: requests
+Dynamic: license-file
+
+
+---
+
+# omnipkg: The Intelligent Python Package Manager
+> One environment. Infinite versions. Zero conflicts.
+
+<p align="center">
+  <a href="https://github.com/omnipkg/omnipkg/actions/workflows/test.yml">
+    <img src="https://img.shields.io/github/actions/workflow/status/omnipkg/omnipkg/test.yml?branch=main" alt="Build Status">
+  </a>
+  <a href="https://pypi.org/project/omnipkg/">
+    <img src="https://img.shields.io/pypi/v/omnipkg.svg" alt="PyPI version">
+  </a>
+  <a href="https://www.gnu.org/licenses/agpl-3.0">
+    <img src="https://img.shields.io/badge/License-AGPLv3-red.svg" alt="License: AGPLv3">
+  </a>
+  <a href="https://github.com/omnipkg/omnipkg/actions/workflows/security_audit.yml">
+    <img src="https://img.shields.io/github/actions/workflow/status/omnipkg/omnipkg/security_audit.yml?branch=main" alt="Security Audit">
+  </a>
+</p>
+
+[![Security Audit](https://github.com/1minds3t/omnipkg/actions/workflows/security_audit.yml/badge.svg)](https://github.com/1minds3t/omnipkg/actions/workflows/security_audit.yml)
+[![Build Status](https://github.com/1minds3t/omnipkg/actions/workflows/publish.yml/badge.svg)](https://github.com/1minds3t/omnipkg/actions/workflows/publish.yml)
+[![PyPI version](https://img.shields.io/pypi/v/omnipkg.svg)](https://pypi.org/project/omnipkg/)
+
+
+---
+
+`omnipkg` lets you install *any version* of *any package* without breaking your environment, downgrading dependencies, or needing Conda, Docker, or `pipx`. **Dependency hell? Obliterated.**
+
+---
+## See It to Believe It (30 Second Demo)
+
+<!-- A GIF is the best format for this. It shows the tool in action without taking up a ton of space. -->
+![omnipkg Demo GIF](https://user-images.githubusercontent.com/your-image-url-here.gif) 
+*This shows `omnipkg install old-package`, downgrade protection activating, and `omnipkg status` confirming both versions coexist.*
+
+---
+
+## 🚀 Features
+
+-   🛡️ **Downgrade Protection**: Stops `pip` from nuking your environment by isolating conflicting versions into protected "bubbles."
+-   💾 **Intelligent Deduplication**: Saves up to 60% disk space on bubbled packages while keeping native C extensions stable.
+-   🧠 **Redis-Backed Knowledge Base**: Lightning-fast lookups for all package versions, dependencies, and security info.
+-   🔀 **Runtime Version Switching**: Activate any bubbled package version on the fly, even within the same script.
+-   🧪 **Battle-Tested**: Proven to handle massive environments (520+ packages, 95+ bubbles, 15.4GB+) without flinching.
+
+---
+
+## How Is This Possible?
+
+When a downgrade is detected, `omnipkg` performs surgery:
+1.  **Intercepts** the request.
+2.  **Installs** the conflicting version and its entire dependency tree into a temporary, isolated location.
+3.  **Creates** a space-efficient, deduplicated "bubble" in `.omnipkg_versions`.
+4.  **Restores** the original package in your main environment.
+
+The result: a perfectly stable global environment, with every version you've ever needed on standby.
+
+<details>
+<summary><strong>🔬 Click for a Real-World Example: Downgrading PyTorch</strong></summary>
+
+```bash
+# User wants to install an older torch version
+$ omnipkg install torch==2.7.0
+
+# ... (omnipkg detects the downgrade) ...
+🛡️  DOWNGRADE PROTECTION ACTIVATED!
+-> Fixing downgrade: torch from v2.7.1 to v2.7.0
+🫧 Creating isolated bubble for torch v2.7.0
+✅ Success: Dependencies resolved via PyPI API.
+🧹 Creating deduplicated bubble...
+⚠️  Disabling deduplication for native package: torch
+✅ Bubble created: 16241 files copied, 3211 deduplicated.
+📊 Space efficiency: 16.5% saved.
+🔄 Restoring ‘torch’ to safe version v2.7.1 in main environment…
+
+✅ Environment protection complete!
+```
+</details>
+
+---
+
+## Why Other Tools Fail
+
+| Tool          | The Task: `install old-conflicting-package` | Result                                |
+|---------------|---------------------------------------------|---------------------------------------|
+| `pip`         | ❌                                          | `ERROR: Cannot uninstall...`          |
+| `conda`       | ⏳                                          | `Solving environment...` (for hours)  |
+| `poetry`      | 💥                                          | `SolverProblemError`                  |
+| `uv`          | 🚫                                          | `No solution found for the request`   |
+| **`omnipkg`** | ✅                                          | **`DOWNGRADE PROTECTION ACTIVATED!`** |
+
+---
+
+## 📜 Licensing
+
+`omnipkg` is available under a dual-license model to suit different needs.
+
+-   **Community Edition (AGPLv3):** Perfect for individual developers, open-source projects, and academic use. If you use `omnipkg` in a project that is also open-source under a compatible license, you're good to go. The source code is available in this repository under the [GNU AGPLv3](LICENSE).
+
+-   **Commercial License:** Required for use in closed-source commercial software, proprietary systems, or for any organization that cannot comply with the terms of the AGPLv3. This license allows you to integrate `omnipkg` without the obligation to open-source your own code.
+
+    → **To inquire about a commercial license, please contact:** [**omnipkg@proton.me**](mailto:omnipkg@proton.me)

omnipkg-1.0.0/README.md

@@ -0,0 +1,104 @@
+
+---
+
+# omnipkg: The Intelligent Python Package Manager
+> One environment. Infinite versions. Zero conflicts.
+
+<p align="center">
+  <a href="https://github.com/omnipkg/omnipkg/actions/workflows/test.yml">
+    <img src="https://img.shields.io/github/actions/workflow/status/omnipkg/omnipkg/test.yml?branch=main" alt="Build Status">
+  </a>
+  <a href="https://pypi.org/project/omnipkg/">
+    <img src="https://img.shields.io/pypi/v/omnipkg.svg" alt="PyPI version">
+  </a>
+  <a href="https://www.gnu.org/licenses/agpl-3.0">
+    <img src="https://img.shields.io/badge/License-AGPLv3-red.svg" alt="License: AGPLv3">
+  </a>
+  <a href="https://github.com/omnipkg/omnipkg/actions/workflows/security_audit.yml">
+    <img src="https://img.shields.io/github/actions/workflow/status/omnipkg/omnipkg/security_audit.yml?branch=main" alt="Security Audit">
+  </a>
+</p>
+
+[![Security Audit](https://github.com/1minds3t/omnipkg/actions/workflows/security_audit.yml/badge.svg)](https://github.com/1minds3t/omnipkg/actions/workflows/security_audit.yml)
+[![Build Status](https://github.com/1minds3t/omnipkg/actions/workflows/publish.yml/badge.svg)](https://github.com/1minds3t/omnipkg/actions/workflows/publish.yml)
+[![PyPI version](https://img.shields.io/pypi/v/omnipkg.svg)](https://pypi.org/project/omnipkg/)
+
+
+---
+
+`omnipkg` lets you install *any version* of *any package* without breaking your environment, downgrading dependencies, or needing Conda, Docker, or `pipx`. **Dependency hell? Obliterated.**
+
+---
+## See It to Believe It (30 Second Demo)
+
+<!-- A GIF is the best format for this. It shows the tool in action without taking up a ton of space. -->
+![omnipkg Demo GIF](https://user-images.githubusercontent.com/your-image-url-here.gif) 
+*This shows `omnipkg install old-package`, downgrade protection activating, and `omnipkg status` confirming both versions coexist.*
+
+---
+
+## 🚀 Features
+
+-   🛡️ **Downgrade Protection**: Stops `pip` from nuking your environment by isolating conflicting versions into protected "bubbles."
+-   💾 **Intelligent Deduplication**: Saves up to 60% disk space on bubbled packages while keeping native C extensions stable.
+-   🧠 **Redis-Backed Knowledge Base**: Lightning-fast lookups for all package versions, dependencies, and security info.
+-   🔀 **Runtime Version Switching**: Activate any bubbled package version on the fly, even within the same script.
+-   🧪 **Battle-Tested**: Proven to handle massive environments (520+ packages, 95+ bubbles, 15.4GB+) without flinching.
+
+---
+
+## How Is This Possible?
+
+When a downgrade is detected, `omnipkg` performs surgery:
+1.  **Intercepts** the request.
+2.  **Installs** the conflicting version and its entire dependency tree into a temporary, isolated location.
+3.  **Creates** a space-efficient, deduplicated "bubble" in `.omnipkg_versions`.
+4.  **Restores** the original package in your main environment.
+
+The result: a perfectly stable global environment, with every version you've ever needed on standby.
+
+<details>
+<summary><strong>🔬 Click for a Real-World Example: Downgrading PyTorch</strong></summary>
+
+```bash
+# User wants to install an older torch version
+$ omnipkg install torch==2.7.0
+
+# ... (omnipkg detects the downgrade) ...
+🛡️  DOWNGRADE PROTECTION ACTIVATED!
+-> Fixing downgrade: torch from v2.7.1 to v2.7.0
+🫧 Creating isolated bubble for torch v2.7.0
+✅ Success: Dependencies resolved via PyPI API.
+🧹 Creating deduplicated bubble...
+⚠️  Disabling deduplication for native package: torch
+✅ Bubble created: 16241 files copied, 3211 deduplicated.
+📊 Space efficiency: 16.5% saved.
+🔄 Restoring ‘torch’ to safe version v2.7.1 in main environment…
+
+✅ Environment protection complete!
+```
+</details>
+
+---
+
+## Why Other Tools Fail
+
+| Tool          | The Task: `install old-conflicting-package` | Result                                |
+|---------------|---------------------------------------------|---------------------------------------|
+| `pip`         | ❌                                          | `ERROR: Cannot uninstall...`          |
+| `conda`       | ⏳                                          | `Solving environment...` (for hours)  |
+| `poetry`      | 💥                                          | `SolverProblemError`                  |
+| `uv`          | 🚫                                          | `No solution found for the request`   |
+| **`omnipkg`** | ✅                                          | **`DOWNGRADE PROTECTION ACTIVATED!`** |
+
+---
+
+## 📜 Licensing
+
+`omnipkg` is available under a dual-license model to suit different needs.
+
+-   **Community Edition (AGPLv3):** Perfect for individual developers, open-source projects, and academic use. If you use `omnipkg` in a project that is also open-source under a compatible license, you're good to go. The source code is available in this repository under the [GNU AGPLv3](LICENSE).
+
+-   **Commercial License:** Required for use in closed-source commercial software, proprietary systems, or for any organization that cannot comply with the terms of the AGPLv3. This license allows you to integrate `omnipkg` without the obligation to open-source your own code.
+
+    → **To inquire about a commercial license, please contact:** [**omnipkg@proton.me**](mailto:omnipkg@proton.me)

omnipkg-1.0.0/omnipkg/__main__.py

@@ -0,0 +1,6 @@
+import sys
+from .cli import main
+
+# This runs the main function and ensures the script exits with the correct status code.
+if __name__ == "__main__":
+    sys.exit(main())

omnipkg-1.0.0/omnipkg/activator.py

@@ -0,0 +1,70 @@
+import sys
+import os
+import importlib.util
+from pathlib import Path
+from omnipkg.core import ConfigManager
+
+def get_config():
+    """Load config using ConfigManager"""
+    config_manager = ConfigManager()
+    return config_manager.config
+
+def get_multiversion_base():
+    """Get base path from config with fallbacks"""
+    try:
+        config = get_config()
+        base = config.get("multiversion_base")
+        if base: return base
+    except Exception:
+        pass
+    
+    # Fallback to package-relative directory
+    return str(Path(__file__).parent.parent / ".omnipkg_versions")
+
+class ImportHookManager:
+    def __init__(self, multiversion_base: str):
+        self.multiversion_base = Path(multiversion_base)
+        self.version_map = {}
+        self.load_version_map()
+
+    def load_version_map(self):
+        if not self.multiversion_base.exists(): return
+        for version_dir in self.multiversion_base.iterdir():
+            if version_dir.is_dir() and '-' in version_dir.name:
+                parts = version_dir.name.rsplit('-', 1)
+                if len(parts) == 2:
+                    pkg_name, version = parts
+                    if pkg_name not in self.version_map: 
+                        self.version_map[pkg_name] = {}
+                    self.version_map[pkg_name][version] = str(version_dir)
+
+    def get_package_path(self, package_name: str, version: str):
+        return self.version_map.get(package_name.lower(), {}).get(version)
+
+class MultiversionFinder:
+    def __init__(self, hook_manager: ImportHookManager):
+        self.hook_manager = hook_manager
+
+    def find_spec(self, fullname, path, target=None):
+        top_level = fullname.split('.')[0]
+        env_var_name = f"_omnipkg_ACTIVE_{top_level.upper().replace('-', '_')}"
+        activated_version = os.environ.get(env_var_name)
+        if activated_version:
+            pkg_path = self.hook_manager.get_package_path(top_level, activated_version)
+            if pkg_path:
+                module_path = Path(pkg_path) / top_level
+                if module_path.is_dir() and (module_path / "__init__.py").exists():
+                    return importlib.util.spec_from_file_location(
+                        fullname,
+                        str(module_path / "__init__.py"),
+                        submodule_search_locations=[str(module_path)]
+                    )
+        return None
+
+# --- Global Singleton ---
+_hook_manager = ImportHookManager(get_multiversion_base())
+
+def install_hook():
+    """Installs the omnipkg import hook if not already active"""
+    if not any(isinstance(finder, MultiversionFinder) for finder in sys.meta_path):
+        sys.meta_path.insert(0, MultiversionFinder(_hook_manager))

omnipkg-1.0.0/omnipkg/cli.py

@@ -0,0 +1,133 @@
+#!/usr/bin/env python3
+"""
+omnipkg CLI
+"""
+import sys
+import argparse
+from .core import omnipkg, ConfigManager
+
+def print_header(title):
+    """Prints a consistent, pretty header for CLI sections."""
+    print("\n" + "="*60)
+    print(f"  🚀 {title}")
+    print("="*60)
+
+import textwrap
+
+def create_parser():
+    """Creates and configures the argument parser."""
+    # This formatter_class is key to making our new help text look good.
+    # The epilog provides examples of the most important commands.
+    parser = argparse.ArgumentParser(
+        prog='omnipkg',
+        description='The intelligent Python package manager that solves dependency hell.',
+        formatter_class=argparse.RawTextHelpFormatter, # Prevents argparse from messing up our formatting
+        epilog=textwrap.dedent('''\
+            
+        Common Commands:
+          omnipkg install <package>   Install a package with downgrade protection.
+          omnipkg list                See all installed packages and their health.
+          omnipkg status              Check the health of your multi-version environment.
+          omnipkg info <package>      Get a detailed dashboard for a specific package.
+          omnipkg demo                Run the interactive showcase to see the magic.
+        ''')
+    )
+    
+    subparsers = parser.add_subparsers(dest='command', help='All available commands:', required=True)
+
+    install_parser = subparsers.add_parser('install', help='Install packages (with downgrade protection)')
+    install_parser.add_argument('packages', nargs='+', help='Packages to install (e.g., "requests==2.25.1")')
+
+    info_parser = subparsers.add_parser('info', help='Show detailed package information with interactive version selection')
+    info_parser.add_argument('package', help='Package name to inspect')
+    info_parser.add_argument('--version', default='active', help='Specific version to inspect')
+
+    list_parser = subparsers.add_parser('list', help='List installed packages')
+    list_parser.add_argument('filter', nargs='?', help='Optional filter pattern for package names')
+
+    status_parser = subparsers.add_parser('status', help='Show multi-version system status')
+
+    demo_parser = subparsers.add_parser('demo', help='Run the interactive, automated demo')
+
+    stress_parser = subparsers.add_parser('stress-test', help='Run the ultimate stress test with heavy-duty packages.')
+
+    reset_parser = subparsers.add_parser('reset', help='DELETE and rebuild the omnipkg knowledge base in Redis')
+    reset_parser.add_argument('--yes', '-y', action='store_true', help='Skip confirmation')
+
+    rebuild_parser = subparsers.add_parser('rebuild-kb', help='Force a full rebuild of the knowledge base without deleting')
+    rebuild_parser.add_argument('--force', '-f', action='store_true', help='Ignore cache and force re-processing of all metadata')
+
+    return parser
+
+def main():
+    """The main entry point for the CLI."""
+    
+    # Handle the case where 'omnipkg' is run with no arguments
+    if len(sys.argv) == 1:
+        cm = ConfigManager()
+        if not cm.config_path.exists():
+            cm._first_time_setup()
+            print("\n" + "="*50)
+            print("🚀 Welcome to omnipkg! Your setup is complete.")
+            print("To see the magic in action, we highly recommend running the demo:")
+            print("\n    omnipkg demo\n")
+            print("="*50)
+        else:
+            print("👋 Welcome back to omnipkg!")
+            print("   Run `omnipkg status` to see your environment.")
+            print("   Run `omnipkg demo` for a showcase of features.")
+            print("   Run `omnipkg --help` for all commands.")
+        return 0
+
+    parser = create_parser()
+    args = parser.parse_args()
+
+    # First, create the config manager to load/create the config
+    cm = ConfigManager()
+    
+    # Now, create the main instance, PASSING IN the loaded config
+    pkg_instance = omnipkg(cm.config)
+
+    try:
+        if args.command == 'install':
+            return pkg_instance.smart_install(args.packages)
+        elif args.command == 'info':
+            return pkg_instance.show_package_info(args.package, args.version)
+        elif args.command == 'list':
+            return pkg_instance.list_packages(args.filter)
+        elif args.command == 'status':
+            return pkg_instance.show_multiversion_status()
+        elif args.command == 'demo':
+            from .demo import run_demo
+            return run_demo()
+        elif args.command == 'stress-test':
+            from . import stress_test
+            print_header("omnipkg Ultimate Stress Test")
+            print("This test will install, bubble, and test multiple large scientific packages.")
+            print("\n⚠️  This will download several hundred MB and may take several minutes.")
+
+            if input("\nProceed with the stress test? (y/n): ").lower() != 'y':
+                print("Stress test cancelled.")
+                return 0
+            
+            stress_test.run()
+            return 0
+        elif args.command == 'reset':
+            return pkg_instance.reset_knowledge_base(force=args.yes)
+        elif args.command == 'rebuild-kb':
+            return pkg_instance.rebuild_knowledge_base(force=args.force)
+        else:
+            parser.print_help()
+            return 1
+            
+    except KeyboardInterrupt:
+        print("\n❌ Operation cancelled by user.")
+        return 1
+    except Exception as e:
+        print(f"\n❌ An unexpected top-level error occurred: {e}")
+        import traceback
+        traceback.print_exc()
+        return 1
+        
+if __name__ == "__main__":
+    sys.exit(main())