regula.documentreader.webclient


Nameregula.documentreader.webclient JSON
Version 7.1.2 PyPI version JSON
download
home_pagehttps://mobile.regulaforensics.com
SummaryRegula's Document Reader python client
upload_time2024-02-27 08:12:06
maintainer
docs_urlNone
authorRegula Forensics, Inc.
requires_python>=3.5
license
keywords document-reader-client document reader document recognition regulaforensics regula
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # Regula Document Reader web API Python 3.5+ client

[![pypi](https://img.shields.io/pypi/v/regula.documentreader.webclient?style=flat-square)](https://support.regulaforensics.com/hc/en-us/articles/115000916306-Documentation)
[![OpenAPI](https://img.shields.io/badge/OpenAPI-defs-8c0a56?style=flat-square)](https://github.com/regulaforensics/DocumentReader-web-openapi)
[![documentation](https://img.shields.io/badge/docs-en-f6858d?style=flat-square)](https://support.regulaforensics.com/hc/en-us/articles/115000916306-Documentation)
[![live](https://img.shields.io/badge/live-demo-0a8c42?style=flat-square)](https://api.regulaforensics.com/)

Documents recognition as easy as reading two bytes.

If you have any problems with or questions about this client, please contact us
through a [GitHub issue](https://github.com/regulaforensics/DocumentReader-web-python-client/issues).
You are invited to contribute [new features, fixes, or updates](https://github.com/regulaforensics/DocumentReader-web-python-client/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22), large or small; 
We are always thrilled to receive pull requests, and do our best to process them as fast as we can.
See [dev guide](./dev.md)

## Install package
`regula.documentreader.webclient` is on the Python Package Index (PyPI):

```bash
pip install regula.documentreader.webclient
```

Or using `pipenv`
```bash
pipenv install regula.documentreader.webclient
```

## Example
Performing request:
```python
from regula.documentreader.webclient import *

with open("australia_passport.jpg", "rb") as f:
    input_image = f.read()

with DocumentReaderApi(host='http://localhost:8080') as api:
    params = ProcessParams(
        scenario=Scenario.FULL_PROCESS,
        result_type_output=[Result.DOCUMENT_IMAGE, Result.STATUS, Result.TEXT, Result.IMAGES]
    )
    request = RecognitionRequest(process_params=params, images=[input_image])
    response = api.process(request)
```

Parsing results:
```python
# status examples
response_status = response.status
doc_overall_status = "valid" if response_status.overall_status == CheckResult.OK else "not valid"

# text fields example
doc_number_field = response.text.get_field(TextFieldType.DOCUMENT_NUMBER)
doc_number_mrz = doc_number_field.get_value()
doc_number_visual = doc_number_field.get_value(Source.VISUAL)
doc_number_visual_validity = doc_number_field.source_validity(Source.VISUAL)
doc_number_mrz_validity = doc_number_field.source_validity(Source.MRZ)
doc_number_mrz_visual_matching = doc_number_field.cross_source_comparison(Source.MRZ, Source.VISUAL)

# images fields example
normalized_input_image = response.images.document_image()
portrait_field = response.images.get_field(GraphicFieldType.PORTRAIT)
portrait_from_visual = portrait_field.get_value(Source.VISUAL)
portrait_from_rfid = portrait_field.get_value(Source.RFID, original=True)
```
You can find more detailed guide and run this sample in [example](./example) folder.

Raw data

            {
    "_id": null,
    "home_page": "https://mobile.regulaforensics.com",
    "name": "regula.documentreader.webclient",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.5",
    "maintainer_email": "",
    "keywords": "document-reader-client,document reader,document recognition,regulaforensics,regula",
    "author": "Regula Forensics, Inc.",
    "author_email": "support@regulaforensics.com",
    "download_url": "https://files.pythonhosted.org/packages/6b/89/142ce298813a162b2ad5453af71568878a304e403367f883ad825f437381/regula.documentreader.webclient-7.1.2.tar.gz",
    "platform": null,
    "description": "# Regula Document Reader web API Python 3.5+ client\n\n[![pypi](https://img.shields.io/pypi/v/regula.documentreader.webclient?style=flat-square)](https://support.regulaforensics.com/hc/en-us/articles/115000916306-Documentation)\n[![OpenAPI](https://img.shields.io/badge/OpenAPI-defs-8c0a56?style=flat-square)](https://github.com/regulaforensics/DocumentReader-web-openapi)\n[![documentation](https://img.shields.io/badge/docs-en-f6858d?style=flat-square)](https://support.regulaforensics.com/hc/en-us/articles/115000916306-Documentation)\n[![live](https://img.shields.io/badge/live-demo-0a8c42?style=flat-square)](https://api.regulaforensics.com/)\n\nDocuments recognition as easy as reading two bytes.\n\nIf you have any problems with or questions about this client, please contact us\nthrough a [GitHub issue](https://github.com/regulaforensics/DocumentReader-web-python-client/issues).\nYou are invited to contribute [new features, fixes, or updates](https://github.com/regulaforensics/DocumentReader-web-python-client/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22), large or small; \nWe are always thrilled to receive pull requests, and do our best to process them as fast as we can.\nSee [dev guide](./dev.md)\n\n## Install package\n`regula.documentreader.webclient` is on the Python Package Index (PyPI):\n\n```bash\npip install regula.documentreader.webclient\n```\n\nOr using `pipenv`\n```bash\npipenv install regula.documentreader.webclient\n```\n\n## Example\nPerforming request:\n```python\nfrom regula.documentreader.webclient import *\n\nwith open(\"australia_passport.jpg\", \"rb\") as f:\n    input_image = f.read()\n\nwith DocumentReaderApi(host='http://localhost:8080') as api:\n    params = ProcessParams(\n        scenario=Scenario.FULL_PROCESS,\n        result_type_output=[Result.DOCUMENT_IMAGE, Result.STATUS, Result.TEXT, Result.IMAGES]\n    )\n    request = RecognitionRequest(process_params=params, images=[input_image])\n    response = api.process(request)\n```\n\nParsing results:\n```python\n# status examples\nresponse_status = response.status\ndoc_overall_status = \"valid\" if response_status.overall_status == CheckResult.OK else \"not valid\"\n\n# text fields example\ndoc_number_field = response.text.get_field(TextFieldType.DOCUMENT_NUMBER)\ndoc_number_mrz = doc_number_field.get_value()\ndoc_number_visual = doc_number_field.get_value(Source.VISUAL)\ndoc_number_visual_validity = doc_number_field.source_validity(Source.VISUAL)\ndoc_number_mrz_validity = doc_number_field.source_validity(Source.MRZ)\ndoc_number_mrz_visual_matching = doc_number_field.cross_source_comparison(Source.MRZ, Source.VISUAL)\n\n# images fields example\nnormalized_input_image = response.images.document_image()\nportrait_field = response.images.get_field(GraphicFieldType.PORTRAIT)\nportrait_from_visual = portrait_field.get_value(Source.VISUAL)\nportrait_from_rfid = portrait_field.get_value(Source.RFID, original=True)\n```\nYou can find more detailed guide and run this sample in [example](./example) folder.\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "Regula's Document Reader python client",
    "version": "7.1.2",
    "project_urls": {
        "Homepage": "https://mobile.regulaforensics.com"
    },
    "split_keywords": [
        "document-reader-client",
        "document reader",
        "document recognition",
        "regulaforensics",
        "regula"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "66285658a126cbf91be7296bf8cbf0dc089c7cc97bde4a5af71a62c69ae150aa",
                "md5": "3f6a3e18200425d3766e356c43ecf233",
                "sha256": "a039198866d396d454d414ee2ee34b5503d4b72879b6b1ed36bd24304df4e9d1"
            },
            "downloads": -1,
            "filename": "regula.documentreader.webclient-7.1.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "3f6a3e18200425d3766e356c43ecf233",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.5",
            "size": 298246,
            "upload_time": "2024-02-27T08:12:03",
            "upload_time_iso_8601": "2024-02-27T08:12:03.296141Z",
            "url": "https://files.pythonhosted.org/packages/66/28/5658a126cbf91be7296bf8cbf0dc089c7cc97bde4a5af71a62c69ae150aa/regula.documentreader.webclient-7.1.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6b89142ce298813a162b2ad5453af71568878a304e403367f883ad825f437381",
                "md5": "4bbaa2cb12d6ff20f835692a0fd38ff8",
                "sha256": "82aa868d87b0b7c57e695be62f7ed56681b1446b7f9109147d7346e0755f1a04"
            },
            "downloads": -1,
            "filename": "regula.documentreader.webclient-7.1.2.tar.gz",
            "has_sig": false,
            "md5_digest": "4bbaa2cb12d6ff20f835692a0fd38ff8",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.5",
            "size": 127061,
            "upload_time": "2024-02-27T08:12:06",
            "upload_time_iso_8601": "2024-02-27T08:12:06.444348Z",
            "url": "https://files.pythonhosted.org/packages/6b/89/142ce298813a162b2ad5453af71568878a304e403367f883ad825f437381/regula.documentreader.webclient-7.1.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-02-27 08:12:06",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "regula.documentreader.webclient"
}
Regula Forensics, Inc.
Elapsed time: 0.20642s