# QR Data Manager (QRDM)
QRDM provides a python package, network API endpoints, and web interfaces for encoding
and decoding documents as a series of QR codes.
## Setup and Execution
The `qrdm` package is written in pure Python; the ease of installation is dependent on
availability of its dependencies.
The simplest method of installing the `qrdm` package is via `pip`.
```sh
pip install qrdm
```
If `pip` is able to reach a suitable package index, `qrdm` will install along with its
core Python dependencies.
**IMPORTANT**
> The QR decoding functionality depends on the [`pyzbar`][pyzbar] python package, which
> in turn depends on the `zbar` shared library. This may require you to install the
> `zbar` package via your system's package manager.
> See the [`pyzbar` installation instructions][pyzbar-install] for more details.
[pyzbar]: https://github.com/NaturalHistoryMuseum/pyzbar
[pyzbar-install]: https://github.com/NaturalHistoryMuseum/pyzbar?tab=readme-ov-file#installation
Two main "package extras" are available for `qrdm` that provide REST API application
("backend") and Web application ("frontend") services for the QR encoding & decoding
functions. These can be included by specifying `qrdm[backend]` or
`qrdm[frontend]` to the installation command above, respectively.
### Web UI via Streamlit
A [Streamlit](https://streamlit.io) "frontend" can be run via:
```sh
git clone https://github.com/mit-ll/qrdm
cd qrdm
python -m pip install .[frontend]
streamlit run ui/QRDM_Home.py --client.toolbarMode=viewer
```
This will host the app at `http://localhost:8501` by default, with pages for QR encoding
and decoding. The host and port can be controlled by passing `--server.port=XXXX` and
`--server.address=X.X.X.X`, as per the syntax of the `streamlit run` command.
### REST API via FastAPI
To run the "backend" FastAPI app via uvicorn, use `uvicorn` directly. For example:
```sh
python -m pip install qrdm[backend]
uvicorn qrdm.backend:app --host localhost --port 8182
```
This will result in the app being hosted at `http://localhost:8182`. Swagger
documentation will be hosted at `http://localhost:8182/docs`, if an internet connection
is available. Further options are available via `uvicorn` command-line configuration.
## Disclaimer
DISTRIBUTION STATEMENT A. Approved for public release: distribution unlimited.
© 2024 Massachusetts Institute of Technology
- Subject to FAR 52.227-11 - Patent Rights - Ownership by the Contractor (May 2014)
- SPDX-License-Identifier: MIT
This material is based upon work supported by the Name of Sponsor under Air Force
Contract No. FA8721-05-C-0002 and/or FA8702-15-D-0001. Any opinions, findings,
conclusions or recommendations expressed in this material are those of the author(s) and
do not necessarily reflect the views of the Name of Sponsor.
Delivered to the U.S. Government with Unlimited Rights, as defined in DFARS Part
252.227-7013 or 7014 (Feb 2014). Notwithstanding any copyright notice, U.S. Government
rights in this work are defined by DFARS 252.227-7013 or DFARS 252.227-7014 as detailed
above.
The software/firmware is provided to you on an As-Is basis.
Raw data
{
"_id": null,
"home_page": null,
"name": "qrdm",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "QR, QR code",
"author": "MIT Lincoln Laboratory",
"author_email": "\"Cuyler D. O'Brien\" <cuyler.obrien@ll.mit.edu>, \"Eric A. Quintero\" <Eric.Quintero@ll.mit.edu>, Tod Shannon <tod@ll.mit.edu>, \"Michael J. Snyder\" <michael.snyder@ll.mit.edu>",
"download_url": "https://files.pythonhosted.org/packages/d2/a1/fb7035dba08d7c0f7fde43cb20fea6c48df3816ca1daa96f4fa87b13bcf3/qrdm-2.0.2.tar.gz",
"platform": null,
"description": "# QR Data Manager (QRDM)\nQRDM provides a python package, network API endpoints, and web interfaces for encoding\nand decoding documents as a series of QR codes.\n\n## Setup and Execution\n\nThe `qrdm` package is written in pure Python; the ease of installation is dependent on\navailability of its dependencies.\n\nThe simplest method of installing the `qrdm` package is via `pip`.\n```sh\npip install qrdm\n```\n\nIf `pip` is able to reach a suitable package index, `qrdm` will install along with its\ncore Python dependencies.\n\n**IMPORTANT**\n> The QR decoding functionality depends on the [`pyzbar`][pyzbar] python package, which\n> in turn depends on the `zbar` shared library. This may require you to install the\n> `zbar` package via your system's package manager.\n> See the [`pyzbar` installation instructions][pyzbar-install] for more details.\n\n[pyzbar]: https://github.com/NaturalHistoryMuseum/pyzbar\n[pyzbar-install]: https://github.com/NaturalHistoryMuseum/pyzbar?tab=readme-ov-file#installation\n\nTwo main \"package extras\" are available for `qrdm` that provide REST API application\n(\"backend\") and Web application (\"frontend\") services for the QR encoding & decoding\nfunctions. These can be included by specifying `qrdm[backend]` or\n`qrdm[frontend]` to the installation command above, respectively.\n\n### Web UI via Streamlit\nA [Streamlit](https://streamlit.io) \"frontend\" can be run via:\n\n```sh\ngit clone https://github.com/mit-ll/qrdm\ncd qrdm\npython -m pip install .[frontend]\nstreamlit run ui/QRDM_Home.py --client.toolbarMode=viewer\n```\n\nThis will host the app at `http://localhost:8501` by default, with pages for QR encoding\nand decoding. The host and port can be controlled by passing `--server.port=XXXX` and\n`--server.address=X.X.X.X`, as per the syntax of the `streamlit run` command.\n\n### REST API via FastAPI\n\nTo run the \"backend\" FastAPI app via uvicorn, use `uvicorn` directly. For example:\n```sh\npython -m pip install qrdm[backend]\nuvicorn qrdm.backend:app --host localhost --port 8182\n```\n\nThis will result in the app being hosted at `http://localhost:8182`. Swagger\ndocumentation will be hosted at `http://localhost:8182/docs`, if an internet connection\nis available. Further options are available via `uvicorn` command-line configuration.\n\n## Disclaimer\n\nDISTRIBUTION STATEMENT A. Approved for public release: distribution unlimited.\n\n\u00a9 2024 Massachusetts Institute of Technology\n\n- Subject to FAR 52.227-11 - Patent Rights - Ownership by the Contractor (May 2014)\n- SPDX-License-Identifier: MIT\n\nThis material is based upon work supported by the Name of Sponsor under Air Force\nContract No. FA8721-05-C-0002 and/or FA8702-15-D-0001. Any opinions, findings,\nconclusions or recommendations expressed in this material are those of the author(s) and\ndo not necessarily reflect the views of the Name of Sponsor.\n\nDelivered to the U.S. Government with Unlimited Rights, as defined in DFARS Part\n252.227-7013 or 7014 (Feb 2014). Notwithstanding any copyright notice, U.S. Government\nrights in this work are defined by DFARS 252.227-7013 or DFARS 252.227-7014 as detailed\nabove.\n\nThe software/firmware is provided to you on an As-Is basis.\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "QR Data Manager",
"version": "2.0.2",
"project_urls": {
"Documentation": "https://mit-ll.github.io/qrdm",
"Repository": "https://github.com/mit-ll/qrdm"
},
"split_keywords": [
"qr",
" qr code"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b5e1d56daf996cc6382a7e9e9f4d754b180fb26b06c5554ad4dba143aa8ed163",
"md5": "ed95da4c3a7481b849949f35d1697c7c",
"sha256": "ba013312337fedc68773ce5f8bd13ff7adbe3073b6f6230fb224aaeab649472d"
},
"downloads": -1,
"filename": "qrdm-2.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ed95da4c3a7481b849949f35d1697c7c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 49139,
"upload_time": "2024-04-19T14:41:28",
"upload_time_iso_8601": "2024-04-19T14:41:28.312159Z",
"url": "https://files.pythonhosted.org/packages/b5/e1/d56daf996cc6382a7e9e9f4d754b180fb26b06c5554ad4dba143aa8ed163/qrdm-2.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d2a1fb7035dba08d7c0f7fde43cb20fea6c48df3816ca1daa96f4fa87b13bcf3",
"md5": "e18fea703052f71e98db30709e3a4f1e",
"sha256": "27e4990e6af5d77965bb5951cc4da6084d475b7b37118cdb3809ded5b75bc57c"
},
"downloads": -1,
"filename": "qrdm-2.0.2.tar.gz",
"has_sig": false,
"md5_digest": "e18fea703052f71e98db30709e3a4f1e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 47829,
"upload_time": "2024-04-19T14:41:29",
"upload_time_iso_8601": "2024-04-19T14:41:29.401728Z",
"url": "https://files.pythonhosted.org/packages/d2/a1/fb7035dba08d7c0f7fde43cb20fea6c48df3816ca1daa96f4fa87b13bcf3/qrdm-2.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-19 14:41:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mit-ll",
"github_project": "qrdm",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"tox": true,
"lcname": "qrdm"
}
JSON
