Metadata-Version: 2.2
Name: bisos.py3-all
Version: 0.24
Summary: bisos.py3-all:  Top level module -- bisos.core + bisosPkgs + adopted bisos external pkgs
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: bisos.b
Requires-Dist: bisos.banna
Requires-Dist: bisos.bashStandaloneIcmSeed
Requires-Dist: bisos.basics
Requires-Dist: bisos.binsprep
Requires-Dist: bisos.bootstrap
Requires-Dist: bisos.bpo
Requires-Dist: bisos.bx-bases
Requires-Dist: bisos.bxoGitlab
Requires-Dist: bisos.capability
Requires-Dist: bisos.capSpecs
Requires-Dist: bisos.cmdb
Requires-Dist: bisos.cntnr
Requires-Dist: bisos.common
Requires-Dist: bisos.core
Requires-Dist: bisos.coreDist
Requires-Dist: bisos.crypt
Requires-Dist: bisos.csPlayer
Requires-Dist: bisos.currents
Requires-Dist: bisos.debian
Requires-Dist: bisos.examples
Requires-Dist: bisos.facter
Requires-Dist: bisos.gcipher
Requires-Dist: bisos.githubApi
Requires-Dist: bisos.gossonot
Requires-Dist: bisos.graphviz
Requires-Dist: bisos.lcnt
Requires-Dist: bisos.marmee
Requires-Dist: bisos.mmwsIcm
Requires-Dist: bisos.pals
Requires-Dist: bisos.platform
Requires-Dist: bisos.provision
Requires-Dist: bisos.pycs
Requires-Dist: bisos.qmail
Requires-Dist: bisos.regfps
Requires-Dist: bisos.sbom
Requires-Dist: bisos.siteRegistrars
Requires-Dist: bisos.things
Requires-Dist: bisos.transit
Requires-Dist: bisos.usgAcct
Requires-Dist: bisos.virsh
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: license
Dynamic: maintainer
Dynamic: maintainer-email
Dynamic: requires-dist
Dynamic: summary

======================================================================================
bisos.py3-all: Top level module – bisos.core + bisosPkgs + adopted bisos external pkgs
======================================================================================

.. contents::
   :depth: 3
..

Overview
========

bisos.py3-all: is a top level module that requires core BISOS and all
BISOS Pkgs (Feature Areas).

bisos.py3-all is a python package that uses the PyCS-Framework for
NOTYET. It is a BISOS-Capability and a Standalone-BISOS-Package.

*bisos.py3-all* is based on PyCS-Foundation and can be used both as a
Command and as a Service (invoke/perform model of remote operations)
using RPYC for central management of multiple systems.

.. _table-of-contents:

Table of Contents TOC
=====================

-  `Overview <#overview>`__
-  `About BISOS — ByStar Internet Services Operating
   System <#about-bisos-----bystar-internet-services-operating-system>`__
-  `bisos.py3-all is a Command Services (PyCS)
   Facility <#bisospy3-all-is-a-command-services-pycs-facility>`__
-  `Uses of bisos.py3-all <#uses-of-bisospy3-all>`__
-  `bisos.py3-all as a Standalone Piece of
   BISOS <#bisospy3-all-as-a-standalone-piece-of-bisos>`__
-  `Installation <#installation>`__

   -  `With pip <#with-pip>`__
   -  `With pipx <#with-pipx>`__

-  `Usage <#usage>`__

   -  `Locally (system command-line) <#locally-system-command-line>`__
   -  `Remotely (as a service –
      Performer+Invoker) <#remotely-as-a-service----performerinvoker>`__

      -  `Performer <#performer>`__
      -  `Invoker <#invoker>`__

   -  `Use by Python script <#use-by-python-script>`__

      -  `bisos.py3-all Source Code is in writen in COMEEGA
         (Collaborative Org-Mode Enhanced Emacs Generalized Authorship)
         – <#bisospy3-all-source-code-is-in-writen-in-comeega-collaborative-org-mode-enhanced-emacs-generalized-authorship----httpsgithubcombx-bleecomeega>`__\ https://github.com/bx-blee/comeega\ `. <#bisospy3-all-source-code-is-in-writen-in-comeega-collaborative-org-mode-enhanced-emacs-generalized-authorship----httpsgithubcombx-bleecomeega>`__
      -  `The primary API for bisos.py3-all is
         ./bisos/py3-all/py3-all-csu.py. It is self documented in
         COMEEGA. <#the-primary-api-for-bisospy3-all-is-bisospy3-allpy3-all-csupy-it-is-self-documented-in-comeega>`__

