diff --git a/ansibledoctor/cli.py b/ansibledoctor/cli.py index b508ab6..b6c6bf7 100644 --- a/ansibledoctor/cli.py +++ b/ansibledoctor/cli.py @@ -23,10 +23,11 @@ class AnsibleDoctor: self.config = SingleConfig() self.config.load(args=self._parse_args()) self.log.register_hanlers(json=self.config.config.logging.json) - except ansibledoctor.exception.ConfigError as e: + self._execute() + except ansibledoctor.exception.DoctorError as e: self.log.sysexit_with_message(e) - - self._execute() + except KeyboardInterrupt: + self.log.sysexit_with_message("Aborted...") def _parse_args(self): """ @@ -123,11 +124,8 @@ class AnsibleDoctor: for item in walkdirs: os.chdir(item) - try: - self.config.load(root_path=os.getcwd()) - self.log.register_hanlers(json=self.config.config.logging.json) - except ansibledoctor.exception.ConfigError as e: - self.log.sysexit_with_message(e) + self.config.load(root_path=os.getcwd()) + self.log.register_hanlers(json=self.config.config.logging.json) try: self.log.set_level(self.config.config.logging.level) diff --git a/ansibledoctor/config.py b/ansibledoctor/config.py index 73aac7d..4910b84 100644 --- a/ansibledoctor/config.py +++ b/ansibledoctor/config.py @@ -2,6 +2,7 @@ """Global settings definition.""" import os +import re from appdirs import AppDirs from dynaconf import Dynaconf, ValidationError, Validator @@ -58,6 +59,9 @@ class Config: self.load() def load(self, root_path=None, args=None): + tmpl_src = os.path.join(os.path.dirname(os.path.realpath(__file__)), "templates") + tmpl_provider = ["local", "git"] + if args: if args.get("config_file"): self.config_merge = False @@ -137,8 +141,12 @@ class Config: ), Validator( "template.src", - default=os.path.join(os.path.dirname(os.path.realpath(__file__)), "templates"), + default=f"local>{tmpl_src}", is_type_of=str, + condition=lambda x: re.match(r"^(local|git)\s*>\s*", x), + messages={ + "condition": f"Template provider must be one of {tmpl_provider}.", + }, ), Validator( "template.name", @@ -218,16 +226,6 @@ class Config: annotations.append(k) return annotations - def get_template(self): - """ - Get the base dir for the template to use. - - :return: str abs path - """ - template_base = self.config.get("template.src") - template_name = self.config.get("template.name") - return os.path.realpath(os.path.join(template_base, template_name)) - class SingleConfig(Config, metaclass=Singleton): """Singleton config class.""" diff --git a/ansibledoctor/doc_generator.py b/ansibledoctor/doc_generator.py index f3f5405..0041bfa 100644 --- a/ansibledoctor/doc_generator.py +++ b/ansibledoctor/doc_generator.py @@ -1,8 +1,6 @@ #!/usr/bin/env python3 """Prepare output and write compiled jinja2 templates.""" -import glob -import ntpath import os import re from functools import reduce @@ -12,8 +10,8 @@ import ruamel.yaml from jinja2 import Environment, FileSystemLoader from jinja2.filters import pass_eval_context -import ansibledoctor.exception from ansibledoctor.config import SingleConfig +from ansibledoctor.template import Template from ansibledoctor.utils import FileUtils, SingleLog @@ -21,34 +19,14 @@ class Generator: """Generate documentation from jinja2 templates.""" def __init__(self, doc_parser): - self.template_files = [] - self.extension = "j2" - self._parser = None - self.config = SingleConfig() self.log = SingleLog() self.logger = self.log.logger + self.config = SingleConfig() + self.template = Template( + self.config.config.get("template.name"), + self.config.config.get("template.src"), + ) self._parser = doc_parser - self._scan_template() - - def _scan_template(self): - """ - Search for Jinja2 (.j2) files to apply to the destination. - - :return: None - """ - template = self.config.get_template() - if os.path.isdir(template): - self.logger.info(f"Using template: {os.path.relpath(template, self.log.ctx)}") - else: - self.log.sysexit_with_message(f"Can not open template directory {template}") - - for file in glob.iglob(template + "/**/*." + self.extension, recursive=True): - relative_file = file[len(template) + 1 :] - if ntpath.basename(file)[:1] != "_": - self.logger.debug(f"Found template file: {relative_file}") - self.template_files.append(relative_file) - else: - self.logger.debug(f"Ignoring template file: {relative_file}") def _create_dir(self, directory): if not self.config.config["dry_run"] and not os.path.isdir(directory): @@ -61,9 +39,9 @@ class Generator: def _write_doc(self): files_to_overwite = [] - for file in self.template_files: + for tf in self.template.files: doc_file = os.path.join( - self.config.config.get("renderer.dest"), os.path.splitext(file)[0] + self.config.config.get("renderer.dest"), os.path.splitext(tf)[0] ) if os.path.isfile(doc_file): files_to_overwite.append(doc_file) @@ -92,31 +70,30 @@ class Generator: try: if not FileUtils.query_yes_no(f"{prompt}\nDo you want to continue?"): self.log.sysexit_with_message("Aborted...") - except ansibledoctor.exception.InputError as e: - self.logger.debug(str(e)) + except KeyboardInterrupt: self.log.sysexit_with_message("Aborted...") - for file in self.template_files: + for tf in self.template.files: doc_file = os.path.join( - self.config.config.get("renderer.dest"), os.path.splitext(file)[0] + self.config.config.get("renderer.dest"), os.path.splitext(tf)[0] ) - source_file = self.config.get_template() + "/" + file + template = os.path.join(self.template.path, tf) self.logger.debug( f"Writing renderer output to: {os.path.relpath(doc_file, self.log.ctx)} " - f"from: {os.path.dirname(os.path.relpath(source_file, self.log.ctx))}" + f"from: {os.path.dirname(template)}" ) # make sure the directory exists self._create_dir(os.path.dirname(doc_file)) - if os.path.exists(source_file) and os.path.isfile(source_file): - with open(source_file) as template: + if os.path.exists(template) and os.path.isfile(template): + with open(template) as template: data = template.read() if data is not None: try: jenv = Environment( # nosec - loader=FileSystemLoader(self.config.get_template()), + loader=FileSystemLoader(self.template.path), lstrip_blocks=True, trim_blocks=True, autoescape=jinja2.select_autoescape(), @@ -143,7 +120,7 @@ class Generator: jinja2.exceptions.TemplateRuntimeError, ) as e: self.log.sysexit_with_message( - f"Jinja2 templating error while loading file: '{file}'\n{e!s}" + f"Jinja2 templating error while loading file: {tf}\n{e!s}" ) except UnicodeEncodeError as e: self.log.sysexit_with_message( diff --git a/ansibledoctor/exception.py b/ansibledoctor/exception.py index c51cf3b..ca46634 100644 --- a/ansibledoctor/exception.py +++ b/ansibledoctor/exception.py @@ -22,7 +22,5 @@ class ConfigError(DoctorError): pass -class InputError(DoctorError): - """Errors related to config file handling.""" - - pass +class TemplateError(DoctorError): + """Errors related to template file handling.""" diff --git a/ansibledoctor/file_registry.py b/ansibledoctor/file_registry.py index 8edc792..f53c77b 100644 --- a/ansibledoctor/file_registry.py +++ b/ansibledoctor/file_registry.py @@ -48,7 +48,7 @@ class Registry: for filename in glob.iglob(pattern, recursive=True): if not excludespec.match_file(filename): self.log.debug( - f"Adding file to role '{role_name}': {os.path.relpath(filename, base_dir)}" + f"Adding file to role: {role_name}: {os.path.relpath(filename, base_dir)}" ) self._doc.append(filename) else: diff --git a/ansibledoctor/template.py b/ansibledoctor/template.py new file mode 100644 index 0000000..cc9a834 --- /dev/null +++ b/ansibledoctor/template.py @@ -0,0 +1,113 @@ +"""Module for handling templates.""" + +import atexit +import glob +import ntpath +import os +import shutil +import tempfile + +from git import GitCommandError, Repo + +import ansibledoctor.exception +from ansibledoctor.utils import SingleLog + + +class Template: + """ + Represents a template that can be used to generate content. + + Templates can besourced from a local file or a Git repository. The `Template` class handles + the initialization and setup of a template, including cloning a Git repository if necessary. + + Args: + ---- + name (str): The name of the template. + src (str): The source of the template, in the format `>`. + Supported providers are `local` and `git`. + + Raises: + ------ + ansibledoctor.exception.TemplateError + + """ + + def __init__(self, name, src): + self.log = SingleLog() + self.logger = self.log.logger + self.name = name + self.src = src + + try: + provider, path = self.src.split(">", 1) + except ValueError as e: + raise ansibledoctor.exception.TemplateError( + "Error reading template src", str(e) + ) from e + + self.provider = provider.strip().lower() + self.path = path.strip() + + if self.provider == "local": + self.path = os.path.realpath(os.path.join(self.path, self.name)) + elif self.provider == "git": + repo_url, branch_or_tag = ( + self.path.split("#", 1) if "#" in self.path else (self.path, None) + ) + temp_dir = self._clone_repo(repo_url, branch_or_tag) + self.path = os.path.join(temp_dir, self.name) + else: + raise ansibledoctor.exception.TemplateError( + f"Unsupported template provider: {provider}" + ) + + self.files = self._scan_files() + + def _clone_repo(self, repo_url, branch_or_tag=None): + temp_dir = tempfile.mkdtemp(prefix="ansibledoctor-") + atexit.register(self._cleanup_temp_dir, temp_dir) + + try: + self.logger.debug(f"Cloning template repo: {repo_url}") + repo = Repo.clone_from(repo_url, temp_dir) + if branch_or_tag: + self.logger.debug(f"Checking out branch or tag: {branch_or_tag}") + try: + repo.git.checkout(branch_or_tag) + except GitCommandError as e: + raise ansibledoctor.exception.TemplateError( + f"Error checking out branch or tag: {branch_or_tag}: {e}" + ) from e + + return temp_dir + except GitCommandError as e: + msg = e.stderr.strip("'").strip() + msg = msg.removeprefix("stderr: ") + + raise ansibledoctor.exception.TemplateError( + f"Error cloning Git repository: {msg}" + ) from e + + def _scan_files(self): + """Search for Jinja2 (.j2) files to apply to the destination.""" + template_files = [] + + if os.path.isdir(self.path): + self.logger.info(f"Using template src: {self.src} name: {self.name}") + else: + self.log.sysexit_with_message(f"Can not open template directory {self.path}") + + for file in glob.iglob(self.path + "/**/*.j2", recursive=True): + relative_file = file[len(self.path) + 1 :] + if ntpath.basename(file)[:1] != "_": + self.logger.debug(f"Found template file: {relative_file}") + template_files.append(relative_file) + else: + self.logger.debug(f"Ignoring template file: {relative_file}") + + return template_files + + @staticmethod + def _cleanup_temp_dir(temp_dir): + if temp_dir and os.path.exists(temp_dir): + shutil.rmtree(temp_dir) diff --git a/ansibledoctor/utils/__init__.py b/ansibledoctor/utils/__init__.py index e25a3d0..d30c00f 100644 --- a/ansibledoctor/utils/__init__.py +++ b/ansibledoctor/utils/__init__.py @@ -9,8 +9,6 @@ from collections.abc import Iterable import colorama from pythonjsonlogger import jsonlogger -import ansibledoctor.exception - CONSOLE_FORMAT = "{}{}[%(levelname)s]{} %(message)s" JSON_FORMAT = "%(asctime)s %(levelname)s %(message)s" @@ -331,9 +329,12 @@ class FileUtils: """ prompt = "[Y/n]" if default else "[N/y]" - try: - # input method is safe in python3 - choice = input(f"{question} {prompt} ") or default # nosec - return to_bool(choice) - except (KeyboardInterrupt, ValueError) as e: - raise ansibledoctor.exception.InputError("Error while reading input", e) from e + while True: + try: + # input method is safe in python3 + choice = input(f"{question} {prompt} ") or default # nosec + return to_bool(choice) + except ValueError: + print("Invalid input. Please enter 'y' or 'n'.") # noqa: T201 + except KeyboardInterrupt as e: + raise e diff --git a/docs/content/usage/configuration.md b/docs/content/usage/configuration.md index ceef960..e265af4 100644 --- a/docs/content/usage/configuration.md +++ b/docs/content/usage/configuration.md @@ -48,8 +48,34 @@ logging: json: False template: + # Name of the template to be used. In most cases, this is the name of a directory that is attached to the + # the `src` path or Git repo (see example below). name: readme - # Default is built-in templates directory. + + # Template provider source. Currently supported providers are `local|git`. + # The `local` provider loads templates from the local file system. This provider + # is used by default and uses the built-in templates. + # + # Examples: + # template: + # name: readme + # src: local>/tmp/custom_templates/ + # + # The `git` provider allows templates to be loaded from a git repository. At the moment + # the functions of this provider are limited and only public repositories are supported. + # + # Examples: + # template: + # src: git>https://github.com/thegeeklab/ansible-doctor + # name: ansibledoctor/templates/readme + # + # template: + # src: git>git@github.com:thegeeklab/ansible-doctor.git + # name: ansibledoctor/templates/readme + # + # template: + # src: git>git@github.com:thegeeklab/ansible-doctor.git#branch-or-tag + # name: ansibledoctor/templates/readme src: options: diff --git a/example/demo-role/.ansibledoctor.yml b/example/demo-role/.ansibledoctor.yml index 9385c0d..e284073 100644 --- a/example/demo-role/.ansibledoctor.yml +++ b/example/demo-role/.ansibledoctor.yml @@ -3,7 +3,8 @@ logging: level: debug template: - name: readme + src: git>https://github.com/thegeeklab/ansible-doctor + name: ansibledoctor/templates/readme renderer: include_header: HEADER.md diff --git a/poetry.lock b/poetry.lock index ffd6413..76cc84a 100644 --- a/poetry.lock +++ b/poetry.lock @@ -316,6 +316,38 @@ files = [ [package.extras] test = ["pytest (>=6)"] +[[package]] +name = "gitdb" +version = "4.0.11" +description = "Git Object Database" +optional = false +python-versions = ">=3.7" +files = [ + {file = "gitdb-4.0.11-py3-none-any.whl", hash = "sha256:81a3407ddd2ee8df444cbacea00e2d038e40150acfa3001696fe0dcf1d3adfa4"}, + {file = "gitdb-4.0.11.tar.gz", hash = "sha256:bf5421126136d6d0af55bc1e7c1af1c397a34f5b7bd79e776cd3e89785c2b04b"}, +] + +[package.dependencies] +smmap = ">=3.0.1,<6" + +[[package]] +name = "gitpython" +version = "3.1.43" +description = "GitPython is a Python library used to interact with Git repositories" +optional = false +python-versions = ">=3.7" +files = [ + {file = "GitPython-3.1.43-py3-none-any.whl", hash = "sha256:eec7ec56b92aad751f9912a73404bc02ba212a23adb2c7098ee668417051a1ff"}, + {file = "GitPython-3.1.43.tar.gz", hash = "sha256:35f314a9f878467f5453cc1fee295c3e18e52f1b99f10f6cf5b1682e968a9e7c"}, +] + +[package.dependencies] +gitdb = ">=4.0.1,<5" + +[package.extras] +doc = ["sphinx (==4.3.2)", "sphinx-autodoc-typehints", "sphinx-rtd-theme", "sphinxcontrib-applehelp (>=1.0.2,<=1.0.4)", "sphinxcontrib-devhelp (==1.0.2)", "sphinxcontrib-htmlhelp (>=2.0.0,<=2.0.1)", "sphinxcontrib-qthelp (==1.0.3)", "sphinxcontrib-serializinghtml (==1.1.5)"] +test = ["coverage[toml]", "ddt (>=1.1.1,!=1.4.3)", "mock", "mypy", "pre-commit", "pytest (>=7.3.1)", "pytest-cov", "pytest-instafail", "pytest-mock", "pytest-sugar", "typing-extensions"] + [[package]] name = "iniconfig" version = "2.0.0" @@ -666,10 +698,10 @@ files = [] develop = false [package.dependencies] -typing_extensions = "*" +typing-extensions = "*" [package.extras] -dev = ["backports.zoneinfo", "black", "build", "freezegun", "mdx_truly_sane_lists", "mike", "mkdocs", "mkdocs-awesome-pages-plugin", "mkdocs-gen-files", "mkdocs-literate-nav", "mkdocs-material (>=8.5)", "mkdocstrings[python]", "msgspec", "mypy", "orjson", "pylint", "pytest", "tzdata", "validate-pyproject[all]"] +dev = ["backports.zoneinfo", "black", "build", "freezegun", "mdx-truly-sane-lists", "mike", "mkdocs", "mkdocs-awesome-pages-plugin", "mkdocs-gen-files", "mkdocs-literate-nav", "mkdocs-material (>=8.5)", "mkdocstrings[python]", "msgspec", "mypy", "orjson", "pylint", "pytest", "tzdata", "validate-pyproject[all]"] [package.source] type = "git" @@ -689,7 +721,6 @@ files = [ {file = "PyYAML-6.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:69b023b2b4daa7548bcfbd4aa3da05b3a74b772db9e23b982788168117739938"}, {file = "PyYAML-6.0.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:81e0b275a9ecc9c0c0c07b4b90ba548307583c125f54d5b6946cfee6360c733d"}, {file = "PyYAML-6.0.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ba336e390cd8e4d1739f42dfe9bb83a3cc2e80f567d8805e11b46f4a943f5515"}, - {file = "PyYAML-6.0.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:326c013efe8048858a6d312ddd31d56e468118ad4cdeda36c719bf5bb6192290"}, {file = "PyYAML-6.0.1-cp310-cp310-win32.whl", hash = "sha256:bd4af7373a854424dabd882decdc5579653d7868b8fb26dc7d0e99f823aa5924"}, {file = "PyYAML-6.0.1-cp310-cp310-win_amd64.whl", hash = "sha256:fd1592b3fdf65fff2ad0004b5e363300ef59ced41c2e6b3a99d4089fa8c5435d"}, {file = "PyYAML-6.0.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:6965a7bc3cf88e5a1c3bd2e0b5c22f8d677dc88a455344035f03399034eb3007"}, @@ -697,16 +728,8 @@ files = [ {file = "PyYAML-6.0.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:42f8152b8dbc4fe7d96729ec2b99c7097d656dc1213a3229ca5383f973a5ed6d"}, {file = "PyYAML-6.0.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:062582fca9fabdd2c8b54a3ef1c978d786e0f6b3a1510e0ac93ef59e0ddae2bc"}, {file = "PyYAML-6.0.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d2b04aac4d386b172d5b9692e2d2da8de7bfb6c387fa4f801fbf6fb2e6ba4673"}, - {file = "PyYAML-6.0.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:e7d73685e87afe9f3b36c799222440d6cf362062f78be1013661b00c5c6f678b"}, {file = "PyYAML-6.0.1-cp311-cp311-win32.whl", hash = "sha256:1635fd110e8d85d55237ab316b5b011de701ea0f29d07611174a1b42f1444741"}, {file = "PyYAML-6.0.1-cp311-cp311-win_amd64.whl", hash = "sha256:bf07ee2fef7014951eeb99f56f39c9bb4af143d8aa3c21b1677805985307da34"}, - {file = "PyYAML-6.0.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:855fb52b0dc35af121542a76b9a84f8d1cd886ea97c84703eaa6d88e37a2ad28"}, - {file = "PyYAML-6.0.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:40df9b996c2b73138957fe23a16a4f0ba614f4c0efce1e9406a184b6d07fa3a9"}, - {file = "PyYAML-6.0.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a08c6f0fe150303c1c6b71ebcd7213c2858041a7e01975da3a99aed1e7a378ef"}, - {file = "PyYAML-6.0.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6c22bec3fbe2524cde73d7ada88f6566758a8f7227bfbf93a408a9d86bcc12a0"}, - {file = "PyYAML-6.0.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:8d4e9c88387b0f5c7d5f281e55304de64cf7f9c0021a3525bd3b1c542da3b0e4"}, - {file = "PyYAML-6.0.1-cp312-cp312-win32.whl", hash = "sha256:d483d2cdf104e7c9fa60c544d92981f12ad66a457afae824d146093b8c294c54"}, - {file = "PyYAML-6.0.1-cp312-cp312-win_amd64.whl", hash = "sha256:0d3304d8c0adc42be59c5f8a4d9e3d7379e6955ad754aa9d6ab7a398b59dd1df"}, {file = "PyYAML-6.0.1-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:50550eb667afee136e9a77d6dc71ae76a44df8b3e51e41b77f6de2932bfe0f47"}, {file = "PyYAML-6.0.1-cp36-cp36m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1fe35611261b29bd1de0070f0b2f47cb6ff71fa6595c077e42bd0c419fa27b98"}, {file = "PyYAML-6.0.1-cp36-cp36m-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:704219a11b772aea0d8ecd7058d0082713c3562b4e271b849ad7dc4a5c90c13c"}, @@ -723,7 +746,6 @@ files = [ {file = "PyYAML-6.0.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a0cd17c15d3bb3fa06978b4e8958dcdc6e0174ccea823003a106c7d4d7899ac5"}, {file = "PyYAML-6.0.1-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:28c119d996beec18c05208a8bd78cbe4007878c6dd15091efb73a30e90539696"}, {file = "PyYAML-6.0.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7e07cbde391ba96ab58e532ff4803f79c4129397514e1413a7dc761ccd755735"}, - {file = "PyYAML-6.0.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:49a183be227561de579b4a36efbb21b3eab9651dd81b1858589f796549873dd6"}, {file = "PyYAML-6.0.1-cp38-cp38-win32.whl", hash = "sha256:184c5108a2aca3c5b3d3bf9395d50893a7ab82a38004c8f61c258d4428e80206"}, {file = "PyYAML-6.0.1-cp38-cp38-win_amd64.whl", hash = "sha256:1e2722cc9fbb45d9b87631ac70924c11d3a401b2d7f410cc0e3bbf249f2dca62"}, {file = "PyYAML-6.0.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:9eb6caa9a297fc2c2fb8862bc5370d0303ddba53ba97e71f08023b6cd73d16a8"}, @@ -731,7 +753,6 @@ files = [ {file = "PyYAML-6.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5773183b6446b2c99bb77e77595dd486303b4faab2b086e7b17bc6bef28865f6"}, {file = "PyYAML-6.0.1-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b786eecbdf8499b9ca1d697215862083bd6d2a99965554781d0d8d1ad31e13a0"}, {file = "PyYAML-6.0.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bc1bf2925a1ecd43da378f4db9e4f799775d6367bdb94671027b73b393a7c42c"}, - {file = "PyYAML-6.0.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:04ac92ad1925b2cff1db0cfebffb6ffc43457495c9b3c39d3fcae417d7125dc5"}, {file = "PyYAML-6.0.1-cp39-cp39-win32.whl", hash = "sha256:faca3bdcf85b2fc05d06ff3fbc1f83e1391b3e724afa3feba7d13eeab355484c"}, {file = "PyYAML-6.0.1-cp39-cp39-win_amd64.whl", hash = "sha256:510c9deebc5c0225e8c96813043e62b680ba2f9c50a08d3724c7f28a747d1486"}, {file = "PyYAML-6.0.1.tar.gz", hash = "sha256:bfdf460b1736c775f2ba9f6a92bca30bc2095067b8a9d77876d1fad6cc3b4a43"}, @@ -922,51 +943,37 @@ python-versions = ">=3.6" files = [ {file = "ruamel.yaml.clib-0.2.8-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:b42169467c42b692c19cf539c38d4602069d8c1505e97b86387fcf7afb766e1d"}, {file = "ruamel.yaml.clib-0.2.8-cp310-cp310-macosx_13_0_arm64.whl", hash = "sha256:07238db9cbdf8fc1e9de2489a4f68474e70dffcb32232db7c08fa61ca0c7c462"}, + {file = "ruamel.yaml.clib-0.2.8-cp310-cp310-manylinux2014_aarch64.whl", hash = "sha256:d92f81886165cb14d7b067ef37e142256f1c6a90a65cd156b063a43da1708cfd"}, {file = "ruamel.yaml.clib-0.2.8-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:fff3573c2db359f091e1589c3d7c5fc2f86f5bdb6f24252c2d8e539d4e45f412"}, - {file = "ruamel.yaml.clib-0.2.8-cp310-cp310-manylinux_2_24_aarch64.whl", hash = "sha256:aa2267c6a303eb483de8d02db2871afb5c5fc15618d894300b88958f729ad74f"}, - {file = "ruamel.yaml.clib-0.2.8-cp310-cp310-musllinux_1_1_i686.whl", hash = "sha256:840f0c7f194986a63d2c2465ca63af8ccbbc90ab1c6001b1978f05119b5e7334"}, - {file = "ruamel.yaml.clib-0.2.8-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:024cfe1fc7c7f4e1aff4a81e718109e13409767e4f871443cbff3dba3578203d"}, {file = "ruamel.yaml.clib-0.2.8-cp310-cp310-win32.whl", hash = "sha256:c69212f63169ec1cfc9bb44723bf2917cbbd8f6191a00ef3410f5a7fe300722d"}, {file = "ruamel.yaml.clib-0.2.8-cp310-cp310-win_amd64.whl", hash = "sha256:cabddb8d8ead485e255fe80429f833172b4cadf99274db39abc080e068cbcc31"}, {file = "ruamel.yaml.clib-0.2.8-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:bef08cd86169d9eafb3ccb0a39edb11d8e25f3dae2b28f5c52fd997521133069"}, {file = "ruamel.yaml.clib-0.2.8-cp311-cp311-macosx_13_0_arm64.whl", hash = "sha256:b16420e621d26fdfa949a8b4b47ade8810c56002f5389970db4ddda51dbff248"}, + {file = "ruamel.yaml.clib-0.2.8-cp311-cp311-manylinux2014_aarch64.whl", hash = "sha256:b5edda50e5e9e15e54a6a8a0070302b00c518a9d32accc2346ad6c984aacd279"}, {file = "ruamel.yaml.clib-0.2.8-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl", hash = "sha256:25c515e350e5b739842fc3228d662413ef28f295791af5e5110b543cf0b57d9b"}, - {file = "ruamel.yaml.clib-0.2.8-cp311-cp311-manylinux_2_24_aarch64.whl", hash = "sha256:1707814f0d9791df063f8c19bb51b0d1278b8e9a2353abbb676c2f685dee6afe"}, - {file = "ruamel.yaml.clib-0.2.8-cp311-cp311-musllinux_1_1_i686.whl", hash = "sha256:46d378daaac94f454b3a0e3d8d78cafd78a026b1d71443f4966c696b48a6d899"}, - {file = "ruamel.yaml.clib-0.2.8-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:09b055c05697b38ecacb7ac50bdab2240bfca1a0c4872b0fd309bb07dc9aa3a9"}, {file = "ruamel.yaml.clib-0.2.8-cp311-cp311-win32.whl", hash = "sha256:53a300ed9cea38cf5a2a9b069058137c2ca1ce658a874b79baceb8f892f915a7"}, {file = "ruamel.yaml.clib-0.2.8-cp311-cp311-win_amd64.whl", hash = "sha256:c2a72e9109ea74e511e29032f3b670835f8a59bbdc9ce692c5b4ed91ccf1eedb"}, {file = "ruamel.yaml.clib-0.2.8-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:ebc06178e8821efc9692ea7544aa5644217358490145629914d8020042c24aa1"}, {file = "ruamel.yaml.clib-0.2.8-cp312-cp312-macosx_13_0_arm64.whl", hash = "sha256:edaef1c1200c4b4cb914583150dcaa3bc30e592e907c01117c08b13a07255ec2"}, + {file = "ruamel.yaml.clib-0.2.8-cp312-cp312-manylinux2014_aarch64.whl", hash = "sha256:7048c338b6c86627afb27faecf418768acb6331fc24cfa56c93e8c9780f815fa"}, {file = "ruamel.yaml.clib-0.2.8-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d176b57452ab5b7028ac47e7b3cf644bcfdc8cacfecf7e71759f7f51a59e5c92"}, - {file = "ruamel.yaml.clib-0.2.8-cp312-cp312-manylinux_2_24_aarch64.whl", hash = "sha256:1dc67314e7e1086c9fdf2680b7b6c2be1c0d8e3a8279f2e993ca2a7545fecf62"}, - {file = "ruamel.yaml.clib-0.2.8-cp312-cp312-musllinux_1_1_i686.whl", hash = "sha256:3213ece08ea033eb159ac52ae052a4899b56ecc124bb80020d9bbceeb50258e9"}, - {file = "ruamel.yaml.clib-0.2.8-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:aab7fd643f71d7946f2ee58cc88c9b7bfc97debd71dcc93e03e2d174628e7e2d"}, - {file = "ruamel.yaml.clib-0.2.8-cp312-cp312-win32.whl", hash = "sha256:5c365d91c88390c8d0a8545df0b5857172824b1c604e867161e6b3d59a827eaa"}, - {file = "ruamel.yaml.clib-0.2.8-cp312-cp312-win_amd64.whl", hash = "sha256:1758ce7d8e1a29d23de54a16ae867abd370f01b5a69e1a3ba75223eaa3ca1a1b"}, {file = "ruamel.yaml.clib-0.2.8-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:a5aa27bad2bb83670b71683aae140a1f52b0857a2deff56ad3f6c13a017a26ed"}, {file = "ruamel.yaml.clib-0.2.8-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:c58ecd827313af6864893e7af0a3bb85fd529f862b6adbefe14643947cfe2942"}, {file = "ruamel.yaml.clib-0.2.8-cp37-cp37m-macosx_12_0_arm64.whl", hash = "sha256:f481f16baec5290e45aebdc2a5168ebc6d35189ae6fea7a58787613a25f6e875"}, - {file = "ruamel.yaml.clib-0.2.8-cp37-cp37m-manylinux_2_24_aarch64.whl", hash = "sha256:77159f5d5b5c14f7c34073862a6b7d34944075d9f93e681638f6d753606c6ce6"}, + {file = "ruamel.yaml.clib-0.2.8-cp37-cp37m-manylinux2014_aarch64.whl", hash = "sha256:3fcc54cb0c8b811ff66082de1680b4b14cf8a81dce0d4fbf665c2265a81e07a1"}, {file = "ruamel.yaml.clib-0.2.8-cp37-cp37m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:7f67a1ee819dc4562d444bbafb135832b0b909f81cc90f7aa00260968c9ca1b3"}, - {file = "ruamel.yaml.clib-0.2.8-cp37-cp37m-musllinux_1_1_i686.whl", hash = "sha256:4ecbf9c3e19f9562c7fdd462e8d18dd902a47ca046a2e64dba80699f0b6c09b7"}, - {file = "ruamel.yaml.clib-0.2.8-cp37-cp37m-musllinux_1_1_x86_64.whl", hash = "sha256:87ea5ff66d8064301a154b3933ae406b0863402a799b16e4a1d24d9fbbcbe0d3"}, {file = "ruamel.yaml.clib-0.2.8-cp37-cp37m-win32.whl", hash = "sha256:75e1ed13e1f9de23c5607fe6bd1aeaae21e523b32d83bb33918245361e9cc51b"}, {file = "ruamel.yaml.clib-0.2.8-cp37-cp37m-win_amd64.whl", hash = "sha256:3f215c5daf6a9d7bbed4a0a4f760f3113b10e82ff4c5c44bec20a68c8014f675"}, {file = "ruamel.yaml.clib-0.2.8-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:1b617618914cb00bf5c34d4357c37aa15183fa229b24767259657746c9077615"}, {file = "ruamel.yaml.clib-0.2.8-cp38-cp38-macosx_12_0_arm64.whl", hash = "sha256:a6a9ffd280b71ad062eae53ac1659ad86a17f59a0fdc7699fd9be40525153337"}, - {file = "ruamel.yaml.clib-0.2.8-cp38-cp38-manylinux_2_24_aarch64.whl", hash = "sha256:305889baa4043a09e5b76f8e2a51d4ffba44259f6b4c72dec8ca56207d9c6fe1"}, + {file = "ruamel.yaml.clib-0.2.8-cp38-cp38-manylinux2014_aarch64.whl", hash = "sha256:665f58bfd29b167039f714c6998178d27ccd83984084c286110ef26b230f259f"}, {file = "ruamel.yaml.clib-0.2.8-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:700e4ebb569e59e16a976857c8798aee258dceac7c7d6b50cab63e080058df91"}, - {file = "ruamel.yaml.clib-0.2.8-cp38-cp38-musllinux_1_1_i686.whl", hash = "sha256:e2b4c44b60eadec492926a7270abb100ef9f72798e18743939bdbf037aab8c28"}, - {file = "ruamel.yaml.clib-0.2.8-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:e79e5db08739731b0ce4850bed599235d601701d5694c36570a99a0c5ca41a9d"}, {file = "ruamel.yaml.clib-0.2.8-cp38-cp38-win32.whl", hash = "sha256:955eae71ac26c1ab35924203fda6220f84dce57d6d7884f189743e2abe3a9fbe"}, {file = "ruamel.yaml.clib-0.2.8-cp38-cp38-win_amd64.whl", hash = "sha256:56f4252222c067b4ce51ae12cbac231bce32aee1d33fbfc9d17e5b8d6966c312"}, {file = "ruamel.yaml.clib-0.2.8-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:03d1162b6d1df1caa3a4bd27aa51ce17c9afc2046c31b0ad60a0a96ec22f8001"}, {file = "ruamel.yaml.clib-0.2.8-cp39-cp39-macosx_12_0_arm64.whl", hash = "sha256:bba64af9fa9cebe325a62fa398760f5c7206b215201b0ec825005f1b18b9bccf"}, - {file = "ruamel.yaml.clib-0.2.8-cp39-cp39-manylinux_2_24_aarch64.whl", hash = "sha256:a1a45e0bb052edf6a1d3a93baef85319733a888363938e1fc9924cb00c8df24c"}, + {file = "ruamel.yaml.clib-0.2.8-cp39-cp39-manylinux2014_aarch64.whl", hash = "sha256:9eb5dee2772b0f704ca2e45b1713e4e5198c18f515b52743576d196348f374d3"}, {file = "ruamel.yaml.clib-0.2.8-cp39-cp39-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:da09ad1c359a728e112d60116f626cc9f29730ff3e0e7db72b9a2dbc2e4beed5"}, - {file = "ruamel.yaml.clib-0.2.8-cp39-cp39-musllinux_1_1_i686.whl", hash = "sha256:184565012b60405d93838167f425713180b949e9d8dd0bbc7b49f074407c5a8b"}, - {file = "ruamel.yaml.clib-0.2.8-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:a75879bacf2c987c003368cf14bed0ffe99e8e85acfa6c0bfffc21a090f16880"}, {file = "ruamel.yaml.clib-0.2.8-cp39-cp39-win32.whl", hash = "sha256:84b554931e932c46f94ab306913ad7e11bba988104c5cff26d90d03f68258cd5"}, {file = "ruamel.yaml.clib-0.2.8-cp39-cp39-win_amd64.whl", hash = "sha256:25ac8c08322002b06fa1d49d1646181f0b2c72f5cbc15a85e80b4c30a544bb15"}, {file = "ruamel.yaml.clib-0.2.8.tar.gz", hash = "sha256:beb2e0404003de9a4cab9753a8805a8fe9320ee6673136ed7f04255fe60bb512"}, @@ -998,6 +1005,17 @@ files = [ {file = "ruff-0.4.8.tar.gz", hash = "sha256:16d717b1d57b2e2fd68bd0bf80fb43931b79d05a7131aa477d66fc40fbd86268"}, ] +[[package]] +name = "smmap" +version = "5.0.1" +description = "A pure Python implementation of a sliding window memory map manager" +optional = false +python-versions = ">=3.7" +files = [ + {file = "smmap-5.0.1-py3-none-any.whl", hash = "sha256:e6d8668fa5f93e706934a62d7b4db19c8d9eb8cf2adbb75ef1b675aa332b69da"}, + {file = "smmap-5.0.1.tar.gz", hash = "sha256:dceeb6c0028fdb6734471eb07c0cd2aae706ccaecab45965ee83f11c8d3b1f62"}, +] + [[package]] name = "toml" version = "0.10.2" @@ -1037,4 +1055,4 @@ ansible-core = ["ansible-core"] [metadata] lock-version = "2.0" python-versions = "^3.9.0" -content-hash = "4b6a3c6416a2afe56760d4371cd88298b78c5b0ccdf826e32212b62b0d599c9f" +content-hash = "36aba4ab2e742187f67e2ccc446fc4ec61b2b63322dad9ca6057d52d9c1cbe2b" diff --git a/pyproject.toml b/pyproject.toml index c454267..f449764 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -42,6 +42,7 @@ python = "^3.9.0" python-json-logger = { git = "https://github.com/nhairs/python-json-logger.git", tag = "v3.1.0" } "ruamel.yaml" = "0.18.6" dynaconf = "3.2.5" +gitpython = "3.1.43" ansible-core = { version = "2.14.17", optional = true } [tool.poetry.extras]