Code Documentation Generator агент

/**
 * Calculates the compound interest for a given principal amount
 * @param {number} principal - The initial amount of money
 * @param {number} rate - The annual interest rate (as decimal, e.g., 0.05 for 5%)
 * @param {number} time - The time period in years
 * @param {number} [compoundFreq=1] - How many times interest is compounded per year
 * @returns {number} The final amount after compound interest
 * @throws {Error} When principal, rate, or time are negative
 * @example
 * // Calculate $1000 at 5% for 2 years, compounded monthly
 * const result = calculateCompoundInterest(1000, 0.05, 2, 12);
 * console.log(result); // 1104.89
 */
function calculateCompoundInterest(principal, rate, time, compoundFreq = 1) {
  if (principal < 0 || rate < 0 || time < 0) {
    throw new Error('Principal, rate, and time must be non-negative');
  }

  return principal * Math.pow((1 + rate / compoundFreq), compoundFreq * time);
}

def process_user_data(user_input: dict, validation_rules: list[str]) -> dict:
    """
    Validates and processes user input data according to specified rules.

    This function applies a series of validation rules to user input,
    sanitizes the data, and returns a cleaned version suitable for
    database storage or API responses.

    Args:
        user_input (dict): Raw user data from form submission or API request.
            Expected keys: 'email', 'name', 'age', 'preferences'
        validation_rules (list[str]): List of validation rule names to apply.
            Valid rules: 'email_format', 'name_length', 'age_range', 'sanitize_html'

    Returns:
        dict: Processed user data with validated and sanitized fields.
            Contains same keys as input plus 'validation_status' field.

    Raises:
        ValidationError: When required fields are missing or invalid.
        ValueError: When validation_rules contains unknown rule names.

    Example:
        >>> user_data = {'email': 'user@example.com', 'name': 'John', 'age': 25}
        >>> rules = ['email_format', 'name_length', 'age_range']
        >>> result = process_user_data(user_data, rules)
        >>> print(result['validation_status'])
        'passed'

    Note:
        This function modifies a copy of the input data and never
        mutates the original user_input dictionary.
    """
    # Implementation here
    pass

## POST /api/v1/users

Creates a new user account in the system.

### Authentication
Requires valid API key in `Authorization` header: `Bearer <api_key>`

### Request Body
```json
{
  "email": "user@example.com",
  "name": "John Doe",
  "role": "user",
  "preferences": {
    "newsletter": true,
    "notifications": false
  }
}

# Project Name

> Brief, compelling description of what the project does

[![Build Status](badge-url)](link) [![License](badge-url)](link)

## Features

- ✨ Key feature with benefit
- 🚀 Another important capability
- 🔧 Technical highlight

## Quick Start

```bash
# Installation
npm install project-name

# Basic usage
const project = require('project-name');
project.doSomething();

git clone https://github.com/user/project.git
cd project
npm install
npm run dev