bisos.capability 0.1__tar.gz

bisos_capability-0.1/PKG-INFO

@@ -0,0 +1,175 @@
+Metadata-Version: 2.2
+Name: bisos.capability
+Version: 0.1
+Summary: bisos.capability:  BISOS Capabilities Bundles -- Abstraction, Specification and Materialization
+Home-page: http://www.by-star.net/PLPC/180047
+Download-URL: http://www.by-star.net/PLPC/180047
+Author: Mohsen Banan
+Author-email: libre@mohsen.1.banan.byname.net
+Maintainer: Mohsen Banan
+Maintainer-email: libre@mohsen.1.banan.byname.net
+License: AGPL
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: blee
+Requires-Dist: blee.icmPlayer
+Requires-Dist: bisos
+Requires-Dist: bisos.b
+Requires-Dist: bisos.basics
+Requires-Dist: bisos.bpo
+Requires-Dist: bisos.common
+Requires-Dist: bisos.platform
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: download-url
+Dynamic: home-page
+Dynamic: license
+Dynamic: maintainer
+Dynamic: maintainer-email
+Dynamic: requires-dist
+Dynamic: summary
+
+=============================================================================================
+bisos.capability: BISOS Capabilities Bundles – Abstraction, Specification and Materialization
+=============================================================================================
+
+.. contents::
+   :depth: 3
+..
+
+Overview
+========
+
+bisos.capability is a python package for BISOS Capabilities Bundles –
+Abstraction, Specification and Materialization.
+
+Package Documentation At Github
+===============================
+
+The information below is a subset of the full of documentation for this
+bisos-pip package. More complete documentation is available at:
+https://github.com/bisos-pip/capability-cs
+
+Realted Resources
+=================
+
++--------------------------+------------------------------------------+
+| bisos Capabilities Panel | file:/panels/capab                       |
+|                          | ilities/_nodeBase_/fullUsagePanel-en.org |
++--------------------------+------------------------------------------+
+|                          |                                          |
++--------------------------+------------------------------------------+
+
+.. _table-of-contents:
+
+Table of Contents TOC
+=====================
+
+-  `Overview <#overview>`__
+-  `Package Documentation At
+   Github <#package-documentation-at-github>`__
+-  `Realted Resources <#realted-resources>`__
+-  `Installation <#installation>`__
+
+   -  `Installation With pip <#installation-with-pip>`__
+   -  `Installation With pipx <#installation-with-pipx>`__
+
+-  `Part of BISOS and ByStar — ByStar Internet Services Operating
+   System <#part-of-bisos-and-bystar-----bystar-internet-services-operating-system>`__
+-  `bisos.capability as a Standalone Piece of
+   BISOS <#bisoscapability-as-a-standalone-piece-of-bisos>`__
+-  `Documentation and Blee-Panels <#documentation-and-blee-panels>`__
+
+   -  `bisos.capability Blee-Panels <#bisoscapability-blee-panels>`__
+
+-  `Support <#support>`__
+
+Installation
+============
+
+The sources for the bisos.capability pip package is maintained at:
+https://github.com/bisos-pip/capability.
+
+The bisos.capability pip package is available at PYPI as
+https://pypi.org/project/bisos.capability
+
+You can install bisos.capability with pip or pipx.
+
+Installation With pip
+---------------------
+
+If you need access to bisos.capability as a python module, you can
+install it with pip:
+
+.. code:: bash
+
+   pip install bisos.capability
+
+Installation With pipx
+----------------------
+
+If you only need access to bisos.capability as a command on
+command-line, you can install it with pipx:
+
+.. code:: bash
+
+   pipx install bisos.capability
+
+The following commands are made available:
+
+-  seedCapability.cs
+-  exmpl-capability.cs
+
+Part of BISOS and ByStar — ByStar Internet Services Operating System
+====================================================================
+
+| Layered on top of Debian, **BISOS**: (By\* Internet Services Operating
+  System) is a unified and universal framework for developing both
+  internet services and software-service continuums that use internet
+  services. See `Bootstrapping ByStar, BISOS and
+  Blee <https://github.com/bxGenesis/start>`__ for information about
+  getting started with BISOS.
+| **BISOS** is a foundation for **The Libre-Halaal ByStar Digital
+  Ecosystem** which is described as a cure for losses of autonomy and
+  privacy in a book titled: `Nature of
+  Polyexistentials <https://github.com/bxplpc/120033>`__
+
+*bisos.capability* is part of BISOS.
+
+bisos.capability as a Standalone Piece of BISOS
+===============================================
+
+bisos.capability is a standalone piece of BISOS. It can be used as a
+self-contained Python package separate from BISOS. Follow the
+installation and usage instructions below for your own use.
+
+Documentation and Blee-Panels
+=============================
+
+bisos.capability is part of ByStar Digital Ecosystem
+http://www.by-star.net.
+
+This module's primary documentation is in the form of Blee-Panels.
+Additional information is also available in:
+http://www.by-star.net/PLPC/180047
+
+bisos.capability Blee-Panels
+----------------------------
+
+bisos.capability Blee-Panels are in ./panels directory. From within Blee
+and BISOS these panels are accessible under the Blee "Panels" menu.
+
+Support
+=======
+
+| For support, criticism, comments and questions; please contact the
+  author/maintainer
+| `Mohsen Banan <http://mohsen.1.banan.byname.net>`__ at:
+  http://mohsen.1.banan.byname.net/contact

