python-clu 0.11.2__tar.gz → 0.11.4__tar.gz

{python_clu-0.11.2 → python_clu-0.11.4}/.bumpversion.toml

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

{python_clu-0.11.2 → python_clu-0.11.4}/Makefile

@@ -93,8 +93,7 @@ changelog: remove-changelog
 	gitchangelog > CHANGELOG.md
 
 repl:
-	python -m bpython --config=$(PROJECT_ROOT)/.config/bpython/config.py3 \
-			-i $(PROJECT_BASE)/clu/scripts/repl.py
+	python -m bpython --config=$(PROJECT_ROOT)/.config/bpython/config.py3 -i $(PROJECT_BASE)/clu/scripts/repl.py
 
 ipy:
 	python -m IPython --autoindent --pylab --colors=LightBG \

{python_clu-0.11.2 → python_clu-0.11.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-clu
-Version: 0.11.2
+Version: 0.11.4
 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

{python_clu-0.11.2 → python_clu-0.11.4}/README.md

@@ -3,6 +3,9 @@ CLU – Common Lightweight Utilities (née Command-Line Utilities)
 
 [![codecov](https://codecov.io/gh/fish2000/CLU/branch/master/graph/badge.svg)](https://codecov.io/gh/fish2000/CLU)
 
+Install it right now! Type: `$ pip install -U python-clu`
+---------------------------------------------------------
+
 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:
 

python_clu-0.11.4/clu/__version__.py

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

{python_clu-0.11.2 → python_clu-0.11.4}/clu/constants/data.py

@@ -211,6 +211,66 @@ banners['python3.x'] = """
                                                                              
 """
 
+banners['python3.15'] = """
+                  888    888                         .d8888b.       d888  888888888  
+                  888    888                        d88P  Y88b     d8888  888        
+                  888    888                             .d88P       888  888        
+88888b.  888  888 888888 88888b.   .d88b.  88888b.      8888"        888  8888888b.  
+888 "88b 888  888 888    888 "88b d88""88b 888 "88b      "Y8b.       888       "Y88b 
+888  888 888  888 888    888  888 888  888 888  888 888    888       888         888 
+888 d88P Y88b 888 Y88b.  888  888 Y88..88P 888  888 Y88b  d88P d8b   888  Y88b  d88P 
+88888P"   "Y88888  "Y888 888  888  "Y88P"  888  888  "Y8888P"  Y8P 8888888 "Y8888P"  
+888           888                                                                    
+888      Y8b d88P                                                                    
+888       "Y88P"                                                                     
+
+"""
+
+banners['python3.14'] = """
+                  888    888                         .d8888b.       d888      d8888  
+                  888    888                        d88P  Y88b     d8888     d8P888  
+                  888    888                             .d88P       888    d8P 888  
+88888b.  888  888 888888 88888b.   .d88b.  88888b.      8888"        888   d8P  888  
+888 "88b 888  888 888    888 "88b d88""88b 888 "88b      "Y8b.       888  d88   888  
+888  888 888  888 888    888  888 888  888 888  888 888    888       888  8888888888 
+888 d88P Y88b 888 Y88b.  888  888 Y88..88P 888  888 Y88b  d88P d8b   888        888  
+88888P"   "Y88888  "Y888 888  888  "Y88P"  888  888  "Y8888P"  Y8P 8888888      888  
+888           888                                                                    
+888      Y8b d88P                                                                    
+888       "Y88P"                                                                     
+
+"""
+
+banners['python3.13'] = """
+                  888    888                         .d8888b.       d888   .d8888b.  
+                  888    888                        d88P  Y88b     d8888  d88P  Y88b 
+                  888    888                             .d88P       888       .d88P 
+88888b.  888  888 888888 88888b.   .d88b.  88888b.      8888"        888      8888"  
+888 "88b 888  888 888    888 "88b d88""88b 888 "88b      "Y8b.       888       "Y8b. 
+888  888 888  888 888    888  888 888  888 888  888 888    888       888  888    888 
+888 d88P Y88b 888 Y88b.  888  888 Y88..88P 888  888 Y88b  d88P d8b   888  Y88b  d88P 
+88888P"   "Y88888  "Y888 888  888  "Y88P"  888  888  "Y8888P"  Y8P 8888888 "Y8888P"  
+888           888                                                                    
+888      Y8b d88P                                                                    
+888       "Y88P"                                                                     
+
+"""
+
+banners['python3.12'] = """
+                  888    888                         .d8888b.       d888    .d8888b.  
+                  888    888                        d88P  Y88b     d8888   d88P  Y88b 
+                  888    888                             .d88P       888          888 
+88888b.  888  888 888888 88888b.   .d88b.  88888b.      8888"        888        .d88P 
+888 "88b 888  888 888    888 "88b d88""88b 888 "88b      "Y8b.       888    .od888P"  
+888  888 888  888 888    888  888 888  888 888  888 888    888       888   d88P"      
+888 d88P Y88b 888 Y88b.  888  888 Y88..88P 888  888 Y88b  d88P d8b   888   888"       
+88888P"   "Y88888  "Y888 888  888  "Y88P"  888  888  "Y8888P"  Y8P 8888888 888888888  
+888           888                                                                     
+888      Y8b d88P                                                                     
+888       "Y88P"                                                                      
+
+"""
+
 banners['python3.11'] = """
                   888    888                         .d8888b.       d888    d888   
                   888    888                        d88P  Y88b     d8888   d8888   

{python_clu-0.11.2 → python_clu-0.11.4}/clu/scripts/repl.py

@@ -27,15 +27,23 @@ repl.py – THE RUBRICK:
 from __future__ import print_function
 
 import importlib
+import os.path
+import runpy
+import warnings
 
 from clu.all import import_clu_modules
+from clu.config.env import Environ
+from clu.constants import consts
 from clu.naming import nameof, qualified_import
-from clu.predicates import ispublic
+from clu.predicates import ispublic, listify
+from clu.repl import columnize
+
+# Set up the __all__ tuple:
+__all__ = list()
 
 # MODULE EXPORT FUNCTIONS: given a module name, export
 # either the module or its contents into a given namespace:
-
-def star_export(modulename, namespace):
+def star_export(modulename, namespace, alltuple=__all__):
     """ Safely bind everything a module exports to a namespace. """
     try:
         module = qualified_import(modulename)
@@ -44,8 +52,9 @@ def star_export(modulename, namespace):
     for name in dir(module):
         if ispublic(name):
             namespace[name] = getattr(module, name)
+            alltuple += listify(name)
 
-def module_export(modulename, namespace):
+def module_export(modulename, namespace, alltuple=__all__):
     """ Safely bind a module to a namespace. """
     try:
         module = qualified_import(modulename)
@@ -53,14 +62,12 @@ def module_export(modulename, namespace):
         module = importlib.import_module(modulename)
     name = nameof(module)
     namespace[modulename] = namespace[name] = module
+    alltuple += listify(name)
 
 # Warm up sys.modules and friends:
-
 import_clu_modules()
 
-# Set up the GLOBAL namespace and the __all__ tuple:
-
-__all__ = tuple()
+# Set up the GLOBALS namespace:
 GLOBALS = globals()
 
 starmods = ('clu.repl.ansi',
@@ -126,7 +133,6 @@ for mod in mods:
 
 # Additionals and corner-cases – imports requiring their own
 # bespoke import-statement forms:
-
 import collections.abc
 from PIL import Image
 from pprint import pprint, pformat
@@ -135,11 +141,12 @@ pp = pprint
 ppt = lambda thing: pprint(tuple(thing))
 
 # These two imports trigger module-level __getattr__ actions:
-
 from clu.testing.utils import pout, inline
 
-# Not quite sure where to put this, for now:
+# Append to __all__:
+__all__ += ['pout', 'inline', 'pp', 'ppt']
 
+# Not quite sure where to put this, for now:
 _explain = lambda thing=None: print(columnize(dir(thing),
                                     display_width=consts.SEPARATOR_WIDTH,
                                             ljust=True))
@@ -182,7 +189,7 @@ except (ImportError, SyntaxError, TypeError): # pragma: no cover
     pass
 else:
     # Extend `__all__`:
-    __all__ += ('asset', 'image_paths', 'catimage')
+    __all__ += ['asset', 'image_paths', 'catimage']
     # Prepare a list of readily open-able image file paths:
     image_paths = list(map(
         lambda image_file: asset.path('img', image_file),
@@ -190,12 +197,30 @@ else:
     # I do this practically every time, so I might as well do it here:
     catimage = Image.open(image_paths[0])
 
-# Remove duplicate and invalid sys.paths:
+# Access CLU app environment variables:
+cluenv = Environ(appname=consts.APPNAME)
+
+# If you, the user, set up a CLU_USER_SCRIPT environment variable
+# before running this repl script, you can have it executed herein:
+if 'user:script' in cluenv:
+    user_script_path = cluenv['user:script']
+    if os.path.exists(user_script_path):
+        user_script_globals = runpy.run_path(user_script_path)
+        GLOBALS.update(user_script_globals)
+        __all__ += list(filter(ispublic, user_script_globals.keys()))
+    else:
+        message = "CLU_USER_SCRIPT needs to point to a Python file"
+        warnings.simplefilter('always')
+        warnings.warn(stacklevel=2, message=message)
+
 
+# Adjust __all__ again:
+__all__ += ['_explain', 'explain', 'cluenv']
+
+# Remove duplicate and invalid sys.paths:
 pypath.remove_invalid_paths()
 
 # Print the Python banner and/or warnings, messages, and other tripe:
-
 if __name__ == '__main__':
     # In theory, this will *not* run when repl.py
     # is loaded into a REPL using a “-i” flag:

{python_clu-0.11.2 → python_clu-0.11.4}/python_clu.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-clu
-Version: 0.11.2
+Version: 0.11.4
 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

{python_clu-0.11.2 → python_clu-0.11.4}/setup.py

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

python_clu-0.11.2/clu/__version__.py

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