-  `Documentation and Blee-Panels <#documentation-and-blee-panels>`__

   -  `bisos.py3-all Blee-Panels <#bisospy3-all-blee-panels>`__

-  `Support <#support>`__

About BISOS — 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.py3-all* as a PyCS facility is a small piece of a much bigger
picture. **BISOS** is a foundation for **The Libre-Halaal ByStar Digital
Ecosystem** which is described as a cure for losses of autonomy and
privacy that we are experiencing in a book titled: `Nature of
Polyexistentials <https://github.com/bxplpc/120033>`__

bisos.py3-all is a Command Services (PyCS) Facility
===================================================

bisos.py3-all can be used locally on command-line or remotely as a
service. bisos.py3-all is a PyCS multi-unit command-service. PyCS is a
framework that converges developement of CLI and Services. PyCS is an
alternative to FastAPI, Typer and Click.

bisos.py3-all uses the PyCS Framework to:

#. Provide access to py3-all facilities through native python.
#. Provide local access to py3-all facilities on CLI.
#. Provide remote access to py3-all facilities through remote invocation
   of python Expection Complete Operations using
   `rpyc <https://github.com/tomerfiliba-org/rpyc>`__.
#. Provide remote access to py3-all facilities on CLI.

What is unique in the PyCS-Framework is that these four models are all a
single abstraction.

The core of PyCS-Framework is the *bisos.b* package (the
PyCS-Foundation). See https://github.com/bisos-pip/b for an overview.

Uses of bisos.py3-all
=====================

Within BISOS, bisos.py3-all is used as a common facility.

bisos.py3-all as a Standalone Piece of BISOS
============================================

bisos.py3-all is a standalone piece of BISOS. It can be used as a
self-contained Python package separate from BISOS. Follow the
installtion and usage instructions below for your own use.

Installation
============

The sources for the bisos.py3-all pip package is maintained at:
https://github.com/bisos-pip/py3-all.

The bisos.py3-all pip package is available at PYPI as
https://pypi.org/project/bisos.py3-all

You can install bisos.py3-all with pip or pipx.

With pip
--------

If you need access to bisos.py3-all as a python module, you can install
it with pip:

.. code:: bash

   pip install bisos.py3-all

With pipx
---------

If you only need access to bisos.py3-all as a command on command-line,
you can install it with pipx:

.. code:: bash

   pipx install bisos.py3-all

The following commands are made available:

-  py3-all.cs
-  roInv-py3-all.cs
-  roPerf-py3-all.cs

These are all one file with 3 names. *roInv-py3-all.cs* and
*roPerf-py3-all.cs* are sym-links to *py3-all.cs*

Usage
=====

Locally (system command-line)
-----------------------------

``py3-all.cs`` can be invoked directly as

.. code:: bash

   bin/py3-all.cs

Remotely (as a service – Performer+Invoker)
-------------------------------------------

You can also run

Performer
~~~~~~~~~

Run performer as:

.. code:: bash

   bin/roPerf-py3-all.cs

Invoker
~~~~~~~

Run invoker as:

.. code:: bash

   bin/roInv-py3-all.cs

Use by Python script
--------------------

bisos.py3-all Source Code is in writen in COMEEGA (Collaborative Org-Mode Enhanced Emacs Generalized Authorship) – https://github.com/bx-blee/comeega.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The primary API for bisos.py3-all is ./bisos/py3-all/py3-all-csu.py. It is self documented in COMEEGA.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Documentation and Blee-Panels
=============================

bisos.py3-all 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.py3-all Blee-Panels
-------------------------

bisos.py3-all Blee-Panles are in ./panels directory. From within Blee
and BISOS these panles 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
