{"id":31743795,"url":"https://github.com/totvs/go-sdk","last_synced_at":"2025-10-09T11:58:14.411Z","repository":{"id":312914692,"uuid":"1048654269","full_name":"totvs/go-sdk","owner":"totvs","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-16T21:16:01.000Z","size":106,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-16T23:22:36.197Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/totvs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-01T19:57:25.000Z","updated_at":"2025-09-16T21:16:05.000Z","dependencies_parsed_at":"2025-09-02T20:37:28.493Z","dependency_job_id":"7c0758b5-2648-467a-8f27-fc7bdb025142","html_url":"https://github.com/totvs/go-sdk","commit_stats":null,"previous_names":["totvs/go-sdk"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/totvs/go-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/totvs%2Fgo-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/totvs%2Fgo-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/totvs%2Fgo-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/totvs%2Fgo-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/totvs","download_url":"https://codeload.github.com/totvs/go-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/totvs%2Fgo-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001330,"owners_count":26083059,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-09T11:57:52.792Z","updated_at":"2025-10-09T11:58:14.403Z","avatar_url":"https://github.com/totvs.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# go-sdk\n\nSDK Go com utilitários reutilizáveis para logging, tracing e integrações.\n\nResumo\n- Fachada de logging pública em `log/` para desacoplar consumidores de implementações\n  concretas (por exemplo `zerolog`).\n- Implementações concretas ficam em `log/internal` (não exportadas).\n- Helpers de trace e propagation em `trace/`.\n- Exemplos em `examples/` e alvos úteis no `Makefile`.\n\nEstrutura principal\n- `log/` — pacote de fachada: `facade.go`, testes e documentação (`log/README.md`).\n  - `log/adapter/` — adaptadores públicos que retornam `LoggerFacade` (ex.: `NewLog`, `NewDefaultLog`).\n  - `log/internal/` — implementações concretas (por exemplo `internal/backend/zerolog.go`).\n  - `log/middleware/`, `log/util/` — middlewares e helpers relacionados a logging.\n- `trace/` — helpers de propagation (`ContextWithTrace`, `TraceIDFromContext`, `GenerateTraceID`).\n- `examples/` — exemplos executáveis (ex.: `examples/logger/main.go`).\n- `Makefile` — targets comuns: `test`, `test-v`, `test-race`, `cover`, `cover-html`, `fmt`, `vet`, `build`, `tidy`, `ci`, `run-example`.\n\nLogging: API rápida\n- Construtores (adapter):\n  - `adapter.NewLog(w io.Writer, level)` — cria um `LoggerFacade` que escreve para `w`.\n  - `adapter.NewDefaultLog()` — cria um logger com configurações padrão.\n- Context helpers (em `trace` e `log`):\n  - `trace.ContextWithTrace`, `trace.TraceIDFromContext`, `trace.GenerateTraceID` — propagation de trace id.\n  - `log.ContextWithLogger(ctx, l)`, `log.LoggerFromContext(ctx)`, `log.FromContext(ctx)` — injeção/recuperação de `LoggerFacade`.\n- Helpers de campos: `WithField`, `WithFields` (disponíveis no `LoggerFacade`).\n- Erros: use `LoggerFacade.Error(err)` seguido de `Msg`/`Msgf` para incluir o campo `error` no payload. Ex.: `f.Error(err).Msg(\"failed\")` ou `f.WithFields(...).Error(err).Msgf(\"failed %s\", name)`.\n- Globais/atalhos: `log.SetGlobal(l)`, `log.GetGlobal()` e helpers de nível `log.Debug()/Info()/Warn()/Error(err)` que retornam um `LogEvent` fluente.\n\nAdicionando um adapter\n- Para suportar outra biblioteca, adicione um adaptador em `log/adapter/` que construa/retorne um `log.LoggerFacade`.\n- Mantenha a dependência concreta dentro de `log/internal` quando for necessário usar bibliotecas externas.\n\nTestes e desenvolvimento\n- Coloque testes ao lado do código (`*_test.go`). Use `bytes.Buffer` e `httptest` para capturar saída e comportamento HTTP.\n- Se um teste alterar o logger global (`log.SetGlobal`), restaure o valor anterior com `defer log.SetGlobal(prev)`.\n- Alvos úteis:\n  - `make test` — roda todos os testes.\n  - `make test-v` — testes em modo verbose.\n  - `make test-race` — com detector de race e cobertura.\n  - `make run-example` — executa `examples/logger` (use `LOG_LEVEL` para alterar o nível).\n\nFormatação e análise estática\n- Rode `make fmt` (gofmt) e `make vet` (go vet) antes de submeter mudanças.\n\nBuild / CI\n- `make build` — compila os pacotes.\n- `make ci` — target para CI que executa `fmt`, `vet` e `test`.\n\nBoas práticas\n- Prefira usar a abstração `log.LoggerFacade` nas bibliotecas para não acoplar\n  consumidores a uma implementação concreta.\n- Mantenha implementações concretas em `log/internal` para evitar vazamento de dependências.\n- O logger global é armazenado com `sync/atomic.Value`: definir o global uma vez no\n  startup é a prática recomendada; swaps em runtime são suportados mas use com cuidado.\n\nExemplos e documentação adicional\n- Veja `examples/logger` para um exemplo de uso.\n- Consulte `log/README.md` para documentação detalhada da fachada e exemplos de adapters.\n\nLicença e contato\n- Ver `LICENSE` (se presente) e abra issues/pull requests para contribuições.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftotvs%2Fgo-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftotvs%2Fgo-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftotvs%2Fgo-sdk/lists"}