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.
1.0.0
Original open source release
1.0.1
Unstable release
1.0.2
First stable release
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.