Metadata-Version: 2.1
Name: idem-linux
Version: 1
Summary: Vertical app merge components for Idem and corn support on Linux
Home-page: UNKNOWN
Author: 
Author-email: 
License: UNKNOWN
Platform: UNKNOWN
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
Requires-Dist: aiofiles (==0.4.0)
Requires-Dist: corn (>=4)
Requires-Dist: distro (>=1.0)
Requires-Dist: dnspython (>=1.16.0)
Requires-Dist: idem (>=5.1)
Requires-Dist: ifcfg (>=0.20)
Requires-Dist: pop (>=8.1)
Requires-Dist: python-dateutil (>=2.8.1)
Requires-Dist: rend (>=4.1)

**********
IDEM-LINUX
**********
**Grains, execution modules, and state modules common to all linux systems**

INSTALLATION
============


Pip install corn::

    pip install -e git+https://gitlab.com/saltstack/pop/corn.git

Clone the `idem-linux` repo and install with pip::

    git clone https://gitlab.com/saltstack/pop/idem-linux.git
    pip install -e idem-linux

EXECUTION
=========
After installation the `corn` command should now be available

TESTING
=======
install `requirements-test.txt` with pip and run pytest::

    pip install -r idem-linux/requirements-test.txt
    pytest idem-linux/tests

VERTICAL APP-MERGING
====================
Instructions for extending pop-linux into an OS or distro specific pop project

Install pop::

    pip install --upgrade pop

Create a new directory for the project::

    mkdir idem-{specific_linux_distro}
    cd idem-{specific_linux_distro}


Use `pop-seed` to generate the structure of a project that extends `corn` and `idem`::

    pop-seed -t v idem-{specific_linux_distro} -d corn exec states

* "-t v" specifies that this is a vertically app-merged project
*  "-d corn exec states" says that we want to implement the dynamic names of "corn", "exec", and "states"

Add "idem-linux" to the requirements.txt::

    echo "idem-linux @ git+https://gitlab.com/saltstack/pop/idem-linux.git" >> requirements.txt

And that's it!  Go to town making corn, execution modules, and state modules specific to your linux distro.
Follow the conventions you see in idem-linux.

For information about running idem states and execution modules check out
https://idem.readthedocs.io


