Build docs and added tutorial files

docs/source/cli.add.md

@@ -19,7 +19,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/source/cli.generate.md

@@ -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_core.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/source/cli.install.md

@@ -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/source/cli.new.md

@@ -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/source/cli.remove.md

@@ -19,6 +19,12 @@ If you call the command in a CPL workspace, you can use the project names. Other
 
 ## 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/source/cli.uninstall.md

@@ -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/source/cli.update.md

@@ -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/source/cpl_core.pipes.rst

@@ -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/source/cpl_core.rst

@@ -12,5 +12,6 @@ API Reference
     cpl_core.environment
     cpl_core.logging
     cpl_core.mailing
+    cpl_core.pipes
     cpl_core.time
     cpl_core.utils

docs/source/getting_started.rst

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

docs/source/introduction.md

@@ -4,6 +4,53 @@ 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.
 
+## 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)

docs/source/tutorials.appsettings.md

@@ -0,0 +1 @@
+# Using appsettings.json

docs/source/tutorials.console-arguments.md

@@ -0,0 +1 @@
+# Handle console arguments

docs/source/tutorials.console.md

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

docs/source/tutorials.create-startup.md

@@ -0,0 +1 @@
+# Create startup class

docs/source/tutorials.extend-application.md

@@ -0,0 +1 @@
+# Extend application

docs/source/tutorials.extend-startup.md

@@ -0,0 +1 @@
+# Extend startup

docs/source/tutorials.logging.md

@@ -0,0 +1 @@
+# Use builtin logger

docs/source/tutorials.mail.md

@@ -0,0 +1 @@
+# Send mails

docs/source/tutorials.rst

@@ -0,0 +1,14 @@
+Tutorials
+=============
+
+.. toctree::
+    :maxdepth: 4
+
+    tutorials.extend-application
+    tutorials.create-startup
+    tutorials.extend-startup
+    tutorials.appsettings
+    tutorials.console-arguments
+    tutorials.console
+    tutorials.logging
+    tutorials.mail