Merge pull request '2022.6' (#88) from 2022.6 into master

Reviewed-on: #88

.gitignore

@@ -106,10 +106,14 @@ celerybeat.pid
 .venv
 env/
 venv/
+venv_*/
 ENV/
 env.bak/
 venv.bak/
 
+# Custom Environments
+cpl-env/
+
 # Spyder project settings
 .spyderproject
 .spyproject
@@ -129,5 +133,8 @@ dmypy.json
 .pyre/
 
 # IDE
-.vscode/
 .idea/
+PythonImportHelper-v2-Completion.json
+
+# cpl unittest stuff
+unittests/test_*_playground

.vscode/launch.json

@@ -0,0 +1,307 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python: Aktuelle Datei",
+            "type": "python",
+            "request": "launch",
+            "program": "${file}",
+            "console": "integratedTerminal"
+        },
+        {
+            "name": "CPL: main test",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}/cpl_core/src/tests/custom/general/src/general",
+            "program": "main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "--customer=sh-edraft.de"
+            ],
+            "env": {
+                "CPL_NAME": "CPL_Dev_Test",
+                "PYTHON_ENVIRONMENT": "development"
+            }
+        },
+        {
+            "name": "CPL: console test",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}/src/tests/custom/console",
+            "program": "main.py",
+            "console": "integratedTerminal",
+        },
+        {
+            "name": "CPL: database test",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}/src/tests/custom/database/src",
+            "program": "main.py",
+            "console": "integratedTerminal",
+            "env": {
+                "PYTHON_ENVIRONMENT": "development",
+                "PYTHONPATH": "${workspaceFolder}/src/:$PYTHONPATH"
+            }
+        },
+        {
+            "name": "CLI",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}/",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": []
+        },
+        {
+            "name": "CLI: add",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}/src/tests/custom/general",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "add",
+                "testing",
+                "general",
+            ]
+        },
+        {
+            "name": "CLI: remove",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}/src/tests/custom/general",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "remove",
+                "testing",
+            ]
+        },
+        {
+            "name": "CLI: build",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "build"
+            ]
+        },
+        {
+            "name": "CLI: generate abc",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "generate",
+                "a",
+                "testName"
+            ]
+        },
+        {
+            "name": "CLI: generate class",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "generate",
+                "c",
+                "src/hfs/fsnfiu/fiush/fisbf/testName"
+            ]
+        },
+        {
+            "name": "CLI: generate enum",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "generate",
+                "e",
+                "testName"
+            ]
+        },
+        {
+            "name": "CLI: generate service",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "generate",
+                "s",
+                "testName"
+            ]
+        },
+        {
+            "name": "CLI: generate settings",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "generate",
+                "st",
+                "testName"
+            ]
+        },
+        {
+            "name": "CLI: generate thread",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "generate",
+                "t",
+                "testName"
+            ]
+        },
+        {
+            "name": "CLI: hello-world",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "hello-world",
+            ]
+        },
+        {
+            "name": "CLI: help",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "help",
+            ]
+        },
+        {
+            "name": "CLI: install discord.py",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}/src/tests/custom/general",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "install",
+                "discord.py",
+            ],
+            "env": {
+                "GISMO_ENVIRONMENT": "development",
+                "PYTHONPATH": "${workspaceFolder}/src/:$PYTHONPATH"
+            }
+        },
+        {
+            "name": "CLI: install local",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}/src/tests/custom/general",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "install",
+            ]
+        },
+        {
+            "name": "CLI: new console",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "new",
+                "console",
+                "HelloWorld"
+            ]
+        },
+        {
+            "name": "CLI: new library",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "new",
+                "library",
+                "HelloWorldLib"
+            ]
+        },
+        {
+            "name": "CLI: publish",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "publish",
+            ]
+        },
+        {
+            "name": "CLI: start",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "start",
+            ],
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/src/:${workspaceFolder}/src/cpl_cli/"
+            }
+        },
+        {
+            "name": "CLI: uninstall discord.py",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}/src/tests/custom/general",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "uninstall",
+                "discord.py",
+            ]
+        },
+        {
+            "name": "CLI: start",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}/src/tests/custom/general",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "update",
+            ]
+        },
+        {
+            "name": "CLI: version",
+            "type": "python",
+            "request": "launch",
+            "cwd": "${workspaceFolder}",
+            "program": "${workspaceFolder}/src/cpl_cli/main.py",
+            "console": "integratedTerminal",
+            "args": [
+                "version",
+            ]
+        },
+    ]
+}

.vscode/settings.json

@@ -0,0 +1,23 @@
+{
+    "workbench.colorCustomizations": {
+        "activityBar.activeBackground": "#93e6fc",
+        "activityBar.activeBorder": "#fa45d4",
+        "activityBar.background": "#93e6fc",
+        "activityBar.foreground": "#15202b",
+        "activityBar.inactiveForeground": "#15202b99",
+        "activityBarBadge.background": "#fa45d4",
+        "activityBarBadge.foreground": "#15202b",
+        "sash.hoverBorder": "#93e6fc",
+        "statusBar.background": "#61dafb",
+        "statusBar.foreground": "#15202b",
+        "statusBarItem.hoverBackground": "#2fcefa",
+        "statusBarItem.remoteBackground": "#61dafb",
+        "statusBarItem.remoteForeground": "#15202b",
+        "titleBar.activeBackground": "#61dafb",
+        "titleBar.activeForeground": "#15202b",
+        "titleBar.inactiveBackground": "#61dafb99",
+        "titleBar.inactiveForeground": "#15202b99"
+    },
+    "peacock.color": "#61dafb",
+    "python.pythonPath": "cpl-env/bin/python3.9",
+}

LICENSE

@@ -1,4 +1,4 @@
-MIT License Copyright (c) <year> <copyright holders>
+MIT License Copyright (c) 2020 - 2022 sh-edraft.de
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,2 +1,153 @@
-# sh_common_py_lib
+<h1 align="center">CPL - Common python library</h1>
 
