NAME

ru-encoding - утилита группового перекодирования файлов в указанную кодировку.

VERSION

Version 0.05

SYNOPSIS

    ru-encoding [-h] [--man] [<files> ...] [--ext exts] [--interpreters interpreters] [--in-branch]

DESCRIPTION

Утилита определяет кодировку файла и переводит его в указанную.

        $ ru-encoding -t cp1251

Есть 4 основные режима работы:

        # Отформатировать все изменённые, но ещё не закомиченные файлы:
        $ ru-encoding
        
        # Обработать изменённые и закомиченные файлы в ветке (branch-е):
        $ ru-encoding --in-branch

        # Обработать файлы в директориях:
        $ ru-encoding --in-dir .,/tmp/mydir

        # Отформатировать указанные файлы:
        $ ru-encoding file1 /root/file2
        

С помощью опции -e (--ext) можно указать расширения файлов для форматирования (по умолчанию это pm,pl,plx,t):

        $ ru-encoding -e pm,t

А для файлов, которые расширений не имеют, можно указать список интерпретаторов, указываемых в первой строке скрипта (#!/usr/bin/env perl):

        $ ru-encoding -i perl,perl5
        

Так же можно указать кодировки и порядок в котором они будут проверяться:

        $ ru-encoding -n cp1251,utf-8
        

LEGENDS

На консоль утилита выведет файлы, которые были изменены с указанием:

equals — кодировка файла совпадает с указанной.

encode — кодировка файла изменена на указанную.

failed — кодировка файла не определена.

В случае, если хоть один из файлов failed, код завершения процесса будет равен 1.

OPTIONS

-h, --help

Показать помощь и выйти.

--man

Распечатать мануал и завершиться.

-t encoding, --to encoding

Кодировка в которую переводить файлы.

Необязательный. По умолчанию: utf-8.

-e exts, --ext exts

Список расширений через запятую.

По умолчанию: pm,pl,plx,t.

Пустая строка обозначает любые расширения.

-i interpreters, --interpreters interpreters

Список интерпретаторов через запятую.

По умолчанию: perl,perl5.

Пустая строка отменяет файлы без расширений.

-n encodings, --encodings encodings

Список кодировок через запятую.

По умолчанию берётся из переменной окружения RU-ENCODINGS, а если она пуста, равняется: utf-8,cp1251,koi8-r.

-b, --in-branch

Перекодировать изменённые и закомиченные файлы в ветке (branch-е).

-d dirs, --in-dir dirs

Перекодировать изменённые и закомиченные файлы в директориях. Директории через запятую.

ARGS

files...

Файлы или директории с файлами, которые нужно отформатировать.

LICENSE

? GPLv3

AUTHOR

Yaroslav O. Kosmina <darviarush@mail.ru>