Metadata-Version: 2.0
Name: pycookiecheat
Version: 0.1.8
Summary: Borrow cookies from your browser's authenticated session foruse in Python scripts.
Home-page: https://github.com/n8henrie/pycookiecheat
Author: Nathan Henrie
Author-email: nate@n8henrie.com
License: GPLv3
Keywords: pycookiecheat
Platform: UNKNOWN
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: keyring (>=5.0)
Requires-Dist: pycrypto (>=2.6.1)

pycookiecheat
=============

Borrow cookies from your browser's authenticated session for use in
Python scripts.

-  Free software: GPLv3
-  Documentation: http://n8h.me/HufI1w

Installation
------------

**NB:** Use ``pip`` and ``python`` instead of ``pip3`` and ``python3``
if you're still on Python 2.

PyPI
~~~~

-  ``pip3 install pycookiecheat``

GitHub
~~~~~~

1. ``git clone https://github.com/n8henrie/pycookiecheat.git``
2. ``cd pycookiecheat``
3. ``python3 setup.py install``

Usage
-----

.. code:: python

    from pycookiecheat import chrome_cookies
    import requests

    url = 'http://example.com/fake.html'

    # Uses Chrome's default cookies filepath by default
    cookies = chrome_cookies(url)
    r = requests.get(url, cookies=cookies)

Use the ``cookie_file`` keyword-argument to specify a different filepath
for the cookies-file:
``chrome_cookies(url, cookie_file='/abspath/to/cookies')``

Features
--------

-  Returns decrypted cookies from Google Chrome on OSX or Linux.

FAQ
---

How about Windows?
~~~~~~~~~~~~~~~~~~

I don't use Windows or have a PC, so I won't be adding support myself.
Feel free to make a PR :)


History
=======

0.1.8
-----

-  Python2 support (thanks `dani14-96 <https://github.com/dani14-96>`__)

0.1.7
-----

-  Configurable cookies file (thanks
   `ankostis <https://github.com/ankostis>`__)

0.1.6
-----

-  OSError instead of Exception for wrong OS.
-  Moved testing requirements to tox and travis-ci files.

0.1.5
-----

-  Updated to work better with PyPI's lack of markdown support
-  Working on tox and travis-ci integration
-  Added a few basic tests that should pass if one has Chrome installed
   and has visited my site (n8henrie.com)
-  Added sys.exit(0) if cookie\_file not found so tests pass on
   travis-ci.

0.1.0 (2015-02-25)
------------------

-  First release on PyPI.

Prior changelog from Gist
-------------------------

-  20150221 v2.0.1: Now should find cookies for base domain and all
   subs.
-  20140518 v2.0: Now works with Chrome's new encrypted cookies.


