Практика: воспроизводимая рабочая папка¶
Задача¶
Создайте учебный каталог для обработки вымышленных позиций спецификации. Другой человек должен суметь понять структуру и повторить запуск только по вашему README.
Требуемая структура¶
environment-practice/
├── data/
│ ├── input/
│ │ └── positions.txt
│ └── output/
├── docs/
│ ├── commands.md
│ └── paths.md
├── hello.py
└── README.md
В positions.txt запишите пять вымышленных позиций, по одной на строку. Не используйте реальные документы или персональные данные.
Порядок работы¶
- До первой команды нарисуйте ожидаемое дерево каталогов.
- Покажите текущую папку и убедитесь, что это безопасное учебное место.
- Создавайте по одному уровню, проверяя содержимое после каждой операции.
- Создайте
hello.py, выводящийСреда готова. - В
docs/commands.mdсохраните использованные команды и подпишите их назначение. - В
docs/paths.mdзапишите абсолютный путь кpositions.txtи относительные пути к нему из корня проекта и изdocs. - Напишите README: требования, команда запуска, ожидаемый вывод и описание каталогов.
Проверочные сценарии¶
| Сценарий | Действие | Ожидаемый результат |
|---|---|---|
| Обычный | Запустить hello.py из корня |
Терминал печатает Среда готова |
| Изменённый | Добавить шестую позицию и прочитать файл | Видны шесть строк, структура не меняется |
| Ошибочный | Запустить missing.py |
Понятное сообщение об отсутствующем файле; остальные файлы целы |
| Путь | Открыть positions.txt относительным путём из docs |
Открывается тот же файл из data/input |
Для каждого сценария сохраните команду, ожидание и фактический результат. Ошибочный сценарий не должен включать удаление или перезапись данных.
Критерии сдачи¶
- структура совпадает с заданием;
- README позволяет повторить запуск;
- оба пути в
paths.mdдействительно ведут к одному файлу; - в журнале присутствуют четыре проверки;
- вы объясняете разницу между текущим каталогом и каталогом файла;
- нет реальных клиентских данных и опасных команд.