🏠 Домашнее задание

📋 Формулировка задания

🔧 Шаг 0. Подготовка окружения

Перед началом работы настройте рабочее окружение. Эти шаги одинаковы для всех уроков.

# Или в терминале VS Code (Ctrl + `):
mkdir python-fundamentals-practice
cd python-fundamentals-practice

git init

# Создайте базовые файлы
echo "# Python Fundamentals — Практические работы" > README.md
echo "venv/" > .gitignore
echo "__pycache__/" >> .gitignore
echo "*.pyc" >> .gitignore
echo ".env" >> .gitignore
echo "reports/" >> .gitignore

git add README.md .gitignore
git commit -m "init: базовая структура репозитория"

# Структура: lesson-XX/
mkdir -p lesson-53
cd lesson-53

# Windows (PowerShell / CMD)
python -m venv venv
venv\Scripts\activate

# Mac / Linux
python3 -m venv venv
source venv/bin/activate

# Вернитесь в корень репозитория
cd ../..

# Создайте и переключитесь на ветку
git checkout -b lesson/53-practice-13

# Отправьте ветку на удалённый репозиторий (если настроен)
git push -u origin lesson/53-practice-13

🛠️ Шаги выполнения задания

Теперь, когда окружение готово, приступайте к решению.

Olivia Suarez,2024-08-02,4565,Electronics,Dallas
Jennifer Jacobs,2023-08-19,4963,Automotive,London
Erin Johnson,2024-08-29,1796,Clothing,Miami
Cynthia Maddox,2025-02-01,538,Electronics,Chicago
Kendra Martinez,2025-02-01,3799,Electronics,New York
Rachel Miller,2025-02-02,1097,Electronics,Boston
Michael Brown,2024-12-15,8200,Automotive,Seattle
Sarah Davis,2025-01-10,1500,Clothing,Los Angeles
John Wilson,2025-01-12,2300,Electronics,Houston
Emma Taylor,2025-02-05,6500,Groceries,Phoenix

def read_sales_data(file_path):
    sales = []
    with open(file_path, "r", encoding="utf-8") as file:
        for line in file:
            parts = line.strip().split(",")
            if len(parts) != 5:
                continue
            name, date, amount, category, city = parts
            year, month, day = date.split("-")
            sales.append({
                "name": name,
                "date": date,
                "amount": int(amount),
                "category": category,
                "year": year,
                "month": month,
            })
    return sales

from collections import defaultdict

grouped_sales = defaultdict(list)
category_totals = defaultdict(lambda: defaultdict(int))

for record in sales:
    key = (record["year"], record["month"], record["category"])
    grouped_sales[key].append(record)
    category_totals[(record["year"], record["month"])][record["category"]] += record["amount"]

import sys

if len(sys.argv) < 3:
    print("Usage: python sales_report.py <input_file> <output_directory>")
    sys.exit(1)

input_file = sys.argv[1]
output_directory = sys.argv[2]

✅ Полное решение

Ниже приведён эталонный вариант. Совет: попробуйте выполнить задание самостоятельно, прежде чем смотреть ответ.

# sales_report.py
import os
import sys
from collections import defaultdict


def read_sales_data(file_path):
    """Считывает данные из .txt файла и возвращает список записей."""
    sales = []

    with open(file_path, "r", encoding="utf-8") as file:
        for line in file:
            parts = line.strip().split(",")

            if len(parts) != 5:
                continue

            name, date, amount, category, city = parts
            year, month, day = date.split("-")

            sales.append({
                "name": name,
                "date": date,
                "amount": int(amount),
                "category": category,
                "city": city,
                "year": year,
                "month": month,
                "day": day,
            })

    return sales


def write_category_reports(output_dir, grouped_sales):
    """Создаёт файлы с отчётами по категориям."""
    for (year, month, category), records in grouped_sales.items():
        category_file = os.path.join(output_dir, year, month, f"{category}.txt")
        os.makedirs(os.path.dirname(category_file), exist_ok=True)

        sorted_records = sorted(records, key=lambda x: x["date"])

        with open(category_file, "w", encoding="utf-8") as file:
            for record in sorted_records:
                file.write(f"{record['date']},{record['name']},{record['amount']}\n")


def write_monthly_reports(output_dir, category_totals):
    """Создаёт общий отчёт по каждому месяцу."""
    for (year, month), category_sums in category_totals.items():
        report_file = os.path.join(output_dir, year, month, "monthly_report.txt")
        os.makedirs(os.path.dirname(report_file), exist_ok=True)

        with open(report_file, "w", encoding="utf-8") as file:
            for category, total in sorted(category_sums.items()):
                file.write(f"{category},{total}\n")
            file.write(f"Full,{sum(category_sums.values())}\n")


def process_sales_data(file_path, output_dir):
    """Обрабатывает продажи и создаёт отчёты."""
    sales = read_sales_data(file_path)

    grouped_sales = defaultdict(list)
    category_totals = defaultdict(lambda: defaultdict(int))

    for record in sales:
        key = (record["year"], record["month"], record["category"])
        grouped_sales[key].append(record)
        category_totals[(record["year"], record["month"])][record["category"]] += record["amount"]

    write_category_reports(output_dir, grouped_sales)
    write_monthly_reports(output_dir, category_totals)


if len(sys.argv) < 3:
    print("Usage: python sales_report.py <input_file> <output_directory>")
    sys.exit(1)

input_file = sys.argv[1]
output_directory = sys.argv[2]

process_sales_data(input_file, output_directory)
print("Reports generated successfully!")

🧪 Как проверить решение

🐛 Отладка в VS Code

Если что-то не работает:

1. Поставьте точку останова (breakpoint) в функции read_sales_data.
2. Нажмите F5 или выберите «Run → Start Debugging».
3. На панели Debug следите за значениями sys.argv, sales, grouped_sales и category_totals.
4. Если программа падает с FileExistsError, проверьте, что используется exist_ok=True в os.makedirs.

💾 Сохранение работы

# Добавьте файлы урока
git add lesson-53/

# Сделайте коммит с осмысленным сообщением
git commit -m "lesson-53: анализ продаж по категориям и датам"

# Отправьте на GitHub / GitLab
git push

💡 Советы и типичные ошибки

• Всегда указывайте encoding="utf-8" при открытии текстовых файлов.
• Используйте os.path.join вместо ручного склеивания путей.
• Не забывайте про exist_ok=True при создании папок.
• Проверяйте len(sys.argv) перед использованием аргументов.
• Не коммитьте папку venv/ и сгенерированные отчёты — они указаны в .gitignore.