Metadata-Version: 1.1
Name: patent-client
Version: 0.1.7
Summary: A set of ORM-style clients for publicly available intellectual property data
Home-page: https://github.com/parkerhancock/python-ip
Author: Parker Douglas Hancock
Author-email: pypatent2018@gmail.com
License: Apache Software License 2.0
Description: .. image:: https://travis-ci.org/parkerhancock/patent_client.svg?branch=master
            :target: https://travis-ci.org/parkerhancock/patent_client
        
        .. image:: https://codecov.io/gh/parkerhancock/patent_client/branch/master/graph/badge.svg
          :target: https://codecov.io/gh/parkerhancock/patent_client
        
        .. image:: https://img.shields.io/pypi/v/patent_client.svg
            :alt: PyPI Package latest release
            :target: https://pypi.python.org/pypi/patent_client
        
        .. image:: https://img.shields.io/pypi/wheel/patent_client.svg
            :alt: PyPI Wheel
            :target: https://pypi.python.org/pypi/patent_client
        
        .. image:: https://img.shields.io/pypi/pyversions/patent_client.svg
            :alt: Supported versions
            :target: https://pypi.python.org/pypi/patent_client
        
        Warning
        ==============
        
        This project is under active development. Please treat this as a rough draft. NOT PRODUCTION READY.
        
        Overview
        ========
        
        A set of Django-ORM-Style accessors to publicly available intellectual property data.
        
        Currently supports:
        
        * `European Patent Office - Open Patent Services <OPS>`_
        
            * Inpadoc - Full Support
            * EPO Register - Full Support
            * Classification - No Support
        
        * `United States Patent & Trademark Office <USPTO>`_
        
            * `Patent Examination Data <PEDS>`_ - Full Support
            * `Patent Assignment Data <Assignment>`_ - Lookup Support
            * `Patent Trial & Appeal Board API <PTAB>`_ - Full Support
        
        .. _OPS: http://ops.epo.org
        .. _USPTO: http://developer.uspto.gov
        .. _PEDS: https://developer.uspto.gov/api-catalog/ped
        .. _Assignment: https://developer.uspto.gov/api-catalog/patent-assignment-search-beta
        .. _PTAB: https://developer.uspto.gov/api-catalog/ptab-api
        
        * Free software: Apache Software License 2.0
        
        Installation
        ============
        
        ::
        
            pip install patent_client
        
        If you only want access to USPTO resources, you're done!
        However, additional setup is necessary to access EPO Inpadoc and EPO Register resources. See the `Docs <http://patent-client.readthedocs.io>`_.
        
        Documentation
        =============
        
        Docs, including a fulsome Getting Started are available on `Read the Docs <http://patent-client.readthedocs.io>`_.
        
        SUPER QUICK START
        -----------------
        
        To use the project:
        
        .. code-block:: python
        
            >>> from patent_client import Inpadoc, Epo, Assignment, USApplication
            # Fetch US Applications
            >>> app = USApplication.objects.get('15710770')
            >>> app.patent_title
            'Camera Assembly with Concave-Shaped Front Face'
            # Fetch from USPTO Assignments
            >>> assignments = Assignment.objects.filter(assignee='Google')
            >>> len(assignments)
            23860
            >>> assignments[0].id
            '47086-788'
            >>> assignments[0].conveyance_text
            'ASSIGNMENT OF ASSIGNORS INTEREST (SEE DOCUMENT FOR DETAILS).'
            # Fetch from INPADOC
            >>> pub = Inpadoc.objects.get('EP3082535A1')
            >>> pub.title
            'AUTOMATIC FLUID DISPENSER'
            >>> pub.priority_claims
            ['201314137130', '2014071849']
            # Fetch from EPO Register
            >>> epo = Epo.objects.get('EP3082535A1')
            >>> epo.title
            'AUTOMATIC FLUID DISPENSER'
            >>> epo.status
            [{'description': 'Examination is in progress', 'code': '14', 'date': '20180615'}]
        
        Development
        ===========
        
        To run the all tests run::
        
            pytest
        
        A developer guide is provided in the `Documentation <http://patent-client.readthedocs.io>`_. 
        This project is narrowly scoped to only public documented API's available without charge
        (at least for moderate usage). Scrapers of HTML websites are not permitted. But PR's to
        add support for new API's are more than welcome. 
        
        Pull requests welcome!
        
        Related projects
        ================
        
        * `Python EPO OPS Client <https://github.com/55minutes/python-epo-ops-client>`_
        * `Google Public Patent Data <https://github.com/google/patents-public-data>`_
        
        
        Changelog
        =========
        
        0.1.5 (2018-10-25)
        ------------------
        * Massive refactor of OPS client
        
        0.1.4 (2018-10-24)
        ------------------
        * Support for USPTO Applications, Assignments, and PTAB documents
        * Support for EPO Inpadoc and EPO Register
        * Initial Installation and Getting Started Documentation
        
        0.0.1 (2018-10-15)
        ------------------
        
        * First release on PyPI.
        * Support for EPO OPS (except Classification data)
        
        
Keywords: patents,uspto,epo,united states patent office,trademark,intellectual property,inpadoc,open patent services
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Utilities
