=========================================================================== 

 ____        ____              _  _     _                     _          
|  _ \ _   _|  _ \  ___   __ _| || |   / \   _ __   __ _  ___| |__   ___ 
| |_) | | | | | | |/ _ \ / _` | || |_ / _ \ | '_ \ / _` |/ __| '_ \ / _ |
|  __/| |_| | |_| | (_) | (_| |__   _/ ___ \| |_) | (_| | (__| | | |  __/
|_|    \__, |____/ \___/ \__, |  |_|/_/   \_\ .__/ \__,_|\___|_| |_|\___|
       |___/             |___/              |_|                          

  Who watches the watchers?

===========================================================================
  PyDog4Apache - is an Apache web logs sneaker.

  With this tool you can search for specific keywords (such as: government, police...) 
  on Whois description of the IPs of your website visitors by -automagically- analyzing 
  apache logs provided (you can set folders of logs to -sneak- all your projects).

  Also you can generate a report with results or send them to a list of email recipients
  like an alert.

  Current version (beta): pydog4apache-v0.1   

git clone https://github.com/epsylon/pydog4apache


  PyDog4Apache runs on many platforms. It requires Python (2.x.y) and the following libraries:

     python-pip - alternative Python package installer

  On Debian-based systems (ex: Ubuntu), run: 

     sudo apt-get install python-pip && sudo pip install ipwhois

  Source libs:

     * Pypi-ipwhois: https://pypi.python.org/pypi/ipwhois/

    Usage: pydog4apache.py [options]

  Options:
    --version      show program's version number and exit
    -h, --help     show this help message and exit
    -u, --update   check for latest stable version
    -v, --verbose  active verbose output

    *Reporting*:
      -r FILE      generate file output with 'visitants'
      -n EMAILS    notify via email (foo@email.net,bar@email.org,...)

  *Verbose:

    ./pydog4apache -v 

  *Generate report file:

    ./pydog4apache -r my_visitants.txt

  *Notify results via email to some recipients (separated by comma):

    ./pydog4apache -n='root@localhost,foo@email.org,bar@email.net'

  *Combine options:

    ./pydog4apache -v -r my_visitants.txt -n epsylon@riseup.net

  *Launch it as daemon (notify via email when finish):

    ./pydog4apache -n epsylon@riseup.net &

   - PyDog4Apache is free software, and may be redistributed under GPL v3.

   If you want to contribute to PyDog4Apache development, reporting a bug, 
   providing a patch, commenting on the code base or simply need to find help 
   to run it, please drop me an e-mail.

   To make donations use the following hashes:
  
      - Bitcoin: 19aXfJtoYJUoXEZtjNwsah2JKN9CK5Pcjw
      - Ecoin: 6enjPY7PZVq9gwXeVCxgJB8frsf4YFNzVp