normatrix 0.2.12

check epitech c coding style

NorMatrix

check some norm for you

install

With Pipy

with pipy

pip install normatrix

Now you can use it with python3 -m normatrix in your terminal

And if you want to just write normatrix :

echo $SHELL

if you are using bash shell (the echo print /something/bash):

echo alias normatrix=\"python3 -m normatrix\" >> $HOME/.bashrc

else if you are using zsh shell (the echo print /something/like/zsh):

echo alias normatrix=\"python3 -m normatrix\" >> $HOME/.zshrc

else handle this yourself bruh;

From source

from source

git clone https://github.com/Saverio976/NorMatrix.git
cd NorMatrix

Now you can use it with ./path/to/folder/NorMatrix/main.py in your terminal

And if you want to just write normatrix :

echo $SHELL

if you are using bash shell (the echo print /something/bash):

echo alias normatrix=\"$PWD/main.py\" >> $HOME/.bashrc

else if you are using zsh shell (the echo print /something/like/zsh):

echo alias normatrix=\"$PWD/main.py\" >> $HOME/.zshrc

else handle this yourself bruh;

Current Checks

• 80 cols per line
• space/tab alone (in a line)/(at the end of line)
• two newline at end of file
• two newline between function (between all buf chhhtt)
• libc function call (pr welcome to add some libc function always banned)
• nested branch more than 3 branch
• no more than 20 lines per function
• comma with no space after
• end of parenthesis with a open curly bracket next ){
• star char * like this char* buf
• preprocessors indentations (#if.., #endif)
• multiple statements
• 5 functions per file
• filename of source code only snake_case
• no line break at end of file
• 5+5 7/9 that need a space (but some false positiv goes in)
• no space after [ and space before ]
• header
• #define in .c
• make + check exe if the compiler add some banned function
• ...

doc

(if you use pipy) python -m normatrix

(if you use pipy) python -m normatrix

usage: python -m normatrix [-h] [--no-operators-pluggin] [--preview] [--conf] [paths ...]

The C Epitech Coding Style Norm Checker

positional arguments:
  paths                 list of path to check (default: the current working directory)

  options:
    -h, --help            show this help message and exit
    --no-operators-pluggin
                          remove the operators pluggin (because it print some false positiv for now)
    --preview             add some plugin that are added recently
    --conf                tells if you have a .normatrix config file

source: https://github.com/Saverio976/NorMatrix

(only from source) main.py

(only from source) main.py

usage: python -m normatrix [-h] [--no-operators-pluggin] [--preview] [--conf] [paths ...]

The C Epitech Coding Style Norm Checker

positional arguments:
  paths                 list of path to check (default: the current working directory)

  options:
    -h, --help            show this help message and exit
    --no-operators-pluggin
                          remove the operators pluggin (because it print some false positiv for now)
    --preview             add some plugin that are added recently
    --conf                tells if you have a .normatrix config file

source: https://github.com/Saverio976/NorMatrix

(only from source) exec.sh

(only from source) exec.sh

(this file exists only to keep compatibility to older version)

usage: python -m normatrix [-h] [--no-operators-pluggin] [--preview] [--conf] [paths ...]

The C Epitech Coding Style Norm Checker

positional arguments:
  paths                 list of path to check (default: the current working directory)

  options:
    -h, --help            show this help message and exit
    --no-operators-pluggin
                          remove the operators pluggin (because it print some false positiv for now)
    --preview             add some plugin that are added recently
    --conf                tells if you have a .normatrix config file

source: https://github.com/Saverio976/NorMatrix

(only from source) Makefile

(only from source) Makefile

(this file exists only to keep compatibility to older version) (if you can, move to another choice)

USAGE:
    make -C path/to/NorMatrix PATH_CHECK=$PWD
DESCRIPTION:
    check the norm! in the current working directory
    (call main.py)
ARGS:
    -C path/to/NorMatrix    run the makefile that is in path/to/NorMatrix
                            instead of the one where you are

    PATH_CHECK=$PWD	        check the norm in your current working
                            directory

configuration

you can now configure what functions are banned, and what are not,

or add some file extension that not be present when you do a normatrix.

all you have to do is add --conf when execute normatrix and put a file .normatrix.json where is the folder that you want to check with this:

.normatrix.json

{
    "banned": [],
    "no-banned": [],
    "no-extension": []
    "enable-preview": true
}

just add inside [] string of what you want

for example to no-banned memset (because you can use it)

{
    "no-banned": ["memset"]
}

by default (and default configuration will be load before yours) there are somthing like this:

{
    "banned": ["printf", "memset", "strcpy", "strcat", "calloc"],
    "no-banned": [],
    "no-extension": [".a", ".o", ".so", ".gch", "~", "#", ".d"]
    "enable-preview": false
}

example if you run it as a github workflow

this is not the latest normatrix but :

link : link

state :

(N.B. : this workflow pass well, but it will not if you copy the code below)

run it as a github workflow

in the repo root :

mkdir .github
mkdir .github/workflows
echo '
name: NorMatrix Check

on: [push]

jobs:
  norm:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2

    - name: set up python
      uses: actions/setup-python@v2
      with:
        python-version: '3.9'

    - name: clone NorMatrix
      run: git clone https://github.com/Saverio976/NorMatrix.git

    - name: NorMatrix
      run: ./NorMatrix/main.py
' > .github/workflows/normatrix_check.yml

Contribute

[more information on CONTRIBUTNG.md]

special thanks

• chempa for his sample of file that dont follow the epitech norm
• and invisble testers that says "bha baah normatrix have a bug"

contributors