allconf 4.0.0__py3-none-any.whl

allconf/__init__.py

@@ -0,0 +1,5 @@
+__version__ = '4.0.0'
+
+__author__ = 'Thordur Matthiasson <doddi79@gmail.com>'
+__license__ = 'MIT License'
+__copyright__ = 'Copyright 2024 -Thordur Matthiasson, Copyright 2019-2024 - CCP Games ehf'

allconf/cli/render/main.py

@@ -0,0 +1,66 @@
+import argparse
+
+from allconf import __version__ as version
+from allconf.renderers import SimpleStaticRenderer
+from allconf.structs.errors import *
+
+import sys
+
+
+def main():
+    parser = argparse.ArgumentParser(description='Renders a single static config from an AllConf formatted file and '
+                                                 'its extends, includes and other expressions.',
+                                     epilog=f'AllConf version {version}')
+
+    parser.add_argument('file', help='The AllConf formatted config file to read, parse and render')
+    parser.add_argument('-o', '--output', help='File to write the results to (otherwise its just printed to stdout)',
+                        default='', nargs='?')
+    parser.add_argument('-f', '--force-overwrite', help='Overwrite existing output file if it exists',
+                        action='store_true')
+
+    loudness_group = parser.add_mutually_exclusive_group()
+    loudness_group.add_argument('-s', '--silent', action='store_true',
+                                help='Only outputs the resulting rendered config (and errors print to stderr)')
+    loudness_group.add_argument('-v', '--verbose', action="store_true",
+                                help='Spits out DEBUG level logs')
+
+    args = parser.parse_args()
+
+    if args.verbose:
+        import logging
+        logging.basicConfig(level=logging.DEBUG)
+
+    if not args.silent:
+        print(f'Reading and parsing file: {args.file}...')
+
+    try:
+        if args.output:
+            if not args.silent:
+                print(f'Writing output to: {args.output}...')
+
+            SimpleStaticRenderer().render_static_config_to_file(input_file=args.file,
+                                                                output_file=args.output,
+                                                                overwrite_existing=args.force_overwrite)
+
+        else:
+            if not args.silent:
+                print(f'Printing results:')
+                print(f'==================================================')
+            print(SimpleStaticRenderer().render_static_config_from_file(args.file))
+
+            if not args.silent:
+                print(f'==================================================')
+
+        if not args.silent:
+            print(f'Done!')
+
+    except AllConfError as e:
+        if not args.silent:
+            print(f'An error occurred: {e!r}')
+        else:
+            print(f'An error occurred: {e!r}', file=sys.stderr)
+        sys.exit(3)
+
+
+if __name__ == '__main__':
+    main()

allconf/cli/stubber/main.py

@@ -0,0 +1,74 @@
+import argparse
+
+from allconf import __version__ as version
+from allconf import stubber
+from allconf.structs.errors import *
+import sys
+
+
+def main():
+    parser = argparse.ArgumentParser(description='Generates Python dataclass stubs based on the given allconf type descriptor file.',
+                                     epilog=f'AllConf version {version}')
+
+    parser.add_argument('file', help='The AllConf config type descriptor file to generate strubs from.')
+    parser.add_argument('-o', '--output', help='File to write the generated stub code to (otherwise its just printed to stdout)',
+                        default='', nargs='?')
+    parser.add_argument('-f', '--force-overwrite', help='Overwrite existing output file if it exists', action='store_true')
+    parser.add_argument('-n', '--class-name',
+                        help='The name of the resulting "final" stub class generated when outputting to a file (default is "AllConfConfigStub"). Set to "None" to skip generating the "final" class.',
+                        default='AllConfConfigStub')
+    parser.add_argument('-x', '--export-all', help='Make all stub class names public and export via __all__ when outputting to a file.',
+                        action='store_true')
+
+    loudness_group = parser.add_mutually_exclusive_group()
+    loudness_group.add_argument('-s', '--silent', action='store_true',
+                                help='Only outputs the resulting rendered code (and errors print to stderr)')
+    loudness_group.add_argument('-v', '--verbose', action="store_true",
+                                help='Spits out DEBUG level logs')
+
+    args = parser.parse_args()
+
+    if args.verbose:
+        import logging
+        logging.basicConfig(level=logging.DEBUG)
+
+    if not args.silent:
+        print(f'Reading and stubbing file: {args.file}...')
+
+    cls_name = 'AllConfConfigStub' if args.class_name is None else args.class_name
+    if cls_name.lower().strip() == 'none':
+        cls_name = ''
+
+    try:
+        if args.output:
+            if not args.silent:
+                print(f'Writing output to: {args.output}...')
+
+            stubber.SimpleStubMaker().render_stub_classes_to_file(input_file=args.file,
+                                                                  output_file=args.output,
+                                                                  overwrite_existing=args.force_overwrite,
+                                                                  is_private=not args.export_all,
+                                                                  class_name=cls_name)
+        else:
+            if not args.silent:
+                print(f'Printing results:')
+                print(f'==================================================')
+
+            print(stubber.SimpleStubMaker().render_stub_classes_from_descriptor_file(args.file, class_name=cls_name, is_private=not args.export_all))
+
+            if not args.silent:
+                print(f'==================================================')
+
+        if not args.silent:
+            print(f'Done!')
+
+    except AllConfError as e:
+        if not args.silent:
+            print(f'An error occurred: {e!r}')
+        else:
+            print(f'An error occurred: {e!r}', file=sys.stderr)
+        sys.exit(3)
+
+
+if __name__ == '__main__':
+    main()