+<!-- Summary -->
+<p align="center">
+  <!-- <img src="" alt="cpl-logo" width="120px" height="120px"/> -->
+  <br>
+  <i>
+  CPL is a development platform for python server applications
+  <br>using Python.</i>
+  <br>
+</p>
+
+## Table of Contents
+<!-- TABLE OF CONTENTS -->
+<ol>
+   <li><a href="#Features">Features</a></li>
+   <li>
+     <a href="#getting-started">Getting Started</a>
+     <ul>
+       <li><a href="#prerequisites">Prerequisites</a></li>
+       <li><a href="#installation">Installation</a></li>
+     </ul>
+   </li>
+   <li><a href="#roadmap">Roadmap</a></li>
+   <li><a href="#contributing">Contributing</a></li>
+   <li><a href="#license">License</a></li>
+   <li><a href="#contact">Contact</a></li>
+</ol>
+
+## Features
+<!-- FEATURE OVERVIEW -->
+- Expandle
+- Application base
+    - Standardized application classes
+    - Application object builder
+    - Application extension classes
+    - Startup classes
+    - Startup extension classes
+- Configuration
+    - Configure via object mapped JSON
+    - Console argument handling
+- Console class for in and output
+    - Banner
+    - Spinner
+    - Options (menu)
+    - Table
+    - Write
+    - Write_at
+    - Write_line
+    - Write_line_at
+- Dependency injection
+    - Service lifetimes: singleton, scoped and transient
+- Providing of application environment
+    - Environment (development, staging, testing, production)
+    - Appname
+    - Customer
+    - Hostname
+    - Runtime directory
+    - Working directory
+- Logging
+    - Standardized logger
+    - Log-level (FATAL, ERROR, WARN, INFO, DEBUG & TRACE)
+- Mail handling
+    - Send mails
+- Pipe classes
+    - Convert input
+- Utils
+    - Credential manager
+        - Encryption via BASE64
+    - PIP wrapper class based on subprocess
+        - Run pip commands
+    - String converter to different variants
+        - to_lower_case
+        - to_camel_case
+        - ...
+
+<!-- GETTING STARTED -->
+## Getting Started
+
+[Get started with CPL][quickstart].
+
+### Prerequisites
+
+- Install [python] which includes [Pip installs packages][pip]
+
+### Installation
+
+Install the CPL package
+```sh
+pip install sh_cpl --extra-index-url https://pip.sh-edraft.de
+```
+
+Install the CPL CLI
+```sh
+pip install sh_cpl-cli --extra-index-url https://pip.sh-edraft.de
+```
+
+Create workspace:
+```sh
+cpl new <console|library> <PROJECT NAME>
+```
+
+Run the application:
+```sh
+cd <PROJECT NAME>
+cpl start
+```
+
+
+<!-- ROADMAP -->
+## Roadmap
+
+See the [open issues](https://git.sh-edraft.de/sh-edraft.de/sh_common_py_lib/issues) for a list of proposed features (and known issues).
+
+
+
+<!-- CONTRIBUTING -->
+## Contributing
+
+### Contributing Guidelines
+
+Read through our [contributing guidelines][contributing] to learn about our submission process, coding rules and more.
+
+### Want to Help?
+
+Want to file a bug, contribute some code, or improve documentation? Excellent! Read up on our guidelines for [contributing][contributing].
+
+
+
+<!-- LICENSE -->
+## License
+
+Distributed under the MIT License. See [LICENSE] for more information.
+
+
+
+<!-- CONTACT -->
+## Contact
+
+Sven Heidemann - sven.heidemann@sh-edraft.de
+
+Project link: [https://git.sh-edraft.de/sh-edraft.de/sh_common_py_lib](https://git.sh-edraft.de/sh-edraft.de/sh_common_py_lib)
+
+<!-- External LINKS -->
+[pip_url]: https://pip.sh-edraft.de
+[python]: https://www.python.org/
+[pip]: https://pypi.org/project/pip/
+
+<!-- Internal LINKS -->
+[project]: https://git.sh-edraft.de/sh-edraft.de/sh_common_py_lib
+[quickstart]: https://git.sh-edraft.de/sh-edraft.de/sh_common_py_lib/wiki/quickstart
+[contributing]: https://git.sh-edraft.de/sh-edraft.de/sh_common_py_lib/wiki/contributing
+[license]: LICENSE

cpl-workspace.json

@@ -0,0 +1,95 @@
+{
+  "WorkspaceSettings": {
+    "DefaultProject": "cpl-cli",
+    "Projects": {
+      "cpl-core": "src/cpl_core/cpl-core.json",
+      "cpl-cli": "src/cpl_cli/cpl-cli.json",
+      "cpl-query": "src/cpl_query/cpl-query.json",
+      "set-version": "tools/set_version/set-version.json",
+      "set-pip-urls": "tools/set_pip_urls/set-pip-urls.json",
+      "unittests": "unittests/unittests/unittests.json",
+      "unittests_cli": "unittests/unittests_cli/unittests_cli.json",
+      "unittests_core": "unittests/unittests_core/unittests_core.json",
+      "unittests_query": "unittests/unittests_query/unittests_query.json",
+      "unittests_shared": "unittests/unittests_shared/unittests_shared.json"
+    },
+    "Scripts": {
+      "hello-world": "echo 'Hello World'",
+
+      "sv": "cpl set-version",
+      "set-version": "cpl run set-version $ARGS; echo '';",
+
+      "spu": "cpl set-pip-urls",
+      "set-pip-urls": "cpl run set-pip-urls $ARGS; echo '';",
+
+      "docs-build": "echo 'Build Documentation'; cd docs/; sphinx-apidoc -o source/ ../src/cpl_core; sphinx-apidoc -o source/ ../src/cpl_query; make clean; make html; rm source/cpl_query.tests.rst;",
+      "db": "cpl docs-build",
+      "docs-open": "xdg-open $PWD/docs/build/html/index.html &",
+      "do": "cpl docs-open",
+
+      "test": "cpl run unittests",
+
+      "pre-build-all": "cpl sv $ARGS; cpl spu $ARGS;",
+      "build-all": "cpl build-cli; cpl build-core; cpl build-query; cpl build-set-pip-urls; cpl build-set-version",
+      "ba": "cpl build-all $ARGS",
+      "build-cli": "echo 'Build cpl-cli'; cd ./src/cpl_cli; cpl build; cd ../../;",
+      "build-core": "echo 'Build cpl-core'; cd ./src/cpl_core; cpl build; cd ../../;",
+      "build-query": "echo 'Build cpl-query'; cd ./src/cpl_query; cpl build; cd ../../;",
+      "build-set-pip-urls": "echo 'Build set-pip-urls'; cd ./tools/set_pip_urls; cpl build; cd ../../;",
+      "build-set-version": "echo 'Build set-version'; cd ./tools/set_version; cpl build; cd ../../;",
+
+      "pre-publish-all": "cpl sv $ARGS; cpl spu $ARGS;",
+      "publish-all": "cpl publish-cli; cpl publish-core; cpl publish-query;",
+      "pa": "cpl build-all $ARGS",
+      "publish-cli": "echo 'Publish cpl-cli'; cd ./src/cpl_cli; cpl publish; cd ../../;",
+      "publish-core": "echo 'Publish cpl-core'; cd ./src/cpl_core; cpl publish; cd ../../;",
+      "publish-query": "echo 'Publish cpl_query'; cd ./src/cpl_query; cpl publish; cd ../../;",
+
+      "upload-prod-cli": "echo 'PROD Upload cpl-cli'; cpl upl-prod-cli;",
+      "upl-prod-cli": "twine upload -r pip.sh-edraft.de dist/cpl-cli/publish/setup/*",
+      "upload-prod-core": "echo 'PROD Upload cpl-core'; cpl upl-prod-core;",
+      "upl-prod-core": "twine upload -r pip.sh-edraft.de dist/cpl-core/publish/setup/*",
+      "upload-prod-query": "echo 'PROD Upload cpl_query'; cpl upl-prod-query;",
+      "upl-prod-query": "twine upload -r pip.sh-edraft.de dist/cpl-query/publish/setup/*",
+      "upload-exp-cli": "echo 'EXP Upload cpl-cli'; cpl upl-exp-cli;",
+      "upl-exp-cli": "twine upload -r pip-exp.sh-edraft.de dist/cpl-cli/publish/setup/*",
+      "upload-exp-core": "echo 'EXP Upload cpl-core'; cpl upl-exp-core;",
+      "upl-exp-core": "twine upload -r pip-exp.sh-edraft.de dist/cpl-core/publish/setup/*",
+      "upload-exp-query": "echo 'EXP Upload cpl_query'; cpl upl-exp-query;",
+      "upl-exp-query": "twine upload -r pip-exp.sh-edraft.de dist/cpl-query/publish/setup/*",
+      "upload-dev-cli": "echo 'DEV Upload cpl-cli'; cpl upl-dev-cli;",
+      "upl-dev-cli": "twine upload -r pip-dev.sh-edraft.de dist/cpl-cli/publish/setup/*",
+      "upload-dev-core": "echo 'DEV Upload cpl-core'; cpl upl-dev-core;",
+      "upl-dev-core": "twine upload -r pip-dev.sh-edraft.de dist/cpl-core/publish/setup/*",
+      "upload-dev-query": "echo 'DEV Upload cpl_query'; cpl upl-dev-query;",
+      "upl-dev-query": "twine upload -r pip-dev.sh-edraft.de dist/cpl-query/publish/setup/*",
+
+      "pre-deploy-prod": "cpl sv $ARGS; cpl spu --environment=production;",
+      "deploy-prod": "cpl deploy-prod-cli; cpl deploy-prod-core; cpl deploy-prod-query;",
+      "dp": "cpl deploy-prod $ARGS",
+      "deploy-prod-cli": "cpl publish-cli; cpl upload-prod-cli",
+      "deploy-prod-core": "cpl publish-core; cpl upload-prod-core",
+      "deploy-prod-query": "cpl publish-query; cpl upload-prod-query",
+
+      "pre-deploy-exp": "cpl sv $ARGS; cpl spu --environment=staging;",
+      "deploy-exp": "cpl deploy-exp-cli; cpl deploy-exp-core; cpl deploy-exp-query;",
+      "de": "cpl deploy-exp $ARGS",
+      "deploy-exp-cli": "cpl publish-cli; cpl upload-exp-cli",
+      "deploy-exp-core": "cpl publish-core; cpl upload-exp-core",
+      "deploy-exp-query": "cpl publish-query; cpl upload-exp-query",
+
+      "pre-deploy-dev": "cpl sv $ARGS; cpl spu --environment=development;",
+      "deploy-dev": "cpl deploy-dev-cli; cpl deploy-dev-core; cpl deploy-dev-query;",
+      "dd": "cpl deploy-dev $ARGS",
+      "deploy-dev-cli": "cpl publish-cli; cpl upload-dev-cli",
+      "deploy-dev-core": "cpl publish-core; cpl upload-dev-core",
+      "deploy-dev-query": "cpl publish-query; cpl upload-dev-query",
+
+      "dev-install": "cpl di-core; cpl di-cli; cpl di-query;",
+      "di": "cpl dev-install",
+      "di-core": "pip install cpl-core --pre --upgrade --extra-index-url https://pip-dev.sh-edraft.de",
+      "di-cli": "pip install cpl-cli --pre --upgrade --extra-index-url https://pip-dev.sh-edraft.de",
+      "di-query": "pip install cpl-query --pre --upgrade --extra-index-url https://pip-dev.sh-edraft.de"
+    }
+  }
+}

docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/build/html/.buildinfo

@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: 9ea51a00cf3559575c97b7efd7a002e5
+tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/build/html/_sources/cli.add.md.txt

@@ -0,0 +1,31 @@
+# cpl add
+
+## Contents
+
+- [Description](#description)
+- [Arguments](#arguments)
+
+Removes a project from workspace.
+
+cpl **add** *&lt;source-project&gt;* *&lt;target-project&gt;* <br>
+cpl **a** *&lt;source-project&gt;* *&lt;target-project&gt;* <br>
+cpl **A** *&lt;source-project&gt;* *&lt;target-project&gt;*
+
+## Description
+
+Adds a project reference to given project.
+
+If you call the command in a CPL workspace, you can use the project names. Otherwise the paths of the projects must be specified.
+
+## Arguments
+
+| Argument               |                        Description                         | Value type |
+|------------------------|:----------------------------------------------------------:|:----------:|
+| ```<source-project>``` | Name of the project to which the reference has to be added | ```str```  |
+| ```<target-project>``` |            Name of the project to be referenced            | ```str```  |
+
+## Flags
+
+| Argument         |                Description                 |
+|------------------|:------------------------------------------:|
+| ```--simulate``` | Specifies whether the command is simulated |

docs/build/html/_sources/cli.build.md.txt

@@ -0,0 +1,26 @@
+# cpl build
+
+## Contents
+
+- [Description](#description)
+<!-- - [Arguments](#arguments) -->
+
+Copies an python app into an output directory named build/ at the given output path. Must be executed within a CPL workspace or project directory
+
+cpl **build** <br>
+cpl **b** <br>
+cpl **B**
+
+## Description
+
+The command can be used to build a project of type "console" or "library".
+
+The build command copies all included source files to the output directory. You can run the source files in the output directory directly.
+
+The command is used to prepare the source files for the publish command or to copy them to an target for execution.
+
+<!-- ## Arguments
+
+| Argument      | Description   | Value type      |
+| ------------- |:-------------:|:----------------:|
+| ```<project>```     | The name of the project to build. Can be an console or a library. | ```str``` -->

docs/build/html/_sources/cli.generate.md.txt

@@ -0,0 +1,38 @@
+# cpl generate
+
+## Contents
+
+- [Description](#description)
+- [Arguments](#arguments)
+- [Schematics](#schematics)
+
+Generate a file based on schematic.
+
+cpl **generate** *&lt;schematic&gt;* *&lt;name&gt;* <br>
+cpl **g** *&lt;schematic&gt;* *&lt;name&gt;* <br>
+cpl **G** *&lt;schematic&gt;* *&lt;name&gt;*
+
+## Description
+
+Generates files based on a schematic.
+
+## Arguments
+
+| Argument          | Description                       | Value type    |
+| ----------------- |:---------------------------------:|:-------------:|
+| ```<schematic>``` | The schematic to generate.        | ```str```     |
+| ```<name>```      | The name of the generated file.   | ```str```     |
+
+## Schematics
+
+| Schematic       |              Description              |  Arguments   |
+|-----------------|:-------------------------------------:|:------------:|
+| ```abc```       |          Abstract base class          | ```<name>``` |
+| ```class```     |                 Class                 | ```<name>``` |
+| ```enum```      |              Enum class               | ```<name>``` |
+| ```pipe```      |              Pipe class               | ```<name>``` |
+| ```service```   |             Service class             | ```<name>``` |
+| ```settings```  | [Configmodel](cpl_core.configuration) | ```<name>``` |
+| ```test```      |              Test class               | ```<name>``` |
+| ```thread```    |             Thread class              | ```<name>``` |
+| ```validator``` |            Validator class            | ```<name>``` |

docs/build/html/_sources/cli.help.md.txt

@@ -0,0 +1,22 @@
+# cpl help
+
+<!-- ## Contents
+
+- [Description](#description) -->
+<!-- - [Arguments](#arguments) -->
+
+Lists available command and their short descriptions.
+
+cpl **help** *&lt;command&gt;* <br>
+cpl **h** *&lt;command&gt;* <br>
+cpl **H** *&lt;command&gt;*
+
+## Description
+
+Lists available command and their short descriptions.
+
+## Arguments
+
+| Argument          | Description                   | Value type    |
+| ----------------- |:-----------------------------:|:-------------:|
+| ```<command>```   | Shows a help message for this command in the console.   | ```str```     |

docs/build/html/_sources/cli.install.md.txt

@@ -0,0 +1,31 @@
+# cpl install
+
+## Contents
+
+- [Description](#description)
+- [Arguments](#arguments)
+
+Installs given package via pip
+
+cpl **install** *&lt;package&gt;* <br>
+cpl **i** *&lt;package&gt;* <br>
+cpl **I** *&lt;package&gt;*
+
+## Description
+
+Install given package to project via pip.
+Without given package it will install the depedencies of the CPL project your in.
+
+## Arguments
+
+| Argument        |      Description       | Value type |
+|-----------------|:----------------------:|:----------:|
+| ```<package>``` | The package to install | ```str```  |
+
+## Flags
+
+| Argument         |                     Description                      |
+|------------------|:----------------------------------------------------:|
+| ```--dev```      | Specifies whether the command is in development mode |
+| ```--virtual```  |    Specifies whether the command is virtual mode     |
+| ```--simulate``` |      Specifies whether the command is simulated      |

docs/build/html/_sources/cli.new.md.txt

@@ -0,0 +1,42 @@
+# cpl new
+
+## Contents
+
+- [Description](#description)
+- [Arguments](#arguments)
+- [Project types](#project-types)
+
+Generates a workspace and initial project or add a project to workspace.
+
+cpl **new** *&lt;type&gt;* *&lt;name&gt;*<br>
+cpl **n** *&lt;type&gt;* *&lt;name&gt;* <br>
+cpl **N** *&lt;type&gt;* *&lt;name&gt;*
+
+## Description
+
+Generates a workspace and initial project or add a project to workspace.
+
+If the command is running in a CPL workspace, it will add the new project to the workspace.
+
+| Argument     |                     Description                      | Value type |
+|--------------|:----------------------------------------------------:|:----------:|
+| ```<type>``` | The type of the project, see [types](#project-types) | ```str```  |
+| ```<name>``` |               The name of the project                | ```str```  |
+
+## Project types
+
+| Project type  |         Description          |
+|---------------|:----------------------------:|
+| ```console``` | A simple console application |
+| ```library``` |          A package           |
+
+## Flags
+
+| Argument                  |                 Description                 |
+|---------------------------|:-------------------------------------------:|
+| ```--async```             |       Specifies whether async is used       |
+| ```--application-base```  | Specifies whether application base is used  |
+| ```--startup```           |      Specifies whether startup is used      |
+| ```--service-providing``` | Specifies whether service-providing is used |
+| ```--nothing```           |      Specifies whether nothing is used      |
+| ```--venv```              |       Specifies whether venv is used        |

docs/build/html/_sources/cli.overview.md.txt

@@ -0,0 +1,53 @@
+# CLI Overview and Command Reference
+
+## Table of Contents
+
+1. [Install CPL](setup#install-the-package)
+2. [Install CPL CLI](setup#install-the-cli)
+3. [Basic workflow](#basic-workflow)
+4. [CLI command-language syntax](#cli-command-language-syntax)
+5. [Command overview](#command-overview)
+
+## Basic workflow
+
+To create, build, and serve a new, basic CPL project on a development server, go to the parent directory of your new workspace use the following commands:
+
+```sh
+cpl new console my-first-project
+cd my-first-project
+cpl start
+```
+
+In the terminal you will the output of the app.
+
+## CLI command-language syntax
+
+```cpl``` commandNameOrAlias requiredArg ```[optionalsArgs]```
+
+- Most commands, and some options, have aliases. Aliases are shown in the syntax statement for each command.
+- Arguments are not prefixed.
+
+### Relative paths
+
+Options that specify files can be given as absolute paths, or as paths relative to the current working directory, which is generally either the workspace or project root.
+
+### Schematics
+
+The cpl generate command takes as an argument the artifact to be generated.  In addition to any general options, each artifact defines its own options in a schematic. Schematic options are supplied to the command in the same format as immediate command options.
+
+## Command overview
+
+| Command                       | Alias         | Description      |
+| ----------------------------- |:-------------:|:----------------:|
+| [add](cli.add)               | a or a        | Adds a project reference to given project.
+| [build](cli.build)            | b or B        | Prepares files for publish into an output directory named dist/ at the given output path. Must be executed from within a workspace directory.
+| [generate](cli.generate)      | g or G        | Generate a new file.
+| [help](cli.help)              | h or H        | Lists available command and their short descriptions.
+| [install](cli.install)        | i or I        | With argument installs packages to project, without argument installs project dependencies.
+| [new](cli.new)                | n or N        | Creates new CPL project.
+| [publish](cli.publish)        | p or P        | Prepares files for publish into an output directory named dist/ at the given output path and executes ```setup.py```. Must be executed from within a library workspace directory.
+| [remove](cli.remove)          | r or R        | Removes a project from workspace.
+| [start](cli.start)            | s or S        | Starts CPL project, restarting on file changes.
+| [uninstall](cli.uninstall)    | ui or UI      | Uninstalls packages from project.
+| [update](cli.update)          | u or U        | Update CPL and project dependencies.
+| [version](cli.version)        | v or V        | Outputs CPL CLI version.

docs/build/html/_sources/cli.publish.md.txt

@@ -0,0 +1,27 @@
+# cpl publish
+
+## Contents
+
+- [Description](#description)
+<!-- - [Arguments](#arguments) -->
+
+Prepares files for publish into an output directory named dist/ at the given output path and executes ```setup.py```.
+
+cpl **publish** <br>
+cpl **p** <br>
+cpl **P**
+
+## Description
+
+The command can be used to publish a project of type "console" or "library".
+
+The publish command builds the source files and then creates an ```setup.py``` with data from ```cpl_core.json```.
+The command executes the ```setup.py``` and removes all source files with the ```setup.py``` from the 'publish/' directory.
+
+Generated files of ```setup.py``` are in the 'publish/setup/' directory.
+
+<!-- ## Arguments
+
+| Argument      | Description   | Value type      |
+| ------------- |:-------------:|:----------------:|
+| ```<project>```     | The name of the project to build. Can be an console or a library. | ```str``` -->

docs/build/html/_sources/cli.remove.md.txt

@@ -0,0 +1,30 @@
+# cpl remove
+
+## Contents
+
+- [Description](#description)
+- [Arguments](#arguments)
+
+Removes a project from workspace.
+
+cpl **remove** *&lt;project&gt;* <br>
+cpl **r** *&lt;project&gt;* <br>
+cpl **R** *&lt;project&gt;*
+
+## Description
+
+Removes a project reference and the files from workspace.
+
+If you call the command in a CPL workspace, you can use the project names. Otherwise the paths of the projects must be specified.
+
+## Arguments
+
+| Argument        |            Description            | Value type |
+|-----------------|:---------------------------------:|:----------:|
+| ```<project>``` | The name of the project to delete | ```str```  |
+
+## Flags
+
+| Argument         |                     Description                      |
+|------------------|:----------------------------------------------------:|
+| ```--simulate``` |      Specifies whether the command is simulated      |

docs/build/html/_sources/cli.start.md.txt

@@ -0,0 +1,7 @@
+# cpl start
+
+Starts your application, restarting on file changes.
+
+cpl **start** <br>
+cpl **s** <br>
+cpl **S**

docs/build/html/_sources/cli.uninstall.md.txt

@@ -0,0 +1,30 @@
+# cpl uninstall
+
+## Contents
+
+- [Description](#description)
+- [Arguments](#arguments)
+
+Uninstalls given package via pip
+
+cpl **uninstall** *&lt;package&gt;* <br>
+cpl **ui** *&lt;package&gt;* <br>
+cpl **UI** *&lt;package&gt;*
+
+## Description
+
+Uninstall given package from project via pip.
+
+## Arguments
+
+| Argument        |       Description        | Value type |
+|-----------------|:------------------------:|:----------:|
+| ```<package>``` | The package to uninstall | ```str```  |
+
+## Flags
+
+| Argument         |                     Description                      |
+|------------------|:----------------------------------------------------:|
+| ```--dev```      | Specifies whether the command is in development mode |
+| ```--virtual```  |    Specifies whether the command is virtual mode     |
+| ```--simulate``` |      Specifies whether the command is simulated      |

docs/build/html/_sources/cli.update.md.txt

@@ -0,0 +1,13 @@
+# cpl update
+
+Updates the CPL and project dependencies.
+
+cpl **update** <br>
+cpl **u** <br>
+cpl **U**
+
+## Flags
+
+| Argument         |                     Description                      |
+|------------------|:----------------------------------------------------:|
+| ```--simulate``` |      Specifies whether the command is simulated      |

docs/build/html/_sources/cli.version.md.txt

@@ -0,0 +1,7 @@
+# cpl version
+
+Lists the version of CPL, CPL CLI and all installed packages from pip.
+
+cpl **version** <br>
+cpl **v** <br>
+cpl **V**

docs/build/html/_sources/contributing.md.txt

@@ -0,0 +1,111 @@
+# Contributing to CPL
+
+We would love for you to contribute to CPL and help make it even better than it is today! As a contributor, here are the guidelines we would like you to follow:
+
+- [Issuses and Bugs](#found-a-bug)
+- [Feature Request](#feature-request)
+- [Submission Guidelines](#submission-guidelines)
+- [Coding Rules](#coding-rules)
+- [License](#license)
+
+## Found a Bug?
+
+If you find a bug in the source code, you can help us by [submitting an issue](#submitting-an-issue) to our [Gitea Repository][gitea-repo]. Even better, you can [submit a Pull Request](#submitting-a-pull-request) with a fix.
+
+## Feature Request
+
+You can request a new feature by submitting an issue to our [Gitea Repository][gitea-repo]. If you would like to implement a new feature, please consider the size of the change in order to determine the right steps to proceed:
+
+For a Major Feature, first open an issue and outline your proposal so that it can be discussed. This process allows us to better coordinate our efforts, prevent duplication of work, and help you to craft the change so that it is successfully accepted into the project.
+
+Note: Adding a new topic to the documentation, or significantly re-writing a topic, counts as a major feature.
+
+Small Features can be crafted and directly submitted as a [Pull Request](#submit-pr).
+
+## Submission Guidelines
+
+### Submitting an Issue
+
+Before you submit an issue, please search the issue tracker, maybe an issue for your problem already exists and the discussion might inform you of workarounds readily available.
+
+We want to fix all the issues as soon as possible, but before fixing a bug we need to reproduce and confirm it. In order to reproduce bugs, we require that you provide a minimal reproduction. Having a minimal reproducible scenario gives us a wealth of important information without going back and forth to you with additional questions.
+
+A minimal reproduction allows us to quickly confirm a bug (or point out a coding problem) as well as confirm that we are fixing the right problem.
+
+We require a minimal reproduction to save maintainers' time and ultimately be able to fix more bugs. Often, developers find coding problems themselves while preparing a minimal reproduction. We understand that sometimes it might be hard to extract essential bits of code from a larger codebase but we really need to isolate the problem before we can fix it.
+
+Unfortunately, we are not able to investigate / fix bugs without a minimal reproduction, so if we don't hear back from you, we are going to close an issue that doesn't have enough info to be reproduced.
+
+### Submitting a Pull Request
+
+Before you submit your Pull Request (PR) consider the following guidelines:
+
+1. Search the [repository][gitea-repo] for an open or closed PR that relates to your submission. You don't want to duplicate existing efforts.
+
+2. Be sure that an issue describes the problem you're fixing, or documents the design for the feature you'd like to add. Discussing the design upfront helps to ensure that we're ready to accept your work.
+
+3. Fork the sh-edraft.de/sh_cpl repo.
+
+4. In your forked repository, make your changes in a new git branch:
+
+    ```sh
+    git checkout -b my-fix-branch master
+    ```
+
+5. Create your patch, including appropriate test cases.
+
+<!-- 6. Follow our [Coding Rules](coding-rules). -->
+
+6. Commit your changes.
+
+    ```sh
+    git commit --all
+    ```
+
+    Note: the optional commit ```-a``` command line option will automatically "add" and "rm" edited files.
+
+7. Push your branch to the [repository][gitea-repo]:
+
+    ```sh
+    git push origin my-fix-branch
+    ```
+
+8. In Gitea, send a pull request to sh_cpl:master
+
+### Reviewing a Pull Request
+
+The sh-edraft.de team reserves the right not to accept pull requests from community members who haven't been good citizens of the community. Such behavior includes not following the CPL [coding rules](#coding-rules) and applies within or outside of CPL managed channels.
+
+#### Addressing review feedback
+
+If we ask for changes via code reviews then:
+
+1. Make the required updates to the code.
+
+2. Create a fixup commit and push to your repository (this will update your Pull Request):
+
+    ```sh
+    git commit --all --fixup HEAD
+    git push
+    ```
+
+That's it! Thank you for your contribution!
+
+## Coding Rules
+
+To ensure consistency throughout the source code, keep these rules in mind as you are working:
+
+- All features or bug fixes must be tested by one or more unit-tests.
+
+- All public API methods must be documented.
+
+- We follow [PEP 8 -- Style Guide for Python Code](https://www.python.org/dev/peps/pep-0008/).
+
+## License
+
+By contributing, you agree that your contributions will be licensed under its MIT License.
+See [LICENSE](https://git.sh-edraft.de/sh-edraft.de/sh_cpl/src/branch/master/LICENSE)
+
+<!-- LINKS -->
+[gitea-repo]: https://git.sh-edraft.de/sh-edraft.de/sh_cpl/
+[coding-rules]: /

docs/build/html/_sources/cpl_cli.rst.txt

@@ -0,0 +1,19 @@
+CLI Reference
+=============
+
+.. toctree::
+    :maxdepth: 4
+
+    cli.overview
+    cli.add
+    cli.build
+    cli.generate
+    cli.help
+    cli.install
+    cli.new
+    cli.publish
+    cli.remove
+    cli.start
+    cli.uninstall
+    cli.update
+    cli.version

docs/build/html/_sources/cpl_core.application.rst.txt

@@ -0,0 +1,34 @@
+cpl_core.application
+=======================
+
+cpl_core.application.application\_abc
+---------------------------------------
+
+.. automodule:: cpl_core.application.application_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.application.application\_builder
+-------------------------------------------
+
+.. automodule:: cpl_core.application.application_builder
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.application.application\_builder\_abc
+------------------------------------------------
+
+.. automodule:: cpl_core.application.application_builder_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.application.startup\_abc
+-----------------------------------
+
+.. automodule:: cpl_core.application.startup_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_core.configuration.rst.txt

@@ -0,0 +1,42 @@
+cpl_core.configuration
+=========================
+
+cpl_core.configuration.configuration
+--------------------------------------
+
+.. automodule:: cpl_core.configuration.configuration
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.configuration.configuration\_abc
+-------------------------------------------
+
+.. automodule:: cpl_core.configuration.configuration_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.configuration.configuration\_model\_abc
+--------------------------------------------------
+
+.. automodule:: cpl_core.configuration.configuration_model_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.configuration.configuration\_variable\_name\_enum
+------------------------------------------------------------
+
+.. automodule:: cpl_core.configuration.configuration_variable_name_enum
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.configuration.console\_argument
+------------------------------------------
+
+.. automodule:: cpl_core.configuration.console_argument
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_core.console.rst.txt

@@ -0,0 +1,42 @@
+cpl_core.console
+===================
+
+cpl_core.console.background\_color\_enum
+------------------------------------------
+
+.. automodule:: cpl_core.console.background_color_enum
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.console.console
+--------------------------
+
+.. automodule:: cpl_core.console.console
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.console.console\_call
+--------------------------------
+
+.. automodule:: cpl_core.console.console_call
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.console.foreground\_color\_enum
+------------------------------------------
+
+.. automodule:: cpl_core.console.foreground_color_enum
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.console.spinner\_thread
+----------------------------------
+
+.. automodule:: cpl_core.console.spinner_thread
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_core.database.connection.rst.txt

@@ -0,0 +1,18 @@
+cpl_core.database.connection
+===============================
+
+cpl_core.database.connection.database\_connection
+---------------------------------------------------
+
+.. automodule:: cpl_core.database.connection.database_connection
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.database.connection.database\_connection\_abc
+--------------------------------------------------------
+
+.. automodule:: cpl_core.database.connection.database_connection_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_core.database.context.rst.txt

@@ -0,0 +1,18 @@
+cpl_core.database.context
+============================
+
+cpl_core.database.context.database\_context
+---------------------------------------------
+
+.. automodule:: cpl_core.database.context.database_context
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.database.context.database\_context\_abc
+--------------------------------------------------
+
+.. automodule:: cpl_core.database.context.database_context_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_core.database.rst.txt

@@ -0,0 +1,35 @@
+cpl_core.database
+====================
+
+.. toctree::
+   :maxdepth: 4
+
+   cpl_core.database.connection
+   cpl_core.database.context
+
+Submodules
+----------
+
+cpl_core.database.database\_model
+-----------------------------------
+
+.. automodule:: cpl_core.database.database_model
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.database.database\_settings
+--------------------------------------
+
+.. automodule:: cpl_core.database.database_settings
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.database.database\_settings\_name\_enum
+--------------------------------------------------
+
+.. automodule:: cpl_core.database.database_settings_name_enum
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_core.dependency_injection.rst.txt

@@ -0,0 +1,50 @@
+cpl_core.dependency\_injection
+=================================
+
+cpl_core.dependency\_injection.service\_collection
+----------------------------------------------------
+
+.. automodule:: cpl_core.dependency_injection.service_collection
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.dependency\_injection.service\_collection\_abc
+---------------------------------------------------------
+
+.. automodule:: cpl_core.dependency_injection.service_collection_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.dependency\_injection.service\_descriptor
+----------------------------------------------------
+
+.. automodule:: cpl_core.dependency_injection.service_descriptor
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.dependency\_injection.service\_lifetime\_enum
+--------------------------------------------------------
+
+.. automodule:: cpl_core.dependency_injection.service_lifetime_enum
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.dependency\_injection.service\_provider
+--------------------------------------------------
+
+.. automodule:: cpl_core.dependency_injection.service_provider
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.dependency\_injection.service\_provider\_abc
+-------------------------------------------------------
+
+.. automodule:: cpl_core.dependency_injection.service_provider_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_core.environment.rst.txt

@@ -0,0 +1,26 @@
+cpl_core.environment
+=======================
+
+cpl_core.environment.application\_environment
+-----------------------------------------------
+
+.. automodule:: cpl_core.environment.application_environment
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.environment.application\_environment\_abc
+----------------------------------------------------
+
+.. automodule:: cpl_core.environment.application_environment_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.environment.environment\_name\_enum
+----------------------------------------------
+
+.. automodule:: cpl_core.environment.environment_name_enum
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_core.logging.rst.txt

@@ -0,0 +1,42 @@
+cpl_core.logging
+===================
+
+cpl_core.logging.logger\_abc
+------------------------------
+
+.. automodule:: cpl_core.logging.logger_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.logging.logger\_service
+----------------------------------
+
+.. automodule:: cpl_core.logging.logger_service
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.logging.logging\_level\_enum
+---------------------------------------
+
+.. automodule:: cpl_core.logging.logging_level_enum
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.logging.logging\_settings
+------------------------------------
+
+.. automodule:: cpl_core.logging.logging_settings
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.logging.logging\_settings\_name\_enum
+------------------------------------------------
+
+.. automodule:: cpl_core.logging.logging_settings_name_enum
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_core.mailing.rst.txt

@@ -0,0 +1,42 @@
+cpl_core.mailing
+===================
+
+cpl_core.mailing.email
+------------------------
+
+.. automodule:: cpl_core.mailing.email
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.mailing.email\_client\_abc
+-------------------------------------
+
+.. automodule:: cpl_core.mailing.email_client_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.mailing.email\_client\_service
+-----------------------------------------
+
+.. automodule:: cpl_core.mailing.email_client_service
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.mailing.email\_client\_settings
+------------------------------------------
+
+.. automodule:: cpl_core.mailing.email_client_settings
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.mailing.email\_client\_settings\_name\_enum
+------------------------------------------------------
+
+.. automodule:: cpl_core.mailing.email_client_settings_name_enum
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_core.pipes.rst.txt

@@ -0,0 +1,77 @@
+cpl\_core.pipes
+=======================
+
+Submodules
+----------
+
+cpl\_core.pipes.bool\_pipe module
+---------------------------------
+
+.. automodule:: cpl_core.pipes.bool_pipe
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl\_core.pipes.first\_char\_to\_lower\_pipe module
+---------------------------------------------------
+
+.. automodule:: cpl_core.pipes.first_char_to_lower_pipe
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl\_core.pipes.first\_to\_upper\_pipe module
+---------------------------------------------
+
+.. automodule:: cpl_core.pipes.first_to_upper_pipe
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl\_core.pipes.ip\_address\_pipe module
+----------------------------------------
+
+.. automodule:: cpl_core.pipes.ip_address_pipe
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl\_core.pipes.pipe\_abc module
+--------------------------------
+
+.. automodule:: cpl_core.pipes.pipe_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl\_core.pipes.to\_camel\_case\_pipe module
+--------------------------------------------
+
+.. automodule:: cpl_core.pipes.to_camel_case_pipe
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl\_core.pipes.to\_snake\_case\_pipe module
+--------------------------------------------
+
+.. automodule:: cpl_core.pipes.to_snake_case_pipe
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl\_core.pipes.version\_pipe module
+------------------------------------
+
+.. automodule:: cpl_core.pipes.version_pipe
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Module contents
+---------------
+
+.. automodule:: cpl_core.pipes
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_core.rst.txt

@@ -0,0 +1,17 @@
+API Reference
+===========
+
+.. toctree::
+    :maxdepth: 4
+
+    cpl_core.application
+    cpl_core.configuration
+    cpl_core.console
+    cpl_core.database
+    cpl_core.dependency_injection
+    cpl_core.environment
+    cpl_core.logging
+    cpl_core.mailing
+    cpl_core.pipes
+    cpl_core.time
+    cpl_core.utils

docs/build/html/_sources/cpl_core.time.rst.txt

@@ -0,0 +1,18 @@
+cpl_core.time
+================
+
+cpl_core.time.time\_format\_settings
+--------------------------------------
+
+.. automodule:: cpl_core.time.time_format_settings
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.time.time\_format\_settings\_names\_enum
+---------------------------------------------------
+
+.. automodule:: cpl_core.time.time_format_settings_names_enum
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_core.utils.rst.txt

@@ -0,0 +1,26 @@
+cpl_core.utils
+=================
+
+cpl_core.utils.credential\_manager
+------------------------------------
+
+.. automodule:: cpl_core.utils.credential_manager
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.utils.pip
+--------------------
+
+.. automodule:: cpl_core.utils.pip
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_core.utils.string
+-----------------------
+
+.. automodule:: cpl_core.utils.string
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_query.exceptions.rst.txt

@@ -0,0 +1,10 @@
+cpl_query.exceptions
+=================================
+
+cpl_query.exceptions
+----------------------------------------------------
+
+.. automodule:: cpl_query.exceptions
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_query.extension.rst.txt

@@ -0,0 +1,42 @@
+cpl_query.extension
+=================================
+
+cpl_query.extension.iterable_abc
+----------------------------------------------------
+
+.. automodule:: cpl_query.extension.iterable_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_query.extension.iterable
+----------------------------------------------------
+
+.. automodule:: cpl_query.extension.iterable
+   :members:
+   :undoc-members:
+   :show-inheritance:
+   
+cpl_query.extension.list
+----------------------------------------------------
+
+.. automodule:: cpl_query.extension.list
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_query.extension.ordered_iterable_abc
+----------------------------------------------------
+
+.. automodule:: cpl_query.extension.ordered_iterable_abc
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cpl_query.extension.ordered_iterable
+----------------------------------------------------
+
+.. automodule:: cpl_query.extension.ordered_iterable
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/build/html/_sources/cpl_query.rst.txt

@@ -0,0 +1,8 @@
+Query Reference
+===========
+
+.. toctree::
+    :maxdepth: 4
+   
+    cpl_query.extension
+    cpl_query.exceptions

docs/build/html/_sources/getting_started.rst.txt

@@ -0,0 +1,10 @@
+Getting started
+===============
+
+.. toctree::
+    :maxdepth: 4
+
+    quickstart
+    setup
+    tutorials
+

docs/build/html/_sources/index.rst.txt

@@ -0,0 +1,25 @@
+.. Common Python Library documentation master file, created by
+   sphinx-quickstart on Wed Apr 14 10:25:36 2021.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Introduction to the CPL Docs
+============================
+
+The Common Python Library (CPL) is a package for python and a development platform meant to help you create simple and efficient server and desktop applications.
+
+This CPL docs help you learn, understand and use the package. From your first application to complex apps for enterprises.
+
+Manuals
+---------
+
+These pages go into great detail about everything the Library can do.
+
+.. toctree::
+   :maxdepth: 1
+
+   introduction
+   getting_started
+   cpl_cli
+   cpl_core
+   cpl_query

docs/build/html/_sources/introduction.md.txt

@@ -0,0 +1,60 @@
+# Introduction to the CPL Docs
+
+The Common Python Library (CPL) is a package for python and a development platform meant to help you create simple and efficient server and desktop applications.
+
+This CPL docs help you learn, understand and use the package. From your first application to complex apps for enterprises.
+
+## Feature overview
+
+- Expandle
+- Application base
+  - Standardized application classes
+  - Application object builder
+  - Application extension classes
+  - Startup classes
+  - Startup extension classes
+- Configuration
+  - Configure via object mapped JSON
+  - Console argument handling
+- Console class for in and output
+  - Banner
+  - Spinner
+  - Options (menu)
+  - Table
+  - Write
+  - Write_at
+  - Write_line
+  - Write_line_at
+- Dependency injection
+  - Service lifetimes: singleton, scoped and transient
+- Providing of application environment
+  - Environment (development, staging, testing, production)
+  - Appname
+  - Customer
+  - Hostname
+  - Runtime directory
+  - Working directory
+- Logging
+  - Standardized logger
+  - Log-level (FATAL, ERROR, WARN, INFO, DEBUG & TRACE)
+- Mail handling
+  - Send mails
+- Pipe classes
+  - Convert input
+- Utils
+  - Credential manager
+    - Encryption via BASE64
+  - PIP wrapper class based on subprocess
+    - Run pip commands
+  - String converter to different variants
+    - to_lower_case
+    - to_camel_case
+    - ...
+
+## Explore
+
+- [Getting started](quickstart)
+- [Setup](setup)
+- [API Reference](cpl_core)
+- [CLI Reference](cli.overview)
+- [Query Reference](cpl_query)

docs/build/html/_sources/modules.rst.txt

@@ -0,0 +1,10 @@
+cpl
+===
+
+.. toctree::
+    :maxdepth: 4
+
+    getting_started
+    cpl_cli
+    cpl_core
+    cpl_query

docs/build/html/_sources/quickstart.md.txt

@@ -0,0 +1,210 @@
+# Getting started with CPL
+
+Welcome to CPL!
+
+This tutorial introduces you to the essentials of the CPL package by walking through building an console based app.
+
+## Table of Contents
+
+1. [Prerequisites](#prerequisites)
+2. [Create the project](#create-the-project)
+3. [Create a menu](#create-a-menu)
+4. [What's next](#whats-next)
+
+## Prerequisites
+
+To get most out of this tutorial you should already have a basic understanding of the following.
+
+- [Python][python]
+
+Also you need to have the following installed.
+
+- [Python][python]
+- [Pip][pip-url]
+- [CPL](setup)
+- [CPL-CLI](setup)
+
+## Create the project
+
+To create the sample project to the following:
+
+1. Open a terminal
+2. Run
+
+    ```sh
+    cpl new console sample-project
+    ```
+
+3. We don't want to use Application base or Dependency injection:
+
+    ```sh
+    Do you want to use application base? (y/n) n
+
+    Do you want to use service providing? (y/n) n
+    ```
+
+    The ouput should look like this:
+
+    ```sh
+    Creating sample-project/LICENSE                                                                     done
+    Creating sample-project/README.md                                                                   done
+    Creating sample-project/src/tests/__init__.py                                                       done
+    Creating sample-project/appsettings.json                                                            done
+    Creating sample-project/src/sample-project/__init__.py                                              done
+    Creating sample-project/src/sample-projectmain.py                                                   done
+    ```
+
+4. Open the project with an IDE like VS Code or PyCharm
+
+    ![IDE](images/ide.png)
+
+5. Set the 'src' directory as source folder
+
+    ![IDE set src folder](images/ide-src.png)
+
+6. Run the application
+
+    You should see an output like:
+
+    ```sh
+    Hello World
+    ```
+
+7. In PyCharm you have to enable ```Emulate terminal in output console```!
+
+    ![IDE emulate console](images/ide-emulate.png)
+
+## Create a menu
+
+1. Open the 'sample-project/main.py'
+
+2. Change 'Hello World' to 'Password generator:' in line 5
+
+3. Add ```Console.select``` as follows:
+
+    ```py
+    from cpl_core.console import Console
+
+
+    def main():
+        Console.write_line('Password generator:')
+        options = [
+            'Only lower case',
+            'Only upper case',
+            'Lower and upper case'
+            'Exit'
+        ]
+        option = Console.select('>', 'Select option: ', options)
+
+
+    if __name__ == '__main__':
+        main()
+    
+    ```
+
+4. Get Id of the selected option:
+
+    ```py
+    index = options.index(option)
+    ```
+
+5. Create the generate function as follows:
+
+    ```py
+    def generate_password(letters: str, length: int) -> str:
+        return ''.join(random.choice(letters) for i in range(length))
+    ```
+
+    Add imports:
+
+    ```py
+    import random
+    import string
+    ```
+
+6. Get length of the password:
+
+    ```py
+    length = int(Console.read('Length: '))
+    ```
+
+7. Validate the selected option:
+
+    ```py
+    index = options.index(option)
+    letters = ''
+    
+    if index == 0:
+        letters = string.ascii_lowercase
+    elif index == 1:
+        letters = string.ascii_uppercase
+    elif index == 2:
+        letters = string.ascii_letters
+    elif index == len(options) - 1:
+        exit()
+    ```
+
+8. Print the generated password:
+
+    ```py
+    Console.write_line('Password: ', generate_password(letters, length))
+    ```
+
+9. The full 'sample-project/main.py':
+
+    ```py
+    import random
+    import string
+
+    from cpl_core.console import Console
+
+
+    def generate_password(letters: str, length: int) -> str:
+        return ''.join(random.choice(letters) for i in range(length))
+
+
+    def main():
+        Console.write_line('Password generator:')
+        options = [
+            'Only lower case',
+            'Only upper case',
+            'Lower and upper case',
+            'Exit'
+        ]
+        option = Console.select('>', 'Select option: ', options)
+
+        length = int(Console.read('Length: '))
+
+        index = options.index(option)
+        letters = ''
+        if index == 0:
+            letters = string.ascii_lowercase
+        elif index == 1:
+            letters = string.ascii_uppercase
+        elif index == 2:
+            letters = string.ascii_letters
+        elif index == len(options) - 1:
+            exit()
+
+        Console.write_line('Password: ', generate_password(letters, length))
+
+
+    if __name__ == '__main__':
+        main()
+
+    ```
+
+## What's next
+
+In this section, you've created an application that uses user input to generate a password.
+
+To continue exploring CPL and developing applications:
+
+- [Application base](cpl_core.application)
+- [Dependency injection](cpl_core.dependency_injection)
+- [Console](cpl_core.console)
+
+<!-- LINKS -->
+[pip-url]: https://pip.sh-edraft.de
+[python]: https://www.python.org/
+[pip]: https://pypi.org/project/pip/

docs/build/html/_sources/setup.md.txt

@@ -0,0 +1,113 @@
+# Setting up the local environment and workspace
+
+## Table of Contents
+
+1. [Prerequisites](#prerequisites)
+2. [Install the package](#install-the-package)
+3. [Install the CLI](#install-the-cli)
+3. [Install the query](#install-the-query)
+4. [Create a initial application](#create-initial-console-app)
+5. [Create a initial library](#create-initial-library)
+6. [Start the application](#start-the-app)
+7. [What's next](#whats-next)
+
+## Prerequisites
+
+To get most out of this tutorial you should already have a basic understanding of the following.
+
+- [Python][python]
+
+Also you need to have the following installed.
+
+- [Python][python]
+- [Pip][pip-url]
+
+## Install the package
+
+To install the package, open a terminal window and run the following command:
+
+```sh
+pip install sh_cpl-core --extra-index-url https://pip.sh-edraft.de
+```
+
+## Install the CLI
+
+You use the CPL CLI to create projects, generate application and library code. You also use the CLI to build and publish your python packages.
+
+To install the CLI, open a terminal window and run the following command:
+
+```sh
+pip install sh_cpl-cli --extra-index-url https://pip.sh-edraft.de
+```
+
+## Install the query
+
+To install the package, open a terminal window and run the following command:
+
+```sh
+pip install sh_cpl-query --extra-index-url https://pip.sh-edraft.de
+```
+
+## Create initial console app
+
+You develop apps and packages in the context of an CPL project which is defined in an cpl_core.json.
+
+1. Run the CLI command ```cpl new console``` and provide the name my-app, as shown here:
+
+    ```sh
+    cpl new console my-app
+    ```
+
+2. The cpl new command prompts you for information about features to include in the initial app. Decline the defaults by enter 'n' and press the Enter key.
+
+The CLI create a new workspace and a simple 'Hello World' app, ready to run.
+
+## Create initial library
+
+You develop apps and packages in the context of an CPL project which is defined in an cpl_core.json.
+
+1. Run the CLI command ```cpl new library``` and provide the name my-lib, as shown here:
+
+    ```sh
+    cpl new library my-lib
+    ```
+
+2. The cpl new command prompts you for information about features to include in the initial library. Decline the defaults by enter 'n' and press the Enter key.
+
+The CLI create a new workspace and a simple 'Hello World' library with CLI, ready to run.
+
+## Start the app
+
+The CLI includes a live development server, so that you can run your app locally.
+
+1. Open a terminal window
+
+2. To navigate to your project workspace, run the following command:
+
+    ```sh
+    cd /path/to/project/name
+    ```
+
+3. To run the app run:
+
+    ```sh
+    cpl start
+    ```
+
+The ```cpl start``` command launches the server, watches your source files, and restarts the app as you make chnages to thoses source files.
+
+If your installation and setup was successful, you should see a output similar to the following:
+
+```sh
+Hello World
+```
+
+## What's next
+
+- To learn more about the CPL CLI, see the [CLI Overview](cli.overview)
+- Fore more informations about the Pyhton files generated by ```cpl new```, see [New Command](cli.new)
+
+<!-- LINKS -->
+[pip-url]: https://pip.sh-edraft.de
+[python]: https://www.python.org/
+[pip]: https://pypi.org/project/pip/

docs/build/html/_sources/tutorials.appsettings.md.txt

@@ -0,0 +1,3 @@
+# Using appsettings.json
+
+## Comming soon

docs/build/html/_sources/tutorials.console-arguments.md.txt

@@ -0,0 +1,3 @@
+# Handle console arguments
+
+## Comming soon

docs/build/html/_sources/tutorials.console.md.txt

@@ -0,0 +1,3 @@
+# Use cpl_core.console.Console
+
+## Comming soon