argcomplete 3.5.2__tar.gz → 3.6.0__tar.gz

argcomplete-3.6.0/.github/workflows/release.yml

@@ -0,0 +1,21 @@
+name: Publish release to PyPI
+
+on:
+  push:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+
+jobs:
+  pypi-publish:
+    name: Build and upload release to PyPI
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+      - run: pip install build
+      - run: python -m build
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

{argcomplete-3.5.2 → argcomplete-3.6.0}/Changes.rst

@@ -1,8 +1,26 @@
+Changes for v3.6.0 (2025-03-05)
+===============================
+
+- Support namespace package traversal when completing Python entry
+  points
+
+- zsh: skip repeat Python runs in the same completion run
+
+- Make \_parse_known_args signature more general for future API changes
+
+Changes for v3.5.3 (2024-12-31)
+===============================
+
+-  Use interactive shells and bind to make environment variable name
+   completions work in older Bash versions (#506)
+
 Changes for v3.5.2 (2024-12-06)
 ===============================
 
 -  Fix \_parse_known_args monkeypatching
 
+   - Note: This fix is required to restore compatibility with Python 3.12.8 and 3.13.1.
+
 -  CI improvements
 
 Changes for v3.5.1 (2024-10-06)

{argcomplete-3.5.2/argcomplete.egg-info → argcomplete-3.6.0}/PKG-INFO

@@ -1,17 +1,20 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: argcomplete
-Version: 3.5.2
+Version: 3.6.0
 Summary: Bash tab completion for argparse
-Home-page: https://github.com/kislyuk/argcomplete
-Author: Andrey Kislyuk
-Author-email: kislyuk@gmail.com
-License: Apache Software License
+Project-URL: Homepage, https://github.com/kislyuk/argcomplete
 Project-URL: Documentation, https://kislyuk.github.io/argcomplete
 Project-URL: Source Code, https://github.com/kislyuk/argcomplete
 Project-URL: Issue Tracker, https://github.com/kislyuk/argcomplete/issues
 Project-URL: Change Log, https://github.com/kislyuk/argcomplete/blob/develop/Changes.rst
-Platform: MacOS X
-Platform: Posix
+Author: Andrey Kislyuk
+Author-email: kislyuk@gmail.com
+Maintainer: Andrey Kislyuk
+Maintainer-email: kislyuk@gmail.com
+License: Apache Software License
+License-File: LICENSE.rst
+License-File: NOTICE
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
@@ -19,29 +22,26 @@ Classifier: Operating System :: MacOS :: MacOS X
 Classifier: Operating System :: POSIX
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
-Classifier: Development Status :: 5 - Production/Stable
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Shells
 Classifier: Topic :: Terminals
 Requires-Python: >=3.8
-Description-Content-Type: text/x-rst
-License-File: LICENSE.rst
-License-File: NOTICE
 Provides-Extra: test
-Requires-Dist: coverage; extra == "test"
-Requires-Dist: pexpect; extra == "test"
-Requires-Dist: wheel; extra == "test"
-Requires-Dist: ruff; extra == "test"
-Requires-Dist: mypy; extra == "test"
+Requires-Dist: coverage; extra == 'test'
+Requires-Dist: mypy; extra == 'test'
+Requires-Dist: pexpect; extra == 'test'
+Requires-Dist: ruff; extra == 'test'
+Requires-Dist: wheel; extra == 'test'
+Description-Content-Type: text/x-rst
 
 argcomplete - Bash/zsh tab completion for argparse
 ==================================================
@@ -85,6 +85,9 @@ follows:
     args = parser.parse_args()
     ...
 
+If using ``pyproject.toml`` ``[project.scripts]`` entry points, the ``PYTHON_ARGCOMPLETE_OK`` marker should appear
+at the beginning of the file that contains the entry point.
+
 Register your Python application with your shell's completion framework by running ``register-python-argcomplete``::
 
     eval "$(register-python-argcomplete my-python-app)"
@@ -268,9 +271,9 @@ multiple Python versions on the same system, the version being used to run the s
  ``/etc/shells``, and run ``chsh`` to change your shell). You can check the version of the running copy of bash with
  ``echo $BASH_VERSION``.
 
-.. note:: If you use setuptools/distribute ``scripts`` or ``entry_points`` directives to package your module,
+.. note:: If you use ``project.scripts`` directives to provide command line entry points to your package,
  argcomplete will follow the wrapper scripts to their destination and look for ``PYTHON_ARGCOMPLETE_OK`` in the
- destination code.
+ first kilobyte of the file containing the destination code.
 
 If you choose not to use global completion, or ship a completion module that depends on argcomplete, you must register
 your script explicitly using ``eval "$(register-python-argcomplete my-python-app)"``. Standard completion module
@@ -295,7 +298,7 @@ work for zsh as well.
 
 Python Support
 --------------
-Argcomplete requires Python 3.7+.
+Argcomplete requires Python 3.9+.
 
 Support for other shells
 ------------------------

