🤔 Context vs структура: следует ли передавать информацию, специфичную для запроса, через context.Context?

HTTP-обработчики могут использовать контекст для управления тайм-аутами запросов или отменой в рамках запроса. Тип Context также позволяет передавать значения (например, идентификатор пользователя, связанный с запросом) другим функциям.

❓Следует ли использовать этот механизм для передачи информации по цепочке вызовов запроса? Или лучше использовать обычную структуру?

Вот две причины, по которым использование Context для передачи значений может быть плохой идеей:

Значения в Context представляют собой пары ключ/значение, где ключ и значение являются пустыми интерфейсами (т. е. any). Другими словами, значения в контексте — это как мешок со всем подряд. Компилятор не может помочь вам отловить ошибки типов или даже проверить, есть ли информация. Удачи в устранении неполадок 😉

Если вы видите функцию, принимающую параметр Context, вы не можете сказать, что внутри. Если вы видите функцию, которая принимает параметр структуры, вы можете ясно видеть, что данные передаются, и что это за данные.

❓Но разве doSomething(ctx) не выглядит намного чище, чем doSomething(ctx, someStruct)?

Чистый код сам по себе не является целью. Код не чист только потому, что он короткий. Код чистый, если читатель может ясно видеть, что он делает.

❓Так context.WithValue() следует избегать?

Значения в контексте могут быть полезны, если они не критичны для бизнес-логики приложения. Например, совершенно нормально передавать идентификаторы запросов для логирования или измерения метрик. Читатель все равно сможет понять логику кода, и если что-то пойдет не так с этим идентификатором, это повлияет только на логирование или метрики приложения, но не на результат запроса.

💡Если данные важны для вашей бизнес-логики, не помещайте их в Context.

#tip

⚡️Свершилось: канал с книгами только по Go

Мы создали для вас канал, куда будем публиковать самые полезные книги только для Go-разработчиков. Подписывайтесь!

👉Книги для Go разработчиков

👾 Ретроспектива Ebitengine в 2023 году

Ebitengine (ранее Ebiten) — популярный движок 2D-игр для Go, который позволяет создавать игры на многочисленных платформах, включая мобильные устройства и Nintendo Switch.

Разработчик движка Hajime Hoshi празднует десятилетие проекта и рассказывает, что произошло с ним в этом году. Под катом много интересного, включая видео некоторых выпущенных игр на базе Ebitengine.

🧰 GitHub Actions CI/CD pipeline для деплоя Go-приложения: простой пример для Go-разработчика

Автор написал простейшее приложение и описал шаги по созданию пайплайна для деплоя веб-приложения на Linux-сервер. Ниже — его полный пример:

name: Golang-App-Workflow
'on':
  push:
    branches:
      - main
jobs:
  build-GoAppliation:
    runs-on: ubuntu-latest

    steps:
      
      - name: Checkout-Repository
        uses: actions/checkout@v4

      - name: Setup-Golang
        uses: actions/setup-go@v4
        with:
          go-version: '1.21'
          check-latest: true
      - run: go version

      - name: Install-Golang-Dependencies
        run: go mod download

      - name: Build-Golang-App
        run: GOOS=linux go build -o build/MusicAlbumAPI -v

      - name: Display-Build-Golang-App
        run: ls -R build/

      - name: Create-Env-File
        run: 'echo "APIKey=${{ secrets.APIKey }}" > build/.env'

      - name: Display-Env-File
        run: cat build/.env

      - name: Run-Unit-Test-Golang-App
        run: go test

      - name: Copy-Build-Golang-App
        uses: appleboy/scp-action@master
        with:
          host: '${{ secrets.VM_HOST }}'
          username: '${{ secrets.VM_USERNAME }}'
          key: '${{ secrets.VM_SSH_KEY }}'
          port: '${{ secrets.VM_SSH_PORT }}'
          source: build/
          target: /var/www/GoApplications

      - name: Deploy-Build-Golang-App-To-Ubuntu-VM
        uses: appleboy/ssh-action@master
        with:
          host: '${{ secrets.VM_HOST }}'
          username: '${{ secrets.VM_USERNAME }}'
          key: '${{ secrets.VM_SSH_KEY }}'
          port: '${{ secrets.VM_SSH_PORT }}'
          script: |
            cd /var/www/GoApplications/build
            ls -l
            sudo systemctl reload nginx
            sudo systemctl status nginx

🤔 Где искать библиотеки и инструменты для своих проектов?

🧰 Подборка для Go-разработчика:

🔗 pkg.go.dev

Здесь вы можете найдете пакеты по различным критериям и получите информацию о версии, лицензии и многом другом.

🔗 GitHub

Вводите в поисковую строку language:go + свой запрос и анализируете результаты.

🔗 Awesome Go

Один из самых старых и самых поддерживаемых кураторских списков по Go.

🔗 Libhunt.com

Коллекция Go-проектов, отфильтрованных по количеству упоминаний, звезд или другим критериям.

🔗 go-recipes

Тщательно подобранный список полезных Go-инструментов, разделенных на категориям.

#tip

💡20 советов по тестированию из доклада Расса Кокса на GopherCon Australia 2023

📌 Оставим их в оригинале:

1. Make it easy to add new test cases.
2. Use test coverage to find untested code.
3. Coverage is no substitute for thought.
4. Write exhaustive tests.
5. Separate test cases from test logic.
6. Look for special cases.
7. If you didn’t add a test, you didn’t fix the bug.
8. Not everything fits in a table.
9. Test cases can be in testdata files.
10. Compare against other implementations.
11. Make test failures readable.
12. If the answer can change, write code to update them.
13. Use txtar for multi-file test cases.
14. Annotate existing formats to create testing mini-languages.
15. Write parsers and printers to simplify tests.
16. Code quality is limited by test quality.
17. Scripts make good tests.
18. Try rsc.io/script for your own script-based test cases.
19. Improve your tests over time.
20. Aim for continuous deployment.

👉 Источник

🤔 Запутались в кучах Go? Не волнуйтесь, вы не одиноки.

Max Hoffman из DoltHub заглянул под капот container/heap и обсудил различные аспекты реализации куч в Go, включая использование указателей на срезы и неизменяемые указатели, а также юзкейсы дженериков для упрощения работы с кучами.

👉 Читать статью

📊 Топ-20 опенсорсных Go-проектов по количеству упоминаний в соцсетях: коллекция от LibHunt

Многие не нуждаются в представлении, но есть и те, о которых вы могли не знать:

🔧 ollama — инструмент для локального запуска больших языковых моделей.
🔧 tailscale — самый простой и безопасный способ использования WireGuard и 2FA.
🔧 rclone — rsync для облачного хранилища
🔧 cursusdb — высокопроизводительная, распределенная документо-ориентированная in-memory БД
🔧 zen — блокировщик рекламы и средство защиты конфиденциальности для Windows, macOS и Linux
🔧 LinGo — TUI для изучения языков с помощью текста.
🔧 cli — официальный CLI-клиент для GitHub
🔧 cerbos — масштабируемое решение для авторизации
🔧 upm — универсальный менеджер пакетов (Python, Node.js, Ruby, Emacs Lisp)
🔧 gron — grep для JSON
🔧 frankenphp — cовременный сервер PHP-приложений