Demo Documentation Management

# app.py
import csv
import sqlite3
import os
from flask import Flask, render_template, request, redirect, url_for, flash, session, g
from datetime import datetime
import hashlib
import logging

# Initialize Flask app
app = Flask(__name__)
app.config['SECRET_KEY'] = 'dev'  # Change this to a random secret key in production
app.config['DATABASE'] = os.path.join(app.instance_path, 'task_manager.sqlite')

def read_csv(file_path):
    """
    Read data from a CSV file and print each row.

    Args:
        file_path (str): Path to the CSV file to be read.

    Returns:
        None: This function prints each row to the console but does not return a value.

    Example:
        >>> read_csv('data.csv')
        ['header1', 'header2', 'header3']
        ['value1', 'value2', 'value3']
    """
    with open(file_path, 'r', newline='') as f:
        csvreader = csv.reader(f)
        for row in csvreader:
            print(row)

# Ensure the instance folder exists
os.makedirs(app.instance_path, exist_ok=True)

# Database connection functions
def get_db():
    """Return a SQLite3 connection stored on the application context `g`."""
    if 'db' not in g:
        g.db = sqlite3.connect(
            app.config['DATABASE'],
            detect_types=sqlite3.PARSE_DECLTYPES
        )
        g.db.row_factory = sqlite3.Row
    return g.db

def close_db(e=None):
    """Close the database connection if it exists on `g`."""
    db = g.pop('db', None)
    if db is not None:
        db.close()

@app.route('/task/create', methods=['POST'])
def create_task():
    """Create a new task and redirect to the dashboard."""
    return redirect(url_for('dashboard'))

@app.route('/task/<int:id>/update', methods=['POST'])
@login_required
def update_task(id):
    """
    Update an existing task's status and assignment.

    Args:
        id (int): Task ID.

    Returns:
        werkzeug.wrappers.Response: Redirect to dashboard with a success message.
    """
    status = request.form['status']
    assigned_to = request.form['assigned_to']

    db = get_db()
    db.execute(
        'UPDATE tasks SET status = ?, assigned_to = ? WHERE id = ?',
        (status, assigned_to, id)
    )
    db.commit()
    flash('Task updated successfully!')
    return redirect(url_for('dashboard'))

@app.route('/task/<int:id>/delete', methods=['POST'])
@login_required
def delete_task(id):
    """
    Delete a task by ID.

    Args:
        id (int): Task ID.

    Returns:
        werkzeug.wrappers.Response: Redirect to dashboard with a success message.
    """
    db = get_db()
    db.execute('DELETE FROM tasks WHERE id = ?', (id,))
    db.commit()
    flash('Task deleted successfully!')
    return redirect(url_for('dashboard'))

# Create a documentation rule file specifying standards
rule_file_path = '.cursor/rules/documentation-standards.mdc'

# Define the content of the rule file
rule_content = """# Documentation Standards
When generating documentation, follow these guidelines:

- Use clear and concise language
- Create documentation that is PEP 8 compliant
- Include code examples for better understanding
- Ensure all parameters and return values are documented
- Use consistent formatting and style
- Avoid jargon and overly technical terms
- Provide links to external references when applicable
- Include usage examples for complex functions or classes
"""

# Write the content to the rule file
with open(rule_file_path, 'w') as file:
    file.write(rule_content)