===============================
bashate
===============================
A pep8 equivalent for bash scripts
This program attempts to be an automated style checker for bash scripts
to fill the same part of code review that pep8 does in most OpenStack
projects. It started from humble beginnings in the DevStack project,
and will continue to evolve over time.
The output format aims to follow `pycodestyle (pep8) default output format
<https://github.com/PyCQA/pycodestyle/blob/master/pycodestyle.py#L108>`_.
- Free software: Apache license
- Documentation: https://docs.openstack.org/bashate
- Source: https://opendev.org/openstack/bashate/
- Bugs: https://bugs.launchpad.net/bash8
- Release notes: https://docs.openstack.org/releasenotes/bashate/index.html
- Contributing: https://docs.openstack.org/bashate/latest/contributor/index.html
Currently Supported Checks
--------------------------
Errors
~~~~~~
Basic white space errors, for consistent indenting
- E001: check that lines do not end with trailing whitespace
- E002: ensure that indents are only spaces, and not hard tabs
- E003: ensure all indents are a multiple of 4 spaces
- E004: file did not end with a newline
- E005: file does not begin with #! or have a .sh prefix
- E006: check for lines longer than 79 columns
Structure Errors
~~~~~~~~~~~~~~~~
A set of rules that help keep things consistent in control blocks.
These are ignored on long lines that have a continuation, because
unrolling that is kind of "interesting"
- E010: *do* not on the same line as *for*
- E011: *then* not on the same line as *if* or *elif*
- E012: heredoc didn't end before EOF
- E020: Function declaration not in format ``^function name {$``
Obsolete, deprecated or unsafe syntax
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Rules to identify obsolete, deprecated or unsafe syntax that should
not be used
- E040: Syntax errors reported by `bash -n`
- E041: Usage of $[ for arithmetic is deprecated for $((
- E042: local declaration hides errors
- E043: arithmetic compound has inconsistent return semantics
- E044: Use [[ for =~,<,> comparisions
Raw data
{
"_id": null,
"home_page": "https://docs.openstack.org/bashate/latest/",
"name": "bashate",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": "",
"keywords": "",
"author": "OpenStack",
"author_email": "openstack-discuss@lists.openstack.org",
"download_url": "https://files.pythonhosted.org/packages/4d/0c/35b92b742cc9da7788db16cfafda2f38505e19045ae1ee204ec238ece93f/bashate-2.1.1.tar.gz",
"platform": null,
"description": "===============================\nbashate\n===============================\n\nA pep8 equivalent for bash scripts\n\nThis program attempts to be an automated style checker for bash scripts\nto fill the same part of code review that pep8 does in most OpenStack\nprojects. It started from humble beginnings in the DevStack project,\nand will continue to evolve over time.\n\nThe output format aims to follow `pycodestyle (pep8) default output format\n<https://github.com/PyCQA/pycodestyle/blob/master/pycodestyle.py#L108>`_.\n\n\n- Free software: Apache license\n- Documentation: https://docs.openstack.org/bashate\n- Source: https://opendev.org/openstack/bashate/\n- Bugs: https://bugs.launchpad.net/bash8\n- Release notes: https://docs.openstack.org/releasenotes/bashate/index.html\n- Contributing: https://docs.openstack.org/bashate/latest/contributor/index.html\n\nCurrently Supported Checks\n--------------------------\n\nErrors\n~~~~~~\n\nBasic white space errors, for consistent indenting\n\n- E001: check that lines do not end with trailing whitespace\n- E002: ensure that indents are only spaces, and not hard tabs\n- E003: ensure all indents are a multiple of 4 spaces\n- E004: file did not end with a newline\n- E005: file does not begin with #! or have a .sh prefix\n- E006: check for lines longer than 79 columns\n\nStructure Errors\n~~~~~~~~~~~~~~~~\n\nA set of rules that help keep things consistent in control blocks.\nThese are ignored on long lines that have a continuation, because\nunrolling that is kind of \"interesting\"\n\n- E010: *do* not on the same line as *for*\n- E011: *then* not on the same line as *if* or *elif*\n- E012: heredoc didn't end before EOF\n- E020: Function declaration not in format ``^function name {$``\n\nObsolete, deprecated or unsafe syntax\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nRules to identify obsolete, deprecated or unsafe syntax that should\nnot be used\n\n- E040: Syntax errors reported by `bash -n`\n- E041: Usage of $[ for arithmetic is deprecated for $((\n- E042: local declaration hides errors\n- E043: arithmetic compound has inconsistent return semantics\n- E044: Use [[ for =~,<,> comparisions\n\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "A pep8 equivalent for bash scripts",
"version": "2.1.1",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7aaf4a6c74d83aa323cf643f2ca30977b3c684a1ce7769f762227d9c0af00dc2",
"md5": "953163b8cca8ff03247c0a33cb499b13",
"sha256": "3104d565a7a0f7ee2cf4028cc584c723a202f52a8ddffe4a39b8cbb0ac5d3e94"
},
"downloads": -1,
"filename": "bashate-2.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "953163b8cca8ff03247c0a33cb499b13",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 27461,
"upload_time": "2022-10-06T09:48:20",
"upload_time_iso_8601": "2022-10-06T09:48:20.237804Z",
"url": "https://files.pythonhosted.org/packages/7a/af/4a6c74d83aa323cf643f2ca30977b3c684a1ce7769f762227d9c0af00dc2/bashate-2.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4d0c35b92b742cc9da7788db16cfafda2f38505e19045ae1ee204ec238ece93f",
"md5": "b0de3d5aead12cfd6c42d9ce221c05ea",
"sha256": "4bab6e977f8305a720535f8f93f1fb42c521fcbc4a6c2b3d3d7671f42f221f4c"
},
"downloads": -1,
"filename": "bashate-2.1.1.tar.gz",
"has_sig": false,
"md5_digest": "b0de3d5aead12cfd6c42d9ce221c05ea",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.5",
"size": 34875,
"upload_time": "2022-10-06T09:48:21",
"upload_time_iso_8601": "2022-10-06T09:48:21.434096Z",
"url": "https://files.pythonhosted.org/packages/4d/0c/35b92b742cc9da7788db16cfafda2f38505e19045ae1ee204ec238ece93f/bashate-2.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-10-06 09:48:21",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "bashate"
}
JSON