semvec/pypi-packages huggingface dataset:
gluware-ansible-inventory 1.2.1
Gluware Ansible Inventory

# Gluware Ansible Inventory (Inventory plugin and Gluware Ansible modules)

This python package installs a Ansible Inventory plugin (glu_devices) to interact with a Gluware Control system to get the current network devices of a organization.  A "inventory" user can be created in the Gluware Control system that can then be used in the configuration of the glu_devices inventory plugin to access the devices of the Gluware Control system.  

The glu_devices Ansible Inventory plugin gives Ansible playbooks the ability to connect to Gluware devices and get the "ansible_network_os" property of the device to know what kind of device it is (if the discovery function in Gluware is used).  The glu_devices inventory plugin also exposes to Ansible playbooks any custom Gluware device attributes that start with "ansible_var_" (minus the "ansible_var_" part) to act on within the logic of the playbook.  In addition, the other Gluware device attributes can be mapped to Ansible variables through configuration settings of the glu_devices.

In version 1.2, Gluware Ansible modules are also installed to allow interaction with Gluware device data from within playbook tasks. The Inventory plugin was updated to supply the 'glu_device_id' for the Gluware Ansible modules. The modules are identified as follows:
* glu_audit_config
    * Perform a audit on the current captured config on a Gluware Device
* glu_capture_config
    * Perform a capture config on a Gluware Device
* glu_run_discover_device_attributes
    * Perform a discover device attributes on a Gluware Device
* glu_update_device_attributes
    * Update device attributes on a Gluware Device

To install on the system that is running Ansible run the command line: "pip install gluware-ansible-inventory".  If updating to a later version the run the command line: "pip install -I gluware-ansible-inventory".

After install run the command line: "ansible-doc -t inventory glu_devices" to see the specifics of how to use the glu_devices inventory plugin to connect to the Gluware Control system.  To see the documentation for each module run the command line: "ansible-doc -t module {{ module_name }}".

* Install Command 
    * $ pip install gluware-ansible-inventory
* Update Command: 
    * $ pip install -I gluware-ansible-inventory
* Usage documentation command after install
    * $ ansible-doc -t inventory glu_devices
    * $ ansible-doc -t module glu_audit_config
    * $ ansible-doc -t module glu_capture_config
    * $ ansible-doc -t module glu_run_discover_device_attributes
    * $ ansible-doc -t module glu_update_device_attributes

* Installation imlementation note:
    * The 'pip install gluware-ansible-inventory' places the 'glu_devices.py' file in the '/usr/share/ansible/plugins/inventory/' directory for ansible to find the glu_devices inventory plugin.  The modules are placed in the '/usr/share/ansible/plugins/modules/'
    directory for ansible to find the Gluware modules.
    * The inventory plugin is just the 'glu_devices.py' file with no other files being used.