# SciJava log handler for Python 🐍☕📑
[![DOI](https://zenodo.org/badge/154402009.svg)][doi]
A very thin Python package (mavenized for [ImageJ2][imagej]) to use the
[SciJava][gh_scijava] [LogService][gh_sj_logservice] as a handler for
[Python's logging facility][py_logging]. See the wiki page about
[Logging][ij_logging] for more details about ImageJ's logging framework.
Developed and provided by the [Imaging Core Facility (IMCF)][imcf] of the
Biozentrum, University of Basel, Switzerland.
## 🚫 WARNING 🚫
The PyPI packages of this project are exclusively useful for automatic testing
of e.g. the [`imcflibs`][imcflibs] package! They have no real use-case in the
standard CPython world 🐍🌍!
## Example usage
The code in [extra/scripts/example.py](extra/scripts/example.py) demonstrates
how to use the handler in an ImageJ2 Python script utilizing the fabulous
[Script Parameters][ij_script_params] for retrieving the LogService instance.
Running this code from ImageJ will result in the following messages being
printed to the console or the *Log* window, depending on how you launch ImageJ:
```log
[Fri Jan 5 12:25:15 CET 2018] [ERROR] +++ new round of messages (level WARNING) +++
[Fri Jan 5 12:25:15 CET 2018] [WARNING] warn log message
[Fri Jan 5 12:25:15 CET 2018] [ERROR] error log message
[Fri Jan 5 12:25:15 CET 2018] [ERROR] critical log message
[Fri Jan 5 12:25:15 CET 2018] [ERROR] --- finished round of messages (level WARNING) ---
[Fri Jan 5 12:25:15 CET 2018] [ERROR] +++ new round of messages (level INFO) +++
[Fri Jan 5 12:25:15 CET 2018] [INFO] info log message
[Fri Jan 5 12:25:15 CET 2018] [WARNING] warn log message
[Fri Jan 5 12:25:15 CET 2018] [ERROR] error log message
[Fri Jan 5 12:25:15 CET 2018] [ERROR] critical log message
[Fri Jan 5 12:25:15 CET 2018] [ERROR] --- finished round of messages (level INFO) ---
[Fri Jan 5 12:25:15 CET 2018] [ERROR] +++ new round of messages (level DEBUG) +++
[Fri Jan 5 12:25:15 CET 2018] [DEBUG] debug log message
[Fri Jan 5 12:25:15 CET 2018] [INFO] info log message
[Fri Jan 5 12:25:15 CET 2018] [WARNING] warn log message
[Fri Jan 5 12:25:15 CET 2018] [ERROR] error log message
[Fri Jan 5 12:25:15 CET 2018] [ERROR] critical log message
[Fri Jan 5 12:25:15 CET 2018] [ERROR] --- finished round of messages (level DEBUG) ---
[Fri Jan 5 12:25:15 CET 2018] [ERROR] +++ new round of messages (level WARNING) +++
[Fri Jan 5 12:25:15 CET 2018] [WARNING] warn log message
[Fri Jan 5 12:25:15 CET 2018] [ERROR] error log message
[Fri Jan 5 12:25:15 CET 2018] [ERROR] critical log message
[Fri Jan 5 12:25:15 CET 2018] [ERROR] --- finished round of messages (level WARNING) ---
```
[imcf]: https://www.biozentrum.unibas.ch/imcf
[imcflibs]: https://github.com/imcf/python-imcflibs/
[imagej]: https://imagej.net
[ij_logging]: https://imagej.net/Logging
[ij_script_params]: http://imagej.net/Script_Parameters
[py_logging]: https://docs.python.org/2/library/logging.html
[gh_scijava]: https://github.com/scijava
[gh_sj_logservice]: https://github.com/scijava/scijava-common/tree/master/src/main/java/org/scijava/log
[doi]: https://zenodo.org/badge/latestdoi/154402009
Raw data
{
"_id": null,
"home_page": "https://github.com/imcf/jython-scijava-logging",
"name": "sjlogging",
"maintainer": null,
"docs_url": null,
"requires_python": ">=2.7",
"maintainer_email": null,
"keywords": "fiji, jython, imagej, logging",
"author": "Niko Ehrenfeuchter",
"author_email": "nikolaus.ehrenfeuchter@unibas.ch",
"download_url": "https://files.pythonhosted.org/packages/12/01/642d78b2c4be39fc0c1c7f103c9e13194fda1655d246aa35f5398d4b4797/sjlogging-0.5.4.tar.gz",
"platform": null,
"description": "# SciJava log handler for Python \ud83d\udc0d\u2615\ud83d\udcd1\n\n[![DOI](https://zenodo.org/badge/154402009.svg)][doi]\n\nA very thin Python package (mavenized for [ImageJ2][imagej]) to use the\n[SciJava][gh_scijava] [LogService][gh_sj_logservice] as a handler for\n[Python's logging facility][py_logging]. See the wiki page about\n[Logging][ij_logging] for more details about ImageJ's logging framework.\n\nDeveloped and provided by the [Imaging Core Facility (IMCF)][imcf] of the\nBiozentrum, University of Basel, Switzerland.\n\n## \ud83d\udeab WARNING \ud83d\udeab\n\nThe PyPI packages of this project are exclusively useful for automatic testing\nof e.g. the [`imcflibs`][imcflibs] package! They have no real use-case in the\nstandard CPython world \ud83d\udc0d\ud83c\udf0d!\n\n## Example usage\n\nThe code in [extra/scripts/example.py](extra/scripts/example.py) demonstrates\nhow to use the handler in an ImageJ2 Python script utilizing the fabulous\n[Script Parameters][ij_script_params] for retrieving the LogService instance.\n\nRunning this code from ImageJ will result in the following messages being\nprinted to the console or the *Log* window, depending on how you launch ImageJ:\n\n```log\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] +++ new round of messages (level WARNING) +++\n[Fri Jan 5 12:25:15 CET 2018] [WARNING] warn log message\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] error log message\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] critical log message\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] --- finished round of messages (level WARNING) ---\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] +++ new round of messages (level INFO) +++\n[Fri Jan 5 12:25:15 CET 2018] [INFO] info log message\n[Fri Jan 5 12:25:15 CET 2018] [WARNING] warn log message\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] error log message\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] critical log message\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] --- finished round of messages (level INFO) ---\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] +++ new round of messages (level DEBUG) +++\n[Fri Jan 5 12:25:15 CET 2018] [DEBUG] debug log message\n[Fri Jan 5 12:25:15 CET 2018] [INFO] info log message\n[Fri Jan 5 12:25:15 CET 2018] [WARNING] warn log message\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] error log message\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] critical log message\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] --- finished round of messages (level DEBUG) ---\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] +++ new round of messages (level WARNING) +++\n[Fri Jan 5 12:25:15 CET 2018] [WARNING] warn log message\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] error log message\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] critical log message\n[Fri Jan 5 12:25:15 CET 2018] [ERROR] --- finished round of messages (level WARNING) ---\n```\n\n[imcf]: https://www.biozentrum.unibas.ch/imcf\n[imcflibs]: https://github.com/imcf/python-imcflibs/\n[imagej]: https://imagej.net\n[ij_logging]: https://imagej.net/Logging\n[ij_script_params]: http://imagej.net/Script_Parameters\n[py_logging]: https://docs.python.org/2/library/logging.html\n[gh_scijava]: https://github.com/scijava\n[gh_sj_logservice]: https://github.com/scijava/scijava-common/tree/master/src/main/java/org/scijava/log\n[doi]: https://zenodo.org/badge/latestdoi/154402009\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "Jython package for using SciJava's LogService for logging.",
"version": "0.5.4",
"project_urls": {
"Homepage": "https://github.com/imcf/jython-scijava-logging",
"Repository": "https://github.com/imcf/jython-scijava-logging"
},
"split_keywords": [
"fiji",
" jython",
" imagej",
" logging"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "32662032e35c0e59c611295f3d8b6024bd94d88f9b5111ffaff2bbac9837de67",
"md5": "a2fbe3fefd18944ac7758a347b5d084c",
"sha256": "e7db0a34ac2788a0404ac02beee232132f3946330cc04d28a37eea9adb3cfd42"
},
"downloads": -1,
"filename": "sjlogging-0.5.4-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "a2fbe3fefd18944ac7758a347b5d084c",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=2.7",
"size": 18120,
"upload_time": "2024-11-14T16:00:51",
"upload_time_iso_8601": "2024-11-14T16:00:51.127951Z",
"url": "https://files.pythonhosted.org/packages/32/66/2032e35c0e59c611295f3d8b6024bd94d88f9b5111ffaff2bbac9837de67/sjlogging-0.5.4-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1201642d78b2c4be39fc0c1c7f103c9e13194fda1655d246aa35f5398d4b4797",
"md5": "1d9363791957abc58465f3339767c52c",
"sha256": "5fb1a4e6338088bdbf9d943a867bf1bc6f77031ec48dbb7dd96f09abb0aaaa92"
},
"downloads": -1,
"filename": "sjlogging-0.5.4.tar.gz",
"has_sig": false,
"md5_digest": "1d9363791957abc58465f3339767c52c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=2.7",
"size": 16407,
"upload_time": "2024-11-14T16:00:53",
"upload_time_iso_8601": "2024-11-14T16:00:53.073135Z",
"url": "https://files.pythonhosted.org/packages/12/01/642d78b2c4be39fc0c1c7f103c9e13194fda1655d246aa35f5398d4b4797/sjlogging-0.5.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-14 16:00:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "imcf",
"github_project": "jython-scijava-logging",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "sjlogging"
}