vim-eof-comment 0.3.11__tar.gz → 0.3.13__tar.gz

vim_eof_comment-0.3.13/.github/workflows/vim-eof-comment.yml

@@ -0,0 +1,40 @@
+# GitHub Actions example
+name: Run vim-eof-comment
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    types:
+      - opened
+    branches:
+      - main
+jobs:
+  vim_eof_comment:
+    name: vim-eof-comment
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+      - name: Set up Python
+        uses: actions/setup-python@v6.1.0
+        with:
+          python-version: '3.10'
+      - name: Install pipenv
+        run: |
+          python -m pip install -U pip
+          pip install pipenv
+      - name: Install vim-eof-comment
+        run: |
+          pipenv install --dev vim-eof-comment
+      - name: Run vim-eof-comment
+        run: |
+          pipenv run vim-eof-comment -e lua,md,Makefile,yaml,toml -i lua:2:Y,md:2:Y -v .
+      - name: Auto Commit Changes
+        uses: stefanzweifel/git-auto-commit-action@v7.1.0
+        with:
+          commit_message: "chore: format files with `vim-eof-comment`"
+          commit_options: "--signoff"
+          branch: ${{ github.head_ref }}

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/Makefile

@@ -43,6 +43,8 @@ lint:
 		vim_eof_comment
 	@pydocstyle --convention=numpy --match='.*\.py' vim_eof_comment
 	@autopep8 --aggressive --aggressive --aggressive --in-place --recursive vim_eof_comment
+	$(eval files := $(shell fd --full-path vim_eof_comment -e py))
+	@numpydoc lint $(files)
 	@echo -e "\nDone!"
 
 stubs: lint

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/PKG-INFO

@@ -1,18 +1,21 @@
 Metadata-Version: 2.4
 Name: vim-eof-comment
-Version: 0.3.11
+Version: 0.3.13
 Summary: Adds Vim EOF comments for given filetypes in given directories
 Author-email: Guennadi Maximov C <g.maxc.fox@protonmail.com>
 Maintainer-email: Guennadi Maximov C <g.maxc.fox@protonmail.com>
 License-Expression: GPL-2.0-only
 Project-URL: Issues, https://github.com/DrKJeff16/vim-eof-comment/issues
 Project-URL: Repository, https://github.com/DrKJeff16/vim-eof-comment
+Project-URL: Download, https://github.com/DrKJeff16/vim-eof-comment/releases/latest
 Keywords: eof comments,eof,files,preprocessing,text,vim modeline,vim,vim-eof
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/Pipfile

@@ -13,6 +13,7 @@ pyproject = "*"
 colorama = "*"
 argcomplete = "*"
 python-magic = "*"
+pynvim = "*"
 
 [dev-packages]
 pynvim = "*"

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/docs/source/conf.py

@@ -22,8 +22,10 @@ release: str = '0.1.33'
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
 extensions: List[str] = [
+    'numpydoc',
     'sphinx.ext.autodoc',
     'sphinx.ext.autosectionlabel',
+    'sphinx.ext.autosummary',
     'sphinx.ext.duration',
 ]
 
@@ -36,4 +38,19 @@ exclude_patterns: List[str] = []
 html_theme: str = 'sphinx_rtd_theme'
 html_static_path: List[str] = ['_static']
 
+# -- Options for numpydoc ----------------------------------------------------
+numpydoc_xref_param_type = True
+numpydoc_validation_checks = {
+    "all",  # report on all checks, except the below
+    "ES01",
+    "EX01",
+    "SA01",
+}
+numpydoc_xref_aliases = {
+    'TextIO': 'typing.TextIO',
+    'List': 'list',
+    'Dict': 'dict',
+    'Tuple': 'tuple',
+}
+
 # vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/docs/source/index.rst

@@ -18,5 +18,5 @@ Contents
 
 .. toctree::
 
-   usage
+   installation
    functions

vim_eof_comment-0.3.13/docs/source/installation.rst

@@ -0,0 +1,14 @@
+Installation
+============
+
+To install *vim-eof-comment*, first install it using ``pip``:
+
+.. code-block:: console
+
+   $ pip install -U vim-eof-comment
+
+You may also use ``pipenv`` or any other virtual environment:
+
+.. code-block:: console
+
+   $ pipenv install vim-eof-comment

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/pyproject.toml

