trigger 2.0.0__py3-none-any.whl

trigger-2.0.0.dist-info/METADATA

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: trigger
+Version: 2.0.0
+Summary: Network automation toolkit for managing network devices
+Author-email: Jathan McCollum <jathan@gmail.com>
+License-Expression: BSD-3-Clause
+Classifier: Development Status :: 6 - Mature
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Framework :: Twisted
+Requires-Python: <3.12,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+License-File: AUTHORS.md
+Requires-Dist: IPy>=1.01
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: Twisted>=22.10.0
+Requires-Dist: crochet>=2.0.0
+Requires-Dist: pyasn1>=0.4.8
+Requires-Dist: pyparsing>=3.1.0
+Requires-Dist: pytz>=2023.3
+Requires-Dist: SimpleParse>=2.2.0
+Requires-Dist: textfsm>=1.1.0
+Requires-Dist: redis>=5.0.0
+Requires-Dist: PTable>=0.9.2
+Requires-Dist: peewee>=3.17.0
+Requires-Dist: service-identity>=23.1.0
+Requires-Dist: bcrypt>=4.0.0
+Requires-Dist: packaging>=21.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-twisted>=1.14.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: python-semantic-release>=9.0.0; extra == "dev"
+Dynamic: license-file
+
+# What is Trigger?
+
+[![Tests](https://github.com/trigger/trigger/workflows/Tests/badge.svg)](https://github.com/trigger/trigger/actions)
+[![Join the chat at https://gitter.im/trigger/trigger](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/trigger/trigger?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
+Trigger is a robust network automation toolkit written in Python that was
+designed for interfacing with network devices and managing network
+configuration and security policy. It increases the speed and efficiency of
+managing large-scale networks while reducing the risk of human error.
+
+Started by the AOL Network Security team in 2006, Trigger was originally
+designed for security policy management on firewalls, routers, and switches. It
+has since been expanded to be a full-featured network automation toolkit.
+
+With the high number of network devices on the AOL network this application is
+invaluable to performance and reliability. We hope you'll find it useful on
+your network and consider participating!
+
+## Supported Platforms
+
+* Cisco IOS, NX-OS, and ASA software
+* Juniper Junos and ScreenOS
+* Force10 router and switch platforms running FTOS
+* Arista Networks 7000-family switches
+* ... and more!
+
+Refer to the [official docs](https://trigger.readthedocs.io/en/latest/#supported-platforms) for the full list.
+
+## Key Features
+
+Trigger is designed to work at scale and can support hundreds or thousands of
+network devices with ease. Here are some of things that make Trigger tick:
+
++ Support for SSH, Telnet, and Juniper's Junoscript XML API.
++ Easily get an interactive shell or execute commands asynchronously.
++ Leverage advanced event-driven functionality to manage any number of
+  jobs in parallel and handle output or errors as they return.
++ Powerful metadata interface for performing complex queries to group and
+  associate network devices by name, manufacturer, type, location, and more.
++ Encrypted storage of login credentials so you can interact without constantly
+  being prompted to enter your password.
++ Flexible access-list & firewall policy parser that can test access if access
+  is permitted, or easily convert ACLs from one format to another.
++ Detailed support for timezones and maintenance windows.
++ A suite of tools for simplifying many common tasks.
+
+New in version 1.2:
+
++ Import your metadata from an existing [RANCID](http://shrubbery.net/rancid/) installation to get up-and-running quickly!
+
+New in version 1.3:
+
++ Import your metadata from a CSV file and get up-and-running even quicker!
+
+## Getting Started
+
+The best way to get started is to read the documentation hosted by [Read the
+Docs](http://readthedocs.org) at [https://trigger.readthedocs.io](https://trigger.readthedocs.io). There you will find everything you need to
+get going including usage examples, installation and configuration
+instructions, and more!
+
+### Python Version Requirements
+
+**Trigger v2.0.0+** requires **Python 3.10 or 3.11**. Python 3.12+ is not yet supported due to SimpleParse C extension compatibility issues.
+
+**Python 2.7 support ended with v1.6.0** (the last Python 2.7 compatible release).
+
+#### Installation
+
+```bash
+# Install the latest version
+pip install trigger
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Using uv (faster)
+uv pip install trigger
+```
+
+For users still requiring Python 2.7, use the v1.6.0 release:
+```bash
+pip install trigger==1.6.0
+```
+
+### Upgrading from v1.6.0?
+
+See the [Migration Guide](https://trigger.readthedocs.io/en/latest/migration.html) for detailed upgrade instructions.
+
+### Before you begin
+
++ The [develop](https://github.com/trigger/trigger/tree/develop) branch is
+  the default branch that will be active when you clone this repository. While
+  it is generally stable this branch is not considered production-ready. Use at
+  your own risk!
++ The [master](https://github.com/trigger/trigger/tree/master) branch is
+  the stable branch, and will reflect the latest production-ready changes. It
+  is recommended that this is the branch you use if you are installing Trigger
+  for the first time.
++ Each point release of Trigger is maintained as a [tag branch](https://github.com/trigger/trigger/tags). If you require a
+  specific Trigger version, please refer to these.
+
+### Get in touch!
+
+If you run into any snags, have questions, feedback, or just want to talk shop:
+[contact us](https://trigger.readthedocs.io/en/latest/#getting-help)!
+
+**Pro tip**: Find us on IRC at `#trigger` on Freenode
+([irc://irc.freenode.net/trigger](irc://irc.freenode.net/trigger)).

trigger-2.0.0.dist-info/RECORD

@@ -0,0 +1,61 @@
+trigger/__init__.py,sha256=154bEsu646qx3Aaj7vJyNgSfEtzPtikaHsxqa-koYOY,214
+trigger/cmds.py,sha256=eZf5uGt02-557KAJST714s0hOr_jpi_0cIMlBUEtmh0,41536
+trigger/exceptions.py,sha256=lvDGybaTlt7S_nsCFk0QFOa9EkMVeOb_BgerUuZ-yXs,7503
+trigger/gorc.py,sha256=yj8Bls1wp85LIOsokUJ3YEgHYJvcYDvG8INccKyg0oo,4654
+trigger/netscreen.py,sha256=5YrvJUb_F7S1MXg2ScHA6WpNzoX6j5rAKvhu1nBmXUM,33767
+trigger/rancid.py,sha256=ctvFVHyr2dm5W0ptMttHcAMjcUwfuj2XxhXI15hQQFk,13896
+trigger/tacacsrc.py,sha256=bVAGd0g6_tU6luZrtZ0cOYHO-EuYuQ-cffDdzx65tfM,19993
+trigger/twister.py,sha256=En9s4BwEgyGhKo-c-Fzqj7AeOF1SIQNqmMbfk0PjNaE,74324
+trigger/twister2.py,sha256=rygZVvBxsZUFxJTTvu-N87NtnRcDiXQsIdHpm3oaJl8,25212
+trigger/acl/__init__.py,sha256=k2V4YfEBJ7adN5zSJH-bSmbc73XYt1yVx5PMv8q3QAw,783
+trigger/acl/autoacl.py,sha256=iFXlZtEEwxSy1rBkbhYB-q7f90EAD40mvpaKKgoZyj0,2654
+trigger/acl/db.py,sha256=jWX116VVSFZmvB6YHww-80gTpzXA8HXQfEJBd2Jr0TM,9924
+trigger/acl/dicts.py,sha256=2RrnruLwJz3EN2zT3tNiMJfFkstYDmLk_eGjaHYaAXc,9100
+trigger/acl/grammar.py,sha256=gbkGt6lYPnNb6zzmswC5r2XEPGY9Iecf5YUzK1Shm2s,3452
+trigger/acl/ios.py,sha256=AOs_SwNDiZ6cUaY0fjOkShzxCgxBnwB7apnsf4Sde28,7714
+trigger/acl/junos.py,sha256=gBgX0U_XZtgU_04A6-5ZhgAiS3S1TLvR3DspviOJvWg,14720
+trigger/acl/models.py,sha256=YG_OQyxK-T6ihbtTKbTm8ky8nKsR2HgQJJUa8V3KrLA,3197
+trigger/acl/parser.py,sha256=VuxiVANz0xvvS5-wRw6snkoAGZS1asm3z9n-Ud0u5-c,4490
+trigger/acl/queue.py,sha256=eft8IN93m1Jd81CvtIjjMnTnL-DAHor_sB8LOfua_20,8639
+trigger/acl/support.py,sha256=4YGW9EDknwgkYYk05ucipWB8LyVkSWcSvjxsL-re1TQ,47470
+trigger/acl/tools.py,sha256=u84Zj0an_J7BdfFS6i0nutDF7E9v7BiZITRkpUTYMlU,23724
+trigger/bin/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+trigger/bin/acl.py,sha256=ipSs_NXgpOvsExjUVIFmH3rdpt0grcykxKYFtFgn37Q,6705
+trigger/bin/acl_script.py,sha256=yirMn171ifWWOuk6DMrGYnwlpUM0y3WUhdXGK1cw7jw,18210
+trigger/bin/aclconv.py,sha256=2EeBLlBusmYP4tzIjPGK2tlWveBlplpAjobF-wMbvI0,2241
+trigger/bin/check_access.py,sha256=Nk1ltw5s41Xfiba1ujLJ3LWd3Ma-v3elfd59zaqIFXc,2364
+trigger/bin/check_syntax.py,sha256=OxNxSuTcYO0Smzk4IpCnibwsLY7KON_nTDRASPcb5aQ,1614
+trigger/bin/fe.py,sha256=zPq6vPHzajcYTxo7bJl5L7LhKbfDY4_mdpaWE9MKKx4,6173
+trigger/bin/find_access.py,sha256=mm1Yr77ZkFHCud1PzcyLMukwgc7csiih-mkXt5Ylu2U,5414
+trigger/bin/gnng.py,sha256=IetWGKMy7CyS_SDia7jewjR6APJRNJ5yv1M5a7raEMY,11740
+trigger/bin/gong.py,sha256=yvGY8rnhPbZ5yxcAfIGg-oyX4u6CKBy4ZDnPtg3o5bw,2163
+trigger/bin/load_acl.py,sha256=kGgf_hpd-LXhCxZD-Nsfga8czGue-rp2w8xE0Mx0nHU,26985
+trigger/bin/load_config.py,sha256=XaxWLHic-UwThi-kEjlPdjbq1DLf9FKRDM9ggHwuWjQ,351
+trigger/bin/netdev.py,sha256=G1L911c9aFC70j6DNRvvjhx9sKr2pSNUVzPMVPYMvE4,8821
+trigger/bin/optimizer.py,sha256=lcCn8pOtGgHYVWCBtrAIF8XRlyoq0rTGX-7ItS3hOAc,17820
+trigger/bin/run_cmds.py,sha256=978IpvA3Mh1d7pK7KsAEDnAQBcf4hy2mh2v3sGCdDno,354
+trigger/changemgmt/__init__.py,sha256=9QeinKfMXQHmg91Zbtz80LXrpwhz0r2dHVSFRwdlR38,11340
+trigger/changemgmt/bounce.py,sha256=R4kA8mxsQ0_aq_c3d8TiqiyS4s52vXMpRxURtJHnsCQ,1795
+trigger/conf/__init__.py,sha256=-VJPOb_SOrVS8sb1mYus5Gv07nDcD11OHnClRsLxBLo,3111
+trigger/conf/global_settings.py,sha256=My8NYxhFwGG2OHM0NNwL4Npnknp2RGAVimDg8hD84ig,22468
+trigger/contrib/__init__.py,sha256=-CDXmrlP76rcnRYzJgzloFayXL6-JBOxFeJRk3wZRW0,129
+trigger/netdevices/__init__.py,sha256=eMYRFJf1P038gNZrZat-911mWX1gP1pBJxCdqbn7iKo,42169
+trigger/netdevices/loader.py,sha256=53A-RbJDluYt7ZX27q_1Zzi7mpRY5HOHfibTEvg84KI,5854
+trigger/packages/__init__.py,sha256=AiAjoqy2HHAetDIq0WopWa-YcB8EhuUEFrsle_Z-808,191
+trigger/packages/peewee.py,sha256=bbh0_O7_b0IfTNH7u-UDKzfbW4-oC-V2AHZx3AJH7Zk,277280
+trigger/utils/__init__.py,sha256=DBLxL_JCBKq6KDB-KnO_D3RZNmGz8491Qotr1NEBX90,2244
+trigger/utils/cli.py,sha256=Z76h72g8Q3ljetWA8shLeb3CMoF6n2edlxiJORxtElo,10466
+trigger/utils/importlib.py,sha256=r8JeIrKFjleBuJT_mS1PG1XpKQyi1OWmDX7dpnwY-jM,2280
+trigger/utils/network.py,sha256=4DQeq_CMrliAa-ENF8Y-brM8S6cJ3DhgD95oMJKrqUM,3858
+trigger/utils/rcs.py,sha256=jB_qBqfDAZRfQxRwL3oRZcznqoLl7gsgyXQb7mEbu-U,4803
+trigger/utils/templates.py,sha256=0gbFmgzna74q9PDd6OcM8QMwJZzYz1gis3wZsOVcAc4,1957
+trigger/utils/url.py,sha256=-ziDnNcAvYP0vHu8_p1rZlzluDrWOmuQpMMDyl8zjVU,2041
+trigger/utils/xmltodict.py,sha256=ZKVzDwX7dT_5qrGxwZYKrB_FPdcU8Abs60kn5pdyKB0,9384
+trigger-2.0.0.dist-info/licenses/AUTHORS.md,sha256=hm1qgRgs74WmWYmIboWm9tjxqEM_xQQRX5nWoMffk3E,750
+trigger-2.0.0.dist-info/licenses/LICENSE.md,sha256=jYSVs3QOgMIPqM7q9_XqYiRc_ePdk2OFOPGOm36CvEE,1493
+twisted/plugins/trigger_xmlrpc.py,sha256=3UlSxH4nYIUI85k7KHapAcPrdZFJJJ6hfAtIeHfJMSo,3742
+trigger-2.0.0.dist-info/METADATA,sha256=zDtmv_CbQVX0Ol6bx6HpRpb-AEZ7q-WKzpCzZG7x57Y,5844
+trigger-2.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+trigger-2.0.0.dist-info/entry_points.txt,sha256=EJFGPV2HoErL-9qYDJgkW4s0C9EH-RpMZftJdCK4W68,526
+trigger-2.0.0.dist-info/top_level.txt,sha256=cBf70dFY3f8zRO1frLHpQuSkxG2FCfiZKRKRZtGnMOM,16
+trigger-2.0.0.dist-info/RECORD,,

trigger-2.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

trigger-2.0.0.dist-info/entry_points.txt

@@ -0,0 +1,15 @@
+[console_scripts]
+acl = trigger.bin.acl:main
+acl_script = trigger.bin.acl_script:main
+aclconv = trigger.bin.aclconv:main
+check_access = trigger.bin.check_access:main
+check_syntax = trigger.bin.check_syntax:main
+fe = trigger.bin.fe:main
+find_access = trigger.bin.find_access:main
+gnng = trigger.bin.gnng:main
+gong = trigger.bin.gong:main
+load_acl = trigger.bin.load_acl:main
+load_config = trigger.bin.load_config:main
+netdev = trigger.bin.netdev:main
+optimizer = trigger.bin.optimizer:main
+run_cmds = trigger.bin.run_cmds:main

trigger-2.0.0.dist-info/licenses/AUTHORS.md

@@ -0,0 +1,20 @@
+# Contributors
+
+The following people have contributed to Trigger at some point during its
+lifetime:
+
+- [Jathan McCollum](https://github.com/jathanism)
+- [Eileen Watson](https://github.com/watsonator)
+- [Mark Ellzey Thomas](https://github.com/ellzey)
+- Michael Shields
+- Jeff Sullivan (for the best error message ever)
+- [Nick Sinopoli](https://github.com/NSinopoli) (for graciously giving us the
+  name Trigger!)
+- [Jason Long](https://github.com/sh0x)
+- [Michael Harding](https://github.com/mvh)
+- William White
+- [Allan Feid](https://github.com/crazed)
+- [Mike Biancaniello](https://github.com/chepazzo)
+- [Murat Ezbiderli](https://github.com/mezbiderli)
+- [Johannes Erdfelt](https://github.com/jerdfelt)
+- [Codey Oxley](https://github.com/coxley)

trigger-2.0.0.dist-info/licenses/LICENSE.md

@@ -0,0 +1,28 @@
+# License
+
+Copyright (c) 2006-2012, AOL Inc.
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+* Neither the name of the AOL Inc. nor the names of its contributors may
+  be used to endorse or promote products derived from this software without
+  specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

trigger-2.0.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+trigger
+twisted

twisted/plugins/trigger_xmlrpc.py

@@ -0,0 +1,124 @@
+# -*- coding: utf-8 -*-
+
+"""
+# trigger_xmlrpc.py - Twisted twistd server plugin for Trigger
+"""
+
+import warnings
+
+from twisted.application.internet import TCPServer, SSLServer
+from twisted.application.service import IServiceMaker, MultiService
+from twisted.conch.manhole_tap import makeService as makeConsoleService
+from twisted.plugin import IPlugin
+from twisted.python.rebuild import rebuild
+from twisted.python import usage
+from twisted.web import server, xmlrpc
+
+try:
+    from twisted.internet import ssl
+except ImportError:
+    # If no ssl, complain loudly.
+    warnings.warn(
+        "SSL support disabled for Trigger XMLRPC Server: PyOpenSSL required.",
+        RuntimeWarning,
+    )
+    ssl = None
+from zope.interface import implements
+
+from trigger.contrib.xmlrpc.server import TriggerXMLRPCServer
+
+
+# Defaults
+XML_PORT = 8000
+SSH_PORT = 8001
+SSH_USERS = "users.txt"
+SSL_KEYFILE = "server.key"
+SSL_CERTFILE = "cacert.pem"
+SSH_KEYDIR = "."
+SSH_KEYNAME = "ssh_host_key"
+SSH_KEYSIZE = 4096
+LISTEN_ADDRESS = "0.0.0.0"
+
+
+class Options(usage.Options):
+    optParameters = [
+        ["listen-address", "a", LISTEN_ADDRESS, "Address to listen on"],
+        ["port", "p", XML_PORT, "Listening port for XMLRPC"],
+        ["ssh-port", "s", SSH_PORT, "Listening port for SSH manhole"],
+        [
+            "ssh-users",
+            "u",
+            SSH_USERS,
+            "Path to a passwd(5)-format username/password file",
+        ],
+        ["ssl-keyfile", "k", SSL_KEYFILE, "Path to a file containing a private key"],
+        [
+            "ssl-certfile",
+            "c",
+            SSL_CERTFILE,
+            "Path to a file containing a CA certificate",
+        ],
+        [
+            "ssh-keydir",
+            "d",
+            SSH_KEYDIR,
+            "The folder that the SSH server key will be kept",
+        ],
+        ["ssh-keyname", "n", SSH_KEYNAME, "The filename of the key."],
+        ["ssh-keysize", "z", SSH_KEYSIZE, "The size of the key, in bits."],
+    ]
+
+
+class TriggerXMLRPCServiceMaker(object):
+    implements(IServiceMaker, IPlugin)
+    tapname = "trigger-xmlrpc"
+    description = "Trigger XMLRPC Server"
+    options = Options
+
+    def makeService(self, options):
+        rpc = TriggerXMLRPCServer(allowNone=True, useDateTime=True)
+        xmlrpc.addIntrospection(rpc)
+        site_factory = server.Site(rpc)
+
+        # Try to setup SSL
+        if ssl is not None:
+            ctx = ssl.DefaultOpenSSLContextFactory(
+                options["ssl-keyfile"], options["ssl-certfile"]
+            )
+            xmlrpc_service = SSLServer(
+                int(options["port"]),
+                site_factory,
+                ctx,
+                interface=options["listen-address"],
+            )
+        # Or fallback to clear-text =(
+        else:
+            xmlrpc_service = TCPServer(
+                int(options["port"]), site_factory, interface=options["listen-address"]
+            )
+
+        # SSH Manhole service
+        console_service = makeConsoleService(
+            {
+                "sshPort": "tcp:%s:interface=%s"
+                % (options["ssh-port"], options["listen-address"]),
+                "sshKeyDir": options["ssh-keydir"],
+                "sshKeyName": options["ssh-keyname"],
+                "sshKeySize": options["ssh-keysize"],
+                "telnetPort": None,
+                "passwd": options["ssh-users"],
+                "namespace": {
+                    "service": rpc,
+                    "rebuild": rebuild,
+                    "factory": site_factory,
+                },
+            }
+        )
+
+        svc = MultiService()
+        xmlrpc_service.setServiceParent(svc)
+        console_service.setServiceParent(svc)
+        return svc
+
+
+serviceMaker = TriggerXMLRPCServiceMaker()