Google Git
Sign in
go / example / f8bc3a00c46867f81091612ae6792ad64e1c7af9
commitf8bc3a00c46867f81091612ae6792ad64e1c7af9[log] [tgz]
authorAdam Bender <abender@gmail.com>Thu Apr 24 20:35:31 2025 -0700
committerGopher Robot <gobot@golang.org>Fri Apr 25 08:47:44 2025 -0700
treed2dc49201c40f22d9145c643b2080b8c1a612359
parent24b880c977e2156eec5965ad1ffd066661e30ace [diff]
example/slog-handler-guide: run `make`

This change is the result of running `make` to produce README.md from
guide.md. It appears that the last time `make` was run was
2024-09-06 for 4e46ff5. I confirmed that all diffs to README.md
were deliberately introduced to guide.md (in 398e112 and 40afcb7).

In addition, one change to README.md (32022ca) was backported to
guide.md.

Change-Id: I6a27b8d128630f7f7e5799ad963fd96fb33ac3df
Reviewed-on: https://go-review.googlesource.com/c/example/+/668075
Reviewed-by: Junyang Shao <shaojunyang@google.com>
Reviewed-by: Jonathan Amsterdam <jba@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Auto-Submit: Jonathan Amsterdam <jba@google.com>
2 files changed
tree: d2dc49201c40f22d9145c643b2080b8c1a612359
  1. appengine-hello/
  2. gotypes/
  3. hello/
  4. helloserver/
  5. internal/
  6. outyet/
  7. ragserver/
  8. slog-handler-guide/
  9. template/
  10. go.mod
  11. go.sum
  12. LICENSE
  13. PATENTS
  14. README.md
README.md

Go example projects

Go Reference

This repository contains a collection of Go programs and libraries that demonstrate the language, standard libraries, and tools.

Clone the project

$ git clone https://go.googlesource.com/example
$ cd example

https://go.googlesource.com/example is the canonical Git repository. It is mirrored at https://github.com/golang/example.

hello and hello/reverse

$ cd hello
$ go build
$ ./hello -help

A trivial “Hello, world” program that uses a library package.

The hello command covers:

  • The basic form of an executable command
  • Importing packages (from the standard library and the local repository)
  • Printing strings (fmt)
  • Command-line flags (flag)
  • Logging (log)

The reverse reverse covers:

  • The basic form of a library
  • Conversion between string and []rune
  • Table-driven unit tests (testing)

helloserver

$ cd helloserver
$ go run .

A trivial “Hello, world” web server.

Topics covered:

outyet

$ cd outyet
$ go run .

A web server that answers the question: “Is Go 1.x out yet?”

Topics covered:

  • Command-line flags (flag)
  • Web servers (net/http)
  • HTML Templates (html/template)
  • Logging (log)
  • Long-running background processes
  • Synchronizing data access between goroutines (sync)
  • Exporting server state for monitoring (expvar)
  • Unit and integration tests (testing)
  • Dependency injection
  • Time (time)

appengine-hello

A trivial “Hello, world” App Engine application intended to be used as the starting point for your own code. Please see Google App Engine SDK for Go and Quickstart for Go in the App Engine Standard Environment.

gotypes

The go/types package is a type-checker for Go programs. It is one of the most complex packages in Go's standard library, so we have provided this tutorial to help you find your bearings. It comes with several example programs that you can obtain using go get and play with as you learn to build tools that analyze or manipulate Go programs.

template

A trivial web server that demonstrates the use of the template package's block feature.

slog-handler-guide

The log/slog package supports structured logging. It features a flexible backend in the form of a Handler interface. This guide can help you write your own handler.