Skip to content

Latest commit

 

History

History
73 lines (48 loc) · 2.11 KB

README.md

File metadata and controls

73 lines (48 loc) · 2.11 KB

Exscript

Summary

Exscript is a Python module and a template processor for automating network connections over protocols such as Telnet or SSH. We attempt to create the best possible set of tools for working with Telnet and SSH.

Exscript also provides a set of tools and functions for sysadmins, that simplify regular expression matching, reporting by email, logging, or syslog handling, CSV parsing, ip address handling, and many more.

Exscript may be used to automate sessions with routers from Cisco, Juniper, OneAccess, Huawei, or any others. If you want to configures machines running Linux/Unix, IOS, IOS-XR, JunOS, VRP, or any other operating system that can be used with a terminal, Exscript should be just what you are looking for.

The Exscript template language is also in some ways comparable to Expect, but has some unique features that make it a lot easier to use and understand for non-developers.

Method 1: Using Exscript with Python

from Exscript.util.start import start
from Exscript.util.file import get_hosts_from_file
from Exscript.util.file import get_accounts_from_file

def do_something(job, host, conn):
    conn.execute('uname -a')

accounts = get_accounts_from_file('accounts.cfg')
hosts = get_hosts_from_file('myhosts.txt')
start(accounts, hosts, do_something, max_threads=2)

Check out the Python tutorial:

https://github.com/knipknap/exscript/wiki/Python-API-Tutorial

Method 2: Using the Exscript command line tool

Create a file named test.exscript with the following content:

uname -a

To run this Exscript template, just start Exscript using the following command:

exscript test.exscript ssh://localhost

Awesome fact: Just replace ssh:// by telnet:// and it should still work with Telnet devices.

Documentation

Full documentation is here:

https://github.com/knipknap/exscript/wiki

Installation

Simply follow the installation guide.

Dependencies

  • Python >=2.6 , <=2.7 (we are working on Python 3 support)
  • Python-crypto
  • Paramiko