Moenda

What is Moenda:

Moenda is an engine built with Nodejs that analyzes a set of files from editable and user-defined rules and generates a report of these files.

Installation and Usage:

$ npm i moenda

$ ./node_modules/moenda.js --rules <rules-file.js> --path <files-dir/> --exclude <files-extensions> --config <config-file.js>
 
Basic Configuration:
 --rules               This option allows you to specify another file from which to load rules files rather then default. 
 --path                This option allows you to specify the path to the file(s) to be analyzed.
 --config              This option allows you to specify an additional configuration file for Moenda.
 --exclude             This option allows you to specify which file extensions Moenda must ignore.(optional)
 --context             This option allows you to generate a context for markdown files. (optional)

Rules

You can specify another file from which to load rules files using --rules option. This allows you to dynamically load new rules at run time. This is useful when you have custom rules that aren't suitable for being bundled with Moenda. Check it out our rules documentation to see how implement your custom rules.

Path

You can specify the path to the file(s) to be analyzed using --path option.

Exclude

You can specify extensions of file to be ignored using --exclude. So, Moenda will not looks to those files when running the rules.

Configuration

Use a JavaScript file to specify configuration information for your files. This should be in the form of an <configName>.js file. Moenda will look for the file that you specified on the command line using --config option.

const config = {
  ruleLineCounter: {limit:60},
  ruleLineAboveXCharacters: {limit:30},
  ruleFirstSectionStartsWithHx: {limit: 3},
  ruleConsecutiveBlankLines: {limit: 1}
}

module.exports = config;

Output

After run the command you'll see the report in your terminal.

$ moenda.js --rules /home/user/md-rules.js --path /home/user/sut --exclude html,java  --config configOne.js

/home/user/sut/file.js
12:76  error  "This line must not exceed 75 characters."     ruleLineAboveXCharacters()
51:-  error    "This file is expected to have a maximum of 50 lines"   ruleLineCounter()
62:- error     "This file is expected to have a maximum of 1 consecutive blank lines"     ruleConsecutiveBlankLines()

* 4 problem(s) (2 errors)
* 0 info(s)


/home/user/sut/markdown.md
1:4     error     The first section of the file does not start with H1     ruleFirstSectionStartsWithHx()
1:4     error     The file does not have increasing and decreasing sections     ruleNeighboringSections()
15:76   error     "This line must not exceed 75 characters."     ruleLineAboveXCharacters()
51:-  error    "This file is expected to have a maximum of 50 lines"   ruleLineCounter()

* 4 problem(s) (4 errors)
* 0 info(s)
  
$ moenda --rules /home/felipe/fork/Moenda/src/rules/MD/MDRules.js --path /home/felipe/fork/Moenda/README.md --config /home/felipe/fork/Moenda/src/config.js --context true


/home/felipe/fork/Moenda/README.md
-:-     info     The file has 94 line(s)     ruleLineCounter()
1:1     error     The first section of the file does not start with H3     ruleFirstSectionStartsWithHx()
5:31     error     This line must not exceed 30 characters.     ruleLineAboveXCharacters()
30:-     error     This file is expected to have a maximum of 1 consecutive blank lines     ruleConsecutiveBlankLines()
45:4     error     The file does not have increasing and decreasing sections     ruleNeighboringSections()
94:-     error     This file is expected to have a minimum of 600 lines     ruleLessThanXLines()

* 5 problem(s) (5 errors)
* 1 info(s)
{ 
  [
    { type: 'inLineCode', value: '`--path || ', line: 25, quantity: 1 },
    {
      type: 'link',
      value: 'https://github.com/SPLAB-UFCG/Moenda/blob/master/src/index.js#L260',
      line: 85,
      quantity: 1
    },
    {
      type: 'text',
      value: '    - Analyzes whether the file has more consecutive blank lines than allowed.',
      line: 86,
      quantity: 1
    },
    { type: 'section', value: 2, line: 91, quantity: 1 },
    { type: 'text', value: 'MIT © Moenda', line: 93, quantity: 1 }
  ],
  sections: 1,
  links: 1,
  lists: 0,
  images: 0,
  inLineCode: 1,
  texts: 2
}

Built-in Rules:

1. ruleLineCounter
   - Counts the file lines.
2. ruleLessThanXLines
   - Evaluates whether a file has fewer lines than necessary.
3. ruleLineAboveXCharacters
   - Evaluates whether a line has more characters than allowed.
4. ruleFirstSectionStartsWithHx
   - Analyzes whether the first section of the file is of the determined order.
5. ruleNeighboringSections
   - Analyzes whether sections have inconsistencies.
6. ruleInconsistencyOfSpaces
   - It finds spaces inconsistency.
7. ruleConsecutiveBlankLines
   - Analyzes whether the file has more consecutive blank lines than allowed.

Licença

MIT © Moenda