Statick analysis plugins for Markdown files.
Project description
Statick Markdown Plugins
This is a set of plugins for Statick that will discover documentation related files and perform static analysis on those files.
Custom exceptions can be applied the same way they are with Statick exceptions.
Table of Contents
Installation
The recommended method to install these Statick plugins is via pip:
python3 -m pip install statick-md
You can also clone the repository and use it locally.
Usage
Make sure you install all the dependencies from apt/npm:
cat install.txt | xargs sudo apt-get install -y
cat npm-deps.txt | xargs sudo npm install -g
Dependency Versions
Markdownlint-cli has occasionally changed defaults via an upgrade that results in lots of new warnings.
To mitigate this you can pin the version of markdownlint-cli in npm-deps.txt by changing markdownlint-cli
to markdownlint-cli@0.19
.
Pip Install
The most common usage is to use statick and statick-md from pip. In that case your directory structure will look like the following:
project-root
|- md-project
|- statick-output
To run with the default configuration for the statick-md tools use:
statick md-project/ --output-directory statick-output/ --profile md-profile.yaml --config md-config.yaml
Pip Install and Custom Configuration
There are times when you will want to have a custom Statick configuration. This is usually done to run a different set of tools than are called out in the default profile, or to add exceptions. For this case you will have to add the new Statick configuration somewhere. This example will have custom exceptions in the md-project, such that the directory structure is:
project-root
|- md-project
|- statick-config
|- rsc
|- exceptions.yaml
|- statick-output
For this setup you will run the following:
statick md-project/ --output-directory statick-output/ --user-paths md-project/statick-config/ --profile md-profile.yaml --config md-config.yaml
Source Install and Custom Configuration
The last type of setup will be to have all of the tools available from cloning repositories, not installing from pip. The directory structure will look like:
project-root
|- md-project
|- statick-config
|- rsc
|- exceptions.yaml
|- statick-output
|- statick
|- statick-md
Using the example where we want to override the default exceptions with custom ones in the md-project, the command to run would be:
./statick/statick md-project/ --output-directory statick-output/ --user-paths statick-md/,statick-md/src/statick_md,md-project/statick-config/ --profile md-profile.yaml --config md-config.yaml
Existing Plugins
Discovery Plugins
File Type | Extensions |
---|---|
markdown | .md |
reStructuredText | .rst |
Tool Plugins
Tool | About |
---|---|
markdownlint | A Node.js style checker and lint tool for Markdown/CommonMark files. |
proselint | A linter for prose. |
rstcheck | Checks syntax of reStructuredText and code blocks nested within it. |
rst-lint | Checks syntax of reStructuredText and code blocks nested within it. |
write-good | Naive linter for English prose. |
Contributing
If you write a new feature for Statick or are fixing a bug, you are strongly encouraged to add unit tests for your contribution. In particular, it is much easier to test whether a bug is fixed (and identify future regressions) if you can add a small unit test which replicates the bug.
Before submitting a change, please run tox to check that you have not introduced any regressions or violated any code style guidelines.
Mypy
Statick Markdown uses mypy to check that type hints are being followed properly. Type hints are described in PEP 484 and allow for static typing in Python. To determine if proper types are being used in Statick Markdown the following command will show any errors, and create several types of reports that can be viewed with a text editor or web browser.
python3 -m pip install mypy
mkdir report
mypy --ignore-missing-imports --strict --html-report report/ --txt-report report src
It is hoped that in the future we will generate coverage reports from mypy and use those to check for regressions.
Formatting
Statick code is formatted using black. To fix locally use
python3 -m pip install black
black src tests
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file statick-md-0.1.3.tar.gz
.
File metadata
- Download URL: statick-md-0.1.3.tar.gz
- Upload date:
- Size: 13.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.16
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9ba201845588df3bb1f7a2dd4dd95924ceb4b09277b382a5e1385851aedaa116 |
|
MD5 | 3ecbbf651b1614ed9118b8ee06716efc |
|
BLAKE2b-256 | 27556834f015aa3dff976a238909340ee0d0ea4a8d35d3719186c70dbf6bc55d |
File details
Details for the file statick_md-0.1.3-py3-none-any.whl
.
File metadata
- Download URL: statick_md-0.1.3-py3-none-any.whl
- Upload date:
- Size: 18.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.16
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 195fb146eac36b7cec51cd8ba71afff6c0e4796a7fee41bc3b91c63a09542236 |
|
MD5 | 719adec218a0b7725efc055998b4c676 |
|
BLAKE2b-256 | eb0ca63d6ded3c0672ee0861d474d917dbd35698339c32a46a576bd1ade97a33 |