Skip to main content
Help us improve Python packaging – donate today!

tools for your toolbox , neatly organised

Project Description

Toolbox

Documentation Status

What is Toolbox ?

Toolbox is a framework to manage a collection of tools. A tool can be anything from a shell script to a python package.

Basically toolbox extends the python argparse.ArgumentParser to enable importing tools from multiple locations in a single executable. Toolbox provides some easy default tools to create , install, uninstall or list (available) tools.

A custom tool needs to implement 2 methods: * prepare_parser : which prepares an argparse.ArgumentParser * execute : which is the main entry point of your tool

Besides the wrapper around argument parsing toolbox as a framework provides some easy to add extra’s like persisted configuration, usage of tools within tools and no-configuration logging.

An example of a custom tool:

from toolbox.plugin import ToolboxPlugin
from toolbox.mixins import RegistryMixin, ConfigMixin, LogMixin

class CustomPlugin(RegistryMixin, ConfigMixin, LogMixin, ToolboxPlugin)
        name = "custom"
        description = "This is a custom plugin that prints a string"

        def prepare_parser(self,parser):
                parser.add_argument('printable', help="string to print")

        def execute(args):
                # LogMixin
                logger = self.get_logger()
                logger.info("printing {}".format(args.printable)

                # ConfigMixin
                config = self.get_config()
                config['first_print'] = args.printable

                # RegistryMixin
                registry = self.get_registry()
                other_plugin = registry.get_plugin('other')

                print(args.printable)

For more info on all the tools the toolbox framework provides check the complete documentation!

Features

  • Integrate your own shell scripts etc. with a single command
  • Easily integrate your existing python tools with toolbox by wrapping them in ToolboxPlugin class
  • Add persisted configuration to your tools
  • Use other tools within your own tools
  • search tools in the toolbox
  • install other tools from PyPI/github with the toolbox commandline

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

0.5.0 (2016-01-02)

  • added logs tool
  • added tests for the registry , scanner and config

0.4.0 (2016-01-01)

  • First stable release on PyPI.

Release history Release notifications

This version
History Node

0.5.1

History Node

0.5.0

History Node

0.4.0

History Node

0.3.9

History Node

0.3.8

History Node

0.3.7

History Node

0.3.6

History Node

0.3.5

History Node

0.3.4

History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

History Node

0.3.0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
tool_box-0.5.1-py2.py3-none-any.whl (25.5 kB) Copy SHA256 hash SHA256 Wheel 3.4 Jan 3, 2016
tool-box-0.5.1.tar.gz (26.4 kB) Copy SHA256 hash SHA256 Source None Jan 3, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page