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

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

@@ -1,6 +1,6 @@
 
 [tool.bumpversion]
-current_version = "0.12.5"
+current_version = "0.12.7"
 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.7}/CHANGELOG.md

@@ -1,7 +1,31 @@
 # Changelog
 
 
-## 0.12.4:pre12+g6e128ac [SNAPSHOT]
+## 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 +33,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.7}/PKG-INFO

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

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

{python_clu-0.12.5 → python_clu-0.12.7}/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.7}/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.7/clu/repl/cli/ansidocs.py

@@ -0,0 +1,49 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+from __future__ import print_function
+
+import os
+import sys
+import shlex
+
+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 clu.repl.ansi import DocFormat
+    from importlib import import_module
+    
+    # Attempt to import it:
+    try:
+        thing = qualified_import(dotpath)
+    except ValueError:
+        thing = import_module(dotpath)
+    
+    ansidocs = DocFormat()
+    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}")
+    
+    # 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.argv.append('clu.exporting.Exporter')
+    # sys.argv.append('clu.repl.ansi.Text')
+    sys.exit(ansidocs_command())

{python_clu-0.12.5 → python_clu-0.12.7}/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.7}/python_clu.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-clu
-Version: 0.12.5
+Version: 0.12.7
 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.7}/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.7}/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.7}/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.7'
 
 # PROJECT DESCRIPTION
 LONG_DESCRIPTION = project_content('ABOUT.md')

python_clu-0.12.5/clu/__version__.py

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