vim-eof-comment 0.6.2__tar.gz → 0.7.1__tar.gz

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/.pre-commit-config.yaml

@@ -18,19 +18,12 @@ repos:
         verbose: true
   - repo: local
     hooks:
-      - id: lint
-        name: Lint Script
+      - id: build
+        name: Build and run project
         language: system
+        entry: make
+        always_run: true
         types: [python]
-        files: ^(vim_eof_comment/.*\.pyi?|Makefile)$
-        entry: make lint
-        verbose: true
-      - id: run_script
-        name: Install and Run Script Locally
-        language: system
-        types: [python]
-        files: ^(vim_eof_comment/.*\.py|Makefile)$
-        entry: make run-script
         verbose: true
 
 # vim: set ts=2 sts=2 sw=2 et ai si sta:

vim_eof_comment-0.7.1/Makefile

@@ -0,0 +1,66 @@
+.PHONY: all help lint build local-install clean run-script docs format
+
+all: run-script
+
+clean: ## Clean built files
+	@echo "Cleaning..."
+	@rm -rf build dist *.egg-info
+	@echo "Done!"
+
+distclean: clean ## Clean everything
+	@echo "Cleaning Everything..."
+	@rm -rf .mypy_cache .ropeproject .pytest_cache .ruff_cache
+	@echo "Done!"
+
+docs: ## Generate Sphinx docs
+	@echo "Generating docs..."
+	@$(MAKE) -C docs html
+	@echo "Done!"
+
+help: ## Show help
+	@echo -e "Usage: make [target]\n\nAvailable targets:"
+	@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf "  %-15s %s\n", $$1, $$2}' $(MAKEFILE_LIST)
+	@echo
+
+lint: ## Lint files
+	@echo "Running flake8..."
+	@pipenv run flake8 vim_eof_comment
+	@echo -e "Done!\n\nRunning pydocstyle..."
+	@pipenv run pydocstyle --convention=numpy --match='.*\.py' vim_eof_comment
+	$(eval files := $(shell fd --full-path vim_eof_comment -e py))
+	@echo -e "Done!\n\nLinting with numpydoc..."
+	@pipenv run numpydoc lint $(files)
+	@echo "Done!"
+
+stubs: lint ## Generate mypy stubs
+	@echo "Generating stubs..."
+	@pipenv run stubgen --include-docstrings --include-private -v -p vim_eof_comment -o .
+	@echo -e "Done!\n\nRunning isort..."
+	@pipenv run isort vim_eof_comment
+	@echo -e "Done!\n\nChecking typing with mypy..."
+	@pipenv run mypy vim_eof_comment
+	@echo "Done!"
+
+format: stubs ## Format using Ruff
+	@echo "Formatting with Ruff..."
+	@pipenv run ruff format vim_eof_comment
+	@echo -e "Done!\n\nChecking with Ruff..."
+	@pipenv run ruff check vim_eof_comment
+	@echo "Done!"
+
+build: format ## Build project
+	@echo "Building..."
+	@pipenv run python -m build
+	@echo "Done!"
+
+local-install: build ## Install project in current pipenv virtual environment
+	@echo "Installing locally..."
+	@pipenv run python -m pip install .
+	@echo "Done!"
+
+run-script: local-install ## Run the built project
+	@echo "Running vim-eof-comment..."
+	@pipenv run vim-eof-comment -e py,pyi,Makefile,md,yaml,yml,toml -nv .
+	@echo "Done!"
+
+# vim: set ts=4 sts=4 sw=0 noet ai si sta:

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vim-eof-comment
-Version: 0.6.2
+Version: 0.7.1
 Summary: Adds Vim EOF modeline 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>

vim_eof_comment-0.7.1/Pipfile

@@ -0,0 +1,42 @@
+[[source]]
+url = "https://pypi.org/simple"
+verify_ssl = true
+name = "pypi"
+
+[packages]
+argparse = "*"
+colorama = "*"
+argcomplete = "*"
+
+[dev-packages]
+pyproject = "*"
+setuptools = "*"
+wheel = "*"
+pynvim = "*"
+build = "*"
+pre-commit = "*"
+furo = "*"
+sphinx-rtd-theme = "*"
+renku-sphinx-theme = "*"
+sphinxawesome-theme = "*"
+numpydoc = "*"
+vim-eof-comment = "*"
+pip = "*"
+update-version = "*"
+python-lsp-server = {extras = ["all"], version = "*"}
+pylsp-mypy = "*"
+pylsp-rope = "*"
+python-lsp-isort = "*"
+mypy = "*"
+mypy-extensions = "*"
+ruff = "*"
+
+[scripts]
+lint = "flake8 --statistics --show-source --color always --max-line-length 100 --docstring-convention numpy --ignore=D401 ."
+build = "python3 -m build"
+local-install = "python3 -m pip install ."
+install = "python3 -m pip install"
+stubs = "stubgen -p vim_eof_comment -o ."
+
+[requires]
+python_version = "3.14"

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/docs/source/conf.py

