langex 0.1.2__tar.gz

langex-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AttAditya
+
+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.

langex-0.1.2/LangEx.egg-info/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: langex
+Version: 0.1.2
+Summary: Extended Language Support for Python
+Author: AttAditya
+Requires-Python: >=3.14
+License-File: LICENSE
+Dynamic: license-file

langex-0.1.2/LangEx.egg-info/SOURCES.txt

@@ -0,0 +1,23 @@
+LICENSE
+README.md
+pyproject.toml
+LangEx.egg-info/PKG-INFO
+LangEx.egg-info/SOURCES.txt
+LangEx.egg-info/dependency_links.txt
+LangEx.egg-info/entry_points.txt
+LangEx.egg-info/top_level.txt
+langex/__init__.py
+langex/__main__.py
+langex/immediate.py
+langex/interface.py
+langex.egg-info/PKG-INFO
+langex.egg-info/SOURCES.txt
+langex.egg-info/dependency_links.txt
+langex.egg-info/entry_points.txt
+langex.egg-info/top_level.txt
+langex/core/__init__.py
+langex/core/callable_meta.py
+langex/core/class_meta.py
+langex/core/meta.py
+langex/core/object_meta.py
+langex/core/use.py

langex-0.1.2/LangEx.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

langex-0.1.2/LangEx.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+langex = langex.__main__:main

langex-0.1.2/LangEx.egg-info/top_level.txt

@@ -0,0 +1 @@
+langex

langex-0.1.2/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: langex
+Version: 0.1.2
+Summary: Extended Language Support for Python
+Author: AttAditya
+Requires-Python: >=3.14
+License-File: LICENSE
+Dynamic: license-file

langex-0.1.2/README.md

