gitflic-rawlink.sh

Генератор raw-ссылок для Gitflic

Дисклеймер

Данный скрипт опубликован как proof of concept, но дальнейшего развития скорее всего не получит. Ибо bash — это не язык программирования для скриптов в сотни строчек, пусть его и можно так использовать, но его использование тут уже на грани.

Думаю переписать его на python или xorsh.

Использование

gitflic-rawlink.sh [options] путь/до/файла.png [ещёфайл.jpg] …

Файл должен существовать. Файл должен отслеживаться в репозитории. Файл не должен иметь ожидаемых изменений (зафиксирован).

Как минимум один из git-источников должен ссылаться на репозиторий в Gitflic

Вывод

RAW-ссылка на файл из репозитория Gitflic. Одна на строку.

Параметры

• [-h]

  • Показывает это сообщение

    Как только сценарий замечает этот флаг, он сразу прекращает работу, отображая это сообщение. Потому его нельзя использовать с другими параметрами.

• [-d]

  • Флаг явно определяет параметр inline в false, тем самым при переходе по ссылке будет произведена загрузка файла.\

    По умолчанию скрипт не указывает параметр inline, позволяя серверу решить, что делать. На момент написания значение по умолчанию этого параметра на сервере = true

• [-i]

  • Флаг явно определяет параметр inline в true, позволяя использовать ссылку в качестве источника изображения или позволяя браузеру отобразить файл перед загрузкой.

    По умолчанию скрипт не указывает параметр inline, позволяя серверу решить, что делать. На момент написания значение по умолчанию этого параметра на сервере = true

• [-r remote]

  • Источник git в котором искать ссылку на Gitflic репозиторий, для которого необходимо сгенерировать ссылку.

    Поведением по умолчанию является перебор. Начиная с источников с именем origin и gitflic (именно в таком порядке). Затем все остальные источники в алфавитном порядке (если присутствуют). Если не найдено источников git, указывающих на Gitflic, сценарий выйдет с ошибкой.

    Если используется этот параметр, перебор будет отключен и если ссылка на Gitflic на указанном источнике не будет найдена, сценарий выйдет с ошибкой.

• [-c commit_id]

  • Ссылка на фиксацию изменений (хэш-сумма коммита), которую следует указать в URL.

    Этот параметр взаимоисключает -b. Нельзя одновременно указывать на коммит и на ветку.

    Стандартным поведением является определение последнего сделанного коммита в репозиторий.

    Если вы не хотите, чтобы скрипт передавал этот параметр в ссылке вообще, передайте пустой аргумент.

• [-b branch]

  • Ветка git на которую следует указать в URL. Вместо того, чтобы указывать на определённую фиксацию изменений, определить ветку git, чтобы загрузить файл по предоставленному пути.

    Этот параметр взаимоисключает -c. Нельзя одновременно указывать на коммит и на ветку.

    Не является стандартным поведением. Это полезно, если вы хотите всегда указывать на последнюю версию файла (например, в master ветке). Но если файл будет переименован, ссылка будет сломана.