python-clu 0.12.5__tar.gz → 0.12.8__tar.gz

{python_clu-0.12.5 → python_clu-0.12.8}/.bumpversion.toml

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

{python_clu-0.12.5 → python_clu-0.12.8}/CHANGELOG.md

@@ -1,7 +1,62 @@
 # Changelog
 
 
-## 0.12.4:pre12+g6e128ac [SNAPSHOT]
+## 0.12.7:pre5+gf7f3ce2 [SNAPSHOT]
+
+### Other
+
+* Fixes in `clu.naming.{qualified_import,main_module_mame}(…)` [Alexander Böhn]
+
+  … “main_module_name(…)” was failing when called within bpython; now,
+    it’s cool
+  … “qualified_import(…)” calls itself recursively when an exception
+    is raised during an internal import call – this should mean its
+    own error-handling should keep runtime import errors from reaching
+    a user when it’s being called correctly (!)
+
+* Very slight, and likely premature, optimization. [Alexander Böhn]
+
+* Dead code cleanup. [Alexander Böhn]
+
+* Don’t want to leave that test-ish line in there. [Alexander Böhn]
+
+* A wee bit of error-handling in “clu-ansidocs” [Alexander Böhn]
+
+
+## v0.12.7 (2025-05-19)
+
+### Other
+
+* Bumped version: 0.12.6 → 0.12.7. [Alexander Böhn]
+
+* [make] New changelog added. [Alexander Böhn]
+
+
+## v0.12.6 (2025-05-19)
+
+### Other
+
+* Bumped version: 0.12.5 → 0.12.6. [Alexander Böhn]
+
+* [make] New changelog added. [Alexander Böhn]
+
+* The ANSI docstring CLU command seems to be up to snuff. [Alexander Böhn]
+
+* Further along the prettyprinting path. [Alexander Böhn]
+
+* Started on a new CLU command to prettyprint ANSI docstrings. [Alexander Böhn]
+
+  … please bear with as we travel on this journey together
+
+* Gratuitously expanded the docstring for `negate(…)` in `clu.predicates` [Alexander Böhn]
+
+  … comparing the function to a child with oppositional-defiant disorder.
+    It makes a lot of sense, no?
+
+* Spruced up the ANSI inline tests. [Alexander Böhn]
+
+
+## v0.12.5 (2025-05-19)
 
 ### Add
 
@@ -9,6 +64,10 @@
 
 ### Other
 
+* Bumped version: 0.12.4 → 0.12.5. [Alexander Böhn]
+
+* [make] New changelog added. [Alexander Böhn]
+
 * Starting to remove the legacy parts of `clu.config` [Alexander Böhn]
 
   … fucking finally. These bits were an early draft of what became

