{
    "info": {
        "author": null,
        "author_email": null,
        "bugtrack_url": null,
        "classifiers": [],
        "description": "# referer-parser Python library\n\nThis is the Python implementation of [referer-parser] [referer-parser], the library for extracting search marketing data from referer _(sic)_ URLs.\n\nThe implementation uses the shared 'database' of known referers found in [`referers.yml`] [referers-yml].\n\nThe Python version of referer-parser is maintained by [Don Spaulding] [donspaulding].\n\n## Installation\n\n    $ pip install referer_parser\n\n## Usage\n\nCreate a new instance of a Referer object by passing in the url you want to parse:\n\n```python\nfrom referer_parser import Referer\n\nreferer_url = 'http://www.google.com/search?q=gateway+oracle+cards+denise+linn&hl=en&client=safari'\n\nr = Referer(referer_url)\n```\n\nThe `r` variable now holds a Referer instance.  The important attributes are:\n\n```python\nprint(r.known)              # True\nprint(r.referer)            # 'Google'\nprint(r.medium)             # 'search'\nprint(r.search_parameter)   # 'q'\nprint(r.search_term)        # 'gateway oracle cards denise linn'\nprint(r.uri)                # ParseResult(scheme='http', netloc='www.google.com', path='/search', params='', query='q=gateway+oracle+cards+denise+linn&hl=en&client=safari', fragment='')\n```\n\nOptionally, pass in the current URL as well, to handle internal referers\n\n```python\nfrom referer_parser import Referer\n\nreferer_url = 'http://www.snowplowanalytics.com/about/team'\ncurr_url = 'http://www.snowplowanalytics.com/account/profile'\n\nr = Referer(referer_url, curr_url)\n```\n\nThe attributes would be\n\n```python\nprint(r.known)              # True\nprint(r.referer)            # None\nprint(r.medium)             # 'internal'\nprint(r.search_parameter)   # None\nprint(r.search_term)        # None\nprint(r.uri)                # ParseResult(scheme='http', netloc='www.snowplowanalytics.com', path='/about/team', params='', query='', fragment='')\n```\n\nThe `uri` attribute is an instance of ParseResult from the standard library's `urlparse` module.\n\n\n## Contributing\n\n1. Fork it\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create new Pull Request\n\n\n## Distribution\nThe distribution process for Python looks like this:\n\n    $ ./sync_data.py\n\t$ # Make changes to codebase.\n\t$ # Bump version number in setup.py\n    $ pushd python\n    $ python setup.py sdist bdist_wheel --universal\n    $ twine upload dist/referer-parser-X.Y.Z.tar.gz\n    $ popd\n\n## Copyright and license\n\nThe referer-parser Python library is copyright 2012-2016 Don Spaulding.\n\nLicensed under the [Apache License, Version 2.0] [license] (the \"License\");\nyou may not use this software except in compliance with the License.\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\n[referer-parser]: https://github.com/snowplow/referer-parser\n[referers-yml]: https://github.com/snowplow/referer-parser/blob/master/referers.yml\n\n[donspaulding]: https://github.com/donspaulding\n\n[license]: http://www.apache.org/licenses/LICENSE-2.0",
        "description_content_type": null,
        "docs_url": null,
        "download_url": null,
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": null,
        "keywords": null,
        "license": null,
        "maintainer": null,
        "maintainer_email": null,
        "name": "referer-parser",
        "package_url": "https://pypi.org/project/referer-parser/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/referer-parser/",
        "project_urls": null,
        "release_url": "https://pypi.org/project/referer-parser/0.4.1/",
        "requires_dist": null,
        "requires_python": null,
        "summary": null,
        "version": "0.4.1"
    },
    "last_serial": 2177508,
    "releases": {
        "0.0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "0215756cb35e56f05a791331bd7520e7",
                    "sha256": "5e932293ab54dd17f950c729c4e15cd24fda37a0439fef089af63a12e5493cdc"
                },
                "downloads": -1,
                "filename": "referer-parser-0.0.3.macosx-10.4-x86_64.exe",
                "has_sig": false,
                "md5_digest": "0215756cb35e56f05a791331bd7520e7",
                "packagetype": "bdist_wininst",
                "python_version": "any",
                "requires_python": null,
                "size": 66165,
                "upload_time": "2012-12-24T17:23:58",
                "url": "https://files.pythonhosted.org/packages/c2/ac/4e6cf46b73b18db44919ab0da7deea27c7d61562b3861305aa408453711e/referer-parser-0.0.3.macosx-10.4-x86_64.exe"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "861d95b6018c1fef134a92db1465abb9",
                    "sha256": "6354a39178cadbf5763892ca4619851c9de9508e6065859156f6eedb9fe93287"
                },
                "downloads": -1,
                "filename": "referer-parser-0.0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "861d95b6018c1fef134a92db1465abb9",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 2061,
                "upload_time": "2012-12-24T17:23:57",
                "url": "https://files.pythonhosted.org/packages/87/94/d1555cb5ded5d17b348383915db277b51388c31ec105f7197d48f5aa4b8b/referer-parser-0.0.3.tar.gz"
            }
        ],
        "0.0.9": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "58e600546b5fdc4fa2995cb9802377aa",
                    "sha256": "9b11f3929da8ddbd4912f9d51ecd2cbdbbbb6db1cefdb66c74d49eba956b792a"
                },
                "downloads": -1,
                "filename": "referer-parser-0.0.9.macosx-10.4-x86_64.exe",
                "has_sig": false,
                "md5_digest": "58e600546b5fdc4fa2995cb9802377aa",
                "packagetype": "bdist_wininst",
                "python_version": "any",
                "requires_python": null,
                "size": 75617,
                "upload_time": "2012-12-24T19:59:34",
                "url": "https://files.pythonhosted.org/packages/f4/5c/437ab5ad54636e1740ba73e49ca59d20ad57bd0ad3613de3e466ef9cf70d/referer-parser-0.0.9.macosx-10.4-x86_64.exe"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "94ef8da54e371f13f1bbbc6112b05ccc",
                    "sha256": "0e66dd63113d53e05a6b6bde582cb371ca4f05f5d938789549b50d94c48e0a69"
                },
                "downloads": -1,
                "filename": "referer-parser-0.0.9.tar.gz",
                "has_sig": false,
                "md5_digest": "94ef8da54e371f13f1bbbc6112b05ccc",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 12292,
                "upload_time": "2012-12-24T19:59:33",
                "url": "https://files.pythonhosted.org/packages/78/86/e13fcc7702c1bf628ea502c1e41ffa53bbbf44e6871183ecc56f328b0709/referer-parser-0.0.9.tar.gz"
            }
        ],
        "0.1.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "d42af5cc600ed1d3ea097617404aaf80",
                    "sha256": "3b2fd999e0f568690eb6e19f36472e18ab34c01384fbcbbae9c4d5966e4ccd38"
                },
                "downloads": -1,
                "filename": "referer-parser-0.1.0.macosx-10.4-x86_64.exe",
                "has_sig": false,
                "md5_digest": "d42af5cc600ed1d3ea097617404aaf80",
                "packagetype": "bdist_wininst",
                "python_version": "any",
                "requires_python": null,
                "size": 76641,
                "upload_time": "2012-12-25T15:39:33",
                "url": "https://files.pythonhosted.org/packages/50/6e/bf0f612f1c8508e59db3e0852319648550523b959d786f07e61e33e1e3a2/referer-parser-0.1.0.macosx-10.4-x86_64.exe"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "328458c5b58e1b8bbb72d99e43988ceb",
                    "sha256": "910cc8c46e5ad76ced999ead8c042f70136de717a0347d9f0e59056e7305b6f4"
                },
                "downloads": -1,
                "filename": "referer-parser-0.1.0.tar.gz",
                "has_sig": false,
                "md5_digest": "328458c5b58e1b8bbb72d99e43988ceb",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 12913,
                "upload_time": "2012-12-25T15:39:30",
                "url": "https://files.pythonhosted.org/packages/29/d4/7f5366cc300579d3eb6d1f34e320eab3e8f7ed07f6f880d344737dfdd50b/referer-parser-0.1.0.tar.gz"
            }
        ],
        "0.2.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "3a7323cf1013780b5cbb8ad3fd73eac8",
                    "sha256": "abec47dde5444bb4609d917dd1dc6b95344fa12e286b6e151448122202497d55"
                },
                "downloads": -1,
                "filename": "referer-parser-0.2.0.tar.gz",
                "has_sig": false,
                "md5_digest": "3a7323cf1013780b5cbb8ad3fd73eac8",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 14764,
                "upload_time": "2013-07-01T13:34:25",
                "url": "https://files.pythonhosted.org/packages/e5/73/2e6ec6cd1ee00861a641939646871c99f4def7cf20b6aea437267fe8316d/referer-parser-0.2.0.tar.gz"
            }
        ],
        "0.3.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "f0f106ea0087e195286f812f7e4bfad9",
                    "sha256": "131c7a550ecef604e123a656e96b2cce5d03e3ef4550297ea822c07f485f6a17"
                },
                "downloads": -1,
                "filename": "referer-parser-0.3.0.tar.gz",
                "has_sig": false,
                "md5_digest": "f0f106ea0087e195286f812f7e4bfad9",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 17127,
                "upload_time": "2013-08-06T19:30:41",
                "url": "https://files.pythonhosted.org/packages/40/2f/263e5952cf6cfbdb0100744490bbd265ea709f0833697294fa3637cc34e0/referer-parser-0.3.0.tar.gz"
            }
        ],
        "0.3.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "7d7153669d507c6dc060e20709733fe8",
                    "sha256": "0c4f505d1865c0a0388189c9745e2ec677e5969499bd5b7a7fc69c7181640985"
                },
                "downloads": -1,
                "filename": "referer-parser-0.3.1.macosx-10.9-x86_64.exe",
                "has_sig": false,
                "md5_digest": "7d7153669d507c6dc060e20709733fe8",
                "packagetype": "bdist_wininst",
                "python_version": "any",
                "requires_python": null,
                "size": 92052,
                "upload_time": "2014-07-28T13:38:14",
                "url": "https://files.pythonhosted.org/packages/9f/dc/01f848d9312521e7527c667d924be58ccc199c7741575ceb57e8b1a0a49e/referer-parser-0.3.1.macosx-10.9-x86_64.exe"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "c37da9f819c5b555affd60c06f4d3e85",
                    "sha256": "841a5d85e6d0c2f3dc54007a1aca149107addd9e0bc85693c075f386c8467f40"
                },
                "downloads": -1,
                "filename": "referer-parser-0.3.1.tar.gz",
                "has_sig": false,
                "md5_digest": "c37da9f819c5b555affd60c06f4d3e85",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 19012,
                "upload_time": "2014-07-28T13:38:12",
                "url": "https://files.pythonhosted.org/packages/3f/b3/7bd8da4565fb3b1665ba037207b69cff65251f8ea73c8ce41b3b4b838eb0/referer-parser-0.3.1.tar.gz"
            }
        ],
        "0.4.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "6981e2a0229ea02f185bc47567fd2fb4",
                    "sha256": "a59c304d670a85cb1a2a2c42af82e7ff1c78cd68ee9aa10763c83a31c626d953"
                },
                "downloads": -1,
                "filename": "referer-parser-0.4.0.tar.gz",
                "has_sig": false,
                "md5_digest": "6981e2a0229ea02f185bc47567fd2fb4",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 18073,
                "upload_time": "2016-06-20T15:41:21",
                "url": "https://files.pythonhosted.org/packages/2e/61/c4e167a9496ae042f4543923dbd706c5552959cc4fd603c004a8efc14958/referer-parser-0.4.0.tar.gz"
            }
        ],
        "0.4.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b8a4787d87fb832e7236b2e8af3f19be",
                    "sha256": "ec1abfe73cfc80937dabb804411f97f959c8f82250d6303c2b2c47726aa9b543"
                },
                "downloads": -1,
                "filename": "referer-parser-0.4.1.tar.gz",
                "has_sig": false,
                "md5_digest": "b8a4787d87fb832e7236b2e8af3f19be",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 18501,
                "upload_time": "2016-06-20T16:11:11",
                "url": "https://files.pythonhosted.org/packages/b1/eb/8ca613509079c662b7521118e097b11ea232090dd5c0e16c1201dcc9ce16/referer-parser-0.4.1.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "b8a4787d87fb832e7236b2e8af3f19be",
                "sha256": "ec1abfe73cfc80937dabb804411f97f959c8f82250d6303c2b2c47726aa9b543"
            },
            "downloads": -1,
            "filename": "referer-parser-0.4.1.tar.gz",
            "has_sig": false,
            "md5_digest": "b8a4787d87fb832e7236b2e8af3f19be",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 18501,
            "upload_time": "2016-06-20T16:11:11",
            "url": "https://files.pythonhosted.org/packages/b1/eb/8ca613509079c662b7521118e097b11ea232090dd5c0e16c1201dcc9ce16/referer-parser-0.4.1.tar.gz"
        }
    ]
}