https://github.com/amooo-ooo/pep8plus
Online syntax checker built for educational institutions to help students enforce Python programming standards.
https://github.com/amooo-ooo/pep8plus
flake8 flask full-stack online pep8 pep8-checker python ruff svelte
Last synced: about 2 months ago
JSON representation
Online syntax checker built for educational institutions to help students enforce Python programming standards.
- Host: GitHub
- URL: https://github.com/amooo-ooo/pep8plus
- Owner: amooo-ooo
- License: mit
- Created: 2023-09-28T09:34:35.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-06-17T02:38:14.000Z (about 1 year ago)
- Last Synced: 2025-06-17T03:29:24.856Z (about 1 year ago)
- Topics: flake8, flask, full-stack, online, pep8, pep8-checker, python, ruff, svelte
- Language: Svelte
- Homepage: http://pep8plus.com
- Size: 679 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
pep8plus
Online Python syntax checker for educational institutions.
# pep8plus
pep8plus is an open-source online tool built for educational institutions to help students enforce and maintain Python programming standards. Powered by Ruff, Flake8 and Pylint, pep8plus is built on the principle of customisability, ease of use and user experience.
> **Warning**
> Project is in beta. Hence, bugs and ironically, questionable programming practices may be present.
## Features
Here are a few major features of pep8plus:
- Customisation:
pep8plus offers three different popular linters: Ruff, Pylint and Flake8. With over 800 built-in convention guides and rules combined, all convention settings are able to be easily activated and deactivated to share with students.
- Shareability:
Easily share customised convention settings with students by generating a custom link.
- Open-source:
pep8plus gives the opportunity for institutions to host the project and implement their own conventions and plugins.
and more!
# Categories
Convention rules are given tags which are colour-coded based on their severity.
| Colour | Severity | Description |
| ------------- | ----------------- | ------------------------------------------------------------------------- |
| `#EB514C` | `error` | There is an error or some sort of issue with the code. |
| `#FF7B72` | `syntax-error` | Convention error is found within the code. |
| `#FFB618` | `severe-warning` | High priority warning with code's syntax. |
| `#FFA657` | `warning` | Warning with code's syntax |
| `#D2A8ff` | `complex` | Complex convention issues. (For more experienced developers) |
| `#524669` | `super-complex` | More complex convention issues. (For more experienced developers) |
| `#79C0FF` | `neutral` | Neutral convention issues with syntax. |
# Quick Start
```shell
git clone https://github.com/amooo-ooo/pep8plus
```
## Setup
Setup dependencies by running the following on the terminal:
```shell
cd api
poetry install
cd ../web
bun install
```
## Hosting
Simply run `python server.py` to host the project:
```shell
python server.py
```
## Support
pep8plus was created as a school project with the aspiration of helping other young Pythonistas enforce and learn python coding practices. The purpose of this project is to provide educators with a transparent, customisable and easy solution to helping their students enforce Python conventions.
## TODO's
[ ] Add new Ruff & Pylint Rules
[ ] Automate commits of new rules