@@ -10,6 +10,8 @@ classifiers = [
     "Intended Audience :: Developers",
     "Intended Audience :: End Users/Desktop",
     "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -45,7 +47,7 @@ maintainers = [{ name = "Guennadi Maximov C", email = "g.maxc.fox@protonmail.com
 name = "vim-eof-comment"
 readme = "README.md"
 requires-python = ">=3.10"
-version = "0.3.11"
+version = "0.3.13"
 
     [project.scripts]
     vim-eof-comment = "vim_eof_comment.eof:main"
@@ -53,13 +55,14 @@ version = "0.3.11"
     [project.urls]
     Issues     = "https://github.com/DrKJeff16/vim-eof-comment/issues"
     Repository = "https://github.com/DrKJeff16/vim-eof-comment"
+    Download   = "https://github.com/DrKJeff16/vim-eof-comment/releases/latest"
 
 [tool.numpydoc_validation]
 checks = [
+    "all",  # report on all checks, except the below
     "ES01",
     "EX01",
     "SA01",
-    "all",  # report on all checks, except the below
 ]
 exclude = [
     '\.undocumented_method$',

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/requirements.txt

@@ -2,7 +2,11 @@
 argcomplete==3.6.3; python_version >= '3.8'
 argparse==1.4.0
 colorama==0.4.6; python_version >= '2.7' and python_version not in '3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 3.6'
+greenlet==3.3.0; python_version >= '3.10'
+msgpack==1.1.2; python_version >= '3.9'
+pynvim==0.6.0; python_version >= '3.7'
 pyproject==1!0.1.2; python_version >= '3.12'
+python-magic==0.4.27; python_version >= '2.7' and python_version not in '3.0, 3.1, 3.2, 3.3, 3.4'
 setuptools==80.9.0; python_version >= '3.9'
 typing==3.7.4.3; python_version >= '2.7' and python_version not in '3.0, 3.1, 3.2, 3.3'
 typing-extensions==4.15.0; python_version >= '3.9'

vim_eof_comment-0.3.13/version.txt

@@ -0,0 +1 @@
+0.3.13

vim_eof_comment-0.3.13/vim_eof_comment/args/completion.py

@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+# Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
+"""
+Argument parsing completion utilities for ``vim-eof-comment``.
+
+Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
+"""
+__all__ = ["complete_parser"]
+
+from argparse import ArgumentParser
+from typing import List, NoReturn
+
+from argcomplete import autocomplete
+
+
+def complete_validator(completion_candidate: List[str], current_input: str) -> bool:
+    """
+    Complete non-prefix substring matches.
+
+    Parameters
+    ----------
+    completion_candidate : List[str]
+        All the completion candidates.
+    current_input : str
+        The current input string.
+
+    Returns
+    -------
+    bool
+        Whether the current input fits the completion candidates pool.
+    """
+    return current_input in completion_candidate
+
+
+def complete_parser(parser: ArgumentParser, **kwargs) -> NoReturn:
+    """
+    Complete the script argument parser.
+
+    Parameters
+    ----------
+    parser : argparse.ArgumentParser
+        The ``ArgumentParser`` object.
+    **kwargs
+        Extra parameters to be passed to ``argcomplete.autocomplete()``.
+    """
+    autocomplete(parser, validator=complete_validator, **kwargs)
+
+# vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/vim_eof_comment/args/completion.pyi

@@ -12,7 +12,7 @@ def complete_parser(parser: ArgumentParser, **kwargs) -> NoReturn:
     parser : argparse.ArgumentParser
         The ``ArgumentParser`` object.
     **kwargs
-        Extra parameters.
+        Extra parameters to be passed to ``argcomplete.autocomplete()``.
     """
 
 # vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/vim_eof_comment/comments/generator.py

@@ -13,11 +13,20 @@ from io import TextIOWrapper
 from os.path import exists, isdir, realpath
 from typing import Dict, Iterator, List, NoReturn, Tuple
 
+from colorama import Fore, Style
+from colorama import init as color_init
+
 from ..types import IndentMap
 from ..util import die
 
 _JSON_FILE: str = realpath("./vim_eof_comment/comments/filetypes.json")
 
+_BLUE: int = Fore.BLUE
+_YELLOW: int = Fore.YELLOW
+_CYAN: int = Fore.CYAN
+_BRIGHT: int = Style.BRIGHT
+_RESET: int = Style.RESET_ALL
+
 
 def import_json() -> Tuple[Dict[str, str], Dict[str, IndentMap]]:
     """
@@ -195,15 +204,48 @@ class Comments():
         return comments.get(ext, None)
 
 
+def generate_list_items(ft: str, level: int, expandtab: str) -> str:
+    """
+    Generate a colored string for filetypes listing.
+
+    Parameters
+    ----------
+    ft : str
+        The filetype item in question.
+    level : int
+        Indent size.
+    expandtab : str
+        Either ``"Yes"`` or ``"No"``.
+
+    Returns
+    -------
+    str
+        The generated string.
+    """
+    txt = f"{_RESET}{_BRIGHT}{_BLUE}{ft}\n"
+    txt += f"   {_RESET}{_BRIGHT}indent size{_RESET}{_BRIGHT} ==> {_CYAN}{level}\n"
+    txt += f"   {_RESET}{_BRIGHT}expandtab{_RESET}{_BRIGHT} ==> {_CYAN}{expandtab}"
+
+    return txt
+
+
 def list_filetypes() -> NoReturn:
     """List all available filetypes."""
-    txt: List[str] = [""]
+    color_init()
+
+    defaults = Comments().get_defaults()
+    items: Dict[str, Tuple[int, str]] = dict()
+    for ft_ext, indents in defaults.items():
+        level: int = indents.get("level", 4)
+        et = "Yes" if indents.get("expandtab") else "No"
+        items[ft_ext] = (level, et)
+
+    keys: List[str] = list(items.keys())
+    keys.sort()
 
-    c: Comments = Comments()
-    defaults: Dict[str, IndentMap] = c.get_defaults()
-    for ext, indents in defaults.items():
-        txt.append(f"- {ext}: {indents}")
+    sorted_items: Dict[str, Tuple[int, str]] = {i: items[i] for i in keys}
 
+    txt = [generate_list_items(k, v[0], v[1]) for k, v in sorted_items.items()]
     die(*txt, code=0, sep="\n")
 
 

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/vim_eof_comment/eof.py

@@ -19,8 +19,8 @@ from .comments.generator import Comments, list_filetypes
 from .file import bootstrap_paths, get_last_line, modify_file, open_batch_paths
 from .regex import matches
 from .types import BatchPathDict, EOFCommentSearch, IndentHandler, IOWrapperBool
-from .util import die, gen_indent_maps, verbose_print, version_print
-from .version import __version__, list_versions
+from .util import die, gen_indent_maps, verbose_print
+from .version import __version__, list_versions, version_print
 
 _RED: int = Fore.LIGHTRED_EX
 _GREEN: int = Fore.LIGHTGREEN_EX

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/vim_eof_comment/regex.py

@@ -11,7 +11,7 @@ from re import compile
 from typing import Tuple
 
 
-def matches(s: str, verbose: bool) -> bool:
+def matches(s: str, verbose: bool = False) -> bool:
     """
     Check if given string matches any of the given patterns.
 
@@ -19,7 +19,7 @@ def matches(s: str, verbose: bool) -> bool:
     ----------
     s : str
         The string to be matched.
-    verbose : bool
+    verbose : bool, optional, default=False
         Enables verbose mode.
 
     Returns

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/vim_eof_comment/regex.pyi

@@ -1,6 +1,6 @@
 __all__ = ['matches']
 
-def matches(s: str, verbose: bool) -> bool:
+def matches(s: str, verbose: bool = False) -> bool:
     """
     Check if given string matches any of the given patterns.
 
@@ -8,7 +8,7 @@ def matches(s: str, verbose: bool) -> bool:
     ----------
     s : str
         The string to be matched.
-    verbose : bool
+    verbose : bool, optional, default=False
         Enables verbose mode.
 
     Returns

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/vim_eof_comment/types.py

@@ -32,15 +32,15 @@ class ParserSpec(TypedDict):
     ----------
     opts : List[str]
         A list containing all the relevant iterations of the same option.
-    kwargs : Dict[str, str]
+    kwargs : Dict[str, Any]
         Extra arguments for ``argparse.ArgumentParser``.
-    completer : argcomplete.DirectoriesCompleter, optional, default=None
-        An optional ``argcomplete`` completer object.
+    completer : argcomplete.DirectoriesCompleter
+        An ``argcomplete`` completer object.
     """
 
     opts: List[str]
     kwargs: Dict[str, Any]
-    completer: DirectoriesCompleter | None
+    completer: DirectoriesCompleter
 
 
 class CommentMap(TypedDict):
@@ -59,7 +59,18 @@ class CommentMap(TypedDict):
 
 
 class IndentMap(TypedDict):
-    """A ``TypedDict`` container."""
+    """
+    A dict containing ``level`` and ``expandtab`` as keys.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    level : int
+        The indent level.
+    expandtab : bool
+        Whether to expand tabs or not.
+    """
 
     level: int
     expandtab: bool
@@ -69,6 +80,8 @@ class IndentHandler(TypedDict):
     """
     A dict containing ``ft_ext``, ``level`` and ``expandtab`` as keys.
 
+    This is a ``TypedDict``-like object.
+
     Attributes
     ----------
     ft_ext : str
@@ -85,35 +98,92 @@ class IndentHandler(TypedDict):
 
 
 class IOWrapperBool(TypedDict):
-    """A ``TypedDict`` container."""
+    """
+    A dict containing ``file`` and ``has_nwl`` as keys.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    file : TextIO
+        The opened file as a ``TextIO`` wrapper.
+    has_nwl : bool
+        Whether the file has a newline or not.
+    """
 
     file: TextIO
     has_nwl: bool
 
 
 class LineBool(TypedDict):
-    """A ``TypedDict`` container."""
+    """
+    A dict containing ``line`` and ``has_nwl`` as keys.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    line : str
+        The last line of the target file.
+    has_nwl : bool
+        Whether the file has a newline or not.
+    """
 
     line: str
     has_nwl: bool
 
 
 class BatchPathDict(TypedDict):
-    """A ``TypedDict`` container."""
+    """
+    A dict containing ``file`` and ``ft_ext`` as keys.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    file : TextIO
+        The opened file as a ``TextIO`` wrapper.
+    ft_ext : str
+        The file-type/file-extension.
+    """
 
     file: TextIO
     ft_ext: str
 
 
 class BatchPairDict(TypedDict):
-    """A ``TypedDict`` container."""
+    """
+    A dict containing ``fpath`` and ``ft_ext`` as keys.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    fpath : str
+        The target file's path.
+    ft_ext : str
+        The file-type/file-extension.
+    """
 
     fpath: str
     ft_ext: str
 
 
 class EOFCommentSearch(TypedDict):
-    """A ``TypedDict`` container."""
+    """
+    A dict containing ``state``, ``lang`` and ``match`` as keys.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    state : IOWrapperBool
+        The target ``IOWrapperBool`` object.
+    lang : str
+        The file language.
+    match : bool
+        Whether it has a variation of an EOF comment at the end.
+    """
 
     state: IOWrapperBool
     lang: str

vim_eof_comment-0.3.13/vim_eof_comment/types.pyi

@@ -0,0 +1,157 @@
+from typing import Any, TextIO, TypedDict
+
+from argcomplete.completers import DirectoriesCompleter
+
+__all__ = ['BatchPairDict', 'BatchPathDict', 'CommentMap', 'EOFCommentSearch', 'IOWrapperBool', 'IndentHandler', 'IndentMap', 'LineBool', 'ParserSpec']
+
+class ParserSpec(TypedDict):
+    """
+    Stores the spec for ``argparse`` operations in a constant value.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    opts : List[str]
+        A list containing all the relevant iterations of the same option.
+    kwargs : Dict[str, Any]
+        Extra arguments for ``argparse.ArgumentParser``.
+    completer : argcomplete.DirectoriesCompleter
+        An ``argcomplete`` completer object.
+    """
+    opts: list[str]
+    kwargs: dict[str, Any]
+    completer: DirectoriesCompleter
+
+class CommentMap(TypedDict):
+    """
+    Stores a dict with a ``level`` key.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    level : int
+        The indentation level.
+    """
+    level: int
+
+class IndentMap(TypedDict):
+    """
+    A dict containing ``level`` and ``expandtab`` as keys.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    level : int
+        The indent level.
+    expandtab : bool
+        Whether to expand tabs or not.
+    """
+    level: int
+    expandtab: bool
+
+class IndentHandler(TypedDict):
+    """
+    A dict containing ``ft_ext``, ``level`` and ``expandtab`` as keys.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    ft_ext : str
+        The file-extension/file-type.
+    level : str
+        The string representation of the indent level.
+    expandtab : bool
+        Whether to expand tabs or not.
+    """
+    ft_ext: str
+    level: str
+    expandtab: bool
+
+class IOWrapperBool(TypedDict):
+    """
+    A dict containing ``file`` and ``has_nwl`` as keys.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    file : TextIO
+        The opened file as a ``TextIO`` wrapper.
+    has_nwl : bool
+        Whether the file has a newline or not.
+    """
+    file: TextIO
+    has_nwl: bool
+
+class LineBool(TypedDict):
+    """
+    A dict containing ``line`` and ``has_nwl`` as keys.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    line : str
+        The last line of the target file.
+    has_nwl : bool
+        Whether the file has a newline or not.
+    """
+    line: str
+    has_nwl: bool
+
+class BatchPathDict(TypedDict):
+    """
+    A dict containing ``file`` and ``ft_ext`` as keys.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    file : TextIO
+        The opened file as a ``TextIO`` wrapper.
+    ft_ext : str
+        The file-type/file-extension.
+    """
+    file: TextIO
+    ft_ext: str
+
+class BatchPairDict(TypedDict):
+    """
+    A dict containing ``fpath`` and ``ft_ext`` as keys.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    fpath : str
+        The target file's path.
+    ft_ext : str
+        The file-type/file-extension.
+    """
+    fpath: str
+    ft_ext: str
+
+class EOFCommentSearch(TypedDict):
+    """
+    A dict containing ``state``, ``lang`` and ``match`` as keys.
+
+    This is a ``TypedDict``-like object.
+
+    Attributes
+    ----------
+    state : IOWrapperBool
+        The target ``IOWrapperBool`` object.
+    lang : str
+        The file language.
+    match : bool
+        Whether it has a variation of an EOF comment at the end.
+    """
+    state: IOWrapperBool
+    lang: str
+    match: bool
+
+# vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/vim_eof_comment/util.py

@@ -5,7 +5,7 @@ EOF comments checker utilities.
 
 Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
 """
-__all__ = ["die", "error", "gen_indent_maps", "verbose_print", "version_print"]
+__all__ = ["die", "error", "gen_indent_maps", "verbose_print"]
 
 from sys import exit as Exit
 from sys import stderr, stdout
@@ -117,22 +117,6 @@ def verbose_print(*msg, verbose: bool | None = None, **kwargs) -> NoReturn:
     print(*msg, end=end, sep=sep, flush=flush)
 
 
-def version_print(version: str) -> NoReturn:
-    """
-    Print project version, then exit.
-
-    Parameters
-    ----------
-    version : str
-        The version string.
-
-    See Also
-    --------
-    vim_eof_comment.util.die : The function used for this function.
-    """
-    die(f"vim-eof-comment-{version}", code=0)
-
-
 def gen_indent_maps(maps: List[IndentHandler]) -> Dict[str, IndentMap] | None:
     """
     Generate a dictionary from the custom indent maps.

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/vim_eof_comment/util.pyi

@@ -2,7 +2,7 @@ from typing import Callable, NoReturn, TextIO
 
 from .types import IndentHandler, IndentMap
 
-__all__ = ['die', 'error', 'gen_indent_maps', 'verbose_print', 'version_print']
+__all__ = ['die', 'error', 'gen_indent_maps', 'verbose_print']
 
 def error(*msg, **kwargs) -> NoReturn:
     """
@@ -77,19 +77,6 @@ def verbose_print(*msg, verbose: bool | None = None, **kwargs) -> NoReturn:
     --------
     print : This function is essentially being wrapped around here.
     """
-def version_print(version: str) -> NoReturn:
-    """
-    Print project version, then exit.
-
-    Parameters
-    ----------
-    version : str
-        The version string.
-
-    See Also
-    --------
-    vim_eof_comment.util.die : The function used for this function.
-    """
 def gen_indent_maps(maps: list[IndentHandler]) -> dict[str, IndentMap] | None:
     """
     Generate a dictionary from the custom indent maps.

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/vim_eof_comment/version.py

@@ -5,7 +5,7 @@ Custom vim-eof-comment versioning objects.
 
 Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
 """
-__all__ = ["VersionInfo", "list_versions", "version_info", "__version__"]
+__all__ = ["VersionInfo", "list_versions", "version_info", "version_print", "__version__"]
 
 from typing import List, NoReturn, Tuple
 
@@ -103,7 +103,7 @@ class VersionInfo():
         Only one definition in constructor.
 
         >>> from vim_eof_comment.version import VersionInfo
-        >>> print(VersionInfo([(0, 0, 1)]))
+        >>> print(repr(VersionInfo([(0, 0, 1)])))
         0.0.1
 
         Multiple definitions in constructor.
@@ -163,7 +163,7 @@ class VersionInfo():
         return result
 
 
-version_info: VersionInfo = VersionInfo([
+version_info = VersionInfo([
     (0, 1, 1),
     (0, 1, 2),
     (0, 1, 3),
@@ -218,6 +218,8 @@ version_info: VersionInfo = VersionInfo([
     (0, 3, 9),
     (0, 3, 10),
     (0, 3, 11),
+    (0, 3, 12),
+    (0, 3, 13),
 ])
 
 __version__: str = str(version_info)
@@ -225,7 +227,18 @@ __version__: str = str(version_info)
 
 def list_versions() -> NoReturn:
     """List all versions."""
-    all_versions: str = version_info.get_all_versions()
-    die(all_versions, code=0)
+    die(version_info.get_all_versions(), code=0)
+
+
+def version_print(version: str) -> NoReturn:
+    """
+    Print project version, then exit.
+
+    Parameters
+    ----------
+    version : str
+        The version string.
+    """
+    die(f"vim-eof-comment-{version}", code=0)
 
 # vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/vim_eof_comment/version.pyi

@@ -1,6 +1,8 @@
 from typing import NoReturn
 
-__all__ = ['VersionInfo', 'list_versions', 'version_info', '__version__']
+from _typeshed import Incomplete
+
+__all__ = ['VersionInfo', 'list_versions', 'version_info', 'version_print', '__version__']
 
 class VersionInfo:
     """
@@ -82,7 +84,7 @@ class VersionInfo:
         Only one definition in constructor.
 
         >>> from vim_eof_comment.version import VersionInfo
-        >>> print(VersionInfo([(0, 0, 1)]))
+        >>> print(repr(VersionInfo([(0, 0, 1)])))
         0.0.1
 
         Multiple definitions in constructor.
@@ -124,10 +126,19 @@ class VersionInfo:
         0.0.3 (latest)
         """
 
-version_info: VersionInfo
+version_info: Incomplete
 __version__: str
 
 def list_versions() -> NoReturn:
     """List all versions."""
+def version_print(version: str) -> NoReturn:
+    """
+    Print project version, then exit.
+
+    Parameters
+    ----------
+    version : str
+        The version string.
+    """
 
 # vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/vim_eof_comment.egg-info/PKG-INFO

@@ -1,18 +1,21 @@
 Metadata-Version: 2.4
 Name: vim-eof-comment
-Version: 0.3.11
+Version: 0.3.13
 Summary: Adds Vim EOF comments for given filetypes in given directories
 Author-email: Guennadi Maximov C <g.maxc.fox@protonmail.com>
 Maintainer-email: Guennadi Maximov C <g.maxc.fox@protonmail.com>
 License-Expression: GPL-2.0-only
 Project-URL: Issues, https://github.com/DrKJeff16/vim-eof-comment/issues
 Project-URL: Repository, https://github.com/DrKJeff16/vim-eof-comment
+Project-URL: Download, https://github.com/DrKJeff16/vim-eof-comment/releases/latest
 Keywords: eof comments,eof,files,preprocessing,text,vim modeline,vim,vim-eof
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12

{vim_eof_comment-0.3.11 → vim_eof_comment-0.3.13}/vim_eof_comment.egg-info/SOURCES.txt

@@ -1,24 +1,25 @@
 .flake8
 .gitattributes
 .pre-commit-config.yaml
-.taplo.toml
 LICENSE
 Makefile
 Pipfile
 README.md
 pyproject.toml
 requirements.txt
+taplo.toml
 version.txt
 .github/CODEOWNERS
 .github/workflows/flake8-lint.yml
 .github/workflows/mypy-lint.yml
 .github/workflows/release.yml
+.github/workflows/vim-eof-comment.yml
 docs/Makefile
 docs/make.bat
 docs/source/conf.py
 docs/source/functions.rst
 docs/source/index.rst
-docs/source/usage.rst
+docs/source/installation.rst
 vim_eof_comment/__init__.py
 vim_eof_comment/__init__.pyi
 vim_eof_comment/__main__.py

vim_eof_comment-0.3.11/docs/source/usage.rst

@@ -1,11 +0,0 @@
-Usage
-=====
-
-Installation
-------------
-
-To use *vim-eof-comment*, first install it using `pip`:
-
-.. code-block:: console
-
-   $ pip install vim-eof-comment

vim_eof_comment-0.3.11/version.txt

@@ -1 +0,0 @@
-0.3.11

vim_eof_comment-0.3.11/vim_eof_comment/args/completion.py

@@ -1,30 +0,0 @@
-# -*- coding: utf-8 -*-
-# Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
-"""
-Argument parsing completion utilities for ``vim-eof-comment``.
-
-Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
-"""
-__all__ = ["complete_parser"]
-
-from argparse import ArgumentParser
-from typing import NoReturn
-
-from argcomplete import autocomplete
-from argcomplete.finders import default_validator
-
-
-def complete_parser(parser: ArgumentParser, **kwargs) -> NoReturn:
-    """
-    Complete the script argument parser.
-
-    Parameters
-    ----------
-    parser : argparse.ArgumentParser
-        The ``ArgumentParser`` object.
-    **kwargs
-        Extra parameters.
-    """
-    autocomplete(parser, validator=default_validator, **kwargs)
-
-# vim: set ts=4 sts=4 sw=4 et ai si sta:

vim_eof_comment-0.3.11/vim_eof_comment/types.pyi

@@ -1,87 +0,0 @@
-from typing import Any, TextIO, TypedDict
-
-from argcomplete.completers import DirectoriesCompleter
-
-__all__ = ['BatchPairDict', 'BatchPathDict', 'CommentMap', 'EOFCommentSearch', 'IOWrapperBool', 'IndentHandler', 'IndentMap', 'LineBool', 'ParserSpec']
-
-class ParserSpec(TypedDict):
-    """
-    Stores the spec for ``argparse`` operations in a constant value.
-
-    This is a ``TypedDict``-like object.
-
-    Attributes
-    ----------
-    opts : List[str]
-        A list containing all the relevant iterations of the same option.
-    kwargs : Dict[str, str]
-        Extra arguments for ``argparse.ArgumentParser``.
-    completer : argcomplete.DirectoriesCompleter, optional, default=None
-        An optional ``argcomplete`` completer object.
-    """
-    opts: list[str]
-    kwargs: dict[str, Any]
-    completer: DirectoriesCompleter | None
-
-class CommentMap(TypedDict):
-    """
-    Stores a dict with a ``level`` key.
-
-    This is a ``TypedDict``-like object.
-
-    Attributes
-    ----------
-    level : int
-        The indentation level.
-    """
-    level: int
-
-class IndentMap(TypedDict):
-    """A ``TypedDict`` container."""
-    level: int
-    expandtab: bool
-
-class IndentHandler(TypedDict):
-    """
-    A dict containing ``ft_ext``, ``level`` and ``expandtab`` as keys.
-
-    Attributes
-    ----------
-    ft_ext : str
-        The file-extension/file-type.
-    level : str
-        The string representation of the indent level.
-    expandtab : bool
-        Whether to expand tabs or not.
-    """
-    ft_ext: str
-    level: str
-    expandtab: bool
-
-class IOWrapperBool(TypedDict):
-    """A ``TypedDict`` container."""
-    file: TextIO
-    has_nwl: bool
-
-class LineBool(TypedDict):
-    """A ``TypedDict`` container."""
-    line: str
-    has_nwl: bool
-
-class BatchPathDict(TypedDict):
-    """A ``TypedDict`` container."""
-    file: TextIO
-    ft_ext: str
-
-class BatchPairDict(TypedDict):
-    """A ``TypedDict`` container."""
-    fpath: str
-    ft_ext: str
-
-class EOFCommentSearch(TypedDict):
-    """A ``TypedDict`` container."""
-    state: IOWrapperBool
-    lang: str
-    match: bool
-
-# vim: set ts=4 sts=4 sw=4 et ai si sta: