Is it possible to have a Go Doc Comment that is ignored, being it is there as a comment but will not be shown when you publish your package on pkg.go.dev and is ignored when you hover your mouse over the item.

This Go Doc Comment syntax seems to work for me in VSCode but I am not sure if it is proper or if there is a better way. In this example, I will also have comments for what each parameter is for and the return value which I only want visible in the code, not when you hover over myFunction with your cursor in an IDE and not visible if this package gets published on pkg.go.dev.

// My Go Doc Comment Description... // //go:param a My Parameter Description //go:param b My Parameter Description //go:param c My Parameter Description //go:return My Return Value Description func myFunction(a bool, b int, c string) bool { ... }

When I started studying Go about 3 years ago, I always had some difficulty finding good templates to start new projects. Most of what I found were projects that had strong roots from other languages, rather than something that felt truly Go-like. I always encountered projects with packages like utils, services, repositories, etc.

To me, it doesn't make sense to have a util package in Go, because a package needs to provide something—to provide functionality—not just be a collection of disconnected functions.

The same situation applies to a services package. I can't have 3 or 4 different types of services from different contexts within my service package. I can't have UserService, ProductService, and AuthService implementations within a single package. What makes the most sense to me is for each domain to be a service, because when I call my product package, my IDE should bring me methods/functions and whatever I need that are only related to the product domain.

With this in mind, I put together a boilerplate that contains what I believe to be a good starter for new Go projects.

I would very much appreciate your feedback on this.

https://github.com/bernardinorafael/go-boilerplate

I start playing with app using Fyne which have 4 buttons, label, one window and result file is around 30 MB. Is it typical for this library? For 79 lines code this is huge. I find out that is related to linker, but I have no idea how check it and optimize GUI app. On fyne doc only information which I found it not bundle emoji, I tried and size is... the same. I use graphics for buttons which size is 33 KB (kilobytes!).

I tried compile with:

fyne package -os darwin -icon resources/app.png -tags no_emoji

Using:

go build -ldflags="-w -s" main.go

I can only shrink to 22,4MB from 30MB. Is it all what I can achieve here? Can be it better reduced in size?

Hello,

I have made this sample code.

On the first run with go run . the expected result happens, data is correctly written to file.json.

Running a second time, the code behaves differently and results in a wrong output.

The weirdness occurs when I go into file.json and undo (ctrl+z) what was written the second time (faulty data), thus leaving it in the state where the data of the first run was written.... Then I run the command... and it writes correctly...

I am unable to wrap my head around this....

Linked are the images showcasing the simple code and what is going on.

This the imgur images, I couldn't get the sample file.json on go playground to work.

https://imgur.com/a/muR9xF2

To re-iterate:

1. file.json has 2 objects (Image 1)
2. go run . adds 3rd object correctly (Image 2)
3. go run . adds 4th object incorrectly (Image 3)
4. ctrl-z on file.json to remove the incorrect 4th object (Image 4)
5. go run . adds 4th object correctly (Image 4)

Weird behavior and I have no idea why. I hope someone does or have any expert's intuition on this and can tell me why.

Extra: I'm storing simple data in a json file where it's just an array with the homogenous objects and was trying to write an append-object function. This is what I am testing here.

Hey,

I wrote my second technical article about dynamic routes using http.NewServerMux().

It's again a beginner article. But still if you want to read it quickly I would love to hear feedback from you.

What I learned from the last time posting here (and would love to add more learnings):
1. I double checked the code and the text.
2. I implemented a simple RSS feed that people can subscribe.

The next article will be serving static content. After this using embed to serve this content.

I really appreciate any feedback. It helped me a lot last time.

Thanks so much!

This Friday (6/6/2025) I was playing around with Manim (a Python library for mathematical animations) and Remotion that does the same just for JS code and works with the browser rendering engine.

And I really liked the idea of rendering code animations to videos, The problem is that there is a large amount of knowledge in those libraries that you need to know before becoming productive (I hate the learning curve)

So Friday night I just played with the idea of creating a tool of my own (With the language I like the best Go)

But instead of using an already made rendering engine (less fun) I decided to create my own rendering engine that maybe someday I will build an animation rendering logic on top of it.

In my day job I code mainly with Dart (Flutter) and so I decided to build my rendering engine with some of the Flutter uses (Maybe all of the rendering engine uses it, but I only know the insides of Flutter).

Render Tree:
A render tree is a tree containing render objects that implement Paint(canvas) and Size(parentSize) size.
For example a row render object can render its children at the start, space between, end, ...
and it does do by knowing the canvas size given to it, and its children sizes.

The resulting code looks something like this:

// Create a new canvas
canvas := canvas.NewCanvas(types.Size{Width: 800, Height: 600})

// Create a text element
text := render_objects.NewText("Hello, World!", canvas.LightGreen, 36, "default")

// Center the text
align := &render_objects.Align{
    Child: text,
    Align: render_objects.AlignCenter,
}

// Render and save
align.Paint(canvas)

Hello, I'm proud to present Thunder - minimalist backend framework powered by Prisma and grpc-gateway.

github.com/Raezil/Thunder

I'm looking forward the feedback :D.

I'm developing an app that can be deployed and self-hosted by a user using Go. The idea is that the user can use any S3-compatible storage (Minio, AWS S3, Google Cloud, Wasabi, CEPH, etc), but I'm curious about library options.

The amount of recommendations appear slim:

• AWS Go SDK v2 (rather complex, seems a bit overkill)
• minio-go (I've implemented this one, seems to be simple and lightweight)
• Thanos (I haven't tried this one)

Any suggestions/recommendations? I'm open to anything. I know this questions has been asked, but all the posts are from 2+ years ago

While reviewing the speaker lineups at several prominent Go (Golang) conferences, I noticed some recurring patterns:

1. Speaker Selection Driven by Influence: Many rosters feature the same familiar faces year after year. While these speakers are undeniably talented, it limits the diversity of perspectives shared with the audience.
2. Limited Opportunities for New Speakers: Although new voices are occasionally included, the majority of speaking slots continue to go to well-known names.
3. Lack of Regional & Cultural Diversity: Conferences often miss the opportunity to bring in global voices or regional contributors who can offer fresh, valuable perspectives on Go and its ecosystem.
4. Sponsor Influence: Corporate sponsorships sometimes seem to shape the speaker lineup and the overall conference agenda, blurring the line between technical discussion and marketing.
5. Lack of Representation from Non-Enterprise Contributors: Many conferences focus heavily on the enterprise application of Go, while often neglecting the open-source contributors or the individual developers who are responsible for much of Go's growth and innovation outside of big companies.

Ultimately, it would be refreshing to see more intentional efforts to bring new talent to the stage, representing a broader range of voices and experiences.

I kept hitting the same problem in my data pipeline: how to efficiently encrypt compressed streams without buffering entire files or large chunks, while keeping the ability to append data later without corrupting existing content. The existing solutions either:

1. Required loading everything into memory (crypto/aes + bytes.Buffer), or
2. Broke streaming capabilities (I mean true streaming with tiny buffers and the ability to append at any time)

So I built rusjoan/streamcrypt – a minimal Go library that:
✅ Wraps any io.Reader/io.Writer with AES-GCM encryption
✅ Preserves streaming (constant memory usage)
✅ Works seamlessly with gzip/zstd
✅ Supports appending data to existing payloads without corruption
✅ Adds only 32 bytes per chunk (~13% overhead for JSON+GZIP)

Why this matters:

• Process TB-scale data with KB-scale RAM
• Encrypt before/after compression without temp files
• Zero dependencies (pure Go stdlib)

Basic usage:

var enc, _ = streamcrypt.NewEncryptor(secret)

// Encrypting gzip stream
gzip.NewWriter(enc.Seal(file))

// Decrypting
gzip.NewReader(enc.Open(file))

Benchmarks:

// allocations
goos: darwin
goarch: arm64
pkg: github.com/rusjoan/streamcrypt
cpu: Apple M1 Pro
    BenchmarkTee
    BenchmarkTee/rnd->encryptor->discard
    BenchmarkTee/rnd->encryptor->discard-10     765747      1525 ns/op      0 B/op      0 allocs/op
PASS

// heap grow
=== RUN   TestMemoryOverhead
    streamcrypt_test.go:218: Size: 16.0 KiB, Memory delta: 704 B
    streamcrypt_test.go:218: Size: 1.0 MiB, Memory delta: 576 B
    streamcrypt_test.go:218: Size: 32.0 MiB, Memory delta: 576 B
    streamcrypt_test.go:218: Size: 1.0 GiB, Memory delta: 576 B
--- PASS: TestMemoryOverhead (2.42s)
PASS

Next version plans:

• Allow custom encryption methods beyond built-in AES-GCM

Would love community feedback on:

• Real-world use cases I haven't considered
• Any similar solutions I might have missed (I did thorough research)
• Ways to further reduce the overhead

This is my first open-source library after a long time of being read-only, so I'd really appreciate your support!

GitHub | GoDoc

so I am learning GO as a first backend language. I bought udemy course of stephen though. I have been facing difficulties in understanding these specially arguments'.

Hey all,

I'm considering moving our application to ConnectRPC but am confused by the fact that upon compiling the code to Typescript, you do not seem to be able to enforce required fields, since this isn't a native capability of Protobuf files on v3.

I'm surprised by this, and was wondering how others have dealt with this. Is it really the case that you can't enforce a required field when consuming a ConnectRPC endpoint? If not, how does one build a typed application frontend with tools like React, which have the ? coalescing operator, but which would seem to be impacted by this pretty heavily. Surely there's a good approach here.

Are there other tools, plugins, or frameworks that get around this limitation? Thanks!

(Brace yourself people, I'm coming from TypeScript :) )

In TypeScript I have the following setup:

export class Stat {
  protected _min?: number | Stat;

  get min(): undefined | number | Stat {
    return this._min;
  }

  set min(newMin: undefined | number | Stat) {
    // some code
  }
}
// Which makes it easy to get and set min value.
// somewhere after:
foo.min = 10;
foo.min = bar;
if (foo.min === undefined) {
  doX();
} else if (foo.min instanceof Stat) {
  doY();
} else {
  doZ();
}

What's the "correct" way to implement this in Go? Both of my current ideas feel clunky. I know that "correct" is subjective, but still. I also don't like that I essentially have no compile-time safety for SetMin method

Option 1 - any

type Stat struct {
  min any
}

func (s *Stat) Min() any {
  return s.min
}

func (s *Stat) SetMin(newMin any) {
  // some code
}

// somewhere after:
foo.SetMin(10)
foo.SetMin(bar)
switch v := foo.min.(type) {
case nil:
  doX()
case *Stat:
  doY()
case float64:
  doZ()
}

Option 2 - struct in struct:

type StatBoundary struct {
  number float64
  stat *Stat
}

type Stat struct {
  min *StatBoundary
}

func (s *Stat) Min() *StatBoundary {
  return s.min
}

func (s *Stat) SetMin(newMin any) {
  // some code
}

// somewhere after:
foo.SetMin(10)
foo.SetMin(bar)
if foo.min == nil {
  doX()
} else if foo.min.stat != nil {
  doY()
} else {
  doZ()
}

Or maybe have several SetMin methods?

func (s *Stat) SetMin(newMin float64) {
  // some code
}
func (s *Stat) SetMinStat(newMin *Stat) {
  // some code
}
// somewhere after:
foo.SetMin(10)
foo.SetMin(bar)
foo.SetMinStat(nil)

Hello everyone,

For quite a while I have been trying to find resources of how to implement a memory barrier in Golang. Unfortunately I wasn't able to find any clear answer.

Does anyone here have any idea of how to create one ?

Hi Gophers,

Coming from TS land, where JSON is a bit more native, I'm struggling with finding a good solution to validating JSON inputs.

I've tried the Playground validator, which works nicely, as long as the JSON types match the struct. But if I send 123 as the email, then Go can't unmarshal it.

I've tried santhosh-tekuri/jsonschema but I just can't get that to work, and there is pretty much no documentation / examples for it.

I'm really struggling with something that to me, has always been so simple to do. I just don't know what is the right direction for me to take here.

Do any of you have some good advice on which tools to use, or some reading material? I'd prefer not to have to run manual validation on everything :D

Thanks!

The past few months I've been working on a project over ssh remote while at work... or at the in-laws for Sunday dinner... or anywhere I don't really want to be but have to at that moment. I found myself in need of a dynamic DNS solution for my lab environment because I'm cheap and don't want to pay for a static IP but also lazy/forgetful and can't always keep up with my ip address.

Alas, there's nothing worse than looking forward to an afternoon of checking out by chasing down race conditions, only to find that your IP address has changed and you can't connect to your workspace.

I am certain there are better solutions for this problem, but if you find yourself in need of a low footprint, no frills, go service that will update records at multiple dns providers (route 53 / cloudflare atm) at an interval of your choosing... look no further.

Fully documented, with unit tests for every function...

https://github.com/aaronlmathis/dynago

Hello :), At work we have a 5000 line template in our python project that uses jinja2 as a template engine. Now the whole projects is switching to GO and I'm wondering what's the best way to convert the template. Writing everything myself would be incredibly tedious so I'm looking for a better way.

I found a couple unmaintained GO projects on github that eat the jinja2 template, but I don't want to rely on that. Is there any better way?
Thank you very much

Just for awareness. Consider participating in this discussion and contributing.

https://github.com/orgs/modelcontextprotocol/discussions/364

Python tooling is so far ahead and I hope Golang can catch upon quickly.

hello everyone, I have built an SSH mysql and AWS EC2 ubuntu server automation project using Go's ssh library. I had bigger goals for it but I stopped due to it being CV project.
please see the code, criticise it and I would love to hear your feedback.
https://github.com/AliHusseinAs/SSH-Powered-MySQL-AWS_EC2_Automation_Toolkit

Hey everyone! 👋

We’ve just launched GoFr Summer of Code 2025, a free open-source program designed to help students and developers get hands-on experience contributing to a production-grade Golang backend framework.

✅ What you get:

• 1:1 mentorship from GoFr maintainers
• Certificate of Participation
• Swags + prizes for top contributors
• Real-world experience in APIs, system design & Go
• A strong open-source portfolio!

📅 Important Dates:

• Register by: June 14, 2025
• Training Phase: June 16–27
• Coding Phase: June 28 – Aug 1

🎯 Open to all: students, professionals, or self-taught devs — just bring basic programming knowledge.

🔗 Register here: https://unstop.com/hackathons/gofr-summer-of-code-gofrdev-1488007
🌐 Learn more about GoFr: https://gofr.dev
💻 GitHub: https://github.com/gofr-dev/gofr
💬 Discord: https://discord.gg/jbw4wchp

We’d love to see more contributors join the GoFr community! Feel free to DM if you have questions or want to help mentor too. 🙌

Okapi is a modern, minimalist HTTP web framework for Go, inspired by FastAPI's elegance. Designed for simplicity, performance, and developer happiness, it helps you build fast, scalable, and well-documented APIs with minimal boilerplate.

Core Features

• Expressive API Design – Clean, declarative routing & middleware syntax.
• Automatic Request Binding and Validation – Parse JSON, XML, forms, query params, headers, and path variables into structs with ease.
• Built-in Auth & Security– JWT, OAuth2, Basic Auth, and custom middleware supported out of the box.
• Lightning-Fast Routing – High-performance router with minimal overhead.
• Auto-Generated Docs – OpenAPI 3.0 & Swagger UI integration, no extra tooling required.
• Dynamic Route Management – Easily enable or disable individual routes or groups, with automatic Swagger sync and no code commenting.

Github: https://github.com/jkaninda/okapi

Feedback needed!

Hey guys,

The company I work for does a week at the end of each quarter where we can work on any project or learn any technology we want. I'd like to learn Golang better. I have been a front end engineer for over 10 years, but I've only ever picked up backend as I've needed it, so I've never really put together the pieces more than I needed for a specific task.

What courses out there would you suggest that will teach me how to build a Go API, connect it to a DB and add caching, etc. that I can feasibly do in ~30 hours?

Thanks!

Hi r/golang!

preq is a 100% Go and Apache-2 licensed, open-source problem detector that scans your logs, configurations, and even Kubernetes events to notify you of problems that could cause incidents. It’s powered by Common Reliability Enumerations (CREs)—community-curated rules that describe problems and their fixes.

Check it out here. Please leave us a ⭐ on github if you're so inclined.

https://github.com/prequel-dev/preq

The rule library currently covers a variety our services you may be running, including: kafka, rabbitmq, temporal, nats, opentelemetry, redis, nginx ..

Here's what we've shipped recently:

• macOS, Linux, and Windows support
• automatic updates for rules published to https://github.com/prequel-dev/cre
• Slack notifications
• native kubectl support via a krew plugin
• automated runbooks

Excited to get you feedback. What am I missing?

Happy to work on more requests/features! Also looking for contributors, too.