Команда check¶
Команда поддерживает множество аргументов для разных целей.
Они могут дополнять друг друга.
Порядок аргументов не имеет значения.
-i, --ini¶
Указывает путь к локальному ini-файлу с описанием плейлистов.
Можно указать только однажды.
Значение по умолчанию: ./playlists.ini
Если файл не найден, проверка плейлистов будет доступна только по ссылкам (--url) или из локальных файлов (--file).
-t, --tags¶
Указывает путь к локальному json-файлу с описанием тегов каналов.
Можно указать только однажды.
Значение по умолчанию: ./channels.json
Если файл не найден, то будет выведено предупреждение о том, что каналы не будут помечены тегами.
-f, --file¶
Указывает путь к локальному файлу плейлиста *.m3u/*.m3u8.
Можно указать несколько разных.
./iptvc check -f playlist.m3u
./iptvc check -f playlist1.m3u --file playlist2.m3u8
./iptvc check --file /path/to/playlist.m3u
-u, --url¶
Указывает URL удалённого плейлиста (поддерживаются протоколы http/https).
Можно указать несколько разных.
./iptvc check -u http://example.com/playlist.m3u
./iptvc check -u https://site.com/playlist.m3u8 --url http://other.com/list.m3u
-c, --code¶
Указывает код плейлиста из файла playlists.ini.
Можно указать несколько разных.
Работает только вместе с --ini.
Если не указан ни разу, то будут проверены все плейлисты, которые указаны в ini-файле.
Если используется кеширование, то проверенные плейлисты (результаты проверки которых ещё находятся в кеше) проверяться не будут.
--repeat¶
Указывает количество повторений (итераций) команды.
Значение по умолчанию: 1
Если указано 0, тогда:
-
повторение будет бесконечным;
-
если переданы
--url,--fileили--code, то на каждой итерации будут проверяться только указанные плейлисты; -
если не переданы
--url,--fileили--code, то на каждой итерации список плейлистов будет подготавливаться заново. Если при этом используется кеширование, то проверенные плейлисты (результаты проверки которых ещё находятся в кеше) проверяться не будут.
# проверить 5 раз плейлисты с кодами xx и yy из my.ini
./iptvc check -i ~/my.ini -c xx --code yy --repeat 5
# бесконечно проверять все плейлисты из my.ini, без учёта проверенных
./iptvc check -i ~/my.ini --repeat 0
# бесконечно проверять плейлист из файла
./iptvc check -f test.m3u --repeat 0
--playlists-all-cooldown¶
Указывает паузу между полными циклами проверки в секундах. Параметр переопределяет check.playlists.allCooldown из конфигурации.
Пауза применяется после завершения полного цикла и перед началом следующего. Внутри цикла этот параметр не используется: для задержки между плейлистами применяется check.playlists.oneCooldown.
Значение по умолчанию: значение check.playlists.allCooldown из конфигурации, обычно 1800 (30 минут).
# проверить 5 раз с паузой 5 секунд между циклами
./iptvc check -i ~/my.ini -c xx --code yy --repeat 5 --playlists-all-cooldown 5
# бесконечно проверять все плейлисты из my.ini каждый час
./iptvc check -i ~/my.ini --repeat 0 --playlists-all-cooldown 3600
# бесконечно проверять плейлист из файла с паузой 10 секунд
./iptvc check -f test.m3u --repeat 0 --playlists-all-cooldown 10
-r, --random¶
Указывает максимальное количество случайных плейлистов из ini-файла для проверки.
Работает только вместе с --ini.
Если не указан ни разу, то будут проверены все плейлисты, которые указаны в ini-файле.
Если используется кеширование, то проверенные плейлисты (результаты проверки которых ещё находятся в кеше) проверяться не будут.
-j, --json¶
Если указано, то подробные результаты проверки будут выводиться в формате JSON.
-q, --quiet¶
Подавляет вывод всех логов.
Не влияет на --json (JSON-данные будут выведены в stdout), но перекрывает --verbose (логов не будет вовсе, независимо от повышенной подробности).
Глобальные флаги¶
Эти флаги доступны для всех команд и переопределяют значения из config.yml.
--config¶
Путь к файлу конфигурации config.yml.
Значение по умолчанию: config.yml
--debug¶
Включает режим отладки. Переопределяет app.debug из config.yml и переменную APP_DEBUG.
--log-level¶
Устанавливает уровень логирования. Переопределяет app.logLevel из config.yml.
Доступные значения: debug, info, warn, error.
-v, --verbose¶
Включает подробное логирование.
Флаги проверки плейлистов¶
Эти флаги переопределяют параметры секции check.playlists из config.yml. Доступны для команд check и serve.
--playlists-timeout¶
Таймаут HTTP-запроса плейлиста в секундах.
Переопределяет check.playlists.timeout (по умолчанию 10).
--playlists-all-cooldown¶
Задержка в секундах после проверки всех плейлистов.
Переопределяет check.playlists.allCooldown (по умолчанию 1800).
--playlists-one-cooldown¶
Задержка в секундах после проверки каждого плейлиста.
Переопределяет check.playlists.oneCooldown (по умолчанию 2).
--playlists-max-routines¶
Максимум одновременно проверяемых плейлистов.
Переопределяет check.playlists.maxRoutines (по умолчанию 1).
--playlists-per-routine¶
Количество плейлистов на одну процедуру проверки.
Переопределяет check.playlists.perRoutine (по умолчанию 1).
--playlists-user-agent¶
User-Agent для HTTP-запросов плейлистов. Можно указать несколько — будет выбран случайный при каждом запросе.
Переопределяет check.playlists.userAgent.
Флаги проверки каналов¶
Эти флаги переопределяют параметры секции check.channels из config.yml. Доступны для команд check и serve.
--channels-timeout¶
Таймаут HTTP-запроса канала в секундах.
Переопределяет check.channels.timeout (по умолчанию 10).
--channels-byte-range¶
Объём данных в байтах для загрузки от сервера при проверке канала.
Переопределяет check.channels.byteRange (по умолчанию 512).
--channels-cooldown¶
Задержка в секундах после проверки каждого канала.
Переопределяет check.channels.cooldown (по умолчанию 0).
--channels-max-routines¶
Максимум одновременно проверяемых каналов.
Переопределяет check.channels.maxRoutines (по умолчанию 50).
--channels-per-routine¶
Количество каналов на одну процедуру проверки.
Переопределяет check.channels.perRoutine (по умолчанию 10).
--channels-user-agent¶
User-Agent для HTTP-запросов каналов. Можно указать несколько — будет выбран случайный при каждом запросе.
Переопределяет check.channels.userAgent.
Флаги кеша¶
Эти флаги переопределяют параметры секции cache из config.yml. Доступны для команд check и serve.
--cache-enabled¶
Включает кеширование результатов.
Переопределяет cache.enabled (по умолчанию true).
--cache-host¶
Хост кеша.
Переопределяет cache.host (по умолчанию cache).
--cache-port¶
Порт кеша.
Переопределяет cache.port (по умолчанию 6379).
--cache-username¶
Логин для подключения к кешу.
Переопределяет cache.username.
--cache-password¶
Пароль для подключения к кешу.
Переопределяет cache.password.
--cache-db¶
Номер базы данных кеша.
Переопределяет cache.db (по умолчанию 0).
--cache-ttl¶
TTL записей кеша в секундах.
Переопределяет cache.ttl (по умолчанию 3600).