Golang: часто используемые пакеты. Быстрое создание программ командной строки, объединение структур и генерация случайных чисел

Репозиторий проекта

• github — отменён из-за проблем с сетью;
• gitee.

Описание проекта

Uymas — это набор инструментов на языке Go. Версия Go: v1.18.

Поддерживает golangci-lint — рекомендуемые стандарты.

# Выполнение рекомендаций по стандартам
golangci-lint run ./...

# Запуск всех тестовых случаев
go test ./...

Ветки проекта

master — основная ветка проекта; develop — ветка разработки; nestling — экспериментальная ветка, содержит экспериментальный код.

Порядок слияния веток: nestling → develop → master.

Установка

# github
$ go get -u gitee.com/conero/uymas

Встроенные переменные среды:

# logger/lgr пакет, настройка уровня журнала:
UYMAS_LGR_LEVEL = info

# команда uymas
UYMAS_CMD_UYMAS_LONG = true
UYMAS_CMD_UYMAS_COLON = false

bin

Синтаксис командной строки:

$ [command] [<options>]

<options> имеет следующий формат:

1. Параметры конфигурации; полное и сокращённое имя:

   • --set[=true];
   • -short[=true].

2. Вторичные команды (<sub-command>), которые следуют сразу за [command]:

$ [command] [<sub-command>] [<options>]

Вторичные команды (PSC) — плагины.

Сканирует каталог $/ и каталог «$/plg» на наличие исполняемых файлов. Если они есть, то считаются PSC.

Формат имён:

• $/$app-name — name;
• $/$app_name — name;
• $/name — name;
• $/plg/$app-name — name;
• $/plg/$app_name — name.

tinygo

Экспериментальная поддержка tinygo (Experimental/Try). Требуется версия не ниже v0.31.0.

Пример компиляции:

# Компиляция tiny пакета
tinygo build ./cmd/tiny

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

package main

import (
	"fmt"
	"gitee.com/conero/uymas/bin"
)
// Команда test
type Test struct {
	bin.Command
}
// Инициализация проекта
func (a *Test) Init ()  {
    // При перезаписи метода необходимо сначала вызвать метод родительского типа структуры [!!]
    a.Command.Init()
    
    // todo ....
}
// Запуск, выполнение внутренней вторичной команды распределения
func (a *Test) Run ()  {
	fmt.Println("ffff.")
}

// Команда yang
type Yang struct {
	bin.Command
}


func main() {
	//router := &bin.Router{}
	//bin.Register("test", &Test{})
	//bin.Register("yang", &Yang{})
	//bin.Adapter(router)
	bin.RegisterApps(map[string]interface{}{
		"test": &Test{},
		"yang": &Yang{},
})
	bin.Run()
}