advscope 0.1.0__tar.gz

advscope-0.1.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: advscope
+Version: 0.1.0
+Summary: Advanced scope utilities for Python.
+Author: Olan
+License: MIT
+Keywords: scope,namespace,utilities
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8

advscope-0.1.0/advscope/__init__.py

@@ -0,0 +1,19 @@
+from .core import (
+    Namespace,
+    Scope,
+    GlobalScope,
+    LocalScope,
+    private,
+    isnamespace,
+    PrivateAccessError,
+)
+
+__all__ = [
+    "Namespace",
+    "Scope",
+    "GlobalScope",
+    "LocalScope",
+    "private",
+    "isnamespace",
+    "PrivateAccessError",
+]

advscope-0.1.0/advscope/core.py

@@ -0,0 +1,150 @@
+import functools
+import inspect
+import sys
+import types
+import weakref
+
+class Namespace:
+    _private_methods = weakref.WeakKeyDictionary()
+
+    def __new__(cls, *args, **kwargs):
+        raise TypeError(
+            f"{cls.__name__} is a namespace and cannot be instantiated."
+        )
+
+    def __init_subclass__(cls):
+        super().__init_subclass__()
+
+        for name, value in list(cls.__dict__.items()):
+            func = value
+
+            if isinstance(value, staticmethod):
+                func = value.__func__
+
+            if isinstance(func, types.FunctionType):
+                original = getattr(
+                    func,
+                    "__advscope_original__",
+                    func
+                )
+
+                if getattr(func, "__advscope_private__", False):
+                    Namespace._private_methods[original] = cls
+                else:
+                    setattr(
+                        cls,
+                        name,
+                        staticmethod(func)
+                    )
+
+def isnamespace(obj):
+    """
+    Return True if obj is a subclass of Namespace.
+    """
+
+    return isinstance(obj, type) and issubclass(obj, Namespace)
+
+class PrivateAccessError(Exception):
+    """
+    Raised when a private member is accessed from outside
+    its allowed namespace.
+    """
+
+    pass
+
+def private(func):
+    if not isinstance(func, types.FunctionType):
+        raise TypeError("@private can only be used on functions")
+
+    @functools.wraps(func)
+    def wrapper(*args, **kwargs):
+        owner = Namespace._private_methods.get(func)
+
+        if owner is None:
+            raise PrivateAccessError(
+                f"Private member '{func.__name__}' has no namespace owner."
+            )
+
+        frame = inspect.currentframe().f_back
+
+        while frame:
+            for member in owner.__dict__.values():
+                if isinstance(member, staticmethod):
+                    member = member.__func__
+
+                if isinstance(member, types.FunctionType):
+                    if frame.f_code is member.__code__:
+                        return func(*args, **kwargs)
+
+            frame = frame.f_back
+
+        raise PrivateAccessError(
+            f"Cannot access private member "
+            f"'{owner.__name__}.{func.__name__}' outside its namespace."
+        )
+
+    wrapper.__advscope_private__ = True
+    wrapper.__advscope_original__ = func
+
+    return wrapper
+
+class GlobalScope:
+    """
+    Represents a global scope shared across the application.
+    """
+
+    def __new__(cls, *args, **kwargs):
+        raise TypeError(
+            "GlobalScope cannot be instantiated."
+        )
+
+class LocalScopeMeta(type):
+    _storage = {}
+
+    def __getattr__(cls, name):
+        module = sys._getframe(1).f_globals["__name__"]
+
+        scope = cls._storage.get(module, {})
+
+        if name in scope:
+            return scope[name]
+
+        raise AttributeError(
+            f"{name!r} does not exist in local scope of {module}"
+        )
+
+    def __setattr__(cls, name, value):
+        if name == "_storage":
+            return super().__setattr__(name, value)
+
+        module = sys._getframe(1).f_globals["__name__"]
+
+        if module not in cls._storage:
+            cls._storage[module] = {}
+
+        cls._storage[module][name] = value
+
+
+class LocalScope(metaclass=LocalScopeMeta):
+    """
+    Scope that belongs only to the module using it.
+    """
+
+    def __new__(cls, *args, **kwargs):
+        raise TypeError("LocalScope cannot be instantiated.")
+
+class Scope:
+    """
+    A dynamic attribute-based scope.
+    """
+
+    def __init__(self, **kwargs):
+        for name, value in kwargs.items():
+            setattr(self, name, value)
+
+    def __repr__(self):
+        attrs = ", ".join(
+            f"{key}={value!r}"
+            for key, value in self.__dict__.items()
+        )
+        return f"Scope({attrs})"

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

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: advscope
+Version: 0.1.0
+Summary: Advanced scope utilities for Python.
+Author: Olan
+License: MIT
+Keywords: scope,namespace,utilities
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8

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

@@ -0,0 +1,7 @@
+pyproject.toml
+advscope/__init__.py
+advscope/core.py
+advscope.egg-info/PKG-INFO
+advscope.egg-info/SOURCES.txt
+advscope.egg-info/dependency_links.txt
+advscope.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+advscope

advscope-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "advscope"
+version = "0.1.0"
+description = "Advanced scope utilities for Python."
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+    { name = "Olan" }
+]
+keywords = [
+    "scope",
+    "namespace",
+    "utilities"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Operating System :: OS Independent"
+]

advscope-0.1.0/setup.cfg

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