use ruff as our one only linter, fix bandit

Author: irvingpop

.bandit

@@ -1,2 +1,2 @@
 [bandit]
-exclude: ./src/tests/*
+exclude=src/tests/*,.venv,__pycache__,*.pyc,migrations/*

.flake8

@@ -51,14 +51,11 @@ jobs:
         if: steps.cached-venv.outputs.cache-hit != 'true'
         run: poetry install --only dev --no-interaction
 
-      - name: Run Black formatter check
-        run: poetry run black --check .
+      - name: Run Ruff linter
+        run: poetry run ruff check .
 
-      - name: Run isort import check
-        run: poetry run isort --check-only .
-
-      - name: Run Flake8 linter
-        run: poetry run flake8 .
+      - name: Run Ruff formatter check
+        run: poetry run ruff format --check .
 
   test:
     name: Test
@@ -162,10 +159,10 @@ jobs:
         run: poetry install --no-interaction
 
       - name: Run Bandit security linter
-        run: poetry run bandit -r . --skip B101 -f json -o bandit-report.json || true
+        run: poetry run bandit -r src --skip B101 -f json -o bandit-report.json || true
 
       - name: Display Bandit results
-        run: poetry run bandit -r . --skip B101 -f txt || true
+        run: poetry run bandit -r src --skip B101 -f txt || true
 
   # Final status check for branch protection
   ci-success:

.github/workflows/ci.yml

@@ -0,0 +1,82 @@
+.PHONY: help install lint lint-fix format test test-unit test-integration test-cov security ci migrate createsuperuser runserver shell clean
+
+# Default target
+help:
+	@echo "Available commands:"
+	@echo "  make install          - Install dependencies with poetry"
+	@echo "  make lint             - Run ruff linter and formatter check"
+	@echo "  make lint-fix         - Auto-fix linting and formatting issues"
+	@echo "  make format           - Format code with ruff"
+	@echo "  make test             - Run all tests"
+	@echo "  make test-unit        - Run unit tests only"
+	@echo "  make test-integration - Run integration tests only"
+	@echo "  make test-cov         - Run tests with coverage report"
+	@echo "  make security         - Run bandit security scanner"
+	@echo "  make ci               - Run all CI checks (lint, test-cov, security)"
+	@echo "  make migrate          - Run Django migrations"
+	@echo "  make createsuperuser  - Create Django superuser"
+	@echo "  make runserver        - Run Django development server"
+	@echo "  make shell            - Open Django shell"
+	@echo "  make clean            - Remove Python cache files and test artifacts"
+
+# Install dependencies
+install:
+	poetry install
+
+# Linting and formatting
+lint:
+	poetry run ruff check .
+	poetry run ruff format --check .
+
+lint-fix:
+	poetry run ruff check --fix .
+	poetry run ruff format .
+
+format:
+	poetry run ruff format .
+
+# Testing
+test:
+	cd src && poetry run pytest
+
+test-unit:
+	cd src && poetry run pytest tests/unit/
+
+test-integration:
+	cd src && poetry run pytest tests/integration/
+
+test-cov:
+	cd src && DJANGO_ENV=testing ENVIRONMENT=TEST SECRET_KEY=test-secret-key poetry run pytest --cov=. --cov-report=xml --cov-report=term-missing -v
+
+# Security
+security:
+	poetry run bandit -r src --skip B101 -f txt
+
+# CI - runs all checks that CI will run
+ci: lint test-cov security
+	@echo ""
+	@echo "✓ All CI checks passed!"
+
+# Django commands
+migrate:
+	poetry run python src/manage.py migrate
+
+createsuperuser:
+	poetry run python src/manage.py createsuperuser
+
+runserver:
+	poetry run python src/manage.py runserver
+
+shell:
+	poetry run python src/manage.py shell
+
+# Cleanup
+clean:
+	find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
+	find . -type f -name "*.pyc" -delete
+	find . -type f -name "*.pyo" -delete
+	find . -type d -name ".pytest_cache" -exec rm -rf {} + 2>/dev/null || true
+	find . -type f -name ".coverage" -delete
+	find . -type f -name "coverage.xml" -delete
+	rm -rf .ruff_cache htmlcov
+	@echo "✓ Cleaned up Python cache files and test artifacts"

Makefile

@@ -3,7 +3,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![Twitter Follow](https://img.shields.io/twitter/follow/operation_code.svg?style=social&label=Follow&style=social)](https://twitter.com/operation_code)
-[![Code-style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
 
 
 [![CircleCI](https://circleci.com/gh/OperationCode/back-end.svg?style=svg)](https://circleci.com/gh/OperationCode/back-end)
@@ -36,33 +36,77 @@ Recommended versions of tools used within the repo:
 
 ```bash
 # Install dependencies (ensure poetry is already installed)
-# if you are encountering an error with psycopg2 during poetry installation, ensure postgreqsql is installed (macOS: brew install postgresql)
-poetry install
+# If you are encountering an error with psycopg2 during poetry installation,
+# ensure PostgreSQL is installed (macOS: brew install postgresql)
+make install
 
 # Create database
 # By default this creates a local sqlite database and adds tables for each of the defined models
-# see example.env for database configurations
-poetry run python src/manage.py migrate
+# See example.env for database configurations
+make migrate
 
 # Create a superuser to add to the new database
-poetry run python src/manage.py createsuperuser 
+make createsuperuser
 
-# Run local development
-poetry run python src/manage.py runserver
+# Run local development server
+make runserver
+```
+
+## Development Workflow
+
+### Running Tests
+```bash
+# Run all tests
+make test
+
+# Run only unit tests
+make test-unit
 
-# Run testing suite
-poetry run pytest
+# Run only integration tests
+make test-integration
 
-# Run formatting and linting
-poetry run black .
-# the next line shouldn't output anything to the terminal if it passes
-poetry run flake8
-poetry run isort .
+# Run tests with coverage report
+make test-cov
 ```
 
-## Running [Bandit](https://github.com/PyCQA/bandit)
-Bandit is a tool designed to find common security issues in Python code. 
+### Linting and Formatting
+We use [Ruff](https://github.com/astral-sh/ruff) for both linting and code formatting.
 
-From within the `back-end/` directory you can run the following Bandit command: 
+```bash
+# Check linting and formatting (doesn't modify files)
+make lint
 
-- `bandit -r .` runs all bandit tests recursively with only filters defined in the `.bandit` file.
+# Auto-fix linting issues and format code
+make lint-fix
+
+# Format code only
+make format
+```
+
+### Security Scanning
+[Bandit](https://github.com/PyCQA/bandit) is a tool designed to find common security issues in Python code.
+
+```bash
+# Run security scanner
+make security
+```
+
+### CI Checks
+Run all the same checks that CI will run:
+
+```bash
+# Run all CI checks (linting, tests with coverage, security)
+make ci
+```
+
+### Other Commands
+```bash
+# Open Django shell
+make shell
+
+# Clean up Python cache files and test artifacts
+make clean
+
+# See all available commands
+make help
+```