Metadata-Version: 2.1
Name: curlylint
Version: 0.8.0
Summary: {{ 🎀}} Prototype linter for Jinja and Django templates, forked from jinjalint
Home-page: https://github.com/thibaudcolas/curlylint
Author: Thibaud Colas
Author-email: thibaudcolas@gmail.com
License: MIT
Description: # [curlylint](https://pypi.org/project/curlylint/) [<img src="https://raw.githubusercontent.com/thibaudcolas/curlylint/master/.github/curlylint-logo.svg?sanitize=true" width="250" height="100" align="right" alt="">](https://pypi.org/project/curlylint/)
        
        [![PyPI](https://img.shields.io/pypi/v/curlylint.svg)](https://pypi.org/project/curlylint/) [![PyPI downloads](https://img.shields.io/pypi/dm/curlylint.svg)](https://pypi.org/project/curlylint/) [![Travis](https://travis-ci.com/thibaudcolas/curlylint.svg?branch=master)](https://travis-ci.com/thibaudcolas/curlylint) [![Total alerts](https://img.shields.io/lgtm/alerts/g/thibaudcolas/curlylint.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/thibaudcolas/curlylint/alerts/) [![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/thibaudcolas/curlylint.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/thibaudcolas/curlylint/context:python)
        
        > **{{ 🎀}}** Prototype linter for [Jinja](https://jinja.palletsprojects.com/) and [Django templates](https://docs.djangoproject.com/en/dev/topics/templates/), forked from [jinjalint](https://github.com/motet-a/jinjalint).
        
        curlylint is a prototype linter for your templates – whether that’s [Django’s templates](https://docs.djangoproject.com/en/1.11/ref/templates/language/), [Jinja](https://jinja.palletsprojects.com/), [Twig](https://twig.symfony.com/), or any other [“curly braces”](tests/README.md) template language.
        
        As of now, curlylint supports:
        
        - Linting invalid template / HTML syntax due to mismatched tags – while template errors are easy enough to spot, it’s not rare for HTML issues to make their way to live sites.
        - Indentation inconsistencies – Usage of tabs vs spaces, line breaks, indentation size.
        
        In the future, we intend to support linting:
        
        - Common accessibility issues in HTML – misuse of ARIA `role`, and making sure alternative text is used where appropriate.
        - Common security issues – e.g. `rel="noopener noreferrer"`, or preventing usage of HTTP URLs.
        - General HTML code smells – duplicate attributes, invalid attributes, etc.
        - More [ideas welcome](docs/README.md)!
        
        ## Usage
        
        You need Python 3. Curlylint doesn’t work with Python 2. Install it with
        `pip install curlylint` (or `pip3 install curlylint` depending on how `pip` is
        called on your system), then run it with:
        
        ```sh
        curlylint template-directory/
        ```
        
        …or:
        
        ```sh
        curlylint some-file.html some-other-file.html
        ```
        
        This is a work in progress. Feel free to contribute :upside_down_face:
        
        ### CLI flags
        
        #### `--verbose`
        
        Turns on verbose mode. This makes it easier to troubleshoot what configuration is used, and what files are being linted.
        
        ```sh
        curlylint --verbose template-directory/
        ```
        
        #### `--quiet`
        
        Don’t emit non-error messages to stderr. Errors are still emitted; silence those with `2>/dev/null`.
        
        ```sh
        curlylint --quiet template-directory/
        ```
        
        #### `--parse-only`
        
        Don’t lint, check for syntax errors and exit.
        
        ```sh
        curlylint --parse-only template-directory/
        ```
        
        ## Configuration with pyproject.toml
        
        _curlylint_ is able to read project-specific default values for its command line options from a [PEP 518](https://www.python.org/dev/peps/pep-0518/) `pyproject.toml` file.
        
        ### Where _curlylint_ looks for the file
        
        By default _curlylint_ looks for `pyproject.toml` starting from the common base directory of all files and directories passed on the command line. If it's not there, it looks in parent directories. It stops looking when it finds the file, or a `.git` directory, or a `.hg` directory, or the root of the file system, whichever comes first.
        
        You can also explicitly specify the path to a particular file that you want with `--config`. In this situation _curlylint_ will not look for any other file.
        
        If you're running with `--verbose`, you will see a blue message if a file was found and used.
        
        ### Configuration format
        
        As the file extension suggests, `pyproject.toml` is a
        [TOML](https://github.com/toml-lang/toml) file. It contains separate sections for
        different tools. _curlylint_ is using the `[tool.curlylint]` section. The option keys are the same as long names of options on the command line.
        
        <details>
        
        <summary>Example `pyproject.toml`</summary>
        
        ```toml
        [tool.curlylint]
        # How many spaces
        indent-size = 4
        # Specify additional Jinja elements which can wrap HTML here. You
        # don't neet to specify simple elements which can't wrap anything like
        # {% extends %} or {% include %}.
        jinja-custom-elements-names = [
          ["cache", "endcache"],
          ["captureas", "endcaptureas"]
        ]
        include = '\.(html|jinja)$'
        exclude = '''
        (
          /(
              \.eggs           # exclude a few common directories in the root of the project
            | \.git
            | \.venv
            | build
            | dist
          )/
          | webpack-stats.html # also separately exclude a file named webpack-stats.html in the root of the project
        )
        '''
        ```
        
        </details>
        
        ### Lookup hierarchy
        
        Command-line options have defaults that you can see in `--help`. A `pyproject.toml` can override those defaults. Finally, options provided by the user on the command line override both.
        
        _curlylint_ will only ever use one `pyproject.toml` file during an entire run. It doesn't look for multiple files, and doesn't compose configuration from different levels of the file hierarchy.
        
        ## Usage with [pre-commit](https://pre-commit.com) git hooks framework
        
        Add to your `.pre-commit-config.yaml`:
        
        ```yaml
        - repo: https://github.com/thibaudcolas/curlylint
          rev: "" # select a tag / sha to point at
          hooks:
            - id: curlylint
        ```
        
        Make sure to fill in the `rev` with a valid revision.
        
        _Note_: by default this configuration will only match `.jinja` and `.jinja2`
        files. To match by regex pattern instead, override `types` and `files` as
        follows:
        
        ```yaml
        - id: curlylint
          types: [file] # restore the default `types` matching
          files: \.(html|sls)$
        ```
        
        ## Contributing
        
        See anything you like in here? Anything missing? We welcome all support, whether on bug reports, feature requests, code, design, reviews, tests, documentation, and more. Please have a look at our [contribution guidelines](CONTRIBUTING.md).
        
        If you just want to set up the project on your own computer, the contribution guidelines also contain all of the setup commands.
        
        ## Credits
        
        Image credit: [FxEmojis](https://github.com/mozilla/fxemoji).
        
        This project is a fork of [jinjalint](https://github.com/motet-a/jinjalint).
        
        Test templates extracted from third-party projects. View the full list in [`tests/README.md`](tests/README.md).
        
        View the full list of [contributors](https://github.com/thibaudcolas/curlylint/graphs/contributors). [MIT](https://github.com/thibaudcolas/curlylint/blob/master/LICENSE) licensed.
        
Keywords: curlylint,jinjalint,linter,jinja,jinja2,django templates,templates,html,twig
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: dev
