rustlings but for golang this time
You may know rustlings, right? If you don't, please go ahead and check out.
rustlings is awesome. It is a CLI app designed to teach the awesome Rust programming language through exercises.
golings has the very same idea, but for the Go programming language
After setting up all the tools required to run golings you have the task to fix tiny go programs.
First, you need to have go installed. You can install it by visiting the Go downloads page
There are several ways to install golings
go install github.com/mauricioabreu/golings/golings@latestAdd go/bin to your PATH if you want to run golings anywhere in your terminal. From the official docs:
The install directory is controlled by the GOPATH and GOBIN environment variables. If GOBIN is set, binaries are installed to that directory. If GOPATH is set, binaries are installed to the bin subdirectory of the first directory in the GOPATH list. Otherwise, binaries are installed to the bin subdirectory of the default GOPATH ($HOME/go or %USERPROFILE%\go).
Some tests depend on CGO which is not installed by default.
- Install scoop package manager Scoop Homepage
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
- Install MINGW using scoop
scoop install mingw
- Close the Powershell session
Go to the releases page and choose the option that best fits your environment.
@Grubba27 worked hard to create a web version: https://golings.vercel.app/
It's pretty awesome and uses the playground so you can play with the exercises without installing anything.
- Install Docker/Podman & VSCode & Configure
- Clone the repository and open it in VSCode.
- You will be prompted to reopen the code in a devcontainer. The container is pre-configured with go and all of the tools needed to debug go code.
- Open a new embeded terminal and run
golings watchto start the exercises.
All the exercises can be found in the directory golings/exercises/<topic>. For every topic there is an additional README file with some resources to get you started on the topic. We really recommend that you have a look at them before you start.
Now you have the task to fix all the programs. Some of them don't compile, and you need to fix them. Some of them compile, but have tests and you need to write some code to have them all green (these are the compile and test modes).
Clone the repository:
git clone git@github.com:mauricioabreu/golings.gitTo run the exercises in the recommended order while taking advantage of fast feedback loop, use the watch command:
golings watchFor Windows:
$env:CGO_ENABLED=1
golings watchThis command will run golings in interactive mode. Every time you save a file it will verify if the code is correct.
To run the next pending exercise:
golings run nextIf you want to run a single exercise:
golings run variables1In case you are stuck and need a hint:
golings hint variables1To list all exercise while checking your progress:
golings listTo compile and run all the exercises:
golings verifyIf you need help with CLI commands:
golings --helpA demo running the command golings run <exercise name>
See CONTRIBUTING.md