regula-documentreader-webclient


Nameregula-documentreader-webclient JSON
Version 8.1.393 PyPI version JSON
download
home_pagehttps://regulaforensics.com
SummaryRegula's Document Reader python client
upload_time2025-06-18 12:11:48
maintainerNone
docs_urlNone
authorRegula Forensics, Inc.
requires_python>=3.9
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.9+ 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/)

## ⚠️ Warning: Package Name Changed

Package name has been changed from `regula.documentreader.webclient` to `regula_documentreader_webclient`

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.9",
    "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/d7/64/c9d13f4c2b478c9b22f5b781fa54d6b26b61cc56314ba2369314887dc15a/regula_documentreader_webclient-8.1.393.tar.gz",
    "platform": null,
    "description": "# Regula Document Reader web API Python 3.9+ 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\n## \u26a0\ufe0f Warning: Package Name Changed\n\nPackage name has been changed from `regula.documentreader.webclient` to `regula_documentreader_webclient`\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": "8.1.393",
    "project_urls": {
        "Homepage": "https://regulaforensics.com"
    },
    "split_keywords": [
        "document-reader-client",
        " document reader",
        " document recognition",
        " regulaforensics",
        " regula"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "b97363719f4729c6babee988398f9ef243513cf49331620b4074b6741fff89af",
                "md5": "b16a23768486c3ee776660131f4b9c83",
                "sha256": "b1e162a18dbfd7a133d69a70234607516eff89b19e2c7fa2d81e6c68066387a8"
            },
            "downloads": -1,
            "filename": "regula_documentreader_webclient-8.1.393-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "b16a23768486c3ee776660131f4b9c83",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 369035,
            "upload_time": "2025-06-18T12:11:45",
            "upload_time_iso_8601": "2025-06-18T12:11:45.925158Z",
            "url": "https://files.pythonhosted.org/packages/b9/73/63719f4729c6babee988398f9ef243513cf49331620b4074b6741fff89af/regula_documentreader_webclient-8.1.393-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d764c9d13f4c2b478c9b22f5b781fa54d6b26b61cc56314ba2369314887dc15a",
                "md5": "c23466e3e58df243b24ff1ed6fdaf011",
                "sha256": "15657580fe96a4ff7b6da8cad078b63d107c3feeab4dfce2c0ee4f75dea155bb"
            },
            "downloads": -1,
            "filename": "regula_documentreader_webclient-8.1.393.tar.gz",
            "has_sig": false,
            "md5_digest": "c23466e3e58df243b24ff1ed6fdaf011",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 130249,
            "upload_time": "2025-06-18T12:11:48",
            "upload_time_iso_8601": "2025-06-18T12:11:48.062287Z",
            "url": "https://files.pythonhosted.org/packages/d7/64/c9d13f4c2b478c9b22f5b781fa54d6b26b61cc56314ba2369314887dc15a/regula_documentreader_webclient-8.1.393.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-06-18 12:11:48",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "regula-documentreader-webclient"
}
Regula Forensics, Inc.
Elapsed time: 0.80154s