bisos_capability-0.1/README.rst

@@ -0,0 +1,137 @@
+=============================================================================================
+bisos.capability: BISOS Capabilities Bundles – Abstraction, Specification and Materialization
+=============================================================================================
+
+.. contents::
+   :depth: 3
+..
+
+Overview
+========
+
+bisos.capability is a python package for BISOS Capabilities Bundles –
+Abstraction, Specification and Materialization.
+
+Package Documentation At Github
+===============================
+
+The information below is a subset of the full of documentation for this
+bisos-pip package. More complete documentation is available at:
+https://github.com/bisos-pip/capability-cs
+
+Realted Resources
+=================
+
++--------------------------+------------------------------------------+
+| bisos Capabilities Panel | file:/panels/capab                       |
+|                          | ilities/_nodeBase_/fullUsagePanel-en.org |
++--------------------------+------------------------------------------+
+|                          |                                          |
++--------------------------+------------------------------------------+
+
+.. _table-of-contents:
+
+Table of Contents TOC
+=====================
+
+-  `Overview <#overview>`__
+-  `Package Documentation At
+   Github <#package-documentation-at-github>`__
+-  `Realted Resources <#realted-resources>`__
+-  `Installation <#installation>`__
+
+   -  `Installation With pip <#installation-with-pip>`__
+   -  `Installation With pipx <#installation-with-pipx>`__
+
+-  `Part of BISOS and ByStar — ByStar Internet Services Operating
+   System <#part-of-bisos-and-bystar-----bystar-internet-services-operating-system>`__
+-  `bisos.capability as a Standalone Piece of
+   BISOS <#bisoscapability-as-a-standalone-piece-of-bisos>`__
+-  `Documentation and Blee-Panels <#documentation-and-blee-panels>`__
+
+   -  `bisos.capability Blee-Panels <#bisoscapability-blee-panels>`__
+
+-  `Support <#support>`__
+
+Installation
+============
+
+The sources for the bisos.capability pip package is maintained at:
+https://github.com/bisos-pip/capability.
+
+The bisos.capability pip package is available at PYPI as
+https://pypi.org/project/bisos.capability
+
+You can install bisos.capability with pip or pipx.
+
+Installation With pip
+---------------------
+
+If you need access to bisos.capability as a python module, you can
+install it with pip:
+
+.. code:: bash
+
+   pip install bisos.capability
+
+Installation With pipx
+----------------------
+
+If you only need access to bisos.capability as a command on
+command-line, you can install it with pipx:
+
+.. code:: bash
+
+   pipx install bisos.capability
+
+The following commands are made available:
+
+-  seedCapability.cs
+-  exmpl-capability.cs
+
+Part of BISOS and ByStar — ByStar Internet Services Operating System
+====================================================================
+
+| Layered on top of Debian, **BISOS**: (By\* Internet Services Operating
+  System) is a unified and universal framework for developing both
+  internet services and software-service continuums that use internet
+  services. See `Bootstrapping ByStar, BISOS and
+  Blee <https://github.com/bxGenesis/start>`__ for information about
+  getting started with BISOS.
+| **BISOS** is a foundation for **The Libre-Halaal ByStar Digital
+  Ecosystem** which is described as a cure for losses of autonomy and
+  privacy in a book titled: `Nature of
+  Polyexistentials <https://github.com/bxplpc/120033>`__
+
+*bisos.capability* is part of BISOS.
+
+bisos.capability as a Standalone Piece of BISOS
+===============================================
+
+bisos.capability is a standalone piece of BISOS. It can be used as a
+self-contained Python package separate from BISOS. Follow the
+installation and usage instructions below for your own use.
+
+Documentation and Blee-Panels
+=============================
+
+bisos.capability is part of ByStar Digital Ecosystem
+http://www.by-star.net.
+
+This module's primary documentation is in the form of Blee-Panels.
+Additional information is also available in:
+http://www.by-star.net/PLPC/180047
+
+bisos.capability Blee-Panels
+----------------------------
+
+bisos.capability Blee-Panels are in ./panels directory. From within Blee
+and BISOS these panels are accessible under the Blee "Panels" menu.
+
+Support
+=======
+
+| For support, criticism, comments and questions; please contact the
+  author/maintainer
+| `Mohsen Banan <http://mohsen.1.banan.byname.net>`__ at:
+  http://mohsen.1.banan.byname.net/contact

