forge-shadow 4.5.0__py3-none-any.whl

forge/__init__.py

@@ -0,0 +1,91 @@
+"""Deprecated: ``forge`` is now ``bladekit`` (Blade AI Fabric, PAAS-771).
+
+This package is a shim kept for code written against the old name::
+
+    import forge                      # -> bladekit, with a DeprecationWarning
+    from forge import App, Image      # same objects as bladekit.App, ...
+    from forge.exceptions import ForgeError   # bladekit.exceptions.FabricError
+    import forge._app                 # IS bladekit._app (same module object)
+
+Every ``forge.<sub>`` module resolves to the already-imported
+``bladekit.<sub>`` module object rather than a second copy of it, so
+classes compare identical (``isinstance``, ``except``) and pickles that name
+``forge.*`` — written by an older client, or by code still importing ``forge``
+— load against ``bladekit``.
+
+Shipped by the ``forge-shadow`` compatibility distribution, never by
+``bladekit`` itself. New code should ``import bladekit``.
+"""
+
+from __future__ import annotations
+
+import importlib
+import importlib.abc
+import importlib.util
+import sys
+import warnings
+from typing import Any, List
+
+import bladekit as _target
+
+_PREFIX = __name__ + "."
+_TARGET = _target.__name__
+
+warnings.warn(
+    "the `forge` package is deprecated: use `import bladekit` "
+    "(pip install bladekit). `forge` is a compatibility alias.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+
+class _AliasLoader(importlib.abc.Loader):
+    """Load ``forge.X`` as the very module object ``bladekit.X``."""
+
+    def __init__(self, target_name: str) -> None:
+        self._target_name = target_name
+        self._own_spec: Any = None
+
+    def create_module(self, spec):  # type: ignore[no-untyped-def]
+        module = importlib.import_module(self._target_name)
+        self._own_spec = module.__spec__
+        return module
+
+    def exec_module(self, module) -> None:  # type: ignore[no-untyped-def]
+        # The import system stamped the alias spec onto the shared module
+        # object between create_module and here; give it back its own so
+        # bladekit.X stays reloadable and module.__spec__.name keeps
+        # saying bladekit.
+        if self._own_spec is not None:
+            module.__spec__ = self._own_spec
+
+
+class _AliasFinder(importlib.abc.MetaPathFinder):
+    def find_spec(self, fullname, path=None, target=None):  # type: ignore[no-untyped-def]
+        if not fullname.startswith(_PREFIX):
+            return None
+        target_name = _TARGET + "." + fullname[len(_PREFIX):]
+        if importlib.util.find_spec(target_name) is None:
+            return None
+        return importlib.util.spec_from_loader(fullname, _AliasLoader(target_name))
+
+
+if not any(isinstance(f, _AliasFinder) for f in sys.meta_path):
+    sys.meta_path.insert(0, _AliasFinder())
+
+
+def __getattr__(name: str) -> Any:
+    from bladekit import exceptions as _exceptions
+
+    if name in _exceptions.DEPRECATED_ALIASES:
+        # forge.ForgeError -> FabricError, warning at the caller's line.
+        return _exceptions.resolve_deprecated(name)
+    return getattr(_target, name)  # forge.App, forge.Image, ...
+
+
+def __dir__() -> List[str]:
+    return sorted(set(globals()) | set(dir(_target)))
+
+
+__all__ = list(getattr(_target, "__all__", [])) + ["ForgeError"]
+__version__ = _target.__version__

forge_shadow/__init__.py

@@ -0,0 +1,18 @@
+"""Entry point of the ``forge`` command (forge-shadow compatibility distribution).
+
+``forge`` is ``blade`` under its pre-PAAS-771 name. It lives outside the
+``forge`` package so running the command does not trip the shim's
+import-time DeprecationWarning; a one-line notice on stderr says it instead.
+"""
+
+from __future__ import annotations
+
+import sys
+
+
+def main() -> None:
+    sys.stderr.write("`forge` is now `blade` — this alias will be removed in a future release.\n")
+    sys.stderr.flush()
+    from bladekit.cli import app
+
+    app(prog_name="forge")

forge_shadow-4.5.0.dist-info/METADATA

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: forge-shadow
+Version: 4.5.0
+Summary: Deprecated name of bladekit (Blade AI Fabric SDK): installs it plus the `forge` import shim and command.
+Author: Blade AI Fabric team
+License: Proprietary
+Requires-Python: >=3.10
+Requires-Dist: bladekit==4.5.0
+Description-Content-Type: text/markdown
+
+# forge-shadow (deprecated name)
+
+The Forge SDK is now **Blade AI Fabric**: install `bladekit`, import
+`bladekit`, run `blade`.
+
+```bash
+pip install bladekit
+```
+
+This `forge-shadow` distribution only exists so existing installs, scripts and
+container images keep working. It installs `bladekit` at the same version,
+plus:
+
+- a `forge` import package that forwards to `bladekit` (`import forge`
+  emits a `DeprecationWarning`);
+- a `forge` command, an alias of `blade`.
+
+Migration notes: see the `bladekit` README, section "Migrating from forge".

forge_shadow-4.5.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+forge/__init__.py,sha256=GlVfBCZgjeQtkrdD6Wjw6RjmDI4jisJtjNaqL9AU8L4,3225
+forge_shadow/__init__.py,sha256=Fn4TJG3kcH0lov3IaTfAcv0QBFXCeQ3RdjCBz3VB6Ik,559
+forge_shadow-4.5.0.dist-info/METADATA,sha256=QEkwuDv6Y8ecJ67FRx6Xb5F-G9-KF4eaqpkmMqlb4wY,863
+forge_shadow-4.5.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+forge_shadow-4.5.0.dist-info/entry_points.txt,sha256=CLZfHaWznfW89OdIW0EtGjb-amWaglbeoGZQCm1xILY,44
+forge_shadow-4.5.0.dist-info/RECORD,,

forge_shadow-4.5.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

forge_shadow-4.5.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+forge = forge_shadow:main