%global _empty_manifest_terminate_build 0 Name: python-skilletlib Version: 1.2.5 Release: 1 Summary: Tools for working with PAN-OS Skillets in Python 3 License: Apache 2.0 URL: https://github.com/paloaltonetworks/skilletlib Source0: https://mirrors.aliyun.com/pypi/web/packages/70/1d/b862db3bba55169edfcd8cb4ca074c79b375f72604189cd3deb134bd1417/skilletlib-1.2.5.tar.gz BuildArch: noarch Requires: python3-oyaml Requires: python3-docker Requires: python3-pan-python Requires: python3-jinja2 Requires: python3-pyyaml Requires: python3-xmldiff Requires: python3-xmltodict Requires: python3-requests-toolbelt Requires: python3-requests Requires: python3-jsonpath-ng Requires: python3-passlib Requires: python3-GitPython Requires: python3-jinja2-ansible-filters Requires: python3-jmespath %description # Skilletlib Base Classes and Utilities for working with Skillets in Python 3.7+. Skilletlib encapsulates all the logic necessary to execute a skillet in your app or tooling. See [here](https://live.paloaltonetworks.com/t5/Skillet-District/ct-p/Skillets) for information about Skillets and what skillets may be available. ## About Skillets Skillets are designed to be sharable units of configuration or validation data. They are perfectly suited for 'Compliance as Code' or 'Infrastructure as Code' type environments. All the 'knowledge' of doing a thing is encapsulated in the skillet. Skillets strive to be tooling agnostic. A subject matter expert should not have to define best practices in multiple domain specific languages. Ideally, this should be expressed once, and executed in a variety of tools. Skilletlib makes it easy to allow Skillets to be executed in your tooling of choice. Skillets are meant to be stored and shared via source control repositories along with the rest of your infrastructure. This allows complex NGFW configurations and use case specific compliance checks to be executed as part of your deployment pipeline. ## Resources * [Information on building Skillets and working with the PAN-OS XML API](https://SkilletBuilder.readthedocs.io) * [Example Skillets](https://github.com/PaloAltoNetworks/skilletlib/tree/master/example_skillets) * [PAN-OS XML Quickstart](https://strata.pan.dev/docs/apis/xmlapi_qs) * [PAN-OS Exploring the API](https://docs.paloaltonetworks.com/pan-os/9-0/pan-os-panorama-api/get-started-with-the-pan-os-xml-api/explore-the-api.html) ## Installation Skilletlib is distributed as a python shared library on [pypi.org](https://pypi.org/project/skilletlib/). ```bash pip install skilletlib ``` ## Example Loading a Skillet ```python from skilletlib import SkilletLoader # init SkilletLoader Class sl = SkilletLoader() # Load the skillet found in the current directory skillet = sl.load_skillet_from_path('.') # Every skillet requires a context, which is a dict containing # any user-input or other variables to allow customization. context = dict() # In this example, our skillet needs a configuration.xml file to be loaded into a variable # called 'config' with open('config.xml', 'r') as config: context['config'] = config.read() # execute the skillet and return the results out = skillet.execute(context) # Do something interesting with the results, like print it out :-) print(out) print('all done') ``` ## Loading Skillets from a Git repository ```python from skilletlib import SkilletLoader repo_url = 'https://github.com/nembery/Skillets' repo_branch = 'develop' directory = '/var/tmp/skillets' repo_name = 'example skillets' sl = SkilletLoader() skillets = sl.load_from_git(repo_url, repo_name, repo_branch, local_dir=directory) for s in skillets: print(s.name) ``` ## using Skilletlib to find recent changes in Set CLI Format ```python import os # The Panos class is a wrapper around the XML API that provides some convience methods from skilletlib import Panos auth = { 'hostname': os.environ.get('ip_address', ''), 'api_username': os.environ.get('username', ''), 'api_password': os.environ.get('password', ''), 'debug': os.environ.get('debug', True), } device = Panos(**auth) # you can pass negative integers to the 'get_configuration' method to retrive the most to least recent # running configurations. This is very useful to finding the Set CLI or XML equivelent of GUI configuration # changes previous_config = device.get_configuration(config_source='-1') latest_config = device.get_configuration(config_source='running') # The 'generate_set_cli_from_configs' method returns the difference between two config files. In this case, # we'll use the running config and the most recent running config audit backup. This will give us all the # changes made via the most recent commit in Set CLI format cmds = device.generate_set_cli_from_configs(previous_config, latest_config) for cmd in cmds: print(cmd) ``` ## Other projects that use Skilletlib Here are a couple of examples of other projects that use skilletlib * [Panhandler](https://github.com/PaloAltoNetworks/panhandler/) Panhandler is a tool to manage collections of Skillets and their respective git repositories * [SLI](https://gitlab.com/panw-gse/as/sli) SLI is a CLI interface to Skilletlib. This tool allows rapid testing and prototyping of Skillets * [SkilletLoader](https://github.com/nembery/skilletLoader/) SkilletLoader is a tool to load and test skillets in a CI/CD pipeline via Docker * [Ansible Skillets](https://github.com/PaloAltoNetworks/panw-gse.skillets) Ansible roles and libraries for loading PAN-OS and related skillets via Ansible playbooks * [Demisto XSOAR Integration](https://github.com/nembery/content/tree/skilletlib/Packs/skilletlib) Experimental in development Demisto XSOAR integration ## Other utilities in Skilletlib Skilletlib also includes a collection of tools and methods called '[Panoply](https://www.merriam-webster.com/dictionary/panoply)' which eases working with emphemeral PAN-OS and Panorama devices, such as in a CI/CD Pipeline or development environment. ## Support Community Supported The software and templates in the repo are released under an as-is, best effort, support policy. This software should be seen as community supported and Palo Alto Networks will contribute our expertise as and when possible. We do not provide technical support or help in using or troubleshooting the components of the project through our normal support options such as Palo Alto Networks support teams, or ASC (Authorized Support Centers) partners and backline support options. The underlying product used (the VM-Series firewall) by the scripts or templates are still supported, but the support is only for the product functionality and not for help in deploying or using the template or script itself. Unless explicitly tagged, all projects or work posted in our GitHub repository (at https://github.com/PaloAltoNetworks) or sites other than our official Downloads page on https://support.paloaltonetworks.com are provided under the best effort policy. %package -n python3-skilletlib Summary: Tools for working with PAN-OS Skillets in Python 3 Provides: python-skilletlib BuildRequires: python3-devel BuildRequires: python3-setuptools BuildRequires: python3-pip %description -n python3-skilletlib # Skilletlib Base Classes and Utilities for working with Skillets in Python 3.7+. Skilletlib encapsulates all the logic necessary to execute a skillet in your app or tooling. See [here](https://live.paloaltonetworks.com/t5/Skillet-District/ct-p/Skillets) for information about Skillets and what skillets may be available. ## About Skillets Skillets are designed to be sharable units of configuration or validation data. They are perfectly suited for 'Compliance as Code' or 'Infrastructure as Code' type environments. All the 'knowledge' of doing a thing is encapsulated in the skillet. Skillets strive to be tooling agnostic. A subject matter expert should not have to define best practices in multiple domain specific languages. Ideally, this should be expressed once, and executed in a variety of tools. Skilletlib makes it easy to allow Skillets to be executed in your tooling of choice. Skillets are meant to be stored and shared via source control repositories along with the rest of your infrastructure. This allows complex NGFW configurations and use case specific compliance checks to be executed as part of your deployment pipeline. ## Resources * [Information on building Skillets and working with the PAN-OS XML API](https://SkilletBuilder.readthedocs.io) * [Example Skillets](https://github.com/PaloAltoNetworks/skilletlib/tree/master/example_skillets) * [PAN-OS XML Quickstart](https://strata.pan.dev/docs/apis/xmlapi_qs) * [PAN-OS Exploring the API](https://docs.paloaltonetworks.com/pan-os/9-0/pan-os-panorama-api/get-started-with-the-pan-os-xml-api/explore-the-api.html) ## Installation Skilletlib is distributed as a python shared library on [pypi.org](https://pypi.org/project/skilletlib/). ```bash pip install skilletlib ``` ## Example Loading a Skillet ```python from skilletlib import SkilletLoader # init SkilletLoader Class sl = SkilletLoader() # Load the skillet found in the current directory skillet = sl.load_skillet_from_path('.') # Every skillet requires a context, which is a dict containing # any user-input or other variables to allow customization. context = dict() # In this example, our skillet needs a configuration.xml file to be loaded into a variable # called 'config' with open('config.xml', 'r') as config: context['config'] = config.read() # execute the skillet and return the results out = skillet.execute(context) # Do something interesting with the results, like print it out :-) print(out) print('all done') ``` ## Loading Skillets from a Git repository ```python from skilletlib import SkilletLoader repo_url = 'https://github.com/nembery/Skillets' repo_branch = 'develop' directory = '/var/tmp/skillets' repo_name = 'example skillets' sl = SkilletLoader() skillets = sl.load_from_git(repo_url, repo_name, repo_branch, local_dir=directory) for s in skillets: print(s.name) ``` ## using Skilletlib to find recent changes in Set CLI Format ```python import os # The Panos class is a wrapper around the XML API that provides some convience methods from skilletlib import Panos auth = { 'hostname': os.environ.get('ip_address', ''), 'api_username': os.environ.get('username', ''), 'api_password': os.environ.get('password', ''), 'debug': os.environ.get('debug', True), } device = Panos(**auth) # you can pass negative integers to the 'get_configuration' method to retrive the most to least recent # running configurations. This is very useful to finding the Set CLI or XML equivelent of GUI configuration # changes previous_config = device.get_configuration(config_source='-1') latest_config = device.get_configuration(config_source='running') # The 'generate_set_cli_from_configs' method returns the difference between two config files. In this case, # we'll use the running config and the most recent running config audit backup. This will give us all the # changes made via the most recent commit in Set CLI format cmds = device.generate_set_cli_from_configs(previous_config, latest_config) for cmd in cmds: print(cmd) ``` ## Other projects that use Skilletlib Here are a couple of examples of other projects that use skilletlib * [Panhandler](https://github.com/PaloAltoNetworks/panhandler/) Panhandler is a tool to manage collections of Skillets and their respective git repositories * [SLI](https://gitlab.com/panw-gse/as/sli) SLI is a CLI interface to Skilletlib. This tool allows rapid testing and prototyping of Skillets * [SkilletLoader](https://github.com/nembery/skilletLoader/) SkilletLoader is a tool to load and test skillets in a CI/CD pipeline via Docker * [Ansible Skillets](https://github.com/PaloAltoNetworks/panw-gse.skillets) Ansible roles and libraries for loading PAN-OS and related skillets via Ansible playbooks * [Demisto XSOAR Integration](https://github.com/nembery/content/tree/skilletlib/Packs/skilletlib) Experimental in development Demisto XSOAR integration ## Other utilities in Skilletlib Skilletlib also includes a collection of tools and methods called '[Panoply](https://www.merriam-webster.com/dictionary/panoply)' which eases working with emphemeral PAN-OS and Panorama devices, such as in a CI/CD Pipeline or development environment. ## Support Community Supported The software and templates in the repo are released under an as-is, best effort, support policy. This software should be seen as community supported and Palo Alto Networks will contribute our expertise as and when possible. We do not provide technical support or help in using or troubleshooting the components of the project through our normal support options such as Palo Alto Networks support teams, or ASC (Authorized Support Centers) partners and backline support options. The underlying product used (the VM-Series firewall) by the scripts or templates are still supported, but the support is only for the product functionality and not for help in deploying or using the template or script itself. Unless explicitly tagged, all projects or work posted in our GitHub repository (at https://github.com/PaloAltoNetworks) or sites other than our official Downloads page on https://support.paloaltonetworks.com are provided under the best effort policy. %package help Summary: Development documents and examples for skilletlib Provides: python3-skilletlib-doc %description help # Skilletlib Base Classes and Utilities for working with Skillets in Python 3.7+. Skilletlib encapsulates all the logic necessary to execute a skillet in your app or tooling. See [here](https://live.paloaltonetworks.com/t5/Skillet-District/ct-p/Skillets) for information about Skillets and what skillets may be available. ## About Skillets Skillets are designed to be sharable units of configuration or validation data. They are perfectly suited for 'Compliance as Code' or 'Infrastructure as Code' type environments. All the 'knowledge' of doing a thing is encapsulated in the skillet. Skillets strive to be tooling agnostic. A subject matter expert should not have to define best practices in multiple domain specific languages. Ideally, this should be expressed once, and executed in a variety of tools. Skilletlib makes it easy to allow Skillets to be executed in your tooling of choice. Skillets are meant to be stored and shared via source control repositories along with the rest of your infrastructure. This allows complex NGFW configurations and use case specific compliance checks to be executed as part of your deployment pipeline. ## Resources * [Information on building Skillets and working with the PAN-OS XML API](https://SkilletBuilder.readthedocs.io) * [Example Skillets](https://github.com/PaloAltoNetworks/skilletlib/tree/master/example_skillets) * [PAN-OS XML Quickstart](https://strata.pan.dev/docs/apis/xmlapi_qs) * [PAN-OS Exploring the API](https://docs.paloaltonetworks.com/pan-os/9-0/pan-os-panorama-api/get-started-with-the-pan-os-xml-api/explore-the-api.html) ## Installation Skilletlib is distributed as a python shared library on [pypi.org](https://pypi.org/project/skilletlib/). ```bash pip install skilletlib ``` ## Example Loading a Skillet ```python from skilletlib import SkilletLoader # init SkilletLoader Class sl = SkilletLoader() # Load the skillet found in the current directory skillet = sl.load_skillet_from_path('.') # Every skillet requires a context, which is a dict containing # any user-input or other variables to allow customization. context = dict() # In this example, our skillet needs a configuration.xml file to be loaded into a variable # called 'config' with open('config.xml', 'r') as config: context['config'] = config.read() # execute the skillet and return the results out = skillet.execute(context) # Do something interesting with the results, like print it out :-) print(out) print('all done') ``` ## Loading Skillets from a Git repository ```python from skilletlib import SkilletLoader repo_url = 'https://github.com/nembery/Skillets' repo_branch = 'develop' directory = '/var/tmp/skillets' repo_name = 'example skillets' sl = SkilletLoader() skillets = sl.load_from_git(repo_url, repo_name, repo_branch, local_dir=directory) for s in skillets: print(s.name) ``` ## using Skilletlib to find recent changes in Set CLI Format ```python import os # The Panos class is a wrapper around the XML API that provides some convience methods from skilletlib import Panos auth = { 'hostname': os.environ.get('ip_address', ''), 'api_username': os.environ.get('username', ''), 'api_password': os.environ.get('password', ''), 'debug': os.environ.get('debug', True), } device = Panos(**auth) # you can pass negative integers to the 'get_configuration' method to retrive the most to least recent # running configurations. This is very useful to finding the Set CLI or XML equivelent of GUI configuration # changes previous_config = device.get_configuration(config_source='-1') latest_config = device.get_configuration(config_source='running') # The 'generate_set_cli_from_configs' method returns the difference between two config files. In this case, # we'll use the running config and the most recent running config audit backup. This will give us all the # changes made via the most recent commit in Set CLI format cmds = device.generate_set_cli_from_configs(previous_config, latest_config) for cmd in cmds: print(cmd) ``` ## Other projects that use Skilletlib Here are a couple of examples of other projects that use skilletlib * [Panhandler](https://github.com/PaloAltoNetworks/panhandler/) Panhandler is a tool to manage collections of Skillets and their respective git repositories * [SLI](https://gitlab.com/panw-gse/as/sli) SLI is a CLI interface to Skilletlib. This tool allows rapid testing and prototyping of Skillets * [SkilletLoader](https://github.com/nembery/skilletLoader/) SkilletLoader is a tool to load and test skillets in a CI/CD pipeline via Docker * [Ansible Skillets](https://github.com/PaloAltoNetworks/panw-gse.skillets) Ansible roles and libraries for loading PAN-OS and related skillets via Ansible playbooks * [Demisto XSOAR Integration](https://github.com/nembery/content/tree/skilletlib/Packs/skilletlib) Experimental in development Demisto XSOAR integration ## Other utilities in Skilletlib Skilletlib also includes a collection of tools and methods called '[Panoply](https://www.merriam-webster.com/dictionary/panoply)' which eases working with emphemeral PAN-OS and Panorama devices, such as in a CI/CD Pipeline or development environment. ## Support Community Supported The software and templates in the repo are released under an as-is, best effort, support policy. This software should be seen as community supported and Palo Alto Networks will contribute our expertise as and when possible. We do not provide technical support or help in using or troubleshooting the components of the project through our normal support options such as Palo Alto Networks support teams, or ASC (Authorized Support Centers) partners and backline support options. The underlying product used (the VM-Series firewall) by the scripts or templates are still supported, but the support is only for the product functionality and not for help in deploying or using the template or script itself. Unless explicitly tagged, all projects or work posted in our GitHub repository (at https://github.com/PaloAltoNetworks) or sites other than our official Downloads page on https://support.paloaltonetworks.com are provided under the best effort policy. %prep %autosetup -n skilletlib-1.2.5 %build %py3_build %install %py3_install install -d -m755 %{buildroot}/%{_pkgdocdir} if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi pushd %{buildroot} if [ -d usr/lib ]; then find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst fi if [ -d usr/lib64 ]; then find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst fi if [ -d usr/bin ]; then find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst fi if [ -d usr/sbin ]; then find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst fi touch doclist.lst if [ -d usr/share/man ]; then find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst fi popd mv %{buildroot}/filelist.lst . mv %{buildroot}/doclist.lst . %files -n python3-skilletlib -f filelist.lst %dir %{python3_sitelib}/* %files help -f doclist.lst %{_docdir}/* %changelog * Thu Jun 08 2023 Python_Bot - 1.2.5-1 - Package Spec generated