code-smaller 0.1.0__py3-none-any.whl

code_smaller-0.1.0.dist-info/METADATA

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: code-smaller
+Version: 0.1.0
+Summary: Code-smaller python abstractions
+Author-email: Ari Fishman <arifishman39@gmail.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/codesmaller/code-smaller
+Project-URL: Repository, https://github.com/codesmaller/code-smaller
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# code-smaller
+
+Simple, intuitive abstractions for common Python tasks.
+
+## Status
+
+🚧 **Early Development** – APIs changing constantly. Pin the version you are using!
+
+## Contributing
+
+Feedback and abstraction requests are welcome! Open an issue to suggest new ideas or improvements.
+
+## License
+
+[Apache 2.0](LICENSE)
+
+## Installation
+
+```bash
+pip install code-smaller
+```

code_smaller-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+code_smaller-0.1.0.dist-info/licenses/LICENSE,sha256=sDcNbwpkS5sM6O0Y_lvTilLF0pO0bATQz5GTOvyex8c,774
+smaller/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+smaller/default.py,sha256=Oxru7W_7prBa23s9Ow0TeE7-CrZIERIFlISgsoQAvho,224
+smaller/sentinel.py,sha256=P7M-kf8aC1ZMoqa6C41WEkMvSvXPyoDDcjke5z3tx3k,624
+smaller/unset.py,sha256=F7SUOGnN8PaV77feIqbzp_toYkN_JuMXcJJs_h-vI6g,260
+code_smaller-0.1.0.dist-info/METADATA,sha256=ZbamVZd1c0iL9hSqaOMVo2o-ZUKja0wNlskkcZhGKGo,838
+code_smaller-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+code_smaller-0.1.0.dist-info/top_level.txt,sha256=aVySEblKTzpEX93T6tYAjpfjrG18zc6QXHgIVjKD0lk,8
+code_smaller-0.1.0.dist-info/RECORD,,

code_smaller-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
+

code_smaller-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,19 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+Copyright [2025] Ari Fishman
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

code_smaller-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+smaller

smaller/default.py

@@ -0,0 +1,12 @@
+from .sentinel import Sentinel
+
+
+"""
+Sentinel placeholder for default values.
+
+Usage:
+    def func(param=DEFAULT):
+        if param is DEFAULT:
+            ...
+"""
+DEFAULT = Sentinel(name="DEFAULT", truthy=True)

smaller/sentinel.py

@@ -0,0 +1,27 @@
+
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True, slots=True)
+class Sentinel:
+    """
+    Custom truthy or falsy "sentinel" object for representing special states or values.
+
+    Usage:
+        DEFAULT = Sentinel(name="DEFAULT", truthy=True)
+
+        if value is DEFAULT:
+            ...
+    """
+
+    # object representation string for logs and debugging
+    name: str
+
+    # whether the sentinel should evaluate to True or False in if statements
+    truthy: bool
+
+    def __bool__(self) -> bool:
+        return self.truthy
+
+    def __repr__(self) -> str:
+        return f"{self.name}"

smaller/unset.py

@@ -0,0 +1,12 @@
+from .sentinel import Sentinel
+
+
+"""
+Sentinel for identifying omitted parameter vs parameter explicitly set to None etc.
+
+Usage:
+    def func(param=UNSET):
+        if param is UNSET:
+            ...
+"""
+UNSET = Sentinel(name="UNSET", truthy=False)