Skip to main content

A Collection of pre-commit hooks for MATLAB

Project description

PyPI - Python Version PyPI PyPI - License pre-commit.ci status lint-and-test Code style: black

pre-commit-matlab

A collection of pre-commit hooks for MATLAB

Ok... it's just one hook so far but maybe someday there will be more 😃

Using pre-commit-matlab with pre-commit

Add this to your .pre-commit-config.yaml

-   repo: https://github.com/sco1/pre-commit-matlab
    rev: v1.2.0
    hooks:
    -   id: matlab-reflow-comments
        args: [--line-length=100]

Hooks

matlab-reflow-comments

Reflow inline comments (lines beginning with %) or block comments (delimited by %{ and %}) in MATLAB file(s) (*.m) to the specified line length.

Blank comment lines are passed back into the reformatted source code.

  • Use --line-length to specify line length. (Default: 75)
  • Use --reflow-block-comments to control block comment reflow. (Default: True)
  • Use --ignore-indented to ignore comments with inner indentation. (Default: True)
    • NOTE: This logic is not applied to the contents of a block comment.
  • Use --alternate-capital-handling to treat comment lines that begin with a capital letter as the start of a new comment block. (Default: False)
    • NOTE: This logic is not applied to the contents of a block comment.

If ignore-indented is True, comments that contain inner indentation of at least two spaces is passed back into the reformatted source code as-is. Leading whitespace in the line is not considered.

For example:

    % This is not indented
% This is not indented
%  This is indented
%    This is indented

If alternate-capital-handling is True, if the line buffer has contents then a line beginning with a capital letter is treated as the start of a new comment block.

For example:

% This is a comment line
% This is a second comment line that will not be reflowed into the previous line

NOTE: As an opinionated flag, this may lead to false positives so it is off by default. If enabled, pay close attention to the resulting diff to ensure that your comments are being reflowed as desired.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pre-commit-matlab-1.2.0.tar.gz (5.7 kB view hashes)

Uploaded Source

Built Distribution

pre_commit_matlab-1.2.0-py3-none-any.whl (6.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page