Где в структуре проекта расположить обертки для сторонних библиотек и API, как их назвать?

Question

[FedorWK]

Внимательно изучил рекомендуемую структуру проекта на Go.
Не смог понять, где следует располагать пакеты-обертки для сторонних библиотек и API. В internal/pkg/? В tools/?

Второй вопрос, есть ли какие-либо правила наименования таких пакетов? Если не правила, то хорошие практики?

Answer 1

[Andrey Tsvetkov]

Рекомендуемую кем? Это самозванцы, пруф

По сути абсолютно не важно куда вы положите обёртку, можно в internal, можно в pkg, можно вообще создать папочку services и туда запихать все внешние зависимости. Нет правил

Comments

[FedorWK]

Благодарю за ответ! А по поводу нейминга есть рекомендации? Ничего лучше *packagename*utils в голову не приходит, да и это выглядит стремно.

[Andrey Tsvetkov]

Всё зависит от конкретики. Если это обёртка на конкретным АПИ конкретного сервиса, то я бы обозвал по названию сервиса. Нууу допустим вам в проекте нужна инфа по погоде, которую вы будете получать из внешних источников, я бы в таком случае создал пакет pkg/weather и в нём уже разместил реализацию обёртки для ЯндексПогоды, ГуглПогоды, или какой-нить OpenWeather

Answer 2

[Евгений]

У папки internal есть четкое и определенное назначение, там должны быть внутренние пакеты которые вы не хотите чтобы были доступны для других проектов. Подробнее тут

По поводу структуры. Храните где угодно и где удобно, главное чтобы структура была логичной. А в том репо, с так называемой рекомендованной структурой, не шуточный холивар, что это не рекомендуемая структура и тем более ни имеет ни какого отношения к стандарту, с чем я лично согласен.