|
9 | 9 |
|
10 | 10 | Модуль представляет собой калькуляторы подсчёта финансов и калорий на основе записей пользователя.
|
11 | 11 |
|
12 |
| -## Класс записей пользователя |
| 12 | +Класс записей пользователя |
13 | 13 |
|
14 | 14 | ```python
|
15 | 15 | class Record
|
16 | 16 | ```
|
17 | 17 |
|
18 |
| -### Свойства класса записей |
| 18 | +Свойства класса записей |
19 | 19 |
|
20 |
| -* amount - количество потребляемых калорий или потраченных денег; |
21 |
| -* comment - коментарии пользователя; |
22 |
| -* date - дата записи; |
| 20 | +- amount - количество потребляемых калорий или потраченных денег; |
| 21 | +- comment - коментарии пользователя; |
| 22 | +- date - дата записи; |
23 | 23 |
|
24 |
| -### Пример создания экземпляра класса |
| 24 | +Пример создания экземпляра класса |
25 | 25 |
|
26 | 26 | ```python
|
27 | 27 | r1 = Record(amount=122, comment='Хороший шопинг', date='09.04.2019')
|
28 | 28 | ```
|
29 | 29 |
|
30 |
| -## Базовый класс калькулятора |
| 30 | +Базовый класс калькулятора |
31 | 31 |
|
32 | 32 | ```python
|
33 | 33 | class Calculator
|
34 | 34 | ```
|
35 | 35 |
|
36 |
| -### Свойства класса калькулятора |
| 36 | +Свойства класса калькулятора |
37 | 37 |
|
38 |
| -* limit - максимально допустимое количество потребляемых калорий или потраченных денег; |
39 |
| -* records - словарь, содержащий все записи пользователя; |
| 38 | +- limit - максимально допустимое количество потребляемых калорий или потраченных денег; |
| 39 | +- records - словарь, содержащий все записи пользователя; |
40 | 40 |
|
41 |
| -### Методы класса калькулятора |
| 41 | +Методы класса калькулятора |
42 | 42 |
|
43 |
| -* `get_today_date()` - метод возвращает текущую дату; |
44 |
| -* `get_week_date()` - метод возвращает текущую неделю; |
45 |
| -* `add_record(record)` - метод принимает на вход новую запись `record` и добавляет её в словарь `records`; |
46 |
| -* `get_today_stats()` - метод возвращает сумму расходов на сегодня; |
47 |
| -* `get_week_stats()` - метод возвращает сумму расходов за неделю; |
48 |
| -* `get_today_limit()` - метод возвращает лимит расходов на сегодня; |
| 43 | +- `get_today_date()` - метод возвращает текущую дату; |
| 44 | +- `get_week_date()` - метод возвращает текущую неделю; |
| 45 | +- `add_record(record)` - метод принимает на вход новую запись `record` и добавляет её в словарь `records`; |
| 46 | +- `get_today_stats()` - метод возвращает сумму расходов на сегодня; |
| 47 | +- `get_week_stats()` - метод возвращает сумму расходов за неделю; |
| 48 | +- `get_today_limit()` - метод возвращает лимит расходов на сегодня; |
49 | 49 |
|
50 |
| -## Наследники класса калькулятора |
| 50 | +### Наследники класса калькулятора |
51 | 51 |
|
52 |
| -### Класс калькулятора денег |
| 52 | +Класс калькулятора денег |
53 | 53 |
|
54 | 54 | ```python
|
55 | 55 | class CashCalculator
|
56 | 56 | ```
|
57 | 57 |
|
58 |
| -### Свойства класса калькулятора денег |
| 58 | +Свойства класса |
59 | 59 |
|
60 |
| -* limit - максимально допустимое количество потраченных денег; |
61 |
| -* records - словарь, содержащий все записи пользователя; |
| 60 | +- limit - максимально допустимое количество потраченных денег; |
| 61 | +- records - словарь, содержащий все записи пользователя; |
62 | 62 |
|
63 |
| -### Константы класса калькулятора денег |
| 63 | +Константы класса |
64 | 64 |
|
65 |
| -* `USD_RATE` - курс доллара к рублю, USD/RUB; |
66 |
| -* `EURO_RATE` - курс евро к рублю, EUR/RUB; |
| 65 | +- `USD_RATE` - курс доллара к рублю, USD/RUB; |
| 66 | +- `EURO_RATE` - курс евро к рублю, EUR/RUB; |
67 | 67 |
|
68 |
| -### Методы класса калькулятора денег |
| 68 | +Методы класса |
69 | 69 |
|
70 |
| -* `get_today_cash_remained(currency)` - метод принимает на вход `currency` - ключ словаря `currencies` курсов валюты и возвращает сообщение о состоянии дневного баланса в указанной валюте, округляя значение типа float до 2 знаков после запятой: |
71 |
| - * *«Указана неверная валюта. Повторите ввод.»*, если вводимая `currency` отсутствует в `currencies`; |
72 |
| - * *«Денег нет, держись»*, если лимит достигнут; |
73 |
| - * *«На сегодня осталось N руб/USD/Euro»*, если лимит `limit` не достигнут; |
74 |
| - * *«Денег нет, держись: твой долг - N руб/USD/Euro»*, если лимит превышен; |
| 70 | +- `get_today_cash_remained(currency)` - метод принимает на вход `currency` - ключ словаря `currencies` курсов валюты и возвращает сообщение о состоянии дневного баланса в указанной валюте, округляя значение типа float до 2 знаков после запятой: |
| 71 | + - _«Указана неверная валюта. Повторите ввод.»_, если вводимая `currency` отсутствует в `currencies`; |
| 72 | + - _«Денег нет, держись»_, если лимит достигнут; |
| 73 | + - _«На сегодня осталось N руб/USD/Euro»_, если лимит `limit` не достигнут; |
| 74 | + - _«Денег нет, держись: твой долг - N руб/USD/Euro»_, если лимит превышен; |
75 | 75 |
|
76 | 76 | ```python
|
77 | 77 | # базовая формула расчета
|
78 | 78 | лимит_расходов_на_сегодня / курс_валюты
|
79 | 79 | ```
|
80 | 80 |
|
81 |
| -### Класс калькулятора калорий |
| 81 | +Класс калькулятора калорий |
82 | 82 |
|
83 | 83 | ```python
|
84 | 84 | class CaloriesCalculator
|
85 | 85 | ```
|
86 | 86 |
|
87 |
| -### Свойства класса калькулятора калорий |
| 87 | +Свойства класса |
88 | 88 |
|
89 |
| -* limit - максимально допустимое количество потребляемых калорий; |
90 |
| -* records - словарь, содержащий все записи пользователя; |
| 89 | +- limit - максимально допустимое количество потребляемых калорий; |
| 90 | +- records - словарь, содержащий все записи пользователя; |
91 | 91 |
|
92 |
| -### Методы класса калькулятора калорий |
| 92 | +Методы класса |
93 | 93 |
|
94 |
| -* `get_calories_remained()` - метод возвращает сообщение, в зависимости от значения `limit`: |
95 |
| - * *«Сегодня можно съесть что-нибудь ещё, но с общей калорийностью не более N кКал»*, если лимит не достигнут; |
96 |
| - * *«Хватит есть!*, если лимит превышен; |
| 94 | +- `get_calories_remained()` - метод возвращает сообщение, в зависимости от значения `limit`: |
| 95 | + - _«Сегодня можно съесть что-нибудь ещё, но с общей калорийностью не более N кКал»_, если лимит не достигнут; |
| 96 | + - _«Хватит есть!_, если лимит превышен; |
| 97 | + |
| 98 | +## Установка |
| 99 | + |
| 100 | +Клонировать репозиторий: |
| 101 | + |
| 102 | +```python |
| 103 | +git clone https://github.com/egorcoders/hw_python_oop.git |
| 104 | +``` |
| 105 | + |
| 106 | +Перейти в папку с проектом: |
| 107 | + |
| 108 | +```python |
| 109 | +cd hw_python_oop/ |
| 110 | +``` |
| 111 | + |
| 112 | +Запустить проект локально: |
| 113 | + |
| 114 | +```python |
| 115 | +# для OS Lunix и MacOS |
| 116 | +python homework.py |
| 117 | + |
| 118 | +# для OS Windows |
| 119 | +python3 homework.py |
| 120 | +``` |
0 commit comments