Python Flask Json Guide

Cursor-Regel für einheitliche JSON-Antworten und Fehlerformate in Flask-APIs.

Original-Beschreibung der Autoren: Cursor rules for Python Flask development with JSON guide.

Die Regel

---
description: "Cursor rules for Python Flask development with JSON guide."
globs: **/*
alwaysApply: false
---
This project is heavily reliant on our custom Drawscape Factorio python module.

Here is code examples of how to use the module:

```python
from drawscape_factorio import create as createFactorio
from drawscape_factorio import importFUE5

with open('/path/to/exported-entities.json', 'r') as file:
    json_data = json.load(file)
    data = importFUE5(json_data)
    result = createFactorio(data, {
        'theme_name': 'default',
        'color_scheme': 'main',
        'show_layers': ['assets', 'belts', 'walls', 'rails', 'electrical', 'spaceship']
    })

with open(output_file_name, 'w') as f:
    f.write(result['svg_string'])

So nutzt du sie

Die Regel kopieren (Button oben) oder als Datei herunterladen und im Projekt unter .cursor/rules/ ablegen — Cursor lädt sie beim nächsten Start automatisch. Ältere Cursor-Versionen lesen alternativ eine einzelne .cursorrules-Datei im Projektstamm; dort einfach den Regel-Text ohne den Kopfblock zwischen den ----Zeilen einfügen.

Der Regel-Text ist englisch — Cursor versteht ihn unabhängig von der Sprache, in der Sie mit dem Editor chatten.

Im Detail

Diese Cursor-Regel bringt Flask-APIs auf ein einheitliches Antwortformat: Erfolgsmeldungen und Fehler folgen immer demselben JSON-Schema (z. B. feste Felder für Status, Daten und Fehlermeldung), statt dass jeder Endpoint sein eigenes Format erfindet. Der Vorteil gegenüber Ad-hoc-Lösungen zeigt sich vor allem, sobald mehrere Endpoints oder mehrere Entwickler am selben Projekt arbeiten – uneinheitliche Fehlerformate sind sonst eine häufige Quelle für Frontend-Bugs. Für ein einzelnes kleines Skript oder einen Prototyp mit nur einem Endpoint lohnt sich der Aufwand kaum, dort reicht ein einfacher jsonify-Aufruf.

Praxis-Tipp

Legen Sie die Regel im Cursor-Projekt ab und lassen Sie testweise einen neuen Endpoint erzeugen, z. B. mit dem Prompt „Erstelle eine Flask-Route /orders mit Validierungsfehlern als JSON“ – prüfen Sie, ob das Fehlerformat zu bestehenden Endpoints passt.

Lizenz & Quelle

• Lizenz: CC0 1.0
• Quelle: PatrickJS/awesome-cursorrules (GitHub)

Lade …