@@ -8,35 +8,35 @@ import sys
 from pathlib import Path
 from typing import List
 
-sys.path.insert(0, str(Path('..', 'src').resolve()))
+sys.path.insert(0, str(Path("..", "src").resolve()))
 
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-project: str = 'vim-eof-comment'
-copyright: str = '2025, Guennadi Maximov C'
-author: str = 'Guennadi Maximov C'
-release: str = '0.1.33'
+project: str = "vim-eof-comment"
+copyright: str = "2025, Guennadi Maximov C"
+author: str = "Guennadi Maximov C"
+release: str = "0.1.33"
 
 # -- General configuration ---------------------------------------------------
 # 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',
+    "numpydoc",
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosectionlabel",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.duration",
 ]
 
-templates_path: List[str] = ['_templates']
+templates_path: List[str] = ["_templates"]
 exclude_patterns: List[str] = []
 
 # -- Options for HTML output -------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
-html_theme: str = 'sphinx_rtd_theme'
-html_static_path: List[str] = ['_static']
+html_theme: str = "sphinx_rtd_theme"
+html_static_path: List[str] = ["_static"]
 
 # -- Options for numpydoc ----------------------------------------------------
 numpydoc_xref_param_type = True
@@ -47,10 +47,10 @@ numpydoc_validation_checks = {
     "SA01",
 }
 numpydoc_xref_aliases = {
-    'TextIO': 'typing.TextIO',
-    'List': 'list',
-    'Dict': 'dict',
-    'Tuple': 'tuple',
+    "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.6.2 → vim_eof_comment-0.7.1}/pyproject.toml

@@ -40,10 +40,10 @@ maintainers = [{ name = "Guennadi Maximov C", email = "g.maxc.fox@protonmail.com
 name = "vim-eof-comment"
 readme = "README.md"
 requires-python = ">=3.10"
-version = "0.6.2"
+version = "0.7.1"
 
     [project.scripts]
-    vim-eof-comment = "vim_eof_comment.eof:main"
+    vim-eof-comment = "vim_eof_comment.main:main"
 
     [project.urls]
     Download   = "https://github.com/DrKJeff16/vim-eof-comment/releases/latest"
@@ -127,4 +127,10 @@ save_objectdb = true
 split_imports = false
 validate_objectdb = true
 
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint.pydocstyle]
+convention = "numpy"
+
 # vim: set ts=4 sts=4 sw=4 et ai si sta:

vim_eof_comment-0.7.1/version.txt

@@ -0,0 +1 @@
+0.7.1

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/__init__.py

@@ -5,11 +5,13 @@ Ensure EOF Vim comments.
 
 Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
 """
+
 __all__ = [
     "__version__",
+    "append_eof_comment",
     "args",
     "comments",
-    "eof",
+    "eof_comment_search",
     "file",
     "main",
     "regex",
@@ -18,8 +20,8 @@ __all__ = [
     "version",
 ]
 
-from . import args, comments, eof, file, regex, types, util
-from .eof import main
+from . import args, comments, file, regex, types, util, version
+from .main import append_eof_comment, eof_comment_search, main
 from .version import __version__
 
 # vim: set ts=4 sts=4 sw=4 et ai si sta:

vim_eof_comment-0.7.1/vim_eof_comment/__init__.pyi

@@ -0,0 +1,27 @@
+from . import args as args
+from . import comments as comments
+from . import file as file
+from . import regex as regex
+from . import types as types
+from . import util as util
+from . import version as version
+from .main import append_eof_comment as append_eof_comment
+from .main import eof_comment_search as eof_comment_search
+from .main import main as main
+from .version import __version__ as __version__
+
+__all__ = [
+    "__version__",
+    "append_eof_comment",
+    "args",
+    "comments",
+    "eof_comment_search",
+    "file",
+    "main",
+    "regex",
+    "types",
+    "util",
+    "version",
+]
+
+# vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/__main__.py

@@ -6,9 +6,10 @@ Main entrypoint for `vim-eof-comment`.
 
 Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
 """
+
 import sys
 
-from .eof import main
+from .main import main
 
 if __name__ == "__main__":
     sys.exit(main())

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/args/__init__.py

@@ -5,6 +5,7 @@ Argument parsing utilities for `vim-eof-comment`.
 
 Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
 """
+
 __all__ = ["completion", "parsing"]
 
 from . import completion, parsing

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/args/__init__.pyi

@@ -1,6 +1,6 @@
 from . import completion as completion
 from . import parsing as parsing
 
-__all__ = ['completion', 'parsing']
+__all__ = ["completion", "parsing"]
 
 # vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/args/completion.py

@@ -5,6 +5,7 @@ Argument parsing completion utilities for ``vim-eof-comment``.
 
 Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
 """
+
 __all__ = ["complete_parser", "complete_validator"]
 
 from argparse import ArgumentParser
@@ -45,4 +46,5 @@ def complete_parser(parser: ArgumentParser, **kwargs) -> None:
     """
     autocomplete(parser, validator=complete_validator, **kwargs)
 
+
 # vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/args/completion.pyi

@@ -1,6 +1,6 @@
 from argparse import ArgumentParser
 
-__all__ = ['complete_parser', 'complete_validator']
+__all__ = ["complete_parser", "complete_validator"]
 
 def complete_validator(completion_candidate: list[str], current_input: str) -> bool:
     """
@@ -18,6 +18,7 @@ def complete_validator(completion_candidate: list[str], current_input: str) -> b
     bool
         Whether the current input fits the completion candidates pool.
     """
+
 def complete_parser(parser: ArgumentParser, **kwargs) -> None:
     """
     Complete the script argument parser.

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/args/parsing.py

@@ -5,6 +5,7 @@ Argument parsing utilities for ``vim-eof-comment``.
 
 Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
 """
+
 __all__ = ["gen_parser_specs", "bootstrap_args", "arg_parser_init", "indent_handler"]
 
 from argparse import ArgumentDefaultsHelpFormatter, ArgumentError, ArgumentParser, Namespace
@@ -90,7 +91,7 @@ def arg_parser_init(prog: str = "vim-eof-comment") -> Tuple[ArgumentParser, Name
         exit_on_error=False,
         formatter_class=ArgumentDefaultsHelpFormatter,
         add_help=True,
-        allow_abbrev=True
+        allow_abbrev=True,
     )
     spec: List[ParserSpec] = gen_parser_specs(
         {
@@ -168,7 +169,7 @@ def arg_parser_init(prog: str = "vim-eof-comment") -> Tuple[ArgumentParser, Name
             "kwargs": {
                 "required": False,
                 "metavar": "EXT1[,EXT2[,EXT3[,...]]]",
-                "help": "A comma-separated list of file extensions (e.g. \"lua,c,cpp,cc,c++\")",
+                "help": 'A comma-separated list of file extensions (e.g. "lua,c,cpp,cc,c++")',
                 "dest": "exts",
             },
         },
@@ -224,4 +225,5 @@ def indent_handler(indent: str) -> List[IndentHandler]:
 
     return maps
 
+
 # vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/args/parsing.pyi

@@ -2,7 +2,7 @@ from argparse import ArgumentParser, Namespace
 
 from ..types import IndentHandler, ParserSpec
 
-__all__ = ['gen_parser_specs', 'bootstrap_args', 'arg_parser_init', 'indent_handler']
+__all__ = ["gen_parser_specs", "bootstrap_args", "arg_parser_init", "indent_handler"]
 
 def gen_parser_specs(*specs) -> list[ParserSpec]:
     """
@@ -18,6 +18,7 @@ def gen_parser_specs(*specs) -> list[ParserSpec]:
     List[ParserSpec]
         The converted dictionaries inside a list.
     """
+
 def bootstrap_args(parser: ArgumentParser, specs: list[ParserSpec]) -> Namespace:
     """
     Bootstrap the program arguments.
@@ -34,8 +35,9 @@ def bootstrap_args(parser: ArgumentParser, specs: list[ParserSpec]) -> Namespace
     argparse.Namespace
         The generated ``argparse.Namespace`` object.
     """
-def arg_parser_init(prog: str = 'vim-eof-comment') -> tuple[ArgumentParser, Namespace]:
-    '''
+
+def arg_parser_init(prog: str = "vim-eof-comment") -> tuple[ArgumentParser, Namespace]:
+    """
     Generate the argparse namespace.
 
     Parameters
@@ -49,7 +51,8 @@ def arg_parser_init(prog: str = 'vim-eof-comment') -> tuple[ArgumentParser, Name
         The generated ``argparse.ArgumentParser`` object.
     namespace : argparse.Namespace
         The generated ``argparse.Namespace`` object.
-    '''
+    """
+
 def indent_handler(indent: str) -> list[IndentHandler]:
     """
     Parse indent levels defined by the user.

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/comments/__init__.py

@@ -5,6 +5,7 @@ Comment class module for ``vim-eof-comment``.
 
 Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
 """
+
 __all__ = ["generator"]
 
 from . import generator

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/comments/__init__.pyi

@@ -1,5 +1,5 @@
 from . import generator as generator
 
-__all__ = ['generator']
+__all__ = ["generator"]
 
 # vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/comments/generator.py

@@ -5,11 +5,10 @@ Per-filetype modeline comment class.
 
 Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
 """
+
 __all__ = [
     "Comments",
-    "export_json",
     "generate_list_items",
-    "import_json",
     "list_filetypes",
 ]
 
@@ -17,7 +16,7 @@ import json
 import os
 from io import TextIOWrapper
 from os.path import exists, isdir, realpath
-from typing import Dict, Iterator, List, Tuple
+from typing import Dict, List, Tuple
 
 from colorama import Fore, Style
 from colorama import init as color_init
@@ -25,8 +24,7 @@ from colorama import init as color_init
 from ..types import IndentMap
 from ..util import die
 
-COMMENT_STR: str = "vim: set ts={ts} sts={sts} sw={sw} {et} ai si sta:"
-
+_COMMENT_STR: str = "vim: set ts={ts} sts={sts} sw={sw} {et} ai si sta:"
 _JSON_FILE: str = realpath("./vim_eof_comment/comments/filetypes.json")
 _BLUE: int = Fore.BLUE
 _YELLOW: int = Fore.YELLOW
@@ -60,15 +58,12 @@ def import_json() -> Tuple[Dict[str, str], Dict[str, IndentMap]]:
     maps = result[1]
 
     for k, v in comments.items():
-        comments[k] = v.format(comment=COMMENT_STR)
+        comments[k] = v.format(comment=_COMMENT_STR)
 
     return comments, maps
 
 
-_formats, _DEFAULT = import_json()
-
-
-class Comments():
+class Comments:
     """
     Vim EOF comments class.
 
@@ -96,8 +91,8 @@ class Comments():
     get_ft()
     """
 
-    __DEFAULT: Dict[str, IndentMap] = _DEFAULT.copy()
-    __formats: Dict[str, str] = _formats.copy()
+    __DEFAULT: Dict[str, IndentMap]
+    __formats: Dict[str, str]
     comments: Dict[str, str]
     langs: Dict[str, IndentMap]
 
@@ -110,6 +105,8 @@ class Comments():
         mappings : Dict[str, IndentMap], optional, default=None
             The ``str`` to ``IndentMap`` dictionary.
         """
+        self.__formats, self.__DEFAULT = import_json()
+
         if mappings is None or len(mappings) == 0:
             self.langs = self.__DEFAULT.copy()
             return
@@ -127,11 +124,6 @@ class Comments():
 
         self.__fill_langs(langs)
 
-    def __iter__(self) -> Iterator[str]:
-        """Iterate through comment langs."""
-        for k, v in self.langs.items():
-            yield (k, v)
-
     def __is_available(self, lang: str) -> bool:
         """
         Check if a given lang is available within the class.
@@ -268,7 +260,7 @@ def export_json() -> None:
         return
 
     try:
-        data: str = json.dumps((_formats, _DEFAULT), ensure_ascii=False)
+        data: str = json.dumps(import_json(), ensure_ascii=False)
     except KeyboardInterrupt:
         die(code=1)
     except Exception:
@@ -285,4 +277,5 @@ def export_json() -> None:
 
     file.close()
 
+
 # vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/comments/generator.pyi

@@ -1,20 +1,6 @@
-from typing import Iterator
-
 from ..types import IndentMap
 
-__all__ = ['Comments', 'export_json', 'generate_list_items', 'import_json', 'list_filetypes']
-
-def import_json() -> tuple[dict[str, str], dict[str, IndentMap]]:
-    """
-    Import default vars from JSON file.
-
-    Returns
-    -------
-    comments : Dict[str, str]
-        The default ``Dict[str, str]``.
-    map_dict : Dict[str, IndentMap]
-        The default indent mappings dict.
-    """
+__all__ = ["Comments", "generate_list_items", "list_filetypes"]
 
 class Comments:
     """
@@ -43,6 +29,7 @@ class Comments:
     get_defaults()
     get_ft()
     """
+
     __DEFAULT: dict[str, IndentMap]
     __formats: dict[str, str]
     comments: dict[str, str]
@@ -56,8 +43,6 @@ class Comments:
         mappings : Dict[str, IndentMap], optional, default=None
             The ``str`` to ``IndentMap`` dictionary.
         """
-    def __iter__(self) -> Iterator[str]:
-        """Iterate through comment langs."""
     def __is_available(self, lang: str) -> bool:
         """
         Check if a given lang is available within the class.
@@ -115,7 +100,7 @@ class Comments:
         """
 
 def generate_list_items(ft: str, level: int, expandtab: str) -> str:
-    '''
+    """
     Generate a colored string for filetypes listing.
 
     Parameters
@@ -131,10 +116,9 @@ def generate_list_items(ft: str, level: int, expandtab: str) -> str:
     -------
     str
         The generated string.
-    '''
+    """
+
 def list_filetypes() -> None:
     """List all available filetypes."""
-def export_json() -> None:
-    """Export default vars to JSON."""
 
 # vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/file.py

@@ -5,6 +5,7 @@ File management utilities.
 
 Copyright (c) 2025 Guennadi Maximov C. All Rights Reserved.
 """
+
 __all__ = [
     "EXCLUDED_DIRS",
     "bootstrap_paths",
@@ -219,4 +220,5 @@ def get_last_line(file: TextIOWrapper) -> LineBool:
 
     return LineBool(line=line, had_nwl=had_nwl, crlf=crlf)
 
+
 # vim: set ts=4 sts=4 sw=4 et ai si sta:

{vim_eof_comment-0.6.2 → vim_eof_comment-0.7.1}/vim_eof_comment/file.pyi

@@ -2,7 +2,14 @@ from io import TextIOWrapper
 
 from .types import BatchPairDict, BatchPathDict, LineBool
 
-__all__ = ['EXCLUDED_DIRS', 'bootstrap_paths', 'get_last_line', 'modify_file', 'open_batch_paths', 'try_open']
+__all__ = [
+    "EXCLUDED_DIRS",
+    "bootstrap_paths",
+    "get_last_line",
+    "modify_file",
+    "open_batch_paths",
+    "try_open",
+]
 
 EXCLUDED_DIRS: list[str]
 
@@ -20,6 +27,7 @@ def try_open(fpath: str) -> bool:
     bool
         Whether the file triggers a ``UnicodeDecodeError`` or not.
     """
+
 def bootstrap_paths(paths: list[str], exts: list[str]) -> list[BatchPairDict]:
     """
     Bootstrap all the matching paths in current dir and below.
@@ -36,6 +44,7 @@ def bootstrap_paths(paths: list[str], exts: list[str]) -> list[BatchPairDict]:
     List[BatchPairDict]
         A list of ``BatchPairDict`` type objects.
     """
+
 def open_batch_paths(paths: list[BatchPairDict]) -> dict[str, BatchPathDict]:
     """
     Return a list of TextIO objects given file path strings.
@@ -50,6 +59,7 @@ def open_batch_paths(paths: list[BatchPairDict]) -> dict[str, BatchPathDict]:
     Dict[str, BatchPathDict]
         A ``str`` to ``BatchPathDict``` dictionary.
     """
+
 def modify_file(file: TextIOWrapper, comments: dict[str, str], ext: str, **kwargs) -> str:
     """
     Modify a file containing a bad EOF comment.
@@ -70,6 +80,7 @@ def modify_file(file: TextIOWrapper, comments: dict[str, str], ext: str, **kwarg
     str
         The modified contents of the given file.
     """
+
 def get_last_line(file: TextIOWrapper) -> LineBool:
     """
     Return the last line of a file and indicates whether it already has a newline.