Skip to main content

This is an troubleShooting Framework Package

Project description


TroubleShooting Framework is a generic open source test-analysis-fix automation framework for troubleshooting. TroubleShooting Framework is operating system and application independent. The core framework is implemented using Python, supports Python 2.6 and Python 2.7, and run also on Jython,IronPython and Pypy. TroubleShooting Framework project is hosted on GitHub where you can find source code, an issue tracker, and some further documentation.

Latest version License


If you already have Python with PIP installed,you can simply run:

pip install troubleshooting-framework

Alternatively you can get TroubleShooting Framework source code by downloading the source distribution from PyPI and extracting it, or by cloning the project repository from GitHub. After that you can install the framework with:

python install

A benefit of using pip is that it automatically installs paramiko and PyCrypto modules that troubleshooting-framework requires on Python. Using pip on Windows with Python works too, but you need to first install PyCrypto module manually.


1. Create a project

you can simply run:

pytsmgr --operation=startProject --project=<MyProject> --directory=<ProjectDirectory>

2. Add a keyword

new a <keywordName>.py file in <ProjectDirectory>/<MyProject>/keywords folder:

from troubleshooting.framework.template._BaseKeyword import _BaseKeyword

class keywordName(_BaseKeyword):
def __init__(self):


def getExample(self):

return “example”

3. Add a testpoint

new a <testPointName>.py file in <ProjectDirectory>/<MyProject>/testpoint folder:

from framework.variable.variable import STATUS,LEVEL

from troubleshooting.framework.template._BaseTestPoint import _BaseTestPoint

class testPointName(_BaseTestPoint):
def __init__(self):


self.level = LEVLE.CRITICAL

def _checkpoint(self):

result = self.getExample()

if result is “example”:

self.status = STATUS.PASS


self.status = STATUS.FAIL self.IMPACT.append(“system is not working”) self.RCA.append(“Bad luck”) self.FIXSTEP.append(“bathing”) self.FIXSTEP.append(“say hello god!”)

Note: self.status is mandatory, it’s enum type , value is STATUS.PASS or STATUS.FAIL

Note: self.level is option, it’s enum type , value is LEVLE.CRITICAL or LEVLE.NOCRITICAL , default is LEVLE.NOCRITICAL

Note: self.IMPACT , self.RCA and self.FIXSTEP is option, it’s list type.

4. Add a case

new a <caseName>.py file in <ProjectDirectory>/<MyProject>/case folder:

from troubleshooting.framework.template._BaseCase import _BaseCase

class caseName(_BaseCase):

“”” To Check linux disk usage. “””

def __init__(self):


self.passCondition = “{testPointName} is True”

self.tags = “example goodcase”

Note: self.passCondition is mandatory, it’s condition of case pass.

Note: self.tags is option, it’s a string and fragment by space.


Switch folder to <ProjectDirectory>/<MyProject>/ , you can simple run:

pyts --host=  --user=root --password=root  --include=exampleANDsmoke --exclude=NoRunORdisable

Support And Contact:


TroubleShooting Framework is open source software provided under the Apache License 2.0. TroubleShooting Framework documentation and other similar content use the Creative Commons Attribution 3.0 Unported license. Most libraries and tools in the ecosystem are also open source, but they may use different licenses. ^

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

troubleshooting-framework- (150.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page