INSTALL

On Unix-like Systems:
####################

You can download latest pacparser source code tarball from:
  https://github.com/pacparser/pacparser/releases

You can also get the latest source code from github (git) repository by
following instructions at:
  https://github.com/pacparser/pacparser

* pacparser C library and pactester:
  ----------------------------------
  Compiling and installing pacparser is as easy as running the following
  commands:
     => make -C src
     => sudo make -C src install

* pacparser python module:
  ------------------------------------------------
  To compile and install pacparser python module:
    => make -C src pymod
    => sudo make -C src install-pymod

  If it failed with runtests.py when building on non interconnected hosts like this;
  ```
    File "../tests/runtests.py", line 79, in runtests
    raise Exception('Tests failed. Got "%s", expected "%s"' % (result, expected_result))
  Exception: Tests failed. Got "END-OF-SCRIPT", expected "isResolvable"
  ```
  Please set an environment variable NO_INTERNET. Then it won't require internet and pass the test.
  ```
  $ export NO_INTERNET=1 && make -C src install-pymod
  ```
  
On Win-32 Systems:
#################

Binary Distribution:
===================

Compiled packages for win32 systems can be downloaded from:
https://github.com/pacparser/pacparser/releases

* C Library and pactester:
  -----------------------
To install pacparser C library and pactester, download package
"pacparser-v.v.v-win32.zip" and extract it somewhere on your machine. It will
create a directory - "pacparser-v.v.v". Copy pacparser.dll and pactester.exe
binaries to somewhere on the system where system can find them (e.g. to the
directories that are already in system path like C:\Windows) or simply add
pacparser directory to the system path.

You'll need pacparser.lib to link in pacparser on Visual Studio/C++. On mingw,
you can directly link with pacparser.dll. Here are the detailed instructions to link in pacparser on Visual Studio:
http://code.google.com/p/pacparser/wiki/LinkingOnVisualStudio.

* Python Module
  -------------
To install pacparser python module (available only for Python 2.7 right now),
download package pacparser-python27-v.v.v-win32.zip and extract it somewhere
on your system. To install the module in you PYTHONPATH, simply run install.py
that comes with the compiled binaries.

If it fails for some reason, simply copy "pacparser" sub-directory to
C:\Python27\Lib\site-packages\ and you are done.

Compiling from Source Code:
==========================

Compiling pacparser for Windows is a rather involved process and is documented
in detail in README.win32 file included with this package.