******
Bravo! You have received a Medical Diploma in "mechsuit" from
the Orbital Convergence University International Air and Water Embassy of the Tangerine Planet.
You are now officially certified to include "mechsuit" in your practice.
******
# 🚲 mechsuit
---
## 🔧 description
This is a bionics module that can reliably
ascertain the health status of software with
a python3 testing interface.
(It's like a testing framework)
---
## 🦾 install
`[ZSH] pip install mechsuit`
---
## ⚙️ documentation (this opens a server process that sends HTML)
`[ZSH] mechsuit shares`
---
## 🔩 internal status tests of the module
`[ZSH] mechsuit internal-status`
These checks are run with pypi "body_scan"
"mechsuit" is built from a fork of "body_scan"
("body_scan" checks are written with "unittest")
---
## 🚴🏻 Tutorial
- Checks are started simultaneously, unless "--simultaneous no"</p>
### Create a status file (glob pattern "**/status_*.py").
(The glob pattern can be modified with the progammatic python3 interface)
```
# status_1.py
def check_1 ():
print ("check 1")
def check_2 ():
print ("check 2")
def check_3 ():
raise Exception ("not 110%")
checks = {
"check 1": check_1,
"check 2": check_2,
"check 3": check_3
}
```
### from a directory deeper than the status file "status_1.py"
`[ZSH] mechsuit status`
This is the equivalent of:
`[ZSH] mechsuit status --glob-string "**/status_*.py"`
#### The report then should appear like this
```
paths: [
{
"path": "../status_1.py",
"empty": false,
"parsed": true,
"stats": {
"passes": 2,
"alarms": 1
},
"checks": [
{
"check": "check 1",
"passed": true,
"elapsed": [
4.054199962411076e-05,
"seconds"
]
},
{
"check": "check 2",
"passed": true,
"elapsed": [
1.72930003827787e-05,
"seconds"
]
},
{
"check": "check 3",
"passed": false,
"exception": "Exception('not 110%')",
"exception trace": [
"Traceback (most recent call last):",
" File \"/home/veganecology/.local/lib/python3.11/site-packages/mechsuit/processes/scan/process/keg/check.py\", line 68, in start",
" checks [ check ] ()",
" File \"<string>\", line 13, in check_3",
"Exception: not 110%"
]
}
]
}
]
alarms: [
{
"path": "../status_1.py",
"checks": [
{
"check": "check 3",
"passed": false,
"exception": "Exception('not 110%')",
"exception trace": [
"Traceback (most recent call last):",
" File \"/home/veganecology/.local/lib/python3.11/site-packages/mechsuit/processes/scan/process/keg/check.py\", line 68, in start",
" checks [ check ] ()",
" File \"<string>\", line 13, in check_3",
"Exception: not 110%"
]
}
]
}
]
stats: {
"alarms": 0,
"empty": 0,
"checks": {
"passes": 2,
"alarms": 1
}
}
```
---
## 🪛 Advanced Tutorial
It's recommended to run mechsuit programmatilly.
An example of this can be found in the "_book/advanced tutorial"
section of the documentation.
---
## 🦿 Contacts
bgrace2468@pm.me
Raw data
{
"_id": null,
"home_page": "",
"name": "mechsuit",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "homeostasis,reliability,consistency,integrity,guarantees,vows,oaths,assurances,insurances,ensurances,speed,calmness,education,augmentation,enhancement,improvements",
"author": "",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/0f/39/1ce7bc5ac0ac632f71687c4ad5db895c1dc8576ade19de0e676477a68226/mechsuit-1.0.2.tar.gz",
"platform": null,
"description": "\n\n\n******\n\nBravo! You have received a Medical Diploma in \"mechsuit\" from \nthe Orbital Convergence University International Air and Water Embassy of the Tangerine Planet. \n\nYou are now officially certified to include \"mechsuit\" in your practice.\n\n******\n\n\n# \ud83d\udeb2 mechsuit\n\n---\n\n## \ud83d\udd27 description\nThis is a bionics module that can reliably\nascertain the health status of software with\na python3 testing interface.\n\n(It's like a testing framework)\n\t\t\n---\t\t\n\t\t\n## \ud83e\uddbe install\n`[ZSH] pip install mechsuit`\n\n---\n\t\n## \u2699\ufe0f documentation (this opens a server process that sends HTML)\n`[ZSH] mechsuit shares`\n\t\n---\t\n\t\n## \ud83d\udd29 internal status tests of the module\n`[ZSH] mechsuit internal-status`\n\t\nThese checks are run with pypi \"body_scan\" \n\"mechsuit\" is built from a fork of \"body_scan\" \n(\"body_scan\" checks are written with \"unittest\") \n\t\n---\n\n## \ud83d\udeb4\ud83c\udffb Tutorial\n- Checks are started simultaneously, unless \"--simultaneous no\"</p>\n\t\n### Create a status file (glob pattern \"**/status_*.py\").\n(The glob pattern can be modified with the progammatic python3 interface)\n```\t\t\n# status_1.py\n\ndef check_1 ():\n\tprint (\"check 1\")\n\t\ndef check_2 ():\n\tprint (\"check 2\")\n\t\ndef check_3 ():\n\traise Exception (\"not 110%\")\n\nchecks = {\n\t\"check 1\": check_1,\n\t\"check 2\": check_2,\n\t\"check 3\": check_3\n}\n```\n\t\t\n### from a directory deeper than the status file \"status_1.py\"\n`[ZSH] mechsuit status`\n\nThis is the equivalent of:\n`[ZSH] mechsuit status --glob-string \"**/status_*.py\"`\n\n\n#### The report then should appear like this\n```\npaths: [\n\t{\n\t\t\"path\": \"../status_1.py\",\n\t\t\"empty\": false,\n\t\t\"parsed\": true,\n\t\t\"stats\": {\n\t\t\t\"passes\": 2,\n\t\t\t\"alarms\": 1\n\t\t},\n\t\t\"checks\": [\n\t\t\t{\n\t\t\t\t\"check\": \"check 1\",\n\t\t\t\t\"passed\": true,\n\t\t\t\t\"elapsed\": [\n\t\t\t\t\t4.054199962411076e-05,\n\t\t\t\t\t\"seconds\"\n\t\t\t\t]\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"check\": \"check 2\",\n\t\t\t\t\"passed\": true,\n\t\t\t\t\"elapsed\": [\n\t\t\t\t\t1.72930003827787e-05,\n\t\t\t\t\t\"seconds\"\n\t\t\t\t]\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"check\": \"check 3\",\n\t\t\t\t\"passed\": false,\n\t\t\t\t\"exception\": \"Exception('not 110%')\",\n\t\t\t\t\"exception trace\": [\n\t\t\t\t\t\"Traceback (most recent call last):\",\n\t\t\t\t\t\" File \\\"/home/veganecology/.local/lib/python3.11/site-packages/mechsuit/processes/scan/process/keg/check.py\\\", line 68, in start\",\n\t\t\t\t\t\" checks [ check ] ()\",\n\t\t\t\t\t\" File \\\"<string>\\\", line 13, in check_3\",\n\t\t\t\t\t\"Exception: not 110%\"\n\t\t\t\t]\n\t\t\t}\n\t\t]\n\t}\n]\nalarms: [\n\t{\n\t\t\"path\": \"../status_1.py\",\n\t\t\"checks\": [\n\t\t\t{\n\t\t\t\t\"check\": \"check 3\",\n\t\t\t\t\"passed\": false,\n\t\t\t\t\"exception\": \"Exception('not 110%')\",\n\t\t\t\t\"exception trace\": [\n\t\t\t\t\t\"Traceback (most recent call last):\",\n\t\t\t\t\t\" File \\\"/home/veganecology/.local/lib/python3.11/site-packages/mechsuit/processes/scan/process/keg/check.py\\\", line 68, in start\",\n\t\t\t\t\t\" checks [ check ] ()\",\n\t\t\t\t\t\" File \\\"<string>\\\", line 13, in check_3\",\n\t\t\t\t\t\"Exception: not 110%\"\n\t\t\t\t]\n\t\t\t}\n\t\t]\n\t}\n]\nstats: {\n\t\"alarms\": 0,\n\t\"empty\": 0,\n\t\"checks\": {\n\t\t\"passes\": 2,\n\t\t\"alarms\": 1\n\t}\n}\n```\n\t\n---\n\n## \ud83e\ude9b Advanced Tutorial\n\nIt's recommended to run mechsuit programmatilly. \n\nAn example of this can be found in the \"_book/advanced tutorial\" \nsection of the documentation.\n\n---\n\n## \ud83e\uddbf Contacts\nbgrace2468@pm.me\n\t\n\t\t\n\t\t\n\t\n",
"bugtrack_url": null,
"license": "GPL 3.0",
"summary": "health checks module",
"version": "1.0.2",
"project_urls": {
"GitLab": "https://gitlab.com/offline-money/squash-1/mechsuit"
},
"split_keywords": [
"homeostasis",
"reliability",
"consistency",
"integrity",
"guarantees",
"vows",
"oaths",
"assurances",
"insurances",
"ensurances",
"speed",
"calmness",
"education",
"augmentation",
"enhancement",
"improvements"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0f391ce7bc5ac0ac632f71687c4ad5db895c1dc8576ade19de0e676477a68226",
"md5": "c10f3ac6bd72f2a96e28d73a19e0c5a8",
"sha256": "21915bde3dec3257a0f63644c2f6e6ad77d4d48d405a66020df691c2ef3fab33"
},
"downloads": -1,
"filename": "mechsuit-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "c10f3ac6bd72f2a96e28d73a19e0c5a8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 78879,
"upload_time": "2024-01-18T19:36:57",
"upload_time_iso_8601": "2024-01-18T19:36:57.651856Z",
"url": "https://files.pythonhosted.org/packages/0f/39/1ce7bc5ac0ac632f71687c4ad5db895c1dc8576ade19de0e676477a68226/mechsuit-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-18 19:36:57",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "offline-money",
"gitlab_project": "squash-1",
"lcname": "mechsuit"
}
JSON