proxy-toggle 1.0.2

A command-line tool to run programs seamlessly behind a proxy.

A command-line tool to run programs seamlessly behind a proxy.

Introduction

Many corporate networks use proxies both for network protection and to cache often-used content. This command-line tool allows you to run programs behind a corporate proxy without the need to constantly set/unset proxy environment variables. It sets the environment variables only when needed and unsets them whenever the program finished its execution. Currently, proxy-toggle only supports Basic Access Authentication as the authentication scheme to the proxy.

Installation

To use proxy-toggle:

$ pip install proxy-toggle

Head over to pip-installer for instructions on installing pip.

To run from source, you can download the source code for proxy-toggle, and then run:

$ python setup.py install

Usage

Before you can start using proxy-toggle, you must initialize the application:

$ px --init

This will prompt for your proxy settings: proxy server URL and user account/password. A secure keyring (to encrypt the password) will be generated. This might take a while.

After successful initialization, run:

$ px <program>

If your proxy doesn’t require user authentication, run it with --nouser option:

$ px --nouser <program>

When you want to renew your proxy password, run it with --renew option:

$ px --renew

Examples

$ px git clone https://github.com/beylsp/proxy-toggle

$ px --nouser wget https://github.com/beylsp/archive/master.zip

Contributing

We love contributions. If you’ve found a bug in the tool or would like new features added, go ahead and open issues or pull requests against this repo.

1.0.0

Original open source release

1.0.1

Unstable release

1.0.2

First stable release