Configuring PRAW
****************

* Configuration Options

  * Basic Configuration Options

  * OAuth Configuration Options

  * Reddit Site Configuration Options

  * Custom Configuration Options

Configuration options can be provided to PRAW in one of three ways:

* praw.ini Files

* Keyword Arguments to "Reddit"

* PRAW Environment Variables

Environment variables have the highest priority, followed by keyword
arguments to "Reddit", and finally settings in "praw.ini" files.


Using an HTTP or HTTPS proxy with PRAW
======================================

PRAW internally relies upon the requests package to handle HTTP
requests. Requests supports use of "HTTP_PROXY" and "HTTPS_PROXY"
environment variables in order to proxy HTTP and HTTPS requests
respectively [ref].

Given that PRAW exclusively communicates with Reddit via HTTPS, only
the "HTTPS_PROXY" option should be required.

For example, if you have a script named "prawbot.py", the
"HTTPS_PROXY" environment variable can be provided on the command line
like so:

   HTTPS_PROXY=https://localhost:3128 ./prawbot.py
