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

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

@@ -1,6 +1,6 @@
 
 [tool.bumpversion]
-current_version = "0.12.9"
+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.9 → python_clu-0.12.12}/CHANGELOG.md

@@ -1,7 +1,65 @@
 # Changelog
 
 
-## 0.12.8:pre8+g4f192b8 [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]
+
+
+## v0.12.10 (2025-05-25)
+
+### Other
+
+* Bumped version: 0.12.9 → 0.12.10. [Alexander Böhn]
+
+* [make] New changelog added. [Alexander Böhn]
+
+* Fixed `clu.naming.qualified_name_tuple(…)` to work for module objects. [Alexander Böhn]
+
+  … this involved special-casing the whole thing, but it was worth it,
+    as it just wasn’t fucking working for this entire case this whole
+    time, which is fucking embarrasing. Yes!
+
+* More requirement/REPL-import adjustments. [Alexander Böhn]
+
+* Code of Conduct clarification. [Alexander Böhn]
+
+* Classifier tidy-up. [Alexander Böhn]
+
+* Gentlemen prefer f-strings. [Alexander Böhn]
+
+* Updating straggling little info corners that didn’t get the memo. [Alexander Böhn]
+
+
+## v0.12.9 (2025-05-24)
 
 ### Add
 
@@ -13,6 +71,10 @@
 
 ### Other
 
+* Bumped version: 0.12.8 → 0.12.9. [Alexander Böhn]
+
+* [make] New changelog added. [Alexander Böhn]
+
 * Removed (fortunately vestigial) Click package dependency. [Alexander Böhn]
 
 * Expanded “getdoc” codepath in `clu.repl.ansi.signature(…)` [Alexander Böhn]

{python_clu-0.12.9 → python_clu-0.12.12}/CLASSIFIERS.txt

@@ -5,7 +5,6 @@ Topic :: Software Development
 Topic :: Software Development :: Testing
 Topic :: Utilities
 Operating System :: MacOS
-Operating System :: Microsoft :: Windows
 Operating System :: OS Independent
 Operating System :: POSIX
 Operating System :: Unix

{python_clu-0.12.9 → python_clu-0.12.12}/CODE_OF_CONDUCT.md

@@ -74,3 +74,10 @@ available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.ht
 
 For answers to common questions about this code of conduct, see
 https://www.contributor-covenant.org/faq
+
+## The Main Thing
+
+Do not be dicks. If you or people you happen to like are dicks, they will have to go
+be dickish elsewhere, and in exrtreme cases you’ll be reported to the FBI or perhaps
+shot at dawn through the lungs, to prevent you from being such dickhead morons.
+OK? OK.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-clu
-Version: 0.12.9
+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
@@ -24,7 +24,6 @@ Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Utilities
 Classifier: Operating System :: MacOS
-Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: OS Independent
 Classifier: Operating System :: POSIX
 Classifier: Operating System :: Unix

python_clu-0.12.12/clu/__version__.py

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

{python_clu-0.12.9 → 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.9 → python_clu-0.12.12}/clu/naming.py

@@ -32,7 +32,7 @@ def determine_module(thing, name=None):
     import pickle
     return pickle.whichmodule(thing, name) # type: ignore
 
-"""
+__doc__ = """
 NAME AND MODULE SEARCH FUNCTIONS: the “nameof(…)” and “moduleof(…)”
 functions each search through, in order:
   
@@ -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
 
@@ -267,7 +267,18 @@ def qualified_name_tuple(thing):
     """ Get the thing-name and module/package name for a class or module.
         e.g. ('FloydSteinberg', 'instakit.processors.halftone')
     """
-    from clu.predicates import pyqualname
+    from clu.predicates import pyqualname, pyname
+    from clu.typology import ismodule
+    
+    # Special case for figuring out module names:
+    if ismodule(thing):
+        putative = pyname(thing)
+        if QUALIFIER in putative:
+            partition = putative.rpartition(QUALIFIER)
+            return partition[-1:][0], partition[:-1][0]
+        else:
+            return putative, ''
+    
     return pyqualname(thing) or nameof(thing), \
                               moduleof(thing)
 

{python_clu-0.12.9 → 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.9 → python_clu-0.12.12}/clu/scripts/repl.py

