housekeeping

Author: skullydazed

README.md

@@ -1,6 +1,6 @@
 # MILC - An Opinionated Batteries-Included Python 3 CLI Framework
 
-MILC is a framework for writing CLI applications in Python 3.8+. It gives you
+MILC is a framework for writing CLI applications in Python 3.9+. It gives you
 all the features users expect from a modern CLI tool out of the box:
 
 * CLI Argument Parsing, with or without subcommands

docs/breaking_changes.md

@@ -3,10 +3,11 @@
 This is a list of breaking changes that have been made to MILC. If your script stops working after a minor or major version upgrade this document will tell you how to fix it.
 
 # Version 2.0.0
-
 * `cli.config_source` now returns `'env_var'` for arguments whose value came from an environment variable via `env_prefix`. Previously only `'argument'`, `'config_file'`, and `None` were possible values. Code that exhaustively checks `config_source` values will need to handle `'env_var'`.
 * `cli.args_passed` has been removed from the public API. Use `cli.config_source` to determine where a value came from.
 * `cli.milc_options()` now uses `is not None` checks for all parameters. Previously, passing a falsy value (e.g. `name=''`) would silently fall back to the previously set value. Now it is applied as-is.
+* The context manager code (with cli: aka `__enter__`/`__exit__`) has been removed. It added unnecessary complexity.
+* Removed support for `set_metadata()` and the `MILC_APP_NAME`, `MILC_APP_VERSION`, and `MILC_APP_AUTHOR` environment vars
 
 # Version 1.9.0
 * Appdirs [has been deprecated](https://github.com/ActiveState/appdirs/issues/79#issuecomment-877645712) and replaced with [platformdirs](https://github.com/tox-dev/platformdirs).

docs/threading.md

@@ -1,6 +1,6 @@
 # Thread Safety
 
-MILC provides a locking mechanism you can interact with for thread safety. It will acquire and release that lock when changing any objects in memory. You can utilize this same mechanism in your own programs as needed. Under the hood it uses an [RLock object](https://docs.python.org/3.8/library/threading.html#rlock-objects) to do the locking.
+MILC provides a locking mechanism you can interact with for thread safety. It will acquire and release that lock when changing any objects in memory. You can utilize this same mechanism in your own programs as needed. Under the hood it uses an [RLock object](https://docs.python.org/3.9/library/threading.html#rlock-objects) to do the locking.
 
 ## Acquire
 

milc/__init__.py

@@ -24,36 +24,7 @@
 from .milc import MILC
 from .milc_interface import MILCInterface
 
-if 'MILC_IGNORE_DEPRECATED' not in os.environ:
-    for name in ('MILC_APP_NAME', 'MILC_APP_VERSION', 'MILC_APP_AUTHOR'):
-        if name in os.environ:
-            warnings.warn(f'Using environment variable {name} is deprecated and will not be supported in the future, please use cli.milc_options() instead.', stacklevel=2)
-
 cli = MILCInterface()
 
-
-def set_metadata(
-    *,
-    name: Optional[str] = None,
-    author: Optional[str] = None,
-    version: Optional[str] = None,
-    logger: Optional[logging.Logger] = None,
-) -> MILCInterface:
-    """Set metadata about your program.
-
-    Deprecated: Use `cli.milc_options()` instead.
-
-    This allows you to set the application's name, version, and/or author
-    before executing your entrypoint. You can also pass your own logger here
-    if you like.
-
-    It's best to run this only once, and it must be run before you call `cli()`.
-    """
-    warnings.warn("milc.set_metadata has been deprecated, please use cli.milc_options() instead.", stacklevel=2)
-    cli.milc_options(name=name, author=author, version=version, logger=logger)
-
-    return cli
-
-
 # Extra stuff people can import
 from ._sparkline import sparkline  # noqa

milc/milc.py

@@ -41,13 +41,13 @@ def __init__(self, name: Optional[str] = None, author: Optional[str] = None, ver
         """
         # Set some defaults
         if not name:
-            name = os.environ.get('MILC_APP_NAME') or self.argv_name()
+            name = self.argv_name()
 
         if not version:
-            version = os.environ.get('MILC_APP_VERSION', 'unknown')
+            version = 'unknown'
 
         if not author:
-            author = os.environ.get('MILC_APP_AUTHOR', name.upper())
+            author = name.upper()
 
         # Setup a lock for thread safety
         self._lock = threading.RLock()

pyproject.toml

@@ -19,11 +19,12 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Natural Language :: English",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Scientific/Engineering",
     "Topic :: Scientific/Engineering :: Human Machine Interfaces",
     "Topic :: Software Development",