معرفی شرکت ها
apeiron-1.1.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Simple CLI for modpack management
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | apeiron-1.1.0 |
| نام | apeiron |
| نسخه کتابخانه | 1.1.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Andriy Kushnir (Orhideous) |
| ایمیل نویسنده | me@orhideous.name |
| آدرس صفحه اصلی | https://git.mc4ep.org/mc4ep/apeiron |
| آدرس اینترنتی | https://pypi.org/project/apeiron/ |
| مجوز | MIT license |
apeiron
=======
*Утилита для управления модпаками*
[](https://pypi.python.org/pypi/apeiron)
[](https://pypi.python.org/pypi/apeiron)
Основные термины
----------------
- **Модпак** — совокупность файлов, которые могут быть доставлены
пользователю, сразу или после сборки
- **SourceManifest (SM)** — виртуальный объект исходников модпака,
описанный в `index.yaml` и представленный файлами в `objects/`
- **TargetManifest (TM)** — виртуальный объект индекса и целевых
файлов модпака, доставляемых пользователю
Принцип работы
--------------
Apeiron оперирует реконструированными из файлов виртуальными объектами
модпаков, предоставленными `SM` и/или `TM`. Никакого другого хранилища
метаданных, кроме самих файлов, нет.
Все изменения в виртуальных объектах (например, создание `TM` из `SM`,
так называемый процесс сборки модпака) немедленно отображается в ФС.
Обратное тоже верно — любые изменения в файлах будут отображены
утилитой `apeiron`
Статусы модпака
---------------
- **Fresh** — исходники модпака (`SM`) в точности равны собранным
файлам (`TM`)
- **Outdated** — `TM` не соответствует `SM`, обычно, если файлы
исходников обновились
- **Not deployed** — для `SM` в модпаке пока не был собран `TM`
- **Orphaned** — существует только `TM` в модпаке, без исходников
- **Broken** — нарушена целостность `TM`, следует пересобрать или
удалить такой модпак
- **Unknown** — эфемерный модпак, запись в котором найдена в
индексе, стоит удалить его
Работа с `apeiron`
------------------
Для просмотра помощи по командам достаточно вызвать утилиту без
аргументов, `apeiron`
Полный пример индекса исходников с комментариями
------------------------------------------------
```yaml
# Отображаемое имя модпака в лаунчере
title: Fancy pack with bells and whistles
# Внутреннее имя, используется в дальнейших операциях с модпаком
name: my_pack
# Версия игры
gameVersion: 1.10.2
# Список дополнительных флагов запуска, пустой по умолчанию
launch:
flags:
- -XX:SomeStrangeJavaFlag=42
- --debug
# Внутреннее версионирование, всегда 2
minimumVersion: 2
# URL к дополнительным библиотекам для этого модпака
# Добавляется к адресу по умолчанию в лаунчере
librariesLocation: http://libraries.devd.io
# Фактическое размещение файлов модпака, относительно индекса
objectsLocation: objects
# Папки из objectsLocation, которые нужно упаковать в zip-архив
# перед сборкой модпака
bundles:
# всё содержимое указанной папки и всех подпапок с сохранением структуры
# будет находиться в resourcepacks/UnpackedResourcePack.zip
- resourcepacks/UnpackedResourcePack
# Список пользовательских файлов и каталогов, которые при установке
# модпака доставляются на клиент, но не перезаписываются при обновлении
userFiles:
include:
- options.txt
- config/MyAwesomeModStuff/*
# Список дополнительно загружаемых частей (DLC) модпака
features:
# Объект DLC
- properties:
# Внутреннее имя DLC
name: MoreBells
# Описание DLC
description: Adds extra bells!
# Рекомендован (starred) или нет (avoid) для загрузки
recommendation: starred
# Игнорируется, так как активно только на стороне клиента
selected: false
# Список файлов, входящих в DLС
files:
include:
- mods/MoreBells.jar
- mods/MoreBellsAddons*
# Аналогично общему блоку userFiles
# файлы доставляются на клиент при отсутствии, но не перезаписываются при обновлении
# Данный блок необязателен и может отсутствовать,
# если в данном DLC нет пользовательских файлов
userFiles:
include:
- config/MoreBells.cfg
```
Все пути на стороне утилиты должны рассматриваться относительно каталога
`objects`, или же каталога игры на стороне клиента.
Конфигурация
------------
Все настройки `apeiron` задаются переменными окружения.
- **APEIRON_SOURCES_DIR** (`~/apeiron/sources`) — Исходные файлы
- **APEIRON_PACKAGES_DIR** (`~/apeiron/packages`) — Собранные модпаки
- **APEIRON_MODPACK_INDEX** (`index.json`) — Рабочий индекс модпаков
- **APEIRON_PARALLELISM** (`4`) — Количество рабочих процессов
- **APEIRON_DEBUG** (`False`) — Включена ли отладка?
Работа с несколькими версиями окружений
---------------------------------------
При необходимости разделить окружения (production/test) можно
использовать несколько индексов модпаков. Так, при вызове
`apeiron --config production.yaml` и содержимом `production.yaml`
```yaml
modpack_index: production.json
```
...все клиенты, для которых `packageListUrl` лаунчера будет указывать на
`production.json`, будут видеть только включенные там сборки.
Настройка веб-сервера
---------------------
Достаточно любого сервера, способного отдавать файлы с
`storage_dir/packages`
Пример для **nginx**, если `storage_dir` настроена в `/opt/apeiron`:
```
server {
listen 80;
server_name packages.example.com;
root /opt/apeiron/packages;
}
```
Установка
---------
`pip3 install apeiron`
Системные требования
--------------------
- POSIX-совместимая ОС
- Python 3.6.4 и выше
History
=======
1.0.0 (2020-06-25)
------------------
* First production-ready release
0.9.0 (2018-09-01)
------------------
* First release on PyPI.
نیازمندی
| مقدار | نام |
|---|---|
| ==0.15 | pydantic |
| ==5.1.2 | PyYaml |
| ==0.8.6 | tabulate |
| ==7.0 | click |
نحوه نصب
نصب پکیج whl apeiron-1.1.0:
pip install apeiron-1.1.0.whl
نصب پکیج tar.gz apeiron-1.1.0:
pip install apeiron-1.1.0.tar.gz