python-clu 0.12.11__tar.gz → 0.12.12__tar.gz

{python_clu-0.12.11 → python_clu-0.12.12}/.bumpversion.toml

@@ -1,6 +1,6 @@
 
 [tool.bumpversion]
-current_version = "0.12.11"
+current_version = "0.12.12"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 search = "{current_version}"

{python_clu-0.12.11 → python_clu-0.12.12}/CHANGELOG.md

@@ -1,10 +1,36 @@
 # Changelog
 
 
-## 0.12.10:pre1+g4e2fdbd [SNAPSHOT]
+## 0.12.11:pre6+gf6ef978 [SNAPSHOT]
 
 ### Other
 
+* Reaffirming the commands’ non-erroneousness AGAIN!! [Alexander Böhn]
+
+* Reaffirming the commands’ non-erroneousness. [Alexander Böhn]
+
+* Supress raising pointless `ValueError`s when running “clu-ansidocs” [Alexander Böhn]
+
+* Properly assigning `__doc__` string. [Alexander Böhn]
+
+* Small updates to `clu.enums` and `clu.naming.qualified_import(…)` [Alexander Böhn]
+
+  … “clu.enums” uses its DUNDER constant internally
+  … “clu.naming.qualified_import(…)” has an internally-used “recurse”
+     argument that basically disables the whole “qualified” check,
+     which by the way I am starting to see as totally unnecessary
+
+* Docstring MUST OCCUR FIRST!!! in a thing. [Alexander Böhn]
+
+
+## v0.12.11 (2025-05-25)
+
+### Other
+
+* Bumped version: 0.12.10 → 0.12.11. [Alexander Böhn]
+
+* [make] New changelog added. [Alexander Böhn]
+
 * Ahhhh my home-brewed classifier didn’t work, booooo. [Alexander Böhn]
 
 

{python_clu-0.12.11 → python_clu-0.12.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-clu
-Version: 0.12.11
+Version: 0.12.12
 Summary: Python-CLU: Common Lightweight Utilities
 Home-page: https://github.com/fish2000/clu
 Download-URL: https://github.com/fish2000/clu/zipball/master

python_clu-0.12.12/clu/__version__.py

@@ -0,0 +1 @@
+__version__ = '0.12.12'

{python_clu-0.12.11 → python_clu-0.12.12}/clu/enums.py

@@ -16,8 +16,6 @@ MIFFLIN = SUNDER = '_aliases_'
 @export
 class alias(clu.abstract.BaseDescriptor, metaclass=clu.abstract.Slotted):
     
-    __slots__ = ('name', 'aliased')
-    
     """ Alias one Enum class instance to another. To wit:
         
             @unique
@@ -48,6 +46,8 @@ class alias(clu.abstract.BaseDescriptor, metaclass=clu.abstract.Slotted):
         ISN’T ALL OF THAT FUCKING AWESOME?!?!? I think so. Yes!
     """
     
+    __slots__ = ('name', 'aliased')
+    
     def __init__(self, instance, name=None, cls=None):
         """ Set up the alias, passing an enum instance.
             
@@ -94,7 +94,7 @@ class alias(clu.abstract.BaseDescriptor, metaclass=clu.abstract.Slotted):
             if it has a dictionary attribute “__aliases__”).
         """
         self.name = name
-        if hasattr(cls, '__aliases__'):
+        if hasattr(cls, DUNDER): # check for __aliases__
             if self.name in cls.__aliases__:
                 message = f"Enum already contains an alias named {self.name}"
                 raise AttributeError(message)
@@ -113,8 +113,8 @@ class AliasingEnumMeta(EnumMeta):
             the normal enum `__members__` directory only with aliases. Yes.
         """
         
-        if '__aliases__' not in attributes:
-            attributes['__aliases__'] = {}
+        if DUNDER not in attributes:
+            attributes[DUNDER] = {}
         
         return super().__new__(metacls, name,
                                         bases,

{python_clu-0.12.11 → python_clu-0.12.12}/clu/naming.py

@@ -248,17 +248,17 @@ def dotpath_split(dotpath):
     return head, tail or None
 
 @export
-def qualified_import(qualified):
+def qualified_import(qualified, *, recurse=False):
     """ Import a thing based on its full thing-name.
         e.g. 'instakit.processors.halftone.FloydSteinberg'
     """
-    if QUALIFIER not in qualified:
+    if not recurse and QUALIFIER not in qualified:
         raise ValueError(f"qualified name required (got {qualified})")
     try:
         imported = importlib.import_module(qualified)
     except ModuleNotFoundError:
         head, tail = dotpath_split(qualified)
-        module = qualified_import(tail)
+        module = qualified_import(tail, recurse=True)
         imported = getattr(module, head)
     return imported
 

{python_clu-0.12.11 → python_clu-0.12.12}/clu/repl/cli/ansidocs.py

@@ -18,9 +18,9 @@ def actually_print_ansidocs(dotpath):
     
     # Attempt to import it:
     try:
-        thing = qualified_import(dotpath)
+        thing = qualified_import(dotpath, recurse=True)
     except ValueError:
-        thing = import_module(dotpath)
+        thing = actually_print_ansidocs(dotpath)
     except AttributeError as error:
         error_string = str(error)
         print(f"[ERROR] {error_string}", file=ansidocs.iohandle)
@@ -28,6 +28,7 @@ def actually_print_ansidocs(dotpath):
     
     # This goes directly to stdout:
     ansidocs(thing)
+    return thing
 
 def ansidocs_command():
     """ Print out the ANSI-ified docstring for the given thing(s) """

{python_clu-0.12.11 → python_clu-0.12.12}/clu/scripts/treeline.py

@@ -20,7 +20,7 @@ from clu.exporting import Exporter
 exporter = Exporter(path=__file__)
 export = exporter.decorator()
 
-"""
+__doc__ = """
 TREELINE – tree ± command-line
 
 • Turn a command like this:

{python_clu-0.12.11 → python_clu-0.12.12}/python_clu.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-clu
-Version: 0.12.11
+Version: 0.12.12
 Summary: Python-CLU: Common Lightweight Utilities
 Home-page: https://github.com/fish2000/clu
 Download-URL: https://github.com/fish2000/clu/zipball/master

{python_clu-0.12.11 → python_clu-0.12.12}/setup.py

@@ -84,7 +84,7 @@ try:
             '__version__.py')).read(),
             '__version__.py', 'exec'))
 except:
-    __version__ = '0.12.11'
+    __version__ = '0.12.12'
 
 # PROJECT DESCRIPTION
 LONG_DESCRIPTION = project_content('ABOUT.md')

python_clu-0.12.11/clu/__version__.py

@@ -1 +0,0 @@
-__version__ = '0.12.11'