bisos_capability-0.1/_description.org

@@ -0,0 +1,110 @@
+#+title: bisos.capability:  BISOS Capabilities Bundles -- Abstraction, Specification and Materialization
+
+
+
+
+* Overview
+
+bisos.capability is a python package for BISOS Capabilities Bundles -- Abstraction, Specification and
+Materialization.
+
+
+
+* Package Documentation At Github
+
+The information below is a subset of the full of documentation for this bisos-pip package.
+More complete documentation is available at: https://github.com/bisos-pip/capability-cs
+
+
+* Realted Resources
+
+| bisos Capabilities Panel | file:/panels/capabilities/_nodeBase_/fullUsagePanel-en.org |
+|                          |                                                                |
+
+
+* Table of Contents     :TOC:
+- [[#overview][Overview]]
+- [[#package-documentation-at-github][Package Documentation At Github]]
+- [[#realted-resources][Realted Resources]]
+- [[#installation][Installation]]
+  - [[#installation-with-pip][Installation With pip]]
+  - [[#installation-with-pipx][Installation With pipx]]
+- [[#part-of-bisos-and-bystar-----bystar-internet-services-operating-system][Part of BISOS and ByStar --- ByStar Internet Services Operating System]]
+- [[#bisoscapability-as-a-standalone-piece-of-bisos][bisos.capability as a Standalone Piece of BISOS]]
+- [[#documentation-and-blee-panels][Documentation and Blee-Panels]]
+  - [[#bisoscapability-blee-panels][bisos.capability Blee-Panels]]
+- [[#support][Support]]
+
+* Installation
+
+The sources for the  bisos.capability pip package is maintained at:
+https://github.com/bisos-pip/capability.
+
+The bisos.capability pip package is available at PYPI as
+https://pypi.org/project/bisos.capability
+
+You can install bisos.capability with pip or pipx.
+
+** Installation With pip
+
+If you need access to bisos.capability as a python module, you can install it with pip:
+
+#+begin_src bash
+pip install bisos.capability
+#+end_src
+
+** Installation With pipx
+
+If you only need access to bisos.capability as a command on command-line, you can install it with pipx:
+
+#+begin_src bash
+pipx install bisos.capability
+#+end_src
+
+The following commands are made available:
+- seedCapability.cs
+- exmpl-capability.cs
+
+* Part of BISOS and ByStar --- ByStar Internet Services Operating System
+
+Layered on top of Debian, *BISOS*: (By* Internet Services Operating System) is a
+unified and universal framework for developing both internet services and
+software-service continuums that use internet services. See [[https://github.com/bxGenesis/start][Bootstrapping
+ByStar, BISOS and Blee]] for information about getting started with BISOS.\\
+*BISOS* is a foundation for *The Libre-Halaal ByStar Digital Ecosystem* which is
+described as a cure for losses of autonomy and privacy in a book titled: [[https://github.com/bxplpc/120033][Nature
+of Polyexistentials]]
+
+/bisos.capability/ is part of BISOS.
+
+* bisos.capability as a Standalone Piece of BISOS
+
+bisos.capability is a standalone piece of BISOS. It can be used as a self-contained
+Python package separate from BISOS. Follow the installation and usage
+instructions below for your own use.
+
+
+* Documentation and Blee-Panels
+
+bisos.capability is part of ByStar Digital Ecosystem [[http://www.by-star.net]].
+
+This module's primary documentation is in the form of Blee-Panels.
+Additional information is also available in: [[http://www.by-star.net/PLPC/180047]]
+
+** bisos.capability Blee-Panels
+
+bisos.capability Blee-Panels are in ./panels directory.
+From within Blee and BISOS these panels are accessible under the
+Blee "Panels" menu.
+
+* Support
+
+For support, criticism, comments and questions; please contact the
+author/maintainer\\
+[[http://mohsen.1.banan.byname.net][Mohsen Banan]] at:
+[[http://mohsen.1.banan.byname.net/contact]]
+
+
+
+
+

bisos_capability-0.1/bin/capMaterializationDispatch.cs

@@ -0,0 +1,218 @@
+#!/bin/env python
+# -*- coding: utf-8 -*-
+
+""" #+begin_org
+* ~[Summary]~ :: A =CmndSvc= for
+#+end_org """
+
+####+BEGIN: b:py3:cs:file/dblockControls :classification "cs-u"
+""" #+begin_org
+* [[elisp:(org-cycle)][| /Control Parameters Of This File/ |]] :: dblk ctrls classifications=cs-u
+#+BEGIN_SRC emacs-lisp
+(setq-local b:dblockControls t) ; (setq-local b:dblockControls nil)
+(put 'b:dblockControls 'py3:cs:Classification "cs-u") ; one of cs-mu, cs-u, cs-lib, bpf-lib, pyLibPure
+#+END_SRC
+#+RESULTS:
+: cs-u
+#+end_org """
+####+END:
+
+####+BEGIN: b:prog:file/proclamations :outLevel 1
+""" #+begin_org
+* *[[elisp:(org-cycle)][| Proclamations |]]* :: Libre-Halaal Software --- Part Of BISOS ---  Poly-COMEEGA Format.
+** This is Libre-Halaal Software. © Neda Communications, Inc. Subject to AGPL.
+** It is part of BISOS (ByStar Internet Services OS)
+** Best read and edited  with Blee in Poly-COMEEGA (Polymode Colaborative Org-Mode Enhance Emacs Generalized Authorship)
+#+end_org """
+####+END:
+
+####+BEGIN: b:prog:file/particulars :authors ("./inserts/authors-mb.org")
+""" #+begin_org
+* *[[elisp:(org-cycle)][| Particulars |]]* :: Authors, version
+** This File: /bisos/git/bxRepos/bisos-pip/binsprep/py3/bin/seedBinsPrep.cs
+** Authors: Mohsen BANAN, http://mohsen.banan.1.byname.net/contact
+#+end_org """
+####+END:
+
+####+BEGIN: b:py3:file/particulars-csInfo :status "inUse"
+""" #+begin_org
+* *[[elisp:(org-cycle)][| Particulars-csInfo |]]*
+#+end_org """
+import typing
+csInfo: typing.Dict[str, typing.Any] = { 'moduleName': ['seedBinsPrep'], }
+csInfo['version'] = '202409222227'
+csInfo['status']  = 'inUse'
+csInfo['panel'] = 'seedBinsPrep-Panel.org'
+csInfo['groupingType'] = 'IcmGroupingType-pkged'
+csInfo['cmndParts'] = 'IcmCmndParts[common] IcmCmndParts[param]'
+####+END:
+
+""" #+begin_org
+* [[elisp:(org-cycle)][| ~Description~ |]] :: [[file:/bisos/git/auth/bxRepos/blee-binders/bisos-core/COMEEGA/_nodeBase_/fullUsagePanel-en.org][BISOS COMEEGA Panel]]
+Module description comes here.
+** Relevant Panels:
+** Status: In use with BISOS
+** /[[elisp:(org-cycle)][| Planned Improvements |]]/ :
+*** TODO complete fileName in particulars.
+#+end_org """
+
+####+BEGIN: b:prog:file/orgTopControls :outLevel 1
+""" #+begin_org
+* [[elisp:(org-cycle)][| Controls |]] :: [[elisp:(delete-other-windows)][(1)]] | [[elisp:(show-all)][Show-All]]  [[elisp:(org-shifttab)][Overview]]  [[elisp:(progn (org-shifttab) (org-content))][Content]] | [[file:Panel.org][Panel]] | [[elisp:(blee:ppmm:org-mode-toggle)][Nat]] | [[elisp:(bx:org:run-me)][Run]] | [[elisp:(bx:org:run-me-eml)][RunEml]] | [[elisp:(progn (save-buffer) (kill-buffer))][S&Q]]  [[elisp:(save-buffer)][Save]]  [[elisp:(kill-buffer)][Quit]] [[elisp:(org-cycle)][| ]]
+** /Version Control/ ::  [[elisp:(call-interactively (quote cvs-update))][cvs-update]]  [[elisp:(vc-update)][vc-update]] | [[elisp:(bx:org:agenda:this-file-otherWin)][Agenda-List]]  [[elisp:(bx:org:todo:this-file-otherWin)][ToDo-List]]
+
+#+end_org """
+####+END:
+
+####+BEGIN: b:py3:file/workbench :outLevel 1
+""" #+begin_org
+* [[elisp:(org-cycle)][| Workbench |]] :: [[elisp:(python-check (format "/bisos/venv/py3/bisos3/bin/python -m pyclbr %s" (bx:buf-fname))))][pyclbr]] || [[elisp:(python-check (format "/bisos/venv/py3/bisos3/bin/python -m pydoc ./%s" (bx:buf-fname))))][pydoc]] || [[elisp:(python-check (format "/bisos/pipx/bin/pyflakes %s" (bx:buf-fname)))][pyflakes]] | [[elisp:(python-check (format "/bisos/pipx/bin/pychecker %s" (bx:buf-fname))))][pychecker (executes)]] | [[elisp:(python-check (format "/bisos/pipx/bin/pycodestyle %s" (bx:buf-fname))))][pycodestyle]] | [[elisp:(python-check (format "/bisos/pipx/bin/flake8 %s" (bx:buf-fname))))][flake8]] | [[elisp:(python-check (format "/bisos/pipx/bin/pylint %s" (bx:buf-fname))))][pylint]]  [[elisp:(org-cycle)][| ]]
+#+end_org """
+####+END:
+
+####+BEGIN: b:py3:cs:framework/imports :basedOn "classification"
+""" #+begin_org
+*  _[[elisp:(blee:menu-sel:outline:popupMenu)][±]]_ _[[elisp:(blee:menu-sel:navigation:popupMenu)][Ξ]]_ [[elisp:(outline-show-branches+toggle)][|=]] [[elisp:(bx:orgm:indirectBufOther)][|>]] *[[elisp:(blee:ppmm:org-mode-toggle)][|N]]*  CsFrmWrk   [[elisp:(outline-show-subtree+toggle)][||]] *Imports* =Based on Classification=cs-u=
+#+end_org """
+from bisos import b
+from bisos.b import cs
+from bisos.b import b_io
+from bisos.common import csParam
+
+import collections
+####+END:
+
+""" #+begin_org
+*  _[[elisp:(blee:menu-sel:outline:popupMenu)][±]]_ _[[elisp:(blee:menu-sel:navigation:popupMenu)][Ξ]]_ [[elisp:(outline-show-branches+toggle)][|=]] [[elisp:(bx:orgm:indirectBufOther)][|>]] *[[elisp:(blee:ppmm:org-mode-toggle)][|N]]*  CsFrmWrk   [[elisp:(outline-show-subtree+toggle)][||]] ~csuList emacs-list Specifications~  [[elisp:(blee:org:code-block/above-run)][ /Eval Below/ ]] [[elisp:(org-cycle)][| ]]
+#+BEGIN_SRC emacs-lisp
+(setq  b:py:cs:csuList
+  (list
+   "bisos.b.cs.ro"
+   "blee.icmPlayer.bleep"
+   "bisos.capability.materializationDispatch_csu"
+ ))
+#+END_SRC
+#+RESULTS:
+| bisos.b.cs.ro | blee.icmPlayer.bleep | bisos.capability.materializationDispatch_csu |
+#+end_org """
+
+####+BEGIN: b:py3:cs:framework/csuListProc :pyImports t :csuImports t :csuParams t
+""" #+begin_org
+*  _[[elisp:(blee:menu-sel:outline:popupMenu)][±]]_ _[[elisp:(blee:menu-sel:navigation:popupMenu)][Ξ]]_ [[elisp:(outline-show-branches+toggle)][|=]] [[elisp:(bx:orgm:indirectBufOther)][|>]] *[[elisp:(blee:ppmm:org-mode-toggle)][|N]]*  CsFrmWrk   [[elisp:(outline-show-subtree+toggle)][||]] =Process CSU List= with /3/ in csuList pyImports=t csuImports=t csuParams=t
+#+end_org """
+
+from bisos.b.cs import ro
+from blee.icmPlayer import bleep
+from bisos.capability import materializationDispatch_csu
+
+
+csuList = [ 'bisos.b.cs.ro', 'blee.icmPlayer.bleep', 'bisos.capability.materializationDispatch_csu', ]
+
+g_importedCmndsModules = cs.csuList_importedModules(csuList)
+
+def g_extraParams():
+    csParams = cs.param.CmndParamDict()
+    cs.csuList_commonParamsSpecify(csuList, csParams)
+    cs.argsparseBasedOnCsParams(csParams)
+
+####+END:
+
+####+BEGIN: b:py3:cs:main/exposedSymbols :classes ()
+""" #+begin_org
+*  _[[elisp:(blee:menu-sel:outline:popupMenu)][±]]_ _[[elisp:(blee:menu-sel:navigation:popupMenu)][Ξ]]_ [[elisp:(outline-show-branches+toggle)][|=]] [[elisp:(bx:orgm:indirectBufOther)][|>]] *[[elisp:(blee:ppmm:org-mode-toggle)][|N]]*  CsFrmWrk   [[elisp:(outline-show-subtree+toggle)][||]] ~CS Controls and Exposed Symbols List Specification~ with /0/ in Classes List
+#+end_org """
+####+END:
+
+cs.invOutcomeReportControl(cmnd=True, ro=True)
+
+
+####+BEGIN: blee:bxPanel:foldingSection :outLevel 0 :sep nil :title "CmndSvcs" :anchor ""  :extraInfo "Command Services Section"
+""" #+begin_org
+*  _[[elisp:(blee:menu-sel:outline:popupMenu)][±]]_ _[[elisp:(blee:menu-sel:navigation:popupMenu)][Ξ]]_ [[elisp:(outline-show-branches+toggle)][|=]] [[elisp:(bx:orgm:indirectBufOther)][|>]] *[[elisp:(blee:ppmm:org-mode-toggle)][|N]]*     [[elisp:(outline-show-subtree+toggle)][| _CmndSvcs_: |]]  Command Services Section  [[elisp:(org-shifttab)][<)]] E|
+#+end_org """
+####+END:
+
+####+BEGIN: b:py3:cs:cmnd/classHead :cmndName "examples" :extent "verify" :ro "noCli" :comment "FrameWrk: CS-Main-Examples" :parsMand "" :parsOpt "" :argsMin "0" :argsMax "0" :asFunc "" :interactiveP ""
+""" #+begin_org
+*  _[[elisp:(blee:menu-sel:outline:popupMenu)][±]]_ _[[elisp:(blee:menu-sel:navigation:popupMenu)][Ξ]]_ [[elisp:(outline-show-branches+toggle)][|=]] [[elisp:(bx:orgm:indirectBufOther)][|>]] *[[elisp:(blee:ppmm:org-mode-toggle)][|N]]*  CmndSvc-   [[elisp:(outline-show-subtree+toggle)][||]] <<examples>>  *FrameWrk: CS-Main-Examples*  =verify= argsMin=0 argsMax=0 ro=noCli   [[elisp:(org-cycle)][| ]]
+#+end_org """
+class examples(cs.Cmnd):
+    cmndParamsMandatory = [ ]
+    cmndParamsOptional = [ ]
+    cmndArgsLen = {'Min': 0, 'Max': 0,}
+    rtInvConstraints = cs.rtInvoker.RtInvoker.new_noRo() # NO RO From CLI
+
+    @cs.track(fnLoc=True, fnEntry=True, fnExit=True)
+    def cmnd(self,
+             rtInv: cs.RtInvoker,
+             cmndOutcome: b.op.Outcome,
+             argsList: typing.Optional[list[str]]=None,  # CsArgs
+    ) -> b.op.Outcome:
+        """FrameWrk: CS-Main-Examples"""
+        failed = b_io.eh.badOutcome
+        callParamsDict = {}
+        if self.invocationValidate(rtInv, cmndOutcome, callParamsDict, argsList).isProblematic():
+            return failed(cmndOutcome)
+        cmndArgsSpecDict = self.cmndArgsSpec()
+####+END:
+        self.cmndDocStr(f""" #+begin_org ***** [[elisp:(org-cycle)][| *CmndDesc:* | ]]  Conventional top level example.
+        #+end_org """)
+
+        od = collections.OrderedDict
+        cmnd = cs.examples.cmndEnter
+        literal = cs.examples.execInsert
+
+        cs.examples.myName(cs.G.icmMyName(), cs.G.icmMyFullName())
+
+        cs.examples.commonBrief()
+
+        bleep.examples_icmBasic()
+
+        materializationDispatch_csu.examples_csu()
+
+        # cs.examples.menuChapter('=ExecLine Example=  *Example Of Echo GPG Install Commands*')
+
+        # literal(f"""echo sudo apt -y install gnupg""")
+
+        b.ignore(ro.__doc__,  cmndArgsSpecDict)  # We are not using these modules, but they are auto imported.
+
+        return(cmndOutcome)
+
+####+BEGIN: bx:icm:py3:section :title "CS-Commands"
+""" #+begin_org
+*  _[[elisp:(blee:menu-sel:outline:popupMenu)][±]]_ _[[elisp:(blee:menu-sel:navigation:popupMenu)][Ξ]]_ [[elisp:(outline-show-branches+toggle)][|=]] [[elisp:(bx:orgm:indirectBufOther)][|>]] *[[elisp:(blee:ppmm:org-mode-toggle)][|N]]*  /Section/    [[elisp:(outline-show-subtree+toggle)][||]] *CS-Commands*  [[elisp:(org-cycle)][| ]]
+#+end_org """
+####+END:
+
+####+BEGIN: blee:bxPanel:foldingSection :outLevel 0 :sep nil :title "Main" :anchor ""  :extraInfo "Framework Dblock"
+""" #+begin_org
+*  _[[elisp:(blee:menu-sel:outline:popupMenu)][±]]_ _[[elisp:(blee:menu-sel:navigation:popupMenu)][Ξ]]_ [[elisp:(outline-show-branches+toggle)][|=]] [[elisp:(bx:orgm:indirectBufOther)][|>]] *[[elisp:(blee:ppmm:org-mode-toggle)][|N]]*     [[elisp:(outline-show-subtree+toggle)][| _Main_: |]]  Framework Dblock  [[elisp:(org-shifttab)][<)]] E|
+#+end_org """
+####+END:
+
+####+BEGIN: b:py3:cs:framework/main :csInfo "csInfo" :noCmndEntry "examples" :extraParamsHook "g_extraParams" :importedCmndsModules "g_importedCmndsModules"
+""" #+begin_org
+*  _[[elisp:(blee:menu-sel:outline:popupMenu)][±]]_ _[[elisp:(blee:menu-sel:navigation:popupMenu)][Ξ]]_ [[elisp:(outline-show-branches+toggle)][|=]] [[elisp:(bx:orgm:indirectBufOther)][|>]] *[[elisp:(blee:ppmm:org-mode-toggle)][|N]]*  CsFrmWrk   [[elisp:(outline-show-subtree+toggle)][||]] =g_csMain= (csInfo, _examples_, g_extraParams, g_importedCmndsModules)
+#+end_org """
+
+if __name__ == '__main__':
+    cs.main.g_csMain(
+        csInfo=csInfo,
+        noCmndEntry=examples,  # specify a Cmnd name
+        extraParamsHook=g_extraParams,
+        importedCmndsModules=g_importedCmndsModules,
+    )
+
+####+END:
+
+####+BEGIN: b:py3:cs:framework/endOfFile :basedOn "classification"
+""" #+begin_org
+* [[elisp:(org-cycle)][| *End-Of-Editable-Text* |]] :: emacs and org variables and control parameters
+#+end_org """
+
+#+STARTUP: showall
+
+### local variables:
+### no-byte-compile: t
+### end:
+####+END: