tvl-depot/README.md
Vincent Ambo 4681c07bde feat(tools/cheddar): Check in new syntax highlighting tool
The first step with this tool will be to use it as a source-filter for
cgit. The second step is to use it as the Markdown renderer by
depending on one of the Markdown libraries, with integration for
rendering code snippets directly.
2019-12-21 04:54:57 +00:00

3 KiB

depot

This repository is the monorepo for my personal tools and infrastructure. Everything in here is built using Nix with an automatic attribute-set layout that mirrors the filesystem layout of the repository (this might feel familiar to users of Bazel).

This repository used to be hosted on GitHub, but for a variety of reasons I have decided to take over the management of personal infrastructure - of which this repository is a core component.

If you've ended up here and have no idea who I am, feel free to follow me on Twitter.

Highlights

Tools

  • tools/emacs contains my personal Emacs configuration (packages & config)
  • fun/aoc2019 contains solutions for a handful of Advent of Code 2019 challenges, before I ran out of interest
  • tools/blog_cli contains my tool for writing new blog posts and storing them in the DNS zone
  • ops/kms_pass.nix is a tiny tool that emulates the user-interface of pass, but actually uses Google Cloud KMS for secret decryption
  • ops/kontemplate contains my Kubernetes resource templating tool (with which the services in this repository are deployed!)

Packages / Libraries

  • nix/buildGo implements a Nix library that can build Go software in the style of Bazel's rules_go. Go programs in this repository are built using this library.
  • tools/emacs-pkgs contains various Emacs libraries that my Emacs setup uses, for example:
    • dottime.el provides dottime in the Emacs modeline
    • nix-util.el provides editing utilities for Nix files
    • term-switcher.el is an ivy-function for switching between vterm buffers
  • net/alcoholic_jwt contains an easy-to-use JWT-validation library for Rust
  • net/crimp contains a high-level HTTP client using cURL for Rust

Services

Services in this repository are deployed on a Google Kubernetes Engine cluster using Nixery.

  • web/tazblog contains my blog software (serving at tazj.in)
  • web/cgit-taz contains a slightly patched version of cgit that serves my git web interface at git.tazj.in
  • ops/sync-gcsr contains a tiny service that synchronises a Google Cloud Source Repository with a local disk path. My cgit setup uses this under-the-hood.
  • ops/journaldriver contains a small Rust daemon that can forward logs from journald to Stackdriver Logging

Miscellaneous

Presentations I've given in the past are in the presentations folder, these cover a variety of topics and some of them have links to recordings.

There's a few fun things in the fun/ folder, often with context given in the README. Check out my list of the best tools for example.

Contributing

If you'd like to contribute to any of the tools in here, please check out the contribution guidelines.