Skip to content

A command-line tool for executing mail-merges between structured YAML and templates to create/update/maintain a structured documentation library.

License

Notifications You must be signed in to change notification settings

davidalpert/go-yeet

Repository files navigation

License: GPL v3


go-yeet

A command-line tool for yeeting content-as-code into document stores like Confluence.
README · CHANGELOG . CONTRIBUTING
Report Bug · Request Feature

Table of contents

About the project

Managing configuration as code has significant benefits.

What if you could manage knowledge base content as code?

yeet offers a way to do just that:

  • store content data as structured YAML documents
  • store content structure as templates
  • perform mail-merge style updates into your knowledge base

Built with

Getting started

Install

go install

With a working golang installation at version >= 1.16 you can install or update with:

go install github.com/davidalpert/go-yeet/cmd/yeet@latest

Pre-compiled binaries

Visit the Releases page to find binary packages pre-compiled for a variety of GOOS and GOARCH combinations:

  1. Download an appropriate package for your GOOS and GOARCH;
  2. Unzip it and put the binary in your path;

Verify your installation

  1. Check the version installed:
    yeet version
    

Uninstall

  • go-yeet ships with an uninstall sub-command which cleans up and removes itself:

    yeet uninstall
    

Usage

  • TODO; coming as the project nears v1.0

Troubleshooting

If you run into trouble you can ask yeet to write some diagnostics to a log file by setting the following environment variables:

Variable Default Description
YEET_LOG_LEVEL "fatal" "fatal", "error", "warning", "warn", "info", "debug"
YEET_LOG_FORMAT "text" "text" or "json"
YEET_LOG_FILE "" path to a log file; when empty logs go to STDOUT

Roadmap

See open issues project board for a list of known issues and up-for-grabs tasks.

Contributing

See the CONTRIBUTING guide for local development setup and contribution guidelines.

License

Distributed under the GPU v3 License. See LICENSE for more information.

Contact

David Alpert - @davidalpert

Project Link: https://github.com/davidalpert/go-yeet

About

A command-line tool for executing mail-merges between structured YAML and templates to create/update/maintain a structured documentation library.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published