update readme's

Author: emilssolmanis

README.md

@@ -82,22 +82,38 @@ For more information, please see the Ruby [README] [ruby-readme].
 
 ## Usage: Python
 
-The Python version of this library still uses the **old** API, and identifies search referers only:
+Create a new instance of a Referer object by passing in the url you want to parse:
 
 ```python
 from referer_parser import Referer
 
 referer_url = 'http://www.google.com/search?q=gateway+oracle+cards+denise+linn&hl=en&client=safari'
 
 r = Referer(referer_url)
+```
+
+The `r` variable now holds a Referer instance.  The important attributes are:
 
+```python
 print(r.known)              # True
 print(r.referer)            # 'Google'
+print(r.medium)             # 'search'
 print(r.search_parameter)   # 'q'     
 print(r.search_term)        # 'gateway oracle cards denise linn'
 print(r.uri)                # ParseResult(scheme='http', netloc='www.google.com', path='/search', params='', query='q=gateway+oracle+cards+denise+linn&hl=en&client=safari', fragment='')
 ```
 
+Optionally, pass in the current URL as well, to handle internal referers
+
+```python
+from referer_parser import Referer
+
+referer_url = 'http://www.snowplowanalytics.com/about/team'
+curr_url = 'http://www.snowplowanalytics.com/account/profile'
+
+r = Referer(referer_url, curr_url)
+```
+
 For more information, please see the Python [README] [python-readme].
 
 ## Usage: .NET

python/README.md

@@ -5,8 +5,6 @@ This is the Python implementation of [referer-parser] [referer-parser], the libr
 The implementation uses the shared 'database' of known referers found in [`referers.yml`] [referers-yml] (converted to a `referers.json` file,
 see below).
 
-**Currently the Python library only extracts search engine referers - it needs updating with the additional functionality now found in the Java/Scala version.**
-
 The Python version of referer-parser is maintained by [Don Spaulding] [donspaulding].
 
 ## Installation
@@ -30,11 +28,34 @@ The `r` variable now holds a Referer instance.  The important attributes are:
 ```python
 print(r.known)              # True
 print(r.referer)            # 'Google'
+print(r.medium)             # 'search'
 print(r.search_parameter)   # 'q'     
 print(r.search_term)        # 'gateway oracle cards denise linn'
 print(r.uri)                # ParseResult(scheme='http', netloc='www.google.com', path='/search', params='', query='q=gateway+oracle+cards+denise+linn&hl=en&client=safari', fragment='')
 ```
 
+Optionally, pass in the current URL as well, to handle internal referers
+
+```python
+from referer_parser import Referer
+
+referer_url = 'http://www.snowplowanalytics.com/about/team'
+curr_url = 'http://www.snowplowanalytics.com/account/profile'
+
+r = Referer(referer_url, curr_url)
+```
+
+The attributes would be
+
+```python
+print(r.known)              # True
+print(r.referer)            # None
+print(r.medium)             # 'internal'
+print(r.search_parameter)   # None
+print(r.search_term)        # None
+print(r.uri)                # ParseResult(scheme='http', netloc='www.snowplowanalytics.com', path='/about/team', params='', query='', fragment='')
+```
+
 The `uri` attribute is an instance of ParseResult from the standard library's `urlparse` module.
 
 ## referers.json

python/referer_parser/__init__.py

@@ -35,6 +35,7 @@ def __init__(self, ref_url, curr_url=None):
         ref_uri = urlparse(ref_url)
         ref_host = ref_uri.hostname
         self.known = ref_uri.scheme in {'http', 'https'}
+        self.uri = ref_uri
 
         # print "Scheme: %s" % ref_uri.scheme