В этой главе мы научимся устанавливать сторонние пакеты, а также разберемся как работать с зависимостями и переменной окружения GOPATH.
Для создания нашего web-сервиса, вместо стандартной библиотеки воспользуемся популярным web-фреймворком echo.
Добавим в секцию import фреймворк.
import (
"github.com/labstack/echo"
"net/http"
)
Если мы попробуем запустить наш файл командой go run src/app/main.go
, то получим
ошибку imported and not used: "app/vendor/github.com/labstack/echo"
это связано с тем,
что в Go, если мы что-то объявляем или импортируем, то мы обязаны это использовать. Все неиспользуемые
импорты и переменные должны быть удалены из кода перед компиляцией. Это требование может
показаться излишне строгим, однако оно помогает держать код "в чистоте".
Давайте перепишем функции handler
и main
c использованием фреймворка.
func handler(c echo.Context) error {
return c.String(http.StatusOK, "hello world")
}
Вместо двух аргументов у нас теперь один с типом echo.Context
. Данный тип позволит
более удобно работать с HTTP запросом и ответом. Например, мы избавились от приведения
типов.
Кроме того, функция обработчика теперь возвращает значение с типом error
- это встроенный в
язык интерфейс, в котором описан только один метод Error
.
type error interface {
Error() string
}
func main() {
e := echo.New()
e.GET("/", handler)
e.Start(":8080")
}
Как видим, место стандартного http сервера занял фреймворк echo. В остальном код особо не изменился.
Попробуем снова запусить программу командой run. В результате увидим ошибку.
main.go:4:2: cannot find package "github.com/labstack/echo" in any of:
и далее
список директорий, в которых компилятор пытался найти пакет.
Переменная окружения GOPATH определяет, где компилятор будет искать
пакеты, указанные в секции import
. Как и PATH, GOPATH может содержать несколько
директорий, разделенных двоеточием (unix). Сначала пакет будет искаться в первой
указанной директории, затем во второй и т.д.
Чтобы получить текущее значение GOPATH наберите go env GOPATH
Структура директорий указанных в GOPATH предопределена и содержит три основных поддиректории:
- src - исходные коды
- pkg - скомпилированные пакеты
- bin - выполняемые файлы
Обычно в примерах, которые можно найти в интернет, для установки библиотек и
зависимостей используется команда go get
. Эта команда скачивает и устанавливает
библиотеку в директорию, указанную в переменной окружения GOPATH.
Однако go get
не умеет разрешать зависимости и учитывать версии пакетов
как это делает composer.
Для решения этой проблемы, начиная с версии 1.6 Go поддерживает использование
папки vendor, в которой прежде всего будут искаться сторонние пакеты, указанные в секции
import
.
Для Go было написано много аналогов composer, однако на данный момент существует официальный экспериментальный инструмент dep. На нем мы и остановимся.
Чтобы установить dep наберите go get -u github.com/golang/dep/cmd/dep
Наберите dep init src/app
для того, чтобы установить все зависимости для
нашего web-сервиса.
В результате выполнения данной комманды в папке src/app
будут созданы
файлы Gopkg.lock
, Gopkg.toml
- аналоги composer.lock
и composer.json
А так же папка vendor
, в которую скачаны необходимые пакеты.
Код находится в src/import_and_deps
.