Skip to main content

check epitech c coding style

Project description

NorMatrix

check some norm for you

PyPI version python-version

windows+ubuntu+macos;3.9,3.10 NorMatrix Check

Codacy Badge

GitHub repo size GitHub language count GitHub top language GitHub last commit

install

with pipy

With Pipy

1

  • if you want some "stable" version:
pip install normatrix
  • if you want the most update to date version:
pip install git+https://github.com/Saverio976/NorMatrix.git

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

2

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 if you are using fish shell (the echo print /something/like/fish):

abbr --add 'normatrix' 'python3 -m normatrix'

else handle this yourself bruh;

3

to update it, you just have to run

pip install -U normatrix

4

to uninstall it (sad), run

pip uninstall normatrix

from source

From source

1

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

2

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;

3

to update it, just go where you have cloned normatrix run

git pull

4

to uninstall it (sad) Delete the folder

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] [--only-errors] [--no-fclean] [--link-line] [--tests-run]
                           [--output format]
                           [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                [deprecated][now it check always for the file] tells if you have a .normatrix config file
  --only-errors         print only bad files with errors
  --no-fclean           if you want normatrix dont do a "make fclean" at the end
  --link-line           to have the "link" to the file (in vscode terminal you can click it and it will open the file at the line of the error)
  --tests-run           run the unit tests for normatrix
  --output format       tell which output format to use [html, md, term_color, term_rich]; for html the file is normatrix-result.htlm; for md the
                        file is normatrix-result.md

(only from source) main.py

(only from source) main.py
usage: ./main.py [-h] [--no-operators-pluggin] [--preview] [--conf] [--only-errors] [--no-fclean] [--link-line] [--tests-run]
                           [--output format]
                           [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                [deprecated][now it check always for the file] tells if you have a .normatrix config file
  --only-errors         print only bad files with errors
  --no-fclean           if you want normatrix dont do a "make fclean" at the end
  --link-line           to have the "link" to the file (in vscode terminal you can click it and it will open the file at the line of the error)
  --tests-run           run the unit tests for normatrix
  --output format       tell which output format to use [html, md, term_color, term_rich]; for html the file is normatrix-result.htlm; for md the
                        file is normatrix-result.md

(only from source) exec.sh

(only from source) exec.sh

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

usage: ./main.py [-h] [--no-operators-pluggin] [--preview] [--conf] [--only-errors] [--no-fclean] [--link-line] [--tests-run]
                           [--output format]
                           [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                [deprecated][now it check always for the file] tells if you have a .normatrix config file
  --only-errors         print only bad files with errors
  --no-fclean           if you want normatrix dont do a "make fclean" at the end
  --link-line           to have the "link" to the file (in vscode terminal you can click it and it will open the file at the line of the error)
  --tests-run           run the unit tests for normatrix
  --output format       tell which output format to use [html, md, term_color, term_rich]; for html the file is normatrix-result.htlm; for md the
                        file is normatrix-result.md

(only from source) Makefile

(only from source) Makefile (deprecated)

(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, you can now configure what extension file are banned, and what are not,

all you have to do is put a file .normatrix.json where you execute normatrix

example with nothing banned and no preview (preview = not stable check) check .normatrix.json

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

just add inside [] the string of what you want

other explanation with example

other explanation with example
  • to no-banne memset (because you can use it)
{
    "no-banned": ["memset"]
}
  • to ban my_printf (because you dont want to use it)
{
    "banned": ["my_printf"]
}
  • to no-banne *.o file (because you dont need this warning)
{
    "no-extension": ["*.o"]
}
  • to banne *.c file (because you want c file banned)
{
    "extension": ["*.c"]
}
  • to enable preview check by default
{
    "enable-preview": true
}

by default there are somthing like this:

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

this configuration will be added even if you add a .normatrix.json file

but if you want to remove *.o, just add it to the no-extension

or you can put *.o in a .gitignore

it will remove it from the default

Run as a github workflow

this is not the latest normatrix but :

link : link

example example1

state : NorMatrix Check

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

  1. 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: pip install git+https://github.com/Saverio976/NorMatrix.git

    - name: NorMatrix
      run: python3 -m normatrix --only-errors
' > .github/workflows/normatrix_check.yml
  1. you can push the modification to github

Contribute

[more information on CONTRIBUTNG.md]

Alternatives

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

Xavier
Xavier Mitault
apps/github-actions/
apps/github-actions
Mizu/
Mizu
mE0w/
mE0w
Christophe
Christophe CHHOR

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

normatrix-0.4.0.tar.gz (27.9 kB view details)

Uploaded Source

Built Distribution

normatrix-0.4.0-py3-none-any.whl (47.5 kB view details)

Uploaded Python 3

File details

Details for the file normatrix-0.4.0.tar.gz.

File metadata

  • Download URL: normatrix-0.4.0.tar.gz
  • Upload date:
  • Size: 27.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.14

File hashes

Hashes for normatrix-0.4.0.tar.gz
Algorithm Hash digest
SHA256 b48774b61de1a0cdb5161bb8a2a216362b4ac0c4a907d2f1faed5130705da619
MD5 0188239e41d1003b6032e26e1879f19a
BLAKE2b-256 c347997fa677931fcd36faa15216e46dfa73fd22d900aa01059bbe16098f423e

See more details on using hashes here.

File details

Details for the file normatrix-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: normatrix-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 47.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.14

File hashes

Hashes for normatrix-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6e4982372ec65559ba64b97bc09ae585948214181a7eea8b3b7f46d144c94f79
MD5 b5349dd171480690211053a595130169
BLAKE2b-256 860a9ca1b11720c840e3f578577630d6c897385f4bc4f2a78ef4efa6faf52d00

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page