Google Git
Sign in
go / example / refs/heads/master
commit24b880c977e2156eec5965ad1ffd066661e30ace[log] [tgz]
authorAdam Bender <abender@gmail.com>Tue Apr 08 18:58:56 2025 -0700
committerJonathan Amsterdam <jba@google.com>Tue Apr 15 10:46:34 2025 -0700
treec92bd9f898575cc8c40e854e3e84701917333d78
parentdd59d6852dfb14d1df8ea02959345bc72cdc5c03 [diff]
example/weave: update TOC anchors to remove **, _, and `

When GitHub's Markdown parser creates anchors for sections, it removes
formatting directives like **, _, and `. See the discussion at
https://support.github.com/ticket/personal/0/3324945

The links to the sections with formatting directives in the current TOC at https://github.com/golang/example/blob/master/slog-handler-guide/README.md
are broken for this reason.

This change modifies weave to also remove those characters from the
anchor links it generates.

This change also replaces the deprecated os.SET_SEEK with io.SeekStart
and removes two unused functions.

Change-Id: I66e3aa8140e14146bdb349c4ccfb773fe7414c67
Reviewed-on: https://go-review.googlesource.com/c/example/+/664015
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Jonathan Amsterdam <jba@google.com>
Reviewed-by: Junyang Shao <shaojunyang@google.com>
1 file changed
tree: c92bd9f898575cc8c40e854e3e84701917333d78
  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.