bisos.capDns 0.1__tar.gz

bisos_capdns-0.1/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.2
+Name: bisos.capDns
+Version: 0.1
+Summary: bisos.gitist:  Git Mass Cloning and More
+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: Operating System :: POSIX
+Classifier: Programming Language :: Python
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: bisos
+Requires-Dist: bisos.b
+Requires-Dist: bisos.common
+Requires-Dist: bisos.csPlayer
+Requires-Dist: bisos.csSeed
+Requires-Dist: setuptools==75.8.0
+Requires-Dist: wheel==0.38.4
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: license
+Dynamic: maintainer
+Dynamic: maintainer-email
+Dynamic: requires-dist
+Dynamic: summary
+
+=======================================
+bisos.gitist: Git Mass Cloning and More
+=======================================
+
+.. contents::
+   :depth: 3
+..
+
+Overview
+========
+
+*bisos.gitist* provides general facilities for mass cloning of public
+github and gitlab and also private gitlab instances.
+
+bisos.gitist is a python package that uses the
+`PyCS-Framework <https://github.com/bisos-pip/pycs>`__.
+
+gitist.cs is a seed. Common usages of gitist take the form of a
+gitistProc.pcs.
+
+.. _table-of-contents:
+
+Table of Contents TOC
+=====================
+
+-  `Overview <#overview>`__
+-  `Gitist Layers <#gitist-layers>`__
+-  `Post-Installation Setup <#post-installation-setup>`__
+-  `Installation <#installation>`__
+
+   -  `Installation With pip <#installation-with-pip>`__
+   -  `Installation With pipx <#installation-with-pipx>`__
+
+-  `Usage <#usage>`__
+
+   -  `Local Usage (system
+      command-line) <#local-usage-system-command-line>`__
+
+-  `Documentation and Blee-Panels <#documentation-and-blee-panels>`__
+
+   -  `bisos.gitist Blee-Panels <#bisosgitist-blee-panels>`__
+
+-  `Support <#support>`__
+-  `Planned Improvements <#planned-improvements>`__
+
+Gitist Layers
+=============
+
+#. PyCS Framework
+#. Seeded/Planted PyCS Framework (gitist.cs)
+#. Common csCmndsList (bisos.csSeed)
+#. Gitist Commands CSUs
+
+Post-Installation Setup
+=======================
+
+After installing, run the provisioning script to create the credentials
+directory and place the configuration templates:
+
+.. code:: bash
+
+   config/provision.pcs -i credsSetup
+
+This creates ``~/credentials/git/`` and copies two config files there if
+they do not already exist:
+
+-  ``~/credentials/git/githubHosts.cfg`` — GitHub configuration; insert
+   your GitHub PAT (Personal Access Token) here.
+-  ``~/credentials/git/gitlabHosts.cfg`` — GitLab configuration; insert
+   your GitLab PAT here.
+
+Once the PATs are in place, you can run the gitist proc scripts, e.g.:
+
+.. code:: bash
+
+   bin/github-pub-gitist.pcs
+   bin/gitlab-pub-gitist.pcs
+
+Installation
+============
+
+The sources for the bisos.gitist pip package are maintained at:
+https://github.com/bisos-pip/gitist.
+
+The bisos.gitist pip package is available at PYPI as
+https://pypi.org/project/bisos.gitist
+
+You can install bisos.gitist with pip or pipx.
+
+Installation With pip
+---------------------
+
+If you need access to bisos.gitist as a python module, you can install
+it with pip:
+
+.. code:: bash
+
+   pip install bisos.gitist
+
+Installation With pipx
+----------------------
+
+If you only need access to bisos.gitist on command-line, you can install
+it with pipx:
+
+.. code:: bash
+
+   pipx install bisos.gitist
+
+Usage
+=====
+
+Local Usage (system command-line)
+---------------------------------
+
+``gitist.cs`` does the equivalent of gitist.
+
+.. code:: bash
+
+   bin/gitist.cs
+   bin/gitistProc.pcs
+
+Documentation and Blee-Panels
+=============================
+
+bisos.gitist 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.gitist Blee-Panels
+------------------------
+
+bisos.gitist Blee-Panles are in ./panels directory. From within Blee and
+BISOS these panles are accessible under the Blee "Panels" menu.
+
+See
+`file:./panels/_nodeBase_/fullUsagePanel-en.org <./panels/_nodeBase_/fullUsagePanel-en.org>`__
+for a starting point.
+
+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
+
+Planned Improvements
+====================
+
+-  Enumerate applicabilities: telecom/SON, datacenter, CMIP-MOs
+-  py3/bisos/gitist/tocsModule\ :sub:`csu`.py

