Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/42School/norminette
Official 42 norminette
https://github.com/42School/norminette
Last synced: 2 months ago
JSON representation
Official 42 norminette
- Host: GitHub
- URL: https://github.com/42School/norminette
- Owner: 42School
- License: mit
- Created: 2020-05-14T14:04:26.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-07-30T21:08:57.000Z (6 months ago)
- Last Synced: 2024-07-31T04:57:33.568Z (6 months ago)
- Language: Python
- Homepage:
- Size: 14.5 MB
- Stars: 890
- Watchers: 22
- Forks: 132
- Open Issues: 84
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-42 - norminette - Official v3 repository. (Tools / Norminette)
README
# norminette for 42 schools
## Install
Requires python3.8+ (3.8, 3.9, 3.10, 3.11)
### Directly inside your global commands
Install using pip.
```shell
python3 -m pip install --upgrade pip setuptools
python3 -m pip install norminette
```
Install using pipx.
```shell
sudo apt update
sudo apt install python3-setuptools
sudo apt install pipx
pipx install norminette
pipx ensurepath
```
Install using a virtual environment.
```shell
python3 -m venv $HOME/.venv
source $HOME/.venv/bin/activate
python3 -m pip install --upgrade pip setuptools
python3 -m pip install norminette
echo "export PATH=\$PATH:$HOME/.venv/bin" >> $HOME/.${SHELL##/bin/}rc
deactivate
```
To upgrade an existing install, use
```shell
python3 -m pip install --upgrade norminette
```
## Usage
- Runs on the current folder and any subfolder:
```
norminette
```
- Runs on the given filename(s):
```
norminette filename.[c/h]
```
- Prevents stopping on various blocking errors:
```
norminette -d
```
- Outputs all the debug logging:
```
norminette -dd
```
## Docker usage
```
docker build -t norminette .
cd ~/42/ft_printf
docker run --rm -v $PWD:/code norminette
```
If you encounter an error or an incorrect output, you can:
- Open an issue on github
- Post a message on the dedicated slack channel (#norminette-v3-beta)
Please try to include as much information as possible (the file on which it crashed, etc)
Feel free to do pull requests if you want to help as well. Make sure that run_test.sh properly runs after your modifications.
## Run for development
This new version uses poetry as a dependency manager.
If you want to contribute:
```shell
poetry install
# Run dev norminette
poetry run norminette
# Or... with virtual env
source .venv/bin/activate
norminette
# Run tests
poetry run pytest
```