Программные утилиты и данные МГИМО

Установка

pip install mgimo

После установки в командной строке станет доступна утилита mgimo, а для использования в других программах - одноименная библиотека.

Что умеет наша программа?

Целями разработки пакета является:

• демонстрация примеров программ, которые посильны начинающим программистам ("если в МГИМО смогли написать такой код, я тоже смогу"),
• проведение тестов и обучающихих игр,
• автоматизация прикладных аналитических задач, которые решают наши студенты и коллеги – с помощью уже существующих или новых инструментов.

К текущей версии наш пакет умеет:

• конвертировать оценки в шкале МГИМО,
• проводить тест на знание столиц мира.

В разработке:

• перевод текста с английского на русский,
• наборы данных по международной сфере.

Утилита командной строки

Проверить запуск утилиты:

mgimo --help

Запустить тест на знание столиц стран мира:

mgimo quiz

Другие команды для теста по столицам

Спросить столицы 10 стран:

mgimo quiz --countries=10

Знаете ли вы эти три столицы :

mgimo quiz --capitals=3

Пять вопросов про столицы и пять про страны:

mgimo quiz --countries=5 --capitals=5

Библиотека

Столицы стран-членов ООН

from random import choice
from mgimo.dataset.data import country_to_capital

countries = list(country_to_capital.keys())
assert len(countries) == 193
country = choice(countries)
city = country_to_capital[country]
print(f"Выбрана страна: {country}, столица - {city}.")

Changelog

0.5.0 - добавлен интерфейс командной строки и тест по столицам мира.

Отладка

Полезные скрипты

npx prettier README.md --write
isort . --float-to-top
black .
ruff check .
pytest

Утилита командной строки

Мы используем пакетный менеджер uv, во время разработки утилита командной строки доступна через команду uv run.

uv run mgimo

Установка конкретной версии утилиты также возможна через pip. Для этого необходимо собрать образ пакета в uv:

uv build

Затем установить образ через pip из директории dist, которая появится после предыдущего шага:

pip install dist/mgimo-0.4.0-py3-none-any.whl

Если вы хорошо понимаете, чем нам могут быть полезны pipx и uvx - откройте, пожалуйста, issue.