bisos_capdns-0.1/README.rst

@@ -0,0 +1,154 @@
+=======================================
+bisos.gitist: Git Mass Cloning and More
+=======================================
+
+.. contents::
+   :depth: 3
+..
+
+Overview
+========
+
+*bisos.gitist* provides general facilities for mass cloning of public
+github and gitlab and also private gitlab instances.
+
+bisos.gitist is a python package that uses the
+`PyCS-Framework <https://github.com/bisos-pip/pycs>`__.
+
+gitist.cs is a seed. Common usages of gitist take the form of a
+gitistProc.pcs.
+
+.. _table-of-contents:
+
+Table of Contents TOC
+=====================
+
+-  `Overview <#overview>`__
+-  `Gitist Layers <#gitist-layers>`__
+-  `Post-Installation Setup <#post-installation-setup>`__
+-  `Installation <#installation>`__
+
+   -  `Installation With pip <#installation-with-pip>`__
+   -  `Installation With pipx <#installation-with-pipx>`__
+
+-  `Usage <#usage>`__
+
+   -  `Local Usage (system
+      command-line) <#local-usage-system-command-line>`__
+
+-  `Documentation and Blee-Panels <#documentation-and-blee-panels>`__
+
+   -  `bisos.gitist Blee-Panels <#bisosgitist-blee-panels>`__
+
+-  `Support <#support>`__
+-  `Planned Improvements <#planned-improvements>`__
+
+Gitist Layers
+=============
+
+#. PyCS Framework
+#. Seeded/Planted PyCS Framework (gitist.cs)
+#. Common csCmndsList (bisos.csSeed)
+#. Gitist Commands CSUs
+
+Post-Installation Setup
+=======================
+
+After installing, run the provisioning script to create the credentials
+directory and place the configuration templates:
+
+.. code:: bash
+
+   config/provision.pcs -i credsSetup
+
+This creates ``~/credentials/git/`` and copies two config files there if
+they do not already exist:
+
+-  ``~/credentials/git/githubHosts.cfg`` — GitHub configuration; insert
+   your GitHub PAT (Personal Access Token) here.
+-  ``~/credentials/git/gitlabHosts.cfg`` — GitLab configuration; insert
+   your GitLab PAT here.
+
+Once the PATs are in place, you can run the gitist proc scripts, e.g.:
+
+.. code:: bash
+
+   bin/github-pub-gitist.pcs
+   bin/gitlab-pub-gitist.pcs
+
+Installation
+============
+
+The sources for the bisos.gitist pip package are maintained at:
+https://github.com/bisos-pip/gitist.
+
+The bisos.gitist pip package is available at PYPI as
+https://pypi.org/project/bisos.gitist
+
+You can install bisos.gitist with pip or pipx.
+
+Installation With pip
+---------------------
+
+If you need access to bisos.gitist as a python module, you can install
+it with pip:
+
+.. code:: bash
+
+   pip install bisos.gitist
+
+Installation With pipx
+----------------------
+
+If you only need access to bisos.gitist on command-line, you can install
+it with pipx:
+
+.. code:: bash
+
+   pipx install bisos.gitist
+
+Usage
+=====
+
+Local Usage (system command-line)
+---------------------------------
+
+``gitist.cs`` does the equivalent of gitist.
+
+.. code:: bash
+
+   bin/gitist.cs
+   bin/gitistProc.pcs
+
+Documentation and Blee-Panels
+=============================
+
+bisos.gitist 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.gitist Blee-Panels
+------------------------
+
+bisos.gitist Blee-Panles are in ./panels directory. From within Blee and
+BISOS these panles are accessible under the Blee "Panels" menu.
+
+See
+`file:./panels/_nodeBase_/fullUsagePanel-en.org <./panels/_nodeBase_/fullUsagePanel-en.org>`__
+for a starting point.
+
+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
+
+Planned Improvements
+====================
+
+-  Enumerate applicabilities: telecom/SON, datacenter, CMIP-MOs
+-  py3/bisos/gitist/tocsModule\ :sub:`csu`.py

bisos_capdns-0.1/_description.org

