regula.documentreader.webclient


Nameregula.documentreader.webclient JSON
Version 7.5.185 PyPI version JSON
download
home_pagehttps://regulaforensics.com
SummaryRegula's Document Reader python client
upload_time2024-12-16 21:22:49
maintainerNone
docs_urlNone
authorRegula Forensics, Inc.
requires_python>=3.8
licenseNone
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.8+ 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://regulaforensics.com",
    "name": "regula.documentreader.webclient",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "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/1f/d8/f64c2fa067bfc6257ad0b1235d3ad69a57565dde4f3db8b6d5b97e25b607/regula_documentreader_webclient-7.5.185.tar.gz",
    "platform": null,
    "description": "# Regula Document Reader web API Python 3.8+ 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": null,
    "summary": "Regula's Document Reader python client",
    "version": "7.5.185",
    "project_urls": {
        "Homepage": "https://regulaforensics.com"
    },
    "split_keywords": [
        "document-reader-client",
        " document reader",
        " document recognition",
        " regulaforensics",
        " regula"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2bd89ae7b78a4922dbc254421052bfec2801da9e14340b0c18aa5c22e392de25",
                "md5": "324dd1106c3162a42a03b6b5ab175b65",
                "sha256": "46895d37e98753d58c07c6db4a7a41b8df47ab6a70f11958360d38f85acbaa3b"
            },
            "downloads": -1,
            "filename": "regula.documentreader.webclient-7.5.185-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "324dd1106c3162a42a03b6b5ab175b65",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 322898,
            "upload_time": "2024-12-16T21:22:47",
            "upload_time_iso_8601": "2024-12-16T21:22:47.410883Z",
            "url": "https://files.pythonhosted.org/packages/2b/d8/9ae7b78a4922dbc254421052bfec2801da9e14340b0c18aa5c22e392de25/regula.documentreader.webclient-7.5.185-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "1fd8f64c2fa067bfc6257ad0b1235d3ad69a57565dde4f3db8b6d5b97e25b607",
                "md5": "c91887354b311e1ed0c2ece3326957ae",
                "sha256": "e1533d7972f23a2b2d0be66dd728b4aa3014c891d370207d155fa761e01386a6"
            },
            "downloads": -1,
            "filename": "regula_documentreader_webclient-7.5.185.tar.gz",
            "has_sig": false,
            "md5_digest": "c91887354b311e1ed0c2ece3326957ae",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 136812,
            "upload_time": "2024-12-16T21:22:49",
            "upload_time_iso_8601": "2024-12-16T21:22:49.386301Z",
            "url": "https://files.pythonhosted.org/packages/1f/d8/f64c2fa067bfc6257ad0b1235d3ad69a57565dde4f3db8b6d5b97e25b607/regula_documentreader_webclient-7.5.185.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-16 21:22:49",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "regula.documentreader.webclient"
}
Regula Forensics, Inc.
Elapsed time: 2.94829s