python-clu 0.12.2__py3-none-any.whl → 0.12.4__py3-none-any.whl

clu/__version__.py

@@ -1 +1 @@
-__version__ = '0.12.2'
+__version__ = '0.12.4'

clu/repl/cli/print_version.py

@@ -15,7 +15,7 @@ def version_string():
     semantic = f"{version.major}.{version.minor}.{version.patch}"
     
     if version.pre:
-        semantic += f"-{version.pre}"
+        semantic += f":pre{version.pre}"
         if version.build:
             semantic += f"+{version.build}"
         semantic += " [SNAPSHOT]"
@@ -29,13 +29,22 @@ def print_version_command():
         in ancilliary human-readable copyright information
     """
     semantic = version_string()
-    copyright = f"CLU version {semantic} © 2010-2032 Alexander Böhn"
+    flags = ('--version-only', '-V')
+    
+    # check if we just want the version number:
+    for flag in flags:
+        if flag in sys.argv:
+            # Just print the number and return OK:
+            print(semantic)
+            return os.EX_OK
     
-    # print it:
+    # print the whole schpiel:
+    copyright = f"CLU version {semantic} © 2010-2032 Alexander Böhn"
     print(copyright)
     
     # Return nice-nice for my POSI(X)ES:
     return os.EX_OK
 
 if __name__ == '__main__':
+    # sys.argv += ['--version-only']
     sys.exit(print_version_command())

clu/scripts/repl.py

@@ -83,9 +83,10 @@ starmods = ('clu.repl.ansi',
             'clu.config.env',
             'clu.config.keymap',
             'clu.config.proxy',
-            'clu.dicts', 'clu.enums', 'clu.exporting', 'clu.extending', 'clu.shelving.redat',
-            'clu.importing', 'clu.mathematics', 'clu.naming', 'clu.predicates', 'clu.typology',
-            'clu.fs.abc', 'clu.fs.filesystem', 'clu.fs.misc', 'clu.repr', 'clu.scripts.treeline', 'clu.stdio',
+            'clu.dicts', 'clu.enums', 'clu.exporting',
+            'clu.importing', 'clu.naming', 'clu.predicates', 'clu.typology',
+            'clu.fs.abc', 'clu.fs.filesystem', 'clu.fs.misc', 'clu.repr',
+            'clu.scripts.treeline',
             'clu.typespace.namespace',
             'clu.testing.utils')
 
@@ -101,9 +102,12 @@ mods = ('clu',
         'clu.csv',
         'clu.fs.appdirectories',
         'clu.keyvalue',
+        'clu.mathematics',
         'clu.dispatch', 'clu.sanitizer', 'clu.fs.pypath',
+        'clu.extending', 'clu.shelving.redat',
         'clu.scripts.ansicolors',
         'clu.scripts.treeline',
+        'clu.stdio',
         'clu.typespace.types', # not technically a module!
         'clu.version', 'clu.version.git_version',
         'sys', 'os', 'io', 're', 'abc',
@@ -111,9 +115,8 @@ mods = ('clu',
         'datetime', 'functools', 'importlib', 'inspect',
         'itertools', 'math', 'operator', 'pathlib',
         'pickle', 'six', 'shutil', 'sysconfig', 'weakref',
-        'numpy', 'more_itertools', 'colorama', 'termcolor',
-        'xerox', 'zict', 'pytz', 'dateutil',
-        'termplotlib', 'termtables')
+        'numpy', 'more_itertools', 'colorama',
+        'xerox', 'zict')
 
 # “Star-import” all starmods – this is equivalent to doing:
 # 
@@ -219,6 +222,8 @@ if 'user:script' in cluenv:
 
 # Adjust __all__ again:
 __all__ += ['_explain', 'explain', 'cluenv']
+# __all__ = tuple(__all__)
+__dir__ = lambda: __all__
 
 # Remove duplicate and invalid sys.paths:
 pypath.remove_invalid_paths()

python_clu-0.12.4.dist-info/METADATA

@@ -0,0 +1,516 @@
+Metadata-Version: 2.4
+Name: python-clu
+Version: 0.12.4
+Summary: Python-CLU: Common Lightweight Utilities
+Home-page: https://github.com/fish2000/clu
+Download-URL: https://github.com/fish2000/clu/zipball/master
+Author: Alexander Böhn
+Author-email: Alexander Böhn <fish2000@gmail.com>
+Project-URL: homepage, https://github.com/fish2000/CLU
+Project-URL: repository, https://github.com/fish2000/CLU
+Project-URL: documentation, https://github.com/fish2000/CLU/blob/master/README.md
+Project-URL: source, https://github.com/fish2000/CLU
+Project-URL: tracker, https://github.com/fish2000/CLU/issues
+Project-URL: changelog, https://github.com/fish2000/CLU/blob/master/CHANGELOG.md
+Project-URL: download, https://pypi.org/project/python-clu/
+Keywords: testing,command,command-line,utilities,modules,REPL,tools
+Platform: any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+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
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: build
+Requires-Dist: Click>=7.0
+Requires-Dist: colorama>=0.4.0
+Requires-Dist: dataclasses>=0.6; python_version < "3.7"
+Requires-Dist: dbx-stopwatch>=1.6
+Requires-Dist: enum34>=1.1.0; python_version < "3.4"
+Requires-Dist: humanize>=1.0.0
+Requires-Dist: importlib-metadata>=1.4.0; python_version < "3.8"
+Requires-Dist: mock>=4.0.0
+Requires-Dist: more_itertools>=8.0.0
+Requires-Dist: multidict>=4.7.0
+Requires-Dist: packaging
+Requires-Dist: pout>=0.8.13
+Requires-Dist: pygments>=2.0.0
+Requires-Dist: PyYAML>=5.3.0
+Requires-Dist: redis>=3.4.0
+Requires-Dist: setuptools>=30.0.0
+Requires-Dist: six>=1.10.0
+Requires-Dist: toml>=0.10.0
+Requires-Dist: wheel>=0.34.0
+Requires-Dist: zict>=0.1.2
+Provides-Extra: all
+Requires-Dist: more_itertools>=8.0.0; extra == "all"
+Requires-Dist: numpy>=1.17.0; extra == "all"
+Requires-Dist: Pillow>=7.1.0; extra == "all"
+Requires-Dist: pytest>=5.4.0; extra == "all"
+Requires-Dist: zipp>=2.0.0; extra == "all"
+Dynamic: author
+Dynamic: download-url
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: platform
+
+[Python-CLU][clu] – Common Lightweight Utilities
+========================================================
+
+[![codecov](https://codecov.io/gh/fish2000/CLU/branch/master/graph/badge.svg)](https://codecov.io/gh/fish2000/CLU/)
+
+Install it right now! [Download][download-link] or type: `$ pip install -U python-clu`
+------------------------------------------------------------------------------
+
+The deal with CLU is, it is a bunch of stuff. Like, a junk drawer… but a junk drawer
+full of building sets: [Legos][lego-link], [Robotix][robotix-link], [Capsela][capsela-link]
+– and also magic interfaces that let somehow you plug Legos into Capselas and all
+that. It’s a la carte: you can use one part of CLU (say the [inline testing stuff][clu.testing.utils])
+and ignore the rest. Or just the [`exporter`][clu.exporting], or just the [`predicates`][clu.predicates]
+collection. Naturally, these things taste great and also taste great together, too.
+
+[![Construx and Capsela](scratch/images/construx-and-capsela-small.jpg)](https://www.reddit.com/r/Xennials/comments/1aixaq7/construx_and_capsela_anyone_else_have_any/)
+
+CLU started out as a packaged-up and sanely written version of
+[the Python tools I wrote for my REPLs][homage-replutilities-link], divided up into
+a bunch of subordinate packages. It’s grown magnificently since then (if I do say so myself).
+And if you are wondering if “CLU” is a Tron reference, [you are correct][clu-tron-link].
+“CLU” stands for “Common Lightweight Utilities” – it started out as an acronym for
+“Command-Line Utilities” but it has grown useful beyond that scope, indeed.
+
+The subordinate packages are pretty well-divided: [`clu.config`][clu.config] contains
+things to help with configuration, like [config-file loading and saving][clu.config.filebase],
+and data structures like [our famous namespaced keymaps][clu.config.keymap].
+[`clu.exporting`][clu.exporting] has the `@export` decorator, a utility to easily label module
+members for export by adding them to a modules’ `__all__` and `__dir__` members,
+plus other stuff like real-name determination. Which, speaking of which, [`clu.naming`][clu.naming]
+has additional easy functions for dealing with the names of your things and other peoples’,
+and [`clu.repr`][clu.repr] has stuff for easily printing, getting, and specifying an objects’
+string representation.
+
+You’ll like [`clu.abstract`][clu.abstract] if you like building class towers – we have ABCs
+for all types of things. If you like [`dict`s][dicts], check out the aforementioned [`clu.config.keymap`][clu.config.keymap]
+and [`clu.dicts`][clu.dicts] modules – you’ll find things to build dictionary types, represent
+them, and deal with them later. [`clu.dispatch`][clu.dispatch] will help you manage
+subprocesses easily, [`clu.version`][clu.version] is better then [`semver`][semver-link]
+(I promise), [`clu.testing`][clu.testing] is great for inlining some quick unit tests, and
+[`clu.scripts`][clu.scripts] and [`clu.repl`][clu.repl] are what you want for whatever your
+REPL environment may be… [`bpython`][bpython-link], [`ipython`][ipython-link],
+[`ptpython`][ptpython-link], and many others I am sure!
+
+So do have a look around. Here’s an abridged breakdown of some things within:
+
+* [`config`][clu.config]: Tons of useful things for dealing with your app’s configuration. These are centered
+    around lexically namespaced dictionaries called “KeyMaps”, which basic examples of which can be
+    found in [`clu.config.keymap`][clu.config.keymap]. If your nested data looks like:
+
+        data = {
+            'yo' : {
+                'dogg' : {
+                    'i-heard' : {
+                        'you-like' : "nested data"
+                    }
+                }
+            }
+        }
+    
+    … and you assign it to a keymap, like e.g. `keyed = keymap.Nested(data).flatten()`, then you can
+    use `keyed` like so:
+    
+        assert keyed["yo:dogg:i-heard:you-like"] == "nested data"
+    
+    … The `Flat` and `Nested` classes are cheap to construct and lightweight, and generally act like most
+    [`dict`][dicts] instances in most of the expected ways. There is also an environment-variable [`keymap`][clu.config.keymap]
+    adapter in [`clu.config.env`][clu.config.env], which if your app uses environment variables that look like like
+    `MYAPP_CONFIG_THINGY`, they can be accessed through `env.FrozenEnviron(appname='myapp')` or
+    `env.Environ(appname='myapp')` like so:
+    
+        appenv = Environ(appname='myapp')
+        assert appenv['config:thingy'] == "some value"
+        appenv['config:doohickey'] = "a different value" # sets MYAPP_CONFIG_DOOHICKEY
+                                                         # in the current env
+    
+    … and there are plenty of tools for rolling your own `KeyMap`s in [`clu.config`][clu.config]: the
+    [`proxy`][clu.config.proxy] subpackage has a `KeyMap` proxy class, [`ns`][clu.config.ns] has utility functions
+    for manipulating namespace strings, [`keymapview`][clu.config.keymapview] has a class tower for
+    [`KeyMap`][clu.config.keymap] key/value/item views, and [`abc`][clu.config.abc] has, as you’d expect, all
+    the abstract base classes upon which our [`KeyMap`s][clu.config.keymap] are built, for your perusal and
+    eventual enjoyment.
+
+* [`constants`][clu.constants]: Definitions of [useful constants][clu.constants.consts], as well as
+    [polyfills][clu.constants.polyfills] to allow certain dependencies from the Python standard library to work even
+    when some of their moving parts are missing (i.e. Ye Olde Pythone 2.7, various PyPy implementations, etc).
+
+* [`fs`][clu.fs]: Filesystem-related things. Submodules include:
+    
+    * [`fs.filesystem`][clu.fs.filesystem]: classes representing filesystem primitives like `Directory`,
+        `TemporaryDirectory`, `TemporaryName`; a version of [`tempfile.NamedTemporaryFile`][tempfile.NamedTemporaryFile]
+        that works with or without the leading dot in the provided suffix (a peeve of mine); functions
+        for common filesystem operations like `which(…)`,  `back_ticks(…)`, `rm_rf(…)` (be careful
+        with that one), and so forth. 
+        
+        * The `Directory` class is particularly extensive, with methods for [Zipfile][zipfile] archiving, searching
+            for importable Python files and others, file-suffix histograms, context-managed working-directory
+            management, walking and reverse-walking, and much more.
+    
+    * [`fs.appdirectories`][clu.fs.appdirectories]: Started out as a pretty much wholesale duplication of the popular
+        [`appdirs`][appdirs-link] package[<sup>†</sup>](#dagger) – but it’s been kitted out with many CLUish things, e.g.
+        [`clu.fs.filesystem.Directory`][clu.fs.filesystem] instances. A solid upgrade in my opinion!
+    
+    * [`fs.misc`][clu.fs.misc]: a bunch of useful miscellany – noteworthy standouts include regex utility functions for
+        constructing filename regex match or exclusion tests.
+    
+    * [`fs.pypath`][clu.fs.pypath]: functions for safe manipulation of [`sys.path`][sys.path] – `enhance(…)`,
+    `remove_paths(…)`, `remove_invalid_paths()`, &c.
+    
+* [`importing`][clu.importing]: a whole class-based-module system! Basically you can do this:
+
+        class Derived(clu.importing.base.Module):
+        
+            """ I heard you like docstrings """
+        
+            yo = 'dogg'
+        
+            @export
+            def yodogg(self):
+                return "I heard you like"
+        
+            @export
+            def nodogg(self):
+                return None
+        
+            export(yo, name='yo')
+        
+        from clu.app import Derived as derived # TAKE NOTE!!!
+        
+        assert isinstance(derived, Module)
+        assert derived.yo == 'dogg'
+        assert derived.yodogg() == "I heard you like"
+        assert derived.nodogg() is None
+
+    … see that? just by subclassing [`clu.importing.base.Module`][clu.importing.base] you can create something
+    instantly importable. Awesome, wouldn’t you say? I would say. We’re working out the best way to create the
+    base `Module` for your own project (the machinery is there but the semantics are not yet perfect) but do feel
+    free to play around with the stuff in [`clu.importing.base`][clu.importing.base], and have a look at the
+    implementation in [`clu.importing.proxy`][clu.importing.proxy] of the “parameterized” `ProxyModule` (there’s a
+    `ChainModuleMap` container available in the [`proxy`][clu.importing.proxy] submodule, too).
+
+* [`repl`][clu.repl] and [`scripts`][clu.scripts]: Tools useful in Python REPL environments. In [`clu.repl`][clu.repl],
+    there’s a while module full of ANSI printing and formatting utilities, many of them as classes, a [`columnize`][clu.repl.columnize]
+    function for, uh, printing things in columns[<sup>†</sup>](#dagger), and a [`modules`][clu.repl.modules] submodule
+    focused on printing things about your project’s modules and submodules.
+    
+    [`clu.scripts`][clu.scripts] contains a [“repl.py”][clu.scripts.repl] file, which is meant to be loaded into an interactive interpreter like e.g.:
+    
+        $ bpython -i «PATH_TO_CLU»/clu/scripts/repl.py
+    
+    … which will set all of CLU up for you to use interactively. N.B. if you have your own script you want to include
+    but stil want to use CLU, you can set the `CLU_USER_SCRIPT` environment variable to the path to your own script,
+    and our “repl.py” script will pick it up. 
+    
+    [`clu.scripts`][clu.scripts] also contains [`treeline`][clu.scripts.treeline] and [`dictroast`][clu.scripts.dictroast], which
+    are CLU’s nascent command-line parsing utilities. They make use of the CLU `KeyMap` idiom (q.v. note _supra_)
+    and are being worked on right this very µsecond!
+
+* [`typespace`][clu.typespace]: Contains a submodule `typespace.namespace` defining `SimpleNamespace` (á la Python 3’s
+    [`types.SimpleNamespace`][types.SimpleNamespace]) and a slightly more useful `Namespace` ancestor class;
+    these are used to furnish a `typespace.types` namespace that contains everything in  the standard-library
+    [`types`][types] module, but with all the typenames shortened so they no longer gratuitously end in “Type”. Like e.g.
+    [`types.ModuleType`][types.ModuleType] is to be found in `typespace.types.Module`, [`types.FunctionType`][types.FunctionType]
+    is `typespace.types.Function`, et cetera, ad nauseum, so you can just do `from clu.typespace import types`
+    to lose the redundant “Type” naming suffix – which I don’t know about you but that annoys me, I mean we all know
+    that these things are types because they are in the fucking [`types`][types] module and don’t need those overly verbose extra four characters
+    there at the end. ALSO, there are additional useful types, from Python’s standard library and common packages,
+    in the [`types` namespace][clu.typespace.namespace]. YOU’RE WELCOME!!
+
+* [`dicts`][clu.dicts]: Functions and classes for wrangling [`dict`s][dicts] (and actually [`Mapping`][collections.abc.Mapping]
+    and [`MutableMapping`][collections.abc.MutableMapping] descendants in general). There are ABCs for
+    key/value/item views for your own mappings, a much better `ChainMap`, written from scratch and improving
+    on [`collections.ChainMap`][collections.ChainMap], plus a `ChainRepr` based on [`reprlib.Repr`][reprlib.Repr],
+    and a whole bunch of fast dict-merging functions.
+
+* [`exporting`][clu.exporting]: This is kind of the heart of CLU. At the beginning of all internal CLU modules, you’ll find something
+    using the `Exporter`, like this:
+    
+        from clu.exporting import Exporter
+        
+        exporter = Exporter(path=__file__)
+        export = exporter.decorator()
+    
+    … which I know, I know, the use of `__file__` there is kind of irritating. But that `exporter` instance is now
+    registered with CLU, and whenever there’s a class or function you want made available outside the module,
+    you can specify it like:
+    
+        @export
+        def public_function():
+            print("I’m so public")
+            
+        class PrivateAncestor:
+            """ I’m more private, don’t play with me """
+            
+        @export
+        class PublicThing(PrivateAncestor):
+            """ I’m very public, indeed, and available """
+    
+    At the end of the module (but before your CLU tests, q.v. note _sub_.) you put:
+    
+        __all__, __dir__ = exporter.all_and_dir()
+    
+    … which makes things clear what is public and what is private to consumers of your code, without messing
+    around with underscore prefixes, which I find coarse, and vulgar. You’re not just labeling things for export,
+    though: [`clu.exporting`][clu.exporting] has tons of machinery for finding out the **“true name”** of a thing,
+    be it a class (easy), a function (trickier but still easy), an instance (trickier still), and a module variable (totally
+    very tricky indeed).
+    
+    For your own project, at some part in your code, all you have to do is: `from clu.exporting import ExporterBase`,
+    and then subclass `ExporterBase` with your app’s name and base path. Like so:
+    
+        class Exporter(ExporterBase, basepath="/your/project", appname="MyProject"):
+            pass
+    
+    … then import your own importer (or call it whatever you want) at the top of your own CLUish modules and
+    instantiate per the example _supra_. See also [`clu.scripts.dictroast`][clu.scripts.dictroast] for other tricks your
+    `Exporter` instances can perform. 
+
+* [`testing`][clu.testing]: a handy inline unit-test writing setup. It works fine with [`coverage`][coverage-link] and
+    [`pytest`][pytest-link] – all you have to do is, after your line assigning `__all__` and `__dir__` at the end
+    of the module proper, something like:
+    
+        def test():
+            from clu.testing.utils import inline
+        
+            @inline.precheck
+            def before_everything_else():
+        	    """ This function runs once before testing """
+                # ...
+                
+            @inline
+            def first_test():
+                """ This test does one thing """
+                # ...
+                
+            @inline
+            def second_test():
+        	    """ This test does another thing """
+                # ...
+                
+            @inline.runif(something == something_else)
+            def test_conditionally_run():
+        	    """ This test only does something if `something` == `something_else` """
+                # ...
+                
+            @inline.diagnostic
+            def apres_testing():
+        	    """ This function runs once after testing """
+                # ...
+                
+            return inline.test(100)
+        
+        if __name__ == '__main__':
+            sys.exit(test())
+
+    … running the module (with either `python -m yourapp.yourmodule` or, say, [Nox][nox-link]) will show
+    you each tests’ output. But see that `return inline.test(100)` line? That integer argument tells
+    the CLU testrunner how many times to run each test (we here like to go a hundred times). You’ll get a
+    report – each test function only prints its output on the first run, the other 99 in this case are muted –
+    that shows you the time totals, which will look like this:
+    
+    [![CLU testrunner time totals](scratch/images/clu-testing-time-totals-example-small.jpg)](https://github.com/fish2000/CLU/tree/master/scratch/images/clu-testing-time-totals-example.jpg)
+    
+    … which the astute will note is the output from a non-CLU module. [`clu.testing.utils`][clu.testing.utils]
+    is very easy to integrate, as it doesn’t require any other part of CLU. Look over [our noxfile][clu-noxfile] for
+    examples of how to run your inline tests as part of a larger suite.
+    
+    … there are other testing support tools in[ `clu.testing.utils`][clu.testing.utils], have a look. There’s
+    also a [`clu.testing.pytest`][clu.testing.pytest] submodule, with some currently-under-development
+    [`pytest`][pytest-link] plugins.
+
+* [`mathematics`][clu.mathematics]: the future home for math-related stuff. All there is right now is a `clamp(…)` function that works with
+    [`numpy`][numpy-link] [dtypes][numpy-dtype-link].
+
+* [`naming`][clu.naming]: functions for determining the names of things (even module constants and other random things
+    that generally lack things like `__name__` attributes) and for the importing and exporting of things by
+    “qualified names” – for instance, you can use `naming.qualified_import(…)` to import a class [`CurveSet`][instakit.processors.curves.CurveSet]
+    from its package [`instakit.processors.curves`][instakit.processors.curves] by doing:
+    
+        CurveSet = qualified_import('instakit.processors.curves.CurveSet')
+    
+    … which that may be handier for you than composing and hard-coding an `import` statement. See also the
+    `nameof(…)` and `moduleof(…)` functions, and the utility functions (e.g. `qualified_name(…)`) and
+    predicates (e.g. `isnative(…)`). Most of these functions take literally anything for their argument.
+
+* [`predicates`][clu.predicates]: If [`clu.exporting`][clu.exporting] is the heart, [`clu.predicates`][clu.predicates] is
+    all of the eyes, ears, fingers and toes of CLU.
+    
+    * Do you want to know if a class is a metaclass? We have an `ismetaclass(…)` predicate for it, for example.
+    * Do you want to get an attribute from something you have, but not sure which attributes this _something_
+    may have (due to versioning or being passed around, or whatever)? `attr(thing, 'one', 'two', default=None)`
+    will give you `thing.one` if that exists, `thing.two`, if `thing.one` doesn’t, and `None` if neither of them
+    are there.
+    * But… would you maybe like to get a tuple with all of the `one` attributes across multiple things?
+    `attr_across('one', *things)` will do exactly that.
+    * Similar to the above, `pyattr(…)` does like `attr(…)` except `one` will be expanded to `__one__`, and
+    `item(…)` searches over mapping keys rather than attribute names. 
+    
+    Sweet, right? These functions, and others in the [`predicates`][clu.predicates] module, are based on `accessor`,
+    `aquirer`, `searcher`, and `collator` – abstract functions that can themselves be used. In fact most of
+    [`clu.predicates`][clu.predicates] is written in the functional style – that is to say they are built successively
+    out of multiple `lambda` statements. If this is not your taste, everything there has been documented thoroughly
+    for your use and you shouldn’t have to program in this style. But… if you _do_ enjoy a spot of FP, the primitives
+    in the module perhaps will interest you more than the more utilitarian contents.
+
+* [`sanitizer`][clu.sanitizer]: functions for cleaning up unicode. Right now there is just a list-based `sanitize(…)`
+    function that tones down anything with high-value code points to the point where it can be safely `ascii`-ified. 
+
+* [`typology`][clu.typology]: This is like [`clu.predicates`][clu.predicates] but with more predicates, many of which are
+    based on typelists. The module is full of typelists and it uses them extensively in its predicates, via `isinstance(…)`,
+    `issubclass(…)` and a custom version of same called `subclasscheck(…)` which tries very hard to work with
+    what you give it (instead of just crapping out with a `False` return value). You will want to explore this one!
+
+* [`version`][clu.version]: This is basically my take on the [`semver`][semver-link] package, only with improvements.
+    I originally developed it for internal use in some of my Python projects, but it stands on its own. You can
+    construct [`clu.version.VersionInfo`][clu.version.VersionInfo] instances using [`semver`][semver-link]
+    primitives amongst other things. The (skeletal) [`git_version`][clu.version.git_version] subpackage has a
+    couple of [Git-related][git-link] functions, but what you really want is in [`read_version`][clu.version.read_version]
+    – therein you’ll find a `read_version_file(…)` function that uses the `ast` module to read one of those
+    `__version__.py` files I know you have lying around. Yes![<sup>†</sup>](#dagger)
+
+* [The `pytest` testsuite][clu-testsuite]: CLU has a full set of [`pytest`][pytest-link]-compatible unit tests.
+    In addition to copious module-specific [CLU inline tests][clu.testing], you can run this test suite using
+    [`pytest`][pytest-link] – or, if you’d like to run *all* the tests, use the fantastic [Nox][nox-link] testrunner
+    (which we use) along with [our included noxfile][clu-noxfile].
+
+… AND MORE!!! There really are a ton of useful things in here and one day I will list them (but not today). 
+    Have fun with it!! [Download][download-link] CLU today and explore – if you want a full list of everything CLU
+    exports, install it and list them all in your terminal:
+
+    $ pip install -U python-clu
+    $ python -m clu
+
+… which will give you a giant list that looks like this:
+
+[![CLU module list](scratch/images/clu-module-list-example-small.jpg)](https://pypi.org/project/python-clu/)
+
+<a name="dagger" style="text-decoration: none;">†</a> – the original code for some modules in CLU (e.g.
+    [`clu.fs.appdirectories`][clu.fs.appdirectories], [`clu.repl.columnize`][clu.repl.columnize],
+    [`clu.version.read_version`][clu.version.read_version]) was vendored in from third-party code.
+    This has all been appropriately licensed and credits are inlined where due. Thanks to all CLU
+    contributors, big and small!
+
+<!--- LINKS! LINKS! LINKS! -->
+[pypi-link]: https://pypi.org/project/python-clu/
+[download-link]: https://files.pythonhosted.org/packages/3e/af/4b0dfabe816cee7802cf6981f7f79770c4f05f8df4ac64fc6984789baaaa/python_clu-0.12.3.tar.gz
+[homage-replutilities-link]: https://github.com/fish2000/homage/blob/master/.script-bin/replutilities.py
+[clu-tron-link]: https://tron.fandom.com/wiki/Clu
+
+[appdirs-link]: https://github.com/ActiveState/appdirs
+[coverage-link]: https://coverage.readthedocs.io/en/latest/
+[git-link]: https://git-scm.com
+[numpy-link]: https://numpy.org
+[numpy-dtype-link]: https://numpy.org/doc/stable/user/basics.types.html
+[bpython-link]: https://bpython-interpreter.org
+[ipython-link]: https://ipython.org
+[ptpython-link]: https://github.com/prompt-toolkit/ptpython
+[semver-link]: https://pypi.org/project/semver/
+[pytest-link]: https://docs.pytest.org/en/stable/
+[nox-link]: https://nox.thea.codes/en/stable/
+[lego-link]: https://www.lego.com/
+[capsela-link]: https://hackaday.com/2017/09/15/retrotectactular-capsela-is-dead-long-live-capsela/
+[robotix-link]: https://en.wikipedia.org/wiki/Robotix
+
+[clu.config]: https://github.com/fish2000/CLU/tree/master/clu/config
+[clu.config.abc]: https://github.com/fish2000/CLU/tree/master/clu/config/abc.py
+[clu.config.env]: https://github.com/fish2000/CLU/tree/master/clu/config/env.py
+[clu.config.filebase]: https://github.com/fish2000/CLU/tree/master/clu/config/filebase.py
+[clu.config.keymap]: https://github.com/fish2000/CLU/tree/master/clu/config/keymap.py
+[clu.config.keymapview]: https://github.com/fish2000/CLU/tree/master/clu/config/keymapview.py
+[clu.config.ns]: https://github.com/fish2000/CLU/tree/master/clu/config/ns.py
+[clu.config.proxy]: https://github.com/fish2000/CLU/tree/master/clu/config/proxy.py
+
+[clu.constants]: https://github.com/fish2000/CLU/tree/master/clu/constants
+[clu.constants.consts]: https://github.com/fish2000/CLU/tree/master/clu/constants/consts.py
+[clu.constants.polyfills]: https://github.com/fish2000/CLU/tree/master/clu/constants/polyfills.py
+
+[clu.fs]: https://github.com/fish2000/CLU/tree/master/clu/fs
+[clu.fs.abc]: https://github.com/fish2000/CLU/tree/master/clu/fs/abc.py
+[clu.fs.appdirectories]: https://github.com/fish2000/CLU/tree/master/clu/fs/appdirectories.py
+[clu.fs.filesystem]: https://github.com/fish2000/CLU/tree/master/clu/fs/filesystem.py
+[clu.fs.misc]: https://github.com/fish2000/CLU/tree/master/clu/fs/misc.py
+[clu.fs.pypath]: https://github.com/fish2000/CLU/tree/master/clu/fs/pypath.py
+
+[clu.importing]: https://github.com/fish2000/CLU/tree/master/clu/importing
+[clu.importing.base]: https://github.com/fish2000/CLU/tree/master/clu/importing/base.py
+[clu.importing.proxy]: https://github.com/fish2000/CLU/tree/master/clu/importing/proxy.py
+
+[clu.repl]: https://github.com/fish2000/CLU/tree/master/clu/repl
+[clu.repl.ansi]: https://github.com/fish2000/CLU/tree/master/clu/repl/ansi.py
+[clu.repl.banners]: https://github.com/fish2000/CLU/tree/master/clu/repl/banners.py
+[clu.repl.columnize]: https://github.com/fish2000/CLU/tree/master/clu/repl/columnize.py
+[clu.repl.modules]: https://github.com/fish2000/CLU/tree/master/clu/repl/modules.py
+
+[clu.scripts]: https://github.com/fish2000/CLU/tree/master/clu/scripts
+[clu.scripts.dictroast]: https://github.com/fish2000/CLU/tree/master/clu/scripts/dictroast.py
+[clu.scripts.repl]: https://github.com/fish2000/CLU/tree/master/clu/scripts/repl.py
+[clu.scripts.treeline]: https://github.com/fish2000/CLU/tree/master/clu/scripts/treeline.py
+
+[clu.testing]: https://github.com/fish2000/CLU/tree/master/clu/testing
+[clu.testing.pytest]: https://github.com/fish2000/CLU/tree/master/clu/testing/pytest.py
+[clu.testing.utils]: https://github.com/fish2000/CLU/tree/master/clu/testing/utils.py
+
+[clu.typespace]: https://github.com/fish2000/CLU/tree/master/clu/typespace
+[clu.typespace.namespace]: https://github.com/fish2000/CLU/tree/master/clu/typespace/namespace.py
+
+[clu.version]: https://github.com/fish2000/CLU/tree/master/clu/version
+[clu.version.git_version]: https://github.com/fish2000/CLU/tree/master/clu/version/git_version.py
+[clu.version.read_version]: https://github.com/fish2000/CLU/tree/master/clu/version/read_version.py
+[clu.version.VersionInfo]: https://github.com/fish2000/CLU/blob/9f64200a947dbdcbf7eca44b87d0d9efeb4c6de7/clu/version/__init__.py#L100-L248
+
+[clu]: https://github.com/fish2000/CLU
+[clu-testsuite]: https://github.com/fish2000/CLU/tree/master/tests
+[clu-noxfile]: https://github.com/fish2000/CLU/blob/master/noxfile.py
+
+[clu.abstract]: https://github.com/fish2000/CLU/tree/master/clu/abstract.py
+[clu.all]: https://github.com/fish2000/CLU/tree/master/clu/all.py
+[clu.application]: https://github.com/fish2000/CLU/tree/master/clu/application.py
+[clu.csv]: https://github.com/fish2000/CLU/tree/master/clu/csv.py
+[clu.dicts]: https://github.com/fish2000/CLU/tree/master/clu/dicts.py
+[clu.dispatch]: https://github.com/fish2000/CLU/tree/master/clu/dispatch.py
+[clu.enums]: https://github.com/fish2000/CLU/tree/master/clu/enums.py
+[clu.exporting]: https://github.com/fish2000/CLU/tree/master/clu/exporting.py
+[clu.extending]: https://github.com/fish2000/CLU/tree/master/clu/extending.py
+[clu.keyvalue]: https://github.com/fish2000/CLU/tree/master/clu/keyvalue.py
+[clu.mathematics]: https://github.com/fish2000/CLU/tree/master/clu/mathematics.py
+[clu.naming]: https://github.com/fish2000/CLU/tree/master/clu/naming.py
+[clu.predicates]: https://github.com/fish2000/CLU/tree/master/clu/predicates.py
+[clu.repr]: https://github.com/fish2000/CLU/tree/master/clu/repr.py
+[clu.sanitizer]: https://github.com/fish2000/CLU/tree/master/clu/sanitizer.py
+[clu.stdio]: https://github.com/fish2000/CLU/tree/master/clu/stdio.py
+[clu.typology]: https://github.com/fish2000/CLU/tree/master/clu/typology.py
+
+[instakit]: https://github.com/fish2000/instakit
+[instakit.processors.curves]: https://github.com/fish2000/instakit/blob/master/instakit/processors/curves.py
+[instakit.processors.curves.CurveSet]: https://github.com/fish2000/instakit/blob/ad5591c88176c2c997d86833b93dde017545277f/instakit/processors/curves.py#L109-L240
+[collections.abc.Mapping]: https://docs.python.org/3/library/collections.abc.html#collections.abc.Mapping
+[collections.abc.MutableMapping]: https://docs.python.org/3/library/collections.abc.html#collections.abc.MutableMapping
+[collections.ChainMap]: https://docs.python.org/3/library/collections.html#chainmap-objects
+[reprlib.Repr]: https://docs.python.org/3/library/reprlib.html#reprlib.Repr
+[sys.path]: https://docs.python.org/3/library/sys_path_init.html
+[tempfile.NamedTemporaryFIle]: https://docs.python.org/3/library/tempfile.html#tempfile.NamedTemporaryFile
+[types]: https://docs.python.org/3/library/types.html
+[types.ModuleType]: https://docs.python.org/3/library/types.html#types.ModuleType
+[types.FunctionType]: https://docs.python.org/3/library/types.html#types.FunctionType
+[types.SimpleNamespace]: https://docs.python.org/3/library/types.html#additional-utility-classes-and-functions
+[zipfile]: https://docs.python.org/3/library/zipfile.html
+[dicts]: https://docs.python.org/3/tutorial/datastructures.html#dictionaries

{python_clu-0.12.2.dist-info → python_clu-0.12.4.dist-info}/RECORD

@@ -1,6 +1,6 @@
 clu/__init__.py,sha256=b8oH0ccvPZhHj6Hx9KmvQJu-Ic5MWj2PqUNyWgHPxsg,2106
 clu/__main__.py,sha256=ZLTfX6fCcimhzwZZVKaTk1LiLUtq2edMWAicGxWtKQA,4170
-clu/__version__.py,sha256=2NS09cZ7_4NXnNX87YIgda5W5KLDZGMrD7Y6C05_Uog,22
+clu/__version__.py,sha256=7oJgOfmJcDNgC_fv9LP8UOoCR1zHDvn7WlirBOozdzQ,22
 clu/abstract.py,sha256=ZDn2zOug6S-CoVp5W3uruwbMvFfvtcvJ4iQpjivBBbo,14157
 clu/all.py,sha256=1Dhdufjubi4elC8x95lhevRUdwL_YsOdJC5Q2U5B-j0,3102
 clu/application.py,sha256=EqgTw2wMlvSx-dmSOcgJVPqu4jwzsP06egmvuzuyEmo,6062
@@ -66,7 +66,7 @@ clu/repl/modules.py,sha256=w2Cc-sN7Cjes7wO1resV03W-5gTmIgagYpwIPqShZRM,9424
 clu/repl/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 clu/repl/cli/boilerplate.py,sha256=eDBQhDuymS74KY8zDyCeuxcef1k1mOnS4r3Rs7lN95c,1081
 clu/repl/cli/boilerplate_copy.py,sha256=qDfjUq47vPfnf7LZv7gQ7jWZXJXo1jNY6ckZdrUILOw,521
-clu/repl/cli/print_version.py,sha256=ONS_LKfnQcrV37KDgK4WSxAZsSNow1WKf4bMliCMn-A,1181
+clu/repl/cli/print_version.py,sha256=Bw2BQdeqx-vak0msTSU64rbrmTgFw6ZpGHD5DMesjbA,1485
 clu/scripts/.gitignore,sha256=EfdiMQTYFRqAtsEvRIS6N5FzZ0cYQ1TR-PXSOxHETFQ,23
 clu/scripts/README.md,sha256=g7DVn99jcVart0gjymIdXtdfI0_kHI371IpD_o8sHSs,1753
 clu/scripts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -74,7 +74,7 @@ clu/scripts/ansicolors.py,sha256=u0nJhEC1cHnjYihkxAlfs80drbyAa7YxdvDvl9mcG4E,262
 clu/scripts/boilerplate.py,sha256=sAn9LaCh0mZqRvI_lsSK8eDoRhHigR3MU87HLDStR2Q,727
 clu/scripts/dictroast.py,sha256=E4qNwTPLrbj2914NediV7LHzia9IM2flsCGtaLSTXg0,5583
 clu/scripts/prediversus.py,sha256=063qT-A7I4po_N9GpafQLAJxglphaJatQIDG2t6jw0s,5173
-clu/scripts/repl.py,sha256=YggHIw_tZPJxuR81hqYu8aH5mhq0ndJryWidBCZUkYQ,7666
+clu/scripts/repl.py,sha256=7BeFXMDaQw1woGK3bl54fdgFV_E8ag0uH1_s7eIjcro,7685
 clu/scripts/treeline.py,sha256=kv7yvsNgO0GVY8gLRrbg4bTB1owXinwrV4otx-MGaYY,31427
 clu/scripts/legacy/forkumask.py,sha256=Q4atVqiX8ERNoe4rfv6qCU8RMlxbvAvsHn4p0g8uG5I,1847
 clu/scripts/legacy/repl-bpython.py,sha256=FqDi_3VL27qX8FK4pF2cI1i_9AsbYsIosJ2K8hOoPlQ,21120
@@ -97,11 +97,10 @@ clu/version/__init__.py,sha256=JPM3y55fTL5D9l0AzJ_2esPgLRWHSKqvV4NYwkGzbKE,8775
 clu/version/__main__.py,sha256=pFWGzpcVNQegMhB_I6xO3hvR3xIhlVnHYVJ54wvxSH8,268
 clu/version/git_version.py,sha256=snh4lHsY4EoFRH0bh--Htequw9eJSfRI2zueUG573gY,1745
 clu/version/read_version.py,sha256=_bBVNy48o5DWmvcDOawINeux2oSIQMFXBZJ9SQ5p4WQ,3879
-python_clu-0.12.2.dist-info/licenses/COPYING.md,sha256=llYAasj2CkLS5mcJ7eRisHzPx_EUig0iG-awvVW-gLg,1719
-python_clu-0.12.2.dist-info/licenses/LICENSE.txt,sha256=xxq-ZV5xvCrohv6DMqkvl9NCaMtFRtVqeOSMelulhdE,1828
-python_clu-0.12.2.dist-info/METADATA,sha256=0V2fJVKANrLxtfTLulDolsmbA6NAOGY70djjl0E3gWE,2690
-python_clu-0.12.2.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-python_clu-0.12.2.dist-info/entry_points.txt,sha256=gHmvIG1rglS0xjrB9O1AC6SspAL8Vl5NTet-2oyce40,256
-python_clu-0.12.2.dist-info/top_level.txt,sha256=OKMcaFrtzEJat-RA3KEqUOiemjFjZRhBFOr6_QqL7gQ,4
-python_clu-0.12.2.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-python_clu-0.12.2.dist-info/RECORD,,
+python_clu-0.12.4.dist-info/licenses/LICENSE.txt,sha256=xxq-ZV5xvCrohv6DMqkvl9NCaMtFRtVqeOSMelulhdE,1828
+python_clu-0.12.4.dist-info/METADATA,sha256=6qx1Hc8XWm9qTPNkG7RXx4WJYQxN0tmYNDq-yuxEdpk,31689
+python_clu-0.12.4.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+python_clu-0.12.4.dist-info/entry_points.txt,sha256=gHmvIG1rglS0xjrB9O1AC6SspAL8Vl5NTet-2oyce40,256
+python_clu-0.12.4.dist-info/top_level.txt,sha256=OKMcaFrtzEJat-RA3KEqUOiemjFjZRhBFOr6_QqL7gQ,4
+python_clu-0.12.4.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+python_clu-0.12.4.dist-info/RECORD,,

{python_clu-0.12.2.dist-info → python_clu-0.12.4.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (78.1.0)
+Generator: setuptools (80.7.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

python_clu-0.12.2.dist-info/METADATA

@@ -1,73 +0,0 @@
-Metadata-Version: 2.4
-Name: python-clu
-Version: 0.12.2
-Summary: CLU - Common Lightweight Utilities, or Command-Line Utilities (your pick)
-Home-page: https://github.com/fish2000/clu
-Download-URL: https://github.com/fish2000/clu/zipball/master
-Author: Alexander Böhn
-Author-email: fish2000@gmail.com
-License: MIT
-Keywords: command utilities clu fish2000 command-line modules predicates REPL tools
-Platform: any
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Framework :: Pytest
-Classifier: Intended Audience :: Developers
-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
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: Implementation :: PyPy
-Description-Content-Type: text/markdown
-License-File: LICENSE.txt
-License-File: COPYING.md
-Requires-Dist: Click>=7.0
-Requires-Dist: colorama>=0.4.0
-Requires-Dist: dataclasses>=0.6; python_version < "3.7"
-Requires-Dist: dbx-stopwatch>=1.6
-Requires-Dist: enum34>=1.1.0; python_version < "3.4"
-Requires-Dist: heapdict>=1.0.0
-Requires-Dist: humanize>=1.0.0
-Requires-Dist: importlib-metadata>=1.4.0; python_version < "3.8"
-Requires-Dist: mock>=4.0.0
-Requires-Dist: multidict>=4.7.0
-Requires-Dist: packaging
-Requires-Dist: pout>=0.8.13
-Requires-Dist: pygments>=2.0.0
-Requires-Dist: PyYAML>=5.3.0
-Requires-Dist: redis>=3.4.0
-Requires-Dist: setuptools>=30.0.0
-Requires-Dist: six>=1.10.0
-Requires-Dist: termcolor>=1.1.0
-Requires-Dist: toml>=0.10.0
-Requires-Dist: wheel>=0.34.0
-Requires-Dist: zict>=0.1.2
-Requires-Dist: zipp>=2.0.0
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: download-url
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: license-file
-Dynamic: platform
-Dynamic: requires-dist
-Dynamic: summary
-
-CLU – Common Lightweight Utilities (née Command-Line Utilities)
-==================================================
-
-This is a packaged-up and sanely version-controlled version of [the Python tools I wrote for my REPLs](https://github.com/fish2000/homage/blob/master/.script-bin/replutilities.py), divided up into
-a bunch of subordinate packages.
-
-If you assumed that the project name was a Tron reference, you are in fact correct.

python_clu-0.12.2.dist-info/licenses/COPYING.md

@@ -1,20 +0,0 @@
-Copyright © 2012-2019 Alexander Böhn <fish2000@gmail.com>; All rights reserved.
-
-Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
-2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
-3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
-4. All stipulations and conditions enumerated in the software license (q.v. “LICENSE.txt” file enclosure sub.) are additionally acknowleged and summarily reproduced verbatim according to Condition §2 supra.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
-LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-POSSIBILITY OF SUCH DAMAGE.