{python_clu-0.12.5 → python_clu-0.12.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-clu
-Version: 0.12.5
+Version: 0.12.8
 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.8/clu/__version__.py

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

{python_clu-0.12.5 → python_clu-0.12.8}/clu/naming.py

@@ -76,10 +76,20 @@ indication that you need to change something, dogg.
 
 @export
 def main_module_name(basepath=None):
+    """ Get the name of the current __main__ module (which may
+        very well just be “__main__”), but still.
+    """
     import __main__
-    if basepath is None:
+    from clu.predicates import attr
+    
+    # Default:
+    if not basepath:
         basepath = BASEPATH
-    return path_to_dotpath(__main__.__file__,
+    
+    # In some REPLs “__main__.__file__” is not set:
+    attribute_name = attr(__main__, '__file__',
+                                    '__spec__.name')
+    return path_to_dotpath(attribute_name,
                            relative_to=basepath)
 
 @export
@@ -234,7 +244,7 @@ def qualified_import(qualified):
         imported = importlib.import_module(qualified)
     except ModuleNotFoundError:
         head, tail = dotpath_split(qualified)
-        module = importlib.import_module(tail)
+        module = qualified_import(tail)
         imported = getattr(module, head)
     return imported
 

{python_clu-0.12.5 → python_clu-0.12.8}/clu/predicates.py

@@ -40,6 +40,12 @@ False
 >>> uncallable = lambda thing: negate(callable)(thing) # see below!
 >>> os.path.differentfile = negate(os.path.samefile) # I’ll admit to having done this
 >>> misfnmatch = negate(shutil.fnmatch.fnmatch) # There are times when this makes sense
+
+### … Basically, `negate(…)` is like oppositional-defiant disorder for functions. Like,
+###   if your mom asks you “Do you want dinner?” she is passing you a lambda function for
+###   you to evaluate, returning True or False accordingly. But the ODD child of course
+###   does not simply return True or False – the ODD child will `negate(…)` their moms’
+###   lambda and pass it back to her. Totally.
 """
 
 # PREDICATE FUNCTIONS: boolean predicates for class types

{python_clu-0.12.5 → python_clu-0.12.8}/clu/repl/ansi.py

@@ -776,27 +776,31 @@ def test():
     from itertools import product
     
     @inline
-    def test_one():
+    def test_print_ansi():
+        """ No-nonsense check of “print_ansi(…)” """
         print_ansi('yo dogg')
         print_ansi_centered('I heard you like non-ANSI-formatted text')
     
     @inline
-    def test_one_point_five():
+    def test_legacy_ansidoc():
+        """ Try the legacy ANSIDoc functions """
         old_ansidoc(Exporter)
         old_ansidoc(product)
     
     @inline
-    def test_two():
+    def test_ansidoc():
+        """ Test the current (class-based) ANSIDoc function """
         ansidoc(Exporter)
         ansidoc(product)
     
     @inline
     def test_three():
+        """ Manual test of the DocFormat class """
         fmt = DocFormat()
         fmt(Exporter)
         fmt(product)
     
-    return inline.test()
+    return inline.test(10)
 
 if __name__ == '__main__':
     sys.exit(test())

python_clu-0.12.8/clu/repl/cli/ansidocs.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+from __future__ import print_function
+
+import os
+import sys
+import shlex
+
+from clu.repl.ansi import DocFormat
+ansidocs = DocFormat()
+
+def actually_print_ansidocs(dotpath):
+    """ This function prints the ANSI docs directly to standard output,
+        formatting accordingly (as in, no ANSI if we can’t ANSI)
+    """
+    from clu.naming import qualified_import
+    from importlib import import_module
+    
+    # Attempt to import it:
+    try:
+        thing = qualified_import(dotpath)
+    except ValueError:
+        thing = import_module(dotpath)
+    except AttributeError as error:
+        error_string = str(error)
+        print(f"[ERROR] {error_string}", file=ansidocs.iohandle)
+        sys.exit(os.EX_CONFIG)
+    
+    # This goes directly to stdout:
+    ansidocs(thing)
+
+def ansidocs_command():
+    """ Print out the ANSI-ified docstring for the given thing(s) """
+    from clu.constants import consts
+    
+    command = " ".join(sys.argv)
+    executable, *dotpaths = shlex.split(command)
+    
+    # If we’re debuggin’ lets’s talk about what we got:
+    if consts.DEBUG:
+        alldotpaths = " ".join(dotpaths)
+        print(f"EXECUTABLE: {executable}")
+        print(f"DOTPATHS: {alldotpaths}")
+        print()
+    
+    # The actual dirty work
+    for dotpath in dotpaths:
+        actually_print_ansidocs(dotpath)
+    
+    # Return nice-nice for my POSI(X)ES:
+    return os.EX_OK
+
+if __name__ == '__main__':
+    sys.exit(ansidocs_command())

{python_clu-0.12.5 → python_clu-0.12.8}/clu/repl/cli/print_version.py

@@ -46,5 +46,4 @@ def print_version_command():
     return os.EX_OK
 
 if __name__ == '__main__':
-    # sys.argv += ['--version-only']
     sys.exit(print_version_command())

{python_clu-0.12.5 → python_clu-0.12.8}/pyproject.toml

@@ -22,6 +22,7 @@ email = "fish2000@gmail.com"
 
 [project.scripts]
 clu-version = 'clu.repl.cli.print_version:print_version_command'
+clu-ansidocs = 'clu.repl.cli.ansidocs:ansidocs_command'
 clu-boilerplate = 'clu.repl.cli.boilerplate:boilerplate_command'
 clu-boilercopy = 'clu.repl.cli.boilerplate:boilerplate_copy_command'
 

{python_clu-0.12.5 → python_clu-0.12.8}/python_clu.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-clu
-Version: 0.12.5
+Version: 0.12.8
 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.5 → python_clu-0.12.8}/python_clu.egg-info/SOURCES.txt

@@ -91,6 +91,7 @@ clu/repl/banners.py
 clu/repl/columnize.py
 clu/repl/modules.py
 clu/repl/cli/__init__.py
+clu/repl/cli/ansidocs.py
 clu/repl/cli/boilerplate.py
 clu/repl/cli/boilerplate_copy.py
 clu/repl/cli/print_version.py

{python_clu-0.12.5 → python_clu-0.12.8}/python_clu.egg-info/entry_points.txt

@@ -1,4 +1,5 @@
 [console_scripts]
+clu-ansidocs = clu.repl.cli.ansidocs:ansidocs_command
 clu-boilercopy = clu.repl.cli.boilerplate:boilerplate_copy_command
 clu-boilerplate = clu.repl.cli.boilerplate:boilerplate_command
 clu-version = clu.repl.cli.print_version:print_version_command

{python_clu-0.12.5 → python_clu-0.12.8}/setup.py

@@ -62,6 +62,7 @@ BASE_PATH = os.path.join(
 # ENTRY POINTS
 ENTRY_POINTS = {
     'console_scripts'  : [    'clu-version = clu.repl.cli.print_version:print_version_command',
+                             'clu-ansidocs = clu.repl.cli.ansidocs:ansidocs_command',
                           'clu-boilerplate = clu.repl.cli.boilerplate:boilerplate_command',
                            'clu-boilercopy = clu.repl.cli.boilerplate:boilerplate_copy_command'],
     'pytest11'         : [    'clu-testing = clu.testing.pytest']
@@ -87,7 +88,7 @@ try:
             '__version__.py')).read(),
             '__version__.py', 'exec'))
 except:
-    __version__ = '0.12.5'
+    __version__ = '0.12.8'
 
 # PROJECT DESCRIPTION
 LONG_DESCRIPTION = project_content('ABOUT.md')

python_clu-0.12.5/clu/__version__.py

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