designkit 0.1.0__tar.gz

designkit-0.1.0/.gitattributes

@@ -0,0 +1,14 @@
+* text=auto eol=lf
+
+*.bat text eol=crlf
+*.cmd text eol=crlf
+
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+
+*.so binary
+*.dll binary
+*.pyd binary

designkit-0.1.0/.github/workflows/CI.yml

@@ -0,0 +1,186 @@
+# This file is autogenerated by maturin v1.14.1
+# To update, run
+#
+#    maturin generate-ci github
+#
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - master
+    tags:
+      - '*'
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  linux:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: ubuntu-22.04
+            target: x86_64
+          - runner: ubuntu-22.04
+            target: x86
+          - runner: ubuntu-22.04
+            target: aarch64
+          - runner: ubuntu-22.04
+            target: armv7
+          - runner: ubuntu-22.04
+            target: s390x
+          - runner: ubuntu-22.04
+            target: ppc64le
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+          manylinux: auto
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-linux-${{ matrix.platform.target }}
+          path: dist
+
+  musllinux:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: ubuntu-22.04
+            target: x86_64
+          - runner: ubuntu-22.04
+            target: x86
+          - runner: ubuntu-22.04
+            target: aarch64
+          - runner: ubuntu-22.04
+            target: armv7
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+          manylinux: musllinux_1_2
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-musllinux-${{ matrix.platform.target }}
+          path: dist
+
+  windows:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: windows-latest
+            target: x64
+            python_arch: x64
+          - runner: windows-latest
+            target: x86
+            python_arch: x86
+          - runner: windows-11-arm
+            target: aarch64
+            python_arch: arm64
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+          architecture: ${{ matrix.platform.python_arch }}
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-windows-${{ matrix.platform.target }}
+          path: dist
+
+  macos:
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      matrix:
+        platform:
+          - runner: macos-15-intel
+            target: x86_64
+          - runner: macos-latest
+            target: aarch64
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - name: Upload wheels
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-macos-${{ matrix.platform.target }}
+          path: dist
+
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - name: Upload sdist
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-sdist
+          path: dist
+
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    if: ${{ startsWith(github.ref, 'refs/tags/') || github.event_name == 'workflow_dispatch' }}
+    needs: [linux, musllinux, windows, macos, sdist]
+    permissions:
+      # Use to sign the release artifacts
+      id-token: write
+      # Used to upload release artifacts
+      contents: write
+      # Used to generate artifact attestation
+      attestations: write
+    steps:
+      - uses: actions/download-artifact@v7
+      - name: Generate artifact attestation
+        uses: actions/attest@v4
+        with:
+          subject-path: 'wheels-*/*'
+      - name: Install uv
+        if: ${{ startsWith(github.ref, 'refs/tags/') }}
+        uses: astral-sh/setup-uv@v7
+      - name: Publish to PyPI
+        if: ${{ startsWith(github.ref, 'refs/tags/') }}
+        run: uv publish 'wheels-*/*'
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}

designkit-0.1.0/.gitignore

@@ -0,0 +1,74 @@
+/target
+/hidden
+/test.py
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+.pytest_cache/
+*.py[cod]
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+.venv/
+env/
+bin/
+build/
+develop-eggs/
+dist/
+eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+include/
+man/
+venv/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+pip-selfcheck.json
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.cache
+nosetests.xml
+coverage.xml
+
+# Translations
+*.mo
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# Rope
+.ropeproject
+
+# Django stuff:
+*.log
+*.pot
+
+.DS_Store
+
+# Sphinx documentation
+docs/_build/
+
+# PyCharm
+.idea/
+
+# VSCode
+.vscode/
+
+# Pyenv
+.python-version

designkit-0.1.0/Cargo.lock

