No description
  • C++ 88.5%
  • CMake 11.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-05 19:03:57 +03:00
.qtcreator initial commit 2026-10-05 19:03:57 +03:00
examples initial commit 2026-10-05 19:03:57 +03:00
include/apops initial commit 2026-10-05 19:03:57 +03:00
pkgconfig initial commit 2026-10-05 19:03:57 +03:00
src initial commit 2026-10-05 19:03:57 +03:00
tests initial commit 2026-10-05 19:03:57 +03:00
.gitignore initial commit 2026-10-05 19:03:57 +03:00
CMakeLists.txt initial commit 2026-10-05 19:03:57 +03:00
README.md initial commit 2026-10-05 19:03:57 +03:00

aptpkg-ops

Программная замена CLI-обёрткам (apt-get, apt-cache, apt-mark) для RPM-систем ALT Linux: C++17-библиотека поверх libapt-pkg, работающая in-process, без парсинга текстового вывода.

Возможности

CLI-сценарий API
apt-get update maintenance::update()
apt-cache search Query::search()
apt-cache show / depends / policy Query::get() / depends() / rdepends() / policy()
apt-get install Transaction::install()+commit()
apt-get remove / purge Transaction::remove(pkg, purge)
apt-get upgrade / dist-upgrade Transaction::upgradeAll(bool)
apt-get -f install Transaction::fixBroken()
apt-get autoremove Transaction::autoRemove()
apt-get -d CommitOptions::downloadOnly
apt-get -s (симуляция) Transaction::preview()
замена одним проходом (apt-get install a b-) Transaction::install()+remove()
apt-mark auto/manual/showauto Marks::setAuto()/listAuto()/listManual()
apt-get clean / autoclean maintenance::cleanArchives()
пересоздание кэша maintenance::removeCaches()

Сборка

cmake -B build -S .
cmake --build build
ctest --test-dir build       # smoke-тест (нужен заполненный кэш apt)

Зависимости: libapt-pkg-devel (ALT), librpm-devel, CMake >= 3.16, C++17.

Если devel-пакеты не установлены, но проект лежит внутри дерева исходников apt (как здесь: ../apt-pkg/), CMake сам соберёт плоскую копию заголовков и прилинкуется к установленной runtime-библиотеке — сборка работает и без libapt-pkg-devel.

Ключевые принципы

  • RAII-инициализация: Library::init() один раз на процесс (pkgInitConfig + pkgInitSystem); все прочие объекты бросают ApOpsError, если она не выполнена.
  • Данные вместо текста: запросы возвращают структуры (PackageInfo, TransactionPlan), прогресс — через std::function-колбеки.
  • Откат транзакции: состояние DepCache снимается при создании Transaction; отказ в CommitOptions::confirm или деструктор без commit() полностью откатывают изменения (pkgDepCache::State::Restore).
  • Смешанные транзакции: install(), remove(), reinstall() в одном Transaction применяются одним проходом — одно разрешение зависимостей, одна закачка, одна транзакция rpm (apt-get install newone oldone-). Подсказки резолверу зеркалят apt-get: запрошенные установки защищены, запрошенные удаления помечены ToRemove, поэтому резолвер не «чинит» сломанные обратные зависимости переустановкой удалённого. Конфликтующие запросы для одного пакета (install+remove, remove+reinstall) бросают ApOpsError.
  • Права доступа: чтение (Query, Marks::list*, cleanArchives) — без root; update, commit, Marks::setAuto — root (внутри всё делает ShouldLockForInstall() + _system->Lock(), как в apt-get).
  • Однопоточность: libapt-pkg не потокобезопасен; все операции сериализуются Library::mutex().

Ограничения v0.1

  • Lua-хуки (Scripts::*) не вызываются (зарезервировано в InitOptions).
  • Смена носителя (CD) в транзакции отменяет закачку, а не переключает диск.
  • Управление sources.list и holds — в планах (v0.2).