ec4j lint API

ec4j lint API for building linters. Default linters live in ec4j-linters

License	Apache License, Version 2.0
Categories	Maven Build Tools
GroupId	org.ec4j.maven
ArtifactId	ec4j-lint-api
Last Version	0.0.8
Release Date	Nov 6, 2018
Type	takari-jar
Description	ec4j lint API ec4j lint API for building linters. Default linters live in ec4j-linters

Download ec4j-lint-api

Filename	Size
ec4j-lint-api-0.0.8.pom
ec4j-lint-api-0.0.8.jar	31 KB
ec4j-lint-api-0.0.8-sources.jar	24 KB

Dependencies

compile (1)

Group / Artifact	Type	Version
org.ec4j.core : ec4j-core	jar	0.0.1

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

editorconfig-maven-plugin

editorconfig-maven-plugin is a Maven plugin for checking whether project files comply with format rules defined in .editorconfig files and eventually also for fixing the violations.

⚠️	editorconfig-maven-plugin is new. Expect issues of all kinds which is not to say that you should not report them :)

Basic usage

editorconfig-maven-plugin requires Java 7+ and Maven 3.3.1+.

To make the build fail if any of your source files does not comply with .editorconfig rules, add the following to your project:

  <plugin>
    <groupId>org.ec4j.maven</groupId>
    <artifactId>editorconfig-maven-plugin</artifactId>
    <version><!-- check the latest on http://central.maven.org/maven2/org/ec4j/maven/editorconfig-maven-plugin/ --></version>
    <executions>
      <execution>
        <id>check</id>
        <phase>verify</phase>
        <goals>
          <goal>check</goal>
        </goals>
      </execution>
    </executions>
    <configuration>
      <!-- See http://ec4j.github.io/editorconfig-maven-plugin/ for full configuration reference -->
      <excludes>
        <!-- Note that maven submodule directories and many non-source file patterns are excluded by default -->
        <!-- - see https://github.com/ec4j/editorconfig-linters/blob/master/editorconfig-lint-api/src/main/java/org/ec4j/lint/api/Constants.java#L37
        <!-- You can exclude further files from processing: -->
        <exclude>src/main/**/*.whatever</exclude>
      </excludes>
      <!-- All files are included by default:
      <includes>
        <include>**</include>
      </includes>
      -->
    </configuration>
  </plugin>

In case any violations are detected, you may want to fix them automagically by running

mvn editorconfig:format

Configuration

See editorconfig:check and editorconfig:format.

How it works

editorconfig-maven-plugin is designed around the Linter interface. Linter is a processor specialized for some particular file format (such as YAML or XML) for which it can detect whether some particular .editorconfig properties are satisfied and eventually propose a fix that can be applied automatically.

Table 1. Linters available in editorconfig-maven-plugin

Class name	Default includes	Default excludes	Supported .editorconfig properties
TextLinter	**/*		end_of_line, trim_trailing_whitespace, insert_final_newline
XmlLinter	**/*.xml, **/*.xsl		indent_style, indent_size

Contributions of further Linters are highly welcome! Please open an issue when you start working on something to avoid duplicate work.

How to build

Prerequisites:

• Java 7+

• Optionally Maven 3.5.0+, unless you want to use ./mvnw or mvnw.bat delivered by the project

The most common build with unit tests:

./mvnw clean install

On Windows:

.\mvnw.cmd clean install

Misc.

• All code and contributions are under Apache License

• Issues and Discussions: https://github.com/ec4j/editorconfig-maven-plugin/issues

EditorConfig tools for Java

Versions

Version
0.0.8 Nov 6, 2018
0.0.7 Oct 28, 2018
0.0.6 Oct 3, 2018
0.0.5 Feb 6, 2018
0.0.4 Jan 28, 2018
0.0.3 Jan 21, 2018
0.0.2 Jan 11, 2018