@@ -0,0 +1,94 @@
+# [LangEx](https://pypi.org/project/langex/)
+
+Extended Language Support for Python
+
+## Installation
+
+```sh
+pip install langex
+```
+
+## About
+
+LangEx is an experimental Python library that introduces additional language-level constructs using decorators, metadata inspection, and structural validation. It focuses on enabling capabilities that Python does not strictly enforce by default, such as interface-like behavior and structured object metadata.
+
+The project builds small language utilities that operate on Python objects (functions, classes, and other callables) to inspect, validate, and extend their behavior while remaining fully compatible with standard Python.
+
+## Features
+- Interface-like constructs for Python classes
+- Metadata extraction for Python objects and callables
+- Runtime validation utilities
+- Decorator-based language extensions
+- Lightweight core inspection tools
+
+## Example
+
+### Defining an Interface
+
+```py
+from langex.interface import interface
+
+@interface
+class Repository:
+  def save(self, data): ...
+  def get(self, id): ...
+```
+
+### Implementing the Interface
+
+```py
+from langex.interface import implements
+
+@implements(Repository)
+class UserRepository:
+  def save(self, data):
+    ...
+
+  def get(self, id):
+    ...
+```
+
+If required methods are missing, validation will raise an error.
+
+## Project Structure
+
+```tree
+langex
+├── __init__.py
+├── __main__.py
+├── immediate.py
+├── interface.py
+├── core
+│   ├── __init__.py
+│   ├── callable_meta.py
+│   ├── class_meta.py
+│   ├── meta.py
+│   ├── object_meta.py
+│   └── use.py
+```
+
+The core module provides internal abstractions for inspecting Python objects and extracting structured metadata used by higher-level utilities like interfaces and validations.
+
+## Design Philosophy
+
+LangEx is designed around a few principles:
+- Pure Python implementation
+- Minimal runtime overhead
+- Explicit developer intent
+- Small composable language utilities
+
+Rather than acting as a framework, LangEx provides foundational language tools that can be used to build higher-level abstractions.
+
+## Status
+
+Experimental and under active development.
+APIs and structure may evolve as the project grows.
+
+## Links
+
+- [PyPI](https://pypi.org/project/langex/)
+- [GitHub](https://github.com/attaditya/langex)
+- [License](https://github.com/attaditya/langex/tree/main/LICENSE)
+
+> _Made with <3 by [AttAditya](https://github.com/AttAditya)_
+

langex-0.1.2/langex/__init__.py

@@ -0,0 +1,2 @@
+__all__ = []
+

langex-0.1.2/langex/__main__.py

@@ -0,0 +1,2 @@
+
+

langex-0.1.2/langex/core/__init__.py

@@ -0,0 +1,2 @@
+__all__ = []
+

langex-0.1.2/langex/core/callable_meta.py

@@ -0,0 +1,45 @@
+class _LangexCallableTypehints:
+  def __init__(self):
+    self.has_typehints = False
+    self.has_return_type = False
+    self.has_pos_args = False
+    self.has_kw_args = False
+    self.has_pos_args_list = False
+    self.has_kw_args_dict = False
+    self.return_type = None
+    self.pos_args = []
+    self.kw_args = {}
+    self.pos_args_list = []
+    self.kw_args_dict = {
+      "keys": [],
+      "values": [],
+    }
+
+  def matches_signature(self, other):
+    has_match = [
+      self.has_typehints == other.has_typehints,
+      self.has_return_type == other.has_return_type,
+      self.has_pos_args == other.has_pos_args,
+      self.has_kw_args == other.has_kw_args,
+      self.has_pos_args_list == other.has_pos_args_list,
+      self.has_kw_args_dict == other.has_kw_args_dict,
+    ]
+
+    value_match = [
+      self.return_type == other.return_type,
+      self.pos_args == other.pos_args,
+      self.kw_args == other.kw_args,
+      self.pos_args_list == other.pos_args_list,
+      self.kw_args_dict == other.kw_args_dict,
+    ]
+
+    return all(has_match) and all(value_match)
+
+class LangexCallableMeta:
+  def __init__(self):
+    self.typehints = _LangexCallableTypehints()
+
+__all__ = [
+  "LangexCallableMeta",
+]
+

langex-0.1.2/langex/core/class_meta.py

@@ -0,0 +1,9 @@
+class LangexClassMeta:
+  def __init__(self):
+    self.is_interface = False
+    self.callables = {}
+
+__all__ = [
+  "LangexClassMeta",
+]
+

langex-0.1.2/langex/core/meta.py

@@ -0,0 +1,14 @@
+from langex.core.callable_meta import LangexCallableMeta
+from langex.core.class_meta import LangexClassMeta
+from langex.core.object_meta import LangexObjectMeta
+
+class LangexMeta:
+  def __init__(self):
+    self.class_meta = LangexClassMeta()
+    self.callable_meta = LangexCallableMeta()
+    self.object_meta = LangexObjectMeta()
+
+__all__ = [
+  "LangexMeta",
+]
+

langex-0.1.2/langex/core/object_meta.py

@@ -0,0 +1,7 @@
+class LangexObjectMeta:
+  pass
+
+__all__ = [
+  "LangexObjectMeta",
+]
+

langex-0.1.2/langex/core/use.py

@@ -0,0 +1,19 @@
+from langex.core.meta import LangexMeta
+
+def use_langex(target):
+  if not hasattr(target, "__langex__"):
+    setattr(target, "__langex__", LangexMeta())
+
+  return target
+
+def access_langex(target):
+  if not hasattr(target, "__langex__"):
+    use_langex(target)
+
+  return target.__langex__
+
+__all__ = [
+  "use_langex",
+  "access_langex",
+]
+

langex-0.1.2/langex/immediate.py

@@ -0,0 +1,7 @@
+def immediate(func):
+  return func()
+
+__all__ = [
+  "immediate",
+]
+

langex-0.1.2/langex/interface.py

@@ -0,0 +1,92 @@
+from langex.core.use import access_langex, use_langex
+from langex.immediate import immediate
+
+@immediate
+def _ignored_attributes():
+  @use_langex
+  class _BlankClass:
+    pass
+
+  return set(dir(_BlankClass))
+
+def interface(cls):
+  use_langex(cls)
+  attributes = set(dir(cls))
+  attributes -= _ignored_attributes
+  lnx = access_langex(cls)
+  class_meta = lnx.class_meta
+  class_meta.is_interface = True
+
+  for attribute_name in attributes:
+    attribute = getattr(cls, attribute_name)
+
+    if not callable(attribute):
+      continue
+
+    callable_lnx = access_langex(attribute)
+    typehints = callable_lnx.callable_meta.typehints
+
+    if typehints.has_typehints:
+      class_meta.callables[attribute_name] = callable_lnx
+
+  def raise_uninstantiable_error(*_, **_____):
+    raise TypeError(" ".join([
+      f"Class {cls.__name__} is an interface.",
+      "It may not be instantiated."
+    ]))
+
+  setattr(cls, "__init__", raise_uninstantiable_error)
+
+  return cls
+
+def implements(*interfaces):
+  callables = {}
+
+  for interface in interfaces:
+    lnx = access_langex(interface)
+    class_meta = lnx.class_meta
+
+    if not class_meta.is_interface:
+      raise TypeError(" ".join([
+        f"Class {interface.__name__} is not an interface.",
+        "Only interfaces may be implemented."
+      ]))
+
+    conflict_callables = set()
+
+    for callable_name in class_meta.callables:
+      if callable_name in callables:
+        overiding_callable = class_meta.callables[callable_name]
+        existing_callable = callables[callable_name]
+
+        if not existing_callable.matches_signature(overiding_callable):
+          conflict_callables.add(callable_name)
+          continue
+
+      callables[callable_name] = class_meta.callables[callable_name]
+
+  def decorator(cls):
+    unimplemented_methods = callables.keys() - set(dir(cls))
+
+    if conflict_callables:
+      raise TypeError(" ".join([
+        f"Class {cls.__name__} has methods that have ",
+        "conflicting signatures in interfaces: ",
+        ", ".join(conflict_callables),
+      ]))
+
+    if unimplemented_methods:
+      raise NotImplementedError(" ".join([
+        f"Class {cls.__name__} does not implement methods:",
+        ", ".join(unimplemented_methods),
+      ]))
+
+    return cls
+
+  return decorator
+
+__all__ = [
+  "interface",
+  "implements",
+]
+

langex-0.1.2/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "langex"
+version = "0.1.2"
+description = "Extended Language Support for Python"
+requires-python = ">=3.14"
+authors = [
+  { name = "AttAditya" }
+]
+
+[project.scripts]
+langex = "langex.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["langex*"]

langex-0.1.2/setup.cfg

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