Metadata-Version: 2.2
Name: bisos.pyDblock
Version: 0.11
Summary: bisos.pyDblock: Pure-Python org-mode Dynamic Block Expansion
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
Requires-Dist: bisos.b
Requires-Dist: bisos.common
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.pyDblock: Pure-Python org-mode Dynamic Block Expansion
============================================================

.. contents::
   :depth: 3
..

Overview
========

*bisos.py-dblock* is a pure-Python engine for expanding org-mode
**dynamic blocks** (dblocks) in files, without requiring Emacs or the
Blee ``bx-dblock`` tool. It mimics org-mode's dblock model: handlers
register under a signature string, and a single pass over a file
dispatches each replacing the block body with freshly computed content.

bisos.py-dblock is a python package that uses the
`PyCS-Framework <https://github.com/bisos-pip/pycs>`__. It provides the
``py-dblock.cs`` command for updating org-mode dynamic blocks from the
command-line.

The package ships one built-in handler, for the
``b:ai:file/particulars`` dblock used by the ByStar AI collaborative
development template set.

.. _table-of-contents:

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

-  `Overview <#overview>`__
-  `Part of BISOS — ByStar Internet Services Operating
   System <#part-of-bisos--bystar-internet-services-operating-system>`__
-  `bisos.py-dblock is a Command-Only PyCS
   Facility <#bisospy-dblock-is-a-command-only-pycs-facility>`__
-  `Planned Improvements <#planned-improvements>`__

Part of 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** 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.py-dblock* is part of BISOS. It is a standalone package that can
be used independently of the full BISOS environment.

bisos.py-dblock is a Command-Only PyCS Facility
===============================================

bisos.py-dblock is a command-line tool. It is a PyCS single-unit command
service. PyCS is a framework that converges development of CLI tools and
services. PyCS is an alternative to FastAPI, Typer and Click.

Planned Improvements
====================

-  Upload to PyPI and test as pipx install
-  Write fullUsagePanel-en.org Blee-Panel
-  Add further dblock handlers beyond ``b:ai:file/particulars``
