Языконезависимый менеджер однофайловых пакетов (версионированный copy-paste)
Бывают участки кода, которые, слегка модифицируясь копируются из проекта в проект. Ради них не рационально заводить и регистрировать отдельный пакет в типовых пакетных менеджерах, потому что:
- Уходит время на создание и поддержку - необходимо создать тестовую инфраструктуру, описать спецификации, фактически придется создать ещё один проект
- Придется отдельно вносить изменения в самом пакете, обновлять пакет в основном приложении и заново заниматься его интеграционным тестированием, а если пойдет что-то не так, обрытно переключаться в проект пакета, вносить там изменения в тесты и код, публиковать и тп.
- Часто бывает, что проще слегка модифицировать код под новый проект, чем создавать универсальное решение подходящее всем проектам.
При этом хочется видеть историю изменений, централизованно хранить и делиться такими участками кода. Для таких случаев подходит goga.
goga это не замена gem, bundle, npm, yarn и тп, а дополнение. Он живет рядом и хорошо делает свою маленькую работу.
goga-модуль это обычный исходник на любом языке программирования, в который первой строкой автоматически добавлен goga-комментарий с адресом источника.
- Подключение однофайловых пакетов одной командой.
- Использует Ваш git и gists для хранения пакетов.
- Публикация пакета в общий репозиторий одной командой.
- Живет в системе контроля версий вашего приложения совместно с основным пакетным менеджером.
- Не зависит от языка программированя.
- Легко вность изменения в исходный код пакетов.
- Мультиплатформенное решение, написано на
golang
-
Установите
golangв вашу ОС по инструкции -
Установите
goga
go get github.com/dapi/goga
Список всех команд:
goga
Скачивает по ссылке файл, кладет по указанному пути и добавляет первой строкой комментарий с ссылкой на источник.
Например:
goga add https://github.com/dapi/elements/blob/master/spinner.js ./app/javascripts/
Далее вы можете подключать и перемещать файл по проекту как вам удобно, используя проектную систему контроля версий.
Сканирует указанную или текущую директорию на goga-модули (файлы с магическим комментарием) и сравнивает их с источником, сообщает если нашел изменения. Например:
> go run ./goga.go status
Scanning directory: /home/danil/code/goga_samples/
Found /home/danil/code/goga_samples/spinner.js checking - 4 diffs foundЗаливает измененния в удаленный источник указанный в магическом комментарии. Например:
goga push ./app/javascripts/spinner.js
Показывает разницу между локальным файлом и его источником. Например:
goga diff
Выводит список поддерживаемых расширений и видов комментариев. Например:
> go run syntax
List of available file extensions and its comments syntax:
.py # goga URI
.pl # goga URI
.sh # goga URI
.haml // goga URI
.c // goga URI
.cs // goga URI
.go // goga URI
.php // goga URI
.sql -- goga URI
.xml <!-- goga URI -->
.html <!-- goga URI -->
.swift -- goga URI
.js // goga URI
.java // goga URI
.slim // goga URI
.rb # goga URIПри скачивании модуля через goga он автоматически добавляет первой строкой магичекий комментарий со ссылкой на источник, например:
// goga https://github.com/dapi/elements/blob/master/spinner.js- Поддержка доступа к git-репозиторию по логин/пароль (сейчас только ssh-ключи)
- Поддержка gist
- Поддержка автоматического определения gitlab/bitbucket-репозиториев.
- Улучшить вывод diff
- shell-автокомплит
- Любая прямая ссылка на файл, например: https://site.com/spinner.js
- Ссылка на исходник в github репозитории наблюдаемый в браузере типа https://github.com/dapi/elements/blob/master/spinner.js автоматически преобразуется в https://raw.githubusercontent.com/...
На данный момент поддерживюатся исходники следующих языков программирования (определяется через расширение файла) - https://github.com/dapi/goga/blob/master/cmd/syntax.go#L31
Если Вам нужна поддержка других языкой - создайте issue или пришлите PR