@@ -0,0 +1,127 @@
+#+title: bisos.gitist:  Git Mass Cloning and More
+
+
+
+
+* Overview
+
+/bisos.gitist/ provides general facilities for mass cloning of public github and gitlab
+and also private gitlab instances.
+
+bisos.gitist is a python package that uses the  [[https://github.com/bisos-pip/pycs][PyCS-Framework]].
+
+gitist.cs is a seed. Common usages of gitist take the form of a gitistProc.pcs.
+
+
+
+* Table of Contents     :TOC:
+- [[#overview][Overview]]
+- [[#gitist-layers][Gitist Layers]]
+- [[#post-installation-setup][Post-Installation Setup]]
+- [[#installation][Installation]]
+  - [[#installation-with-pip][Installation With pip]]
+  - [[#installation-with-pipx][Installation With pipx]]
+- [[#usage][Usage]]
+  - [[#local-usage-system-command-line][Local Usage (system command-line)]]
+- [[#documentation-and-blee-panels][Documentation and Blee-Panels]]
+  - [[#bisosgitist-blee-panels][bisos.gitist Blee-Panels]]
+- [[#support][Support]]
+- [[#planned-improvements][Planned Improvements]]
+
+* Gitist Layers
+
+1) PyCS Framework
+2) Seeded/Planted PyCS Framework (gitist.cs)
+3) Common csCmndsList (bisos.csSeed)
+4) Gitist Commands CSUs
+
+
+* Post-Installation Setup
+
+After installing, run the provisioning script to create the credentials directory
+and place the configuration templates:
+
+#+begin_src bash
+config/provision.pcs -i credsSetup
+#+end_src
+
+This creates =~/credentials/git/= and copies two config files there if they do
+not already exist:
+
+- =~/credentials/git/githubHosts.cfg= — GitHub configuration; insert your GitHub PAT (Personal Access Token) here.
+- =~/credentials/git/gitlabHosts.cfg= — GitLab configuration; insert your GitLab PAT here.
+
+Once the PATs are in place, you can run the gitist proc scripts, e.g.:
+
+#+begin_src bash
+bin/github-pub-gitist.pcs
+bin/gitlab-pub-gitist.pcs
+#+end_src
+
+
+* Installation
+
+The sources for the bisos.gitist pip package are maintained at:
+https://github.com/bisos-pip/gitist.
+
+The bisos.gitist pip package is available at PYPI as
+https://pypi.org/project/bisos.gitist
+
+You can install bisos.gitist with pip or pipx.
+
+** Installation With pip
+
+If you need access to bisos.gitist as a python module, you can install it with pip:
+
+#+begin_src bash
+pip install bisos.gitist
+#+end_src
+
+** Installation With pipx
+
+If you only need access to bisos.gitist on command-line, you can install it with pipx:
+
+#+begin_src bash
+pipx install bisos.gitist
+#+end_src
+
+* Usage
+
+** Local Usage (system command-line)
+
+=gitist.cs= does the equivalent of gitist.
+
+#+begin_src bash
+bin/gitist.cs
+bin/gitistProc.pcs
+#+end_src
+
+
+* Documentation and Blee-Panels
+
+bisos.gitist 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.gitist Blee-Panels
+
+bisos.gitist Blee-Panles are in ./panels directory.
+From within Blee and BISOS these panles are accessible under the
+Blee "Panels" menu.
+
+See [[file:./panels/_nodeBase_/fullUsagePanel-en.org]] for a starting point.
+
+* 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]]
+
+
+* Planned Improvements
+
+- Enumerate applicabilities: telecom/SON, datacenter, CMIP-MOs
+- py3/bisos/gitist/tocsModule_csu.py
+

bisos_capdns-0.1/bin/airflow-here-dns.pcs

@@ -0,0 +1,33 @@
+#!/usr/bin/env python
+
+""" #+begin_org
+* ~[Summary]~ :: A =PlantedCmndService= for Processing BISOS-Capability 
+#+end_org """
+
+from bisos.b import cs
+import collections
+
+from bisos.csSeed import seedsLib
+
+from bisos.capDns import capDns_seed #  noqa: F401  # type: ignore[unused-import] _atExit_
+
+from bisos.capDns import capDns_seedInfo
+cntrlInfo = capDns_seedInfo.cmndsControlInfo
+
+cntrlInfo.dnsSpecMethod = capDns_seedInfo.DnsSpecMethod.etcHosts   # Other choice is tinydns
+cntrlInfo.fqdn = "airflow.here"
+
+from bisos.csSeed import csCmndsList_seedInfo
+csCmnd = csCmndsList_seedInfo.csCmnd
+
+csCmndsList = [
+    csCmnd("capDns_update",),
+    csCmnd("capDns_verify",),
+    csCmnd("capDns_resolve", args=f"{cntrlInfo.fqdn}"),
+    csCmnd("capDns_fqdnPing",
+           args=f"{cntrlInfo.fqdn}"),
+]
+
+csCmndsList_seedInfo.setup(
+    csCmndsList=csCmndsList,
+)