devreplay v1.12.0

Devreplay

Devreplay is a static analysis tool based on your own programming rule. This README.md introduced DevReplay rules information and CLI environment. Please check the following link for other platform information.

• Visual Studio Code (VS Code)
• Other Editor Support (Language Server)
• GitHub Actions

How to use

1. Install on local

npm install -g devreplay
# or
yarn global add devreplay

2. Put your own programming rule(.devreplay.json) on the project like bellow

{
  "before": [
    "(?<tmp>.+)\\s*=\\s*(?<a>.+)",
    "\\k<a>\\s*=\\s*(?<b>.+)",
    "\\k<b>\\s*=\\s*\\k<tmp>"
  ],
  "after": [
    "$2, $3 = $3, $2"
  ],
  "isRegex": true
}

3. Run the devreplay

devreplay yourfile.py

or get fixed code

devreplay --fix yourfile.py

The target source code file will be

- tmp = a
- a = b
- b = a
+ a, b = b, a

• Step up: Make the rule message and severity. Also after can be more abstract

{
  "before": [
    "(?<tmp>.+)\\s*=\\s*(?<a>.+)",
    "\\k<a>\\s*=\\s*(?<b>.+)",
    "\\k<b>\\s*=\\s*\\k<tmp>"
  ],
  "after": [
    "$2, $3 = $3, $2"
  ],
  "isRegex": true,
  "author": "Yuki Ueda",
  "message": "Value exchanging can be one line",
  "severity": "Information"
}

• severity means how this rule is important

  • E: Error
  • W: Warning
  • I: Information
  • H: Hint

• Run devreplay again

$ devreplay yourfile.py
./yourfile.py
  15:1  warning  Value exchanging can be one line  0

Make rules

A JSON object represents a rule. The rule file .devreplay.json consists of a single rule or an array of rules.

Each rule comprises a pair of the before and after properties.

• before property is the only DevReplay required property to find code fragments and show warnings for them.
• after property is necessary for an automatic fix.

If the property is not specified, DevReplay shows a warning message. A value of the properties is either a single string or a string array. Using the array format, DevReplay finds and replaces the consecutive lines of code.

How to use Regular Expression

isRegex option regards the pattern specified in the before property as a regular expression. DevReplay uses the standard regular expression specified in ECMAScript 5. For example, the before property in the following example uses two ([a-z]+) representing any one or more characters.

In the after property, $1 and $2corresponds to the value enclosed in parentheses in the before property. Automatically generated coding rules enabled this option by default.

{
  "before": [
    "([a-z]+)-([a-z]+)"
  ],
  "after": [
      "$1 $2"
  ],
  "isRegex": true
}

That will fix

- print("hello-world")
+ print("hello world")

More rule options

Supported Languages and Frameworks

You can enable built-in rules by writing a language or framework name directly in a rule file. For example, the following rule file enables TypeScript and Python rules. The built-in rules are defined in src/rules/[language-or-framework-name].ts files.

[
  "TypeScript",
  "Python",
]

API Usage

You can use devreplay as a TypeScript API.

import {DevReplayRule, BaseRule2DevReplayRule, fixWithRules} from 'devreplay';

const rules: DevReplayRule[] = [{
    before: [
      '([a-z]+)-([a-z]+)'
    ],
    after: [
        '$1 $2'
    ],
    isRegex: true
},
{
  before: [
    'for \\(let (?<i>.+) = 0;\\k<i> < (?<arr>.+).length;\\k<i>\\+\\+\\) (.*)\\(\\k<arr>\\[\\k<i>\\]\\)'
  ],
  after: [
    'for (let $1 = 0;$1 < $2.length;i++) {',
    '    $3($2[$1])',
    '}'
  ],
  isRegex: true,
  message: 'One line for should use paren'
}].map(rule => BaseRule2DevReplayRule(rule, 0));

const fixed = fixWithRules('print("hello-world")', rules)
/*
'print("hello world")'
*/
console.log(fixed)

const fixed2 = fixWithRules('for (let i = 0;i < arr.length;i++) foo(arr[i])', rules)
/*
for (let i = 0;i < arr.length;i++) {
  foo(arr[i])
}
*/
console.log(fixed2)

GitHub Actions

Please copy the following .github/workflows/devreplay.yml file to your repository.

name: Devreplay
on: [push, pull_request]
jobs:
  devreplay:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-node@v2
        with:
          node-version: "14.x"
      - run: npm install -g devreplay
      - name: Run devreplay
        run: devreplay ./ .devreplay.json

Contribution Link

TODO

• Support rule ignoring comments
• Support .devreplayignore file
• Make rule generating GUI

License

MIT © 2019 Yuki Ueda ikuyadeu0513@gmail.com (ikuyadeu.github.io)