A command-line tool to run programs seamlessly behind a proxy.
Project description
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. Write a test to show your bug was fixed or the feature works as expected.
1.0.0
Original open source release