# Diagnosticism.Python <!-- omit from toc -->
Diagnosticism library, for Python
[](https://badge.fury.io/py/diagnosticism)
## Table of Contents <!-- omit from toc -->
- [Introduction](#introduction)
- [Installation \& usage](#installation--usage)
- [Components](#components)
- [Examples](#examples)
- [Project Information](#project-information)
- [Where to get help](#where-to-get-help)
- [Contribution guidelines](#contribution-guidelines)
- [Dependencies](#dependencies)
- [Related projects](#related-projects)
- [License](#license)
## Introduction
**Diagnosticism** is a standalone library of simple components for aiding in diagnostics for Python projects. It contains versions of components seen in the other **Diagnosticism**s - see [below](#related-projects) - though there is not a 1-to-1 correspondence between any of them.
## Installation & usage
Install via **pip** or **pip3**, as in:
```
$ pip3 install diagnosticism
```
Use via **import**:
```Python
import diagnosticism
```
When using the simple logging facilities, we find it convenient to import as follows:
```Python
import diagnosticism as d
import diagnosticism.severity as sev
```
that may then be used as:
```Python
d.log(sev.INFO, "hello")
```
## Components
**Diagnosticism.Python** provides components in the following categories:
* Contingent Reporting
* Diagnostic Logging
* Tracing
**NOTE**: for the moment, the Diagnostic Logging facilities emit to the standard error stream, via the Contingent Reporting API. In the near future this will be changed to work with more sophisticated logging libraries, including the standard logging facilities and the (as yet to be release) **Pantheios.Python**.
## Examples
Examples are provided in the ```examples``` directory, along with a markdown description for each. A detailed list TOC of them is provided in [EXAMPLES.md](./EXAMPLES.md).
## Project Information
### Where to get help
[GitHub Page](https://github.com/synesissoftware/Diagnosticism.Python "GitHub Page")
### Contribution guidelines
Defect reports, feature requests, and pull requests are welcome on https://github.com/synesissoftware/Diagnosticism.Python.
### Dependencies
### Related projects
* [**Diagnosticism**](https://github.com/synesissoftware/Diagnosticism/)
* [**Diagnosticism.Go**](https://github.com/synesissoftware/Diagnosticism.Go/)
* [**Diagnosticism.NET**](https://github.com/synesissoftware/Diagnosticism.NET/)
### License
**Diagnosticism.Python** is released under the 3-clause BSD license. See [LICENSE](./LICENSE) for details.
<!-- ########################### end of file ########################### -->
Raw data
{
"_id": null,
"home_page": "https://github.com/synesissoftware/diagnosticism.Python",
"name": "diagnosticism",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "Diagnostic Diagnostics Logging Trace Tracing Stopwatch",
"author": "Matt Wilson",
"author_email": "matthew@synesis.com.au",
"download_url": "https://files.pythonhosted.org/packages/a1/dc/a3e5d5852a66676a9597a680eb619f0d815e097e5631e0948f3c9292614b/diagnosticism-0.14.0.tar.gz",
"platform": null,
"description": "# Diagnosticism.Python <!-- omit from toc -->\n\nDiagnosticism library, for Python\n\n[](https://badge.fury.io/py/diagnosticism)\n\n\n## Table of Contents <!-- omit from toc -->\n\n- [Introduction](#introduction)\n- [Installation \\& usage](#installation--usage)\n- [Components](#components)\n- [Examples](#examples)\n- [Project Information](#project-information)\n\t- [Where to get help](#where-to-get-help)\n\t- [Contribution guidelines](#contribution-guidelines)\n\t- [Dependencies](#dependencies)\n\t- [Related projects](#related-projects)\n\t- [License](#license)\n\n\n## Introduction\n\n**Diagnosticism** is a standalone library of simple components for aiding in diagnostics for Python projects. It contains versions of components seen in the other **Diagnosticism**s - see [below](#related-projects) - though there is not a 1-to-1 correspondence between any of them.\n\n\n## Installation & usage\n\nInstall via **pip** or **pip3**, as in:\n\n```\n$ pip3 install diagnosticism\n```\n\nUse via **import**:\n\n```Python\n\nimport diagnosticism\n```\n\nWhen using the simple logging facilities, we find it convenient to import as follows:\n\n```Python\n\nimport diagnosticism as d\nimport diagnosticism.severity as sev\n```\n\nthat may then be used as:\n\n```Python\n\nd.log(sev.INFO, \"hello\")\n```\n\n\n\n## Components\n\n**Diagnosticism.Python** provides components in the following categories:\n\n* Contingent Reporting\n* Diagnostic Logging\n* Tracing\n\n**NOTE**: for the moment, the Diagnostic Logging facilities emit to the standard error stream, via the Contingent Reporting API. In the near future this will be changed to work with more sophisticated logging libraries, including the standard logging facilities and the (as yet to be release) **Pantheios.Python**.\n\n\n## Examples\n\nExamples are provided in the ```examples``` directory, along with a markdown description for each. A detailed list TOC of them is provided in [EXAMPLES.md](./EXAMPLES.md).\n\n\n## Project Information\n\n\n### Where to get help\n\n[GitHub Page](https://github.com/synesissoftware/Diagnosticism.Python \"GitHub Page\")\n\n\n### Contribution guidelines\n\nDefect reports, feature requests, and pull requests are welcome on https://github.com/synesissoftware/Diagnosticism.Python.\n\n\n### Dependencies\n\n\n### Related projects\n\n* [**Diagnosticism**](https://github.com/synesissoftware/Diagnosticism/)\n* [**Diagnosticism.Go**](https://github.com/synesissoftware/Diagnosticism.Go/)\n* [**Diagnosticism.NET**](https://github.com/synesissoftware/Diagnosticism.NET/)\n\n\n### License\n\n**Diagnosticism.Python** is released under the 3-clause BSD license. See [LICENSE](./LICENSE) for details.\n\n\n<!-- ########################### end of file ########################### -->\n\n\n\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "Basic diagnostic facilities, for Python",
"version": "0.14.0",
"project_urls": {
"Homepage": "https://github.com/synesissoftware/diagnosticism.Python"
},
"split_keywords": [
"diagnostic",
"diagnostics",
"logging",
"trace",
"tracing",
"stopwatch"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a1dca3e5d5852a66676a9597a680eb619f0d815e097e5631e0948f3c9292614b",
"md5": "d5eb7782f02efc8aa8a4ebc415868bb3",
"sha256": "ba0805353d11004a3b31dc70872d311b597661e1241132a58cdd84487afe6e1a"
},
"downloads": -1,
"filename": "diagnosticism-0.14.0.tar.gz",
"has_sig": false,
"md5_digest": "d5eb7782f02efc8aa8a4ebc415868bb3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 20621,
"upload_time": "2025-07-28T01:41:30",
"upload_time_iso_8601": "2025-07-28T01:41:30.246217Z",
"url": "https://files.pythonhosted.org/packages/a1/dc/a3e5d5852a66676a9597a680eb619f0d815e097e5631e0948f3c9292614b/diagnosticism-0.14.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-28 01:41:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "synesissoftware",
"github_project": "diagnosticism.Python",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "diagnosticism"
}
JSON
