Калькулятор денег и калорий

Вы добрались до итогового проекта спринта. Когда вы выполните это задание — в вашем распоряжении окажутся два отличных инструмента для контроля расходов и доходов.

Перед тем, как приступить к заданию — технические подробности.

Порядок работы над заданием

Привяжите свой аккаунт GitHub к аккаунту Яндекс.Практикума.
После связывания аккаунтов на вашем GitHub появится новый приватный репозиторий hw_python_oop.
Склонируйте этот репозиторий на свой компьютер. Сейчас в репозитории hw_python_oop лежит пустая заготовка кода и набор автоматических тестов.

Репозиторий, который вы скачали, содержит некоторое количество служебных директорий и файлов. Свой код пишите в файле homework.py

Скопировать код
 └── hw_python_oop
     ├── tests
     │   ├── fixtures
     │   │   ├── fixture_data.py
     │   │   └── fixture_msg.py
     │   ├── conftest.py
     │   └── test_homework.py
     ├── .gitignore
     ├── homework.py  # пишите код в этом файле
     ├── pytest.ini
     ├── requirements.txt
     └── setup.cfg

Установите и активируйте виртуальное окружение. Папка проекта должна принять такой вид:

Скопировать код
 └── hw_python_oop
     ├── tests/
     ├── venv/      <-- Новая папка с виртуальным окружением
     ├── .gitignore
     ├── homework.py  
     ├── pytest.ini
     ├── requirements.txt
     └── setup.cfg

В виртуальном окружении через менеджер пакетов pip установите программу автоматического тестирования кода pytest.
Сделайте домашнее задание.
Запуститите pytest и убедитесь, что автоматические тесты проходят успешно.
Когда все тесты пройдены — запуште код в репозиторий на github hw_python_oop (команды git add . , git commit -m 'текст коммита' и git push). После этого нажмите кнопку «Проверить задание».

Будьте внимательны: файлы и папки вашего проекта должны быть размещены в головной папке репозитория, который вы скачали.
Если проект не удаётся отправить обычным способом и платформа предлагает загрузить проект архивом, важно, чтобы:
- Ваш архив с проектом был строго в формате ZIP.
- Размер архива был меньше 4 MB.
Ваше решение отправится на code review, его проверят специалисты.

В случае затруднений вернитесь к уроку «Знакомство с Git».

Условие задачи

Создайте два калькулятора: для подсчёта денег и калорий. Пользовательскую часть калькуляторов, их «лицо», писать не нужно, напишите только логику — отдельный класс для каждого из калькуляторов.

Калькулятор денег должен уметь:

Сохранять новую запись о расходах методом add_record()
Считать, сколько денег потрачено сегодня методом get_today_stats()
Определять, сколько ещё денег можно потратить сегодня в рублях, долларах или евро — метод get_today_cash_remained(currency)
Считать, сколько денег потрачено за последние 7 дней — метод get_week_stats()

Калькулятор калорий должен уметь:

Сохранять новую запись о приёме пищи— метод add_record()
Считать, сколько калорий уже съедено сегодня — метод get_today_stats()
Определять, сколько ещё калорий можно/нужно получить сегодня — метод get_calories_remained()
Считать, сколько калорий получено за последние 7 дней — метод get_week_stats()

У калькуляторов много пересекающихся функций: они должны уметь хранить какие-то записи (о еде или деньгах, но по сути - всё числа и даты), знать дневной лимит (сколько в день можно истратить денег или сколько калорий можно получить) и суммировать записи за конкретные даты. Всю эту общую функциональность заложите в родительский класс Calculator, а от него унаследуйте классы CaloriesCalculator и CashCalculator.

Конструктор класса Calculator должен принимать один аргумент — число limit (дневной лимит трат/калорий, который задал пользователь). В конструкторе создайте пустой список, в котором потом будут храниться записи (назовите его records).

Чтобы было удобнее создавать записи, создайте для них отдельный класс Record. В нём сохраните:

