microconst 0.1.0__py3-none-any.whl

microconst/__init__.py

@@ -0,0 +1,6 @@
+from microconst.entry import parse_entry
+from microconst.members import Key
+from microconst.members import create_flag as flag
+from microconst.members import create_key as key
+
+__all__ = ["Key", "flag", "key", "parse_entry"]

microconst/entry.py

@@ -0,0 +1,6 @@
+from collections.abc import Callable
+
+
+def parse_entry[T](data: str, value_type: Callable[[str], T]) -> T:
+    str_value = data[2:]
+    return value_type(str_value)

microconst/key.py

@@ -0,0 +1,29 @@
+from collections.abc import Generator
+from string import ascii_letters, digits
+
+CHARACTERS = f"{ascii_letters}{digits}"
+
+MAX_IDX = len(CHARACTERS) - 1
+MAX_KEYS = len(CHARACTERS) ** 2
+
+
+def create_unique_key_generator() -> Generator[str, None, None]:
+    left_idx: int = 0
+    right_idx: int = 0
+
+    while right_idx != MAX_IDX + 1:
+        pair: str = CHARACTERS[left_idx] + CHARACTERS[right_idx]
+
+        if left_idx == MAX_IDX:
+            left_idx = 0
+            right_idx += 1
+        else:
+            left_idx += 1
+
+        yield pair
+
+    msg = f"cannot create more than {MAX_KEYS} keys"
+    raise OverflowError(msg)
+
+
+unique_key_generator = create_unique_key_generator()

microconst/members.py

@@ -0,0 +1,32 @@
+from collections.abc import Callable
+from typing import Self
+
+from microconst.entry import parse_entry
+from microconst.key import unique_key_generator
+
+
+class Key[T](str):
+    # Subclasses of str should define __slots__
+    __slots__ = ("type",)
+    # We'll assign to this in __new__
+    type: Callable[[str], T]
+
+    def __new__(cls, name: str, value_type: Callable[[str], T]) -> Self:
+        instance = super().__new__(cls, name)
+        instance.type = value_type
+        return instance
+
+    def __call__(self, value: T) -> str:
+        return f"{self}{value}"
+
+    def parse_entry(self, data: str) -> T:
+        return parse_entry(data, self.type)
+
+
+def create_flag() -> str:
+    return next(unique_key_generator)
+
+
+def create_key[T](value_type: type[T]) -> Key[T]:
+    name = next(unique_key_generator)
+    return Key(name, value_type)

microconst/py.typed

@@ -0,0 +1 @@
+This file serves as a type annotation marker.

microconst-0.1.0.dist-info/METADATA

@@ -0,0 +1,87 @@
+Metadata-Version: 2.4
+Name: microconst
+Version: 0.1.0
+Summary: Library for optimizing enum constant values
+Author-email: triple-raze <weebucks2@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/triple-raze/microconst
+Project-URL: Repository, https://github.com/triple-raze/microconst.git
+Project-URL: Issues, https://github.com/triple-raze/microconst/issues
+Keywords: enum,compact
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# microconst
+[![pypi](https://img.shields.io/pypi/v/microconst)](https://pypi.org/project/microconst/)
+![python](https://img.shields.io/badge/python-3.12+-blue?logo=python)
+![typed](https://img.shields.io/badge/typed-yes-blue)
+![tests](https://img.shields.io/badge/tests-manual-green) 
+![license](https://img.shields.io/badge/license-MIT-blue)
+
+Replace long constant names with 2 ASCII keys
+
+## Installation
+pip: 
+```
+pip install microconst
+```
+poetry:
+```
+poetry add microconst
+```
+
+## Features
+#### Constants
+Every call of `flag` or `key` generates 2-character key. This key is represented as left and right indexes of `f"{ascii_letters}{digits}"` str. Each time the left index reaches cap, it resets to 0 and right index increments.<br>
+After reaching both of caps, next call of function will throw `OverflowError`. Current maximum count of keys is 3844.
+
+#### Typing
+`key` function requires `value_type` argument, such as `str`, `int` etc. This type used in both static analysis and type convertion with `Key.parse_entry(data)` function. 
+
+## Examples
+Main purpose of this library is making telegram bot's "callback_data" much more compact because of 64-byte limit. You can see more realistic example [here](example)<br><br>
+#### Flag usage:
+```python
+from microconst import flag
+
+# Autogenerates unique pairs of characters
+class Status:
+    PENDING = flag()
+    APPROVED = flag()
+    REJECTED = flag()
+
+assert Status.PENDING == "aa"
+assert Status.APPROVED == "ba"
+assert Status.REJECTED == "ca"
+```
+
+#### Key usage:
+```python
+from microconst import key, parse_entry
+
+USER = key(str)
+
+# You can call keys to create key-value pair (acts same as concat)
+username = USER("name") 
+# Getting value
+value = USER.parse_entry(username) 
+
+assert username == "aaname"
+assert value == "name"
+
+# You can use seperate function or method. Method doesnt require type argument
+assert parse_entry(username, str) == value
+```
+
+## License
+MIT

microconst-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+microconst/__init__.py,sha256=TSa3h7q5xtLLglUtUdBJvv395YYoAzYvB1ehj5UdiiE,231
+microconst/entry.py,sha256=9oEKshzIcOgwhj1ZkTnHiZ2ejeVhXFiXDGChHfOhdqQ,171
+microconst/key.py,sha256=nhNeyP8gDulWcgGo1UwUNTEszBB2p3ZxX4HUdlznjKI,709
+microconst/members.py,sha256=m_FWujh3drGconuyNNh77KdUuwWZ-7IJhw8EMlsmQaI,875
+microconst/py.typed,sha256=TYyiMxTQNcIkn-rpK_EarmVnGNXcBohGJy2b1REexQo,45
+microconst-0.1.0.dist-info/METADATA,sha256=8-k0Ubgy1qi_gynnfdtWru5ApqP75u38zV5R2KC_1Hg,2947
+microconst-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+microconst-0.1.0.dist-info/top_level.txt,sha256=XVBEqhpR9o0B51aKQ-3Bxn1AqJTHZ1IMQMcKRx8h0KY,11
+microconst-0.1.0.dist-info/RECORD,,

microconst-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

microconst-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+microconst