"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "README.md" between
pacparser-1.3.8.tar.gz and pacparser-1.3.9.tar.gz

About: pacparser is a library to parse Proxy Auto-Config (PAC) files (incl. a pactester).

README.md  (pacparser-1.3.8):README.md  (pacparser-1.3.9)
[![Build Status](https://travis-ci.org/manugarg/pacparser.svg?branch=master)](ht [![Build Status](https://github.com/manugarg/pacparser/actions/workflows/build.y
tps://travis-ci.org/manugarg/pacparser) ml/badge.svg)](https://github.com/manugarg/pacparser/actions/workflows/build.yml
[![Build status](https://ci.appveyor.com/api/projects/status/uvct988e0jx991x3?sv )
g=true)](https://ci.appveyor.com/project/manugarg/pacparser) [![PyPI version](https://badge.fury.io/py/pacparser.svg)](https://badge.fury.io/
py/pacparser)
# [Pacparser](http://pacparser.github.io) # [Pacparser](http://pacparser.manugarg.com)
***[pacparser.github.io](http://pacparser.github.io)*** ***[pacparser.manugarg.com](http://pacparser.manugarg.com)***
pacparser is a library to parse proxy auto-config (PAC) files. Proxy auto-config Pacparser is a library to parse proxy auto-config (PAC) files. Proxy auto-config
files are a vastly used proxy configuration method these days. Web browsers can files are a vastly used proxy configuration method these days. Web browsers can
use a PAC file to determine which proxy server to use or whether to go direct use a PAC file to determine which proxy server to use or whether to go direct
for a given URL. PAC files are written in JavaScript and can be programmed to for a given URL. PAC files are written in JavaScript and can be programmed to
return different proxy methods (e.g., `"PROXY proxy1:port; DIRECT"`) depending return different proxy methods (e.g., `"PROXY proxy1:port; DIRECT"`) depending
upon URL, source IP address, protocol, time of the day etc. PAC files introduce upon URL, source IP address, protocol, time of the day etc. PAC files introduce
a lot of possibilities. Please look at the wikipedia entry for Proxy auto-config a lot of possibilities. Please look at the wikipedia entry for Proxy auto-config
(<http://en.wikipedia.org/wiki/Proxy_auto-config>) for more information. (<http://en.wikipedia.org/wiki/Proxy_auto-config>) for more information.
Needless to say, PAC files are now a widely accepted method for proxy The idea behind pacparser is to make it easy to add PAC-file parsing capability
configuration management and companies all over are using them in corporate to any program (C and python supported right now). It comes as a shared C librar
environment. Almost all popular web browsers support PAC files. The idea behind y
pacparser is to make it easy to add this PAC file parsing capability to any and a python module which can be used to make any C or python program PAC script
program (C and python supported right now). It comes as a shared C library and s
a python module which can be used to make any C or python program PAC scripts
intelligent. Some very useful targets could be popular web software like wget, intelligent. Some very useful targets could be popular web software like wget,
curl and python-urllib. curl and python-urllib.
### Implementation ### Implementation
pacparser makes use of Mozilla's JavaScript interpreter SpiderMonkey to parse Pacparser makes use of the Mozilla's JavaScript interpreter SpiderMonkey to pars e
PAC files (which are nothing but javascripts). Apart from that, proxy PAC files (which are nothing but javascripts). Apart from that, proxy
auto-config standard assumes availability of some functions which are not auto-config standard assumes availability of some functions which are not
part of standard JavaScript. pacparser uses Mozilla's PAC implementation to part of the standard JavaScript. Pacparser uses Mozilla's PAC implementation to
define all these functions except couple of dns functions which are defined by define all these functions except couple of dns functions which are defined by
pacparser itself. As a result, pacparser is as close to standard as it gets :) pacparser itself. As a result, pacparser is as close to standard as it gets :)
### Install ### Install
Please see 'INSTALL' in the root directory of the package. Please see 'INSTALL' in the root directory of the package.
### How to use it? ### How to use it?
Pacparser comes as a shared library (libpacparser.so on Unix-like systems Pacparser comes as a shared library (`libpacparser.so` on Linux, `libpacparser.d
and pacparser.dll on windows) as well as a python module. Using it is as easy ylib`
compiling your C programs against it or importing pacparser module in your on MacOS, and pacparser.dll on windows) as well as a python module. Using it is
as
easy compiling your C programs against it or importing pacparser module in your
python programs. python programs.
### Usage Examples ### Usage Examples
#### Python: #### Python:
```python ```python
>>> import pacparser >>> import pacparser
>>> pacparser.init() >>> pacparser.init()
>>> pacparser.parse_pac('examples/wpad.dat') >>> pacparser.parse_pac('examples/wpad.dat')
>>> pacparser.find_proxy('http://www.google.com', 'www.google.com') >>> pacparser.find_proxy('http://www.google.com', 'www.google.com')
skipping to change at line 90 skipping to change at line 87
manugarg@hobbiton:~$ gcc -o pactest pactest.c -lpacparser manugarg@hobbiton:~$ gcc -o pactest pactest.c -lpacparser
manugarg@hobbiton:~$ ./pactest wpad.dat http://www.google.com www.google.com manugarg@hobbiton:~$ ./pactest wpad.dat http://www.google.com www.google.com
PROXY proxy1.manugarg.com:3128; PROXY proxy2.manugarg.com:3128; DIRECT PROXY proxy1.manugarg.com:3128; PROXY proxy2.manugarg.com:3128; DIRECT
``` ```
#### Platforms #### Platforms
pacparser has been tested to work on Linux (all architectures supported by pacparser has been tested to work on Linux (all architectures supported by
Debian), Mac OS X and Win32 systems. Debian), Mac OS X and Win32 systems.
#### Homepage #### Homepage
<http://pacparser.github.io> http://pacparser.manugarg.com
Author: Manu Garg <manugarg@gmail.com> Author: [Manu Garg](http://github.com/manugarg)
Copyright (C) 2007 Manu Garg.
Copyright (C) 2015 Google, Inc.
 End of changes. 9 change blocks. 
19 lines changed or deleted 21 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)