Metadata-Version: 2.3
Name: harangued
Version: 0.1
Summary: Update and manage other programs/system config files safely
Author-email: Roger Gammans <rgammans@gammascience.co.uk>
License: GPLv3
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Text Processing :: General
Requires-Python: >=3.10
Description-Content-Type: text/x-rst

Harangued
=========

..  image:: https://github.com/GammaScience/harangued/actions/workflows/unittest.yml/badge.svg
    :alt: Python package tests
    :target: https://github.com/GammaScience/harangued/actions/workflows/unittest.yml


Harangued is small library for managing adding additional lines
to standard (and normally system) configuration files.

Harangued provides a context manager which can be used
to manage your app additions to a configuration file which
is common with other apps, including other apps using Harangued,
or human editors and make changes to those config files in
their own guarded sections.

Harangued can be use like this:

.. code:
    with Haranguer("/path/to/file") as my_lines:
        for line in my_lines.data:
           # Verify line
           pass
        my_lines.data.append("extra line")

This will result is a section being added to the config file
like this.

.. code:
    Some config line
    ################## begin Block - Generated by Haranguer ##################
    an existing config line
    extra line
    ################## end   Block - Generated by Haranguer ##################