число amount (денежная сумма или количество килокалорий),
дату создания записи date (передаётся в явном виде в конструктор, либо присваивается значение по умолчанию — текущая дата),
комментарий comment, поясняющий, на что потрачены деньги или откуда взялись калории.

Примеры таких записей:

Скопировать кодPYTHON
# для CashCalculator 
r1 = Record(amount=145, comment='Безудержный шопинг', date='08.03.2019')
r2 = Record(amount=1568,
            comment='Наполнение потребительской корзины',
            date='09.03.2019')
r3 = Record(amount=691, comment='Катание на такси', date='08.03.2019')

# для CaloriesCalculator
r4 = Record(amount=1186,
            comment='Кусок тортика. И ещё один.',
            date='24.02.2019')
r5 = Record(amount=84, comment='Йогурт.', date='23.02.2019')
r6 = Record(amount=1140, comment='Баночка чипсов.', date='24.02.2019')

Код должен соответствовать требованиям оформления кода Яндекс.Практикум.

Использование Type Hints в этом проекте не обязательно.

Подробнее о формате вывода

1. Метод get_calories_remained() калькулятора калорий должен возвращать ответ

«Сегодня можно съесть что-нибудь ещё, но с общей калорийностью не более N кКал», если лимит limit не достигнут,
или «Хватит есть!», если лимит достигнут или превышен.

2. Метод get_today_cash_remained(currency) денежного калькулятора должен принимать на вход код валюты: одну из строк "rub", "usd" или "eur".

Возвращает он сообщение о состоянии дневного баланса в этой валюте, округляя сумму до двух знаков после запятой (до сотых):

«На сегодня осталось N руб/USD/Euro» — в случае, если лимит limit не достигнут,
или «Денег нет, держись», если лимит достигнут,
или «Денег нет, держись: твой долг - N руб/USD/Euro», если лимит превышен.

Курс валют укажите константами USD_RATE и EURO_RATE, прямо в теле класса CashCalculator. Какой курс вы укажете — не так важно, выберите любой, похожий на правду. Значения обменного курса можно посмотреть, например, на главной странице Яндекса https://yandex.ru.

Как мы проверяем домашние работы

Все ваши домашние работы будут проверяться по следующей схеме:

Линтеры: автоматическая проверка

В самом начале код проверяется на соответствие требованиям по оформлению PEP8. Без стопроцентного соответствия поезд дальше не пойдёт. При проверке работы мы применяем flake8. Если ваш код не соответствует PEP8 — вы получите сообщение об этом, доработаете код и снова отправите его на проверку.

Тесты: автоматическая проверка

Автоматические тесты. На каждый проект написаны тесты, проверяющие критичные для проекта параметры. Если ваш код не пройдёт тесты — вы получите сообщение об этом, доработаете код и снова отправите его на проверку.

Code review: ручная проверка

Квалифицированный программист проанализирует ваш код и примет решение о том, качественно ли выполнена работа. Если ревьюер обнаружит ошибки — он обязательно напишет комментарии с рекомендациями по улучшению кода. Вы доработаете код и снова отправите его на проверку.

Всё получится.

Шаг 3/4

Работа отправлена на ревью.
Проверка займёт не больше 24 часов. Если сутки прошли, а работа всё ещё не проверена, напишите куратору.

Ваш проект c комментариями

Проект спринта: калькулятор денег и калорий

hw_python_oop-master

Нет комментариев

Углублённый Python

Калькулятор денег и калорий

Порядок работы над заданием

Условие задачи

Подробнее о формате вывода

Рекомендации и подсказки

Как мы проверяем домашние работы

Линтеры: автоматическая проверка

Тесты: автоматическая проверка

Code review: ручная проверка

Ваш проект c комментариями

Как всё устроено

Основы Python

Углублённый Python

Бэкенд на Django

API: интерфейс взаимодействия программ

Управление проектом на удалённом сервере

Проект «Продуктовый помощник»

Трудоустройство 2.1

Алгоритмы и структуры данных

Парсинг

Альтернативные фреймворки

Python для бизнеса

Проекты и подготовка к собеседованиям