@@ -0,0 +1,132 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "designkit"
+version = "0.1.0"
+dependencies = [
+ "pyo3",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "libc"
+version = "0.2.186"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.14.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3d20d5497ef88037a52ff98267d066e7f11fcc5e99bbfbd58a42336193aacec3"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.29.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cd274650b21d4bfc26a0a47587962c1edb425f69287324355cd040c3ea66071c"
+dependencies = [
+ "libc",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.29.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c5e2a7d2f0d013342f295c048ad19237add5154a55b1c5a254c0ec93d4109078"
+dependencies = [
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.29.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ca85c467da1bbc8d866eea5deff9cf29ea5f7785054a17da36e65bda9c05845b"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.29.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ac53762fd065daa3194dd09337a38bd793a188100fd1a9304c4ab312d901771"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.29.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4ca3a1557399783172dc5bf39cfca835157732532cba56b71d2292161e53b362"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.13.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "adb6935a6f5c20170eeceb1a3835a49e12e19d792f6dd344ccc76a985ca5a6ca"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"

designkit-0.1.0/Cargo.toml

@@ -0,0 +1,14 @@
+[package]
+name = "designkit"
+version = "0.1.0"
+edition = "2024"
+readme = "README.md"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+[lib]
+name = "designkit"
+path = "rust/lib.rs"
+crate-type = ["cdylib"]
+
+[dependencies]
+pyo3 = "0.29.0"

designkit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 José Daniel Avalos Becerra ~ Sheñey.
+
+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.

designkit-0.1.0/PKG-INFO

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: designkit
+Version: 0.1.0
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Software Development :: Libraries
+Requires-Dist: designkit-utils>=0.6.1,<0.7
+Requires-Dist: rich>=15.0.0,<16.0
+Requires-Dist: pytest>=9.1.1,<10.0 ; extra == 'dev'
+Requires-Dist: pytest-cov>=5.3.1,<6.0 ; extra == 'dev'
+Requires-Dist: mypy ; extra == 'dev'
+Provides-Extra: dev
+License-File: LICENSE
+Summary: A modern Python toolkit for software architecture, featuring all 23 GoF + 6 original design patterns, original architectural patterns, and powerful developer utilities.
+Keywords: patterns,design,kit,utils,framework,rust,pyo3
+Author-email: Sheñey <sheneyby2010@gmail.com>
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Changelog, https://github.com/Sheniey/designkit/releases
+Project-URL: Documentation, https://github.com/Sheniey/designkit
+Project-URL: Homepage, https://github.com/Sheniey/designkit
+Project-URL: Issues, https://github.com/Sheniey/designkit/issues
+Project-URL: Repository, https://github.com/Sheniey/designkit
+
+
+## What is DesignKit?
+DesignKit is a modern Python architecture toolkit that combines the 23 Gang of Four design patterns with original architectural abstractions, expressive APIs, and high-performance utilities to build cleaner, more maintainable software.
+

designkit-0.1.0/README.md

@@ -0,0 +1,3 @@
+
+## What is DesignKit?
+DesignKit is a modern Python architecture toolkit that combines the 23 Gang of Four design patterns with original architectural abstractions, expressive APIs, and high-performance utilities to build cleaner, more maintainable software.

designkit-0.1.0/TODO.md

@@ -0,0 +1,38 @@
+
+### Creational (5)
+ - [ ] Abstract Factory
+ - [ ] Builder
+ - [ ] Factory Method
+ - [X] Prototype
+ - [X] Singleton
+
+### Structural (7)
+ - [ ] Adapter
+ - [ ] Bridge
+ - [ ] Composite
+ - [X] Decorator
+ - [ ] Facade
+ - [ ] Flyweight
+ - [ ] Proxy
+
+### Behavioral (11)
+ - [X] Chain of Responsibility
+ - [X] Command
+ - [X] Interpreter
+ - [X] Iterator
+ - [X] Mediator
+ - [ ] Memento
+ - [ ] Observer
+ - [X] State
+ - [~] Strategy
+ - [X] Policy
+ - [X] Template Method
+ - [ ] Visitor
+
+ - [X] Control
+ - [X] Imperative
+ - [X] Matcher
+ - [X] Trie
+ - [X] Typing
+ - [X] Memorable
+

designkit-0.1.0/designkit/__init__.py

@@ -0,0 +1,6 @@
+
+from ._designkit import *
+
+from . import behavioral
+from . import structural
+from . import creational

designkit-0.1.0/designkit/behavioral/cache/__init__.py

@@ -0,0 +1,3 @@
+
+from .core import cached
+from .lru_cache import LRUCache

designkit-0.1.0/designkit/behavioral/cache/core.py

@@ -0,0 +1,23 @@
+
+from functools import wraps
+from typing import Callable
+
+from .models import AbstractCache
+from .lru_cache import LRUCache
+
+
+def cached[F: Callable[..., R], R](capacity: int, cache: AbstractCache[R] = LRUCache) -> Callable[[F], F]:
+    def decorator(func: F) -> F:
+        @wraps(func)
+        def wrapper(*args, **kwargs):
+            key: tuple[tuple, tuple[tuple[str, object]]] = (args, tuple(sorted(kwargs.items())))
+            if key in wrapper.cache:
+                return wrapper.cache.get(key)
+            
+            result: R = func(*args, **kwargs)
+            wrapper.cache.put(key, result)
+            return result
+
+        wrapper.cache = cache[R](capacity)
+        return wrapper
+    return decorator

designkit-0.1.0/designkit/behavioral/cache/lru_cache.py

@@ -0,0 +1,98 @@
+
+class Node[T]:
+    def __init__(self, key: str, value: T) -> None:
+        self.key: str = key
+        self.value: T = value
+        self.prev: Node[T] | None = None
+        self.next: Node[T] | None = None
+
+class LRUCache[T]:
+    def __init__(self, capacity: int) -> None:
+        self.__capacity: int = capacity
+        self.__map: dict[str, Node[T]] = {}
+        self.__head: Node[T] = Node('', 0)  # type: ignore
+        self.__tail: Node[T] = Node('', 0)  # type: ignore
+        self.__head.next = self.__tail
+        self.__tail.prev = self.__head
+
+    def __repr__(self) -> str:
+        nodes: list[str] = []
+        current: Node[T] | None = self.__head.next
+
+        while current is not None and current != self.__tail:
+            nodes.append(f'({current.key}: {current.value})')
+            current = current.next
+        
+        return ' <-> '.join(nodes)
+
+    def __str__(self) -> str:
+        return f'{self.__class__.__name__}( capacity={self.__capacity}, map={self.__map} )'
+
+    def __getitem__(self, key: str) -> T:
+        return self.get(key)
+
+    def __setitem__(self, key: str, value: T) -> None:
+        self.put(key, value)
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.__map
+
+    def __len__(self) -> int:
+        return len(self.__map)
+    
+    def _remove(self, node: Node[T]) -> None:
+        if node.prev is not None:
+            node.prev.next = node.next
+
+        if node.next is not None:
+            node.next.prev = node.prev
+    
+    def _add_to_front(self, node: Node[T]) -> None:
+        node.next = self.__head.next
+        node.prev = self.__head
+        self.__head.next.prev = node
+        self.__head.next = node
+    
+    def get(self, key: str) -> T:
+        node: Node[T] | None = self.__map.get(key)
+
+        if node is None:
+            return -1
+        
+        self._remove(node)
+        self._add_to_front(node)
+        
+        return node.value
+
+    def put(self, key: str, value: T) -> None:
+        existing: Node[T] | None = self.__map.get(key)
+
+        if existing is not None:
+            existing.value = value
+            self._remove(existing)
+            self._add_to_front(existing)
+            return
+        
+        node: Node[T] = Node(key, value)
+        self.__map[key] = node
+
+        self._add_to_front(node)
+
+        if len(self.__map) > self.__capacity:
+            lru: Node[T] | None = self.__tail.prev
+
+            if lru is not None:
+                self._remove(lru)
+                del self.__map[lru.key]
+
+    @property
+    def capacity(self) -> int:
+        return self.__capacity
+
+    @property
+    def free_space(self) -> int:
+        return self.__capacity - len(self.__map)
+
+    @property
+    def is_full(self) -> bool:
+        return len(self.__map) >= self.__capacity

designkit-0.1.0/designkit/behavioral/cache/models.py

@@ -0,0 +1,12 @@
+
+from abc import ABC, abstractmethod
+
+
+class AbstractCache[T](ABC):
+    @abstractmethod
+    def get(self, key: str) -> T:
+        ...
+
+    @abstractmethod
+    def put(self, key: str, value: T) -> None:
+        ...

designkit-0.1.0/designkit/behavioral/chain_of_responsibility/__init__.py

@@ -0,0 +1,2 @@
+
+from .core import AbstractHandler, Handler, HandlerChain