@@ -76,16 +76,13 @@ GLOBALS = globals()
 starmods = ('clu.repl.ansi',
             'clu.repl.columnize',
             'clu.repl.modules',
-            'clu.constants.enums',
-            'clu.constants.data',
-            'clu.application',
             'clu.config.abc',
             'clu.config.env',
             'clu.config.keymap',
             'clu.config.proxy',
-            'clu.dicts', 'clu.enums', 'clu.exporting',
+            'clu.dicts', 'clu.exporting',
             'clu.importing', 'clu.naming', 'clu.predicates', 'clu.typology',
-            'clu.fs.abc', 'clu.fs.filesystem', 'clu.fs.misc', 'clu.repr',
+            'clu.fs.filesystem', 'clu.fs.misc',
             'clu.scripts.treeline',
             'clu.typespace.namespace',
             'clu.testing.utils')
@@ -94,15 +91,20 @@ mods = ('clu',
         'clu.all',
         'clu.abstract',
         'clu.constants.consts',
+        'clu.constants.data',
+        'clu.constants.enums',
         'clu.constants.polyfills',
         'clu.config.codecs',
         'clu.config.ns',
         'clu.csv',
+        'clu.enums',
+        'clu.fs.abc',
         'clu.fs.appdirectories',
         'clu.keyvalue',
         'clu.mathematics',
         'clu.dispatch', 'clu.sanitizer', 'clu.fs.pypath',
         'clu.extending', 'clu.shelving.redat',
+        'clu.repr',
         'clu.scripts.ansicolors',
         'clu.scripts.treeline',
         'clu.stdio',
@@ -113,7 +115,7 @@ mods = ('clu',
         'datetime', 'functools', 'importlib', 'inspect',
         'itertools', 'math', 'operator', 'pathlib',
         'pickle', 'six', 'shutil', 'sysconfig', 'weakref',
-        'numpy', 'more_itertools', 'colorama',
+        'numpy', 'colorama',
         'xerox', 'zict')
 
 # “Star-import” all starmods – this is equivalent to doing:

{python_clu-0.12.9 → 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.9 → 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.9
+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
@@ -24,7 +24,6 @@ Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Utilities
 Classifier: Operating System :: MacOS
-Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: OS Independent
 Classifier: Operating System :: POSIX
 Classifier: Operating System :: Unix

{python_clu-0.12.9 → python_clu-0.12.12}/requirements/dev.txt

@@ -11,7 +11,6 @@ coverage>=5.0.0
 curtsies>=0.3.1
 cython>=0.29.14
 gfm>=0.0.2
-greenlet>=0.4.0
 ipython>=7.10.0
 jedi>=0.16.0
 lmdb>=0.8.0

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

@@ -23,13 +23,12 @@
 #    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 
 #    SOFTWARE.
 #
-''' CLU - Common Lightweight Utilities, or Command-Line Utilities (your pick) '''
+''' CLU - Common Lightweight Utilities '''
 
 from __future__ import print_function
 from setuptools import setup, find_packages
 
-import os
-import sys
+import sys, os, io
 import sysconfig
 
 # CONSTANTS
@@ -40,11 +39,9 @@ AUTHOR_USER = 'fish2000'
 GITHUB = 'github.com'
 GMAIL = 'gmail.com'
 
-AUTHOR_EMAIL = '%s@%s' % (AUTHOR_USER, GMAIL)
-PROJECT_GH_URL = 'https://%s/%s/%s' % (GITHUB,
-                                       AUTHOR_USER,
-                                       PROJECT_NAME)
-PROJECT_DL_URL = '%s/zipball/master' % PROJECT_GH_URL
+AUTHOR_EMAIL = f'{AUTHOR_USER}@{GMAIL}'
+PROJECT_GH_URL = f'https://{GITHUB}/{AUTHOR_USER}/{PROJECT_NAME}'
+PROJECT_DL_URL = f'{PROJECT_GH_URL}/zipball/master'
 
 KEYWORDS = ('command',
             'utilities', PROJECT_NAME,
@@ -69,15 +66,14 @@ ENTRY_POINTS = {
 }
 
 def project_content(*filenames):
-    import io
     filepath = os.path.join(CWD, *filenames)
     if not os.path.isfile(filepath):
-        raise IOError("""File %s doesn't exist""" % filepath)
+        raise IOError(f"File {filepath} doesn't exist")
     out = ''
     with io.open(filepath, 'r') as handle:
         out += handle.read()
     if not out:
-        raise ValueError("""File %s couldn't be read""" % os.path.sep.join(filenames))
+        raise ValueError(f"File {filepath} couldn't be read")
     return out.strip()
 
 # PROJECT VERSION & METADATA
@@ -88,7 +84,7 @@ try:
             '__version__.py')).read(),
             '__version__.py', 'exec'))
 except:
-    __version__ = '0.12.9'
+    __version__ = '0.12.12'
 
 # PROJECT DESCRIPTION
 LONG_DESCRIPTION = project_content('ABOUT.md')

python_clu-0.12.9/clu/__version__.py

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