Merge pull request '2021.11' (#50) from 2021.11 into master

Reviewed-on: #50

.gitignore

@@ -133,3 +133,4 @@ dmypy.json
 
 # IDE
 .idea/
+PythonImportHelper-v2-Completion.json

.vscode/launch.json

@@ -41,6 +41,10 @@
             "cwd": "${workspaceFolder}/src/tests/custom/database/src",
             "program": "main.py",
             "console": "integratedTerminal",
+            "env": {
+                "PYTHON_ENVIRONMENT": "development",
+                "PYTHONPATH": "${workspaceFolder}/src/:$PYTHONPATH"
+            }
         },
         {
             "name": "CLI",
@@ -197,7 +201,11 @@
             "args": [
                 "install",
                 "discord.py",
-            ]
+            ],
+            "env": {
+                "GISMO_ENVIRONMENT": "development",
+                "PYTHONPATH": "${workspaceFolder}/src/:$PYTHONPATH"
+            }
         },
         {
             "name": "CLI: install local",
@@ -256,7 +264,10 @@
             "console": "integratedTerminal",
             "args": [
                 "start",
-            ]
+            ],
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/src/:${workspaceFolder}/src/cpl_cli/"
+            }
         },
         {
             "name": "CLI: uninstall discord.py",

.vscode/settings.json

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

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

@@ -8,6 +8,14 @@ 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
 ----------------------------------------------------
@@ -21,6 +29,14 @@ 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/cpl_query.extension.html

@@ -44,8 +44,10 @@
 <li class="toctree-l1 current"><a class="reference internal" href="cpl_query.html">Query Reference</a><ul class="current">
 <li class="toctree-l2 current"><a class="current reference internal" href="#">cpl_query.extension</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="#module-cpl_query.extension.iterable_abc">cpl_query.extension.iterable_abc</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#module-cpl_query.extension.iterable">cpl_query.extension.iterable</a></li>
 <li class="toctree-l3"><a class="reference internal" href="#module-cpl_query.extension.list">cpl_query.extension.list</a></li>
 <li class="toctree-l3"><a class="reference internal" href="#module-cpl_query.extension.ordered_iterable_abc">cpl_query.extension.ordered_iterable_abc</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#module-cpl_query.extension.ordered_iterable">cpl_query.extension.ordered_iterable</a></li>
 </ul>
 </li>
 <li class="toctree-l2"><a class="reference internal" href="cpl_query.exceptions.html">cpl_query.exceptions</a></li>
@@ -86,149 +88,409 @@
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC">
 <em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">cpl_query.extension.iterable_abc.</span></span><span class="sig-name descname"><span class="pre">IterableABC</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">t</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">type</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">values</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">list</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC" title="Permalink to this definition"></a></dt>
 <dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">abc.ABC</span></code>, <code class="xref py py-class docutils literal notranslate"><span class="pre">list</span></code></p>
+<p>ABC to define functions on list</p>
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.all">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">all</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">bool</span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.all" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Checks if every element of list equals result found by function</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>bool</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.any">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">any</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">bool</span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.any" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Checks if list contains result found by function</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>bool</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.append">
 <span class="sig-name descname"><span class="pre">append</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">_IterableABC__object</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">object</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">None</span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.append" title="Permalink to this definition"></a></dt>
-<dd><p>Append object to the end of the list.</p>
+<dd><p>Adds element to list</p>
+<blockquote>
+<div><dl class="simple">
+<dt>__object: <code class="xref py py-class docutils literal notranslate"><span class="pre">object</span></code></dt><dd><p>value</p>
+</dd>
+</dl>
+</div></blockquote>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.average">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">average</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Callable</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Union</span><span class="p"><span class="pre">[</span></span><span class="pre">int</span><span class="p"><span class="pre">,</span> </span><span class="pre">float</span><span class="p"><span class="pre">,</span> </span><span class="pre">complex</span><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.average" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Returns average value of list</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>Union[int, float, complex]</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.contains">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">contains</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">value</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">object</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">bool</span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.contains" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Checks if list contains value given by function</p>
+<blockquote>
+<div><dl class="simple">
+<dt>value: <code class="xref py py-class docutils literal notranslate"><span class="pre">object</span></code></dt><dd><p>value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>bool</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.count">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">count</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">int</span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.count" title="Permalink to this definition"></a></dt>
-<dd><p>Return number of occurrences of value.</p>
+<dd><p>Returns length of list or count of found elements</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>int</p>
+</div></blockquote>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.distinct">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">distinct</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.distinct" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Returns list without redundancies</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.element_at">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">element_at</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">int</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC.any" title="cpl_query.extension.iterable_abc.IterableABC.any"><span class="pre">cpl_query.extension.iterable_abc.IterableABC.any</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.element_at" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Returns element at given index</p>
+<blockquote>
+<div><dl class="simple">
+<dt>index: <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></dt><dd><p>index</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>Value at index: any</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.element_at_or_default">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">element_at_or_default</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">int</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC.any" title="cpl_query.extension.iterable_abc.IterableABC.any"><span class="pre">cpl_query.extension.iterable_abc.IterableABC.any</span></a><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.element_at_or_default" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Returns element at given index or None</p>
+<blockquote>
+<div><dl class="simple">
+<dt>index: <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></dt><dd><p>index</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>Value at index: Optional[any]</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.extend">
 <span class="sig-name descname"><span class="pre">extend</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">_IterableABC__iterable</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Iterable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">None</span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.extend" title="Permalink to this definition"></a></dt>
-<dd><p>Extend list by appending elements from the iterable.</p>
+<dd><p>Adds elements of given list to list</p>
+<blockquote>
+<div><dl class="simple">
+<dt>__iterable: :class: <cite>cpl_query.extension.iterable.Iterable</cite></dt><dd><p>index</p>
+</dd>
+</dl>
+</div></blockquote>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.first">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">first</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC.any" title="cpl_query.extension.iterable_abc.IterableABC.any"><span class="pre">cpl_query.extension.iterable_abc.IterableABC.any</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.first" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Returns first element</p>
+<blockquote>
+<div><p>First element of list: any</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.first_or_default">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">first_or_default</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC.any" title="cpl_query.extension.iterable_abc.IterableABC.any"><span class="pre">cpl_query.extension.iterable_abc.IterableABC.any</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.first_or_default" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Returns first element or None</p>
+<blockquote>
+<div><p>First element of list: Optional[any]</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.for_each">
-<em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">for_each</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Union</span><span class="p"><span class="pre">[</span></span><span class="pre">int</span><span class="p"><span class="pre">,</span> </span><span class="pre">float</span><span class="p"><span class="pre">,</span> </span><span class="pre">complex</span><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.for_each" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">for_each</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.for_each" title="Permalink to this definition"></a></dt>
+<dd><p>Runs given function for each element of list</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: :class: <cite>Callable</cite></dt><dd><p>function to call</p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.last">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">last</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC.any" title="cpl_query.extension.iterable_abc.IterableABC.any"><span class="pre">cpl_query.extension.iterable_abc.IterableABC.any</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.last" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Returns last element</p>
+<blockquote>
+<div><p>Last element of list: any</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.last_or_default">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">last_or_default</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC.any" title="cpl_query.extension.iterable_abc.IterableABC.any"><span class="pre">cpl_query.extension.iterable_abc.IterableABC.any</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.last_or_default" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Returns last element or None</p>
+<blockquote>
+<div><p>Last element of list: Optional[any]</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.max">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">max</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Callable</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Union</span><span class="p"><span class="pre">[</span></span><span class="pre">int</span><span class="p"><span class="pre">,</span> </span><span class="pre">float</span><span class="p"><span class="pre">,</span> </span><span class="pre">complex</span><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.max" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Returns highest value</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>Union[int, float, complex]</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.min">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">min</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Callable</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Union</span><span class="p"><span class="pre">[</span></span><span class="pre">int</span><span class="p"><span class="pre">,</span> </span><span class="pre">float</span><span class="p"><span class="pre">,</span> </span><span class="pre">complex</span><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.min" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Returns highest value</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>Union[int, float, complex]</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.order_by">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">order_by</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.order_by" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Sorts elements by function in ascending order</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.order_by_descending">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">order_by_descending</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.order_by_descending" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Sorts elements by function in descending order</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.reverse">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">reverse</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.reverse" title="Permalink to this definition"></a></dt>
-<dd><p>Reverse <em>IN PLACE</em>.</p>
+<dd><p>Reverses list</p>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.single">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">single</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC.any" title="cpl_query.extension.iterable_abc.IterableABC.any"><span class="pre">cpl_query.extension.iterable_abc.IterableABC.any</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.single" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Returns one single element of list</p>
+<blockquote>
+<div><p>Found value: any</p>
+</div></blockquote>
+<blockquote>
+<div><p>ArgumentNoneException: when argument is None
+Exception: when argument is None or found more than one element</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.single_or_default">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">single_or_default</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC.any" title="cpl_query.extension.iterable_abc.IterableABC.any"><span class="pre">cpl_query.extension.iterable_abc.IterableABC.any</span></a><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.single_or_default" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Returns one single element of list</p>
+<blockquote>
+<div><p>Found value: Optional[any]</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.skip">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">skip</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">int</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.skip" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Skips all elements from index</p>
+<blockquote>
+<div><dl class="simple">
+<dt>index: <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></dt><dd><p>index</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.skip_last">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">skip_last</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">int</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.skip_last" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Skips all elements after index</p>
+<blockquote>
+<div><dl class="simple">
+<dt>index: <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></dt><dd><p>index</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.sum">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">sum</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Callable</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Union</span><span class="p"><span class="pre">[</span></span><span class="pre">int</span><span class="p"><span class="pre">,</span> </span><span class="pre">float</span><span class="p"><span class="pre">,</span> </span><span class="pre">complex</span><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.sum" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Sum of all values</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>Union[int, float, complex]</p>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.take">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">take</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">int</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.take" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Takes all elements from index</p>
+<blockquote>
+<div><dl class="simple">
+<dt>index: <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></dt><dd><p>index</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.take_last">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">take_last</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">int</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.take_last" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Takes all elements after index</p>
+<blockquote>
+<div><dl class="simple">
+<dt>index: <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></dt><dd><p>index</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.to_list">
 <span class="sig-name descname"><span class="pre">to_list</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">list</span></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.to_list" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Converts :class: <cite>cpl_query.extension.iterable_abc.IterableABC</cite> to :class: <cite>list</cite></p>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>list</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
 
 <dl class="py property">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.type">
@@ -238,7 +500,415 @@
 <dl class="py method">
 <dt class="sig sig-object py" id="cpl_query.extension.iterable_abc.IterableABC.where">
 <em class="property"><span class="pre">abstract</span> </em><span class="sig-name descname"><span class="pre">where</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable_abc.IterableABC.where" title="Permalink to this definition"></a></dt>
-<dd></dd></dl>
+<dd><p>Select element by function</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+</dd></dl>
+
+</div>
+<div class="section" id="module-cpl_query.extension.iterable">
+<span id="cpl-query-extension-iterable"></span><h2>cpl_query.extension.iterable<a class="headerlink" href="#module-cpl_query.extension.iterable" title="Permalink to this headline"></a></h2>
+<dl class="py class">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable">
+<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">cpl_query.extension.iterable.</span></span><span class="sig-name descname"><span class="pre">Iterable</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">t</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">type</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">values</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">list</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable" title="Permalink to this definition"></a></dt>
+<dd><p>Bases: <a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><code class="xref py py-class docutils literal notranslate"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></code></a></p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.all">
+<span class="sig-name descname"><span class="pre">all</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">bool</span></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.all" title="Permalink to this definition"></a></dt>
+<dd><p>Checks if every element of list equals result found by function</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>bool</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.any">
+<span class="sig-name descname"><span class="pre">any</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">bool</span></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.any" title="Permalink to this definition"></a></dt>
+<dd><p>Checks if list contains result found by function</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>bool</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.average">
+<span class="sig-name descname"><span class="pre">average</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Callable</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Union</span><span class="p"><span class="pre">[</span></span><span class="pre">int</span><span class="p"><span class="pre">,</span> </span><span class="pre">float</span><span class="p"><span class="pre">,</span> </span><span class="pre">complex</span><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.average" title="Permalink to this definition"></a></dt>
+<dd><p>Returns average value of list</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>Union[int, float, complex]</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.contains">
+<span class="sig-name descname"><span class="pre">contains</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">value</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">object</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">bool</span></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.contains" title="Permalink to this definition"></a></dt>
+<dd><p>Checks if list contains value given by function</p>
+<blockquote>
+<div><dl class="simple">
+<dt>value: <code class="xref py py-class docutils literal notranslate"><span class="pre">object</span></code></dt><dd><p>value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>bool</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.count">
+<span class="sig-name descname"><span class="pre">count</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Callable</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">int</span></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.count" title="Permalink to this definition"></a></dt>
+<dd><p>Returns length of list or count of found elements</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>int</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.distinct">
+<span class="sig-name descname"><span class="pre">distinct</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.distinct" title="Permalink to this definition"></a></dt>
+<dd><p>Returns list without redundancies</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.element_at">
+<span class="sig-name descname"><span class="pre">element_at</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">int</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable.Iterable.any" title="cpl_query.extension.iterable.Iterable.any"><span class="pre">cpl_query.extension.iterable.Iterable.any</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.element_at" title="Permalink to this definition"></a></dt>
+<dd><p>Returns element at given index</p>
+<blockquote>
+<div><dl class="simple">
+<dt>index: <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></dt><dd><p>index</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>Value at index: any</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.element_at_or_default">
+<span class="sig-name descname"><span class="pre">element_at_or_default</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">int</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#cpl_query.extension.iterable.Iterable.any" title="cpl_query.extension.iterable.Iterable.any"><span class="pre">cpl_query.extension.iterable.Iterable.any</span></a><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.element_at_or_default" title="Permalink to this definition"></a></dt>
+<dd><p>Returns element at given index or None</p>
+<blockquote>
+<div><dl class="simple">
+<dt>index: <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></dt><dd><p>index</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>Value at index: Optional[any]</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.first">
+<span class="sig-name descname"><span class="pre">first</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable.Iterable.any" title="cpl_query.extension.iterable.Iterable.any"><span class="pre">cpl_query.extension.iterable.Iterable.any</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.first" title="Permalink to this definition"></a></dt>
+<dd><p>Returns first element</p>
+<blockquote>
+<div><p>First element of list: any</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.first_or_default">
+<span class="sig-name descname"><span class="pre">first_or_default</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#cpl_query.extension.iterable.Iterable.any" title="cpl_query.extension.iterable.Iterable.any"><span class="pre">cpl_query.extension.iterable.Iterable.any</span></a><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.first_or_default" title="Permalink to this definition"></a></dt>
+<dd><p>Returns first element or None</p>
+<blockquote>
+<div><p>First element of list: Optional[any]</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.for_each">
+<span class="sig-name descname"><span class="pre">for_each</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.for_each" title="Permalink to this definition"></a></dt>
+<dd><p>Runs given function for each element of list</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: :class: <cite>Callable</cite></dt><dd><p>function to call</p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.last">
+<span class="sig-name descname"><span class="pre">last</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable.Iterable.any" title="cpl_query.extension.iterable.Iterable.any"><span class="pre">cpl_query.extension.iterable.Iterable.any</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.last" title="Permalink to this definition"></a></dt>
+<dd><p>Returns last element</p>
+<blockquote>
+<div><p>Last element of list: any</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.last_or_default">
+<span class="sig-name descname"><span class="pre">last_or_default</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#cpl_query.extension.iterable.Iterable.any" title="cpl_query.extension.iterable.Iterable.any"><span class="pre">cpl_query.extension.iterable.Iterable.any</span></a><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.last_or_default" title="Permalink to this definition"></a></dt>
+<dd><p>Returns last element or None</p>
+<blockquote>
+<div><p>Last element of list: Optional[any]</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.max">
+<span class="sig-name descname"><span class="pre">max</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Callable</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Union</span><span class="p"><span class="pre">[</span></span><span class="pre">int</span><span class="p"><span class="pre">,</span> </span><span class="pre">float</span><span class="p"><span class="pre">,</span> </span><span class="pre">complex</span><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.max" title="Permalink to this definition"></a></dt>
+<dd><p>Returns highest value</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>Union[int, float, complex]</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.min">
+<span class="sig-name descname"><span class="pre">min</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Callable</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Union</span><span class="p"><span class="pre">[</span></span><span class="pre">int</span><span class="p"><span class="pre">,</span> </span><span class="pre">float</span><span class="p"><span class="pre">,</span> </span><span class="pre">complex</span><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.min" title="Permalink to this definition"></a></dt>
+<dd><p>Returns highest value</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>Union[int, float, complex]</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.order_by">
+<span class="sig-name descname"><span class="pre">order_by</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.ordered_iterable_abc.OrderedIterableABC" title="cpl_query.extension.ordered_iterable_abc.OrderedIterableABC"><span class="pre">cpl_query.extension.ordered_iterable_abc.OrderedIterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.order_by" title="Permalink to this definition"></a></dt>
+<dd><p>Sorts elements by function in ascending order</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.order_by_descending">
+<span class="sig-name descname"><span class="pre">order_by_descending</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.ordered_iterable_abc.OrderedIterableABC" title="cpl_query.extension.ordered_iterable_abc.OrderedIterableABC"><span class="pre">cpl_query.extension.ordered_iterable_abc.OrderedIterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.order_by_descending" title="Permalink to this definition"></a></dt>
+<dd><p>Sorts elements by function in descending order</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.reverse">
+<span class="sig-name descname"><span class="pre">reverse</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.reverse" title="Permalink to this definition"></a></dt>
+<dd><p>Reverses list</p>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.single">
+<span class="sig-name descname"><span class="pre">single</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable.Iterable.any" title="cpl_query.extension.iterable.Iterable.any"><span class="pre">cpl_query.extension.iterable.Iterable.any</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.single" title="Permalink to this definition"></a></dt>
+<dd><p>Returns one single element of list</p>
+<blockquote>
+<div><p>Found value: any</p>
+</div></blockquote>
+<blockquote>
+<div><p>ArgumentNoneException: when argument is None
+Exception: when argument is None or found more than one element</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.single_or_default">
+<span class="sig-name descname"><span class="pre">single_or_default</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#cpl_query.extension.iterable.Iterable.any" title="cpl_query.extension.iterable.Iterable.any"><span class="pre">cpl_query.extension.iterable.Iterable.any</span></a><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.single_or_default" title="Permalink to this definition"></a></dt>
+<dd><p>Returns one single element of list</p>
+<blockquote>
+<div><p>Found value: Optional[any]</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.skip">
+<span class="sig-name descname"><span class="pre">skip</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">int</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.skip" title="Permalink to this definition"></a></dt>
+<dd><p>Skips all elements from index</p>
+<blockquote>
+<div><dl class="simple">
+<dt>index: <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></dt><dd><p>index</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.skip_last">
+<span class="sig-name descname"><span class="pre">skip_last</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">int</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.skip_last" title="Permalink to this definition"></a></dt>
+<dd><p>Skips all elements after index</p>
+<blockquote>
+<div><dl class="simple">
+<dt>index: <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></dt><dd><p>index</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.sum">
+<span class="sig-name descname"><span class="pre">sum</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">Callable</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Union</span><span class="p"><span class="pre">[</span></span><span class="pre">int</span><span class="p"><span class="pre">,</span> </span><span class="pre">float</span><span class="p"><span class="pre">,</span> </span><span class="pre">complex</span><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.sum" title="Permalink to this definition"></a></dt>
+<dd><p>Sum of all values</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><p>Union[int, float, complex]</p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.take">
+<span class="sig-name descname"><span class="pre">take</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">int</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.take" title="Permalink to this definition"></a></dt>
+<dd><p>Takes all elements from index</p>
+<blockquote>
+<div><dl class="simple">
+<dt>index: <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></dt><dd><p>index</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.take_last">
+<span class="sig-name descname"><span class="pre">take_last</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">index</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">int</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.take_last" title="Permalink to this definition"></a></dt>
+<dd><p>Takes all elements after index</p>
+<blockquote>
+<div><dl class="simple">
+<dt>index: <code class="xref py py-class docutils literal notranslate"><span class="pre">int</span></code></dt><dd><p>index</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.iterable.Iterable.where">
+<span class="sig-name descname"><span class="pre">where</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.iterable_abc.IterableABC" title="cpl_query.extension.iterable_abc.IterableABC"><span class="pre">cpl_query.extension.iterable_abc.IterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.iterable.Iterable.where" title="Permalink to this definition"></a></dt>
+<dd><p>Select element by function</p>
+<blockquote>
+<div><dl class="simple">
+<dt>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></dt><dd><p>selected value</p>
+</dd>
+</dl>
+</div></blockquote>
+<blockquote>
+<div><dl class="field-list simple">
+<dt class="field-odd">class</dt>
+<dd class="field-odd"><p><cite>cpl_query.extension.iterable_abc.IterableABC</cite></p>
+</dd>
+</dl>
+</div></blockquote>
+</dd></dl>
 
 </dd></dl>
 
@@ -248,7 +918,7 @@
 <dl class="py class">
 <dt class="sig sig-object py" id="cpl_query.extension.list.List">
 <em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">cpl_query.extension.list.</span></span><span class="sig-name descname"><span class="pre">List</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">t</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">type</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">values</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">Optional</span><span class="p"><span class="pre">[</span></span><span class="pre">list</span><span class="p"><span class="pre">]</span></span></span> <span class="o"><span class="pre">=</span></span> <span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#cpl_query.extension.list.List" title="Permalink to this definition"></a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">cpl_query.extension.iterable.Iterable</span></code></p>
+<dd><p>Bases: <a class="reference internal" href="#cpl_query.extension.iterable.Iterable" title="cpl_query.extension.iterable.Iterable"><code class="xref py py-class docutils literal notranslate"><span class="pre">cpl_query.extension.iterable.Iterable</span></code></a></p>
 <p>Implementation of :class: <cite>cpl_query.extension.iterable.Iterable</cite></p>
 </dd></dl>
 
@@ -285,6 +955,40 @@
 
 </dd></dl>
 
+</div>
+<div class="section" id="module-cpl_query.extension.ordered_iterable">
+<span id="cpl-query-extension-ordered-iterable"></span><h2>cpl_query.extension.ordered_iterable<a class="headerlink" href="#module-cpl_query.extension.ordered_iterable" title="Permalink to this headline"></a></h2>
+<dl class="py class">
+<dt class="sig sig-object py" id="cpl_query.extension.ordered_iterable.OrderedIterable">
+<em class="property"><span class="pre">class</span> </em><span class="sig-prename descclassname"><span class="pre">cpl_query.extension.ordered_iterable.</span></span><span class="sig-name descname"><span class="pre">OrderedIterable</span></span><a class="headerlink" href="#cpl_query.extension.ordered_iterable.OrderedIterable" title="Permalink to this definition"></a></dt>
+<dd><p>Bases: <a class="reference internal" href="#cpl_query.extension.iterable.Iterable" title="cpl_query.extension.iterable.Iterable"><code class="xref py py-class docutils literal notranslate"><span class="pre">cpl_query.extension.iterable.Iterable</span></code></a>, <a class="reference internal" href="#cpl_query.extension.ordered_iterable_abc.OrderedIterableABC" title="cpl_query.extension.ordered_iterable_abc.OrderedIterableABC"><code class="xref py py-class docutils literal notranslate"><span class="pre">cpl_query.extension.ordered_iterable_abc.OrderedIterableABC</span></code></a></p>
+<p>Implementation of :class: <cite>cpl_query.extension.Iterable</cite> <cite>cpl_query.extension.OrderedIterableABC</cite></p>
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.ordered_iterable.OrderedIterable.then_by">
+<span class="sig-name descname"><span class="pre">then_by</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">_func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">collections.abc.Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.ordered_iterable_abc.OrderedIterableABC" title="cpl_query.extension.ordered_iterable_abc.OrderedIterableABC"><span class="pre">cpl_query.extension.ordered_iterable_abc.OrderedIterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.ordered_iterable.OrderedIterable.then_by" title="Permalink to this definition"></a></dt>
+<dd><p>Sorts OrderedList in ascending order by function</p>
+<blockquote>
+<div><p>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></p>
+</div></blockquote>
+<blockquote>
+<div><p>list of <code class="xref py py-class docutils literal notranslate"><span class="pre">cpl_query.extension.OrderedIterableABC</span></code></p>
+</div></blockquote>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="cpl_query.extension.ordered_iterable.OrderedIterable.then_by_descending">
+<span class="sig-name descname"><span class="pre">then_by_descending</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">_func</span></span><span class="p"><span class="pre">:</span></span> <span class="n"><span class="pre">collections.abc.Callable</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="#cpl_query.extension.ordered_iterable_abc.OrderedIterableABC" title="cpl_query.extension.ordered_iterable_abc.OrderedIterableABC"><span class="pre">cpl_query.extension.ordered_iterable_abc.OrderedIterableABC</span></a></span></span><a class="headerlink" href="#cpl_query.extension.ordered_iterable.OrderedIterable.then_by_descending" title="Permalink to this definition"></a></dt>
+<dd><p>Sorts OrderedList in descending order by function</p>
+<blockquote>
+<div><p>func: <code class="xref py py-class docutils literal notranslate"><span class="pre">Callable</span></code></p>
+</div></blockquote>
+<blockquote>
+<div><p>list of <code class="xref py py-class docutils literal notranslate"><span class="pre">cpl_query.extension.OrderedIterableABC</span></code></p>
+</div></blockquote>
+</dd></dl>
+
+</dd></dl>
+
 </div>
 </div>
 

docs/build/html/cpl_query.html

@@ -78,8 +78,10 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="cpl_query.extension.html">cpl_query.extension</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="cpl_query.extension.html#module-cpl_query.extension.iterable_abc">cpl_query.extension.iterable_abc</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cpl_query.extension.html#module-cpl_query.extension.iterable">cpl_query.extension.iterable</a></li>
 <li class="toctree-l2"><a class="reference internal" href="cpl_query.extension.html#module-cpl_query.extension.list">cpl_query.extension.list</a></li>
 <li class="toctree-l2"><a class="reference internal" href="cpl_query.extension.html#module-cpl_query.extension.ordered_iterable_abc">cpl_query.extension.ordered_iterable_abc</a></li>
+<li class="toctree-l2"><a class="reference internal" href="cpl_query.extension.html#module-cpl_query.extension.ordered_iterable">cpl_query.extension.ordered_iterable</a></li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="cpl_query.exceptions.html">cpl_query.exceptions</a><ul>

docs/build/html/genindex.html

@@ -160,22 +160,30 @@
         <li><a href="cpl_core.dependency_injection.html#cpl_core.dependency_injection.service_collection_abc.ServiceCollectionABC.add_transient">(cpl_core.dependency_injection.service_collection_abc.ServiceCollectionABC method)</a>
 </li>
       </ul></li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="cpl_core.configuration.html#cpl_core.configuration.configuration.Configuration.additional_arguments">additional_arguments (cpl_core.configuration.configuration.Configuration property)</a>
 
       <ul>
         <li><a href="cpl_core.configuration.html#cpl_core.configuration.configuration_abc.ConfigurationABC.additional_arguments">(cpl_core.configuration.configuration_abc.ConfigurationABC property)</a>
 </li>
       </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="cpl_query.tests.html#cpl_query.tests.models.Address">Address (class in cpl_query.tests.models)</a>
 </li>
       <li><a href="cpl_core.configuration.html#cpl_core.configuration.console_argument.ConsoleArgument.aliases">aliases (cpl_core.configuration.console_argument.ConsoleArgument property)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.all">all() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.all">all() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.all">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.any">any() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      </ul></li>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.any">any() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.any">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
       <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.append">append() (cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
       <li><a href="cpl_core.environment.html#cpl_core.environment.application_environment.ApplicationEnvironment.application_name">application_name (cpl_core.environment.application_environment.ApplicationEnvironment property)</a>
@@ -210,8 +218,12 @@
         <li><a href="cpl_core.database.html#cpl_core.database.database_settings_name_enum.DatabaseSettingsNameEnum.auth_plugin">(cpl_core.database.database_settings_name_enum.DatabaseSettingsNameEnum attribute)</a>
 </li>
       </ul></li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.average">average() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.average">average() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.average">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
   </ul></td>
 </tr></table>
 
@@ -320,14 +332,22 @@
 </li>
       <li><a href="cpl_core.console.html#cpl_core.console.console_call.ConsoleCall">ConsoleCall (class in cpl_core.console.console_call)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.contains">contains() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.contains">contains() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.contains">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
       <li><a href="cpl_core.utils.html#cpl_core.utils.string.String.convert_to_camel_case">convert_to_camel_case() (cpl_core.utils.string.String static method)</a>
 </li>
       <li><a href="cpl_core.utils.html#cpl_core.utils.string.String.convert_to_snake_case">convert_to_snake_case() (cpl_core.utils.string.String static method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.count">count() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.count">count() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.count">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
       <li>
     cpl_core.application.application_abc
 
@@ -650,6 +670,13 @@
 
       <ul>
         <li><a href="cpl_query.exceptions.html#module-cpl_query.exceptions">module</a>
+</li>
+      </ul></li>
+      <li>
+    cpl_query.extension.iterable
+
+      <ul>
+        <li><a href="cpl_query.extension.html#module-cpl_query.extension.iterable">module</a>
 </li>
       </ul></li>
       <li>
@@ -664,6 +691,13 @@
 
       <ul>
         <li><a href="cpl_query.extension.html#module-cpl_query.extension.list">module</a>
+</li>
+      </ul></li>
+      <li>
+    cpl_query.extension.ordered_iterable
+
+      <ul>
+        <li><a href="cpl_query.extension.html#module-cpl_query.extension.ordered_iterable">module</a>
 </li>
       </ul></li>
       <li>
@@ -806,8 +840,12 @@
 </li>
       <li><a href="cpl_core.console.html#cpl_core.console.console.Console.disable">disable() (cpl_core.console.console.Console class method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.distinct">distinct() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.distinct">distinct() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.distinct">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
   </ul></td>
 </tr></table>
 
@@ -820,10 +858,18 @@
         <li><a href="cpl_core.database.html#cpl_core.database.database_settings_name_enum.DatabaseSettingsNameEnum.echo">(cpl_core.database.database_settings_name_enum.DatabaseSettingsNameEnum attribute)</a>
 </li>
       </ul></li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.element_at">element_at() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.element_at">element_at() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.element_at">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.element_at_or_default">element_at_or_default() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      </ul></li>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.element_at_or_default">element_at_or_default() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.element_at_or_default">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
       <li><a href="cpl_core.mailing.html#cpl_core.mailing.email.EMail">EMail (class in cpl_core.mailing.email)</a>
 </li>
       <li><a href="cpl_core.mailing.html#cpl_core.mailing.email_client_service.EMailClient">EMailClient (class in cpl_core.mailing.email_client_service)</a>
@@ -850,6 +896,8 @@
         <li><a href="cpl_core.environment.html#cpl_core.environment.application_environment_abc.ApplicationEnvironmentABC.end_time">(cpl_core.environment.application_environment_abc.ApplicationEnvironmentABC property)</a>
 </li>
       </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="cpl_core.database.connection.html#cpl_core.database.connection.database_connection.DatabaseConnection.engine">engine (cpl_core.database.connection.database_connection.DatabaseConnection property)</a>
 
       <ul>
@@ -860,8 +908,6 @@
         <li><a href="cpl_core.database.context.html#cpl_core.database.context.database_context_abc.DatabaseContextABC.engine">(cpl_core.database.context.database_context_abc.DatabaseContextABC property)</a>
 </li>
       </ul></li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="cpl_core.configuration.html#cpl_core.configuration.configuration.Configuration.environment">environment (cpl_core.configuration.configuration.Configuration property)</a>
 
       <ul>
@@ -916,18 +962,30 @@
         <li><a href="cpl_core.logging.html#cpl_core.logging.logging_settings_name_enum.LoggingSettingsNameEnum.filename">(cpl_core.logging.logging_settings_name_enum.LoggingSettingsNameEnum attribute)</a>
 </li>
       </ul></li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.first">first() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.first">first() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.first">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.first_or_default">first_or_default() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      </ul></li>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.first_or_default">first_or_default() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.first_or_default">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
       <li><a href="cpl_core.utils.html#cpl_core.utils.string.String.first_to_lower">first_to_lower() (cpl_core.utils.string.String static method)</a>
-</li>
-      <li><a href="cpl_core.utils.html#cpl_core.utils.string.String.first_to_upper">first_to_upper() (cpl_core.utils.string.String static method)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.for_each">for_each() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_core.utils.html#cpl_core.utils.string.String.first_to_upper">first_to_upper() (cpl_core.utils.string.String static method)</a>
 </li>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.for_each">for_each() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.for_each">(cpl_query.extension.iterable_abc.IterableABC method)</a>
+</li>
+      </ul></li>
       <li><a href="cpl_core.console.html#cpl_core.console.console.Console.foreground_color">foreground_color (cpl_core.console.console.Console property)</a>
 </li>
       <li><a href="cpl_core.console.html#cpl_core.console.foreground_color_enum.ForegroundColorEnum">ForegroundColorEnum (class in cpl_core.console.foreground_color_enum)</a>
@@ -1045,6 +1103,8 @@
       <li><a href="cpl_query.exceptions.html#cpl_query.exceptions.InvalidTypeException">InvalidTypeException</a>
 </li>
       <li><a href="cpl_core.configuration.html#cpl_core.configuration.console_argument.ConsoleArgument.is_value_token_optional">is_value_token_optional (cpl_core.configuration.console_argument.ConsoleArgument property)</a>
+</li>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable">Iterable (class in cpl_query.extension.iterable)</a>
 </li>
       <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC">IterableABC (class in cpl_query.extension.iterable_abc)</a>
 </li>
@@ -1056,20 +1116,28 @@
 <h2 id="L">L</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.last">last() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.last">last() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.last">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.last_or_default">last_or_default() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      </ul></li>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.last_or_default">last_or_default() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.last_or_default">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
       <li><a href="cpl_core.logging.html#cpl_core.logging.logging_settings.LoggingSettings.level">level (cpl_core.logging.logging_settings.LoggingSettings property)</a>
 </li>
       <li><a href="cpl_core.dependency_injection.html#cpl_core.dependency_injection.service_descriptor.ServiceDescriptor.lifetime">lifetime (cpl_core.dependency_injection.service_descriptor.ServiceDescriptor property)</a>
 </li>
       <li><a href="cpl_query.extension.html#cpl_query.extension.list.List">List (class in cpl_query.extension.list)</a>
-</li>
-      <li><a href="cpl_query.exceptions.html#cpl_query.exceptions.ExceptionArgument.list">list (cpl_query.exceptions.ExceptionArgument attribute)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="cpl_query.exceptions.html#cpl_query.exceptions.ExceptionArgument.list">list (cpl_query.exceptions.ExceptionArgument attribute)</a>
+</li>
       <li><a href="cpl_core.logging.html#cpl_core.logging.logger_service.Logger">Logger (class in cpl_core.logging.logger_service)</a>
 </li>
       <li><a href="cpl_core.logging.html#cpl_core.logging.logger_abc.LoggerABC">LoggerABC (class in cpl_core.logging.logger_abc)</a>
@@ -1096,10 +1164,18 @@
       </ul></li>
       <li><a href="cpl_core.application.html#cpl_core.application.application_abc.ApplicationABC.main">main() (cpl_core.application.application_abc.ApplicationABC method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.max">max() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.max">max() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.max">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.min">min() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      </ul></li>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.min">min() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.min">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
       <li>
     module
 
@@ -1195,10 +1271,14 @@
         <li><a href="cpl_core.utils.html#module-cpl_core.utils.string">cpl_core.utils.string</a>
 </li>
         <li><a href="cpl_query.exceptions.html#module-cpl_query.exceptions">cpl_query.exceptions</a>
+</li>
+        <li><a href="cpl_query.extension.html#module-cpl_query.extension.iterable">cpl_query.extension.iterable</a>
 </li>
         <li><a href="cpl_query.extension.html#module-cpl_query.extension.iterable_abc">cpl_query.extension.iterable_abc</a>
 </li>
         <li><a href="cpl_query.extension.html#module-cpl_query.extension.list">cpl_query.extension.list</a>
+</li>
+        <li><a href="cpl_query.extension.html#module-cpl_query.extension.ordered_iterable">cpl_query.extension.ordered_iterable</a>
 </li>
         <li><a href="cpl_query.extension.html#module-cpl_query.extension.ordered_iterable_abc">cpl_query.extension.ordered_iterable_abc</a>
 </li>
@@ -1233,11 +1313,21 @@
   <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="cpl_core.logging.html#cpl_core.logging.logging_level_enum.LoggingLevelEnum.OFF">OFF (cpl_core.logging.logging_level_enum.LoggingLevelEnum attribute)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.order_by">order_by() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.order_by">order_by() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.order_by">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.order_by_descending">order_by_descending() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.order_by_descending">order_by_descending() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.order_by_descending">(cpl_query.extension.iterable_abc.IterableABC method)</a>
+</li>
+      </ul></li>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.ordered_iterable.OrderedIterable">OrderedIterable (class in cpl_query.extension.ordered_iterable)</a>
 </li>
       <li><a href="cpl_query.extension.html#cpl_query.extension.ordered_iterable_abc.OrderedIterableABC">OrderedIterableABC (class in cpl_query.extension.ordered_iterable_abc)</a>
 </li>
@@ -1301,8 +1391,12 @@
 </li>
       <li><a href="cpl_core.utils.html#cpl_core.utils.pip.Pip.reset_executable">reset_executable() (cpl_core.utils.pip.Pip class method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.reverse">reverse() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.reverse">reverse() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.reverse">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
       <li><a href="cpl_core.application.html#cpl_core.application.application_abc.ApplicationABC.run">run() (cpl_core.application.application_abc.ApplicationABC method)</a>
 
       <ul>
@@ -1371,14 +1465,14 @@
 </li>
       <li><a href="cpl_core.console.html#cpl_core.console.console.Console.set_hold_back">set_hold_back() (cpl_core.console.console.Console class method)</a>
 </li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="cpl_core.environment.html#cpl_core.environment.application_environment.ApplicationEnvironment.set_runtime_directory">set_runtime_directory() (cpl_core.environment.application_environment.ApplicationEnvironment method)</a>
 
       <ul>
         <li><a href="cpl_core.environment.html#cpl_core.environment.application_environment_abc.ApplicationEnvironmentABC.set_runtime_directory">(cpl_core.environment.application_environment_abc.ApplicationEnvironmentABC method)</a>
 </li>
       </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="cpl_core.environment.html#cpl_core.environment.application_environment.ApplicationEnvironment.set_working_directory">set_working_directory() (cpl_core.environment.application_environment.ApplicationEnvironment method)</a>
 
       <ul>
@@ -1391,16 +1485,32 @@
         <li><a href="cpl_query.tests.html#cpl_query.tests.query_test.QueryTest.setUp">(cpl_query.tests.query_test.QueryTest method)</a>
 </li>
       </ul></li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.single">single() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.single">single() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.single">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.single_or_default">single_or_default() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      </ul></li>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.single_or_default">single_or_default() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.single_or_default">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
       <li><a href="cpl_core.dependency_injection.html#cpl_core.dependency_injection.service_lifetime_enum.ServiceLifetimeEnum.singleton">singleton (cpl_core.dependency_injection.service_lifetime_enum.ServiceLifetimeEnum attribute)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.skip">skip() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.skip">skip() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.skip">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.skip_last">skip_last() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      </ul></li>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.skip_last">skip_last() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.skip_last">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
       <li><a href="cpl_core.console.html#cpl_core.console.console.Console.spinner">spinner() (cpl_core.console.console.Console class method)</a>
 </li>
       <li><a href="cpl_core.console.html#cpl_core.console.spinner_thread.SpinnerThread">SpinnerThread (class in cpl_core.console.spinner_thread)</a>
@@ -1423,8 +1533,12 @@
 </li>
       <li><a href="cpl_core.mailing.html#cpl_core.mailing.email.EMail.subject">subject (cpl_core.mailing.email.EMail property)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.sum">sum() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.sum">sum() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.sum">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
   </ul></td>
 </tr></table>
 
@@ -1433,10 +1547,18 @@
   <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="cpl_core.console.html#cpl_core.console.console.Console.table">table() (cpl_core.console.console.Console class method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.take">take() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.take">take() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.take">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.take_last">take_last() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      </ul></li>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.take_last">take_last() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.take_last">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
       <li><a href="cpl_query.tests.html#cpl_query.tests.query_test.QueryTest.test_all">test_all() (cpl_query.tests.query_test.QueryTest method)</a>
 </li>
       <li><a href="cpl_query.tests.html#cpl_query.tests.query_test.QueryTest.test_any">test_any() (cpl_query.tests.query_test.QueryTest method)</a>
@@ -1501,10 +1623,18 @@
 </li>
       <li><a href="cpl_core.environment.html#cpl_core.environment.environment_name_enum.EnvironmentNameEnum.testing">testing (cpl_core.environment.environment_name_enum.EnvironmentNameEnum attribute)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.ordered_iterable_abc.OrderedIterableABC.then_by">then_by() (cpl_query.extension.ordered_iterable_abc.OrderedIterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.ordered_iterable.OrderedIterable.then_by">then_by() (cpl_query.extension.ordered_iterable.OrderedIterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.ordered_iterable_abc.OrderedIterableABC.then_by">(cpl_query.extension.ordered_iterable_abc.OrderedIterableABC method)</a>
 </li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.ordered_iterable_abc.OrderedIterableABC.then_by_descending">then_by_descending() (cpl_query.extension.ordered_iterable_abc.OrderedIterableABC method)</a>
+      </ul></li>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.ordered_iterable.OrderedIterable.then_by_descending">then_by_descending() (cpl_query.extension.ordered_iterable.OrderedIterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.ordered_iterable_abc.OrderedIterableABC.then_by_descending">(cpl_query.extension.ordered_iterable_abc.OrderedIterableABC method)</a>
 </li>
+      </ul></li>
       <li><a href="cpl_core.time.html#cpl_core.time.time_format_settings.TimeFormatSettings.time_format">time_format (cpl_core.time.time_format_settings.TimeFormatSettings property)</a>
 
       <ul>
@@ -1593,8 +1723,12 @@
         <li><a href="cpl_core.logging.html#cpl_core.logging.logger_service.Logger.warn">(cpl_core.logging.logger_service.Logger method)</a>
 </li>
       </ul></li>
-      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.where">where() (cpl_query.extension.iterable_abc.IterableABC method)</a>
+      <li><a href="cpl_query.extension.html#cpl_query.extension.iterable.Iterable.where">where() (cpl_query.extension.iterable.Iterable method)</a>
+
+      <ul>
+        <li><a href="cpl_query.extension.html#cpl_query.extension.iterable_abc.IterableABC.where">(cpl_query.extension.iterable_abc.IterableABC method)</a>
 </li>
+      </ul></li>
       <li><a href="cpl_core.console.html#cpl_core.console.background_color_enum.BackgroundColorEnum.white">white (cpl_core.console.background_color_enum.BackgroundColorEnum attribute)</a>
 
       <ul>

docs/build/html/modules.html

@@ -249,8 +249,10 @@
 <li class="toctree-l1"><a class="reference internal" href="cpl_query.html">Query Reference</a><ul>
 <li class="toctree-l2"><a class="reference internal" href="cpl_query.extension.html">cpl_query.extension</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="cpl_query.extension.html#module-cpl_query.extension.iterable_abc">cpl_query.extension.iterable_abc</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cpl_query.extension.html#module-cpl_query.extension.iterable">cpl_query.extension.iterable</a></li>
 <li class="toctree-l3"><a class="reference internal" href="cpl_query.extension.html#module-cpl_query.extension.list">cpl_query.extension.list</a></li>
 <li class="toctree-l3"><a class="reference internal" href="cpl_query.extension.html#module-cpl_query.extension.ordered_iterable_abc">cpl_query.extension.ordered_iterable_abc</a></li>
+<li class="toctree-l3"><a class="reference internal" href="cpl_query.extension.html#module-cpl_query.extension.ordered_iterable">cpl_query.extension.ordered_iterable</a></li>
 </ul>
 </li>
 <li class="toctree-l2"><a class="reference internal" href="cpl_query.exceptions.html">cpl_query.exceptions</a><ul>

docs/build/html/py-modindex.html

@@ -321,6 +321,11 @@
        <td>&#160;&#160;&#160;
        <a href="cpl_query.exceptions.html#module-cpl_query.exceptions"><code class="xref">cpl_query.exceptions</code></a></td><td>
        <em></em></td></tr>
+     <tr class="cg-2">
+       <td></td>
+       <td>&#160;&#160;&#160;
+       <a href="cpl_query.extension.html#module-cpl_query.extension.iterable"><code class="xref">cpl_query.extension.iterable</code></a></td><td>
+       <em></em></td></tr>
      <tr class="cg-2">
        <td></td>
        <td>&#160;&#160;&#160;
@@ -331,6 +336,11 @@
        <td>&#160;&#160;&#160;
        <a href="cpl_query.extension.html#module-cpl_query.extension.list"><code class="xref">cpl_query.extension.list</code></a></td><td>
        <em></em></td></tr>
+     <tr class="cg-2">
+       <td></td>
+       <td>&#160;&#160;&#160;
+       <a href="cpl_query.extension.html#module-cpl_query.extension.ordered_iterable"><code class="xref">cpl_query.extension.ordered_iterable</code></a></td><td>
+       <em></em></td></tr>
      <tr class="cg-2">
        <td></td>
        <td>&#160;&#160;&#160;

docs/source/cpl_query.extension.rst

@@ -8,6 +8,14 @@ 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
 ----------------------------------------------------
@@ -21,6 +29,14 @@ 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:

scripts/upload.sh

@@ -1,16 +1,16 @@
 #!/bin/bash
 
 if [ $1 == "-prod" ]; then
-  twine upload -r pip.sh-edraft.de ../dist/sh_cpl-cli/publish/setup/*
-  twine upload -r pip.sh-edraft.de ../dist/sh_cpl-core/publish/setup/*
-  twine upload -r pip.sh-edraft.de ../dist/sh_cpl-query/publish/setup/*
+  twine upload -r pip.sh-edraft.de dist/sh_cpl-cli/publish/setup/*
+  twine upload -r pip.sh-edraft.de dist/sh_cpl-core/publish/setup/*
+  twine upload -r pip.sh-edraft.de dist/sh_cpl-query/publish/setup/*
 elif [ $1 == "-prod" ]; then
-  twine upload -r pip-exp.sh-edraft.de ../dist/sh_cpl-cli/publish/setup/*
-  twine upload -r pip-exp.sh-edraft.de ../dist/sh_cpl-core/publish/setup/*
-  twine upload -r pip-.sh-edraft.de ../dist/sh_cpl-query/publish/setup/*
+  twine upload -r pip-exp.sh-edraft.de dist/sh_cpl-cli/publish/setup/*
+  twine upload -r pip-exp.sh-edraft.de dist/sh_cpl-core/publish/setup/*
+  twine upload -r pip-.sh-edraft.de dist/sh_cpl-query/publish/setup/*
 
 else
-  twine upload -r pip-dev.sh-edraft.de ../dist/sh_cpl-cli/publish/setup/*
-  twine upload -r pip-dev.sh-edraft.de ../dist/sh_cpl-core/publish/setup/*
-  twine upload -r pip-dev.sh-edraft.de ../dist/sh_cpl-query/publish/setup/*
+  twine upload -r pip-dev.sh-edraft.de dist/sh_cpl-cli/publish/setup/*
+  twine upload -r pip-dev.sh-edraft.de dist/sh_cpl-core/publish/setup/*
+  twine upload -r pip-dev.sh-edraft.de dist/sh_cpl-query/publish/setup/*
 fi

src/cpl_cli/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_cli'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -29,4 +29,4 @@ from .main import main
 from .startup import Startup
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/_templates/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli._templates'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/_templates/build/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli._templates.build'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/_templates/generate/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli._templates.generate'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/_templates/new/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli._templates.new'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/_templates/new/console/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli._templates.new.console'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/_templates/new/console/source/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli._templates.new.console.source'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/_templates/new/console/source/name/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli._templates.new.console.source.name'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/_templates/new/console/source/name/application.py

@@ -5,29 +5,51 @@ from cpl_cli._templates.template_file_abc import TemplateFileABC
 
 class ApplicationTemplate(TemplateFileABC):
 
-    def __init__(self, name: str, path: str):
+    def __init__(self, name: str, path: str, use_async: bool):
         TemplateFileABC.__init__(self)
 
         self._name = 'application.py'
         self._path = path
-        self._value = textwrap.dedent("""\
-            from cpl_core.application import ApplicationABC
-            from cpl_core.configuration import ConfigurationABC
-            from cpl_core.console import Console
-            from cpl_core.dependency_injection import ServiceProviderABC
+        self._use_async = use_async
+        
+        if self._use_async:
+            self._value = textwrap.dedent("""\
+                from cpl_core.application import ApplicationABC
+                from cpl_core.configuration import ConfigurationABC
+                from cpl_core.console import Console
+                from cpl_core.dependency_injection import ServiceProviderABC
+                    
+                    
+                class Application(ApplicationABC):
                 
+                    def __init__(self, config: ConfigurationABC, services: ServiceProviderABC):
+                        ApplicationABC.__init__(self, config, services)
                 
-            class Application(ApplicationABC):
-            
-                def __init__(self, config: ConfigurationABC, services: ServiceProviderABC):
-                    ApplicationABC.__init__(self, config, services)
-            
-                def configure(self):
-                    pass
-            
-                def main(self):
-                    Console.write_line('Hello World')
-        """)
+                    async def configure(self):
+                        pass
+                
+                    async def main(self):
+                        Console.write_line('Hello World')
+            """)
+        else:
+            self._value = textwrap.dedent("""\
+                from cpl_core.application import ApplicationABC
+                from cpl_core.configuration import ConfigurationABC
+                from cpl_core.console import Console
+                from cpl_core.dependency_injection import ServiceProviderABC
+                    
+                    
+                class Application(ApplicationABC):
+                
+                    def __init__(self, config: ConfigurationABC, services: ServiceProviderABC):
+                        ApplicationABC.__init__(self, config, services)
+                
+                    def configure(self):
+                        pass
+                
+                    def main(self):
+                        Console.write_line('Hello World')
+            """)
 
     @property
     def name(self) -> str:

src/cpl_cli/_templates/new/console/source/name/main.py

@@ -6,7 +6,7 @@ from cpl_cli._templates.template_file_abc import TemplateFileABC
 
 class MainWithApplicationHostAndStartupTemplate(TemplateFileABC):
 
-    def __init__(self, name: str, path: str):
+    def __init__(self, name: str, path: str, use_async: bool):
         TemplateFileABC.__init__(self)
 
         name = String.convert_to_snake_case(name)
@@ -15,22 +15,44 @@ class MainWithApplicationHostAndStartupTemplate(TemplateFileABC):
 
         import_pkg = f'{name}.'
 
-        self._value = textwrap.dedent(f"""\
-            from cpl_core.application import ApplicationBuilder
-            
-            from {import_pkg}application import Application
-            from {import_pkg}startup import Startup
-            
-            
-            def main():
-                app_builder = ApplicationBuilder(Application)
-                app_builder.use_startup(Startup)
-                app_builder.build().run()
-            
-            
-            if __name__ == '__main__':
-                main()
-        """)
+        if use_async:
+            self._value = textwrap.dedent(f"""\
+                import asyncio
+                
+                from cpl_core.application import ApplicationBuilder
+                
+                from {import_pkg}application import Application
+                from {import_pkg}startup import Startup
+                
+                
+                async def main():
+                    app_builder = ApplicationBuilder(Application)
+                    app_builder.use_startup(Startup)
+                    app: Application = await app_builder.build_async()
+                    await app.run_async()
+                
+                
+                if __name__ == '__main__':
+                    ml = asyncio.get_event_loop()
+                    ml.run_until_complete(main())
+            """)
+        else:
+            self._value = textwrap.dedent(f"""\
+                from cpl_core.application import ApplicationBuilder
+                
+                from {import_pkg}application import Application
+                from {import_pkg}startup import Startup
+                
+                
+                def main():
+                    app_builder = ApplicationBuilder(Application)
+                    app_builder.use_startup(Startup)
+                    app_builder.build().run()
+                
+                
+                if __name__ == '__main__':
+                    main()
+            """)
 
     @property
     def name(self) -> str:
@@ -47,7 +69,7 @@ class MainWithApplicationHostAndStartupTemplate(TemplateFileABC):
 
 class MainWithApplicationBaseTemplate(TemplateFileABC):
 
-    def __init__(self, name: str, path: str):
+    def __init__(self, name: str, path: str, use_async: bool):
         TemplateFileABC.__init__(self)
 
         name = String.convert_to_snake_case(name)
@@ -56,20 +78,40 @@ class MainWithApplicationBaseTemplate(TemplateFileABC):
 
         import_pkg = f'{name}.'
 
-        self._value = textwrap.dedent(f"""\
-            from cpl_core.application import ApplicationBuilder
-            
-            from {import_pkg}application import Application
-            
-            
-            def main():
-                app_builder = ApplicationBuilder(Application)
-                app_builder.build().run()
-            
-            
-            if __name__ == '__main__':
-                main()
-        """)
+        if use_async:
+            self._value = textwrap.dedent(f"""\
+                import asyncio
+                
+                from cpl_core.application import ApplicationBuilder
+                
+                from {import_pkg}application import Application
+                
+                
+                async def main():
+                    app_builder = ApplicationBuilder(Application)
+                    app: Application = await app_builder.build_async()
+                    await app.run_async()
+                
+                
+                if __name__ == '__main__':
+                    ml = asyncio.get_event_loop()
+                    ml.run_until_complete(main())
+            """)
+        else:
+            self._value = textwrap.dedent(f"""\
+                from cpl_core.application import ApplicationBuilder
+                
+                from {import_pkg}application import Application
+                
+                
+                def main():
+                    app_builder = ApplicationBuilder(Application)
+                    app_builder.build().run()
+                
+                
+                if __name__ == '__main__':
+                    main()
+            """)
 
     @property
     def name(self) -> str:
@@ -86,7 +128,7 @@ class MainWithApplicationBaseTemplate(TemplateFileABC):
 
 class MainWithoutApplicationBaseTemplate(TemplateFileABC):
 
-    def __init__(self, name: str, path: str):
+    def __init__(self, name: str, path: str, use_async: bool):
         TemplateFileABC.__init__(self)
 
         name = String.convert_to_snake_case(name)
@@ -95,17 +137,33 @@ class MainWithoutApplicationBaseTemplate(TemplateFileABC):
 
         import_pkg = f'{name}.'
 
-        self._value = textwrap.dedent("""\
-            from cpl_core.console import Console
-            
-            
-            def main():
-                Console.write_line('Hello World')
-            
-            
-            if __name__ == '__main__':
-                main()
-        """)
+        if use_async:
+            self._value = textwrap.dedent("""\
+                import asyncio
+                
+                from cpl_core.console import Console
+                
+                
+                async def main():
+                    Console.write_line('Hello World')
+                
+                
+                if __name__ == '__main__':
+                    ml = asyncio.get_event_loop()
+                    ml.run_until_complete(main())
+            """)
+        else:
+            self._value = textwrap.dedent("""\
+                from cpl_core.console import Console
+                
+                
+                def main():
+                    Console.write_line('Hello World')
+                
+                
+                if __name__ == '__main__':
+                    main()
+            """)
 
     @property
     def name(self) -> str:
@@ -122,7 +180,7 @@ class MainWithoutApplicationBaseTemplate(TemplateFileABC):
 
 class MainWithDependencyInjection(TemplateFileABC):
 
-    def __init__(self, name: str, path: str):
+    def __init__(self, name: str, path: str, use_async: bool):
         TemplateFileABC.__init__(self)
 
         name = String.convert_to_snake_case(name)
@@ -131,31 +189,61 @@ class MainWithDependencyInjection(TemplateFileABC):
 
         import_pkg = f'{name}.'
 
-        self._value = textwrap.dedent("""\
-            from cpl_core.configuration import Configuration, ConfigurationABC
-            from cpl_core.console import Console
-            from cpl_core.dependency_injection import ServiceCollection, ServiceProviderABC
-            
-            
-            def configure_configuration() -> ConfigurationABC:
-                config = Configuration()
-                return config
-            
-            
-            def configure_services(config: ConfigurationABC) -> ServiceProviderABC:
-                services = ServiceCollection(config)
-                return services.build_service_provider()
-            
-            
-            def main():
-                config = configure_configuration()
-                provider = configure_services(config)
-                Console.write_line('Hello World')
-            
-            
-            if __name__ == '__main__':
-                main()
-        """)
+        if use_async:
+            self._value = textwrap.dedent("""\
+                import asyncio
+                
+                from cpl_core.configuration import Configuration, ConfigurationABC
+                from cpl_core.console import Console
+                from cpl_core.dependency_injection import ServiceCollection, ServiceProviderABC
+                
+                
+                async def configure_configuration() -> ConfigurationABC:
+                    config = Configuration()
+                    return config
+                
+                
+                async def configure_services(config: ConfigurationABC) -> ServiceProviderABC:
+                    services = ServiceCollection(config)
+                    return services.build_service_provider()
+                
+                
+                async def main():
+                    config = await configure_configuration()
+                    provider = await configure_services(config)
+                    Console.write_line('Hello World')
+                
+                
+                if __name__ == '__main__':
+                    ml = asyncio.get_event_loop()
+                    ml.run_until_complete(main())
+            """)
+        else:
+            self._value = textwrap.dedent("""\
+                from cpl_core.configuration import Configuration, ConfigurationABC
+                from cpl_core.console import Console
+                from cpl_core.dependency_injection import ServiceCollection, ServiceProviderABC
+                
+                
+                def configure_configuration() -> ConfigurationABC:
+                    config = Configuration()
+                    return config
+                
+                
+                def configure_services(config: ConfigurationABC) -> ServiceProviderABC:
+                    services = ServiceCollection(config)
+                    return services.build_service_provider()
+                
+                
+                def main():
+                    config = configure_configuration()
+                    provider = configure_services(config)
+                    Console.write_line('Hello World')
+                
+                
+                if __name__ == '__main__':
+                    main()
+            """)
 
     @property
     def name(self) -> str:

src/cpl_cli/_templates/new/console/source/name/startup.py

@@ -5,29 +5,51 @@ from cpl_cli._templates.template_file_abc import TemplateFileABC
 
 class StartupTemplate(TemplateFileABC):
 
-    def __init__(self, name: str, path: str):
+    def __init__(self, name: str, path: str, use_async: bool):
         TemplateFileABC.__init__(self)
 
         self._name = 'startup.py'
         self._path = path
-        self._value = textwrap.dedent("""\
-            from cpl_core.application import StartupABC
-            from cpl_core.configuration import ConfigurationABC
-            from cpl_core.dependency_injection import ServiceProviderABC, ServiceCollectionABC
-            from cpl_core.environment import ApplicationEnvironment
-            
-            
-            class Startup(StartupABC):
-            
-                def __init__(self):
-                    StartupABC.__init__(self)
-            
-                def configure_configuration(self, configuration: ConfigurationABC, environment: ApplicationEnvironment) -> ConfigurationABC:
-                    return configuration
-            
-                def configure_services(self, services: ServiceCollectionABC, environment: ApplicationEnvironment) -> ServiceProviderABC:
-                    return services.build_service_provider()
-        """)
+        self._use_async = use_async
+        
+        if self._use_async:
+            self._value = textwrap.dedent("""\
+                from cpl_core.application import StartupABC
+                from cpl_core.configuration import ConfigurationABC
+                from cpl_core.dependency_injection import ServiceProviderABC, ServiceCollectionABC
+                from cpl_core.environment import ApplicationEnvironment
+                
+                
+                class Startup(StartupABC):
+                
+                    def __init__(self):
+                        StartupABC.__init__(self)
+                
+                    async def configure_configuration(self, configuration: ConfigurationABC, environment: ApplicationEnvironment) -> ConfigurationABC:
+                        return configuration
+                
+                    async def configure_services(self, services: ServiceCollectionABC, environment: ApplicationEnvironment) -> ServiceProviderABC:
+                        return services.build_service_provider()
+            """)
+        else:
+            self._value = textwrap.dedent("""\
+                from cpl_core.application import StartupABC
+                from cpl_core.configuration import ConfigurationABC
+                from cpl_core.dependency_injection import ServiceProviderABC, ServiceCollectionABC
+                from cpl_core.environment import ApplicationEnvironment
+                
+                
+                class Startup(StartupABC):
+                
+                    def __init__(self):
+                        StartupABC.__init__(self)
+                
+                    def configure_configuration(self, configuration: ConfigurationABC, environment: ApplicationEnvironment) -> ConfigurationABC:
+                        return configuration
+                
+                    def configure_services(self, services: ServiceCollectionABC, environment: ApplicationEnvironment) -> ServiceProviderABC:
+                        return services.build_service_provider()
+            """)
 
     @property
     def name(self) -> str:

src/cpl_cli/_templates/new/console/source/tests/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli._templates.new.console.source.tests'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/_templates/new/library/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli._templates.new.library'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/_templates/new/library/source/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli._templates.new.library.source'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/_templates/new/library/source/name/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli._templates.new.library.source.name'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/_templates/new/library/source/name/application.py

@@ -5,29 +5,50 @@ from cpl_cli._templates.template_file_abc import TemplateFileABC
 
 class ApplicationTemplate(TemplateFileABC):
 
-    def __init__(self, name: str, path: str):
+    def __init__(self, name: str, path: str, use_async: bool):
         TemplateFileABC.__init__(self)
 
         self._name = 'application.py'
         self._path = path
-        self._value = textwrap.dedent("""\
-            from cpl_core.application import ApplicationABC
-            from cpl_core.configuration import ConfigurationABC
-            from cpl_core.console import Console
-            from cpl_core.dependency_injection import ServiceProviderABC
+        
+        if use_async:
+            self._value = textwrap.dedent("""\
+                from cpl_core.application import ApplicationABC
+                from cpl_core.configuration import ConfigurationABC
+                from cpl_core.console import Console
+                from cpl_core.dependency_injection import ServiceProviderABC
+                    
+                    
+                class Application(ApplicationABC):
                 
+                    def __init__(self, config: ConfigurationABC, services: ServiceProviderABC):
+                        ApplicationABC.__init__(self, config, services)
                 
-            class Application(ApplicationABC):
-            
-                def __init__(self, config: ConfigurationABC, services: ServiceProviderABC):
-                    ApplicationABC.__init__(self, config, services)
-            
-                def configure(self):
-                    pass
-            
-                def main(self):
-                    Console.write_line('Hello World')
-        """)
+                    async def configure(self):
+                        pass
+                
+                    async def main(self):
+                        Console.write_line('Hello World')
+            """)
+        else:
+            self._value = textwrap.dedent("""\
+                from cpl_core.application import ApplicationABC
+                from cpl_core.configuration import ConfigurationABC
+                from cpl_core.console import Console
+                from cpl_core.dependency_injection import ServiceProviderABC
+                    
+                    
+                class Application(ApplicationABC):
+                
+                    def __init__(self, config: ConfigurationABC, services: ServiceProviderABC):
+                        ApplicationABC.__init__(self, config, services)
+                
+                    def configure(self):
+                        pass
+                
+                    def main(self):
+                        Console.write_line('Hello World')
+            """)
 
     @property
     def name(self) -> str:

src/cpl_cli/_templates/new/library/source/name/main.py

@@ -5,7 +5,7 @@ from cpl_cli._templates.template_file_abc import TemplateFileABC
 
 class MainWithApplicationHostAndStartupTemplate(TemplateFileABC):
 
-    def __init__(self, name: str, path: str):
+    def __init__(self, name: str, path: str, use_async: bool):
         TemplateFileABC.__init__(self)
 
         self._name = 'main.py'
@@ -15,22 +15,44 @@ class MainWithApplicationHostAndStartupTemplate(TemplateFileABC):
         if name == '':
             import_pkg = ''
 
-        self._value = textwrap.dedent(f"""\
-            from cpl_core.application import ApplicationBuilder
-            
-            from {import_pkg}application import Application
-            from {import_pkg}startup import Startup
-            
-            
-            def main():
-                app_builder = ApplicationBuilder(Application)
-                app_builder.use_startup(Startup)
-                app_builder.build().run()
-            
-            
-            if __name__ == '__main__':
-                main()
-        """)
+        if use_async:
+            self._value = textwrap.dedent(f"""\
+                import asyncio
+                
+                from cpl_core.application import ApplicationBuilder
+                
+                from {import_pkg}application import Application
+                from {import_pkg}startup import Startup
+                
+                
+                async def main():
+                    app_builder = ApplicationBuilder(Application)
+                    app_builder.use_startup(Startup)
+                    app: Application = await app_builder.build_async()
+                    await app.run_async()
+                
+                
+                if __name__ == '__main__':
+                    ml = asyncio.get_event_loop()
+                    ml.run_until_complete(main())
+            """)
+        else:
+            self._value = textwrap.dedent(f"""\
+                from cpl_core.application import ApplicationBuilder
+                
+                from {import_pkg}application import Application
+                from {import_pkg}startup import Startup
+                
+                
+                def main():
+                    app_builder = ApplicationBuilder(Application)
+                    app_builder.use_startup(Startup)
+                    app_builder.build().run()
+                
+                
+                if __name__ == '__main__':
+                    main()
+            """)
 
     @property
     def name(self) -> str:
@@ -47,7 +69,7 @@ class MainWithApplicationHostAndStartupTemplate(TemplateFileABC):
 
 class MainWithApplicationBaseTemplate(TemplateFileABC):
 
-    def __init__(self, name: str, path: str):
+    def __init__(self, name: str, path: str, use_async: bool):
         TemplateFileABC.__init__(self)
 
         self._name = 'main.py'
@@ -57,20 +79,40 @@ class MainWithApplicationBaseTemplate(TemplateFileABC):
         if name == '':
             import_pkg = ''
 
-        self._value = textwrap.dedent(f"""\
-            from cpl_core.application import ApplicationBuilder
-            
-            from {import_pkg}application import Application
-            
-            
-            def main():
-                app_builder = ApplicationBuilder(Application)
-                app_builder.build().run()
-            
-            
-            if __name__ == '__main__':
-                main()
-        """)
+        if use_async:
+            self._value = textwrap.dedent(f"""\
+                import asyncio
+                
+                from cpl_core.application import ApplicationBuilder
+                
+                from {import_pkg}application import Application
+                
+                
+                async def main():
+                    app_builder = ApplicationBuilder(Application)
+                    app: Application = await app_builder.build_async()
+                    await app.run_async()
+                
+                
+                if __name__ == '__main__':
+                    ml = asyncio.get_event_loop()
+                    ml.run_until_complete(main())
+            """)
+        else:
+            self._value = textwrap.dedent(f"""\
+                from cpl_core.application import ApplicationBuilder
+                
+                from {import_pkg}application import Application
+                
+                
+                def main():
+                    app_builder = ApplicationBuilder(Application)
+                    app_builder.build().run()
+                
+                
+                if __name__ == '__main__':
+                    main()
+            """)
 
     @property
     def name(self) -> str:
@@ -87,23 +129,39 @@ class MainWithApplicationBaseTemplate(TemplateFileABC):
 
 class MainWithoutApplicationBaseTemplate(TemplateFileABC):
 
-    def __init__(self, name: str, path: str):
+    def __init__(self, name: str, path: str, use_async: bool):
         TemplateFileABC.__init__(self)
 
         self._name = 'main.py'
         self._path = path
 
-        self._value = textwrap.dedent("""\
-            from cpl_core.console import Console
-            
-            
-            def main():
-                Console.write_line('Hello World')
-            
-            
-            if __name__ == '__main__':
-                main()
-        """)
+        if use_async:
+            self._value = textwrap.dedent("""\
+                import asyncio
+                
+                from cpl_core.console import Console
+                
+                
+                async def main():
+                    Console.write_line('Hello World')
+                
+                
+                if __name__ == '__main__':
+                    ml = asyncio.get_event_loop()
+                    ml.run_until_complete(main())
+            """)
+        else:
+            self._value = textwrap.dedent("""\
+                from cpl_core.console import Console
+                
+                
+                def main():
+                    Console.write_line('Hello World')
+                
+                
+                if __name__ == '__main__':
+                    main()
+            """)
 
     @property
     def name(self) -> str:
@@ -120,37 +178,67 @@ class MainWithoutApplicationBaseTemplate(TemplateFileABC):
 
 class MainWithDependencyInjection(TemplateFileABC):
 
-    def __init__(self, name: str, path: str):
+    def __init__(self, name: str, path: str, use_async: bool):
         TemplateFileABC.__init__(self)
 
         self._name = 'main.py'
         self._path = path
-
-        self._value = textwrap.dedent("""\
-            from cpl_core.configuration import Configuration, ConfigurationABC
-            from cpl_core.console import Console
-            from cpl_core.dependency_injection import ServiceCollection, ServiceProviderABC
-            
-            
-            def configure_configuration() -> ConfigurationABC:
-                config = Configuration()
-                return config
-            
-            
-            def configure_services(config: ConfigurationABC) -> ServiceProviderABC:
-                services = ServiceCollection(config)
-                return services.build_service_provider()
-            
-            
-            def main():
-                config = configure_configuration()
-                provider = configure_services(config)
-                Console.write_line('Hello World')
-            
-            
-            if __name__ == '__main__':
-                main()
-        """)
+        
+        if use_async:
+            self._value = textwrap.dedent("""\
+                import asyncio
+                
+                from cpl_core.configuration import Configuration, ConfigurationABC
+                from cpl_core.console import Console
+                from cpl_core.dependency_injection import ServiceCollection, ServiceProviderABC
+                
+                
+                async def configure_configuration() -> ConfigurationABC:
+                    config = Configuration()
+                    return config
+                
+                
+                async def configure_services(config: ConfigurationABC) -> ServiceProviderABC:
+                    services = ServiceCollection(config)
+                    return services.build_service_provider()
+                
+                
+                async def main():
+                    config = await configure_configuration()
+                    provider = await configure_services(config)
+                    Console.write_line('Hello World')
+                
+                
+                if __name__ == '__main__':
+                    ml = asyncio.get_event_loop()
+                    ml.run_until_complete(main())
+            """)
+        else:
+            self._value = textwrap.dedent("""\
+                from cpl_core.configuration import Configuration, ConfigurationABC
+                from cpl_core.console import Console
+                from cpl_core.dependency_injection import ServiceCollection, ServiceProviderABC
+                
+                
+                def configure_configuration() -> ConfigurationABC:
+                    config = Configuration()
+                    return config
+                
+                
+                def configure_services(config: ConfigurationABC) -> ServiceProviderABC:
+                    services = ServiceCollection(config)
+                    return services.build_service_provider()
+                
+                
+                def main():
+                    config = configure_configuration()
+                    provider = configure_services(config)
+                    Console.write_line('Hello World')
+                
+                
+                if __name__ == '__main__':
+                    main()
+            """)
 
     @property
     def name(self) -> str:

src/cpl_cli/_templates/new/library/source/name/startup.py

@@ -5,29 +5,50 @@ from cpl_cli._templates.template_file_abc import TemplateFileABC
 
 class StartupTemplate(TemplateFileABC):
 
-    def __init__(self, name: str, path: str):
+    def __init__(self, name: str, path: str, use_async: bool):
         TemplateFileABC.__init__(self)
 
         self._name = 'startup.py'
         self._path = path
-        self._value = textwrap.dedent("""\
-            from cpl_core.application import StartupABC
-            from cpl_core.configuration import ConfigurationABC
-            from cpl_core.dependency_injection import ServiceProviderABC, ServiceCollectionABC
-            from cpl_core.environment import ApplicationEnvironment
-            
-            
-            class Startup(StartupABC):
-            
-                def __init__(self):
-                    StartupABC.__init__(self)
-            
-                def configure_configuration(self, configuration: ConfigurationABC, environment: ApplicationEnvironment) -> ConfigurationABC:
-                    return configuration
-            
-                def configure_services(self, services: ServiceCollectionABC, environment: ApplicationEnvironment) -> ServiceProviderABC:
-                    return services.build_service_provider()
-        """)
+        
+        if use_async:
+            self._value = textwrap.dedent("""\
+                from cpl_core.application import StartupABC
+                from cpl_core.configuration import ConfigurationABC
+                from cpl_core.dependency_injection import ServiceProviderABC, ServiceCollectionABC
+                from cpl_core.environment import ApplicationEnvironment
+                
+                
+                class Startup(StartupABC):
+                
+                    def __init__(self):
+                        StartupABC.__init__(self)
+                
+                    async def configure_configuration(self, configuration: ConfigurationABC, environment: ApplicationEnvironment) -> ConfigurationABC:
+                        return configuration
+                
+                    async def configure_services(self, services: ServiceCollectionABC, environment: ApplicationEnvironment) -> ServiceProviderABC:
+                        return services.build_service_provider()
+            """)
+        else:
+            self._value = textwrap.dedent("""\
+                from cpl_core.application import StartupABC
+                from cpl_core.configuration import ConfigurationABC
+                from cpl_core.dependency_injection import ServiceProviderABC, ServiceCollectionABC
+                from cpl_core.environment import ApplicationEnvironment
+                
+                
+                class Startup(StartupABC):
+                
+                    def __init__(self):
+                        StartupABC.__init__(self)
+                
+                    def configure_configuration(self, configuration: ConfigurationABC, environment: ApplicationEnvironment) -> ConfigurationABC:
+                        return configuration
+                
+                    def configure_services(self, services: ServiceCollectionABC, environment: ApplicationEnvironment) -> ServiceProviderABC:
+                        return services.build_service_provider()
+            """)
 
     @property
     def name(self) -> str:

src/cpl_cli/_templates/new/library/source/tests/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli._templates.new.library.source.tests'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/_templates/publish/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli._templates.publish'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/command/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_cli.command'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -28,4 +28,4 @@ from .publish_service import PublishService
 from .version_service import VersionService
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/command/custom_script_service.py

@@ -30,10 +30,6 @@ class CustomScriptService(CommandABC):
             if script == cmd:
                 command = self._workspace.scripts[script]
                 try:
-                    run_command = []
-                    for word in command.split(' '):
-                        run_command.append(word)
-
-                    subprocess.run(run_command)
+                    subprocess.run(command, shell=True if os.name == 'posix' else None)
                 except Exception as e:
                     Console.error(str(e))

src/cpl_cli/command/install_service.py

@@ -2,20 +2,21 @@ import json
 import os
 import subprocess
 import textwrap
+import time
 
-from packaging import version
-
-from cpl_core.configuration.configuration_abc import ConfigurationABC
-from cpl_core.console.console import Console
-from cpl_core.console.foreground_color_enum import ForegroundColorEnum
-from cpl_core.environment.application_environment_abc import ApplicationEnvironmentABC
-from cpl_core.utils.pip import Pip
 from cpl_cli.cli_settings import CLISettings
 from cpl_cli.command_abc import CommandABC
 from cpl_cli.configuration.build_settings import BuildSettings
 from cpl_cli.configuration.project_settings import ProjectSettings
 from cpl_cli.configuration.settings_helper import SettingsHelper
 from cpl_cli.error import Error
+from cpl_core.configuration.configuration_abc import ConfigurationABC
+from cpl_core.console.console import Console
+from cpl_core.console.foreground_color_enum import ForegroundColorEnum
+from cpl_core.environment.application_environment_abc import \
+    ApplicationEnvironmentABC
+from cpl_core.utils.pip import Pip
+from packaging import version
 
 
 class InstallService(CommandABC):
@@ -37,6 +38,9 @@ class InstallService(CommandABC):
         self._build_settings = build_settings
         self._project_settings = project_settings
         self._cli_settings = cli_settings
+        
+        self._is_simulating = False
+        self._is_virtual = False
 
         self._project_file = f'{self._config.get_configuration("ProjectName")}.json'
 
@@ -49,6 +53,9 @@ class InstallService(CommandABC):
         Arguments:
             package    The package to install 
         """)
+        
+    def _wait(self, t: int, *args, source: str = None, stdout=None, stderr=None):
+        time.sleep(t)
 
     def _install_project(self):
         """
@@ -64,11 +71,12 @@ class InstallService(CommandABC):
             Error.error(f'Found invalid dependencies in {self._project_file}.')
             return
 
-        Pip.set_executable(self._project_settings.python_executable)
+        if not self._is_virtual:
+            Pip.set_executable(self._project_settings.python_executable)
         for dependency in self._project_settings.dependencies:
             Console.spinner(
                 f'Installing: {dependency}',
-                Pip.install, dependency,
+                Pip.install if not self._is_virtual else self._wait, dependency if not self._is_virtual else 2,
                 source=self._cli_settings.pip_path if 'sh_cpl' in dependency else None,
                 stdout=subprocess.DEVNULL,
                 stderr=subprocess.DEVNULL,
@@ -76,7 +84,8 @@ class InstallService(CommandABC):
                 spinner_foreground_color=ForegroundColorEnum.cyan
             )
 
-        Pip.reset_executable()
+        if not self._is_virtual:
+            Pip.reset_executable()
 
     def _install_package(self, package: str):
         """
@@ -85,7 +94,8 @@ class InstallService(CommandABC):
         :return:
         """
         is_already_in_project = False
-        Pip.set_executable(self._project_settings.python_executable)
+        if not self._is_virtual:
+            Pip.set_executable(self._project_settings.python_executable)
 
         if self._project_settings is None or self._build_settings is None:
             Error.error('The command requires to be run in an CPL project, but a project could not be found.')
@@ -129,15 +139,18 @@ class InstallService(CommandABC):
 
         Console.spinner(
             f'Installing: {package}',
-            Pip.install, package,
+            Pip.install if not self._is_virtual else self._wait, package if not self._is_virtual else 2,
             source=self._cli_settings.pip_path if 'sh_cpl' in package else None,
             stdout=subprocess.DEVNULL,
             stderr=subprocess.DEVNULL,
             text_foreground_color=ForegroundColorEnum.green,
             spinner_foreground_color=ForegroundColorEnum.cyan
         )
-        new_package = Pip.get_package(name)
-        Console.write_line(new_package)
+        
+        if self._is_virtual:
+            new_package = name
+        else:
+            new_package = Pip.get_package(name)
         if new_package is None \
                 or '==' in package and \
                 version.parse(package.split('==')[1]) != version.parse(new_package.split('==')[1]):
@@ -159,14 +172,15 @@ class InstallService(CommandABC):
 
             self._project_settings.dependencies.append(new_name)
 
-            config = {
-                ProjectSettings.__name__: SettingsHelper.get_project_settings_dict(self._project_settings),
-                BuildSettings.__name__: SettingsHelper.get_build_settings_dict(self._build_settings)
-            }
-
-            with open(os.path.join(self._env.working_directory, self._project_file), 'w') as project_file:
-                project_file.write(json.dumps(config, indent=2))
-                project_file.close()
+            if not self._is_simulating:
+                config = {
+                    ProjectSettings.__name__: SettingsHelper.get_project_settings_dict(self._project_settings),
+                    BuildSettings.__name__: SettingsHelper.get_build_settings_dict(self._build_settings)
+                }
+            
+                with open(os.path.join(self._env.working_directory, self._project_file), 'w') as project_file:
+                    project_file.write(json.dumps(config, indent=2))
+                    project_file.close()
 
         Pip.reset_executable()
 
@@ -176,6 +190,16 @@ class InstallService(CommandABC):
         :param args:
         :return:
         """
+        if '--virtual' in args:
+            self._is_virtual = True
+            args.remove('--virtual')
+            Console.write_line('Running in virtual mode:')
+        
+        if '--simulate' in args:
+            self._is_virtual = True
+            args.remove('--simulate')
+            Console.write_line('Running in simulation mode:')
+
         if len(args) == 0:
             self._install_project()
         else:

src/cpl_cli/command/new_service.py

@@ -46,6 +46,7 @@ class NewService(CommandABC):
         self._use_application_api: bool = False
         self._use_startup: bool = False
         self._use_service_providing: bool = False
+        self._use_async: bool = False
 
     @property
     def help_message(self) -> str:
@@ -97,7 +98,7 @@ class NewService(CommandABC):
             ProjectSettingsNameEnum.license_name.value: '',
             ProjectSettingsNameEnum.license_description.value: '',
             ProjectSettingsNameEnum.dependencies.value: [
-                f'sh_cpl>={version.parse(cpl_core.__version__)}'
+                f'sh_cpl-core>={version.parse(cpl_core.__version__)}'
             ],
             ProjectSettingsNameEnum.python_version.value: f'>={sys.version.split(" ")[0]}',
             ProjectSettingsNameEnum.python_path.value: {
@@ -177,6 +178,10 @@ class NewService(CommandABC):
             result = Console.read('Do you want to use service providing? (y/n) ')
             if result.lower() == 'y':
                 self._use_service_providing = True
+                
+        result = Console.read('Do you want to use async? (y/n) ')
+        if result.lower() == 'y':
+            self._use_async = True
 
         Console.set_foreground_color(ForegroundColorEnum.default)
 
@@ -202,6 +207,7 @@ class NewService(CommandABC):
                 self._use_application_api,
                 self._use_startup,
                 self._use_service_providing,
+                self._use_async,
                 self._project.name,
                 self._project_json,
                 self._workspace
@@ -231,6 +237,7 @@ class NewService(CommandABC):
                 self._use_application_api,
                 self._use_startup,
                 self._use_service_providing,
+                self._use_async,
                 self._project.name,
                 self._project_json,
                 self._workspace

src/cpl_cli/command/remove_service.py

@@ -57,7 +57,8 @@ class RemoveService(CommandABC):
         ws_dict = {
             WorkspaceSettings.__name__: {
                 WorkspaceSettingsNameEnum.default_project.value: self._workspace.default_project,
-                WorkspaceSettingsNameEnum.projects.value: self._workspace.projects
+                WorkspaceSettingsNameEnum.projects.value: self._workspace.projects,
+                WorkspaceSettingsNameEnum.scripts.value: self._workspace.scripts
             }
         }
 

src/cpl_cli/command/uninstall_service.py

@@ -2,6 +2,7 @@ import json
 import os
 import subprocess
 import textwrap
+import time
 
 from cpl_core.configuration.configuration_abc import ConfigurationABC
 from cpl_core.console.console import Console
@@ -31,6 +32,9 @@ class UninstallService(CommandABC):
         self._env = env
         self._build_settings = build_settings
         self._project_settings = project_settings
+        
+        self._is_simulating = False
+        self._is_virtual = False
 
     @property
     def help_message(self) -> str:
@@ -41,6 +45,9 @@ class UninstallService(CommandABC):
         Arguments:
             package     The package to uninstall
         """)
+        
+    def _wait(self, t: int, *args, source: str = None, stdout=None, stderr=None):
+        time.sleep(t)
 
     def run(self, args: list[str]):
         """
@@ -52,13 +59,28 @@ class UninstallService(CommandABC):
             Console.error(f'Expected package')
             Console.error(f'Usage: cpl uninstall <package>')
             return
+        
+        
+        if '--virtual' in args:
+            self._is_virtual = True
+            args.remove('--virtual')
+            Console.write_line('Running in virtual mode:')
+        
+        if '--simulate' in args:
+            self._is_virtual = True
+            args.remove('--simulate')
+            Console.write_line('Running in simulation mode:')
 
-        Pip.set_executable(self._project_settings.python_executable)
+        if not self._is_virtual:
+            Pip.set_executable(self._project_settings.python_executable)
 
         package = args[0]
         is_in_dependencies = False
 
-        pip_package = Pip.get_package(package)
+        if not self._is_virtual:
+            pip_package = Pip.get_package(package)
+        else:
+            pip_package = package
 
         for dependency in self._project_settings.dependencies:
             if package in dependency:
@@ -74,7 +96,7 @@ class UninstallService(CommandABC):
 
         Console.spinner(
             f'Uninstalling: {package}',
-            Pip.uninstall, package,
+            Pip.uninstall if not self._is_virtual else self._wait, package if not self._is_virtual else 2,
             stdout=subprocess.DEVNULL,
             stderr=subprocess.DEVNULL,
             text_foreground_color=ForegroundColorEnum.green,
@@ -83,13 +105,15 @@ class UninstallService(CommandABC):
 
         if package in self._project_settings.dependencies:
             self._project_settings.dependencies.remove(package)
-            config = {
-                ProjectSettings.__name__: SettingsHelper.get_project_settings_dict(self._project_settings),
-                BuildSettings.__name__: SettingsHelper.get_build_settings_dict(self._build_settings)
-            }
-            with open(os.path.join(self._env.working_directory, f'{self._config.get_configuration("ProjectName")}.json'), 'w') as project_file:
-                project_file.write(json.dumps(config, indent=2))
-                project_file.close()
+            if not self._is_simulating:
+                config = {
+                    ProjectSettings.__name__: SettingsHelper.get_project_settings_dict(self._project_settings),
+                    BuildSettings.__name__: SettingsHelper.get_build_settings_dict(self._build_settings)
+                }
+                with open(os.path.join(self._env.working_directory, f'{self._config.get_configuration("ProjectName")}.json'), 'w') as project_file:
+                    project_file.write(json.dumps(config, indent=2))
+                    project_file.close()
 
         Console.write_line(f'Removed {package}')
-        Pip.reset_executable()
+        if not self._is_virtual:
+            Pip.reset_executable()

src/cpl_cli/command/version_service.py

@@ -52,7 +52,11 @@ class VersionService(CommandABC):
         ]
         packages = []
         for modname in cpl_packages:
-            module = pkgutil.find_loader(modname).load_module(modname)
+            module = pkgutil.find_loader(modname)
+            if module is None:
+                break
+            
+            module = module.load_module(modname)
             if '__version__' in dir(module):
                 packages.append([f'{modname}', module.__version__])
 

src/cpl_cli/configuration/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_cli.configuration'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -30,4 +30,4 @@ from .workspace_settings import WorkspaceSettings
 from .workspace_settings_name_enum import WorkspaceSettingsNameEnum
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/cpl_cli.json

@@ -3,8 +3,8 @@
     "Name": "sh_cpl-cli",
     "Version": {
       "Major": "2021",
-      "Minor": "10",
-      "Micro": "0.post2"
+      "Minor": "11",
+      "Micro": "0"
     },
     "Author": "Sven Heidemann",
     "AuthorEmail": "sven.heidemann@sh-edraft.de",
@@ -16,7 +16,7 @@
     "LicenseName": "MIT",
     "LicenseDescription": "MIT, see LICENSE for more details.",
     "Dependencies": [
-      "sh_cpl-core>=2021.10.0.post1"
+      "sh_cpl-core>=2021.10.0"
     ],
     "PythonVersion": ">=3.8",
     "PythonPath": {},

src/cpl_cli/live_server/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli.live_server'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/live_server/live_server_service.py

@@ -41,7 +41,7 @@ class LiveServerService(FileSystemEventHandler):
         :return:
         """
         self._observer = Observer()
-        self._observer.schedule(self, path=self._src_dir, recursive=True)
+        self._observer.schedule(self, path=os.path.abspath(os.path.join(self._src_dir, '../')), recursive=True)
         self._observer.start()
 
     def _restart(self):

src/cpl_cli/publish/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_cli.publish'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -24,4 +24,4 @@ from .publisher_abc import PublisherABC
 from .publisher_service import PublisherService
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/source_creator/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_cli.source_creator'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post2'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post2')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_cli/source_creator/console_builder.py

@@ -39,12 +39,12 @@ class ConsoleBuilder:
             project_json.close()
 
     @classmethod
-    def _create_workspace(cls, path: str, project_name, projects: dict):
+    def _create_workspace(cls, path: str, project_name, projects: dict, scripts: dict):
         ws_dict = {
             WorkspaceSettings.__name__: {
                 WorkspaceSettingsNameEnum.default_project.value: project_name,
                 WorkspaceSettingsNameEnum.projects.value: projects,
-                WorkspaceSettingsNameEnum.scripts.value: {}
+                WorkspaceSettingsNameEnum.scripts.value: scripts
             }
         }
 
@@ -59,19 +59,24 @@ class ConsoleBuilder:
 
     @classmethod
     def build(cls, project_path: str, use_application_api: bool, use_startup: bool, use_service_providing: bool,
-              project_name: str, project_settings: dict, workspace: Optional[WorkspaceSettings]):
+              use_async: bool, project_name: str, project_settings: dict, workspace: Optional[WorkspaceSettings]):
         """
         Builds the console project files
         :param project_path:
         :param use_application_api:
         :param use_startup:
         :param use_service_providing:
+        :param use_async:
         :param project_name:
         :param project_settings:
         :param workspace:
         :return:
         """
-        project_name_snake = String.convert_to_snake_case(project_name)
+        pj_name = project_name
+        if '/' in pj_name:
+            pj_name = pj_name.split('/')[len(pj_name.split('/')) - 1]
+
+        project_name_snake = String.convert_to_snake_case(pj_name)
 
         if workspace is None:
             templates: list[TemplateFileABC] = [
@@ -79,7 +84,8 @@ class ConsoleBuilder:
                 ReadmeTemplate(),
                 TestsInitTemplate(),
                 AppsettingsTemplate(),
-                MainInitTemplate(project_name, os.path.join('src/', project_name_snake))
+                MainInitTemplate(project_name, os.path.join(
+                    'src/', project_name_snake))
             ]
         else:
             project_path = os.path.join(
@@ -88,8 +94,6 @@ class ConsoleBuilder:
             )
 
             templates: list[TemplateFileABC] = [
-                LicenseTemplate(),
-                ReadmeTemplate(),
                 AppsettingsTemplate(),
                 MainInitTemplate('', '')
             ]
@@ -103,36 +107,62 @@ class ConsoleBuilder:
             src_rel_path = os.path.join('src/', src_name)
 
         if use_application_api:
-            templates.append(ApplicationTemplate(src_name, src_rel_path))
+            templates.append(ApplicationTemplate(
+                src_name, src_rel_path, use_async))
 
             if use_startup:
-                templates.append(StartupTemplate(src_name, src_rel_path))
-                templates.append(MainWithApplicationHostAndStartupTemplate(src_name, src_rel_path))
+                templates.append(StartupTemplate(
+                    src_name, src_rel_path, use_async))
+                templates.append(MainWithApplicationHostAndStartupTemplate(
+                    src_name, src_rel_path, use_async))
             else:
-                templates.append(MainWithApplicationBaseTemplate(src_name, src_rel_path))
+                templates.append(MainWithApplicationBaseTemplate(
+                    src_name, src_rel_path, use_async))
         else:
             if use_service_providing:
-                templates.append(MainWithDependencyInjection(src_name, src_rel_path))
+                templates.append(MainWithDependencyInjection(
+                    src_name, src_rel_path, use_async))
             else:
-                templates.append(MainWithoutApplicationBaseTemplate(src_name, src_rel_path))
+                templates.append(MainWithoutApplicationBaseTemplate(
+                    src_name, src_rel_path, use_async))
+
+        if '/' in project_name:
+            old_pj_name = project_name
+            parts = project_name.split('/')
+            project_name = parts[len(parts) - 1]
+            src_rel_path = old_pj_name.split(project_name)[0]
 
         proj_name = project_name
+        if src_rel_path.endswith('/'):
+            src_rel_path = src_rel_path[:len(src_rel_path) - 1]
+
+        if src_rel_path != '':
+            proj_name = f'{src_rel_path}/{project_name}'
         if workspace is not None:
             proj_name = project_name_snake
 
-        project_file_path = f'{project_name_snake}/{project_name}.json'
+        if src_rel_path != '':
+            project_file_path = f'{src_rel_path}/{project_name_snake}/{project_name}.json'
+        else:
+            project_file_path = f'{project_name_snake}/{project_name}.json'
+
         if workspace is None:
             src_path = f'src/{project_name_snake}'
             workspace_file_path = f'{proj_name}/cpl-workspace.json'
             project_file_rel_path = f'{src_path}/{project_name}.json'
             project_file_path = f'{proj_name}/{src_path}/{project_name}.json'
-            cls._create_workspace(workspace_file_path, project_name, {
-                project_name: project_file_rel_path
-            })
+            cls._create_workspace(
+                workspace_file_path,
+                project_name, 
+                {
+                    project_name: project_file_rel_path
+                },
+                {}
+            )
 
         else:
             workspace.projects[project_name] = f'src/{project_file_path}'
-            cls._create_workspace('cpl-workspace.json', workspace.default_project, workspace.projects)
+            cls._create_workspace('cpl-workspace.json', workspace.default_project, workspace.projects, workspace.scripts)
 
         Console.spinner(
             f'Creating {project_file_path}',

src/cpl_cli/source_creator/library_builder.py

@@ -39,12 +39,12 @@ class LibraryBuilder:
             project_json.close()
 
     @classmethod
-    def _create_workspace(cls, path: str, project_name, projects: dict):
+    def _create_workspace(cls, path: str, project_name, projects: dict, scripts: dict):
         ws_dict = {
             WorkspaceSettings.__name__: {
                 WorkspaceSettingsNameEnum.default_project.value: project_name,
                 WorkspaceSettingsNameEnum.projects.value: projects,
-                WorkspaceSettingsNameEnum.scripts.value: {}
+                WorkspaceSettingsNameEnum.scripts.value: scripts,
             }
         }
 
@@ -59,7 +59,7 @@ class LibraryBuilder:
 
     @classmethod
     def build(cls, project_path: str, use_application_api: bool, use_startup: bool,
-              use_service_providing: bool, project_name: str, project_settings: dict,
+              use_async: bool, use_service_providing: bool, project_name: str, project_settings: dict,
               workspace: Optional[WorkspaceSettings]):
         """
         Builds the library project files
@@ -67,19 +67,25 @@ class LibraryBuilder:
         :param use_application_api:
         :param use_startup:
         :param use_service_providing:
+        :param use_async:
         :param project_name:
         :param project_settings:
         :param workspace:
         :return:
         """
-        project_name_snake = String.convert_to_snake_case(project_name)
+        pj_name = project_name
+        if '/' in pj_name:
+            pj_name = pj_name.split('/')[len(pj_name.split('/')) - 1]
+
+        project_name_snake = String.convert_to_snake_case(pj_name)
 
         if workspace is None:
             templates: list[TemplateFileABC] = [
                 LicenseTemplate(),
                 ReadmeTemplate(),
                 TestsInitTemplate(),
-                NameInitTemplate(project_name, os.path.join('src/', project_name_snake)),
+                NameInitTemplate(project_name, os.path.join(
+                    'src/', project_name_snake)),
                 AppsettingsTemplate()
             ]
         else:
@@ -104,36 +110,62 @@ class LibraryBuilder:
             src_rel_path = os.path.join('src/', src_name)
 
         if use_application_api:
-            templates.append(ApplicationTemplate(src_name, src_rel_path))
+            templates.append(ApplicationTemplate(
+                src_name, src_rel_path, use_async))
 
             if use_startup:
-                templates.append(StartupTemplate(src_name, src_rel_path))
-                templates.append(MainWithApplicationHostAndStartupTemplate(src_name, src_rel_path))
+                templates.append(StartupTemplate(
+                    src_name, src_rel_path, use_async))
+                templates.append(MainWithApplicationHostAndStartupTemplate(
+                    src_name, src_rel_path, use_async))
             else:
-                templates.append(MainWithApplicationBaseTemplate(src_name, src_rel_path))
+                templates.append(MainWithApplicationBaseTemplate(
+                    src_name, src_rel_path, use_async))
         else:
             if use_service_providing:
-                templates.append(MainWithDependencyInjection(src_name, src_rel_path))
+                templates.append(MainWithDependencyInjection(
+                    src_name, src_rel_path, use_async))
             else:
-                templates.append(MainWithoutApplicationBaseTemplate(src_name, src_rel_path))
+                templates.append(MainWithoutApplicationBaseTemplate(
+                    src_name, src_rel_path, use_async))
+
+        if '/' in project_name:
+            old_pj_name = project_name
+            parts = project_name.split('/')
+            project_name = parts[len(parts) - 1]
+            src_rel_path = old_pj_name.split(project_name)[0]
 
         proj_name = project_name
+        if src_rel_path.endswith('/'):
+            src_rel_path = src_rel_path[:len(src_rel_path) - 1]
+        
+        if src_rel_path != '':
+            proj_name = f'{src_rel_path}/{project_name}'
         if workspace is not None:
             proj_name = project_name_snake
 
-        project_file_path = f'{project_name_snake}/{project_name}.json'
+        if src_rel_path != '':
+            project_file_path = f'{src_rel_path}/{project_name_snake}/{project_name}.json'
+        else:
+            project_file_path = f'{project_name_snake}/{project_name}.json'
+
         if workspace is None:
             src_path = f'src/{project_name_snake}'
             workspace_file_path = f'{proj_name}/cpl-workspace.json'
             project_file_rel_path = f'{src_path}/{project_name}.json'
             project_file_path = f'{proj_name}/{src_path}/{project_name}.json'
-            cls._create_workspace(workspace_file_path, project_name, {
-                project_name: project_file_rel_path
-            })
+            cls._create_workspace(
+                workspace_file_path,
+                project_name, 
+                {
+                    project_name: project_file_rel_path
+                },
+                {}
+            )
 
         else:
             workspace.projects[project_name] = f'src/{project_file_path}'
-            cls._create_workspace('cpl-workspace.json', workspace.default_project, workspace.projects)
+            cls._create_workspace('cpl-workspace.json', workspace.default_project, workspace.projects, workspace.scripts)
 
         Console.spinner(
             f'Creating {project_file_path}',

src/cpl_cli/startup.py

@@ -55,7 +55,10 @@ class Startup(StartupABC):
             ConsoleArgument('', 'help', ['h', 'H'], ' ', is_value_token_optional=True)
         )
         configuration.add_console_argument(
-            ConsoleArgument('', 'install', ['i', 'I'], ' ', is_value_token_optional=True)
+            ConsoleArgument('', 'install', ['i', 'I'], ' ', is_value_token_optional=True, console_arguments= [
+                ConsoleArgument('', '--virtual', ['--v', '--V'], ''),
+                ConsoleArgument('', '--simulate', ['--s', '--S'], ''),
+            ])
         )
         configuration.add_console_argument(ConsoleArgument('', 'new', ['n', 'N'], '', console_arguments=[
             ConsoleArgument('', 'console', ['c', 'C'], ' '),

src/cpl_cli/tests/custom/database/src/model/city_model.py

@@ -1,14 +0,0 @@
-from sqlalchemy import Column, Integer, String
-
-from cpl_core.database import DatabaseModel
-
-
-class CityModel(DatabaseModel):
-    __tablename__ = 'Cities'
-    Id = Column(Integer, primary_key=True, nullable=False, autoincrement=True)
-    Name = Column(String(64), nullable=False)
-    ZIP = Column(String(5), nullable=False)
-
-    def __init__(self, name: str, zip_code: str):
-        self.Name = name
-        self.ZIP = zip_code

src/cpl_cli/tests/custom/database/src/model/user_model.py

@@ -1,18 +0,0 @@
-from sqlalchemy import Column, Integer, String, ForeignKey
-from sqlalchemy.orm import relationship
-
-from cpl_core.database import DatabaseModel
-from .city_model import CityModel
-
-
-class UserModel(DatabaseModel):
-    __tablename__ = 'Users'
-    Id = Column(Integer, primary_key=True, nullable=False, autoincrement=True)
-    Name = Column(String(64), nullable=False)
-    City_Id = Column(Integer, ForeignKey('Cities.Id'), nullable=False)
-    City = relationship("CityModel")
-
-    def __init__(self, name: str, city: CityModel):
-        self.Name = name
-        self.City_Id = city.Id
-        self.City = city

src/cpl_cli/tests/custom/database/src/model/user_repo.py

@@ -1,29 +0,0 @@
-from cpl_core.database.context import DatabaseContextABC
-from .city_model import CityModel
-from .user_model import UserModel
-from .user_repo_abc import UserRepoABC
-
-
-class UserRepo(UserRepoABC):
-
-    def __init__(self, db_context: DatabaseContextABC):
-        UserRepoABC.__init__(self)
-
-        self._session = db_context.session
-        self._user_query = db_context.session.query(UserModel)
-
-    def create(self): pass
-
-    def add_test_user(self):
-        city = CityModel('Haren', '49733')
-        city2 = CityModel('Meppen', '49716')
-        self._session.add(city2)
-        user = UserModel('TestUser', city)
-        self._session.add(user)
-        self._session.commit()
-
-    def get_users(self) -> list[UserModel]:
-        return self._session.query(UserModel).all()
-
-    def get_cities(self) -> list[CityModel]:
-        return self._session.query(CityModel).all()

src/cpl_cli/tests/custom/database/src/startup.py

@@ -1,39 +0,0 @@
-from cpl_core.application import StartupABC
-from cpl_core.configuration import ConfigurationABC
-from cpl_core.database import DatabaseSettings
-from cpl_core.dependency_injection import ServiceProviderABC, ServiceCollectionABC
-from cpl_core.logging import LoggerABC, Logger
-from model.db_context import DBContext
-from model.user_repo import UserRepo
-from model.user_repo_abc import UserRepoABC
-
-
-class Startup(StartupABC):
-
-    def __init__(self, config: ConfigurationABC, services: ServiceCollectionABC):
-        StartupABC.__init__(self)
-
-        self._configuration = config
-        self._environment = self._configuration.environment
-        self._services = services
-
-    def configure_configuration(self) -> ConfigurationABC:
-        self._configuration.add_environment_variables('PYTHON_')
-        self._configuration.add_environment_variables('CPL_')
-        self._configuration.add_console_arguments()
-        self._configuration.add_json_file(f'appsettings.json')
-        self._configuration.add_json_file(f'appsettings.{self._configuration.environment.environment_name}.json')
-        self._configuration.add_json_file(f'appsettings.{self._configuration.environment.host_name}.json', optional=True)
-
-        return self._configuration
-
-    def configure_services(self) -> ServiceProviderABC:
-        # Create and connect to database
-        db_settings: DatabaseSettings = self._configuration.get_configuration(DatabaseSettings)
-        self._services.add_db_context(DBContext, db_settings)
-
-        self._services.add_singleton(UserRepoABC, UserRepo)
-
-        self._services.add_singleton(LoggerABC, Logger)
-        return self._services.build_service_provider()
-

src/cpl_core/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_core'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_core/application/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_core.application'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -26,4 +26,4 @@ from .application_builder_abc import ApplicationBuilderABC
 from .startup_abc import StartupABC
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_core/application/application_abc.py

@@ -34,6 +34,17 @@ class ApplicationABC(ABC):
             self.main()
         except KeyboardInterrupt:
             Console.close()
+    
+    async def run_async(self):
+        r"""Entry point
+
+        Called by custom Application.main
+        """
+        try:
+            await self.configure()
+            await self.main()
+        except KeyboardInterrupt:
+            Console.close()
 
     @abstractmethod
     def configure(self):

src/cpl_core/application/application_builder.py

@@ -1,4 +1,3 @@
-import types
 from typing import Type, Optional, Callable
 
 from cpl_core.application.application_abc import ApplicationABC
@@ -6,7 +5,6 @@ from cpl_core.application.application_builder_abc import ApplicationBuilderABC
 from cpl_core.application.application_extension_abc import ApplicationExtensionABC
 from cpl_core.application.startup_abc import StartupABC
 from cpl_core.configuration.configuration import Configuration
-from cpl_core.console import Console
 from cpl_core.dependency_injection.service_collection import ServiceCollection
 
 
@@ -50,3 +48,17 @@ class ApplicationBuilder(ApplicationBuilderABC):
             extension.run(config, services)
 
         return self._app(config, services)
+
+    async def build_async(self) -> ApplicationABC:
+        if self._startup is not None:
+            await self._startup.configure_configuration(self._configuration, self._environment)
+            await self._startup.configure_services(self._services, self._environment)
+
+        config = self._configuration
+        services = self._services.build_service_provider()
+
+        for ex in self._extensions:
+            extension = ex()
+            await extension.run(config, services)
+
+        return self._app(config, services)

src/cpl_core/application/application_builder_abc.py

@@ -23,6 +23,17 @@ class ApplicationBuilderABC(ABC):
         """
         pass
 
+    @abstractmethod
+    async def use_startup(self, startup: Type[StartupABC]):
+        r"""Sets the custom startup class to use async
+
+        Parameter
+        ---------
+            startup: Type[:class:`cpl_core.application.startup_abc.StartupABC`]
+                Startup class to use
+        """
+        pass
+
     @abstractmethod
     def build(self) -> ApplicationABC:
         r"""Creates custom application object
@@ -32,3 +43,13 @@ class ApplicationBuilderABC(ABC):
             Object of :class:`cpl_core.application.application_abc.ApplicationABC`
         """
         pass
+
+    @abstractmethod
+    async def build_async(self) -> ApplicationABC:
+        r"""Creates custom application object async
+
+        Returns
+        -------
+            Object of :class:`cpl_core.application.application_abc.ApplicationABC`
+        """
+        pass

src/cpl_core/application/application_extension_abc.py

@@ -11,3 +11,6 @@ class ApplicationExtensionABC(ABC):
 
     @abstractmethod
     def run(self, config: ConfigurationABC, services: ServiceProviderABC): pass
+    
+    @abstractmethod
+    async def run(self, config: ConfigurationABC, services: ServiceProviderABC): pass

src/cpl_core/configuration/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_core.configuration'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -27,4 +27,4 @@ from .configuration_variable_name_enum import ConfigurationVariableNameEnum
 from .console_argument import ConsoleArgument
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_core/console/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_core.console'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -27,4 +27,4 @@ from .foreground_color_enum import ForegroundColorEnum
 from .spinner_thread import SpinnerThread
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_core/cpl_core.json

@@ -3,8 +3,8 @@
     "Name": "sh_cpl-core",
     "Version": {
       "Major": "2021",
-      "Minor": "10",
-      "Micro": "0.post1"
+      "Minor": "11",
+      "Micro": "0"
     },
     "Author": "Sven Heidemann",
     "AuthorEmail": "sven.heidemann@sh-edraft.de",
@@ -19,15 +19,14 @@
       "colorama==0.4.4",
       "mysql-connector==2.2.9",
       "psutil==5.8.0",
-      "packaging==20.9",
+      "packaging==21.3",
       "pyfiglet==0.8.post1",
-      "pynput==1.7.3",
-      "SQLAlchemy==1.4.7",
-      "setuptools==56.0.0",
+      "pynput==1.7.5",
+      "setuptools==59.4.0",
       "tabulate==0.8.9",
       "termcolor==1.1.0",
-      "watchdog==2.0.2",
-      "wheel==0.36.2"
+      "watchdog==2.1.6",
+      "wheel==0.37.0"
     ],
     "PythonVersion": ">=3.8",
     "PythonPath": {},

src/cpl_core/database/__init__.py

@@ -15,14 +15,14 @@ __title__ = 'cpl_core.database'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
-from .database_model import DatabaseModel
-from .database_settings import DatabaseSettings
 from .database_settings_name_enum import DatabaseSettingsNameEnum
+from .database_settings import DatabaseSettings
+from .table_abc import TableABC
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_core/database/connection/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_core.database.connection'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -24,4 +24,4 @@ from .database_connection import DatabaseConnection
 from .database_connection_abc import DatabaseConnectionABC
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_core/database/connection/database_connection.py

@@ -1,64 +1,52 @@
 from typing import Optional
 
-from sqlalchemy import engine, create_engine
-from sqlalchemy.orm import Session, sessionmaker
-
-from cpl_core.console.console import Console
-from cpl_core.console.foreground_color_enum import ForegroundColorEnum
-from cpl_core.database.connection.database_connection_abc import DatabaseConnectionABC
+import mysql.connector as sql
+from cpl_core.database.connection.database_connection_abc import \
+    DatabaseConnectionABC
 from cpl_core.database.database_settings import DatabaseSettings
+from cpl_core.utils.credential_manager import CredentialManager
+from mysql.connector.abstracts import MySQLConnectionAbstract
+from mysql.connector.cursor import MySQLCursorBuffered
 
 
 class DatabaseConnection(DatabaseConnectionABC):
     r"""Representation of the database connection
-
-    Parameter
-    ---------
-        database_settings: :class:`cpl_core.database.database_settings.DatabaseSettings`
     """
 
-    def __init__(self, database_settings: DatabaseSettings):
+    def __init__(self):
         DatabaseConnectionABC.__init__(self)
 
-        self._db_settings = database_settings
-
-        self._engine: Optional[engine] = None
-        self._session: Optional[Session] = None
-        self._credentials: Optional[str] = None
+        self._database: Optional[MySQLConnectionAbstract] = None
+        self._cursor: Optional[MySQLCursorBuffered] = None
 
     @property
-    def engine(self) -> engine:
-        return self._engine
+    def server(self) -> MySQLConnectionAbstract:
+        return self._database
 
     @property
-    def session(self) -> Session:
-        return self._session
+    def cursor(self) -> MySQLCursorBuffered:
+        return self._cursor
 
-    def connect(self, connection_string: str):
-        try:
-            self._engine = create_engine(connection_string)
-
-            if self._db_settings.auth_plugin is not None:
-                self._engine = create_engine(connection_string, connect_args={'auth_plugin': self._db_settings.auth_plugin})
-
-            if self._db_settings.encoding is not None:
-                self._engine.encoding = self._db_settings.encoding
-
-            if self._db_settings.case_sensitive is not None:
-                self._engine.case_sensitive = self._db_settings.case_sensitive
-
-            if self._db_settings.echo is not None:
-                self._engine.echo = self._db_settings.echo
-
-            self._engine.connect()
-
-            db_session = sessionmaker(bind=self._engine)
-            self._session = db_session()
-            Console.set_foreground_color(ForegroundColorEnum.green)
-            Console.write_line(f'[{__name__}] Connected to database')
-            Console.set_foreground_color(ForegroundColorEnum.default)
-        except Exception as e:
-            Console.set_foreground_color(ForegroundColorEnum.red)
-            Console.write_line(f'[{__name__}] Database connection failed -> {e}')
-            Console.set_foreground_color(ForegroundColorEnum.default)
-            exit()
+    def connect(self, database_settings: DatabaseSettings):
+        connection = sql.connect(
+            host=database_settings.host,
+            user=database_settings.user,
+            passwd=CredentialManager.decrypt(database_settings.password),
+            charset=database_settings.charset,
+            use_unicode=database_settings.use_unicode,
+            buffered=database_settings.buffered,
+            auth_plugin=database_settings.auth_plugin
+        )
+        connection.cursor().execute(
+            f'CREATE DATABASE IF NOT EXISTS `{database_settings.database}`;')
+        self._database = sql.connect(
+            host=database_settings.host,
+            user=database_settings.user,
+            passwd=CredentialManager.decrypt(database_settings.password),
+            db=database_settings.database,
+            charset=database_settings.charset,
+            use_unicode=database_settings.use_unicode,
+            buffered=database_settings.buffered,
+            auth_plugin=database_settings.auth_plugin
+        )
+        self._cursor = self._database.cursor()

src/cpl_core/database/connection/database_connection_abc.py

@@ -1,7 +1,8 @@
-from abc import abstractmethod, ABC
+from abc import ABC, abstractmethod
 
-from sqlalchemy import engine
-from sqlalchemy.orm import Session
+from cpl_core.database.database_settings import DatabaseSettings
+from mysql.connector.abstracts import MySQLConnectionAbstract
+from mysql.connector.cursor import MySQLCursorBuffered
 
 
 class DatabaseConnectionABC(ABC):
@@ -12,14 +13,14 @@ class DatabaseConnectionABC(ABC):
 
     @property
     @abstractmethod
-    def engine(self) -> engine: pass
-
+    def server(self) -> MySQLConnectionAbstract: pass
+    
     @property
     @abstractmethod
-    def session(self) -> Session: pass
-
+    def cursor(self) -> MySQLCursorBuffered: pass
+    
     @abstractmethod
-    def connect(self, connection_string: str):
+    def connect(self, database_settings: DatabaseSettings):
         r"""Connects to a database by connection string
 
         Parameter

src/cpl_core/database/context/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_core.database.context'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -24,4 +24,4 @@ from .database_context import DatabaseContext
 from .database_context_abc import DatabaseContextABC
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_core/database/context/database_context.py

@@ -1,13 +1,13 @@
-from sqlalchemy import engine, Table
-from sqlalchemy.orm import Session
 
-from cpl_core.console.console import Console
-from cpl_core.console.foreground_color_enum import ForegroundColorEnum
+from typing import Optional
+
 from cpl_core.database.connection.database_connection import DatabaseConnection
-from cpl_core.database.connection.database_connection_abc import DatabaseConnectionABC
+from cpl_core.database.connection.database_connection_abc import \
+    DatabaseConnectionABC
 from cpl_core.database.context.database_context_abc import DatabaseContextABC
 from cpl_core.database.database_settings import DatabaseSettings
-from cpl_core.database.database_model import DatabaseModel
+from cpl_core.database.table_abc import TableABC
+from mysql.connector.cursor import MySQLCursorBuffered
 
 
 class DatabaseContext(DatabaseContextABC):
@@ -19,38 +19,23 @@ class DatabaseContext(DatabaseContextABC):
     """
 
     def __init__(self, database_settings: DatabaseSettings):
-        DatabaseContextABC.__init__(self)
+        DatabaseContextABC.__init__(self, database_settings)
 
-        self._db: DatabaseConnectionABC = DatabaseConnection(database_settings)
-        self._tables: list[Table] = []
+        self._db: DatabaseConnectionABC = DatabaseConnection()
+        self._tables: list[TableABC] = TableABC.__subclasses__()
 
     @property
-    def engine(self) -> engine:
-        return self._db.engine
-
-    @property
-    def session(self) -> Session:
-        return self._db.session
-
-    def connect(self, connection_string: str):
-        self._db.connect(connection_string)
-        self._create_tables()
+    def cursor(self) -> MySQLCursorBuffered:
+        return self._db.cursor
+    
+    def connect(self, database_settings: DatabaseSettings):
+        self._db.connect(database_settings)
+        for table in self._tables:
+            self._db.cursor.execute(table.get_create_string())
 
     def save_changes(self):
-        self._db.session.commit()
-
-    def _create_tables(self):
-        try:
-            for subclass in DatabaseModel.__subclasses__():
-                self._tables.append(subclass.__table__)
-
-            DatabaseModel.metadata.drop_all(self._db.engine, self._tables)
-            DatabaseModel.metadata.create_all(self._db.engine, self._tables, checkfirst=True)
-            Console.set_foreground_color(ForegroundColorEnum.green)
-            Console.write_line(f'[{__name__}] Created tables')
-            Console.set_foreground_color(ForegroundColorEnum.default)
-        except Exception as e:
-            Console.set_foreground_color(ForegroundColorEnum.red)
-            Console.write_line(f'[{__name__}] Creating tables failed -> {e}')
-            Console.set_foreground_color(ForegroundColorEnum.default)
-            exit()
+        self._db.server.commit()
+        
+    def select(self, statement: str) -> list[tuple]:
+        self._db.cursor.execute(statement)
+        return self._db.cursor.fetchall()

src/cpl_core/database/context/database_context_abc.py

@@ -1,7 +1,7 @@
-from abc import abstractmethod, ABC
+from abc import ABC, abstractmethod
 
-from sqlalchemy import engine
-from sqlalchemy.orm import Session
+from cpl_core.database.database_settings import DatabaseSettings
+from mysql.connector.cursor import MySQLCursorBuffered
 
 
 class DatabaseContextABC(ABC):
@@ -12,29 +12,34 @@ class DatabaseContextABC(ABC):
         pass
 
     @property
+    def cursor(self) -> MySQLCursorBuffered:
+        return self._cursor
+    
     @abstractmethod
-    def engine(self) -> engine: pass
-
-    @property
-    @abstractmethod
-    def session(self) -> Session: pass
-
-    @abstractmethod
-    def connect(self, connection_string: str):
-        r"""Connects to a database by connection string
+    def connect(self, database_settings: DatabaseSettings):
+        r"""Connects to a database by connection settings
 
         Parameter
         ---------
-            connection_string: :class:`str`
-                Database connection string, see: https://docs.sqlalchemy.org/en/14/core/engines.html
+            database_settings :class:`cpl_core.database.database_settings.DatabaseSettings`
         """
         pass
-
+    
+    @abstractmethod
     def save_changes(self):
         r"""Saves changes of the database"""
         pass
-
+    
     @abstractmethod
-    def _create_tables(self):
-        r"""Create all tables for application from database model"""
+    def select(self, statement: str) -> list[tuple]:
+        r"""Runs SQL Statements
+        
+        Parameter
+        ---------
+            statement: :class:`str`
+        
+        Returns
+        -------
+            list: Fetched list of selected elements
+        """
         pass

src/cpl_core/database/database_model.py

@@ -1,3 +0,0 @@
-from sqlalchemy.ext.declarative import declarative_base
-
-DatabaseModel: declarative_base = declarative_base()

src/cpl_core/database/database_settings.py

@@ -13,61 +13,47 @@ class DatabaseSettings(ConfigurationModelABC):
     def __init__(self):
         ConfigurationModelABC.__init__(self)
 
+        self._host: Optional[str] = None
+        self._user: Optional[str] = None
+        self._password: Optional[str] = None
+        self._databse: Optional[str] = None
+        self._charset: Optional[str] = None
+        self._use_unicode: Optional[bool] = None
+        self._buffered: Optional[bool] = None
         self._auth_plugin: Optional[str] = None
-        self._connection_string: Optional[str] = None
-        self._credentials: Optional[str] = None
-        self._encoding: Optional[str] = None
-        self._case_sensitive: Optional[bool] = None
-        self._echo: Optional[bool] = None
 
     @property
-    def auth_plugin(self) -> str:
+    def host(self) -> Optional[str]:
+        return self._host
+
+    @property
+    def user(self) -> Optional[str]:
+        return self._user
+
+    @property
+    def password(self) -> Optional[str]:
+        return self._password
+
+    @property
+    def database(self) -> Optional[str]:
+        return self._databse
+
+    @property
+    def charset(self) -> Optional[str]:
+        return self._charset
+
+    @property
+    def use_unicode(self) -> Optional[bool]:
+        return self._use_unicode
+
+    @property
+    def buffered(self) -> Optional[bool]:
+        return self._buffered
+
+    @property
+    def auth_plugin(self) -> Optional[str]:
         return self._auth_plugin
 
-    @auth_plugin.setter
-    def auth_plugin(self, auth_plugin: str):
-        self._auth_plugin = auth_plugin
-
-    @property
-    def connection_string(self) -> str:
-        return self._connection_string
-
-    @connection_string.setter
-    def connection_string(self, connection_string: str):
-        self._connection_string = connection_string
-
-    @property
-    def credentials(self) -> str:
-        return self._credentials
-
-    @credentials.setter
-    def credentials(self, credentials: str):
-        self._credentials = credentials
-
-    @property
-    def encoding(self) -> str:
-        return self._encoding
-
-    @encoding.setter
-    def encoding(self, encoding: str) -> None:
-        self._encoding = encoding
-
-    @property
-    def case_sensitive(self) -> bool:
-        return self._case_sensitive
-
-    @case_sensitive.setter
-    def case_sensitive(self, case_sensitive: bool) -> None:
-        self._case_sensitive = case_sensitive
-
-    @property
-    def echo(self) -> bool:
-        return self._echo
-
-    @echo.setter
-    def echo(self, echo: bool) -> None:
-        self._echo = echo
-
     def from_dict(self, settings: dict):
         r"""Sets attributes from given dict
 
@@ -76,20 +62,22 @@ class DatabaseSettings(ConfigurationModelABC):
         settings: :class:`dict`
         """
         try:
-            self._connection_string = settings[DatabaseSettingsNameEnum.connection_string.value]
-            self._credentials = settings[DatabaseSettingsNameEnum.credentials.value]
-
+            self._host = settings[DatabaseSettingsNameEnum.host.value]
+            self._user = settings[DatabaseSettingsNameEnum.user.value]
+            self._password = settings[DatabaseSettingsNameEnum.password.value]
+            self._databse = settings[DatabaseSettingsNameEnum.database.value]
+            
+            if DatabaseSettingsNameEnum.charset.value in settings:
+                self._charset = settings[DatabaseSettingsNameEnum.charset.value]
+            
+            if DatabaseSettingsNameEnum.buffered.value in settings:
+                self._use_unicode = bool(settings[DatabaseSettingsNameEnum.use_unicode.value])
+            
+            if DatabaseSettingsNameEnum.buffered.value in settings:
+                self._buffered = bool(settings[DatabaseSettingsNameEnum.buffered.value])
+            
             if DatabaseSettingsNameEnum.auth_plugin.value in settings:
                 self._auth_plugin = settings[DatabaseSettingsNameEnum.auth_plugin.value]
-
-            if DatabaseSettingsNameEnum.encoding.value in settings:
-                self._encoding = settings[DatabaseSettingsNameEnum.encoding.value]
-
-            if DatabaseSettingsNameEnum.case_sensitive.value in settings:
-                self._case_sensitive = bool(settings[DatabaseSettingsNameEnum.case_sensitive.value])
-
-            if DatabaseSettingsNameEnum.echo.value in settings:
-                self._echo = bool(settings[DatabaseSettingsNameEnum.echo.value])
         except Exception as e:
             Console.set_foreground_color(ForegroundColorEnum.red)
             Console.write_line(f'[ ERROR ] [ {__name__} ]: Reading error in {self.__name__} settings')

src/cpl_core/database/database_settings_name_enum.py

@@ -3,9 +3,11 @@ from enum import Enum
 
 class DatabaseSettingsNameEnum(Enum):
 
-    connection_string = 'ConnectionString'
-    credentials = 'Credentials'
-    encoding = 'Encoding'
-    case_sensitive = 'CaseSensitive'
-    echo = 'Echo'
+    host = 'Host'
+    user = 'User'
+    password = 'Password'
+    database = 'Database'
+    charset = 'Charset'
+    use_unicode = 'UseUnicode'
+    buffered = 'Buffered'
     auth_plugin = 'AuthPlugin'

src/cpl_core/database/table_abc.py

@@ -0,0 +1,35 @@
+from abc import ABC, abstractmethod
+from datetime import datetime
+from typing import Optional
+
+
+class TableABC(ABC):
+
+    @abstractmethod
+    def __init__(self):
+        self._created_at: Optional[datetime] = None
+        self._modified_at: Optional[datetime] = None
+    
+    @property
+    def CreatedAt(self) -> datetime:
+        return self._created_at
+    
+    @property
+    def LastModifiedAt(self) -> datetime:
+        return self._modified_at
+    
+    @staticmethod
+    @abstractmethod
+    def get_create_string() -> str: pass
+    
+    @property
+    @abstractmethod
+    def insert_string(self) -> str: pass
+    
+    @property
+    @abstractmethod
+    def udpate_string(self) -> str: pass
+    
+    @property
+    @abstractmethod
+    def delete_string(self) -> str: pass

src/cpl_core/dependency_injection/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_core.dependency_injection'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -28,4 +28,4 @@ from .service_provider import ServiceProvider
 from .service_provider_abc import ServiceProviderABC
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_core/dependency_injection/scope.py

@@ -0,0 +1,18 @@
+
+from cpl_core.console.console import Console
+from cpl_core.dependency_injection.scope_abc import ScopeABC
+from cpl_core.dependency_injection.service_provider_abc import ServiceProviderABC
+
+
+class Scope(ScopeABC):
+
+    def __init__(self, service_provider: ServiceProviderABC):
+        self._service_provider = service_provider
+        self._service_provider.set_scope(self)
+
+    @property
+    def service_provider(self) -> ServiceProviderABC:
+        return self._service_provider
+    
+    def dispose(self):
+        self._service_provider = None

src/cpl_core/dependency_injection/scope_abc.py

@@ -0,0 +1,24 @@
+from abc import ABC, abstractmethod
+
+class ScopeABC(ABC):
+    r"""ABC for the class :class:`cpl_core.dependency_injection.scope.Scope`"""
+    
+    def __init__(self):
+        pass
+    
+    @property
+    @abstractmethod
+    def service_provider(self):
+        r"""Returns to service provider of scope
+
+        Returns
+        -------
+            Object of type :class:`cpl_core.dependency_injection.service_provider_abc.ServiceProviderABC`
+        """
+        pass
+    
+    @abstractmethod
+    def dispose():
+        r"""Sets service_provider to None
+        """
+        pass

src/cpl_core/dependency_injection/scope_builder.py

@@ -0,0 +1,19 @@
+from cpl_core.dependency_injection.scope import Scope
+from cpl_core.dependency_injection.scope_abc import ScopeABC
+from cpl_core.dependency_injection.service_provider_abc import ServiceProviderABC
+
+
+class ScopeBuilder:
+    r"""Class to build :class:`cpl_core.dependency_injection.scope.Scope`"""
+    
+    def __init__(self, service_provider: ServiceProviderABC) -> None:
+        self._service_provider = service_provider
+    
+    def build(self) -> ScopeABC:
+        r"""Returns scope
+
+        Returns
+        -------
+            Object of type :class:`cpl_core.dependency_injection.scope.Scope`
+        """
+        return Scope(self._service_provider)

src/cpl_core/dependency_injection/service_collection.py

@@ -40,7 +40,7 @@ class ServiceCollection(ServiceCollectionABC):
 
     def add_db_context(self, db_context_type: Type[DatabaseContextABC], db_settings: DatabaseSettings):
         self._database_context = db_context_type(db_settings)
-        self._database_context.connect(CredentialManager.build_string(db_settings.connection_string, db_settings.credentials))
+        self._database_context.connect(db_settings)
 
     def add_logging(self):
         self.add_singleton(LoggerABC, Logger)
@@ -59,9 +59,13 @@ class ServiceCollection(ServiceCollectionABC):
             self._add_descriptor(impl, ServiceLifetimeEnum.singleton)
 
     def add_scoped(self, service_type: Type, service: Callable = None):
-        raise Exception('Not implemented')
+        if service is not None:
+            self._add_descriptor(service, ServiceLifetimeEnum.scoped)
+        else:
+            self._add_descriptor(service_type, ServiceLifetimeEnum.scoped)
+        
 
-    def add_transient(self, service_type: Union[type], service: Union[type] = None):
+    def add_transient(self, service_type: type, service: type = None):
         if service is not None:
             self._add_descriptor(service, ServiceLifetimeEnum.transient)
         else:

src/cpl_core/dependency_injection/service_collection_abc.py

@@ -15,15 +15,13 @@ class ServiceCollectionABC(ABC):
         pass
 
     @abstractmethod
-    def add_db_context(self, db_context: Type[DatabaseContextABC], db_settings: DatabaseSettings):
+    def add_db_context(self, db_context: Type[DatabaseContextABC]):
         r"""Adds database context
 
         Parameter
         ---------
             db_context: Type[:class:`cpl_core.database.context.database_context_abc.DatabaseContextABC`]
                 Database context
-            db_settings: :class:`cpl_core.database.database_settings.DatabaseSettings`
-                Database settings
         """
         pass
 

src/cpl_core/dependency_injection/service_lifetime_enum.py

@@ -4,5 +4,5 @@ from enum import Enum
 class ServiceLifetimeEnum(Enum):
 
     singleton = 0
-    scoped = 1  # not supported yet
+    scoped = 1
     transient = 2

src/cpl_core/dependency_injection/service_provider.py

@@ -1,10 +1,13 @@
 from collections import Callable
+import copy
 from inspect import signature, Parameter
 from typing import Optional
 
 from cpl_core.configuration.configuration_abc import ConfigurationABC
 from cpl_core.configuration.configuration_model_abc import ConfigurationModelABC
 from cpl_core.database.context.database_context_abc import DatabaseContextABC
+from cpl_core.dependency_injection.scope_abc import ScopeABC
+from cpl_core.dependency_injection.scope_builder import ScopeBuilder
 from cpl_core.dependency_injection.service_provider_abc import ServiceProviderABC
 from cpl_core.dependency_injection.service_descriptor import ServiceDescriptor
 from cpl_core.dependency_injection.service_lifetime_enum import ServiceLifetimeEnum
@@ -30,8 +33,9 @@ class ServiceProvider(ServiceProviderABC):
         self._service_descriptors: list[ServiceDescriptor] = service_descriptors
         self._configuration: ConfigurationABC = config
         self._database_context = db_context
+        self._scope: Optional[ScopeABC] = None
 
-    def _find_service(self, service_type: type) -> [ServiceDescriptor]:
+    def _find_service(self, service_type: type) -> ServiceDescriptor:
         for descriptor in self._service_descriptors:
             if descriptor.service_type == service_type or issubclass(descriptor.service_type, service_type):
                 return descriptor
@@ -84,6 +88,13 @@ class ServiceProvider(ServiceProviderABC):
                     params.append(self._get_service(parameter))
 
         return service_type(*params)
+    
+    def set_scope(self, scope: ScopeABC):
+        self._scope = scope
+    
+    def create_scope(self) -> ScopeABC:
+        sb = ScopeBuilder(ServiceProvider(copy.deepcopy(self._service_descriptors), self._configuration, self._database_context))
+        return sb.build()
 
     def get_service(self, service_type: type) -> Optional[Callable[object]]:
         result = self._find_service(service_type)
@@ -95,7 +106,7 @@ class ServiceProvider(ServiceProviderABC):
             return result.implementation
 
         implementation = self.build_service(service_type)
-        if result.lifetime == ServiceLifetimeEnum.singleton:
+        if result.lifetime == ServiceLifetimeEnum.singleton or result.lifetime == ServiceLifetimeEnum.scoped and self._scope is not None:
             result.implementation = implementation
 
         return implementation

src/cpl_core/dependency_injection/service_provider_abc.py

@@ -2,6 +2,8 @@ from abc import abstractmethod, ABC
 from collections import Callable
 from typing import Type, Optional
 
+from cpl_core.dependency_injection.scope_abc import ScopeABC
+
 
 class ServiceProviderABC(ABC):
     r"""ABC for the class :class:`cpl_core.dependency_injection.service_provider.ServiceProvider`"""
@@ -24,6 +26,27 @@ class ServiceProviderABC(ABC):
             Object of the given type
         """
         pass
+    
+    @abstractmethod
+    def set_scope(self, scope: ScopeABC):
+        r"""Sets the scope of service provider
+
+        Parameter
+        ---------
+            scope :class:`cpl_core.dependency_injection.scope.Scope`
+                Service scope
+        """
+        pass
+    
+    @abstractmethod
+    def create_scope(self) -> ScopeABC:
+        r"""Creates a service scope
+
+        Returns
+        -------
+            Object of type :class:`cpl_core.dependency_injection.scope.Scope`
+        """
+        pass
 
     @abstractmethod
     def get_service(self, instance_type: Type) -> Optional[Callable[object]]:

src/cpl_core/environment/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_core.environment'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -25,4 +25,4 @@ from .environment_name_enum import EnvironmentNameEnum
 from .application_environment import ApplicationEnvironment
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_core/logging/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_core.logging'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -27,4 +27,4 @@ from .logging_settings import LoggingSettings
 from .logging_settings_name_enum import LoggingSettingsNameEnum
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_core/mailing/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_core.mailing'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -27,4 +27,4 @@ from .email_client_settings import EMailClientSettings
 from .email_client_settings_name_enum import EMailClientSettingsNameEnum
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_core/time/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_core.time'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -24,4 +24,4 @@ from .time_format_settings import TimeFormatSettings
 from .time_format_settings_names_enum import TimeFormatSettingsNamesEnum
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_core/utils/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_core.utils'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -25,4 +25,4 @@ from .string import String
 from .pip import Pip
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_query/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_query'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports: 
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_query/_query/__init__.py

@@ -15,11 +15,11 @@ __title__ = 'cpl_query._query'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
 # imports:
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_query/_query/order_by.py

@@ -6,7 +6,7 @@ from cpl_query.extension.ordered_iterable_abc import OrderedIterableABC
 
 
 def order_by_query(_list: IterableABC, _func: Callable) -> OrderedIterableABC:
-    result = OrderedIterableABC(_func)
+    result = OrderedIterableABC(_list.type, _func)
     _list.sort(key=_func)
     result.extend(_list)
     return result
@@ -19,7 +19,7 @@ def order_by_descending_query(_list: IterableABC, _func: Callable) -> OrderedIte
     if _func is None:
         raise ArgumentNoneException(ExceptionArgument.func)
 
-    result = OrderedIterableABC(_func)
+    result = OrderedIterableABC(_list.type, _func)
     _list.sort(key=_func, reverse=True)
     result.extend(_list)
     return result

src/cpl_query/cpl_query.json

@@ -3,8 +3,8 @@
     "Name": "sh_cpl-query",
     "Version": {
       "Major": "2021",
-      "Minor": "10",
-      "Micro": "0.post1"
+      "Minor": "11",
+      "Micro": "0"
     },
     "Author": "Sven Heidemann",
     "AuthorEmail": "sven.heidemann@sh-edraft.de",
@@ -16,9 +16,9 @@
     "LicenseName": "MIT",
     "LicenseDescription": "MIT, see LICENSE for more details.",
     "Dependencies": [
-      "sh_cpl-core>=2021.10.0"
+      "sh_cpl-core>=2021.11.0"
     ],
-    "PythonVersion": ">=3.9.2",
+    "PythonVersion": ">=3.8",
     "PythonPath": {},
     "Classifiers": []
   },

src/cpl_query/extension/__init__.py

@@ -15,7 +15,7 @@ __title__ = 'cpl_query.extension'
 __author__ = 'Sven Heidemann'
 __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2020 - 2021 sh-edraft.de'
-__version__ = '2021.10.0.post1'
+__version__ = '2021.11.0'
 
 from collections import namedtuple
 
@@ -27,4 +27,4 @@ from .ordered_iterable_abc import OrderedIterableABC
 from .ordered_iterable import OrderedIterable
 
 VersionInfo = namedtuple('VersionInfo', 'major minor micro')
-version_info = VersionInfo(major='2021', minor='10', micro='0.post1')
+version_info = VersionInfo(major='2021', minor='11', micro='0')

src/cpl_query/extension/iterable.py

@@ -75,13 +75,13 @@ class Iterable(IterableABC):
 
     def order_by(self, func: Callable) -> OrderedIterableABC:
         res = order_by_query(self, func)
-        from cpl_query._extension.ordered_iterable import OrderedIterable
+        from cpl_query.extension.ordered_iterable import OrderedIterable
         res.__class__ = OrderedIterable
         return res
 
     def order_by_descending(self, func: Callable) -> OrderedIterableABC:
         res = order_by_descending_query(self, func)
-        from cpl_query._extension.ordered_iterable import OrderedIterable
+        from cpl_query.extension.ordered_iterable import OrderedIterable
         res.__class__ = OrderedIterable
         return res
 

src/cpl_query/extension/iterable_abc.py

@@ -3,6 +3,8 @@ from typing import Optional, Callable, Union, Iterable
 
 
 class IterableABC(ABC, list):
+    r"""ABC to define functions on list
+    """
 
     @abstractmethod
     def __init__(self, t: type = None, values: list = None):
@@ -21,12 +23,43 @@ class IterableABC(ABC, list):
         return self._type
 
     @abstractmethod
-    def any(self, func: Callable) -> bool: pass
+    def all(self, func: Callable) -> bool:
+        r"""Checks if every element of list equals result found by function
+
+        Parameter
+        ---------
+            func: :class:`Callable`
+                selected value
+
+        Returns
+        -------
+            bool
+        """
+        pass
 
     @abstractmethod
-    def all(self, func: Callable) -> bool: pass
+    def any(self, func: Callable) -> bool:
+        r"""Checks if list contains result found by function
+
+        Parameter
+        ---------
+            func: :class:`Callable`
+                selected value
+
+        Returns
+        -------
+            bool
+        """
+        pass
 
     def append(self, __object: object) -> None:
+        r"""Adds element to list
+
+        Parameter
+        ---------
+            __object: :class:`object`
+                value
+        """
         if self._type is not None and type(__object) != self._type and not isinstance(type(__object), self._type) \
                 and not issubclass(type(__object), self._type):
             raise Exception(f'Unexpected type: {type(__object)}')
@@ -37,80 +70,347 @@ class IterableABC(ABC, list):
         super().append(__object)
 
     @abstractmethod
-    def average(self, func: Callable = None) -> Union[int, float, complex]: pass
+    def average(self, func: Callable = None) -> Union[int, float, complex]:
+        r"""Returns average value of list
+
+        Parameter
+        ---------
+            func: :class:`Callable`
+                selected value
+
+        Returns
+        -------
+            Union[int, float, complex]
+        """
+        pass
 
     @abstractmethod
-    def contains(self, value: object) -> bool: pass
+    def contains(self, value: object) -> bool:
+        r"""Checks if list contains value given by function
+
+        Parameter
+        ---------
+            value: :class:`object`
+                value
+
+        Returns
+        -------
+            bool
+        """
+        pass
 
     @abstractmethod
-    def count(self, func: Callable) -> int: pass
+    def count(self, func: Callable) -> int:
+        r"""Returns length of list or count of found elements
+
+        Parameter
+        ---------
+            func: :class:`Callable`
+                selected value
+
+        Returns
+        -------
+            int
+        """
+        pass
 
     @abstractmethod
-    def distinct(self, func: Callable) -> 'IterableABC': pass
+    def distinct(self, func: Callable) -> 'IterableABC':
+        r"""Returns list without redundancies
+
+        Parameter
+        ---------
+            func: :class:`Callable`
+                selected value
+
+        Returns
+        -------
+            :class: `cpl_query.extension.iterable_abc.IterableABC`
+        """
+        pass
 
     @abstractmethod
-    def element_at(self, index: int) -> any: pass
+    def element_at(self, index: int) -> any:
+        r"""Returns element at given index
+
+        Parameter
+        ---------
+            index: :class:`int`
+                index
+
+        Returns
+        -------
+            Value at index: any
+        """
+        pass
 
     @abstractmethod
-    def element_at_or_default(self, index: int) -> Optional[any]: pass
+    def element_at_or_default(self, index: int) -> Optional[any]:
+        r"""Returns element at given index or None
+
+        Parameter
+        ---------
+            index: :class:`int`
+                index
+
+        Returns
+        -------
+            Value at index: Optional[any]
+        """
+        pass
 
     def extend(self, __iterable: Iterable) -> None:
+        r"""Adds elements of given list to list
+
+        Parameter
+        ---------
+            __iterable: :class: `cpl_query.extension.iterable.Iterable`
+                index
+        """
         for value in __iterable:
             self.append(value)
 
     @abstractmethod
-    def last(self) -> any: pass
+    def last(self) -> any:
+        r"""Returns last element
+
+        Returns
+        -------
+            Last element of list: any
+        """
+        pass
 
     @abstractmethod
-    def last_or_default(self) -> any: pass
+    def last_or_default(self) -> any:
+        r"""Returns last element or None
+
+        Returns
+        -------
+            Last element of list: Optional[any]
+        """
+        pass
 
     @abstractmethod
-    def first(self) -> any: pass
+    def first(self) -> any:
+        r"""Returns first element
+
+        Returns
+        -------
+            First element of list: any
+        """
+        pass
 
     @abstractmethod
-    def first_or_default(self) -> any: pass
+    def first_or_default(self) -> any:
+        r"""Returns first element or None
+
+        Returns
+        -------
+            First element of list: Optional[any]
+        """
+        pass
 
     @abstractmethod
-    def for_each(self, func: Callable) -> Union[int, float, complex]: pass
+    def for_each(self, func: Callable):
+        r"""Runs given function for each element of list
+
+        Parameter
+        ---------
+            func: :class: `Callable`
+                function to call
+        """
+        pass
 
     @abstractmethod
-    def max(self, func: Callable = None) -> Union[int, float, complex]: pass
+    def max(self, func: Callable = None) -> Union[int, float, complex]:
+        r"""Returns highest value
+
+        Parameter
+        ---------
+            func: :class:`Callable`
+                selected value
+
+        Returns
+        -------
+            Union[int, float, complex]
+        """
+        pass
 
     @abstractmethod
-    def min(self, func: Callable = None) -> Union[int, float, complex]: pass
+    def min(self, func: Callable = None) -> Union[int, float, complex]:
+        r"""Returns highest value
+
+        Parameter
+        ---------
+            func: :class:`Callable`
+                selected value
+
+        Returns
+        -------
+            Union[int, float, complex]
+        """
+        pass
 
     @abstractmethod
-    def order_by(self, func: Callable) -> 'IterableABC': pass
+    def order_by(self, func: Callable) -> 'IterableABC':
+        r"""Sorts elements by function in ascending order
+
+        Parameter
+        ---------
+            func: :class:`Callable`
+                selected value
+
+        Returns
+        -------
+            :class: `cpl_query.extension.iterable_abc.IterableABC`
+        """
+        pass
 
     @abstractmethod
-    def order_by_descending(self, func: Callable) -> 'IterableABC': pass
+    def order_by_descending(self, func: Callable) -> 'IterableABC':
+        r"""Sorts elements by function in descending order
+
+        Parameter
+        ---------
+            func: :class:`Callable`
+                selected value
+
+        Returns
+        -------
+            :class: `cpl_query.extension.iterable_abc.IterableABC`
+        """
+        pass
 
     @abstractmethod
-    def reverse(self) -> 'IterableABC': pass
+    def reverse(self) -> 'IterableABC':
+        r"""Reverses list
+
+        Returns
+        -------
+            :class: `cpl_query.extension.iterable_abc.IterableABC`
+        """
+        pass
 
     @abstractmethod
-    def single(self) -> any: pass
+    def single(self) -> any:
+        r"""Returns one single element of list
+
+        Returns
+        -------
+            Found value: any
+
+        Raises
+        ------
+            ArgumentNoneException: when argument is None
+            Exception: when argument is None or found more than one element
+        """
+        pass
 
     @abstractmethod
-    def single_or_default(self) -> Optional[any]: pass
+    def single_or_default(self) -> Optional[any]:
+        r"""Returns one single element of list
+
+        Returns
+        -------
+            Found value: Optional[any]
+        """
+        pass
 
     @abstractmethod
-    def skip(self, index: int) -> 'IterableABC': pass
+    def skip(self, index: int) -> 'IterableABC':
+        r"""Skips all elements from index
+
+        Parameter
+        ---------
+            index: :class:`int`
+                index
+
+        Returns
+        -------
+            :class: `cpl_query.extension.iterable_abc.IterableABC`
+        """
+        pass
 
     @abstractmethod
-    def skip_last(self, index: int) -> 'IterableABC': pass
+    def skip_last(self, index: int) -> 'IterableABC':
+        r"""Skips all elements after index
+
+        Parameter
+        ---------
+            index: :class:`int`
+                index
+
+        Returns
+        -------
+            :class: `cpl_query.extension.iterable_abc.IterableABC`
+        """
+        pass
 
     @abstractmethod
-    def sum(self, func: Callable = None) -> Union[int, float, complex]: pass
+    def sum(self, func: Callable = None) -> Union[int, float, complex]:
+        r"""Sum of all values
+
+        Parameter
+        ---------
+            func: :class:`Callable`
+                selected value
+
+        Returns
+        -------
+            Union[int, float, complex]
+        """
+        pass
 
     @abstractmethod
-    def take(self, index: int) -> 'IterableABC': pass
+    def take(self, index: int) -> 'IterableABC':
+        r"""Takes all elements from index
+
+        Parameter
+        ---------
+            index: :class:`int`
+                index
+
+        Returns
+        -------
+            :class: `cpl_query.extension.iterable_abc.IterableABC`
+        """
+        pass
 
     @abstractmethod
-    def take_last(self, index: int) -> 'IterableABC': pass
+    def take_last(self, index: int) -> 'IterableABC':
+        r"""Takes all elements after index
+
+        Parameter
+        ---------
+            index: :class:`int`
+                index
+
+        Returns
+        -------
+            :class: `cpl_query.extension.iterable_abc.IterableABC`
+        """
+        pass
 
     def to_list(self) -> list:
+        r"""Converts :class: `cpl_query.extension.iterable_abc.IterableABC` to :class: `list`
+
+        Returns
+        -------
+            :class: `list`
+        """
         return list(self)
 
     @abstractmethod
-    def where(self, func: Callable) -> 'IterableABC': pass
+    def where(self, func: Callable) -> 'IterableABC':
+        r"""Select element by function
+
+        Parameter
+        ---------
+            func: :class:`Callable`
+                selected value
+
+        Returns
+        -------
+            :class: `cpl_query.extension.iterable_abc.IterableABC`
+        """
+        pass

src/cpl_query/extension/ordered_iterable.py

@@ -9,9 +9,9 @@ class OrderedIterable(Iterable, OrderedIterableABC):
     r"""Implementation of :class: `cpl_query.extension.Iterable` `cpl_query.extension.OrderedIterableABC`
     """
 
-    def __init__(self):
-        Iterable.__init__(self)
-        OrderedIterableABC.__init__(self)
+    def __init__(self, _t: type = None):
+        Iterable.__init__(self, _t)
+        OrderedIterableABC.__init__(self, _t)
 
     def then_by(self, _func: Callable) -> OrderedIterableABC:
         self._funcs.append(_func)

src/cpl_query/extension/ordered_iterable_abc.py

@@ -7,8 +7,8 @@ from cpl_query.extension.iterable_abc import IterableABC
 class OrderedIterableABC(IterableABC):
 
     @abstractmethod
-    def __init__(self, _func: Callable = None):
-        IterableABC.__init__(self)
+    def __init__(self, _t: type, _func: Callable = None):
+        IterableABC.__init__(self, _t)
         self._funcs: list[Callable] = []
         if _func is not None:
             self._funcs.append(_func)