go-xkcdreader/README.md
surtur c335867935
readme: add {godocsreference,goreportcard} badges
also bump version: v0.0.0 -> v0.0.12

[skip ci]
2022-05-13 23:06:21 +02:00

2.3 KiB

go-xkcdreader

an offline-capable xkcd webcomic reader written in Go

built with nix Cachix pre-commit Build Status Go Report Card Go Documentation

disclaimer

WIP 🚧

ad nix flake ❄

this project is provided as a nix flake for both convenience and reproducibility.
and also because I wanted to play with nix and its flakes just a wee bit.

note on the nix-related steps: make sure you have nix installed and optionally the flake functionality enabled, the Go toolchain and a minimal set of Go development goodies will get pulled in automatically. you might want to speed up the builds by making use of project's build cache: cachix use go-xkcdreader.

that means you can get started:

developing using nix (flakes enabled)

run nix develop in the project folder first, then go {run,build,fmt,...} about your day.

developing using nix (without flakes)

for compatibility with non-flake-enabled systems, this project uses github:edolstra/flake-compat.

run nix-shell in the project folder first, then go {run,build,fmt,...} about your day.

developing without nix

note: you only need to have the Go toolchain and Fyne dependencies installed for this.

if you don't want to use the flake provided or don't have nix installed, you can use the standard go tool: run go {run,build,fmt,...} in the project folder.

COPYING

Licensed under GPL-3.0-or-later (see LICENSE for details).