Вряд ли вы здесь случайно.
Нужен Python 3.9+.
В ~/.prpr.yaml
нужно положить токен доступа к Стартреку.
Также можно определить первое число для начала месяца расчёта зарплаты и определить суффиксы для уточнения когорт (в зависимости от курса):
startrek_token: your_token_here
# Optional:
free_work_owner: lepervushina # owner of unassigned (free) tickets
month_start: 16 # Meaning closed tickets are grouped by May 16-June 15, June 16-July 16 and so on.
component_suffixes: # suffixes for cohort definition according to course
backend-developer: ''
python-developer-plus: '+'
Клонируем, (по желанию) создаем окружение, ставим зависимости.
python3 -m prpr.main
Также удобно создать bash alias, чтобы можно было запускать из любого местоположения, например, так:
alias prpr='cd /path/to/dir/prpr/ && source venv/bin/activate && python -m prpr.main'
Доступна встроенная справка:
python3 -m prpr.main --help
usage: main.py [-h] [-m {standard,all,open,closed,closed-this-month,closed-previous-month}] [-p PROBLEMS [PROBLEMS ...]] [-n NO] [-s STUDENT] [-c COHORTS [COHORTS ...]] [-f FROM_DATE] [-t TO_DATE] [-o] [-d [{one,all,interactive,interactive-all}]] [--head] [-i] [-v] [--post-process]
optional arguments:
-h, --help show this help message and exit
-o, --open open homework pages in browser
-v, --verbose
filters:
these allow to specify the subset of homeworks to be displayed, can be composed
-m {standard,all,open,closed,closed-this-month,closed-previous-month}, --mode {standard,all,open,closed,closed-this-month,closed-previous-month}
filter mode
standard: in review, open or on the side of user
open: in review or open
closed: resolved or closed
closed-this-month: resolved or closed this "month" aka 💰.
closed-previous-month: resolved or closed previous "month" aka 💰.
all: all, duh
-p PROBLEMS [PROBLEMS ...], --problems PROBLEMS [PROBLEMS ...]
the numbers of problems to be shown; multiple space-separated values are accepted
-n NO, --no NO the no of the homework to be shown, all other filters are ignored
-s STUDENT, --student STUDENT
the substring to be found in the student column, mail works best
-c COHORTS [COHORTS ...], --cohorts COHORTS [COHORTS ...]
cohorts to be shown; multiple space-separated values are accepted
-f FROM_DATE, --from-date FROM_DATE
the start date (YYYY-MM-DD)
-t TO_DATE, --to-date TO_DATE
the end date (YYYY-MM-DD)
-u USER, --user USER
show issues assigned for USER (name in tracker, like y-nikulin)
--free
show unassigned (free) tickets (overrides -u/--user)
download:
-d [{one,all,interactive,interactive-all}], --download [{one,all,interactive,interactive-all}]
download mode
one: first by deadline,
all: all, duh
interactive: choose one interactively,
interactive-all: choose one interactively, repeat
--head download with visible browser window (default is headless, i.e. the window is hidden)
-i, --interactive choose which homework to download interactively (deprecated)
process:
--post-process
Скачать и обработать архив с интерактивным выбором работы с повтором, открыть браузер, логирование уровня INFO
(это рекомендованный вариант запуска):
python -m prpr.main -v --download interactive-all --post-process --open
То же самое, только одна работа:
python -m prpr.main -v --download interactive --post-process --open
Скачать и обработать все работы, открыть браузер:
python -m prpr.main -v --download all --post-process --open
Вывести только 1 и 2 проекты для студентов 16 когорты и 1 когорты "Питон+":
python -m prpr.main --problems 1 2 --cohorts 16 1+
Открыть в браузере работу № 100:
python -m prpr.main --no 100 --open
Скачать архив с работой:
python -m prpr.main --down
Скачать и обработать архив с работой:
python -m prpr.main --down --post-process
Вывести все работы по конкретному студенту (емейл, имя, фамилия):
python -m prpr.main --mode all --student [email protected]
python -m prpr.main --mode all --student "Василиса Пупкина"
Вывести все закрытые работы в определенный период времени. Даты указываются в формате YYYY-MM-DD:
python -m prpr.main --mode closed --from-date 2021-04-16 --to-date 2021-05-15
Вывести закрытые в текущем/предыдущем учетном месяце работы:
python -m prpr.main --mode closed-this-month
python -m prpr.main --mode closed-previous-month
Вывести свободные работы
python -m prpr.main --free
Достаточно указывать уникальный префикс ключа: можно --down
, а не --download
.
Номер итерации равен количеству переходов в статус Открыт
.
Получение истории статусов требует отдельного запроса на каждый тикет,
так что (пока?) для экономии номер итерации отображается только для заданий
со статусом Открыт
или Ревью
.
- Нужно установить драйвер Selenium для Firefox.
- До Ревизора должен быть доступ (VPN, 2FA etc).
- Нужно указать в
.prpr
профиль Firefox с залогином в Ревизоре.
# .prpr fragment
download:
directory: path/to/downloaded/homeworks
browser:
type: firefox
profile_path: path/to/firefox/profile
В тикете есть ссылка на Ревизор. Она открывается в Firefox с помощью Selenium 🤦🏻♀️, там кликается нужная вкладка. Из страницы вынимаются ссылки на zip-файлы. Недостающие архивы скачиваются в директорию, указанную в дотфайле. Нужная структура поддиректорий будет создана автоматически.
В .prpr
нужно добавить секцию process
, в ней можно настроить
шаги для обработки.
Шаги -- шаблоны, в которых заполняются некоторые переменные. Самая интересная
переменная -- it_last
, она будет заменена на абсолютный путь до директории с последней
версией последней итерации (а it_prev
-- для предпоследней). Полный список
переменных доступен в .prpr.yaml
(отрывок см. ниже). Для it_last
можно запускать
проверки (как стандартные линтеры, так и свои), для it_prev
и it_last
-- строить
диффы.
Заполненный шаблон подается на process.runner
. Если runner
--
["bash", "-c"]
, будут работать стандартные возможности, такие как перенаправления и пайпы.
- Шаги из
process.default
будут применены всегда. - При совпадении имени курса -- шаги из
process.courses.<course_name>.default
. - При совпадении имени курса и номера задачи -- шаги из
process.courses.<course_name>.problems.<problem_number>
. - Для первой итерации пропускаются шаги, которым нужна предыдущая итерация.
Вывод шагов сохраняется в директорию домашней работы. Имена шагов должны быть допустимыми именами файлов.
Пример:
# .prpr fragment
process:
# Which steps are applied?
# 1. The steps in process.default
# 2. If the course name matches, the steps in process.courses.<course_name>.default
# 3. If the problem number matches as well, the steps in process.courses.<course_name>.problems.<problem_number>
runner: ["bash", "-c"]
default:
steps:
# The following variables are supported:
#
# hw -- the absolute path of the homework directory,
# it_last -- the absolute path of the last iteration directory,
# it_last_ -- the path of the last iteration directory relative to the homework directory,
# it_last_zip and it_last_zip_ are similar, but point to zip files,
# it_prev, it_prev_ and so on refer to the corresponding counterparts for the previous iteration.
# if it_prev, it_prev_... are present the step is skipped for the first iteration.
diff: "cd {hw} && diff -r -N {it_prev_} {it_last_}"
# Check out https://github.com/jeffkaufman/icdiff for a better alternative.
# icdiff: "cd {hw} && icdiff -r -N {it_prev_} {it_last_}"
courses:
backend-developer:
default:
steps:
pycodestyle: "/usr/local/bin/pycodestyle {it_last} | grep -v -e 'master/tests/' -e migrations -e settings"
problems:
2: # communities
steps:
# This is an example of a problem-specific check:
find_set_null: "cd {it_last} && grep -r SET_NULL ."
- [Refactor] Метод
PraktikTrackerClient.get_status_history()
переписан с использованием штатного интерфейса клиента Яндекс-трекера. - [Refactor] Удален метод
PraktikTrackerClient.get_iteration_and_updated()
.
- Добавлен вывод свободных работ и отображение тикетов других ревьюверов.
NB: не забудьте скопировать настройку
free_work_owner: lepervushina
в~/.prpr.yaml
.
- Поиск по студентам сделан регистронезависимым.
- Фикс селектора для скачки.
- Добавлен режим
--download interactive-all
. - В меню появилось обновления статусов.
- Добавлен режим
--download all
. - Вместо
--interactive
рекомендуется использовать--download interactive
.
- Устранен баг в распаковке архивов.
- Устранен баг в сортировке архивов итераций.
- Домашнюю работу для скачивания можно выбрать интерактивно:
-i/--interactive
. - Для домашних работ в ревью с пропущенными дедлайнами выставлена иконка 🔎.
- Добавлен пост-процессинг aka «диффы» 🥳
- Архивы распакуются при скачке.
- Теперь можно скачать архивы с домашними заданиями, пока только через Firefox.
- Теперь
-v
включает логи со статусом INFO и выше,-vv
-- со статусомDEBUG
и выше. - Ссылка на Стартрек не обрезается на узких терминалах.
- Добавлен режим
closed-previous-month
.
- Добавлен вывод когорт в таблицу.
- Добавлен фильтр по когортам.
- Добавлен режим
closed-this-month
. - Ключи фильтров по датам переименованы в
--date-from
и--date-to
. - Режим
default
переименован вstandard
.
- Добавлена поддержка фильтров по дате.
- Добавлена поддержка номеров итераций и отображение дедлайнов для тикетов в статусе
Ревью
.
- Добавлены примеры запусков.
- Настройки и украшения
- Создать пакет cо скриптом запуска
- Уведомления
- Статистика
- Тесты 😹
- Кэширование
- Демонстрационный запуск