When you start a new project in Go, you might begin by cloning an existing project. That way, you can start with something that already works, making incremental changes instead of starting from scratch. For a long time now, we have heard from Go developers that getting started is often the hardest part. New developers coming from other languages expect guidance on a default project layout, experienced developers working on teams expect consistency in their projects’ dependencies, and developers of all kinds expect an easy way to try new products and services without having to copy and paste from samples on the web. To that end, today we published gonew, an experimental tool for instantiating new projects in Go from predefined templates. Anyone can write templates, which are packaged and distributed as modules, leveraging the Go module proxy and checksum database for better security and availability. gonew The prototype gonew is intentionally minimal: what we have released today is an extremely limited prototype meant to provide a base from which we can gather feedback and community direction. Try it out, tell us what you think, and help us build a more useful tool for everyone. gonew tell us what you think Getting started Start by installing gonew using go install: gonew go install $ go install golang.org/x/tools/cmd/gonew@latest $ go install golang.org/x/tools/cmd/gonew@latest To copy an existing template, run gonew in your new project’s parent directory with two arguments: first, the path to the template you wish to copy, and second, the module name of the project you are creating. For example: gonew $ gonew golang.org/x/example/helloserver example.com/myserver
$ cd ./myserver $ gonew golang.org/x/example/helloserver example.com/myserver
$ cd ./myserver And then you can read and edit the files in ./myserver to customize. ./myserver We’ve written two templates to get you started: hello: A command line tool that prints a greeting, with customization flags.
helloserver: An HTTP server that serves greetings. hello: A command line tool that prints a greeting, with customization flags. hello helloserver: An HTTP server that serves greetings. helloserver Write your own templates Writing your own template is as easy as creating any other module in Go. Check out the examples we linked above to get started. creating any other module There are also examples available from the Google Cloud and Service Weaver teams. Google Cloud Service Weaver Next steps Please try out gonew and let us know how we can make it better and more useful. Remember, gonew is just an experiment for now; we need your feedback to get it right. gonew gonew feedback to get it right Cameron Balahan Cameron Balahan This article is available on The Go Blog under a CC BY 4.0 DEED license. This article is available on The Go Blog under a CC BY 4.0 DEED license. The Go Blog The Go Blog Photo by Clemens van Lay on Unsplash Photo by Clemens van Lay on Unsplash Clemens van Lay Unsplash

Google Cloud

Google

Here's What You Need to Know About Vulnerability Management for Go

Go Project Templates: How to Get Started

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

A Beginner's Guide to Code Coverage for Go Integration Tests

A System to Turn Clients into Leads

15 Best Project Management Tools

7 Best Workflow Automation Software Available Online

104 Stories To Learn About Go

A Beginner's Guide to Code Coverage for Go Integration Tests

A System to Turn Clients into Leads

15 Best Project Management Tools

7 Best Workflow Automation Software Available Online

104 Stories To Learn About Go

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps