Release 2022.12.0

Reviewed-on: #132
Closes #122

.gitignore

@@ -106,6 +106,7 @@ celerybeat.pid
 .venv
 env/
 venv/
+venv_*/
 ENV/
 env.bak/
 venv.bak/
@@ -132,5 +133,8 @@ dmypy.json
 .pyre/
 
 # IDE
-.vscode/
 .idea/
+PythonImportHelper-v2-Completion.json
+
+# cpl unittest stuff
+unittests/test_*_playground

LICENSE

@@ -1,4 +1,4 @@
-MIT License Copyright (c) 2020 - 2021 sh-edraft.de
+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

@@ -13,6 +13,7 @@
 ## Table of Contents
 <!-- TABLE OF CONTENTS -->
 <ol>
+   <li><a href="#Features">Features</a></li>
    <li>
      <a href="#getting-started">Getting Started</a>
      <ul>
@@ -26,6 +27,52 @@
    <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

cpl-workspace.json

@@ -1,11 +1,145 @@
 {
   "WorkspaceSettings": {
-    "DefaultProject": "cpl_cli",
+    "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"
+      "cpl-cli": "src/cpl_cli/cpl-cli.json",
+      "cpl-core": "src/cpl_core/cpl-core.json",
+      "cpl-discord": "src/cpl_discord/cpl-discord.json",
+      "cpl-query": "src/cpl_query/cpl-query.json",
+      "cpl-translation": "src/cpl_translation/cpl-translation.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",
+      "unittests_translation": "unittests/unittests_translation/unittests_translation.json"
     },
-    "Scripts": {}
+    "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-discord; cpl build-query; cpl build-translation; 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-discord": "echo 'Build cpl-discord'; cd ./src/cpl_discord; cpl build; cd ../../;",
+      "build-query": "echo 'Build cpl-query'; cd ./src/cpl_query; cpl build; cd ../../;",
+      "build-translation": "echo 'Build cpl-translation'; cd ./src/cpl_translation; 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-discord; cpl publish-query; cpl publish-translation;",
+      "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-discord": "echo 'Publish cpl-discord'; cd ./src/cpl_discord; cpl publish; cd ../../;",
+      "publish-query": "echo 'Publish cpl-query'; cd ./src/cpl_query; cpl publish; cd ../../;",
+      "publish-translation": "echo 'Publish cpl-translation'; cd ./src/cpl_translation; 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-discord": "echo 'PROD Upload cpl-discord'; cpl upl-prod-discord;",
+      "upl-prod-discord": "twine upload -r pip.sh-edraft.de dist/cpl-discord/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-prod-translation": "echo 'PROD Upload cpl-translation'; cpl upl-prod-translation;",
+      "upl-prod-translation": "twine upload -r pip.sh-edraft.de dist/cpl-translation/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-discord": "echo 'EXP Upload cpl-discord'; cpl upl-exp-discord;",
+      "upl-exp-discord": "twine upload -r pip-exp.sh-edraft.de dist/cpl-discord/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-exp-translation": "echo 'EXP Upload cpl-translation'; cpl upl-exp-translation;",
+      "upl-exp-translation": "twine upload -r pip-exp.sh-edraft.de dist/cpl-translation/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-discord": "echo 'DEV Upload cpl-discord'; cpl upl-dev-discord;",
+      "upl-dev-discord": "twine upload -r pip-dev.sh-edraft.de dist/cpl-discord/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/*",
+
+      "upload-dev-translation": "echo 'DEV Upload cpl-translation'; cpl upl-dev-translation;",
+      "upl-dev-translation": "twine upload -r pip-dev.sh-edraft.de dist/cpl-translation/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-discord; cpl deploy-prod-query; cpl deploy-prod-translation;",
+      "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",
+      "deploy-prod-discord": "cpl publish-discord; cpl upload-prod-discord",
+      "deploy-prod-translation": "cpl publish-translation; cpl upload-prod-translation",
+
+      "pre-deploy-exp": "cpl sv $ARGS; cpl spu --environment=staging;",
+      "deploy-exp": "cpl deploy-exp-cli; cpl deploy-exp-core; cpl deploy-exp-discord; cpl deploy-exp-query; cpl deploy-exp-translation;",
+      "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-discord": "cpl publish-discord; cpl upload-exp-discord",
+      "deploy-exp-query": "cpl publish-query; cpl upload-exp-query",
+      "deploy-exp-translation": "cpl publish-translation; cpl upload-exp-translation",
+
+      "pre-deploy-dev": "cpl sv $ARGS; cpl spu --environment=development;",
+      "deploy-dev": "cpl deploy-dev-cli; cpl deploy-dev-core; cpl deploy-dev-discord; cpl deploy-dev-query; cpl deploy-dev-translation;",
+      "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-discord": "cpl publish-discord; cpl upload-dev-discord",
+      "deploy-dev-query": "cpl publish-query; cpl upload-dev-query",
+      "deploy-dev-translation": "cpl publish-query; cpl upload-dev-translation",
+
+      "dev-install": "cpl di-core; cpl di-cli; cpl di-query; cpl di-translation;",
+      "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-discord": "pip install cpl-discord --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",
+      "di-translation": "pip install cpl-translation --pre --upgrade --extra-index-url https://pip-dev.sh-edraft.de",
+
+      "prod-install": "cpl pi-core; cpl pi-cli; cpl pi-query; cpl pi-translation;",
+      "pi": "cpl prod-install",
+      "pi-core": "pip install cpl-core --pre --upgrade --extra-index-url https://pip.sh-edraft.de",
+      "pi-cli": "pip install cpl-cli --pre --upgrade --extra-index-url https://pip.sh-edraft.de",
+      "pi-discord": "pip install cpl-discord --pre --upgrade --extra-index-url https://pip.sh-edraft.de",
+      "pi-query": "pip install cpl-query --pre --upgrade --extra-index-url https://pip.sh-edraft.de",
+      "pi-translation": "pip install cpl-translation --pre --upgrade --extra-index-url https://pip.sh-edraft.de"
+    }
   }
 }

docs/build/html/.buildinfo

@@ -1,4 +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: 8170277cf12e5442e6180427108a8adf
+config: 9ea51a00cf3559575c97b7efd7a002e5
 tags: 645f666f9bcd5a90fca523b33c5a78b7

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

@@ -4,6 +4,7 @@
 
 - [Description](#description)
 - [Arguments](#arguments)
+- [Flags](#flags)
 
 Removes a project from workspace.
 
@@ -19,7 +20,13 @@ If you call the command in a CPL workspace, you can use the project names. Other
 
 ## 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```
+| 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.generate.md.txt

@@ -25,11 +25,14 @@ Generates files based on a schematic.
 
 ## Schematics
 
-| Schematic         | Description         | Arguments      |
-| ----------------- |:-------------------:|:----------------:|
-| ```abc```         | Abstract base class | ```<name>```
-| ```class```       | Class               | ```<name>```
-| ```enum```        | Enum class          | ```<name>```
-| ```service```     | Service class       | ```<name>```
-| ```settings```    | [Configmodel](cpl.configuration) | ```<name>```
-| ```thread```      | Thread class        | ```<name>```
+| 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

@@ -1,9 +1,9 @@
 # cpl help
 
-<!-- ## Contents
+## Contents
 
-- [Description](#description) -->
-<!-- - [Arguments](#arguments) -->
+- [Description](#description)
+- [Arguments](#arguments)
 
 Lists available command and their short descriptions.
 

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

@@ -18,6 +18,14 @@ 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```     |
+| 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

@@ -18,14 +18,25 @@ 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```     |
+| 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                     |
+| 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.publish.md.txt

@@ -15,7 +15,7 @@ cpl **P**
 
 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.json```.
+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.

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

@@ -13,15 +13,18 @@ cpl **R** *<project>*
 
 ## Description
 
-The command can be used to publish a project of type "console" or "library".
+Removes a project reference and the files from workspace.
 
-The publish command builds the source files and then creates an ```setup.py``` with data from ```cpl.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.
+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```
+| 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.uninstall.md.txt

@@ -17,6 +17,14 @@ Uninstall given package from project via pip.
 
 ## Arguments
 
-| Argument          | Description                   | Value type    |
-| ----------------- |:-----------------------------:|:-------------:|
-| ```<package>```   | The package to uninstall      | ```str```     |
+| 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

@@ -5,3 +5,9 @@ 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/cpl.configuration.rst.txt

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,34 +1,34 @@
-cpl.application
+cpl_core.application
 =======================
 
-cpl.application.application\_abc
+cpl_core.application.application\_abc
 ---------------------------------------
 
-.. automodule:: cpl.application.application_abc
+.. automodule:: cpl_core.application.application_abc
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.application.application\_builder
+cpl_core.application.application\_builder
 -------------------------------------------
 
-.. automodule:: cpl.application.application_builder
+.. automodule:: cpl_core.application.application_builder
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.application.application\_builder\_abc
+cpl_core.application.application\_builder\_abc
 ------------------------------------------------
 
-.. automodule:: cpl.application.application_builder_abc
+.. automodule:: cpl_core.application.application_builder_abc
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.application.startup\_abc
+cpl_core.application.startup\_abc
 -----------------------------------
 
-.. automodule:: cpl.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

@@ -1,42 +1,42 @@
-cpl.console
+cpl_core.console
 ===================
 
-cpl.console.background\_color\_enum
+cpl_core.console.background\_color\_enum
 ------------------------------------------
 
-.. automodule:: cpl.console.background_color_enum
+.. automodule:: cpl_core.console.background_color_enum
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.console.console
+cpl_core.console.console
 --------------------------
 
-.. automodule:: cpl.console.console
+.. automodule:: cpl_core.console.console
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.console.console\_call
+cpl_core.console.console\_call
 --------------------------------
 
-.. automodule:: cpl.console.console_call
+.. automodule:: cpl_core.console.console_call
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.console.foreground\_color\_enum
+cpl_core.console.foreground\_color\_enum
 ------------------------------------------
 
-.. automodule:: cpl.console.foreground_color_enum
+.. automodule:: cpl_core.console.foreground_color_enum
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.console.spinner\_thread
+cpl_core.console.spinner\_thread
 ----------------------------------
 
-.. automodule:: cpl.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

@@ -1,35 +1,35 @@
-cpl.database
+cpl_core.database
 ====================
 
 .. toctree::
    :maxdepth: 4
 
-   cpl.database.connection
-   cpl.database.context
+   cpl_core.database.connection
+   cpl_core.database.context
 
 Submodules
 ----------
 
-cpl.database.database\_model
+cpl_core.database.database\_model
 -----------------------------------
 
-.. automodule:: cpl.database.database_model
+.. automodule:: cpl_core.database.database_model
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.database.database\_settings
+cpl_core.database.database\_settings
 --------------------------------------
 
-.. automodule:: cpl.database.database_settings
+.. automodule:: cpl_core.database.database_settings
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.database.database\_settings\_name\_enum
+cpl_core.database.database\_settings\_name\_enum
 --------------------------------------------------
 
-.. automodule:: cpl.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

@@ -1,42 +1,42 @@
-cpl.logging
+cpl_core.logging
 ===================
 
-cpl.logging.logger\_abc
+cpl_core.logging.logger\_abc
 ------------------------------
 
-.. automodule:: cpl.logging.logger_abc
+.. automodule:: cpl_core.logging.logger_abc
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.logging.logger\_service
+cpl_core.logging.logger\_service
 ----------------------------------
 
-.. automodule:: cpl.logging.logger_service
+.. automodule:: cpl_core.logging.logger_service
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.logging.logging\_level\_enum
+cpl_core.logging.logging\_level\_enum
 ---------------------------------------
 
-.. automodule:: cpl.logging.logging_level_enum
+.. automodule:: cpl_core.logging.logging_level_enum
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.logging.logging\_settings
+cpl_core.logging.logging\_settings
 ------------------------------------
 
-.. automodule:: cpl.logging.logging_settings
+.. automodule:: cpl_core.logging.logging_settings
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.logging.logging\_settings\_name\_enum
+cpl_core.logging.logging\_settings\_name\_enum
 ------------------------------------------------
 
-.. automodule:: cpl.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

@@ -1,42 +1,42 @@
-cpl.mailing
+cpl_core.mailing
 ===================
 
-cpl.mailing.email
+cpl_core.mailing.email
 ------------------------
 
-.. automodule:: cpl.mailing.email
+.. automodule:: cpl_core.mailing.email
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.mailing.email\_client\_abc
+cpl_core.mailing.email\_client\_abc
 -------------------------------------
 
-.. automodule:: cpl.mailing.email_client_abc
+.. automodule:: cpl_core.mailing.email_client_abc
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.mailing.email\_client\_service
+cpl_core.mailing.email\_client\_service
 -----------------------------------------
 
-.. automodule:: cpl.mailing.email_client_service
+.. automodule:: cpl_core.mailing.email_client_service
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.mailing.email\_client\_settings
+cpl_core.mailing.email\_client\_settings
 ------------------------------------------
 
-.. automodule:: cpl.mailing.email_client_settings
+.. automodule:: cpl_core.mailing.email_client_settings
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.mailing.email\_client\_settings\_name\_enum
+cpl_core.mailing.email\_client\_settings\_name\_enum
 ------------------------------------------------------
 
-.. automodule:: cpl.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

@@ -1,18 +1,18 @@
-cpl.time
+cpl_core.time
 ================
 
-cpl.time.time\_format\_settings
+cpl_core.time.time\_format\_settings
 --------------------------------------
 
-.. automodule:: cpl.time.time_format_settings
+.. automodule:: cpl_core.time.time_format_settings
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.time.time\_format\_settings\_names\_enum
+cpl_core.time.time\_format\_settings\_names\_enum
 ---------------------------------------------------
 
-.. automodule:: cpl.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

@@ -1,26 +1,26 @@
-cpl.utils
+cpl_core.utils
 =================
 
-cpl.utils.credential\_manager
+cpl_core.utils.credential\_manager
 ------------------------------------
 
-.. automodule:: cpl.utils.credential_manager
+.. automodule:: cpl_core.utils.credential_manager
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.utils.pip
+cpl_core.utils.pip
 --------------------
 
-.. automodule:: cpl.utils.pip
+.. automodule:: cpl_core.utils.pip
    :members:
    :undoc-members:
    :show-inheritance:
 
-cpl.utils.string
+cpl_core.utils.string
 -----------------------
 
-.. automodule:: cpl.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

@@ -6,4 +6,5 @@ Getting started
 
     quickstart
     setup
+    tutorials
 

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

@@ -10,6 +10,72 @@ The Common Python Library (CPL) is a package for python and a development platfo
 
 This CPL docs help you learn, understand and use the package. From your first application to complex apps for enterprises.
 
+
+Features
+--------
+- cpl-core
+   - 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
+           - ...
+- cpl-cli
+   - Expandle
+   - Code generation
+   - Package managing
+   - Build & Publishing
+- cpl-discord
+   - Utils for discord.py
+   - Connector between cpl-core and discord.py
+   - Prepared services for dependency injection
+- cpl-query
+   - Python list extensions
+   - Functions for sorting and filtering
+   - Like linq from C# but in python xD
+- cpl-translate
+   - Generic translations
+   - Prepared translation service and translate pipe
+   - Get translation from JSON files key dot.key notation
+
 Manuals
 ---------
 
@@ -20,5 +86,7 @@ These pages go into great detail about everything the Library can do.
 
    introduction
    getting_started
-   cpl
+   contributing
    cpl_cli
+   cpl_core
+   cpl_query