{argcomplete-3.5.2 → argcomplete-3.6.0}/README.rst

@@ -40,6 +40,9 @@ follows:
     args = parser.parse_args()
     ...
 
+If using ``pyproject.toml`` ``[project.scripts]`` entry points, the ``PYTHON_ARGCOMPLETE_OK`` marker should appear
+at the beginning of the file that contains the entry point.
+
 Register your Python application with your shell's completion framework by running ``register-python-argcomplete``::
 
     eval "$(register-python-argcomplete my-python-app)"
@@ -223,9 +226,9 @@ multiple Python versions on the same system, the version being used to run the s
  ``/etc/shells``, and run ``chsh`` to change your shell). You can check the version of the running copy of bash with
  ``echo $BASH_VERSION``.
 
-.. note:: If you use setuptools/distribute ``scripts`` or ``entry_points`` directives to package your module,
+.. note:: If you use ``project.scripts`` directives to provide command line entry points to your package,
  argcomplete will follow the wrapper scripts to their destination and look for ``PYTHON_ARGCOMPLETE_OK`` in the
- destination code.
+ first kilobyte of the file containing the destination code.
 
 If you choose not to use global completion, or ship a completion module that depends on argcomplete, you must register
 your script explicitly using ``eval "$(register-python-argcomplete my-python-app)"``. Standard completion module
@@ -250,7 +253,7 @@ work for zsh as well.
 
 Python Support
 --------------
-Argcomplete requires Python 3.7+.
+Argcomplete requires Python 3.9+.
 
 Support for other shells
 ------------------------

{argcomplete-3.5.2 → argcomplete-3.6.0}/argcomplete/_check_module.py

@@ -10,30 +10,7 @@ Intended to be invoked by argcomplete's global completion function.
 import os
 import sys
 import tokenize
-
-try:
-    from importlib.util import find_spec  # type:ignore
-except ImportError:
-    import typing as t
-    from collections import namedtuple
-    from imp import find_module  # type:ignore
-
-    ModuleSpec = namedtuple("ModuleSpec", ["origin", "has_location", "submodule_search_locations"])
-
-    def find_spec(  # type:ignore
-        name: str,
-        package: t.Optional[str] = None,
-    ) -> t.Optional[ModuleSpec]:
-        """Minimal implementation as required by `find`."""
-        try:
-            f, path, _ = find_module(name)
-        except ImportError:
-            return None
-        has_location = path is not None
-        if f is None:
-            return ModuleSpec(None, has_location, [path])
-        f.close()
-        return ModuleSpec(path, has_location, None)
+from importlib.util import find_spec
 
 
 class ArgcompleteMarkerNotFound(RuntimeError):
@@ -42,7 +19,12 @@ class ArgcompleteMarkerNotFound(RuntimeError):
 
 def find(name, return_package=False):
     names = name.split(".")
-    spec = find_spec(names[0])
+    # Look for the first importlib ModuleSpec that has `origin` set, indicating it's not a namespace package.
+    for package_name_boundary in range(len(names)):
+        spec = find_spec(".".join(names[: package_name_boundary + 1]))
+        if spec is not None and spec.origin is not None:
+            break
+
     if spec is None:
         raise ArgcompleteMarkerNotFound('no module named "{}"'.format(names[0]))
     if not spec.has_location:
@@ -53,7 +35,7 @@ def find(name, return_package=False):
         return spec.origin
     if len(spec.submodule_search_locations) != 1:
         raise ArgcompleteMarkerNotFound("expecting one search location")
-    path = os.path.join(spec.submodule_search_locations[0], *names[1:])
+    path = os.path.join(spec.submodule_search_locations[0], *names[package_name_boundary + 1 :])
     if os.path.isdir(path):
         filename = "__main__.py"
         if return_package:

{argcomplete-3.5.2 → argcomplete-3.6.0}/argcomplete/bash_completion.d/_python-argcomplete