allconf/loaders/__init__.py

@@ -0,0 +1,4 @@
+from .interface import *
+from .jsonfile import *
+from .yamlfile import *
+from .autoloader import *

allconf/loaders/autoloader.py

@@ -0,0 +1,93 @@
+__all__ = [
+    'autoload',
+    'guess_loader_class',
+    'raw_load',
+    'render_load',
+]
+
+import os
+
+from allconf.structs import *
+from .interface import *
+from .jsonfile import *
+from .yamlfile import *
+
+_EXTENSION_LOADER_MAP = {
+    '.json': JsonFileConfigLoader,
+    '.yaml': YamlFileConfigLoader,
+    '.yml': YamlFileConfigLoader,
+}
+
+
+def guess_loader_class(file_name: str) -> Type[IAllConfLoader]:
+    """Returns the most probable loader class based of the given file's extension.
+    """
+    ext = os.path.splitext(file_name)[-1]
+    loader = _EXTENSION_LOADER_MAP.get(ext, None)
+    if not loader:
+        raise AllConfUnknownFileTypeError(f'Dont know how to autoload file extension {ext}', file_name=file_name)
+    return loader
+
+
+def raw_load(file_name: str, skip_env_loading: bool = False, skip_fidelius: bool = False, skip_py_inject: bool = False, encoding: str = 'utf-8') -> Dict:
+    """Loads and parses the given config file and returns the "raw" results as a
+    simple python dictionary.
+
+    This is mostly intended for the testing and debugging of the configuration
+    files themselves if needed.
+
+    :param file_name: The file to load
+    :param skip_env_loading: Set to True to skip resolving environment variable tags
+    :param skip_fidelius: Set to True to skip resolving Fidelius tags
+    :param skip_py_inject: Set to True to skip injecting Python imported values
+    :param encoding: Encoding to use when reading the file (utf-8 by default)
+    :return: A dict with the results
+    """
+    loader = guess_loader_class(file_name)()
+    loader.load_file(file_name, no_env_load=skip_env_loading, no_fidelius=skip_fidelius,
+                     no_py_inject=skip_py_inject, encoding=encoding)
+    return loader.data
+
+
+def render_load(file_name: str, skip_env_loading: bool = True, skip_fidelius: bool = True, skip_py_inject: bool = True, encoding: str = 'utf-8') -> str:
+    """Loads and parses the given config file and returns the "render" results
+    as a str in the same format the original file used.
+
+    The main point of this method is to be able to load and parse an AllConf
+    configuration file, including all includes, extensions, internal references,
+    environment variables, Fidelius values etc. and render as a single
+    value/file of the same format.
+
+    As a use-case example, it was originally built in order to generate
+    Kubernetes YAML manifest files using AllConf' format to simplify the process
+    (i.e. includes, internal references, secret injection via Fidelius during
+    deployment and so on).
+
+    :param file_name: The file to load
+    :param skip_env_loading: Set to True to skip resolving environment variable
+                             tags
+    :param skip_fidelius: Set to True to skip resolving Fidelius tags
+    :param skip_py_inject: Set to True to skip injecting Python imported values
+    :param encoding: Encoding to use when reading the file (utf-8 by default)
+    :return: A string representation of the configuration data loaded, in the
+             same format as the target file if possible
+    """
+    loader = guess_loader_class(file_name)()
+    loader.load_file(file_name, no_env_load=skip_env_loading, no_fidelius=skip_fidelius, no_py_inject=skip_py_inject, encoding=encoding)
+    return loader.rendered
+
+
+def autoload(file_name: str, encoding: str = 'utf-8') -> BaseConfig:
+    """Loads and parses the given config file and returns as a `BaseConfig`
+    object.
+
+    :param file_name:
+    :type file_name:
+    :param encoding:
+    :type encoding:
+    :return:
+    :rtype:
+    """
+    loader = guess_loader_class(file_name)()
+    loader.load_file(file_name, encoding=encoding)
+    return BaseConfig(**raw_load(file_name))