mse-task-generators 0.3.2

Оглавление

• Инструкция по развертыванию проекта
• Функционал проекта
• CodeRunner Moodle
• Docker

Инструкция по развертыванию проекта

Требования к системе

• ОС: Linux (рекомендуется Ubuntu 20.04 LTS или выше)
• Python: версия 3.8 или выше
• Компилятор: GCC (GNU Compiler Collection)
• Инструменты отладки и профилирования:
  • Valgrind
  • GDB (GNU Debugger)
  • Gprof (GNU Profiler)

1. Установка зависимостей

Установка Python, PIP и venv

sudo apt update
sudo apt install python3 python3-pip python3-venv

Установка GCC, Valgrind, GDB, Gprof

sudo apt install gcc valgrind gdb binutils

Проверка версий

python3 --version
pip3 --version     
python3 -m venv --help 
gcc --version
valgrind --version
gdb --version
gprof --version

2. Клонирование репозитория

git clone https://github.com/moevm/mse1h2025-perf.git
cd mse1h2025-perf

3. Установка Python-зависимостей

python3 -m venv venv  
source venv/bin/activate  
(venv) pip install -r requirements.txt

4. Установка пакета

Детальная информация о pip пакете проекта - Документация

5. Загрузка исполняемого файла на Яндекс.Диск

Инструкция по запуску генератора с примером загрузки исполняемого файла на Яндекс.Диск - Документация

Функционал проекта

Примеры использования генераторов задач

Проект поддерживает 3 генератора задач. Ниже приведены примеры их запуска.

Генератор 1:

Создание задач на профилирование

generators.profiling1 1 init -o test.out

Проверка задач на профилирование

./test.out
gprof -bp test.out gmon.out
generators-profiling1 finding_in_main check -b test.out -a reorganization -s 1

Параметры:

• Первый параметр: тип задачи (1, 2)
• Второй параметр: создание задачи или проверка ответа (init, check)
• С полным списком параметров можно ознакомиться в документации к генератору - Документация

Генератор 2:

Создание задач на утечку памяти

python3 -m generators.leak_generator -m 1

Проверка задач на утечку памяти

python3 -m generators.leak_generator -m 2

Параметры:

• --mode, -m: создание задачи иили проверка ответа (1, 2)
• С полным списком параметров можно ознакомиться в документации к генератору - Документация

Генератор 3:

Создание задач на отладку

python3 -m generators.cycle_generator -m 1

Проверка задач на отладку

python3 -m generators.cycle_generator -m 2

Параметры:

• --mode, -m: создание задачи или проверка ответа (1, 2)
• С полным списком параметров можно ознакомиться в документации к генератору - Документация

CodeRunner Moodle

Для демонстрации работоспособности модуля была создана тестовая задача на Moodle. Перед решением необходимо в шаблон задачи вставить ваш токен от Яндекс Диска. Инструкция

Задача при первом входе:

Демонстрация пустого хранилища:

При нажатии на кнопку "Предварительная проверка" в хранилище помещается сгенерированный исполняемый файл:

Docker, сборка и примеры запуска

Сборка образа

docker build -t perf .

Запуск контейнера в интерактивном режиме

docker run -it perf bash

Примеры создания и проверки задач

Генератор задач на профилирование (Документация)

1. Поиск n-ой по времени выполнения функции, вызванной из main

   Команды:

   • generators-profiling1 finding_in_main init -o test.out -s 1
     

   • ./test.out
     

   • gprof -bp test.out gmon.out
     

   • generators-profiling1 finding_in_main check -b test.out -a reorganization -s 1
     

2. Поиск n-ой по времени выполнения функции, вызванной из find_me

   Команды:

   • generators-profiling1 finding_in_find_me init -o test.out -s 1
     

   • ./test.out
     

   • gprof -b test.out gmon.out --graph=find_me
     

   • generators-profiling1 finding_in_find_me check -b test.out -a kilt -s 1
     

Генератор задач на утечку памяти (Документация)

Команды:

• generators-leak-generator -m 1
  

• valgrind ./generated/leaks_generated
  

• generators-leak-generator -m 2
  

Генератор задач на отладку (Документация)

Команды:

• python3 -m generators.cycle_generator -m 1
  

• valgrind --leak-check=full ./generators/cycle_generator/generators_files/generated_code_with_cycle
  

• python3 -m generators.cycle_generator -m 2