@@ -124,6 +124,12 @@ __python_argcomplete_which() {
 _python_argcomplete_global() {
 
     if [[ -n "${ZSH_VERSION-}" ]]; then
+        if [[ "${_matcher_num-}" -gt 1 ]]; then
+            # Return early if the completer is called multiple times in the same completion run.
+            # Currently the only known occurrence of this is in zsh when a matcher-list zstyle is declared.
+            # When this happens, _matcher_num is incremented past 1.
+            return
+        fi
         # Store result of a regex match in the
         # BASH_REMATCH variable rather than MATCH
         setopt local_options BASH_REMATCH

{argcomplete-3.5.2 → argcomplete-3.6.0}/argcomplete/completers.py

@@ -59,13 +59,26 @@ class FilesCompleter(BaseCompleter):
         completion = []
         if self.allowednames:
             if self.directories:
-                files = _call(["bash", "-c", "compgen -A directory -- '{p}'".format(p=prefix)])
+                # Using 'bind' in this and the following commands is a workaround to a bug in bash
+                # that was fixed in bash 5.3 but affects older versions. Environment variables are not treated
+                # correctly in older versions and calling bind makes them available. For details, see
+                # https://savannah.gnu.org/support/index.php?111125
+                files = _call(
+                    ["bash", "-c", "bind; compgen -A directory -- '{p}'".format(p=prefix)], stderr=subprocess.DEVNULL
+                )
                 completion += [f + "/" for f in files]
             for x in self.allowednames:
-                completion += _call(["bash", "-c", "compgen -A file -X '!*.{0}' -- '{p}'".format(x, p=prefix)])
+                completion += _call(
+                    ["bash", "-c", "bind; compgen -A file -X '!*.{0}' -- '{p}'".format(x, p=prefix)],
+                    stderr=subprocess.DEVNULL,
+                )
         else:
-            completion += _call(["bash", "-c", "compgen -A file -- '{p}'".format(p=prefix)])
-            anticomp = _call(["bash", "-c", "compgen -A directory -- '{p}'".format(p=prefix)])
+            completion += _call(
+                ["bash", "-c", "bind; compgen -A file -- '{p}'".format(p=prefix)], stderr=subprocess.DEVNULL
+            )
+            anticomp = _call(
+                ["bash", "-c", "bind; compgen -A directory -- '{p}'".format(p=prefix)], stderr=subprocess.DEVNULL
+            )
             completion = list(set(completion) - set(anticomp))
 
             if self.directories:

{argcomplete-3.5.2 → argcomplete-3.6.0}/argcomplete/packages/_argparse.py

@@ -75,7 +75,7 @@ class IntrospectiveArgumentParser(ArgumentParser):
     except for the lines that contain the string "Added by argcomplete".
     '''
 
-    def _parse_known_args(self, arg_strings, namespace, intermixed=False):
+    def _parse_known_args(self, arg_strings, namespace, intermixed=False, **kwargs):
         _num_consumed_args.clear()  # Added by argcomplete
         self._argcomplete_namespace = namespace
         self.active_actions: List[Action] = []  # Added by argcomplete

{argcomplete-3.5.2 → argcomplete-3.6.0}/argcomplete/packages/_shlex.py

@@ -36,7 +36,7 @@ class shlex:
         else:
             self.eof = ''
         self.commenters = '#'
-        self.wordchars = 'abcdfeghijklmnopqrstuvwxyz' 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_'
+        self.wordchars = 'abcdfeghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_'
         # Modified by argcomplete: 2/3 compatibility
         # if self.posix:
         #     self.wordchars += ('ßàáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿ'

{argcomplete-3.5.2 → argcomplete-3.6.0}/argcomplete/scripts/python_argcomplete_check_easy_install_script.py

@@ -33,7 +33,7 @@ def main():
             lines = head.split("\n", 12)
             for line in lines:
                 if line.startswith("# EASY-INSTALL-SCRIPT"):
-                    import pkg_resources
+                    import pkg_resources  # type: ignore
 
                     re_match = re.match("# EASY-INSTALL-SCRIPT: '(.+)','(.+)'", line)
                     assert re_match is not None
@@ -48,7 +48,7 @@ def main():
                     dist, group, name = re_match.groups()
                     import pkgutil
 
-                    import pkg_resources
+                    import pkg_resources  # type: ignore
 
                     entry_point_info = pkg_resources.get_distribution(dist).get_entry_info(group, name)
                     assert entry_point_info is not None
@@ -71,7 +71,7 @@ def main():
                     module = re_match.groups()[0]
                     import pkgutil
 
-                    import pkg_resources
+                    import pkg_resources  # type: ignore
 
                     with open(pkgutil.get_loader(module).get_filename()) as mod_fh:  # type: ignore
                         if "PYTHON_ARGCOMPLETE_OK" in mod_fh.read(1024):

{argcomplete-3.5.2 → argcomplete-3.6.0}/argcomplete/shell_integration.py

@@ -34,6 +34,12 @@ _python_argcomplete%(function_suffix)s() {
     local IFS=$'\013'
     local script="%(argcomplete_script)s"
     if [[ -n "${ZSH_VERSION-}" ]]; then
+        if [[ "${_matcher_num-}" -gt 1 ]]; then
+            # Return early if the completer is called multiple times in the same completion run.
+            # Currently the only known occurrence of this is in zsh when a matcher-list zstyle is declared.
+            # When this happens, _matcher_num is incremented past 1.
+            return
+        fi
         local completions
         completions=($(IFS="$IFS" \
             COMP_LINE="$BUFFER" \

{argcomplete-3.5.2 → argcomplete-3.6.0}/common.mk

@@ -18,9 +18,8 @@ release:
 	@if ! type -P pandoc; then echo "Please install pandoc"; exit 1; fi
 	@if ! type -P sponge; then echo "Please install moreutils"; exit 1; fi
 	@if ! type -P gh; then echo "Please install gh"; exit 1; fi
-	@if ! type -P twine; then echo "Please install twine"; exit 1; fi
 	git pull
-	git clean -x --force $$(python setup.py --name)
+	git clean -x --force argcomplete
 	TAG_MSG=$$(mktemp); \
 	    echo "# Changes for ${TAG} ($$(date +%Y-%m-%d))" > $$TAG_MSG; \
 	    git log --pretty=format:%s $$(git describe --abbrev=0)..HEAD >> $$TAG_MSG; \
@@ -32,13 +31,8 @@ release:
 	git push --follow-tags
 	$(MAKE) install
 	gh release create ${TAG} dist/*.whl --notes="$$(git tag --list ${TAG} -n99 | perl -pe 's/^\S+\s*// if $$. == 1' | sed 's/^\s\s\s\s//')"
-	$(MAKE) release-pypi
 	$(MAKE) release-docs
 
-release-pypi:
-	python -m build
-	twine upload dist/*.tar.gz dist/*.whl --verbose
-
 release-docs:
 	$(MAKE) docs
 	-git branch -D gh-pages

{argcomplete-3.5.2 → argcomplete-3.6.0}/pyproject.toml

@@ -1,7 +1,3 @@
-[build-system]
-requires = ["setuptools>=67.7.2", "setuptools_scm[toml]>=6.2"]
-build-backend = "setuptools.build_meta"
-
 [project]
 name = "argcomplete"
 description = "Bash tab completion for argparse"
@@ -9,7 +5,7 @@ readme = "README.rst"
 requires-python = ">=3.8"
 license = { text = "Apache Software License" }
 authors = [{ name = "Andrey Kislyuk"}, {email = "kislyuk@gmail.com" }]
-maintainers = []
+maintainers = [{ name = "Andrey Kislyuk"}, {email = "kislyuk@gmail.com" }]
 dynamic = ["version"]
 classifiers = [
   "Environment :: Console",
@@ -19,12 +15,12 @@ classifiers = [
   "Operating System :: POSIX",
   "Programming Language :: Python",
   "Programming Language :: Python :: 3",
-  "Programming Language :: Python :: 3.7",
   "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 :: Implementation :: CPython",
   "Programming Language :: Python :: Implementation :: PyPy",
   "Development Status :: 5 - Production/Stable",
@@ -43,12 +39,18 @@ register-python-argcomplete = "argcomplete.scripts.register_python_argcomplete:m
 test = ["coverage", "pexpect", "wheel", "ruff", "mypy"]
 
 [project.urls]
+"Homepage"= "https://github.com/kislyuk/argcomplete"
 "Documentation"= "https://kislyuk.github.io/argcomplete"
 "Source Code"= "https://github.com/kislyuk/argcomplete"
 "Issue Tracker"= "https://github.com/kislyuk/argcomplete/issues"
 "Change Log"= "https://github.com/kislyuk/argcomplete/blob/develop/Changes.rst"
 
-[tool.setuptools_scm]
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"
 
 [tool.black]
 line-length = 120
@@ -62,6 +64,8 @@ skip = ".*/version.py"
 
 [tool.ruff]
 line-length = 120
+
+[tool.ruff.lint]
 per-file-ignores = {"argcomplete/__init__.py" = ["F401"]}
 
 [tool.ruff.format]

argcomplete-3.6.0/setup.cfg

@@ -0,0 +1,6 @@
+[bdist_rpm]
+provides=python-argcomplete
+doc_files = Authors.rst
+            Changes.rst
+            README.rst
+            LICENSE.rst

argcomplete-3.5.2/PKG-INFO

@@ -1,351 +0,0 @@
-Metadata-Version: 2.1
-Name: argcomplete
-Version: 3.5.2
-Summary: Bash tab completion for argparse
-Home-page: https://github.com/kislyuk/argcomplete
-Author: Andrey Kislyuk
-Author-email: kislyuk@gmail.com
-License: Apache Software License
-Project-URL: Documentation, https://kislyuk.github.io/argcomplete
-Project-URL: Source Code, https://github.com/kislyuk/argcomplete
-Project-URL: Issue Tracker, https://github.com/kislyuk/argcomplete/issues
-Project-URL: Change Log, https://github.com/kislyuk/argcomplete/blob/develop/Changes.rst
-Platform: MacOS X
-Platform: Posix
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: MacOS :: MacOS X
-Classifier: Operating System :: POSIX
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: Implementation :: PyPy
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Topic :: Software Development
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: System :: Shells
-Classifier: Topic :: Terminals
-Requires-Python: >=3.8
-Description-Content-Type: text/x-rst
-License-File: LICENSE.rst
-License-File: NOTICE
-Provides-Extra: test
-Requires-Dist: coverage; extra == "test"
-Requires-Dist: pexpect; extra == "test"
-Requires-Dist: wheel; extra == "test"
-Requires-Dist: ruff; extra == "test"
-Requires-Dist: mypy; extra == "test"
-
-argcomplete - Bash/zsh tab completion for argparse
-==================================================
-*Tab complete all the things!*
-
-Argcomplete provides easy, extensible command line tab completion of arguments for your Python application.
-
-It makes two assumptions:
-
-* You're using bash or zsh as your shell
-* You're using `argparse <http://docs.python.org/3/library/argparse.html>`_ to manage your command line arguments/options
-
-Argcomplete is particularly useful if your program has lots of options or subparsers, and if your program can
-dynamically suggest completions for your argument/option values (for example, if the user is browsing resources over
-the network).
-
-Installation
-------------
-::
-
-    pip install argcomplete
-    activate-global-python-argcomplete
-
-See `Activating global completion`_ below for details about the second step.
-
-Refresh your shell environment (start a new shell).
-
-Synopsis
---------
-Add the ``PYTHON_ARGCOMPLETE_OK`` marker and a call to ``argcomplete.autocomplete()`` to your Python application as
-follows:
-
-.. code-block:: python
-
-    #!/usr/bin/env python
-    # PYTHON_ARGCOMPLETE_OK
-    import argcomplete, argparse
-    parser = argparse.ArgumentParser()
-    ...
-    argcomplete.autocomplete(parser)
-    args = parser.parse_args()
-    ...
-
-Register your Python application with your shell's completion framework by running ``register-python-argcomplete``::
-
-    eval "$(register-python-argcomplete my-python-app)"
-
-Quotes are significant; the registration will fail without them. See `Global completion`_ below for a way to enable
-argcomplete generally without registering each application individually.
-
-argcomplete.autocomplete(*parser*)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-This method is the entry point to the module. It must be called **after** ArgumentParser construction is complete, but
-**before** the ``ArgumentParser.parse_args()`` method is called. The method looks for an environment variable that the
-completion hook shellcode sets, and if it's there, collects completions, prints them to the output stream (fd 8 by
-default), and exits. Otherwise, it returns to the caller immediately.
-
-.. admonition:: Side effects
-
- Argcomplete gets completions by running your program. It intercepts the execution flow at the moment
- ``argcomplete.autocomplete()`` is called. After sending completions, it exits using ``exit_method`` (``os._exit``
- by default). This means if your program has any side effects that happen before ``argcomplete`` is called, those
- side effects will happen every time the user presses ``<TAB>`` (although anything your program prints to stdout or
- stderr will be suppressed). For this reason it's best to construct the argument parser and call
- ``argcomplete.autocomplete()`` as early as possible in your execution flow.
-
-.. admonition:: Performance
-
- If the program takes a long time to get to the point where ``argcomplete.autocomplete()`` is called, the tab completion
- process will feel sluggish, and the user may lose confidence in it. So it's also important to minimize the startup time
- of the program up to that point (for example, by deferring initialization or importing of large modules until after
- parsing options).
-
-Specifying completers
----------------------
-You can specify custom completion functions for your options and arguments. Two styles are supported: callable and
-readline-style. Callable completers are simpler. They are called with the following keyword arguments:
-
-* ``prefix``: The prefix text of the last word before the cursor on the command line.
-  For dynamic completers, this can be used to reduce the work required to generate possible completions.
-* ``action``: The ``argparse.Action`` instance that this completer was called for.
-* ``parser``: The ``argparse.ArgumentParser`` instance that the action was taken by.
-* ``parsed_args``: The result of argument parsing so far (the ``argparse.Namespace`` args object normally returned by
-  ``ArgumentParser.parse_args()``).
-
-Completers can return their completions as an iterable of strings or a mapping (dict) of strings to their
-descriptions (zsh will display the descriptions as context help alongside completions). An example completer for names
-of environment variables might look like this:
-
-.. code-block:: python
-
-    def EnvironCompleter(**kwargs):
-        return os.environ
-
-To specify a completer for an argument or option, set the ``completer`` attribute of its associated action. An easy
-way to do this at definition time is:
-
-.. code-block:: python
-
-    from argcomplete.completers import EnvironCompleter
-
-    parser = argparse.ArgumentParser()
-    parser.add_argument("--env-var1").completer = EnvironCompleter
-    parser.add_argument("--env-var2").completer = EnvironCompleter
-    argcomplete.autocomplete(parser)
-
-If you specify the ``choices`` keyword for an argparse option or argument (and don't specify a completer), it will be
-used for completions.
-
-A completer that is initialized with a set of all possible choices of values for its action might look like this:
-
-.. code-block:: python
-
-    class ChoicesCompleter(object):
-        def __init__(self, choices):
-            self.choices = choices
-
-        def __call__(self, **kwargs):
-            return self.choices
-
-The following two ways to specify a static set of choices are equivalent for completion purposes:
-
-.. code-block:: python
-
-    from argcomplete.completers import ChoicesCompleter
-
-    parser.add_argument("--protocol", choices=('http', 'https', 'ssh', 'rsync', 'wss'))
-    parser.add_argument("--proto").completer=ChoicesCompleter(('http', 'https', 'ssh', 'rsync', 'wss'))
-
-Note that if you use the ``choices=<completions>`` option, argparse will show
-all these choices in the ``--help`` output by default. To prevent this, set
-``metavar`` (like ``parser.add_argument("--protocol", metavar="PROTOCOL",
-choices=('http', 'https', 'ssh', 'rsync', 'wss'))``).
-
-The following `script <https://raw.github.com/kislyuk/argcomplete/master/docs/examples/describe_github_user.py>`_ uses
-``parsed_args`` and `Requests <http://python-requests.org/>`_ to query GitHub for publicly known members of an
-organization and complete their names, then prints the member description:
-
-.. code-block:: python
-
-    #!/usr/bin/env python
-    # PYTHON_ARGCOMPLETE_OK
-    import argcomplete, argparse, requests, pprint
-
-    def github_org_members(prefix, parsed_args, **kwargs):
-        resource = "https://api.github.com/orgs/{org}/members".format(org=parsed_args.organization)
-        return (member['login'] for member in requests.get(resource).json() if member['login'].startswith(prefix))
-
-    parser = argparse.ArgumentParser()
-    parser.add_argument("--organization", help="GitHub organization")
-    parser.add_argument("--member", help="GitHub member").completer = github_org_members
-
-    argcomplete.autocomplete(parser)
-    args = parser.parse_args()
-
-    pprint.pprint(requests.get("https://api.github.com/users/{m}".format(m=args.member)).json())
-
-`Try it <https://raw.github.com/kislyuk/argcomplete/master/docs/examples/describe_github_user.py>`_ like this::
-
-    ./describe_github_user.py --organization heroku --member <TAB>
-
-If you have a useful completer to add to the `completer library
-<https://github.com/kislyuk/argcomplete/blob/master/argcomplete/completers.py>`_, send a pull request!
-
-Readline-style completers
-~~~~~~~~~~~~~~~~~~~~~~~~~
-The readline_ module defines a completer protocol in rlcompleter_. Readline-style completers are also supported by
-argcomplete, so you can use the same completer object both in an interactive readline-powered shell and on the command
-line. For example, you can use the readline-style completer provided by IPython_ to get introspective completions like
-you would get in the IPython shell:
-
-.. _readline: http://docs.python.org/3/library/readline.html
-.. _rlcompleter: http://docs.python.org/3/library/rlcompleter.html#completer-objects
-.. _IPython: http://ipython.org/
-
-.. code-block:: python
-
-    import IPython
-    parser.add_argument("--python-name").completer = IPython.core.completer.Completer()
-
-``argcomplete.CompletionFinder.rl_complete`` can also be used to plug in an argparse parser as a readline completer.
-
-Printing warnings in completers
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Normal stdout/stderr output is suspended when argcomplete runs. Sometimes, though, when the user presses ``<TAB>``, it's
-appropriate to print information about why completions generation failed. To do this, use ``warn``:
-
-.. code-block:: python
-
-    from argcomplete import warn
-
-    def AwesomeWebServiceCompleter(prefix, **kwargs):
-        if login_failed:
-            warn("Please log in to Awesome Web Service to use autocompletion")
-        return completions
-
-Using a custom completion validator
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-By default, argcomplete validates your completions by checking if they start with the prefix given to the completer. You
-can override this validation check by supplying the ``validator`` keyword to ``argcomplete.autocomplete()``:
-
-.. code-block:: python
-
-    def my_validator(completion_candidate, current_input):
-        """Complete non-prefix substring matches."""
-        return current_input in completion_candidate
-
-    argcomplete.autocomplete(parser, validator=my_validator)
-
-Global completion
------------------
-In global completion mode, you don't have to register each argcomplete-capable executable separately. Instead, the shell
-will look for the string **PYTHON_ARGCOMPLETE_OK** in the first 1024 bytes of any executable that it's running
-completion for, and if it's found, follow the rest of the argcomplete protocol as described above.
-
-Additionally, completion is activated for scripts run as ``python <script>`` and ``python -m <module>``. If you're using
-multiple Python versions on the same system, the version being used to run the script must have argcomplete installed.
-
-.. admonition:: Bash version compatibility
-
- When using bash, global completion requires bash support for ``complete -D``, which was introduced in bash 4.2. Since
- Mac OS ships with an outdated version of Bash (3.2), you can either use zsh or install a newer version of bash using
- `Homebrew <http://brew.sh/>`_ (``brew install bash`` - you will also need to add ``/opt/homebrew/bin/bash`` to
- ``/etc/shells``, and run ``chsh`` to change your shell). You can check the version of the running copy of bash with
- ``echo $BASH_VERSION``.
-
-.. note:: If you use setuptools/distribute ``scripts`` or ``entry_points`` directives to package your module,
- argcomplete will follow the wrapper scripts to their destination and look for ``PYTHON_ARGCOMPLETE_OK`` in the
- destination code.
-
-If you choose not to use global completion, or ship a completion module that depends on argcomplete, you must register
-your script explicitly using ``eval "$(register-python-argcomplete my-python-app)"``. Standard completion module
-registration rules apply: namely, the script name is passed directly to ``complete``, meaning it is only tab completed
-when invoked exactly as it was registered. In the above example, ``my-python-app`` must be on the path, and the user
-must be attempting to complete it by that name. The above line alone would **not** allow you to complete
-``./my-python-app``, or ``/path/to/my-python-app``.
-
-Activating global completion
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The script ``activate-global-python-argcomplete`` installs the global completion script
-`bash_completion.d/_python-argcomplete <https://github.com/kislyuk/argcomplete/blob/master/argcomplete/bash_completion.d/_python-argcomplete>`_
-into an appropriate location on your system for both bash and zsh. The specific location depends on your platform and
-whether you installed argcomplete system-wide using ``sudo`` or locally (into your user's home directory).
-
-Zsh Support
------------
-Argcomplete supports zsh. On top of plain completions like in bash, zsh allows you to see argparse help strings as
-completion descriptions. All shellcode included with argcomplete is compatible with both bash and zsh, so the same
-completer commands ``activate-global-python-argcomplete`` and ``eval "$(register-python-argcomplete my-python-app)"``
-work for zsh as well.
-
-Python Support
---------------
-Argcomplete requires Python 3.7+.
-
-Support for other shells
-------------------------
-Argcomplete maintainers provide support only for the bash and zsh shells on Linux and MacOS. For resources related to
-other shells and platforms, including fish, tcsh, xonsh, powershell, and Windows, please see the
-`contrib <https://github.com/kislyuk/argcomplete/tree/develop/contrib>`_ directory.
-
-Common Problems
----------------
-If global completion is not completing your script, bash may have registered a default completion function::
-
-    $ complete | grep my-python-app
-    complete -F _minimal my-python-app
-
-You can fix this by restarting your shell, or by running ``complete -r my-python-app``.
-
-Debugging
----------
-Set the ``_ARC_DEBUG`` variable in your shell to enable verbose debug output every time argcomplete runs. This will
-disrupt the command line composition state of your terminal, but make it possible to see the internal state of the
-completer if it encounters problems.
-
-Acknowledgments
----------------
-Inspired and informed by the optcomplete_ module by Martin Blais.
-
-.. _optcomplete: http://pypi.python.org/pypi/optcomplete
-
-Links
------
-* `Project home page (GitHub) <https://github.com/kislyuk/argcomplete>`_
-* `Documentation <https://kislyuk.github.io/argcomplete/>`_
-* `Package distribution (PyPI) <https://pypi.python.org/pypi/argcomplete>`_
-* `Change log <https://github.com/kislyuk/argcomplete/blob/master/Changes.rst>`_
-
-Bugs
-~~~~
-Please report bugs, issues, feature requests, etc. on `GitHub <https://github.com/kislyuk/argcomplete/issues>`_.
-
-License
--------
-Copyright 2012-2023, Andrey Kislyuk and argcomplete contributors. Licensed under the terms of the
-`Apache License, Version 2.0 <http://www.apache.org/licenses/LICENSE-2.0>`_. Distribution of the LICENSE and NOTICE
-files with source copies of this package and derivative works is **REQUIRED** as specified by the Apache License.
-
-.. image:: https://github.com/kislyuk/argcomplete/workflows/Python%20package/badge.svg
-        :target: https://github.com/kislyuk/argcomplete/actions
-.. image:: https://codecov.io/github/kislyuk/argcomplete/coverage.svg?branch=master
-        :target: https://codecov.io/github/kislyuk/argcomplete?branch=master
-.. image:: https://img.shields.io/pypi/v/argcomplete.svg
-        :target: https://pypi.python.org/pypi/argcomplete
-.. image:: https://img.shields.io/pypi/l/argcomplete.svg
-        :target: https://pypi.python.org/pypi/argcomplete

argcomplete-3.5.2/argcomplete.egg-info/SOURCES.txt

@@ -1,64 +0,0 @@
-.gitignore
-Authors.rst
-Changes.rst
-LICENSE.rst
-MANIFEST.in
-Makefile
-NOTICE
-README.rst
-SECURITY.md
-common.mk
-pyproject.toml
-setup.cfg
-setup.py
-.github/FUNDING.yml
-.github/workflows/ci.yml
-argcomplete/__init__.py
-argcomplete/_check_console_script.py
-argcomplete/_check_module.py
-argcomplete/completers.py
-argcomplete/exceptions.py
-argcomplete/finders.py
-argcomplete/io.py
-argcomplete/lexers.py
-argcomplete/py.typed
-argcomplete/shell_integration.py
-argcomplete.egg-info/PKG-INFO
-argcomplete.egg-info/SOURCES.txt
-argcomplete.egg-info/dependency_links.txt
-argcomplete.egg-info/entry_points.txt
-argcomplete.egg-info/not-zip-safe
-argcomplete.egg-info/requires.txt
-argcomplete.egg-info/top_level.txt
-argcomplete/bash_completion.d/_python-argcomplete
-argcomplete/packages/__init__.py
-argcomplete/packages/_argparse.py
-argcomplete/packages/_shlex.py
-argcomplete/scripts/__init__.py
-argcomplete/scripts/activate_global_python_argcomplete.py
-argcomplete/scripts/python_argcomplete_check_easy_install_script.py
-argcomplete/scripts/register_python_argcomplete.py
-contrib/README.rst
-docs/changelog.rst
-docs/conf.py
-docs/fish_help_string.png
-docs/index.rst
-docs/toc.html
-docs/examples/describe_github_user.py
-test/__init__.py
-test/inputrc
-test/prog
-test/stuck
-test/test.py
-test/test_contrib_shells.py
-test/test_package/__init__.py
-test/test_package/setup.py
-test/test_package/test_module.py
-test/test_package/build/lib/test_module.py
-test/test_package/build/lib/test_package/__init__.py
-test/test_package/test_package/__init__.py
-test/test_package/test_package.egg-info/PKG-INFO
-test/test_package/test_package.egg-info/SOURCES.txt
-test/test_package/test_package.egg-info/dependency_links.txt
-test/test_package/test_package.egg-info/entry_points.txt
-test/test_package/test_package.egg-info/top_level.txt

argcomplete-3.5.2/argcomplete.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

argcomplete-3.5.2/argcomplete.egg-info/entry_points.txt

@@ -1,4 +0,0 @@
-[console_scripts]
-activate-global-python-argcomplete = argcomplete.scripts.activate_global_python_argcomplete:main
-python-argcomplete-check-easy-install-script = argcomplete.scripts.python_argcomplete_check_easy_install_script:main
-register-python-argcomplete = argcomplete.scripts.register_python_argcomplete:main

argcomplete-3.5.2/argcomplete.egg-info/not-zip-safe

@@ -1 +0,0 @@
-

argcomplete-3.5.2/argcomplete.egg-info/requires.txt

@@ -1,7 +0,0 @@
-
-[test]
-coverage
-pexpect
-wheel
-ruff
-mypy

argcomplete-3.5.2/argcomplete.egg-info/top_level.txt

@@ -1 +0,0 @@
-argcomplete

argcomplete-3.5.2/setup.cfg

@@ -1,11 +0,0 @@
-[bdist_rpm]
-provides = python-argcomplete
-doc_files = Authors.rst
-	Changes.rst
-	README.rst
-	LICENSE.rst
-
-[egg_info]
-tag_build = 
-tag_date = 0
-

argcomplete-3.5.2/setup.py

@@ -1,12 +0,0 @@
-#!/usr/bin/env python
-
-from setuptools import find_packages, setup
-
-setup(
-    url="https://github.com/kislyuk/argcomplete",
-    packages=find_packages(exclude=["test", "test.*"]),
-    package_data={"argcomplete": ["bash_completion.d/_python-argcomplete", "py.typed"]},
-    zip_safe=False,
-    include_package_data=True,
-    platforms=["MacOS X", "Posix"],
-)

argcomplete-3.5.2/test/test_package/test_module.py

@@ -1,6 +0,0 @@
-# PYTHON_ARGCOMPLETE_OK
-
-from test_package import main
-
-if __name__ == "__main__":
-    main()

argcomplete-3.5.2/test/test_package/test_package/__init__.py

@@ -1,16 +0,0 @@
-# PYTHON_ARGCOMPLETE_OK
-import argparse
-
-import argcomplete
-
-
-def main():
-    parser = argparse.ArgumentParser()
-    parser.add_argument("arg", choices=["arg"])
-    argcomplete.autocomplete(parser)
-    args = parser.parse_args()
-    print(args.arg)
-
-
-if __name__ == "__main__":
-    main()

argcomplete-3.5.2/test/test_package/test_package.egg-info/PKG-INFO

@@ -1,3 +0,0 @@
-Metadata-Version: 2.1
-Name: test-package
-Version: 0

argcomplete-3.5.2/test/test_package/test_package.egg-info/SOURCES.txt

@@ -1,8 +0,0 @@
-setup.py
-test_module.py
-test_package/__init__.py
-test_package.egg-info/PKG-INFO
-test_package.egg-info/SOURCES.txt
-test_package.egg-info/dependency_links.txt
-test_package.egg-info/entry_points.txt
-test_package.egg-info/top_level.txt

argcomplete-3.5.2/test/test_package/test_package.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

argcomplete-3.5.2/test/test_package/test_package.egg-info/entry_points.txt

@@ -1,3 +0,0 @@
-[console_scripts]
-test-module = test_module:main
-test-package = test_package:main

argcomplete-3.5.2/test/test_package/test_package.egg-info/top_level.txt

@@ -1,2 +0,0 @@
-test_module
-test_package