This release is a pre-release and may not be stable for production use.
Regula Document Reader web API Python 3.9+ client
⚠️ 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. You are invited to contribute new features, fixes, or updates, 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
Install package
regula_documentreader_webclient is on the Python Package Index (PyPI):
pip install regula_documentreader_webclient
Or using pipenv
pipenv install regula_documentreader_webclient
Example
Performing request:
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:
# 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 folder.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file regula_documentreader_webclient-9.8.989.dev0.tar.gz.
File metadata
- Download URL: regula_documentreader_webclient-9.8.989.dev0.tar.gz
- Upload date:
- Size: 146.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.10.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
54c6bae94d597ea8250400bf5ca6e6300e91d69d7a3605ef36581af3766c4512
|
|
| MD5 |
a857109269606a7d1d7cf4d98044659c
|
|
| BLAKE2b-256 |
c94c8d8e0695efab50ae5988179ca44ab65ea33f058c3265e69f98cf9a3cedb2
|
File details
Details for the file regula_documentreader_webclient-9.8.989.dev0-py3-none-any.whl.
File metadata
- Download URL: regula_documentreader_webclient-9.8.989.dev0-py3-none-any.whl
- Upload date:
- Size: 423.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.10.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
081aa1291bdbb2936802b57754e6b344a0789480c7ac09530850cdd871861d1b
|
|
| MD5 |
79b0c5bfbc046bb3d3b731623388ba95
|
|
| BLAKE2b-256 |
2d39ca294b7ce4b977134f8eb5b1a6cd3c191ad1e5bfeeee5efb5021c2a64859
|
