forked from cadey/xesite
Compare commits
2 Commits
main
...
miau-onesh
| Author | SHA1 | Date |
|---|---|---|
 Cadey Ratio
|
44f3b65c7b | |
|
Cadey Ratio
|
e97151b665 |
|
|
@ -1 +1,2 @@
|
|||
nix/deps.nix linguist-vendored
|
||||
nix/sources.nix linguist-vendored
|
||||
|
|
|
|||
|
|
@ -1,53 +0,0 @@
|
|||
version: 2
|
||||
updates:
|
||||
- package-ecosystem: cargo
|
||||
directory: "/"
|
||||
schedule:
|
||||
interval: daily
|
||||
time: "10:00"
|
||||
open-pull-requests-limit: 10
|
||||
ignore:
|
||||
- dependency-name: tokio
|
||||
versions:
|
||||
- ">= 0.3.a, < 0.4"
|
||||
- dependency-name: hyper
|
||||
versions:
|
||||
- 0.14.4
|
||||
- 0.14.6
|
||||
- dependency-name: serde_json
|
||||
versions:
|
||||
- 1.0.62
|
||||
- 1.0.63
|
||||
- 1.0.64
|
||||
- dependency-name: tracing
|
||||
versions:
|
||||
- 0.1.24
|
||||
- 0.1.25
|
||||
- dependency-name: futures
|
||||
versions:
|
||||
- 0.3.12
|
||||
- 0.3.13
|
||||
- dependency-name: url
|
||||
versions:
|
||||
- 2.2.1
|
||||
- dependency-name: thiserror
|
||||
versions:
|
||||
- 1.0.24
|
||||
- dependency-name: tracing-futures
|
||||
versions:
|
||||
- 0.2.5
|
||||
- dependency-name: serde
|
||||
versions:
|
||||
- 1.0.123
|
||||
- dependency-name: rand
|
||||
versions:
|
||||
- 0.8.3
|
||||
- dependency-name: log
|
||||
versions:
|
||||
- 0.4.14
|
||||
- dependency-name: serde_yaml
|
||||
versions:
|
||||
- 0.8.16
|
||||
- dependency-name: tokio
|
||||
versions:
|
||||
- 1.1.1
|
||||
|
|
@ -0,0 +1,19 @@
|
|||
name: Go
|
||||
on: [push]
|
||||
jobs:
|
||||
build:
|
||||
name: Build
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Set up Go 1.14
|
||||
uses: actions/setup-go@v1
|
||||
with:
|
||||
go-version: 1.14
|
||||
id: go
|
||||
- name: Check out code into the Go module directory
|
||||
uses: actions/checkout@v1
|
||||
- name: Test
|
||||
run: go test -v ./...
|
||||
env:
|
||||
GO111MODULE: on
|
||||
GOPROXY: https://cache.greedo.xeserv.us
|
||||
|
|
@ -0,0 +1,80 @@
|
|||
name: "CI/CD"
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- master
|
||||
jobs:
|
||||
deploy:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v1
|
||||
- name: Build container image
|
||||
run: |
|
||||
docker build -t xena/christinewebsite:$(echo $GITHUB_SHA | head -c7) .
|
||||
echo $DOCKER_PASSWORD | docker login -u $DOCKER_USERNAME --password-stdin
|
||||
docker push xena/christinewebsite
|
||||
env:
|
||||
DOCKER_USERNAME: "xena"
|
||||
DOCKER_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}
|
||||
- name: Download secrets/Install/Configure/Use Dyson
|
||||
run: |
|
||||
mkdir ~/.ssh
|
||||
echo $FILE_DATA | base64 -d > ~/.ssh/id_rsa
|
||||
md5sum ~/.ssh/id_rsa
|
||||
chmod 600 ~/.ssh/id_rsa
|
||||
git clone git@ssh.tulpa.dev:cadey/within-terraform-secret
|
||||
curl https://xena.greedo.xeserv.us/files/dyson-linux-amd64-0.1.0.tgz | tar xz
|
||||
cp ./dyson-linux-amd64-0.1.1/dyson .
|
||||
rm -rf dyson-linux-amd64-0.1.1
|
||||
mkdir -p ~/.config/dyson
|
||||
|
||||
echo '[DigitalOcean]
|
||||
Token = ""
|
||||
|
||||
[Cloudflare]
|
||||
Email = ""
|
||||
Token = ""
|
||||
|
||||
[Secrets]
|
||||
GitCheckout = "./within-terraform-secret"' > ~/.config/dyson/dyson.ini
|
||||
|
||||
./dyson manifest \
|
||||
--name=christinewebsite \
|
||||
--domain=christine.website \
|
||||
--dockerImage=xena/christinewebsite:$(echo $GITHUB_SHA | head -c7) \
|
||||
--containerPort=5000 \
|
||||
--replicas=2 \
|
||||
--useProdLE=true > $GITHUB_WORKSPACE/deploy.yml
|
||||
env:
|
||||
FILE_DATA: ${{ secrets.SSH_PRIVATE_KEY }}
|
||||
GIT_SSH_COMMAND: "ssh -i ~/.ssh/id_rsa -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no"
|
||||
- name: Save DigitalOcean kubeconfig
|
||||
uses: digitalocean/action-doctl@master
|
||||
env:
|
||||
DIGITALOCEAN_ACCESS_TOKEN: ${{ secrets.DIGITALOCEAN_TOKEN }}
|
||||
with:
|
||||
args: kubernetes cluster kubeconfig show kubermemes > $GITHUB_WORKSPACE/.kubeconfig
|
||||
- name: Deploy to DigitalOcean Kubernetes
|
||||
uses: docker://lachlanevenson/k8s-kubectl
|
||||
with:
|
||||
args: --kubeconfig=/github/workspace/.kubeconfig apply -n apps -f /github/workspace/deploy.yml
|
||||
- name: Verify deployment
|
||||
uses: docker://lachlanevenson/k8s-kubectl
|
||||
with:
|
||||
args: --kubeconfig=/github/workspace/.kubeconfig rollout status -n apps deployment/christinewebsite
|
||||
- name: Ping Google
|
||||
uses: docker://lachlanevenson/k8s-kubectl
|
||||
with:
|
||||
args: --kubeconfig=/github/workspace/.kubeconfig apply -f /github/workspace/k8s/job.yml
|
||||
- name: Sleep
|
||||
run: |
|
||||
sleep 5
|
||||
- name: Don't Ping Google
|
||||
uses: docker://lachlanevenson/k8s-kubectl
|
||||
with:
|
||||
args: --kubeconfig=/github/workspace/.kubeconfig delete -f /github/workspace/k8s/job.yml
|
||||
- name: POSSE
|
||||
env:
|
||||
MI_TOKEN: ${{ secrets.MI_TOKEN }}
|
||||
run: |
|
||||
curl -H "Authorization: $MI_TOKEN" --data "https://christine.website/blog.json" https://mi.within.website/blog/refresh
|
||||
|
|
@ -1,18 +1,19 @@
|
|||
name: "Nix"
|
||||
on:
|
||||
push:
|
||||
branches:
|
||||
- main
|
||||
pull_request:
|
||||
branches:
|
||||
- main
|
||||
jobs:
|
||||
docker-build:
|
||||
tests:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v1
|
||||
- uses: cachix/install-nix-action@v12
|
||||
- uses: cachix/cachix-action@v7
|
||||
with:
|
||||
name: xe
|
||||
- run: nix-build --no-out-link
|
||||
- uses: actions/checkout@v1
|
||||
- uses: cachix/install-nix-action@v6
|
||||
- uses: cachix/cachix-action@v3
|
||||
with:
|
||||
name: xe
|
||||
- run: |
|
||||
nix-build docker.nix
|
||||
docker load -i result
|
||||
docker tag xena/christinewebsite:latest xena/christinewebsite:$(echo $GITHUB_SHA | head -c7)
|
||||
- run: |
|
||||
nix-env -if ./nix/dhall-yaml.nix
|
||||
dhall-to-yaml-ng --omit-empty --file site.dhall
|
||||
|
|
|
|||
|
|
@ -5,6 +5,4 @@ cw.tar
|
|||
/result-*
|
||||
/result
|
||||
.#*
|
||||
/target
|
||||
.patreon.json
|
||||
.direnv
|
||||
|
||||
|
|
|
|||
|
|
@ -1,8 +0,0 @@
|
|||
{
|
||||
"editor.wordWrap": "wordWrapColumn",
|
||||
"[markdown]": {
|
||||
"editor.wordWrap": "wordWrapColumn",
|
||||
"editor.wordWrapColumn": 80,
|
||||
"editor.wordBasedSuggestions": false
|
||||
},
|
||||
}
|
||||
|
|
@ -1,36 +0,0 @@
|
|||
{
|
||||
// See https://go.microsoft.com/fwlink/?LinkId=733558
|
||||
// for the documentation about the tasks.json format
|
||||
"version": "2.0.0",
|
||||
"options": {
|
||||
"env": {
|
||||
"out": "/fake"
|
||||
}
|
||||
},
|
||||
"tasks": [
|
||||
{
|
||||
"label": "run",
|
||||
"type": "shell",
|
||||
"command": "cargo run",
|
||||
"problemMatcher": [
|
||||
"$rustc"
|
||||
]
|
||||
},
|
||||
{
|
||||
"label": "auto rerun",
|
||||
"type": "shell",
|
||||
"command": "cargo watch -x run",
|
||||
"problemMatcher": [
|
||||
"$rustc"
|
||||
]
|
||||
},
|
||||
{
|
||||
"label": "test",
|
||||
"type": "shell",
|
||||
"command": "cargo test",
|
||||
"problemMatcher": [
|
||||
"$rustc"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
15
CHANGELOG.md
15
CHANGELOG.md
|
|
@ -1,15 +0,0 @@
|
|||
# Changelog
|
||||
|
||||
New site features will be documented here.
|
||||
|
||||
## 2.1.0
|
||||
|
||||
- Blogpost bodies are now present in the RSS feed
|
||||
|
||||
## 2.0.1
|
||||
|
||||
Custom render RSS/Atom feeds
|
||||
|
||||
## 2.0.0
|
||||
|
||||
Complete site rewrite in Rust
|
||||
File diff suppressed because it is too large
Load Diff
77
Cargo.toml
77
Cargo.toml
|
|
@ -1,77 +0,0 @@
|
|||
[package]
|
||||
name = "xesite"
|
||||
version = "2.4.0"
|
||||
authors = ["Xe Iaso <me@christine.website>"]
|
||||
edition = "2018"
|
||||
build = "src/build.rs"
|
||||
repository = "https://github.com/Xe/site"
|
||||
|
||||
# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
|
||||
|
||||
[dependencies]
|
||||
axum = "0.5"
|
||||
axum-macros = "0.2"
|
||||
axum-extra = "0.2"
|
||||
color-eyre = "0.6"
|
||||
chrono = "0.4"
|
||||
comrak = "0.12.1"
|
||||
derive_more = "0.99"
|
||||
envy = "0.4"
|
||||
estimated_read_time = "1"
|
||||
futures = "0.3"
|
||||
glob = "0.3"
|
||||
http = "0.2"
|
||||
http-body = "0.4"
|
||||
hyper = "0.14"
|
||||
kankyo = "0.3"
|
||||
lazy_static = "1.4"
|
||||
log = "0.4"
|
||||
mime = "0.3.0"
|
||||
prometheus = { version = "0.13", default-features = false, features = ["process"] }
|
||||
rand = "0"
|
||||
reqwest = { version = "0.11", features = ["json"] }
|
||||
serde_dhall = "0.11.0"
|
||||
serde = { version = "1", features = ["derive"] }
|
||||
serde_yaml = "0.8"
|
||||
sitemap = "0.4"
|
||||
thiserror = "1"
|
||||
tokio = { version = "1", features = ["full"] }
|
||||
tokio-stream = { version = "0.1", features = ["net"] }
|
||||
tracing = "0.1"
|
||||
tracing-futures = "0.2"
|
||||
tracing-subscriber = { version = "0.3", features = ["fmt"] }
|
||||
xml-rs = "0.8"
|
||||
url = "2"
|
||||
uuid = { version = "0.8", features = ["serde", "v4"] }
|
||||
|
||||
# workspace dependencies
|
||||
cfcache = { path = "./lib/cfcache" }
|
||||
jsonfeed = { path = "./lib/jsonfeed" }
|
||||
mi = { path = "./lib/mi" }
|
||||
patreon = { path = "./lib/patreon" }
|
||||
|
||||
[dependencies.tower]
|
||||
version = "0.4"
|
||||
features = [ "full" ]
|
||||
|
||||
[dependencies.tower-http]
|
||||
version = "0.2"
|
||||
features = [ "full" ]
|
||||
|
||||
# os-specific dependencies
|
||||
[target.'cfg(target_os = "linux")'.dependencies]
|
||||
sdnotify = { version = "0.2", default-features = false }
|
||||
|
||||
[build-dependencies]
|
||||
ructe = { version = "0.14", features = [ "mime03" ] }
|
||||
|
||||
[dev-dependencies]
|
||||
pfacts = "0"
|
||||
serde_json = "1"
|
||||
eyre = "0.6"
|
||||
pretty_env_logger = "0"
|
||||
|
||||
[workspace]
|
||||
members = [
|
||||
"./lib/*",
|
||||
]
|
||||
|
|
@ -0,0 +1,20 @@
|
|||
FROM xena/go:1.14 AS build
|
||||
ENV GOPROXY https://cache.greedo.xeserv.us
|
||||
COPY . /site
|
||||
WORKDIR /site
|
||||
RUN CGO_ENABLED=0 go test -v ./...
|
||||
RUN CGO_ENABLED=0 GOBIN=/root go install -v ./cmd/site
|
||||
|
||||
FROM xena/alpine
|
||||
EXPOSE 5000
|
||||
WORKDIR /site
|
||||
COPY --from=build /root/site .
|
||||
COPY ./static /site/static
|
||||
COPY ./templates /site/templates
|
||||
COPY ./blog /site/blog
|
||||
COPY ./talks /site/talks
|
||||
COPY ./gallery /site/gallery
|
||||
COPY ./css /site/css
|
||||
COPY ./signalboost.dhall /site/signalboost.dhall
|
||||
HEALTHCHECK CMD wget --spider http://127.0.0.1:5000/.within/health || exit 1
|
||||
CMD ./site
|
||||
4
LICENSE
4
LICENSE
|
|
@ -1,4 +1,4 @@
|
|||
Copyright (c) 2017-2021 Christine Dodrill <me@christine.website>
|
||||
Copyright (c) 2017 Christine Dodrill <me@christine.website>
|
||||
|
||||
This software is provided 'as-is', without any express or implied
|
||||
warranty. In no event will the authors be held liable for any damages
|
||||
|
|
@ -16,4 +16,4 @@ freely, subject to the following restrictions:
|
|||
2. Altered source versions must be plainly marked as such, and must not be
|
||||
misrepresented as being the original software.
|
||||
|
||||
3. This notice may not be removed or altered from any source distribution.
|
||||
3. This notice may not be removed or altered from any source distribution.
|
||||
30
README.md
30
README.md
|
|
@ -1,33 +1,5 @@
|
|||
# site
|
||||
|
||||
[](https://builtwithnix.org)
|
||||
|
||||
|
||||
|
||||
My personal/portfolio website.
|
||||
|
||||
## <big>Information for people wishing to use this code</big>
|
||||
|
||||
Don't. This code is not made for you to be able to use without extensive
|
||||
modification. The [license](https://github.com/Xe/site/blob/main/LICENSE) of
|
||||
this code is intentionally chosen in such a way that it will make reuse of this
|
||||
website code verbatim very difficult.
|
||||
|
||||
If you are still adamant about using this backend, please keep several things in
|
||||
mind:
|
||||
|
||||
1. All blog content is all rights reserved. I aggressively pursue and report
|
||||
content theft.
|
||||
2. You _must_ fully comply with the license. I will aggressively pursue people
|
||||
that are not in compliance with the license.
|
||||
3. You are on your own. I will not help you. This is code I made for myself and
|
||||
it's only really open source as a side effect of making deployment on NixOS
|
||||
easier. Please do not be the person that makes me have to take this repo
|
||||
closed source.
|
||||
4. Upon security issues being found and remediated, you will not be notified
|
||||
about issues or remediation instructions.
|
||||
|
||||
This is probably not what you are looking for. Make your own website. Look into
|
||||
[Hugo](http://gohugo.io/) or [Zola](https://www.getzola.org/). They are going to
|
||||
be better maintained than this site will be.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,93 +0,0 @@
|
|||
---
|
||||
title: Compiling Code to Matter in My Living Room
|
||||
date: 2022-03-28
|
||||
tags:
|
||||
- openscad
|
||||
- 3dprinting
|
||||
---
|
||||
|
||||
In a moment of weakness, my husband and I got a 3d printer. It's mostly been sitting around and not doing much since we got it, but recently I found a great use for it: I wanted a controller stand for my Valve Index controllers and VR full body trackers.
|
||||
|
||||
After doing some digging on Thingiverse, I found [this stand](https://www.thingiverse.com/thing:4587097) that looked like it had promise. So I downloaded the model, sliced it and then sent it over to Kyubey:
|
||||
|
||||
<blockquote class="twitter-tweet"><p lang="tl" dir="ltr">Kyuubey is happy <a href="https://t.co/atTLN8MSgc">pic.twitter.com/atTLN8MSgc</a></p>— Xe Iaso (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1507485129907871747?ref_src=twsrc%5Etfw">March 25, 2022</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
[Kyubey's name is a reference to <a href="https://madoka.fandom.com/wiki/Kyubey">Kyubey</a> from Puella Magi Madoka Magika</a>.](conversation://Mara/hacker)
|
||||
|
||||
Once it was done I ended up with a stand that I could feed [these cables I got from Amazon](https://www.amazon.ca/gp/product/B09LSF8XL9/) through. The tracker holes worked great, but the controller holes were just barely too small.
|
||||
|
||||
This was kinda frustrating and I almost gave up on the project, but then I remembered that [OpenSCAD](https://openscad.org) existed. OpenSCAD is a weird programming environment / 3D modeling hybrid program that I've seen used on Thingiverse. It works by letting you position platonic solids into a 3d environment, and from there you can create anything you want.
|
||||
|
||||
One of the primitives that OpenSCAD offers is a cylinder. So I wondered if I could use one of those to widen the hole in the index stand and then reprint the part with the wider hole.
|
||||
|
||||
[Wait, you're using a CAD program to fix your 3D print by modifying the model instead of using, I don't know, a drill and 5 minutes to make it fit that way?](conversation://Numa/dismay)
|
||||
|
||||
[There's no doing like overdoing!](conversation://Cadey/enby)
|
||||
|
||||
After some finangling, I managed to get the cylinders in the right place with this OpenSCAD code:
|
||||
|
||||
```scad
|
||||
//difference() {
|
||||
color("magenta") translate([0, 0, 0]) import("./assets/ValveTrackerDeckEditedByInugoro.stl");
|
||||
// bores for controller holders
|
||||
color([0, 1, 0]) translate([63, 44, 0]) cylinder(h = 55, r = 4.75);
|
||||
color([0, 1, 0]) translate([-63, 44, 0]) cylinder(h = 55, r = 4.75);
|
||||
//}
|
||||
```
|
||||
|
||||
<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Some finagling required <a href="https://t.co/7T0R6x1XoP">pic.twitter.com/7T0R6x1XoP</a></p>— Xe Iaso (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1508566854926745614?ref_src=twsrc%5Etfw">March 28, 2022</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
And when I uncommented out the `difference()` block, it ends up looking good enough:
|
||||
|
||||
<blockquote class="twitter-tweet" data-conversation="none" data-dnt="true"><p lang="und" dir="ltr"><a href="https://t.co/fiShvlN8QH">pic.twitter.com/fiShvlN8QH</a></p>— Xe Iaso (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1508567556759728141?ref_src=twsrc%5Etfw">March 28, 2022</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
So then I took a good solid look at the rest of the 3D printed part to see if I could improve on anything else before I sent it to another round of the printer. The last stand took _14 hours_ to print and used a lot of material. I want to avoid waste.
|
||||
|
||||
Something I noticed is that the front of the print where all the cables come out was a bit too thin. All 5 of the cables wouldn't fit in there (my braided cables must have been thicker than the ones that the original modeler used). So again I grabbed a few platonic solids and managed to make it work out:
|
||||
|
||||
```scad
|
||||
// widen the paths
|
||||
color("green") translate([0, -16, 1.3]) rotate([0, 0, 90]) cube([10, 57, 7.8], center = true);
|
||||
color("green") translate([0, 0, 1.7]) rotate([0, 0, 0]) cube([25, 30, 7], center = true);
|
||||
```
|
||||
|
||||
<blockquote class="twitter-tweet" data-conversation="none" data-dnt="true"><p lang="und" dir="ltr"><a href="https://t.co/pKAVtiPfDS">pic.twitter.com/pKAVtiPfDS</a></p>— Xe Iaso (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1508568858650685440?ref_src=twsrc%5Etfw">March 28, 2022</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
Then I wanted to add some wedges into the underside of the part to help me get the print off the bed. Most people have a problem with bed adhesion being too little. I have too much bed adhesion. So I added some angled rectangles:
|
||||
|
||||
```scad
|
||||
// wedges to help get the print off the bed
|
||||
color([1, 1, 0]) translate([-120, 0, 0]) rotate([15, 0, 90]) cube([10, 11, 2], center = true); // right
|
||||
color([1, 1, 0]) translate([120, 0, 0]) rotate([-15, 0, 90]) cube([10, 11, 2], center = true); // left
|
||||
color([1, 1, 0]) translate([0, -85, 0]) rotate([0, 15, 90]) cube([10, 11, 2], center = true); // back
|
||||
color([1, 1, 0]) translate([60, 56, 1]) rotate([0, -15, 90]) cube([10, 11, 2], center = true); // front left
|
||||
color([1, 1, 0]) translate([-60, 56, 1]) rotate([0, -15, 90]) cube([10, 11, 2], center = true); // front right
|
||||
color([1, 1, 0]) translate([32.5, 41, 1]) rotate([0, -15, 130]) cube([10, 11, 2], center = true); // front left inner
|
||||
color([1, 1, 0]) translate([-32.5, 41, 1]) rotate([0, -15, 60]) cube([10, 11, 2], center = true); // front right inner
|
||||
```
|
||||
|
||||
<blockquote class="twitter-tweet" data-conversation="none" data-dnt="true"><p lang="und" dir="ltr"><a href="https://t.co/XUQ9ZeYk1H">pic.twitter.com/XUQ9ZeYk1H</a></p>— Xe Iaso (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1508569796253827077?ref_src=twsrc%5Etfw">March 28, 2022</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
And then once I spun it around for a bit and thought it was good, I sliced it in PrusaSlicer and sent it off to Kyubey. It was going to take 14 hours, so I went off to do other things, ate dinner and then went to bed while the printer continued.
|
||||
|
||||
<blockquote class="twitter-tweet" data-conversation="none" data-dnt="true"><p lang="fr" dir="ltr">Diligent bean <a href="https://t.co/yPgnJA0ZdW">pic.twitter.com/yPgnJA0ZdW</a></p>— Xe Iaso (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1508397506031460352?ref_src=twsrc%5Etfw">March 28, 2022</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
Then when I woke up, Kyubey was done:
|
||||
|
||||
<blockquote class="twitter-tweet" data-conversation="none" data-dnt="true"><p lang="und" dir="ltr"><a href="https://t.co/2E1IS810EH">pic.twitter.com/2E1IS810EH</a></p>— Xe Iaso (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1508407046995156992?ref_src=twsrc%5Etfw">March 28, 2022</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
I was excited and chiseled the print off the bed (the wedges helped a little, but it ended up making the print look kinda weird so I don't know if I will do that again), but the hole for the middle tracker didn't fit perfectly. Everything else did though.
|
||||
|
||||
[If you want to get prints off your printer easier, see this video for the method we're starting to use: <br /><br /><iframe width="560" height="315" src="https://www.youtube.com/embed/VCCbzCvtRzU" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>](conversation://Mara/hacker)
|
||||
|
||||
I looked on my desk and found that a random pen that I had sitting around for months was about the right size, so I pushed it into and out of the hole a few times and then the cables fit perfectly. I assume some plastic was in a weird state or something.
|
||||
|
||||
Then I set everything up and I had my Index controller stand:
|
||||
|
||||
<blockquote class="twitter-tweet" data-conversation="none" data-dnt="true"><p lang="en" dir="ltr">Victory! <a href="https://t.co/A3aCtQMQt5">pic.twitter.com/A3aCtQMQt5</a></p>— Xe Iaso (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1508426229464064001?ref_src=twsrc%5Etfw">March 28, 2022</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
[I really need to get a table or something for this.](conversation://Cadey/facepalm)
|
||||
|
||||
I've uploaded my modified version to [Thingiverse](https://www.thingiverse.com/thing:5332988). If you want to see the OpenSCAD code, you can check it out on GitHub [here](https://github.com/Xe/3dstuff/blob/main/index_stand_hack.scad). I'm really liking OpenSCAD so far. It's very weird but it lets you do whatever you want by chaining together basic shapes to build up to what you want. I imagine I will be using it a lot in the future, especially once my husband's new sim racing gear comes in.
|
||||
|
||||
Having a 3D printer around is like having a very weird superpower on standby. You can compile matter in your living room, but you need a very pedantic description of what that should look like. You also can have any material you like as long as it's plastic. However when it's useful, it's a lifesaver. You can make something to fit a gap or mend something broken or even add functionality to something that lacked it. The cloud's the limit!
|
||||
|
|
@ -1,175 +0,0 @@
|
|||
---
|
||||
title: The 7th Edition
|
||||
date: 2020-12-19
|
||||
tags:
|
||||
- ttrpg
|
||||
---
|
||||
|
||||
You know what, fuck rules. Fuck systems. Fuck limitations. Let's dial the
|
||||
tabletop RPG system down to its roots. Let's throw out every stat but one:
|
||||
Awesomeness. When you try to do something that could fail, roll for Awesomeness.
|
||||
If your roll is more than your awesomeness stat, you win. If not, you lose. If
|
||||
you are or have something that would benefit you in that situation, roll for
|
||||
awesomeness twice and take the higher value.
|
||||
|
||||
No stats.<br />
|
||||
No counts.<br />
|
||||
No limits.<br />
|
||||
No gods.<br />
|
||||
No masters.<br />
|
||||
Just you and me and nature in the battlefield.
|
||||
|
||||
* Want to shoot an arrow? Roll for awesomeness. You failed? You're out of ammo.
|
||||
* Want to, defeat a goblin but you have a goblin-slaying-broadsword? Roll twice
|
||||
for awesomeness and take the higher value. You got a 20? That goblin was
|
||||
obliterated. Good job.
|
||||
* Want to pick up an item into your inventory? Roll for awesomeness. You got it?
|
||||
It's in your inventory.
|
||||
|
||||
Etc. Don't think too hard. Let a roll of the dice decide if you are unsure.
|
||||
|
||||
## Base Awesomeness Stats
|
||||
|
||||
Here are some probably balanced awesomeness base stats depending on what kind of
|
||||
dice you are using:
|
||||
|
||||
* 6-sided: 4 or 5
|
||||
* 8-sided: 5 or 6
|
||||
* 10-sided: 6 or 7
|
||||
* 12-sided: 7 or 8
|
||||
* 20-sided: anywhere from 11-13
|
||||
|
||||
## Character Sheet Template
|
||||
|
||||
Here's an example character sheet:
|
||||
|
||||
```
|
||||
Name:
|
||||
Awesomeness:
|
||||
Race:
|
||||
Class:
|
||||
Inventory:
|
||||
*
|
||||
```
|
||||
|
||||
That's it. You don't even need the race or class if you don't want to have it.
|
||||
|
||||
You can add more if you feel it is relevant for your character. If your
|
||||
character is a street brat that has experience with haggling, then fuck it be
|
||||
the most street brattiest haggler you can. Try to not overload your sheet with
|
||||
information, this game is supposed to be simple. A sentence or two at most is
|
||||
good.
|
||||
|
||||
## One Player is The World
|
||||
|
||||
The World is a character that other systems would call the Narrator, the
|
||||
Pathfinder, Dungeon Master or similar. Let's strip this down to the core of the
|
||||
matter. One player doesn't just dictate the world, they _are_ the world.
|
||||
|
||||
The World also controls the monsters and non-player characters. In general, if
|
||||
you are in doubt as to who should roll for an event, The World does that roll.
|
||||
|
||||
## Mixins/Mods
|
||||
|
||||
These are things you can do to make the base game even more tailored to your
|
||||
group. Whether you should do this is highly variable to the needs and whims of
|
||||
your group in particular.
|
||||
|
||||
### Mixin: Adjustable Awesomeness
|
||||
|
||||
So, one problem that could come up with this is that bad luck could make this
|
||||
not as fun. As a result, add these two rules in:
|
||||
|
||||
* Every time you roll above your awesomeness, add 1 to your awesomeness stat
|
||||
* Every time you roll below your awesomeness, remove 1 from your awesomeness
|
||||
stat
|
||||
|
||||
This should add up so that luck would even out over time. Players that have less
|
||||
luck than usual will eventually get their awesomeness evened out so that luck
|
||||
will be in their favor.
|
||||
|
||||
### Mixin: No Awesomeness
|
||||
|
||||
In this mod, rip out Awesomeness altogether. When two parties are at odds, they
|
||||
both roll dice. The one that rolls higher gets what they want. If they tie, both
|
||||
people get a little part of what they want. For extra fun do this with six-sided
|
||||
dice.
|
||||
|
||||
* Monster wants to attack a player? The World and that player roll. If the
|
||||
player wins, they can choose to counterattack. If the monster wins, they do a
|
||||
wound or something.
|
||||
* One player wants to steal from another? Have them both roll to see what
|
||||
happens.
|
||||
|
||||
Use your imagination! Ask others if you are unsure!
|
||||
|
||||
## Other Advice
|
||||
|
||||
This is not essential but it may help.
|
||||
|
||||
### Monster Building
|
||||
|
||||
Okay so basically monsters fall into two categories: peons and bosses. Peons
|
||||
should be easy to defeat, usually requiring one action. Bosses may require more
|
||||
and might require more than pure damage to defeat. Get clever. Maybe require the
|
||||
players to drop a chandelier on the boss. Use the environment.
|
||||
|
||||
In general, peons should have a very high base awesomeness in order to do things
|
||||
they want. Bosses can vary based on your mood.
|
||||
|
||||
Adjustable awesomeness should affect monsters too.
|
||||
|
||||
### Worldbuilding
|
||||
|
||||
Take a setting from somewhere and roll with it. You want to do a cyberpunk jaunt
|
||||
in Night City with a sword-wielding warlock, a succubus space marine, a bard
|
||||
netrunner and a shapeshifting monk? Do the hell out of that. That sounds
|
||||
awesome.
|
||||
|
||||
Don't worry about accuracy or the like. You are setting out to have fun.
|
||||
|
||||
## Special Thanks
|
||||
|
||||
Special thanks goes to Jared, who sent out this [tweet][1] that inspired this
|
||||
document. In case the tweet gets deleted, here's what it said:
|
||||
|
||||
[1]: https://twitter.com/infinite_mao/status/1340402360259137541
|
||||
|
||||
> heres a d&d for you
|
||||
|
||||
> you have one stat, its a saving throw. if you need to roll dice, you roll your
|
||||
> save.
|
||||
|
||||
> you have a class and some equipment and junk. if the thing you need to roll
|
||||
> dice for is relevant to your class or equipment or whatever, roll your save
|
||||
> with advantage.
|
||||
|
||||
> oh your Save is 5 or something. if you do something awesome, raise your save
|
||||
> by 1.
|
||||
|
||||
> no hp, save vs death. no damage, save vs goblin. no tracking arrows, save vs
|
||||
> running out of ammo.
|
||||
|
||||
> thanks to @Axes_N_Orcs for this
|
||||
|
||||
> What's So Cool About Save vs Death?
|
||||
|
||||
> can you carry all that treasure and equipment? save vs gains
|
||||
|
||||
I replied:
|
||||
|
||||
> Can you get more minimal than this?
|
||||
|
||||
He replied:
|
||||
|
||||
> when two or more parties are at odds, all roll dice. highest result gets what
|
||||
> they want.
|
||||
|
||||
> hows that?
|
||||
|
||||
This document is really just this twitter exchange in more words so that people
|
||||
less familiar with tabletop games can understand it more easily. You know you
|
||||
have finished when there is nothing left to remove, not when you can add
|
||||
something to "fix" it.
|
||||
|
||||
I might put this on my [itch.io page](https://withinstudios.itch.io/).
|
||||
|
|
@ -7,6 +7,8 @@ tags:
|
|||
- release
|
||||
---
|
||||
|
||||
# OVE-20190623-0001
|
||||
|
||||
## Within Security Advisory
|
||||
|
||||
Root-level Remote Command Injection in the [V](https://vlang.io) playground (OVE-20190623-0001)
|
||||
|
|
@ -9,6 +9,8 @@ tags:
|
|||
- oh-dear-god
|
||||
---
|
||||
|
||||
# OVE-20191021-0001
|
||||
|
||||
## Within Security Advisory
|
||||
|
||||
Multiple vulnerabilities in the mysqljs API and code.
|
||||
|
|
@ -1,638 +0,0 @@
|
|||
---
|
||||
title: "TL;DR Rust"
|
||||
date: 2020-09-19
|
||||
series: rust
|
||||
tags:
|
||||
- go
|
||||
- golang
|
||||
---
|
||||
|
||||
Recently I've been starting to use Rust more and more for larger and larger
|
||||
projects. As things have come up, I realized that I am missing a good reference
|
||||
for common things in Rust as compared to Go. This post contains a quick
|
||||
high-level overview of patterns in Rust and how they compare to patterns
|
||||
in Go. This will focus on code samples. This is no replacement for the [Rust
|
||||
book](https://doc.rust-lang.org/book/), but should help you get spun up on the
|
||||
various patterns used in Rust code.
|
||||
|
||||
Also I'm happy to introduce Mara to the blog!
|
||||
|
||||
[Hey, happy to be here! I'm Mara, a shark hacker from Christine's imagination.
|
||||
I'll interject with side information, challenge assertions and more! Thanks for
|
||||
inviting me!](conversation://Mara/hacker)
|
||||
|
||||
Let's start somewhere simple: functions.
|
||||
|
||||
## Making Functions
|
||||
|
||||
Functions are defined using `fn` instead of `func`:
|
||||
|
||||
```go
|
||||
func foo() {}
|
||||
```
|
||||
|
||||
```rust
|
||||
fn foo() {}
|
||||
```
|
||||
|
||||
### Arguments
|
||||
|
||||
Arguments can be passed by separating the name from the type with a colon:
|
||||
|
||||
```go
|
||||
func foo(bar int) {}
|
||||
```
|
||||
|
||||
```rust
|
||||
fn foo(bar: i32) {}
|
||||
```
|
||||
|
||||
### Returns
|
||||
|
||||
Values can be returned by adding `-> Type` to the function declaration:
|
||||
|
||||
```go
|
||||
func foo() int {
|
||||
return 2
|
||||
}
|
||||
```
|
||||
|
||||
```rust
|
||||
fn foo() -> i32 {
|
||||
return 2;
|
||||
}
|
||||
```
|
||||
|
||||
In Rust values can also be returned on the last statement without the `return`
|
||||
keyword or a terminating semicolon:
|
||||
|
||||
```rust
|
||||
fn foo() -> i32 {
|
||||
2
|
||||
}
|
||||
```
|
||||
|
||||
[Hmm, what if I try to do something like this. Will this
|
||||
work?](conversation://Mara/hmm)
|
||||
|
||||
```rust
|
||||
fn foo() -> i32 {
|
||||
if some_cond {
|
||||
2
|
||||
}
|
||||
|
||||
4
|
||||
}
|
||||
```
|
||||
|
||||
Let's find out! The compiler spits back an error:
|
||||
|
||||
```
|
||||
error[E0308]: mismatched types
|
||||
--> src/lib.rs:3:9
|
||||
|
|
||||
2 | / if some_cond {
|
||||
3 | | 2
|
||||
| | ^ expected `()`, found integer
|
||||
4 | | }
|
||||
| | -- help: consider using a semicolon here
|
||||
| |_____|
|
||||
| expected this to be `()`
|
||||
```
|
||||
|
||||
This happens because most basic statements in Rust can return values. The best
|
||||
way to fix this would be to move the `4` return into an `else` block:
|
||||
|
||||
```rust
|
||||
fn foo() -> i32 {
|
||||
if some_cond {
|
||||
2
|
||||
} else {
|
||||
4
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Otherwise, the compiler will think you are trying to use that `if` as a
|
||||
statement, such as like this:
|
||||
|
||||
```rust
|
||||
let val = if some_cond { 2 } else { 4 };
|
||||
```
|
||||
|
||||
### Functions that can fail
|
||||
|
||||
The [Result](https://doc.rust-lang.org/std/result/) type represents things that
|
||||
can fail with specific errors. The [eyre Result
|
||||
type](https://docs.rs/eyre) represents things that can fail
|
||||
with any error. For readability, this post will use the eyre Result type.
|
||||
|
||||
[The angle brackets in the `Result` type are arguments to the type, this allows
|
||||
the Result type to work across any type you could imagine.](conversation://Mara/hacker)
|
||||
|
||||
```go
|
||||
import "errors"
|
||||
|
||||
func divide(x, y int) (int, err) {
|
||||
if y == 0 {
|
||||
return 0, errors.New("cannot divide by zero")
|
||||
}
|
||||
|
||||
return x / y, nil
|
||||
}
|
||||
```
|
||||
|
||||
```rust
|
||||
use eyre::{eyre, Result};
|
||||
|
||||
fn divide(x: i32, y: i32) -> Result<i32> {
|
||||
match y {
|
||||
0 => Err(eyre!("cannot divide by zero")),
|
||||
_ => Ok(x / y),
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
[Huh? I thought Rust had the <a
|
||||
href="https://doc.rust-lang.org/std/error/trait.Error.html">Error trait</a>,
|
||||
shouldn't you be able to use that instead of a third party package like
|
||||
eyre?](conversation://Mara/wat)
|
||||
|
||||
Let's try that, however we will need to make our own error type because the
|
||||
[`eyre!`](https://docs.rs/eyre/0.6.0/eyre/macro.eyre.html) macro creates its own
|
||||
transient error type on the fly.
|
||||
|
||||
First we need to make our own simple error type for a DivideByZero error:
|
||||
|
||||
```rust
|
||||
use std::error::Error;
|
||||
use std::fmt;
|
||||
|
||||
#[derive(Debug)]
|
||||
struct DivideByZero;
|
||||
|
||||
impl fmt::Display for DivideByZero {
|
||||
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
||||
write!(f, "cannot divide by zero")
|
||||
}
|
||||
}
|
||||
|
||||
impl Error for DivideByZero {}
|
||||
```
|
||||
|
||||
So now let's use it:
|
||||
|
||||
```rust
|
||||
fn divide(x: i32, y: i32) -> Result<i32, DivideByZero> {
|
||||
match y {
|
||||
0 => Err(DivideByZero{}),
|
||||
_ => Ok(x / y),
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
However there is still one thing left: the function returns a DivideByZero
|
||||
error, not _any_ error like the [error interface in
|
||||
Go](https://godoc.org/builtin#error). In order to represent that we need to
|
||||
return something that implements the Error trait:
|
||||
|
||||
```rust
|
||||
fn divide(x: i32, y: i32) -> Result<i32, impl Error> {
|
||||
// ...
|
||||
}
|
||||
```
|
||||
|
||||
And for the simple case, this will work. However as things get more complicated
|
||||
this simple facade will not work due to reality and its complexities. This is
|
||||
why I am shipping as much as I can out to other packages like eyre or
|
||||
[anyhow](https://docs.rs/anyhow). Check out this code in the [Rust
|
||||
Playground](https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&gist=946057d8eb02f388cb3f03bae226d10d)
|
||||
to mess with this code interactively.
|
||||
|
||||
[Pro tip: eyre (via <a href="https://docs.rs/color-eyre">color-eyre</a>) also
|
||||
has support for adding <a href="https://docs.rs/color-eyre/0.5.4/color_eyre/#custom-sections-for-error-reports-via-help-trait">custom
|
||||
sections and context</a> to errors similar to Go's <a href="https://godoc.org/fmt#Errorf">`fmt.Errorf` `%w`
|
||||
format argument</a>, which will help in real world
|
||||
applications. When you do need to actually make your own errors, you may want to look into
|
||||
crates like <a href="https://docs.rs/thiserror">thiserror</a> to help with
|
||||
automatically generating your error implementation.](conversation://Mara/hacker)
|
||||
|
||||
### The `?` Operator
|
||||
|
||||
In Rust, the `?` operator checks for an error in a function call and if there is
|
||||
one, it automatically returns the error and gives you the result of the function
|
||||
if there was no error. This only works in functions that return either an Option
|
||||
or a Result.
|
||||
|
||||
[The <a href="https://doc.rust-lang.org/std/option/index.html">Option</a> type
|
||||
isn't shown in very much detail here, but it acts like a "this thing might not exist and it's your
|
||||
responsibility to check" container for any value. The closest analogue in Go is
|
||||
making a pointer to a value or possibly putting a value in an `interface{}`
|
||||
(which can be annoying to deal with in practice).](conversation://Mara/hacker)
|
||||
|
||||
```go
|
||||
func doThing() (int, error) {
|
||||
result, err := divide(3, 4)
|
||||
if err != nil {
|
||||
return 0, err
|
||||
}
|
||||
|
||||
return result, nil
|
||||
}
|
||||
```
|
||||
|
||||
```rust
|
||||
use eyre::Result;
|
||||
|
||||
fn do_thing() -> Result<i32> {
|
||||
let result = divide(3, 4)?;
|
||||
Ok(result)
|
||||
}
|
||||
```
|
||||
|
||||
If the second argument of divide is changed to `0`, then `do_thing` will return
|
||||
an error.
|
||||
|
||||
[And how does that work with eyre?](conversation://Mara/hmm)
|
||||
|
||||
It works with eyre because eyre has its own error wrapper type called
|
||||
[`Report`](https://docs.rs/eyre/0.6.0/eyre/struct.Report.html), which can
|
||||
represent anything that implements the Error trait.
|
||||
|
||||
## Macros
|
||||
|
||||
Rust macros are function calls with `!` after their name:
|
||||
|
||||
```rust
|
||||
println!("hello, world");
|
||||
```
|
||||
|
||||
## Variables
|
||||
|
||||
Variables are created using `let`:
|
||||
|
||||
```go
|
||||
var foo int
|
||||
var foo = 3
|
||||
foo := 3
|
||||
```
|
||||
|
||||
```rust
|
||||
let foo: i32;
|
||||
let foo = 3;
|
||||
```
|
||||
|
||||
### Mutability
|
||||
|
||||
In Rust, every variable is immutable (unchangeable) by default. If we try to
|
||||
change those variables above we get a compiler error:
|
||||
|
||||
```rust
|
||||
fn main() {
|
||||
let foo: i32;
|
||||
let foo = 3;
|
||||
foo = 4;
|
||||
}
|
||||
```
|
||||
|
||||
This makes the compiler return this error:
|
||||
|
||||
```
|
||||
error[E0384]: cannot assign twice to immutable variable `foo`
|
||||
--> src/main.rs:4:5
|
||||
|
|
||||
3 | let foo = 3;
|
||||
| ---
|
||||
| |
|
||||
| first assignment to `foo`
|
||||
| help: make this binding mutable: `mut foo`
|
||||
4 | foo = 4;
|
||||
| ^^^^^^^ cannot assign twice to immutable variable
|
||||
```
|
||||
|
||||
As the compiler suggests, you can create a mutable variable by adding the `mut`
|
||||
keyword after the `let` keyword. There is no analog to this in Go.
|
||||
|
||||
```rust
|
||||
let mut foo: i32 = 0;
|
||||
foo = 4;
|
||||
```
|
||||
|
||||
[This is slightly a lie. There's more advanced cases involving interior
|
||||
mutability and other fun stuff like that, however this is a more advanced topic
|
||||
that isn't covered here.](conversation://Mara/hacker)
|
||||
|
||||
### Lifetimes
|
||||
|
||||
Rust does garbage collection at compile time. It also passes ownership of memory
|
||||
to functions as soon as possible. Lifetimes are how Rust calculates how "long" a
|
||||
given bit of data should exist in the program. Rust will then tell the compiled
|
||||
code to destroy the data from memory as soon as possible.
|
||||
|
||||
[This is slightly inaccurate in order to make this simpler to explain and
|
||||
understand. It's probably more accurate to say that Rust calculates _when_ to
|
||||
collect garbage at compile time, but the difference doesn't really matter for
|
||||
most cases](conversation://Mara/hacker)
|
||||
|
||||
For example, this code will fail to compile because `quo` was moved into the
|
||||
second divide call:
|
||||
|
||||
```rust
|
||||
let quo = divide(4, 8)?;
|
||||
let other_quo = divide(quo, 5)?;
|
||||
|
||||
// Fails compile because ownership of quo was given to divide to create other_quo
|
||||
let yet_another_quo = divide(quo, 4)?;
|
||||
```
|
||||
|
||||
To work around this you can pass a reference to the divide function:
|
||||
|
||||
```rust
|
||||
let other_quo = divide(&quo, 5);
|
||||
let yet_another_quo = divide(&quo, 4)?;
|
||||
```
|
||||
|
||||
Or even create a clone of it:
|
||||
|
||||
```rust
|
||||
let other_quo = divide(quo.clone(), 5);
|
||||
let yet_another_quo = divide(quo, 4)?;
|
||||
```
|
||||
|
||||
[You can also get more fancy with <a
|
||||
href="https://doc.rust-lang.org/rust-by-example/scope/lifetime/explicit.html">explicit
|
||||
lifetime annotations</a>, however as of Rust's 2018 edition they aren't usually
|
||||
required unless you are doing something weird. This is something that is also
|
||||
covered in more detail in <a
|
||||
href="https://doc.rust-lang.org/stable/book/ch04-00-understanding-ownership.html">The
|
||||
Rust Book</a>.](conversation://Mara/hacker)
|
||||
|
||||
### Passing Mutability
|
||||
|
||||
Sometimes functions need mutable variables. To pass a mutable reference, add
|
||||
`&mut` before the name of the variable:
|
||||
|
||||
```rust
|
||||
let something = do_something_to_quo(&mut quo)?;
|
||||
```
|
||||
|
||||
## Project Setup
|
||||
|
||||
### Imports
|
||||
|
||||
External dependencies are declared using the [Cargo.toml
|
||||
file](https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html):
|
||||
|
||||
```toml
|
||||
# Cargo.toml
|
||||
|
||||
[dependencies]
|
||||
eyre = "0.6"
|
||||
```
|
||||
|
||||
This depends on the crate [eyre](https://crates.io/crates/eyre) at version
|
||||
0.6.x.
|
||||
|
||||
[You can do much more with version requirements with cargo, see more <a
|
||||
href="https://doc.rust-lang.org/cargo/reference/specifying-dependencies.html">here</a>.](conversation://Mara/hacker)
|
||||
|
||||
Dependencies can also have optional features:
|
||||
|
||||
```toml
|
||||
# Cargo.toml
|
||||
|
||||
[dependencies]
|
||||
reqwest = { version = "0.10", features = ["json"] }
|
||||
```
|
||||
|
||||
This depends on the crate [reqwest](https://crates.io/reqwest) at version 0.10.x
|
||||
with the `json` feature enabled (in this case it enables reqwest being able to
|
||||
automagically convert things to/from json using Serde).
|
||||
|
||||
External dependencies can be used with the `use` statement:
|
||||
|
||||
```go
|
||||
// go
|
||||
|
||||
import "github.com/foo/bar"
|
||||
```
|
||||
|
||||
```rust
|
||||
use foo; // -> foo now has the members of crate foo behind the :: operator
|
||||
use foo::Bar; // -> Bar is now exposed as a type in this file
|
||||
|
||||
use eyre::{eyre, Result}; // exposes the eyre! and Result members of eyre
|
||||
```
|
||||
|
||||
[This doesn't cover how the <a
|
||||
href="http://www.sheshbabu.com/posts/rust-module-system/">module system</a>
|
||||
works, however the post I linked there covers this better than I
|
||||
can.](conversation://Mara/hacker)
|
||||
|
||||
## Async/Await
|
||||
|
||||
Async functions may be interrupted to let other things execute as needed. This
|
||||
program uses [tokio](https://tokio.rs/) to handle async tasks. To run an async
|
||||
task and wait for its result, do this:
|
||||
|
||||
```
|
||||
let printer_fact = reqwest::get("https://printerfacts.cetacean.club/fact")
|
||||
.await?
|
||||
.text()
|
||||
.await?;
|
||||
println!("your printer fact is: {}", printer_fact);
|
||||
```
|
||||
|
||||
This will populate `response` with an amusing fact about everyone's favorite
|
||||
household pet, the [printer](https://printerfacts.cetacean.club).
|
||||
|
||||
To make an async function, add the `async` keyword before the `fn` keyword:
|
||||
|
||||
```rust
|
||||
async fn get_text(url: String) -> Result<String> {
|
||||
reqwest::get(&url)
|
||||
.await?
|
||||
.text()
|
||||
.await?
|
||||
}
|
||||
```
|
||||
|
||||
This can then be called like this:
|
||||
|
||||
```rust
|
||||
let printer_fact = get_text("https://printerfacts.cetacean.club/fact").await?;
|
||||
```
|
||||
|
||||
## Public/Private Types and Functions
|
||||
|
||||
Rust has three privacy levels for functions:
|
||||
|
||||
- Only visible to the current file (no keyword, lowercase in Go)
|
||||
- Visible to anything in the current crate (`pub(crate)`, internal packages in
|
||||
go)
|
||||
- Visible to everyone (`pub`, upper case in Go)
|
||||
|
||||
[You can't get a perfect analog to `pub(crate)` in Go, but <a
|
||||
href="https://docs.google.com/document/d/1e8kOo3r51b2BWtTs_1uADIA5djfXhPT36s6eHVRIvaU/edit">internal
|
||||
packages</a> can get close to this behavior. Additionally you can have a lot
|
||||
more control over access levels than this, see <a
|
||||
href="https://doc.rust-lang.org/nightly/reference/visibility-and-privacy.html">here</a>
|
||||
for more information.](conversation://Mara/hacker)
|
||||
|
||||
## Structures
|
||||
|
||||
Rust structures are created using the `struct` keyword:
|
||||
|
||||
```go
|
||||
type Client struct {
|
||||
Token string
|
||||
}
|
||||
```
|
||||
|
||||
```rust
|
||||
pub struct Client {
|
||||
pub token: String,
|
||||
}
|
||||
```
|
||||
|
||||
If the `pub` keyword is not specified before a member name, it will not be
|
||||
usable outside the Rust source code file it is defined in:
|
||||
|
||||
```go
|
||||
type Client struct {
|
||||
token string
|
||||
}
|
||||
```
|
||||
|
||||
```rust
|
||||
pub(crate) struct Client {
|
||||
token: String,
|
||||
}
|
||||
```
|
||||
|
||||
### Encoding structs to JSON
|
||||
|
||||
[serde](https://serde.rs) is used to convert structures to json. The Rust
|
||||
compiler's
|
||||
[derive](https://doc.rust-lang.org/stable/rust-by-example/trait/derive.html)
|
||||
feature is used to automatically implement the conversion logic.
|
||||
|
||||
```go
|
||||
type Response struct {
|
||||
Name string `json:"name"`
|
||||
Description *string `json:"description,omitempty"`
|
||||
}
|
||||
```
|
||||
|
||||
```rust
|
||||
use serde::{Serialize, Deserialize};
|
||||
|
||||
#[derive(Serialize, Deserialize, Debug)]
|
||||
pub(crate) struct Response {
|
||||
pub name: String,
|
||||
pub description: Option<String>,
|
||||
}
|
||||
```
|
||||
|
||||
## Strings
|
||||
|
||||
Rust has a few string types that do different things. You can read more about
|
||||
this [here](https://fasterthanli.me/blog/2020/working-with-strings-in-rust/),
|
||||
but at a high level most projects only uses a few of them:
|
||||
|
||||
- `&str`, a slice reference to a String owned by someone else
|
||||
- String, an owned UTF-8 string
|
||||
- PathBuf, a filepath string (encoded in whatever encoding the OS running this
|
||||
code uses for filesystems)
|
||||
|
||||
The strings are different types for safety reasons. See the linked blogpost for
|
||||
more detail about this.
|
||||
|
||||
## Enumerations / Tagged Unions
|
||||
|
||||
Enumerations, also known as tagged unions, are a way to specify a superposition
|
||||
of one of a few different kinds of values in one type. A neat way to show them
|
||||
off (along with some other fancy features like the derivation system) is with the
|
||||
[structopt](https://docs.rs/structopt/0.3.14/structopt/) crate. There is no easy
|
||||
analog for this in Go.
|
||||
|
||||
[We've actually been dealing with enumerations ever since we touched the Result
|
||||
type earlier. <a
|
||||
href="https://doc.rust-lang.org/std/result/enum.Result.html">Result</a> and <a
|
||||
href="https://doc.rust-lang.org/std/option/enum.Option.html">Option</a> are
|
||||
implemented with enumerations.](conversation://Mara/hacker)
|
||||
|
||||
```rust
|
||||
#[derive(StructOpt, Debug)]
|
||||
#[structopt(about = "A simple release management tool")]
|
||||
pub(crate) enum Cmd {
|
||||
/// Creates a new release for a git repo
|
||||
Cut {
|
||||
#[structopt(flatten)]
|
||||
common: Common,
|
||||
/// Changelog location
|
||||
#[structopt(long, short, default_value="./CHANGELOG.md")]
|
||||
changelog: PathBuf,
|
||||
},
|
||||
|
||||
/// Runs releases as triggered by GitHub Actions
|
||||
GitHubAction {
|
||||
#[structopt(flatten)]
|
||||
gha: GitHubAction,
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
Enum variants can be matched using the `match` keyword:
|
||||
|
||||
```rust
|
||||
match cmd {
|
||||
Cmd::Cut { common, changelog } => {
|
||||
cmd::cut::run(common, changelog).await
|
||||
}
|
||||
Cmd::GitHubAction { gha } => {
|
||||
cmd::github_action::run(gha).await
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
All variants of an enum must be matched in order for the code to compile.
|
||||
|
||||
[This code was borrowed from <a
|
||||
href="https://github.com/lightspeed/palisade">palisade</a> in order to
|
||||
demonstrate this better. If you want to see these patterns in action, check this
|
||||
repository out!](conversation://Mara/hacker)
|
||||
|
||||
## Testing
|
||||
|
||||
Test functions need to be marked with the `#[test]` annotation, then they will
|
||||
be run alongside `cargo test`:
|
||||
|
||||
```rust
|
||||
mod tests { // not required but it is good practice
|
||||
#[test]
|
||||
fn math_works() {
|
||||
assert_eq!(2 + 2, 4);
|
||||
}
|
||||
|
||||
#[tokio::test] // needs tokio as a dependency
|
||||
async fn http_works() {
|
||||
let _ = get_html("https://within.website").await.unwrap();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Avoid the use of `unwrap()` outside of tests. In the wrong cases, using
|
||||
`unwrap()` in production code can cause the server to crash and can incur data
|
||||
loss.
|
||||
|
||||
[Alternatively, you can also use the <a href="https://learning-rust.github.io/docs/e4.unwrap_and_expect.html#expect">`.expect()`</a> method instead
|
||||
of `.unwrap()`. This lets you attach a message that will be shown when the
|
||||
result isn't Ok.](conversation://Mara/hacker)
|
||||
|
||||
---
|
||||
|
||||
This is by no means comprehensive, see the rust book or [Learn X in Y Minutes
|
||||
Where X = Rust](https://learnxinyminutes.com/docs/rust/) for more information.
|
||||
This code is written to be as boring and obvious as possible. If things don't
|
||||
make sense, please reach out and don't be afraid to ask questions.
|
||||
|
|
@ -6,6 +6,8 @@ tags:
|
|||
- offmychest
|
||||
---
|
||||
|
||||
# A Letter to Those Who Bullied Me
|
||||
|
||||
Hey,
|
||||
|
||||
I'm not angry at you. I don't want to propagate hate. In a way, I almost feel like I should be thanking you for the contributions you've made in making me into the person I am today. Without you all, I would have had a completely different outcome in life. I would have stayed in the closet for good like I had planned. I would have probably ended up boring. I would have never met my closest friends and some even more.
|
||||
|
|
|
|||
|
|
@ -1,45 +0,0 @@
|
|||
---
|
||||
title: "Site Update: A Sigil"
|
||||
date: 2022-01-11
|
||||
---
|
||||
|
||||
<style>
|
||||
.logo-wumbo {
|
||||
background-color: #fdf5d7;
|
||||
-webkit-mask: url("/static/img/xeiaso.svg");
|
||||
-webkit-mask-repeat: no-repeat;
|
||||
-webkit-mask-size: 100%;
|
||||
mask: url("/static/img/xeiaso.svg");
|
||||
mask-repeat: no-repeat;
|
||||
mask-size: 100%;
|
||||
width: 9.5em;
|
||||
height: 16em;
|
||||
display: inline-block;
|
||||
}
|
||||
|
||||
@media (prefers-color-scheme: light) {
|
||||
.logo-wumbo {
|
||||
background-color: #1d2021;
|
||||
}
|
||||
}
|
||||
</style>
|
||||
|
||||
The upper left-hand corner of my website has gotten more interesting as of
|
||||
recently. I have decided to experiment with adding an SVG icon to the upper left
|
||||
hand corner of the page.
|
||||
|
||||
This is the sigilized form of the name `Xe Iaso`. This sigil is equivalent in
|
||||
meaning and semantics to the name `Xe Iaso`. Here is a version of it in a much
|
||||
bigger size:
|
||||
|
||||
<center><span class="logo-wumbo"></span></center>
|
||||
|
||||
[Fun fact: the sigil is written using <a
|
||||
href="https://greggshorthand.github.io/index.html">Gregg Shorthand</a>. It says
|
||||
the phonetic equivalent of `Xe Iaso`.](conversation://Mara/hacker)
|
||||
|
||||
I have tested this in Edge on Linux, Firefox on Linux, Chrome on Android and
|
||||
Safari on iOS. This should cover most of the big web browsers, but surely I've
|
||||
missed something. If you use a _modern release_ of a _standards compliant_ web
|
||||
browser and you don't see a logo anywhere on the page, please let me know so I
|
||||
can go cry and then hopefully fix the issue.
|
||||
|
|
@ -1,27 +0,0 @@
|
|||
---
|
||||
title: A Tool to Aid Forgetfulness
|
||||
date: 2022-01-12
|
||||
series: stories
|
||||
---
|
||||
|
||||
The Egyptian God Thoth lived in the Egyptian city of Naucratis. Thoth was the
|
||||
inventor of many arts such as math and astronomy, but the most significant was
|
||||
the invention of writing. Thoth showed writing to the king of Egypt, claiming
|
||||
that it would make Egyptians wiser and give them better memories; that it it
|
||||
would vastly improve both the memory and the wit of the Egyptian people.
|
||||
|
||||
The king replied: "Thoth, you invented this tool. As such you are not the best
|
||||
one to judge such things. You have not created a tool to aid memory, you have
|
||||
created a tool to aid forgetfulness. Learners will not use their memories, they
|
||||
will blindly trust these sigils and not remember for themselves.
|
||||
|
||||
"You have discovered an aid to vague recollection, as the users of this tool
|
||||
will not be given truth. They will only be given a semblance of truth.
|
||||
|
||||
"They will be hearers of many things and learners of nothing. They will appear
|
||||
to know all the knowledge of the world yet when asked they will only be the
|
||||
middleman to external forces that are trusted without verification. They will
|
||||
know wisdom, but not truth."
|
||||
|
||||
Adapted from The Dialogues of Plato in Five Volumes, 3rd ed. Oxford
|
||||
University, 1892. Vol. 1 pp. 483-489.
|
||||
|
|
@ -1,278 +0,0 @@
|
|||
---
|
||||
title: "A Trip into FreeBSD"
|
||||
date: 2021-02-13
|
||||
tags:
|
||||
- freebsd
|
||||
---
|
||||
|
||||
I normally deal with Linux machines. Linux is what I know and it's what I've
|
||||
been using since I was in college. A friend of mine has been coaxing me into
|
||||
trying out [FreeBSD](https://www.freebsd.org), and I decided to try it out and
|
||||
see what it's like. Here's some details about my experience and what I've
|
||||
learned.
|
||||
|
||||
## Hardware
|
||||
|
||||
I've tried out FreeBSD on the following hardware:
|
||||
|
||||
- qemu/KVM on amd64
|
||||
- Raspberry Pi 4 (4 GB)
|
||||
- Raspberry Pi 3B (1 GB)
|
||||
|
||||
I've had the most luck with the Raspberry Pi 3 though. The KVM machine would
|
||||
hang infinitely after the install process waiting for the mail service to do a
|
||||
DNS probe of its own hostname (I do not host automagic FQDNS for my vms). I'm
|
||||
pretty sure I was doing something wrong there but I wasn't able to figure out
|
||||
what I needed to do in order to disable the DNS probe blocking startup.
|
||||
|
||||
[If you know what we were doing wrong here, please feel free to <a
|
||||
href="/contact">contact</a> us with the thing we messed
|
||||
up.](conversation://Mara/hacker)
|
||||
|
||||
After waiting for about 5 minutes I gave up and decided to try out the Raspberry
|
||||
Pi 4. The Raspberry Pi 4 is the most powerful arm board I own. It has 4 GB of
|
||||
ram and a quad core processor that is way more than sufficient for my needs. I
|
||||
was hoping to use FreeBSD on that machine so I could benefit from the hardware
|
||||
the most. Following the instructions on [the wiki
|
||||
page](https://wiki.freebsd.org/arm/Raspberry%20Pi), I downloaded the 12.2 RPI
|
||||
image and flashed it to an SD card using Etcher. I put the SD card in, turned
|
||||
the raspi on and then waited for it to show up on the network.
|
||||
|
||||
Except it never showed up on the network. I ran scans with nmap (specifically
|
||||
with the command `sudo nmap -sS -p 22 192.168.0.0/24`) and the IP address never
|
||||
showed up. I also didn't see any new MAC addresses on the network, so that lead
|
||||
me to believe that the pi was failing to boot. I downloaded an image for 13-BETA
|
||||
and followed [this
|
||||
guide](https://medium.com/swlh/freebsd-usb-boot-on-raspberry-pi-4-765cb6e75570)
|
||||
that claims to make it work on the pi 4, but I got the same issue. The Raspberry
|
||||
Pi 4 unfortunately has a micro-HDMI port on it, so I was unable to attach it to
|
||||
my monitor to see any error messages. After trying for a while to see if I could
|
||||
set up a serial port to get the serial log messages (spoiler: I couldn't), I dug
|
||||
up my Pi 3 and stuck the same SD card into it, hooked it up to my monitor,
|
||||
attached a spare keyboard to it and booted into FreeBSD first try.
|
||||
|
||||
## Using FreeBSD
|
||||
|
||||
FreeBSD is a very down to earth operating system. It also has a
|
||||
[handbook](https://docs.freebsd.org/en/books/handbook/) that legitimately
|
||||
includes all of the information you need to get up and running. Following the
|
||||
handbook, I set a new password, installed the `pkg` tool, set up
|
||||
[fish](https://fishshell.com) and then also installed the Go compiler toolchain
|
||||
for the hell of it.
|
||||
|
||||
`pkg` is a very minimal looking package manager. It doesn't have very many
|
||||
frills and it is integrated into the system pretty darn well. It looks like it
|
||||
prefers putting everything into `/usr/local`, including init scripts and other
|
||||
configuration files.
|
||||
|
||||
This interestingly lets you separate out the concerns of the base system from
|
||||
individual machine-local configuration. I am not sure if this also works with
|
||||
files like `/etc/resolv.conf` or other system configuration files, but it does
|
||||
really give `/usr/local` a reason to exist beyond being a legacy location for
|
||||
yolo-installed software that may or may not be able to be upgraded separately.
|
||||
|
||||
## Custom Services
|
||||
|
||||
Speaking of services, I wanted to see how hard it would be to get a custom
|
||||
service running on a FreeBSD box. At the minimum I would need the following:
|
||||
|
||||
- The binary built for freebsd/aarch64 and installed to `/usr/local/bin`
|
||||
- A user account for that service
|
||||
- An init script for that service
|
||||
- To enable the init script in `/etc/rc.conf`
|
||||
|
||||
I decided to do this with a service I made years ago called
|
||||
[whatsmyip](https://github.com/Xe/whatsmyip).
|
||||
|
||||
### Building a Binary
|
||||
|
||||
Building the service is easy, I just go into the directory and run `go build`.
|
||||
Then I get a binary. Running it in another tmux tab, we can see it in action:
|
||||
|
||||
```console
|
||||
$ curl http://[::1]:9090
|
||||
::1
|
||||
```
|
||||
|
||||
I can also run the curl command from my macbook:
|
||||
|
||||
```console
|
||||
$ curl http://pai:9090
|
||||
100.72.190.5
|
||||
```
|
||||
|
||||
Cool, I've got a working service! Let's install it to `/usr/local/bin`:
|
||||
|
||||
```console
|
||||
$ doas cp ./whatismyip /usr/local/bin
|
||||
```
|
||||
|
||||
[Wait, `doas`? What is `doas`? It looks like it's doing something close to what
|
||||
sudo does.](conversation://Mara/hmm)
|
||||
|
||||
[doas](https://en.wikipedia.org/wiki/Doas) is a program that does most of the
|
||||
same things that sudo does, but it's a much smaller codebase. I decided to try
|
||||
out doas for this install for no other reason than I thought it would be a cool
|
||||
thing to learn. It's actually pretty simple, and I'm going to look at using it
|
||||
elsewhere (with an alias for `sudo` -> `doas`).
|
||||
|
||||
### Service User
|
||||
|
||||
The handbook says that we use the
|
||||
[adduser](https://people.freebsd.org/~blackend/en_US.ISO8859-1/books/handbook/users-synopsis.html)
|
||||
command to add users to the system. So, let's run `adduser` to create a
|
||||
`whatsmyip` user:
|
||||
|
||||
```console
|
||||
# adduser
|
||||
Username: whatsmyip
|
||||
Full name: github.com/Xe/whatsmyip
|
||||
Uid (Leave empty for default): 666
|
||||
Login group [whatsmyip]:
|
||||
Login group is whatsmyip. Invite whatsmyip into other groups? []:
|
||||
Login class [default]:
|
||||
Shell (sh csh tcsh bash rbash git-shell fish nologin) [sh]: sh
|
||||
Home directory [/home/whatsmyip]: /var/db/whatsmyip
|
||||
Home directory permissions (Leave empty for default):
|
||||
Use password-based authentication? [yes]: no
|
||||
Lock out the account after creation? [no]: yes
|
||||
Username : whatsmyip
|
||||
Password : <disabled>
|
||||
Full Name : github.com/Xe/whatsmyip
|
||||
Uid : 666
|
||||
Class :
|
||||
Groups : whatsmyip
|
||||
Home : /var/db/whatsmyip
|
||||
Home Mode :
|
||||
Shell : /bin/sh
|
||||
Locked : yes
|
||||
OK? (yes/no): yes
|
||||
adduser: INFO: Successfully added (whatsmyip) to the user database.
|
||||
adduser: INFO: Account (whatsmyip) is locked.
|
||||
Add another user? (yes/no): no
|
||||
Goodbye!
|
||||
```
|
||||
|
||||
It's a bit weird that there's not a flow for creating a "system user" that
|
||||
automatically sets the flags that I expect from Linux system administration, but
|
||||
I was able to specify the values manually without too much effort.
|
||||
|
||||
Something interesting is that when I set the user account to `nologin` I
|
||||
actually was unable to log in as the user. Usually in Linux you can hack around
|
||||
this with `su` flags but FreeBSD doesn't have this escape hatch. Neat.
|
||||
|
||||
### Init Script
|
||||
|
||||
Now that I had the service account set up, I need to write an init service that
|
||||
will start this program on boot. Following other parts of the handbook I was
|
||||
able to get a base script that looks like this:
|
||||
|
||||
```shell
|
||||
#!/bin/sh
|
||||
#
|
||||
# PROVIDE: whatsmyip
|
||||
# REQUIRE: DAEMON
|
||||
# KEYWORD: shutdown
|
||||
|
||||
. /etc/rc.subr
|
||||
|
||||
name=whatsmyip
|
||||
rcvar=whatsmyip_enable
|
||||
|
||||
command="/usr/sbin/daemon"
|
||||
command_args="-S -u whatsmyip -r -f -p /var/run/whatsmyip.pid /usr/local/bin/whatsmyip"
|
||||
load_rc_config $name
|
||||
|
||||
#
|
||||
# DO NOT CHANGE THESE DEFAULT VALUES HERE
|
||||
# SET THEM IN THE /etc/rc.conf FILE
|
||||
#
|
||||
whatsmyip_enable=${whatsmyip_enable-"NO"}
|
||||
pidfile=${whatsmyip_pidfile-"/var/run/whatsmyip.pid"}
|
||||
|
||||
run_rc_command "$1"
|
||||
```
|
||||
|
||||
Now I can copy this file to `/usr/local/etc/rc.d/whatsmyip` and then make sure
|
||||
it's set to the permissions `0555` with something like:
|
||||
|
||||
```console
|
||||
$ chmod 0555 ./whatsmyip.rc
|
||||
$ doas cp ./whatsmyip.rc /usr/local/etc/rc.d/whatsmyip
|
||||
```
|
||||
|
||||
### Enabling The Service
|
||||
|
||||
Once I had the file in the right place, I enabled the service in `/etc/rc.conf`
|
||||
like this:
|
||||
|
||||
```shell
|
||||
# whatsmyip
|
||||
whatsmyip_enable="YES"
|
||||
```
|
||||
|
||||
Then I started the service with `service whatsmyip start`, and I was unable to
|
||||
start the service. I got this error:
|
||||
|
||||
```
|
||||
Feb 13 20:40:00 pai freebsd[1519]: /usr/local/etc/rc.d/whatsmyip: WARNING: failed to start whatsmyip
|
||||
```
|
||||
|
||||
And no other useful information to help me actually fix the problem. I assume
|
||||
there's some weirdness going on with permissions, so let's sidestep the user
|
||||
account for now and just run the service as root directly by changing the
|
||||
`command_args` in `/usr/local/etc/rc.d/whatsmyip`:
|
||||
|
||||
```shell
|
||||
command_args="-S -r -p /var/run/whatsmyip.pid /usr/local/bin/whatsmyip"
|
||||
```
|
||||
|
||||
Restarting the service, everything works! I can hit that service all I want and
|
||||
I get back the IP address that I used to hit that service.
|
||||
|
||||
## What I Learned
|
||||
|
||||
FreeBSD has _excellent_ documentation. The people on the documentation team
|
||||
really care about making the handbook useful. I wish it went into more detail
|
||||
about best practices for making your own services (I had to crib from some other
|
||||
service files as well as googling for a minimal template), but overall it gives
|
||||
you enough information to get off the ground.
|
||||
|
||||
FreeBSD is also fairly weird. It's familiar-ish, but it's a very different
|
||||
experience. It's also super-minimal. Looking at the output of `ps x`, there's
|
||||
only 45 processes running on the system, including kernel threads.
|
||||
|
||||
```
|
||||
root@pai ~# ps x | wc -l
|
||||
45
|
||||
```
|
||||
|
||||
The only processes are `init`, `dhclient`, a device manager, `syslog`,
|
||||
`tailscaled`, `sshd`, `cron`, `whatsmyip`, `fish` and a few instances of `getty`
|
||||
to allow me to log in with an HDMI monitor and keyboard should I need to. That's
|
||||
it. That's all that's running. It's only using 96 MB of ram and most of the
|
||||
machine's power is left over to me.
|
||||
|
||||
It's just a shame that FreeBSD support for programming languages is so poor in
|
||||
general. Go works fine on it, but Rust doesn't have any pre-built binaries for
|
||||
the compiled (and using ports/pkg isn't an option because aarch64 is a tier-2
|
||||
architecture in FreeBSD land which means that it's not guaranteed to have
|
||||
prebuilt binaries for everything). Compiling Rust from source also really isn't
|
||||
an option because I don't have enough ram on my raspi to do that. Go works
|
||||
though.
|
||||
|
||||
I really wonder how this kind of network effect will boil down with more and
|
||||
more security libraries like
|
||||
[pyca](https://github.com/pyca/cryptography/issues/5771) integrating Rust deeper
|
||||
into core security components. It probably means that people are going to have
|
||||
to step up and actually do the legwork required to get Rust working on more
|
||||
platforms, however it definitely is going to leave some older hardware or less
|
||||
commonly used configurations (like aarch64 FreeBSD) in the dust if we aren't
|
||||
careful. Maybe this isn't a technical problem, but it is definitely something
|
||||
interesting to think about.
|
||||
|
||||
Overall, FreeBSD is an interesting tool and if I ever have a good use for it in
|
||||
my server infrastructure I will definitely give it a solid look. I just wish it
|
||||
was as easy to manage a FreeBSD system as it is to manage a NixOS system. A lot
|
||||
of my faffing about with `rc.conf` and rc scripts wouldn't have needed to
|
||||
happen if that was the case.
|
||||
|
|
@ -1,278 +0,0 @@
|
|||
---
|
||||
title: Prometheus and Aegis
|
||||
date: 2021-04-05
|
||||
tags:
|
||||
- prometheus
|
||||
- o11y
|
||||
---
|
||||
|
||||
[*Last time in the christine dot website cinematic
|
||||
universe:*](https://christine.website/blog/unix-domain-sockets-2021-04-01)
|
||||
|
||||
*Unix sockets started to be used to grace the cluster. Things were at peace.
|
||||
Then, a realization came through:*
|
||||
|
||||
[What about Prometheus? Doesn't it need a direct line of fire to the service to
|
||||
scrape metrics?](conversation://Mara/hmm?smol)
|
||||
|
||||
*This could not do! Without observability the people of the Discord wouldn't have
|
||||
a livefeed of the infrastructure falling over! This cannot stand! Look, our hero
|
||||
takes action!*
|
||||
|
||||
[It will soon!](conversation://Cadey/percussive-maintenance?smol)
|
||||
|
||||
In order to help keep an eye on all of the services I run, I use
|
||||
[Prometheus](https://prometheus.io/) for collecting metrics. For an example of
|
||||
the kind of metrics I collect, see [here (1)](/metrics). In the configuration
|
||||
that I have, Prometheus runs on a server in my apartment and reaches out to my
|
||||
other machines to scrape metrics over the network. This worked great when I had
|
||||
my major services listen over TCP, I could just point Prometheus at the backend
|
||||
port over my tunnel.
|
||||
|
||||
When I started using Unix sockets for hosting my services, this stopped working.
|
||||
It became very clear very quickly that I needed some kind of shim. This shim
|
||||
needed to do the following things:
|
||||
|
||||
- Listen over the network as a HTTP server
|
||||
- Connect to the unix sockets for relevant services based on the path (eg.
|
||||
`/xesite` should get the metrics from `/srv/within/run/xesite.sock`)
|
||||
- Do nothing else
|
||||
|
||||
The Go standard library has a tool for doing reverse proxying in the standard
|
||||
library:
|
||||
[`net/http/httputil#ReverseProxy`](https://pkg.go.dev/net/http/httputil#ReverseProxy).
|
||||
Maybe we could build something with this?
|
||||
|
||||
[The documentation seems to imply it will use the network by default. Wait,
|
||||
what's this `Transport` field?](conversation://Mara/hmm?smol)
|
||||
|
||||
```go
|
||||
type ReverseProxy struct {
|
||||
// ...
|
||||
|
||||
// The transport used to perform proxy requests.
|
||||
// If nil, http.DefaultTransport is used.
|
||||
Transport http.RoundTripper
|
||||
|
||||
// ...
|
||||
}
|
||||
```
|
||||
|
||||
[So a transport is a <a
|
||||
href="https://pkg.go.dev/net/http#RoundTripper">`RoundTripper`</a>, which is a
|
||||
function that takes a request and returns a response somehow. It uses
|
||||
`http.DefaultTransport` by default, which reads from the network. So at a
|
||||
minimum we're gonna need: <ul><li>a `ReverseProxy`</li><li>a
|
||||
`Transport`</li><li>a dialing function</li><ul>Right?](conversation://Mara/hmm?smol)
|
||||
|
||||
Yep! Unix sockets can be used like normal sockets, so all you need is something
|
||||
like this:
|
||||
|
||||
```go
|
||||
func proxyToUnixSocket(w http.ResponseWriter, r *http.Request) {
|
||||
name := path.Base(r.URL.Path)
|
||||
|
||||
fname := filepath.Join(*sockdir, name+".sock")
|
||||
_, err := os.Stat(fname)
|
||||
if os.IsNotExist(err) {
|
||||
http.NotFound(w, r)
|
||||
return
|
||||
}
|
||||
|
||||
ts := &http.Transport{
|
||||
Dial: func(_, _ string) (net.Conn, error) {
|
||||
return net.Dial("unix", fname)
|
||||
},
|
||||
DisableKeepAlives: true,
|
||||
}
|
||||
|
||||
rp := httputil.ReverseProxy{
|
||||
Director: func(req *http.Request) {
|
||||
req.URL.Scheme = "http"
|
||||
req.URL.Host = "aegis"
|
||||
req.URL.Path = "/metrics"
|
||||
req.URL.RawPath = "/metrics"
|
||||
},
|
||||
Transport: ts,
|
||||
}
|
||||
rp.ServeHTTP(w, r)
|
||||
}
|
||||
```
|
||||
|
||||
[So in this handler:](conversation://Mara/hmm?smol)
|
||||
|
||||
```go
|
||||
name := path.Base(r.URL.Path)
|
||||
|
||||
fname := filepath.Join(*sockdir, name+".sock")
|
||||
_, err := os.Stat(fname)
|
||||
if os.IsNotExist(err) {
|
||||
http.NotFound(w, r)
|
||||
return
|
||||
}
|
||||
|
||||
ts := &http.Transport{
|
||||
Dial: func(_, _ string) (net.Conn, error) {
|
||||
return net.Dial("unix", fname)
|
||||
},
|
||||
DisableKeepAlives: true,
|
||||
}
|
||||
```
|
||||
|
||||
[You have the socket path built from the URL path, and then you return
|
||||
connections to that path ignoring what the HTTP stack thinks it should point
|
||||
to?](conversation://Mara/hmm?smol)
|
||||
|
||||
Yep. Then the rest is really just boilerplate:
|
||||
|
||||
```go
|
||||
package main
|
||||
|
||||
import (
|
||||
"flag"
|
||||
"log"
|
||||
"net"
|
||||
"net/http"
|
||||
"net/http/httputil"
|
||||
"os"
|
||||
"path"
|
||||
"path/filepath"
|
||||
)
|
||||
|
||||
var (
|
||||
hostport = flag.String("hostport", "[::]:31337", "TCP host:port to listen on")
|
||||
sockdir = flag.String("sockdir", "./run", "directory full of unix sockets to monitor")
|
||||
)
|
||||
|
||||
func main() {
|
||||
flag.Parse()
|
||||
|
||||
log.SetFlags(0)
|
||||
log.Printf("%s -> %s", *hostport, *sockdir)
|
||||
|
||||
http.DefaultServeMux.HandleFunc("/", proxyToUnixSocket)
|
||||
|
||||
log.Fatal(http.ListenAndServe(*hostport, nil))
|
||||
}
|
||||
```
|
||||
|
||||
Now all that's needed is to build a NixOS service out of this:
|
||||
|
||||
```nix
|
||||
{ config, lib, pkgs, ... }:
|
||||
let cfg = config.within.services.aegis;
|
||||
in
|
||||
with lib; {
|
||||
# Mara\ this describes all of the configuration options for Aegis.
|
||||
options.within.services.aegis = {
|
||||
enable = mkEnableOption "Activates Aegis (unix socket prometheus proxy)";
|
||||
|
||||
# Mara\ This is the IPv6 host:port that the service should listen on.
|
||||
# It's IPv6 because this is $CURRENT_YEAR.
|
||||
hostport = mkOption {
|
||||
type = types.str;
|
||||
default = "[::1]:31337";
|
||||
description = "The host:port that aegis should listen for traffic on";
|
||||
};
|
||||
|
||||
# Mara\ This is the folder full of unix sockets. In the previous post we
|
||||
# mentioned that the sockets should go somewhere like /tmp, however this
|
||||
# may be a poor life decision:
|
||||
# https://lobste.rs/s/fqqsct/unix_domain_sockets_for_serving_http#c_g4ljpf
|
||||
sockdir = mkOption {
|
||||
type = types.str;
|
||||
default = "/srv/within/run";
|
||||
example = "/srv/within/run";
|
||||
description =
|
||||
"The folder that aegis will read from";
|
||||
};
|
||||
};
|
||||
|
||||
# Mara\ The configuration that will arise from this module if it's enabled
|
||||
config = mkIf cfg.enable {
|
||||
# Mara\ Aegis has its own user account to keep things tidy. It doesn't need
|
||||
# root to run so we don't give it root.
|
||||
users.users.aegis = {
|
||||
createHome = true;
|
||||
description = "tulpa.dev/cadey/aegis";
|
||||
isSystemUser = true;
|
||||
group = "within";
|
||||
home = "/srv/within/aegis";
|
||||
};
|
||||
|
||||
# Mara\ The systemd service that actually runs Aegis.
|
||||
systemd.services.aegis = {
|
||||
wantedBy = [ "multi-user.target" ];
|
||||
|
||||
# Mara\ These correlate to the [Service] block in the systemd unit.
|
||||
serviceConfig = {
|
||||
User = "aegis";
|
||||
Group = "within";
|
||||
Restart = "on-failure";
|
||||
WorkingDirectory = "/srv/within/aegis";
|
||||
RestartSec = "30s";
|
||||
};
|
||||
|
||||
# Mara\ When the service starts up, run this script.
|
||||
script = let aegis = pkgs.tulpa.dev.cadey.aegis;
|
||||
in ''
|
||||
exec ${aegis}/bin/aegis -sockdir="${cfg.sockdir}" -hostport="${cfg.hostport}"
|
||||
'';
|
||||
};
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
[Then I just flicked it on for a server of mine:](conversation://Cadey/enby?smol)
|
||||
|
||||
```nix
|
||||
within.services.aegis = {
|
||||
enable = true;
|
||||
hostport = "[fda2:d982:1da2:180d:b7a4:9c5c:989b:ba02]:43705";
|
||||
sockdir = "/srv/within/run";
|
||||
};
|
||||
```
|
||||
|
||||
[And then test it with `curl`:](conversation://Cadey/enby?smol)
|
||||
|
||||
```console
|
||||
$ curl http://[fda2:d982:1da2:180d:b7a4:9c5c:989b:ba02]:43705/printerfacts
|
||||
# HELP printerfacts_hits Number of hits to various pages
|
||||
# TYPE printerfacts_hits counter
|
||||
printerfacts_hits{page="fact"} 15
|
||||
printerfacts_hits{page="index"} 23
|
||||
printerfacts_hits{page="not_found"} 17
|
||||
# HELP process_cpu_seconds_total Total user and system CPU time spent in seconds.
|
||||
# TYPE process_cpu_seconds_total counter
|
||||
process_cpu_seconds_total 0.06
|
||||
# HELP process_max_fds Maximum number of open file descriptors.
|
||||
# TYPE process_max_fds gauge
|
||||
process_max_fds 1024
|
||||
# HELP process_open_fds Number of open file descriptors.
|
||||
# TYPE process_open_fds gauge
|
||||
process_open_fds 12
|
||||
# HELP process_resident_memory_bytes Resident memory size in bytes.
|
||||
# TYPE process_resident_memory_bytes gauge
|
||||
process_resident_memory_bytes 5296128
|
||||
# HELP process_start_time_seconds Start time of the process since unix epoch in seconds.
|
||||
# TYPE process_start_time_seconds gauge
|
||||
process_start_time_seconds 1617458164.36
|
||||
# HELP process_virtual_memory_bytes Virtual memory size in bytes.
|
||||
# TYPE process_virtual_memory_bytes gauge
|
||||
process_virtual_memory_bytes 911777792
|
||||
```
|
||||
|
||||
[And there you go! Now we can make Prometheus point to this and we can save
|
||||
Christmas!](conversation://Cadey/aha?smol)
|
||||
|
||||
[:D](conversation://Mara/happy?smol)
|
||||
|
||||
---
|
||||
|
||||
This is another experiment in writing these kinds of posts in more of a Socratic
|
||||
method. I'm trying to strike a balance with a [limited pool of
|
||||
stickers](https://tulpa.dev/cadey/kadis-layouts/src/branch/master/moonlander/leader.c#L68-L84)
|
||||
while I wait for more stickers/emoji to come in. [Feedback](/contact) is always welcome.
|
||||
|
||||
(1): These metrics are not perfect because of the level of caching that
|
||||
Cloudflare does for me.
|
||||
|
|
@ -4,6 +4,8 @@ date: 2019-05-25
|
|||
series: dreams
|
||||
---
|
||||
|
||||
# All There is is Now
|
||||
|
||||
The dream scenario was going on for a while uneventfully. I saw an old man walking around and ranting about things. I decided to go and talk with him.
|
||||
|
||||
"You fools! Time doesn't exist! The past is immutable! Don't worry about your trivial daily needs. All there is is Now!"
|
||||
|
|
|
|||
|
|
@ -7,6 +7,8 @@ tags:
|
|||
- makes-u-thonk
|
||||
---
|
||||
|
||||
# Outsider Art and Anathema
|
||||
|
||||
This was going to be a post about [Urbit][urbit] at first; but in the process of discussing about my interest in writing something _positive_ about it, I was warned by a few people that this was a Bad Idea. I was focusing purely on the technical side of it and how closely it implemented a concept called [liquid software][liquidsoftware], but from what people were saying, it seemed like a creation that was spoiled by something outside of it, specifically the creator's political views (of which I had little idea at the time).
|
||||
|
||||
As much as I will probably return to the original concept in the future with another post, this feels like something I had to address first.
|
||||
|
|
@ -21,13 +23,13 @@ This is a surprisingly hard question to answer. Most of the time though, I know
|
|||
|
||||
Art doesn't have to follow conventional ideas of what most people think "art" is. Art can be just about anything that you can classify as art. As a conventional example, consider something like the Mona Lisa:
|
||||
|
||||
|
||||
<center>  </center>
|
||||
|
||||
People will accept this as art without much argument. It's a painting, it obviously took a lot of skill and time to create. It is said that Leonardo Da Vinci (the artist of the painting) created it partially [as a contribution to the state of the art of oil painting][monalisawhy].
|
||||
|
||||
So that painting is art, and a lot of people would consider it art; so what *would* a lot of people *not* consider art? Here's an example:
|
||||
|
||||
|
||||
<center>  </center>
|
||||
|
||||
This is *Untitled (Perfect Lovers)* by Felix Gonzalez. If you just take a look at it without context, it's just two battery-operated clocks on a wall. Where is the expertise and the like that goes into this? This is just the result of someone buying two clocks from the store and putting them somewhere, right?
|
||||
|
||||
|
|
|
|||
|
|
@ -1,127 +0,0 @@
|
|||
---
|
||||
date: 2021-07-03
|
||||
title: My Thoughts About Using Android Again as an iPhone User
|
||||
tags:
|
||||
- android
|
||||
- iphone
|
||||
author: ectamorphic
|
||||
---
|
||||
|
||||
I used to be a hardcore Android user. It was my second major kind of smartphone
|
||||
(the first was Windows Mobile 6.1 on a T-Mobile Dash) and it left me hooked to
|
||||
the concept of smartphones and connected tech in general. I've used many Android
|
||||
phones over the years but one day I rage-switched over to an iPhone. My Samsung
|
||||
Galaxy S7 pissed me off for the last time and I went to the Apple store and
|
||||
bought an iPhone 7 on the spot. I popped my sim card into it (after a lovely
|
||||
meal at Panda Express) and I was off to the races. I haven't really used Android
|
||||
since other than in little stints with devices like the Amazon Fire 7 (because
|
||||
it was so darn cheap).
|
||||
|
||||
Recently I realized that it would be very easy to package up my website for the
|
||||
Google Play Store using [pwabuilder](https://www.pwabuilder.com/). I've been
|
||||
shipping my site as a progressive web app (PWA) for years (and use that PWA for
|
||||
testing how the site looks on my phone), but aside from the occasional confused
|
||||
screenshot that's been tweeted at me I've never actually made much use of this.
|
||||
It does do an additional level of caching (which is why you can load a bunch of
|
||||
pages on the site, disconnect from the internet and then still browse those
|
||||
pages that you loaded like you were online) though, which helps a lot with the
|
||||
bandwidth cost of this site.
|
||||
|
||||
So, I decided to ship this site as an Android app. You can download it from the
|
||||
Google Play Store
|
||||
[here](https://play.google.com/store/apps/details?id=website.christine.xesite)
|
||||
and get a partially native experience. It worked perfectly in the Android
|
||||
emulator but you really need to experience it on a phone to know for sure. On a
|
||||
whim I grabbed a [Moto g8
|
||||
Power](https://www.gsmarena.com/motorola_moto_g8_power-10052.php) from Amazon
|
||||
and then I used it for the final testing on the app before I shipped it on the
|
||||
Google Play store. I unboxed the phone, set it up, plugged it into my MacBook
|
||||
and then hit "run" in Android Studio. The app installed instantly and I saw [the
|
||||
homepage for my site](https://cdn.christine.website/file/christine-static/blog/Screenshot_20210703-101654.png).
|
||||
|
||||
It was a magical experience. Me, someone that has no idea what they are doing
|
||||
with Android app development was able to take an existing project I've poured
|
||||
years of work into and make it work on a phone like a native app. I literally
|
||||
just had the phone barely out of the box and my code was running natively on it.
|
||||
I don't have to worry about the app timing out, I don't have to pay Google money
|
||||
to test things on my own device, I just hit play and it runs.
|
||||
|
||||
This is the kind of developer experience I wish I could have on iOS. I used to
|
||||
have a paid developer cert for resigning a few personally hacked up apps, but
|
||||
when I moved to Canada and changed over my cards to have Canadian billing
|
||||
addresses I lost the ability to purchase a renewal for my developer certificate.
|
||||
I _can_ change my Apple account over to a Canadian one but doing that means I
|
||||
have to delete my Apple Music subscription and that would delete all of the
|
||||
custom uploaded music I have in the cloud. I have more music up there than I
|
||||
have disk space locally, so this is not really a viable option.
|
||||
|
||||
Meanwhile on Android you just open the box, turn the phone on, set it up, press
|
||||
on the build number 10 times, enable USB debugging, plug it in, confirm debug
|
||||
access and bam, you're in. You can test an unlimited number of Android apps
|
||||
forever. I can give the APK to people and then they can tell me if it works on
|
||||
their device. You cannot do this on iOS. It's making me really consider if iOS
|
||||
really is the best option for me going forward.
|
||||
|
||||
But then the claws of the Apple ecosystem show their face. I have an iPad,
|
||||
MacBook Air, Apple Watch, iPhone and AirPods. If I end up switching to Android
|
||||
as my main phone I make my watch significantly less useful. I won't have the
|
||||
seamless notification syncing to my wrist unless I buy a new watch. I don't
|
||||
really know if I want to do that.
|
||||
|
||||
At the same time though, Android lets me poke around and change things that
|
||||
bother me. I can make animations faster, which makes the phone _feel_ so much
|
||||
more snappy and responsive. I can rip out Chrome and replace it with something
|
||||
else. I can choose which app to use for text messages. I have _agency_ and
|
||||
_power_ over my experience in ways that iOS simply cannot match. As a tinkerer
|
||||
that mains a NixOS tower this is a huge factor for me. And then I'm able to test
|
||||
my apps for free. I can just do it. I don't have to worry about dev certs,
|
||||
licenses or anything else. I just put the app on the phone and I'm done.
|
||||
|
||||
Android's UX is a lot different than it was when I used it last. The last
|
||||
Android phone I used had hardware home, menu and back buttons. This Moto g8
|
||||
Power seems to have some kind of gesture control mode that mostly emulates
|
||||
modern iPhone gesture controls, so my muscle memory isn't totally freaked out.
|
||||
It was a bit more sensitive than I would have liked out of the box, but I was
|
||||
easily able to tweak the sensitivity until I got to a level I was comfortable
|
||||
with. This would have never been able to happen on iOS.
|
||||
|
||||
I guess this post is a lot more rambly and less focused than I thought it would
|
||||
be while I was outlining it on paper. I didn't go into this expecting a 1:1
|
||||
experience matchup with what I have on iOS. This phone is not nearly powerful
|
||||
enough to make them comparable, however I can easily just pick it up, do what I
|
||||
need and it does it. I'm considering getting a burner sim for this thing so I
|
||||
can take it with me instead of (or in addition to) my iPhone. The camera is
|
||||
decent, but I don't really have any good comparison shots yet. Android and iOS
|
||||
are at a state of convergent evolution at this point. They both do about the
|
||||
same things. Android is more easily customizeable and iOS is more about a guided
|
||||
experience. Neither is really "better" at this point, but I guess it really will
|
||||
boil down to the ecosystem you want.
|
||||
|
||||
Apple's walled garden approach has a lot of
|
||||
things in its favor. You can buy accessories from the Apple Store and they will
|
||||
just work. You can seamlessly copy things from your phone to your tablet or your
|
||||
laptop. iCloud and Airdrop glue your machines together, and in the future I can
|
||||
only anticipate that each of those devices will get more and more muddled
|
||||
together until there's not really a difference between them. Android has a lot
|
||||
of options. There's over 15,000 Android devices out there with official Google
|
||||
Play support. They're all at different patch states and have different gimmicks
|
||||
to distinguish them, but you have an unparalleled amount of choice and agency.
|
||||
This means that there's less of a consistent total experience, however it leaves
|
||||
a lot of room for experimentation and innovation.
|
||||
|
||||
I like this phone and the instance of Android that runs on it. The only real
|
||||
downside I've seen so far is that the update notes are in Spanish. I have no
|
||||
idea why they're in Spanish, I don't speak Spanish and the phone's UI language
|
||||
is set to English, but I get ["Seguridad de
|
||||
Android"](https://twitter.com/theprincessxena/status/1411072416986587138/photo/1)
|
||||
patches on it and that's my life now.
|
||||
|
||||
A lot of the Airdrop and integration features I've been missing have been
|
||||
supplemented by [Taildrop](https://tailscale.com/kb/1106/taildrop/) and
|
||||
Tailscale in general. It's really satisfying to be able to work for a company
|
||||
that makes the annoyingly hard problem of "make computers talk to eachother" so
|
||||
_trivial_.
|
||||
|
||||
Overall, it's a 7/10 experience for me. I'd likely choose Android if I wasn't so
|
||||
entrenched in the Apple/iOS ecosystem. If only it wasn't so tied into Google's
|
||||
fangs.
|
||||
|
|
@ -1,10 +0,0 @@
|
|||
---
|
||||
title: "Animal Crossing New Horizons: An Island of Stability in an Unstable World"
|
||||
date: 2021-02-28
|
||||
tags:
|
||||
- link
|
||||
redirect_to: https://www.getrevue.co/profile/theprincessxena/issues/animal-crossing-new-horizons-an-island-of-stability-in-an-unstable-world-313933
|
||||
---
|
||||
|
||||
Check out this post [on my
|
||||
newsletter](https://www.getrevue.co/profile/theprincessxena/issues/animal-crossing-new-horizons-an-island-of-stability-in-an-unstable-world-313933)!
|
||||
|
|
@ -1,126 +0,0 @@
|
|||
---
|
||||
title: "The Worst Experience I've Had With an aarch64 MacBook"
|
||||
date: 2021-02-15
|
||||
tags:
|
||||
- mac
|
||||
- aarch64
|
||||
---
|
||||
|
||||
I've had my hands on this M1 MacBook Air for a few weeks now and I have gotten a
|
||||
lot of opinions about it. I wanted to go over them and give my thoughts. This is
|
||||
an amazing laptop. Its battery life is iPad tier. I can run iPad and iPhone apps
|
||||
seamlessly.
|
||||
|
||||
That being said, aarch64 macOS is still very much in its teething phase. Rosetta
|
||||
is nothing short of a technical miracle, it's amazing how close it is to the
|
||||
performance of running amd64 apps natively. As such, it's probably going to end
|
||||
up being the _worst_ experience that I have using an aarch64 MacBook.
|
||||
|
||||
## Performance
|
||||
|
||||
[This website](https://github.com/Xe/site) is a fairly complicated webapp
|
||||
written in Rust. As such it makes for a fairly decent compile stress test. I'm
|
||||
going to do a compile test against my [Ryzen
|
||||
3600](https://christine.website/blog/nixos-desktop-flow-2020-04-25) with this M1
|
||||
MacBook Air.
|
||||
|
||||
My tower is running this version of Rust:
|
||||
|
||||
```
|
||||
$ rustc --version
|
||||
rustc 1.51.0-nightly (a62a76047 2021-01-13)
|
||||
```
|
||||
|
||||
My MacBook is running this version of Rust:
|
||||
|
||||
```
|
||||
$ rustc --version
|
||||
rustc 1.50.0 (cb75ad5db 2021-02-10)
|
||||
```
|
||||
|
||||
Building a development build my Ryzen gets this:
|
||||
|
||||
```
|
||||
Finished dev [unoptimized + debuginfo] target(s) in 1m 00s
|
||||
```
|
||||
|
||||
Doing the same development build, my M1 MacBook Air gets this:
|
||||
|
||||
```
|
||||
Finished dev [unoptimized + debuginfo] target(s) in 1m 03s
|
||||
```
|
||||
|
||||
And the MacBook didn't even get warm.
|
||||
|
||||
Everything I have thrown at this seems to get about the same results. This 15
|
||||
watt laptop chip holds its own with desktop machines. I can only imagine how
|
||||
this will proceed as Apple advances their processor technology.
|
||||
|
||||
## Apps
|
||||
|
||||
With the exception of virtual machines, the M1 MacBook Air runs nearly
|
||||
everything I need it to. I have a Go compiler, Rust compiler, Nix, Discord,
|
||||
Slack, Telegram, text editor, image editors, chat clients and more. Some of that
|
||||
software is running in Rosetta and I am not able to tell when that is the case.
|
||||
|
||||
The biggest thing that doesn't run properly on here is Emacs. I am able to get a
|
||||
version of it via Rosetta, however there are weird hangs that will randomly eat
|
||||
up all my input while I am in flow. This is undesirable to say the least. I've
|
||||
been using the aarch64 build of VS Code for the meantime, however I am really
|
||||
missing the native Emacs experience. Maybe a future version of [Emacs for Mac OS
|
||||
X](https://emacsformacosx.com) will improve this (or even make a fully native
|
||||
aarch64 build).
|
||||
|
||||
Being able to run iPad and iPhone apps is also really nice. There's some
|
||||
constraints involved with having to emulate the touchscreen input, however
|
||||
overall it's enough to get the job done. I had to use
|
||||
[iMazing](https://imazing.com) to get installable versions of some apps I wanted
|
||||
to put on my mac (such as Skip The Dishes so I could get its notifications in
|
||||
the same place and Procreate so I could use Sidecar to draw using the M1's GPU
|
||||
power and extra ram), however they work well enough in general.
|
||||
|
||||
It would be nice if more companies toggled the "supported on M1 Macs" flag. I'm
|
||||
willing to use a degraded experience if it means it's easier to access things
|
||||
that are otherwise exclusive to my phone (such as Facebook and my banking app).
|
||||
It would be great to use Netflix without having to open Safari.
|
||||
|
||||
Something that really surprised me was how well Dolphin runs when you use a
|
||||
native build. I'm able to play Gamecube and Wii games at retina resolution and
|
||||
the MacBook doesn't even get warm to the touch. The amd64 version of Dolphin
|
||||
uses some Just-In-Time compilation that Rosetta can't emulate at all, however
|
||||
the aarch64 one runs a lot faster than it has any right to. It must be easier to
|
||||
translate binaries between RISC processor types or something. You have to build
|
||||
Dolphin from source when you do this, however it's worth it.
|
||||
|
||||
## The Hardware
|
||||
|
||||
I have written a depressing amount of this blog's content on a butterfly
|
||||
keyboard mac. The keyboard on the M1 Air is night and day better. It's like
|
||||
using an older MacBook keyboard without being forced to wear headphones to mask
|
||||
out the fan noise. I'm typing this in qwerty at the moment (I seem to have
|
||||
settled on being able to seamlessly switch between qwerty on laptop keyboards
|
||||
and Colemak Mod-DH on my Moonlander), but goddamn they really made the typing
|
||||
experience so much better. I wish I had this keyboard years ago.
|
||||
|
||||
My previous MacBook was a 12" early 2018 model. It had 16 GB of ram (though 8 of
|
||||
it failed and became unusable somehow) and chugged doing basic tasks. It had a
|
||||
dual core processor and ended up being practically unable to handle more than
|
||||
basic code compilation. I shudder to think about how long it would take to build
|
||||
my website code on that machine. It also got hot. Very hot. I didn't even have
|
||||
to push it very far to get it so hot. The battery also started to go sour by the
|
||||
end of me using it. Overall I think it was a good purchase and I've gotten a lot
|
||||
of mileage out of it, but this M1 Air is so much better it's not even funny.
|
||||
|
||||
## The Verdict
|
||||
|
||||
If you are looking for a machine that is silent, room temperature, and capable of
|
||||
doing anything you can throw at it, look into getting an Apple Silicon Mac. This
|
||||
first generation is going to have the most teething issues; so if you don't want
|
||||
to deal with the jank that comes with a first generation product I'd probably
|
||||
suggest waiting for the M2 or whatever they are going to call it. I know it's
|
||||
certainly worth it for me, but I am not you and my needs will be different from
|
||||
your needs.
|
||||
|
||||
This writeup was not sponsored in any way, Apple is not reviewing this post for
|
||||
content (and probably doesn't know that I made it). I am just a fan of this
|
||||
device and want to see aarch64 on the desktop succeed.
|
||||
|
|
@ -7,6 +7,9 @@ tags:
|
|||
- vim
|
||||
---
|
||||
|
||||
My Experience with Atom as A Vim User
|
||||
=====================================
|
||||
|
||||
Historically, I am a Vim user. People know me as a very very heavy vim
|
||||
user. I have spent almost the last two years customizing [my .vimrc
|
||||
file](https://github.com/Xe/dotfiles/blob/master/.vimrc) and I have parts
|
||||
|
|
|
|||
|
|
@ -1,227 +0,0 @@
|
|||
---
|
||||
title: "Goodbye Kubernetes"
|
||||
date: 2021-01-03
|
||||
---
|
||||
|
||||
Well, since I posted [that last post](/blog/k8s-pondering-2020-12-31) I have had
|
||||
an adventure. A good friend pointed out a server host that I had missed when I
|
||||
was looking for other places to use, and now I have migrated my blog to this new
|
||||
server. As of yesterday, I now run my website on a dedicated server in Finland.
|
||||
Here is the story of my journey to migrate 6 years of cruft and technical debt
|
||||
to this new server.
|
||||
|
||||
Let's talk about this goliath of a server. This server is an AX41 from Hetzner.
|
||||
It has 64 GB of ram, a 512 GB nvme drive, 3 2 TB drives, and a Ryzen 3600. For
|
||||
all practical concerns, this beast is beyond overkill and rivals my workstation
|
||||
tower in everything but the GPU power. I have named it `lufta`, which is the
|
||||
word for feather in [L'ewa](https://lewa.within.website/dictionary.html).
|
||||
|
||||
## Assimilation
|
||||
|
||||
For my server setup process, the first step it to assimilate it. In this step I
|
||||
get a base NixOS install on it somehow. Since I was using Hetzner, I was able to
|
||||
boot into a NixOS install image using the process documented
|
||||
[here](https://nixos.wiki/wiki/Install_NixOS_on_Hetzner_Online). Then I decided
|
||||
that it would also be cool to have this server use
|
||||
[zfs](https://en.wikipedia.org/wiki/ZFS) as its filesystem to take advantage of
|
||||
its legendary subvolume and snapshotting features.
|
||||
|
||||
So I wrote up a bootstrap system definition like the Hetzner tutorial said and
|
||||
ended up with `hosts/lufta/bootstrap.nix`:
|
||||
|
||||
```nix
|
||||
{ pkgs, ... }:
|
||||
|
||||
{
|
||||
services.openssh.enable = true;
|
||||
users.users.root.openssh.authorizedKeys.keys = [
|
||||
"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIPg9gYKVglnO2HQodSJt4z4mNrUSUiyJQ7b+J798bwD9 cadey@shachi"
|
||||
];
|
||||
|
||||
networking.usePredictableInterfaceNames = false;
|
||||
systemd.network = {
|
||||
enable = true;
|
||||
networks."eth0".extraConfig = ''
|
||||
[Match]
|
||||
Name = eth0
|
||||
[Network]
|
||||
# Add your own assigned ipv6 subnet here here!
|
||||
Address = 2a01:4f9:3a:1a1c::/64
|
||||
Gateway = fe80::1
|
||||
# optionally you can do the same for ipv4 and disable DHCP (networking.dhcpcd.enable = false;)
|
||||
Address = 135.181.162.99/26
|
||||
Gateway = 135.181.162.65
|
||||
'';
|
||||
};
|
||||
|
||||
boot.supportedFilesystems = [ "zfs" ];
|
||||
|
||||
environment.systemPackages = with pkgs; [ wget vim zfs ];
|
||||
}
|
||||
```
|
||||
|
||||
Then I fired up the kexec tarball and waited for the server to boot into a NixOS
|
||||
live environment. A few minutes later I was in. I started formatting the drives
|
||||
according to the [NixOS install
|
||||
guide](https://nixos.org/manual/nixos/stable/index.html#sec-installation) with
|
||||
one major difference: I added a `/boot` ext4 partition on the SSD. This allows
|
||||
me to have the system root device on zfs. I added the disks to a `raidz1` pool
|
||||
and created a few volumes. I also added the SSD as a log device so I get SSD
|
||||
caching.
|
||||
|
||||
From there I installed NixOS as normal and rebooted the server. It booted
|
||||
normally. I had a shiny new NixOS server in the cloud! I noticed that the server
|
||||
had booted into NixOS unstable as opposed to NixOS 20.09 like my other nodes. I
|
||||
thought "ah, well, that probably isn't a problem" and continued to the
|
||||
configuration step.
|
||||
|
||||
[That's ominous...](conversation://Mara/hmm)
|
||||
|
||||
## Configuration
|
||||
|
||||
Now that the server was assimilated and I could SSH into it, the next step was
|
||||
to configure it to run my services. While I was waiting for Hetzner to provision
|
||||
my server I ported a bunch of my services over to Nixops services [a-la this
|
||||
post](/blog/nixops-services-2020-11-09) in [this
|
||||
folder](https://github.com/Xe/nixos-configs/tree/master/common/services) of my
|
||||
configs repo.
|
||||
|
||||
Now that I had them, it was time to add this server to my Nixops setup. So I
|
||||
opened the [nixops definition
|
||||
folder](https://github.com/Xe/nixos-configs/tree/master/nixops/hexagone) and
|
||||
added the metadata for `lufta`. Then I added it to my Nixops deployment with
|
||||
this command:
|
||||
|
||||
```console
|
||||
$ nixops modify -d hexagone -n hexagone *.nix
|
||||
```
|
||||
|
||||
Then I copied over the autogenerated config from `lufta`'s `/etc/nixos/` folder
|
||||
into
|
||||
[`hosts/lufta`](https://github.com/Xe/nixos-configs/tree/master/hosts/lufta) and
|
||||
ran a `nixops deploy` to add some other base configuration.
|
||||
|
||||
## Migration
|
||||
|
||||
Once that was done, I started enabling my services and pushing configs to test
|
||||
them. After I got to a point where I thought things would work I opened up the
|
||||
Kubernetes console and started deleting deployments on my kubernetes cluster as
|
||||
I felt "safe" to migrate them over. Then I saw the deployments come back. I
|
||||
deleted them again and they came back again.
|
||||
|
||||
Oh, right. I enabled that one Kubernetes service that made it intentionally hard
|
||||
to delete deployments. One clever set of scale-downs and kills later and I was
|
||||
able to kill things with wild abandon.
|
||||
|
||||
I copied over the gitea data with `rsync` running in the kubernetes deployment.
|
||||
Then I killed the gitea deployment, updated DNS and reran a whole bunch of gitea
|
||||
jobs to resanify the environment. I did a test clone on a few of my repos and
|
||||
then I deleted the gitea volume from DigitalOcean.
|
||||
|
||||
Moving over the other deployments from Kubernetes into NixOS services was
|
||||
somewhat easy, however I did need to repackage a bunch of my programs and static
|
||||
sites for NixOS. I made the
|
||||
[`pkgs`](https://github.com/Xe/nixos-configs/tree/master/pkgs) tree a bit more
|
||||
fleshed out to compensate.
|
||||
|
||||
[Okay, packaging static sites in NixOS is beyond overkill, however a lot of them
|
||||
need some annoyingly complicated build steps and throwing it all into Nix means
|
||||
that we can make them reproducible and use one build system to rule them
|
||||
all. Not to mention that when I need to upgrade the system, everything will
|
||||
rebuild with new system libraries to avoid the <a
|
||||
href="https://blog.tidelift.com/bit-rot-the-silent-killer">Docker bitrot
|
||||
problem</a>.](conversation://Mara/hacker)
|
||||
|
||||
## Reboot Test
|
||||
|
||||
After a significant portion of the services were moved over, I decided it was
|
||||
time to do the reboot test. I ran the `reboot` command and then...nothing.
|
||||
My continuous ping test was timing out. My phone was blowing up with downtime
|
||||
messages from NodePing. Yep, I messed something up.
|
||||
|
||||
I was able to boot the server back into a NixOS recovery environment using the
|
||||
kexec trick, and from there I was able to prove the following:
|
||||
|
||||
- The zfs setup is healthy
|
||||
- I can read some of the data I migrated over
|
||||
- I can unmount and remount the ZFS volumes repeatedly
|
||||
|
||||
I was confused. This shouldn't be happening. After half an hour of
|
||||
troubleshooting, I gave in and ordered an IPKVM to be installed in my server.
|
||||
|
||||
Once that was set up (and I managed to trick MacOS into letting me boot a .jnlp
|
||||
web start file), I rebooted the server so I could see what error I was getting
|
||||
on boot. I missed it the first time around, but on the second time I was able to
|
||||
capture this screenshot:
|
||||
|
||||
|
||||
|
||||
Then it hit me. I did the install on NixOS unstable. My other servers use NixOS
|
||||
20.09. I had downgraded zfs and the older version of zfs couldn't mount the
|
||||
volume created by the newer version of zfs in read/write mode. One more trip to
|
||||
the recovery environment later to install NixOS unstable in a new generation.
|
||||
|
||||
Then I switched my tower's default NixOS channel to the unstable channel and ran
|
||||
`nixops deploy` to reactivate my services. After the NodePing uptime
|
||||
notifications came in, I ran the reboot test again while looking at the console
|
||||
output to be sure.
|
||||
|
||||
It booted. It worked. I had a stable setup. Then I reconnected to IRC and passed
|
||||
out.
|
||||
|
||||
## Services Migrated
|
||||
|
||||
Here is a list of all of the services I have migrated over from my old dedicated
|
||||
server, my kubernetes cluster and my dokku server:
|
||||
|
||||
- aerial -> discord chatbot
|
||||
- goproxy -> go modules proxy
|
||||
- lewa -> https://lewa.within.website
|
||||
- hlang -> https://h.christine.website
|
||||
- mi -> https://mi.within.website
|
||||
- printerfacts -> https://printerfacts.cetacean.club
|
||||
- xesite -> https://christine.website
|
||||
- graphviz -> https://graphviz.christine.website
|
||||
- idp -> https://idp.christine.website
|
||||
- oragono -> ircs://irc.within.website:6697/
|
||||
- tron -> discord bot
|
||||
- withinbot -> discord bot
|
||||
- withinwebsite -> https://within.website
|
||||
- gitea -> https://tulpa.dev
|
||||
- other static sites
|
||||
|
||||
Doing this migration is a bit of an archaeology project as well. I was
|
||||
continuously discovering services that I had littered over my machines with very
|
||||
poorly documented requirements and configuration. I hope that this move will let
|
||||
the next time I do this kind of migration be a lot easier by comparison.
|
||||
|
||||
I still have a few other services to move over, however the ones that are left
|
||||
are much more annoying to set up properly. I'm going to get to deprovision 5
|
||||
servers in this migration and as a result get this stupidly powerful goliath of
|
||||
a server to do whatever I want with and I also get to cut my monthly server
|
||||
costs by over half.
|
||||
|
||||
I am very close to being able to turn off the Kubernetes cluster and use NixOS
|
||||
for everything. A few services that are still on the Kubernetes cluster are
|
||||
resistant to being nixified, so I may have to use the Docker containers for
|
||||
that. I was hoping to be able to cut out Docker entirely, however we don't seem
|
||||
to be that lucky yet.
|
||||
|
||||
Sure, there is some added latency with the server being in Europe instead of
|
||||
Montreal, however if this ever becomes a practical issue I can always launch a
|
||||
cheap DigitalOcean VPS in Toronto to act as a DNS server for my WireGuard setup.
|
||||
|
||||
Either way, I am now off Kubernetes for my highest traffic services. If services
|
||||
of mine need to use the disk, they can now just use the disk. If I really care
|
||||
about the data, I can add the service folders to the list of paths to back up to
|
||||
`rsync.net` (I have a post about how this backup process works in the drafting
|
||||
stage) via [borgbackup](https://www.borgbackup.org/).
|
||||
|
||||
Let's hope it stays online!
|
||||
|
||||
---
|
||||
|
||||
Many thanks to [Graham Christensen](https://twitter.com/grhmc), [Dave
|
||||
Anderson](https://twitter.com/dave_universetf) and everyone else who has been
|
||||
helping me along this journey. I would be lost without them.
|
||||
|
|
@ -6,6 +6,8 @@ tags:
|
|||
- shell
|
||||
---
|
||||
|
||||
# The Beautiful in the Ugly
|
||||
|
||||
Functional programming is nice and all, but sometimes you just need to have
|
||||
things get done regardless of the consequences. Sometimes a dirty little hack
|
||||
will suffice in place of a branching construct. This is a story of one of these
|
||||
|
|
|
|||
|
|
@ -6,6 +6,9 @@ tags:
|
|||
- beego
|
||||
---
|
||||
|
||||
Web Application Development with Beego
|
||||
======================================
|
||||
|
||||
Beego is a fantastic web application framework from the Go China
|
||||
community. It currently powers some of the biggest websites in China,
|
||||
and thus the world.
|
||||
|
|
|
|||
|
|
@ -1,191 +0,0 @@
|
|||
---
|
||||
title: "My Next Life as an Imaginary Bottle of Window Cleaner"
|
||||
date: 2021-09-24
|
||||
author: Mai
|
||||
tags:
|
||||
- isekai
|
||||
- fiction
|
||||
---
|
||||
|
||||
Today was another boring day, like all the other boring days. I was almost done
|
||||
with my commute to the office, not looking forward to spending another day
|
||||
working on the same spreadsheet. I don't believe in monsters, ghosts or spirits,
|
||||
but I do believe that thing is haunted.
|
||||
|
||||
"Next stop is Broughton Junction, end of the line!"
|
||||
|
||||
That was my stop. I thought I got it easy by getting an apartment right next to
|
||||
the train, but I never thought that my job would move so far away. I got up with
|
||||
the others and walked my way to the exit of the station. The crowd was lifeless
|
||||
and dead today. The usual morning rush of the station I got on the train at had
|
||||
turned into a lazy slump towards the exit.
|
||||
|
||||
The only solace from these doldrums was the barista at the coffee shop by the
|
||||
doors. She had such a lovely smile; sometimes it was the only thing that kept me
|
||||
going. _I wonder what her name is_, I thought to myself as I breached the
|
||||
darkness of the station and was enveloped in the light of the outside world.
|
||||
Nubypool was the financial hub of the province. My work was in the Ministry of
|
||||
Accounting, taming the beast that was their spreadsheets. As I walked towards
|
||||
the entrance of the building I looked around, seeing the gray, drab skyscrapers
|
||||
around me sully the lively deep blue above them.
|
||||
|
||||
I crossed the street and walked to the double doors, but then there was a noise.
|
||||
I looked up and saw something falling towards me, then suddenly there was a loud
|
||||
noise and everything went dark.
|
||||
|
||||
The darkness persisted for a while, I couldn't touch, see or hear myself. I was
|
||||
alone in a silent hell with only my thoughts to break the sheer emptiness of it
|
||||
all. Suddenly, it hit me. _I'm dead, aren't I? I'm never going to get that
|
||||
barista's number, am I?_
|
||||
|
||||
A noise filled my awareness. I couldn't recognize it, but it came with a
|
||||
friendly presence. It felt like my best friend, mother, and more all in one. I
|
||||
felt like I knew this person intimately even though we had never spoken before.
|
||||
I could pick out that there were words, but nothing usable other than that.
|
||||
|
||||
The words stopped after a while, and that was the saddest part of the whole
|
||||
thing. I was so alone without the words, but I didn't feel like I had any
|
||||
control over when they started. They started and stopped without any indication
|
||||
of where or when they were coming from.
|
||||
|
||||
Then they started again and I knew that I needed to capitalize on this. The
|
||||
voice was going to go away if I didn't do anything about it. All I could do was
|
||||
think, so I decided to think as loud and hard as I could. I screamed in my mind.
|
||||
I would have woke the neighbors if this was in the apartment back home. Those
|
||||
thin walls would have made the entire floor wake up. I shouted and shouted like
|
||||
my life depended on it. As I shouted and screamed the darkness started to gain
|
||||
color. There was a small pinhole of light that expanded and filled my awareness
|
||||
until it grew to everywhere I could see. _Is this reincarnation?_
|
||||
|
||||
As if a blindfold had been lifted, I could finally get to see myself in some
|
||||
level of detail. I looked down and all I saw was a bright poster with what
|
||||
looked like words on it. I looked behind me and I saw what appeared to be a
|
||||
poster with more smaller words. I looked to the sides and saw what appeared to
|
||||
be clear plastic with a blue liquid in it.
|
||||
|
||||
I started panicking. I didn't know what was going on. _Aren't I supposed to be
|
||||
some kind of animal? Why am I this?_
|
||||
|
||||
The voice started again, a lot more clearly. I could pick out the words: "So
|
||||
_that's_ why they call it a 'head pressure'! Wow I don't even know how to
|
||||
describe this feeling other than that!"
|
||||
|
||||
I looked ahead and I saw a young boy, something like 18 years old. I was in some
|
||||
kind of small apartment. There was a ritual circle of some kind, I was right in
|
||||
the middle of it. Looking around there was a pentagram made out of a white and
|
||||
blue powder, cards I've never seen before and a bottle of red liquid. There was
|
||||
a mirror to the side of me though. I took a long and detailed look at myself.
|
||||
|
||||
I saw an orange nozzle look back at me. There was what appeared to be a handle
|
||||
under the nozzle, looking like it was screwed on top of a bottle of...
|
||||
|
||||
_No, this can't be!_
|
||||
|
||||
It was screwed on top of a bottle of window cleaner.
|
||||
|
||||
"I'M A BOTTLE OF WINDOW CLEANER????"
|
||||
|
||||
The boy in front of me winced and grunted, my shouting must have hurt him. I
|
||||
suddenly got a feeling of fear washing over me. I felt the tip of my nozzle
|
||||
screw itself shut and my self-image vanished from the mirror. Had I interrupted
|
||||
the ritual?
|
||||
|
||||
The boy composed himself and looked down at me. "So, you're the succubus I
|
||||
summoned? What's wrong with you?"
|
||||
|
||||
"S...succubus? I'm not a succubus, I could swear that a few days ago I was...
|
||||
well not this. I don't know what I am other than apparently..."
|
||||
|
||||
I tried to gesture at my own body but only ended up making my handle flail about
|
||||
meaninglessly, spraying a bit of blue fluid out of my nozzle. It felt like it
|
||||
had come out of my mouth. It had no taste initially, but it left a slightly sour
|
||||
taste after a moment.
|
||||
|
||||
"A bottle of window cleaner??"
|
||||
|
||||
"...What. How did this happen?"
|
||||
|
||||
"Why are you asking me? You apparently summoned me. What did you expect to get?"
|
||||
|
||||
The boy looked at me like I had lobsters crawling out of my ears. Assuming I had
|
||||
ears that were big enough for lobsters crawling out of them that is.
|
||||
|
||||
"I...what...how...okay"
|
||||
|
||||
There was suddenly a knock at the door. "SHIT!", the boy said to himself without
|
||||
saying it. He started scrambling around and frantically trying to clean things.
|
||||
|
||||
He swept up the white powder and put away the playing cards, but try as he might
|
||||
he couldn't grab me to put me away. His hand phased through me like I wasn't
|
||||
there. He got up and let the other person in. It was a pizza delivery person.
|
||||
The boy handed over some money and then took the pizza and placed it on top of a
|
||||
clear spot of his desk.
|
||||
|
||||
I suddenly found myself on top of a metal surface. I could feel something
|
||||
spinning under me and heard the soft hum of an idle fan. I had just teleported
|
||||
across the room. "W..what, why am I here?"
|
||||
|
||||
"I didn't...know that would do anything. I thought it would be nice if you were
|
||||
on top of my computer and you just appeared there." Another knock came at the
|
||||
door. There was a female voice.
|
||||
|
||||
"Shit, play it cool."
|
||||
|
||||
"I don't know how I can do anything other than what I am doing now, but okay."
|
||||
|
||||
A woman entered the room. She appeared to be in a very skimpy outfit, showing
|
||||
off her curves. She also seemed to have a pair of demonic looking wings that she
|
||||
let open in the middle of the room. The boy awkwardly made conversation with her
|
||||
for a while. I tried to get the boy's attention by spraying at him. I definitely
|
||||
got his attention. "What're you looking at, roomie? Aren't you gonna give your
|
||||
poor roomie some pizza?"
|
||||
|
||||
I didn't think she could see me. I tried spraying more. The boy looked over at
|
||||
me angrily. "Cut it out bottle, I'll throw you out with the trash if you keep
|
||||
that up!"
|
||||
|
||||
"What are you talking about? I'm not a bottle, I'm hungry." She walked over to
|
||||
the pizza and grabbed a slice, pushing the boy into his desk. She looked dead at
|
||||
me when she had her slice. I don't think she saw me. She turned around and
|
||||
bumped one of her wings into the boy, causing them to fall off. "Nooo! My
|
||||
costume!"
|
||||
|
||||
"That's what you get for wearing a succubus costume in a dorm hall."
|
||||
|
||||
She stuck her tongue out sarcastically at the boy and picked up her wing. "Okay
|
||||
sarcasm boy, you're gonna help me get this on~. If you do I may have a fun time
|
||||
planned for you~."
|
||||
|
||||
"I know what you're planning Mike. I'm not going to bang you. We agreed that I
|
||||
wouldn't before you did this."
|
||||
|
||||
"No fun."
|
||||
|
||||
Her name is _Mike_? I thought about it and decided that it was better to leave
|
||||
things be.
|
||||
|
||||
"Hey, dude, I don't really know what's going on. Where am I? Who am I? What am
|
||||
I? Are you just gonna keep me in the dark about all of this?" I tried to direct
|
||||
this to the boy with a burst of energy, spraying him to be sure I got his
|
||||
attention.
|
||||
|
||||
He looked over at me like I was cock-blocking him. I felt myself blush and
|
||||
backed off. It looks like there would be plenty of time later to get those
|
||||
questions answered.
|
||||
|
||||
"Hey Conner, when are you going to get into your costume? Did the ritual I gave
|
||||
you work?"
|
||||
|
||||
"Yeah...about that..."
|
||||
|
||||
---
|
||||
|
||||
Elsewhere at a random cleaning product factory, it was business as usual. The
|
||||
production lines were running smoothly. The trucks of cleaner continued as
|
||||
normal and every bottle was being filled at the normal rate.
|
||||
|
||||
A woman in a skimpy outfit suddenly appeared on the production line, causing one
|
||||
of the workers to hit the "emergency stop" button. The woman had a demonic aura
|
||||
about her. Her bewitching gaze stunned the factory floor. She got off the
|
||||
production line and walked out of the building, with that worker in tow;
|
||||
seemingly enamored with her. _This is going to be fun~_, she thought to herself.
|
||||
|
|
@ -4,6 +4,8 @@ date: 2018-11-29
|
|||
series: conlangs
|
||||
---
|
||||
|
||||
# Blind Men and an Elephant
|
||||
|
||||
or
|
||||
|
||||
# le'i ka na viska kakne ku e le xanto
|
||||
|
|
|
|||
|
|
@ -7,6 +7,8 @@ tags:
|
|||
- 100th-post
|
||||
---
|
||||
|
||||
# Blog Feature: Art Gallery
|
||||
|
||||
I have just implemented support for my portfolio site to also function as an art
|
||||
gallery. See all of my posted art [here](/gallery).
|
||||
|
||||
|
|
|
|||
|
|
@ -1,176 +0,0 @@
|
|||
---
|
||||
title: "How to Set Up Borg Backup on NixOS"
|
||||
date: 2021-01-09
|
||||
series: howto
|
||||
tags:
|
||||
- nixos
|
||||
- borgbackup
|
||||
---
|
||||
|
||||
[Borg Backup](https://www.borgbackup.org/) is a encrypted, compressed,
|
||||
deduplicated backup program for multiple platforms including Linux. This
|
||||
combined with the [NixOS options for configuring
|
||||
Borg Backup](https://search.nixos.org/options?channel=20.09&show=services.borgbackup.jobs.%3Cname%3E.paths&from=0&size=30&sort=relevance&query=services.borgbackup.jobs)
|
||||
allows you to backup on a schedule and restore from those backups when you need
|
||||
to.
|
||||
|
||||
Borg Backup works with local files, remote servers and there are even [cloud
|
||||
hosts](https://www.borgbackup.org/support/commercial.html) that specialize in
|
||||
hosting your backups. In this post we will cover how to set up a backup job on a
|
||||
server using [BorgBase](https://www.borgbase.com/)'s free tier to host the
|
||||
backup files.
|
||||
|
||||
## Setup
|
||||
|
||||
You will need a few things:
|
||||
|
||||
- A free BorgBase account
|
||||
- A server running NixOS
|
||||
- A list of folders to back up
|
||||
- A list of folders to NOT back up
|
||||
|
||||
First, we will need to create a SSH key for root to use when connecting to
|
||||
BorgBase. Open a shell as root on the server and make a `borgbackup` folder in
|
||||
root's home directory:
|
||||
|
||||
```shell
|
||||
mkdir borgbackup
|
||||
cd borgbackup
|
||||
```
|
||||
|
||||
Then create a SSH key that will be used to connect to BorgBase:
|
||||
|
||||
```shell
|
||||
ssh-keygen -f ssh_key -t ed25519 -C "Borg Backup"
|
||||
```
|
||||
|
||||
Ignore the SSH key password because at this time the automated Borg Backup job
|
||||
doesn't allow the use of password-protected SSH keys.
|
||||
|
||||
Now we need to create an encryption passphrase for the backup repository. Run
|
||||
this command to generate one using [xkcdpass](https://pypi.org/project/xkcdpass/):
|
||||
|
||||
```shell
|
||||
nix-shell -p python39Packages.xkcdpass --run 'xkcdpass -n 12' > passphrase
|
||||
```
|
||||
|
||||
[You can do whatever you want to generate a suitable passphrase, however
|
||||
xkcdpass is proven to be <a href="https://xkcd.com/936/">more random</a> than
|
||||
most other password generators.](conversation://Mara/hacker)
|
||||
|
||||
## BorgBase Setup
|
||||
|
||||
Now that we have the basic requirements out of the way, let's configure BorgBase
|
||||
to use that SSH key. In the BorgBase UI click on the Account tab in the upper
|
||||
right and open the SSH key management window. Click on Add Key and paste in the
|
||||
contents of `./ssh_key.pub`. Name it after the hostname of the server you are
|
||||
working on. Click Add Key and then go back to the Repositories tab in the upper
|
||||
right.
|
||||
|
||||
Click New Repo and name it after the hostname of the server you are working on.
|
||||
Select the key you just created to have full access. Choose the region of the
|
||||
backup volume and then click Add Repository.
|
||||
|
||||
On the main page copy the repository path with the copy icon next to your
|
||||
repository in the list. You will need this below. Attempt to SSH into the backup
|
||||
repo in order to have ssh recognize the server's host key:
|
||||
|
||||
```shell
|
||||
ssh -i ./ssh_key o6h6zl22@o6h6zl22.repo.borgbase.com
|
||||
```
|
||||
|
||||
Then accept the host key and press control-c to terminate the SSH connection.
|
||||
|
||||
## NixOS Configuration
|
||||
|
||||
In your `configuration.nix` file, add the following block:
|
||||
|
||||
```nix
|
||||
services.borgbackup.jobs."borgbase" = {
|
||||
paths = [
|
||||
"/var/lib"
|
||||
"/srv"
|
||||
"/home"
|
||||
];
|
||||
exclude = [
|
||||
# very large paths
|
||||
"/var/lib/docker"
|
||||
"/var/lib/systemd"
|
||||
"/var/lib/libvirt"
|
||||
|
||||
# temporary files created by cargo and `go build`
|
||||
"**/target"
|
||||
"/home/*/go/bin"
|
||||
"/home/*/go/pkg"
|
||||
];
|
||||
repo = "o6h6zl22@o6h6zl22.repo.borgbase.com:repo";
|
||||
encryption = {
|
||||
mode = "repokey-blake2";
|
||||
passCommand = "cat /root/borgbackup/passphrase";
|
||||
};
|
||||
environment.BORG_RSH = "ssh -i /root/borgbackup/ssh_key";
|
||||
compression = "auto,lzma";
|
||||
startAt = "daily";
|
||||
};
|
||||
```
|
||||
|
||||
Customize the paths and exclude lists to your needs. Once you are satisfied,
|
||||
rebuild your NixOS system using `nixos-rebuild`:
|
||||
|
||||
```shell
|
||||
nixos-rebuild switch
|
||||
```
|
||||
|
||||
And then you can fire off an initial backup job with this command:
|
||||
|
||||
```shell
|
||||
systemctl start borgbackup-job-borgbase.service
|
||||
```
|
||||
|
||||
Monitor the job with this command:
|
||||
|
||||
```shell
|
||||
journalctl -fu borgbackup-job-borgbase.service
|
||||
```
|
||||
|
||||
The first backup job will always take the longest to run. Every incremental
|
||||
backup after that will get smaller and smaller. By default, the system will
|
||||
create new backup snapshots every night at midnight local time.
|
||||
|
||||
## Restoring Files
|
||||
|
||||
To restore files, first figure out when you want to restore the files from.
|
||||
NixOS includes a wrapper script for each Borg job you define. you can mount your
|
||||
backup archive using this command:
|
||||
|
||||
```
|
||||
mkdir mount
|
||||
borg-job-borgbase mount o6h6zl22@o6h6zl22.repo.borgbase.com:repo ./mount
|
||||
```
|
||||
|
||||
Then you can explore the backup (and with it each incremental snapshot) to
|
||||
your heart's content and copy files out manually. You can look through each
|
||||
folder and copy out what you need.
|
||||
|
||||
When you are done you can unmount it with this command:
|
||||
|
||||
```
|
||||
borg-job-borgbase umount /root/borgbase/mount
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
And that's it! You can get more fancy with nixops using a setup [like
|
||||
this](https://github.com/Xe/nixos-configs/blob/master/common/services/backup.nix).
|
||||
In general though, you can get away with this setup. It may be a good idea to
|
||||
copy down the encryption passphrase onto paper and put it in a safe space like a
|
||||
safety deposit box.
|
||||
|
||||
For more information about Borg Backup on NixOS, see [the relevant chapter of
|
||||
the NixOS
|
||||
manual](https://nixos.org/manual/nixos/stable/index.html#module-borgbase) or
|
||||
[the list of borgbackup
|
||||
options](https://search.nixos.org/options?channel=20.09&query=services.borgbackup.jobs)
|
||||
that you can pick from.
|
||||
|
||||
I hope this is able to help.
|
||||
|
|
@ -7,6 +7,8 @@ tags:
|
|||
- blender
|
||||
---
|
||||
|
||||
# How I Converted my Brain fMRI to a 3D Model
|
||||
|
||||
AUTHOR'S NOTE: I just want to start this out by saying I am not an expert, and
|
||||
nothing in this blogpost should be construed as medical advice. I just wanted
|
||||
to see what kind of pretty pictures I could get out of an fMRI data file.
|
||||
|
|
|
|||
|
|
@ -1,105 +0,0 @@
|
|||
---
|
||||
title: You Win, Broken Database Schemas
|
||||
date: 2022-01-10
|
||||
tags:
|
||||
- rant
|
||||
---
|
||||
|
||||
There is [no software that correctly handles
|
||||
names](https://www.kalzumeus.com/2010/06/17/falsehoods-programmers-believe-about-names/)
|
||||
that exists on this planet. One of the major things I have bashed my head into
|
||||
as of late is the assumption that people have a first and a last name. The first
|
||||
name is usually what identifies the person, and the last name usually identifies
|
||||
the family.
|
||||
|
||||
I have wanted to use `Xe` as my name places (no last name, like Socrates), but
|
||||
everyone has broken database schemas that make it impossible. These schemas
|
||||
usually look like this:
|
||||
|
||||
```sql
|
||||
CREATE TABLE IF NOT EXISTS people
|
||||
( id VARCHAR PRIMARY KEY DEFAULT (uuid4())
|
||||
, first_name VARCHAR NOT NULL
|
||||
, last_name VARCHAR NOT NULL
|
||||
-- draw the rest of the owl
|
||||
);
|
||||
```
|
||||
|
||||
And as a result things like `Xe` (no last name) cannot fit into this schema. I
|
||||
have found out the depth of this shitshow while trying to use my handle as my
|
||||
name on newly registered account things and the amount of stuff that breaks or
|
||||
works in weird ways is _staggering_. Email salutations look like this:
|
||||
|
||||
> Hello Xe ,
|
||||
|
||||
Forms will break if I don't put a last name in the field. The assumptions about
|
||||
names are _so deep_ that it's rapidly becoming not worth it to only have my name
|
||||
as `Xe`. Not to mention [overzealous journalists that will argue with you over
|
||||
what your name is due to name
|
||||
collisions](https://twitter.com/theprincessxena/status/1479197000667181061?s=20).
|
||||
|
||||
You win, broken database schemas. I give up trying to deal with you to encode my
|
||||
name correctly. You just don't let me and I am tired of fighting it, opening
|
||||
support tickets and arguing with people over what my name is. I give in. I'm
|
||||
going to use a last name for my handle, which is absolutely ridiculous, but here
|
||||
we are.
|
||||
|
||||
It took me a few hours to dig through ideas over the weekend and today, but I
|
||||
think I have found something satisfactory enough that I can keep it for the long
|
||||
haul: [Iaso](https://en.wikipedia.org/wiki/Iaso) (ai-uh-so, /aɪ.ə.soʊ/), the
|
||||
minor Greek goddess of recovering from illness.
|
||||
|
||||
Hopefully I don't have to deal with professional issues as a result of me trying
|
||||
to be more true to myself about my identity. At the very least I want very
|
||||
little to do with the last name that I was born into. Some day that name will be
|
||||
removed from the last database with it set, but today is not that day.
|
||||
|
||||
If you work on systems that handle names, please, please, please take the time
|
||||
to reconsider if you actually need to deal with a last name for more reason than
|
||||
it's the cultural standard. There are valid reasons to have a mononym, and by
|
||||
supporting mononyms you will make people's lives easier.
|
||||
|
||||
Until then, I am `Xe Iaso`. Let's see where this phase of the identity
|
||||
experiment goes. It's still really complicated. Anyone who claims to have their
|
||||
identity figured out is either in denial or stopped digging into it for the time
|
||||
being. The rabbit hole truly never ends.
|
||||
|
||||
The main thing I don't like about this name is how ambiguous it shows up in
|
||||
sans-serif fonts:
|
||||
|
||||
<div style="font-family:sans-serif">
|
||||
|
||||
Xe Iaso
|
||||
|
||||
</div>
|
||||
|
||||
It looks like `Xe laso`. I've edited my email signature to try and compensate
|
||||
for this:
|
||||
|
||||
```
|
||||
Xe Iaso (zi ai-uh-so)
|
||||
https://christine.website
|
||||
|
||||
.i la budza pu cusku lu
|
||||
<<.i ko snura .i ko kanro
|
||||
.i ko panpi .i ko gleki
|
||||
```
|
||||
|
||||
Let's see if that helps. It will probably look bad when things are put into
|
||||
sans-serif fonts, but what can you do lol.
|
||||
|
||||
---
|
||||
|
||||
Also I would _prefer_ you call me `Xe` from now on when possible. This conflicts
|
||||
with and supercedes suggestions I made in [this article](/blog/xe-2021-08-07). I
|
||||
consider most of that experiment to have worked out and I am going into the next
|
||||
phase, albeit less "pure" than I wanted.
|
||||
|
||||
Thank you for sticking with this blog. This started out as a place for me to get
|
||||
better at writing but has rapidly turned into something that has helped me
|
||||
explore my identity in ways that I never would have thought it would. Thanks for
|
||||
following the rabbit hole. Thank you for supporting me being more authentic to
|
||||
myself about who I am. Your support means more than you possibly will know.
|
||||
|
||||
I wonder if my SEO craft is strong enough to get me high on the list of google
|
||||
results for `Iaso`.
|
||||
|
|
@ -5,6 +5,8 @@ tags:
|
|||
- career
|
||||
---
|
||||
|
||||
# Advice to People Nurturing a Career in Computering
|
||||
|
||||
Computering, or making computers do things in exchange for money, can be a
|
||||
surprisingly hard field to break into as an outsider. There's lots of jargon,
|
||||
tool holy wars, flamewars about the "right" way to do things and a whole host
|
||||
|
|
|
|||
|
|
@ -1,115 +0,0 @@
|
|||
---
|
||||
title: Change
|
||||
date: 2021-10-20
|
||||
tags:
|
||||
- enby
|
||||
- trans
|
||||
---
|
||||
|
||||
[Content warning: this post talks about the transgender/nonbinary coming out of
|
||||
the closet experience. If you are not in the best headspace for that, feel free
|
||||
to skip this post until you're in a better headspace. This post isn't going to
|
||||
randomly vanish. It will be there when you're ready. There are some descriptions
|
||||
of subconscious body functions and bodily fluids that may gross some people
|
||||
out.](conversation://Cadey/enby)
|
||||
|
||||
Coming out as transgender/nonbinary to someone you care about one of the most
|
||||
terrifying things you can do. At least it feels that way, it feels like things
|
||||
are going to change and you'll lose that person. It can be gut-wrenching,
|
||||
especially for family.
|
||||
|
||||
For me the scariest part of this whole thing has been the change in how people
|
||||
see me. It can be a huge abrupt difference for some people, and the unknowns in
|
||||
how people will react to that can make you paralyzed with fear. So, let's look
|
||||
at change a little.
|
||||
|
||||
[Annoyingly, the same kinds of people that get upset about someone changing
|
||||
their name and pronouns for coming out as transgender/nonbinary are _instantly_
|
||||
and _immediately_ tolerant of someone changing their last name for marriage and
|
||||
"get used to it" almost instantly.](conversation://Cadey/facepalm)
|
||||
|
||||
Life is a constant change. Stop for a moment right now and feel your body. Feel
|
||||
how the pressure in your chest changes as your lungs subconsciously inhale and
|
||||
exhale. If you have a watch, look at the seconds hand (or equivalent digital
|
||||
display) and watch it tick forward for a bit. Change is constant, yet still
|
||||
continuously moving forward. Even though the change is happening though,
|
||||
everything is still roughly the same as it was before. Blood continues to move
|
||||
through your body, constantly cycling its oxygen with other parts, but it
|
||||
continues.
|
||||
|
||||
Coming out to my parents was one of the most terrifying things I have ever done.
|
||||
I was nervous beyond belief. I hardly ate that day I hit send. I turned off my
|
||||
phone after doing it and got lost in a game that I liked playing. The real
|
||||
reason it was so scary to me though is that I had already tried to come out to
|
||||
them in the past but I was shut down.
|
||||
|
||||
Middle school was rough for me. I don't really remember much of it (other than
|
||||
they banned high fives for "gang activity"), but that was when my parents found
|
||||
my diary app. I don't remember why they were going through my laptop (I grew up
|
||||
in one of _those_ kinds of Jesus freak households), but they found it somehow
|
||||
and my entries where I was questioning my gender came to their attention and
|
||||
they confronted me about it. I was not ready at all. I was completely blindsided
|
||||
by it. That attempt to come out failed and I was put into Christian
|
||||
"counseling". I was pushed deep back into the closet and I still have trouble
|
||||
writing down my thoughts in a journal to this day.
|
||||
|
||||
So that day I hit "send" on [the
|
||||
email](https://christine.website/blog/coming-out-2015-12-01) was mortally
|
||||
terrifying. All that fear from so long ago came raging up to the surface and I
|
||||
was left in a crying and vulnerable state. However it ended up being a good kind
|
||||
of cry, the healing kind.
|
||||
|
||||
My relationship with my parents (and later my siblings) has deteriorated since,
|
||||
and not just for religious differences. However, I am fine. I am still healing
|
||||
and I probably will be healing for a long time and I have accepted that. In
|
||||
place, I have found something more powerful to put in their place. I have found
|
||||
a new family of choice.
|
||||
|
||||
[For the parents that read this blog, please do not repeat this kind of
|
||||
suffering if you can avoid it. I don't want anyone else to suffer the way I have
|
||||
if I can help to avoid it.](conversation://Cadey/enby)
|
||||
|
||||
This was a huge change, but it ended up being for the better. That change was a
|
||||
tool to help me live a better life surrounded by the people I wanted to be
|
||||
around as opposed to the people I inherited.
|
||||
|
||||
There's an idiom that comes to mind, something that is in the "completely
|
||||
misunderstood" brand of idioms: "blood is thicker than water".
|
||||
It's often used by people to emphasize the importance of familial relationships
|
||||
over friendships or the like (family is the "blood" part of that idiom, and
|
||||
friendships are the "water" part). The full form of the idiom is closer to this:
|
||||
|
||||
> The blood of the covenant is thicker than the water of the womb
|
||||
|
||||
This overall sentiment is [commonly interpreted by Christian
|
||||
scholars](https://www.blueletterbible.org/Comm/murray_andrew/two/two09.cfm) to
|
||||
have a meaning closer to "the bond between Jesus and someone who chooses to
|
||||
believe in Him is stronger than the bond between family members", however we can
|
||||
afford to interpret this differently for the sake of this message.
|
||||
|
||||
The bonds you choose are stronger than the bonds you inherited. The bonds I have
|
||||
with my friends, my husband, my closest companions and all those who I keep
|
||||
close to me are stronger than the bonds with my family will ever be.
|
||||
|
||||
In a way, coming out as transgender to people and that level of associated
|
||||
change has become a _tool_ to help me figure out who really cares about me and
|
||||
who I should bother keeping around me. It's my life. I can live it as honestly,
|
||||
openly and real as I want to. I don't have to justify it to anyone but myself.
|
||||
|
||||
You don't really have to justify this level of change to anyone else but
|
||||
yourself either. It'll let you know who your real friends are, for better and
|
||||
for worse. You don't have to keep anyone around you that can't accept you for
|
||||
who you are. Your family of choice will _always_ have stronger bonds than your
|
||||
family of origin.
|
||||
|
||||
<center>
|
||||
<picture>
|
||||
<source srcset="/static/blog/change/the-dude-dither.avif" type="image/avif">
|
||||
<source srcset="/static/blog/change/the-dude-dither.webp" type="image/webp">
|
||||
<img src="/static/blog/change/the-dude-dither.png" alt="The dude abides">
|
||||
</picture>
|
||||
</center>
|
||||
|
||||
The Dude abides, so will you. Change as a result of coming out can be a good
|
||||
thing as much as it can be a bad thing. Don't let inherent negativity biases
|
||||
blind you to that.
|
||||
|
|
@ -5,6 +5,8 @@ thanks: CelestialBoon
|
|||
series: magick
|
||||
---
|
||||
|
||||
# Chaos Magick Debugging
|
||||
|
||||
Belief is a powerful thing. Beliefs are the foundations of everyone's points of view, and the way they interpret reality. Belief is what allows people to create the greatest marvels of technology, the most wondrous worlds of imagination, and the most oppressive religions.
|
||||
|
||||
But at the core, what *is* a belief, other than the sheer tautology of *what a person believes*?
|
||||
|
|
|
|||
|
|
@ -9,6 +9,8 @@ tags:
|
|||
- garlic
|
||||
---
|
||||
|
||||
# Chicken Stir Fry
|
||||
|
||||
This recipe was made up by me and my fiancé. We just sorta winged it every time
|
||||
we made it until we found something that was easy to cook and tasty. We make
|
||||
this every week or so.
|
||||
|
|
|
|||
|
|
@ -5,6 +5,9 @@ tags:
|
|||
- cinemaquestria
|
||||
---
|
||||
|
||||
CinemaQuestria Orchestration
|
||||
============================
|
||||
|
||||
### Or: Continuous Defenstration in a Container-based Ecosystem
|
||||
|
||||
I've been a core member of the staff for [CinemaQuestria](http://cinemaquestria.com)
|
||||
|
|
|
|||
|
|
@ -1,38 +0,0 @@
|
|||
---
|
||||
title: "Book Release: Closed Projects"
|
||||
date: 2022-03-24
|
||||
tags:
|
||||
- shortstory
|
||||
- fiction
|
||||
- retrospective
|
||||
---
|
||||
|
||||
Closed Projects is a retelling of [a four-part series](/blog/series/freenode) on
|
||||
my blog where I process the events that lead to the death of freenode, the
|
||||
largest IRC network for peer-directed projects.
|
||||
|
||||
freenode was the reason that I managed to get into tech. Without freenode I
|
||||
would be a vastly different person today. The death of freenode last year
|
||||
brought up many lingering memories and emotions. I talk about my history with
|
||||
freenode, the events that happened in the wake of its death and how a new
|
||||
community took its place.
|
||||
|
||||
Each part of this story is written by weaving the narrative of the last
|
||||
caretaker trying to protect the discussion halls against the darkness, and
|
||||
things continue as the darkness gets more crafty and clever.
|
||||
|
||||
I have included versions of this for all common eBook reader devices and
|
||||
formats. I have tested this on my Kindle Oasis and iPad Pro, but I see no reason
|
||||
that at least one of these formats wouldn't work for you.
|
||||
|
||||
<iframe frameborder="0" src="https://itch.io/embed/1454153?dark=true" width="552" height="167"><a href="https://withinstudios.itch.io/closed-projects">Closed Projects by Within</a></iframe>
|
||||
|
||||
If you are a [Patreon supporter](https://patreon.com/cadey), you can get this
|
||||
for free by clicking [this
|
||||
link](https://withinstudios.itch.io/closed-projects/patreon-access).
|
||||
|
||||
If you are a part of a marginalized group and cannot afford this but want to
|
||||
read it anyways, please [contact me](/contact).
|
||||
|
||||
Thank you for reading what I put out to the world. I only hope I can continue to
|
||||
create and inspire you.
|
||||
|
|
@ -1,478 +0,0 @@
|
|||
---
|
||||
title: My Magical Adventure With cloud-init
|
||||
date: 2021-06-04
|
||||
---
|
||||
|
||||
> "If I had a world of my own, everything would be nonsense. Nothing would be
|
||||
> what it is, because everything would be what it isn't. And contrary wise, what
|
||||
> is, it wouldn't be. And what it wouldn't be, it would. You see?"
|
||||
|
||||
- The Mad Hatter, Alice's Adventures in Wonderland
|
||||
|
||||
The modern cloud is a magical experience. You take a template, give it some SSH
|
||||
keys and maybe some user-data and then you have a server running somewhere. This
|
||||
is all powered by a tool called [cloud-init](https://cloud-init.io/). cloud-init
|
||||
is the most useful in actual datacenters with proper metadata services, but what
|
||||
if you aren't in a datacenter with a metadata service?
|
||||
|
||||
Recently I wanted to test a
|
||||
[script](https://github.com/tailscale/tailscale/blob/main/scripts/installer.sh)
|
||||
a coworker wrote that allows users to automatically install Tailscale on every
|
||||
distro and version Tailscale supports. I wanted to try and avoid having to
|
||||
install each version of every distribution manually, so I started looking for
|
||||
options.
|
||||
|
||||
[This may seem like overkill (and at some level it probably is), however as a
|
||||
side effect of going through this song and dance you can spin up a bunch of VMs
|
||||
pretty easily. <br /> <center> <blockquote class="twitter-tweet"><p lang="und"
|
||||
dir="ltr"><a
|
||||
href="https://t.co/yays27Wmes">pic.twitter.com/yays27Wmes</a></p>— Xe from
|
||||
Within (@theprincessxena) <a
|
||||
href="https://twitter.com/theprincessxena/status/1394265890494062593?ref_src=twsrc%5Etfw">May
|
||||
17, 2021</a></blockquote> <script async
|
||||
src="https://platform.twitter.com/widgets.js"
|
||||
charset="utf-8"></script> <center>](conversation://Mara/hacker)
|
||||
|
||||
cloud-init has a feature called the
|
||||
[NoCloud](https://cloudinit.readthedocs.io/en/latest/topics/datasources/nocloud.html)
|
||||
data source. To use it, you need to write two yaml files, put them into a
|
||||
specially named ISO file and then mount it to the virtual machine. cloud-init
|
||||
will then pick up your configuration data and apply it.
|
||||
|
||||
[Wait...really? What.](conversation://Mara/hmm)
|
||||
|
||||
[Yes, really.](conversation://Cadey/coffee)
|
||||
|
||||
Let's make an [Amazon Linux
|
||||
2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-linux-2-virtual-machine.html)
|
||||
virtual machine as an example. Amazon offers their Linux distribution for
|
||||
download so you can run it on-premises (I don't really know why you'd want to do
|
||||
this outside of testing stuff on Amazon Linux). In this blog we use KVM, so keep
|
||||
that in mind when you set things up yourself.
|
||||
|
||||
First you need to make a `meta-data` file, this will contain the VM's hostname
|
||||
and the "instance ID" (this makes sense in cloud contexts however you can use
|
||||
whatever you want):
|
||||
|
||||
```yaml
|
||||
local-hostname: mayhem
|
||||
instance-id: 31337
|
||||
```
|
||||
|
||||
[You can configure networking settings here, but our VM is going to get an
|
||||
address over DHCP so you don't really need to care about that in this case](conversation://Mara/hacker)
|
||||
|
||||
Next you need to make a `user-data` file, this will actually configure your VM:
|
||||
|
||||
```yaml
|
||||
#cloud-config
|
||||
#vim:syntax=yaml
|
||||
|
||||
cloud_config_modules:
|
||||
- runcmd
|
||||
|
||||
cloud_final_modules:
|
||||
- [users-groups, always]
|
||||
- [scripts-user, once-per-instance]
|
||||
|
||||
users:
|
||||
- name: xe
|
||||
groups: [ wheel ]
|
||||
sudo: [ "ALL=(ALL) NOPASSWD:ALL" ]
|
||||
shell: /bin/bash
|
||||
ssh-authorized-keys:
|
||||
- ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIPYr9hiLtDHgd6lZDgQMkJzvYeAXmePOrgFaWHAjJvNU cadey@ontos
|
||||
|
||||
write_files:
|
||||
- path: /etc/cloud/cloud.cfg.d/80_disable_network_after_firstboot.cfg
|
||||
content: |
|
||||
# Disable network configuration after first boot
|
||||
network:
|
||||
config: disabled
|
||||
```
|
||||
|
||||
Please make sure to change the username and swap out the SSH key as needed,
|
||||
unless you want to get locked out of your VM. For more information about what
|
||||
you can do from cloud-init, see the list of modules
|
||||
[here](http://cloudinit.readthedocs.io/en/latest/topics/modules.html).
|
||||
|
||||
Now that you have the two yaml files you can make the seed image with this
|
||||
command (Linux):
|
||||
|
||||
```console
|
||||
$ genisoimage -output seed.iso \
|
||||
-volid cidata \
|
||||
-joliet \
|
||||
-rock \
|
||||
user-data meta-data
|
||||
```
|
||||
|
||||
[In NixOS you may need to run it inside nix-shell: `nix-shell -p
|
||||
cdrkit`.](conversation://Mara/hacker)
|
||||
|
||||
Or this command (macOS):
|
||||
|
||||
```console
|
||||
$ hdiutil makehybrid \
|
||||
-o seed.iso \
|
||||
-hfs \
|
||||
-joliet \
|
||||
-iso \
|
||||
-default-volume-name cidata \
|
||||
user-data meta-data
|
||||
```
|
||||
|
||||
Now you can download the KVM image from that [Amazon Linux User Guide page from
|
||||
earlier](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-linux-2-virtual-machine.html)
|
||||
and then put it somewhere safe. This image will be written into a [ZFS
|
||||
zvol](https://pthree.org/2012/12/21/zfs-administration-part-xiv-zvols/). To find
|
||||
out how big the zvol needs to be, you can use `qemu-img info`:
|
||||
|
||||
```console
|
||||
$ qemu-img info amzn2-kvm-2.0.20210427.0-x86_64.xfs.gpt.qcow2
|
||||
image: amzn2-kvm-2.0.20210427.0-x86_64.xfs.gpt.qcow2
|
||||
file format: qcow2
|
||||
virtual size: 25 GiB (26843545600 bytes)
|
||||
disk size: 410 MiB
|
||||
cluster_size: 65536
|
||||
Format specific information:
|
||||
compat: 1.1
|
||||
compression type: zlib
|
||||
lazy refcounts: false
|
||||
refcount bits: 16
|
||||
corrupt: false
|
||||
extended l2: false
|
||||
```
|
||||
|
||||
The virtual disk image is 25 gigabytes, so you can create it with a command like
|
||||
this:
|
||||
|
||||
```console
|
||||
$ sudo zfs create -V 25G rpool/safe/vms/mayhem
|
||||
```
|
||||
|
||||
Then you use `qemu-img convert` to copy the image into the zvol:
|
||||
|
||||
```console
|
||||
$ sudo qemu-img convert \
|
||||
-O raw \
|
||||
amzn2-kvm-2.0.20210427.0-x86_64.xfs.gpt.qcow2 \
|
||||
/dev/zvol/rpool/safe/vms/mayhem
|
||||
```
|
||||
|
||||
If you don't use ZFS you can make a layered disk using `qemu-img create`:
|
||||
|
||||
```console
|
||||
$ qemu-img create \
|
||||
-f qcow2 \
|
||||
-o backing_file=amzn2-kvm-2.0.20210427.0-x86_64.xfs.gpt.qcow2 \
|
||||
mayhem.qcow2
|
||||
```
|
||||
|
||||
Open up virt-manager and then create a new virtual machine. Make sure you select
|
||||
"Manual install".
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
virt-manager will then ask you what OS the virtual machine is running so it can
|
||||
load some known working defaults. It doesn't have an option for Amazon Linux,
|
||||
but it's kinda sorta like CentOS 7, so enter CentOS 7 here.
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
The default amount of ram and CPU are fine, but you can choose other options if
|
||||
you have more restrictive hardware requirements.
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
Now you need to select the storage path for the VM. virt-manager will helpfully
|
||||
offer to create a new virtual disk for you. You already made the disk with the
|
||||
above steps, so enter in `/dev/zvol/rpool/safe/vms/mayhem` (or the path to your
|
||||
custom layered qcow2 from the above `qemu-img create` command) as the disk
|
||||
location.
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
Finally, name the VM and then choose "Customize configuration before install" so
|
||||
you can mount the seed data.
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
Click on the "Add Hardware" button in the lower left corner of the configuration
|
||||
window.
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
Make a new CDROM storage device that points to your seed image:
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
And then click "Begin Installation". The virtual machine will be created and its
|
||||
graphical console will open. Click on the info tab and then the NIC device. The
|
||||
VM's IP address will be listed:
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
Now SSH into the VM:
|
||||
|
||||
```console
|
||||
$ ssh xe@192.168.122.122
|
||||
The authenticity of host '192.168.122.122 (192.168.122.122)' can't be established.
|
||||
ED25519 key fingerprint is SHA256:TP7dWLkHOixx5tr78qn0yvDQKttH0yWz6IBvbadEqcs.
|
||||
This key is not known by any other names
|
||||
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
|
||||
Warning: Permanently added '192.168.122.122' (ED25519) to the list of known hosts.
|
||||
|
||||
__| __|_ )
|
||||
_| ( / Amazon Linux 2 AMI
|
||||
___|\___|___|
|
||||
|
||||
https://aws.amazon.com/amazon-linux-2/
|
||||
8 package(s) needed for security, out of 17 available
|
||||
Run "sudo yum update" to apply all updates.
|
||||
[xe@mayhem ~]$
|
||||
```
|
||||
|
||||
And voila! A new virtual machine that you can do whatever you want with, just
|
||||
like you would any other server.
|
||||
|
||||
[Do you really need to make an ISO file for this? Can't I just use HTTP like <a
|
||||
href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html">the
|
||||
AWS metadata service</a>?](conversation://Mara/hmm)
|
||||
|
||||
Yes and no. You can have the configuration loaded over HTTP/S, but without
|
||||
special network configuration you won't be able to have `http://169.254.169.254`
|
||||
work like the AWS metadata service without a fair bit of effort. Either way, you
|
||||
are going to have to edit the virtual machine's XML though.
|
||||
|
||||
[XML? Why is XML involved?](conversation://Mara/wat)
|
||||
|
||||
virt-manager is a frontend to [libvirt](https://libvirt.org/index.html). libvirt
|
||||
uses XML to describe virtual machines.
|
||||
[Here](https://gist.github.com/Xe/f870ebb2d9dce0929a35a4ba347cbda3) is the XML
|
||||
used to describe the VM you made earlier. This looks like a lot (because frankly
|
||||
it is a lot, computers are complicated), however this is a lot more manageable
|
||||
than the equivalent qemu flags.
|
||||
|
||||
[What do the qemu flags look like?](conversation://Mara/hmm)
|
||||
|
||||
[Like
|
||||
this](https://gist.githubusercontent.com/Xe/2eba35ec6cbd54becf9fca02f6d69f0b/raw/89d68424c0ae26333d798bd9bd6a224dfec844d7/qemu%2520flags.txt).
|
||||
It is kind of a mess that I would rather have something made by people smarter
|
||||
than me take care of.
|
||||
|
||||
To enable cloud-init to load over HTTP, you are going to have to add the qemu XML
|
||||
namespace to mayhem's configuration. At the top you should see a line that looks
|
||||
like this:
|
||||
|
||||
```xml
|
||||
<domain type="kvm">
|
||||
```
|
||||
|
||||
Replace it with one that looks like this:
|
||||
|
||||
```xml
|
||||
<domain xmlns:qemu="http://libvirt.org/schemas/domain/qemu/1.0" type="kvm">
|
||||
```
|
||||
|
||||
This will allow you to set the cloud-init seed location information using a
|
||||
[SMBIOS value](https://en.wikipedia.org/wiki/System_Management_BIOS). To enable
|
||||
this, add the following to the _bottom_ of your XML file, just before the
|
||||
closing `</domain>`:
|
||||
|
||||
```xml
|
||||
<qemu:commandline>
|
||||
<qemu:arg value="-smbios"/>
|
||||
<qemu:arg value="type=1,serial=ds=nocloud-net;h=mayhem;s=http://10.77.2.22:8000/mayhem/"/>
|
||||
</qemu:commandline>
|
||||
```
|
||||
|
||||
Make sure the data is actually being served on that address. Here's a nix-shell
|
||||
python one-liner HTTP server:
|
||||
|
||||
```console
|
||||
$ nix-shell -p python3 --run 'python -m http.server 8000'
|
||||
```
|
||||
|
||||
Then you will need to either load the base image back into the zvol or recreate
|
||||
the qcow2 file to reset the VM back to its default state.
|
||||
|
||||
Reboot the VM and wait for it to connect to your "metadata server":
|
||||
|
||||
```console
|
||||
192.168.122.122 - - [04/Jun/2021 11:41:10] "GET /mayhem/meta-data HTTP/1.1" 200 -
|
||||
192.168.122.122 - - [04/Jun/2021 11:41:10] "GET /mayhem/user-data HTTP/1.1" 200 -
|
||||
```
|
||||
|
||||
Then you can SSH into it like normal:
|
||||
|
||||
```console
|
||||
$ ssh xe@192.168.122.122
|
||||
The authenticity of host '192.168.122.122 (192.168.122.122)' can't be established.
|
||||
ED25519 key fingerprint is SHA256:eJRjDsvnVrXfntVtNVN6N+JdakaA+dvGKWWQP5OFkeA.
|
||||
This key is not known by any other names
|
||||
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
|
||||
Warning: Permanently added '192.168.122.122' (ED25519) to the list of known hosts.
|
||||
|
||||
__| __|_ )
|
||||
_| ( / Amazon Linux 2 AMI
|
||||
___|\___|___|
|
||||
|
||||
https://aws.amazon.com/amazon-linux-2/
|
||||
8 package(s) needed for security, out of 17 available
|
||||
Run "sudo yum update" to apply all updates.
|
||||
[xe@mayhem ~]$
|
||||
```
|
||||
|
||||
[Can I choose other distros for this?](conversation://Mara/hmm)
|
||||
|
||||
Yep! Most distributions offer cloud-init enabled images. They may be hard to
|
||||
find, but they do exist. Here's some links that will help you with common
|
||||
distros:
|
||||
|
||||
- [Arch Linux](https://mirror.pkgbuild.com/images/) (use the `cloudimg` ones)
|
||||
- [CentOS 7](https://cloud.centos.org/centos/7/images/) (use the `GenericCloud`
|
||||
one)
|
||||
- [CentOS 8](https://cloud.centos.org/centos/8-stream/x86_64/images/) (use the
|
||||
`GenericCloud` one)
|
||||
- [Debian 9](http://cloud.debian.org/images/cloud/OpenStack/9.13.22-20210531/)
|
||||
(use the `openstack` one)
|
||||
- [Debian 10](http://cloud.debian.org/images/cloud/buster/20210329-591/) (use
|
||||
the `generic` one)
|
||||
- [Debian 11](http://cloud.debian.org/images/cloud/bullseye/daily/) (use the
|
||||
`generic` one)
|
||||
- [Fedora 34](https://alt.fedoraproject.org/cloud/) (use the Openstack image)
|
||||
- [OpenSUSE Leap
|
||||
15.2](https://download.opensuse.org/repositories/Cloud:/Images:/Leap_15.2/images/)
|
||||
(use the `OpenStack` image)
|
||||
- [OpenSUSE Leap 15.3](https://get.opensuse.org/leap/) (use the JeOS one labeled
|
||||
`OpenStack-Cloud`)
|
||||
- [OpenSUSE Tumbleweed](https://download.opensuse.org/tumbleweed/appliances/)
|
||||
(use the JeOS one labeled `Openstack-Cloud`)
|
||||
- [Ubuntu](https://cloud-images.ubuntu.com/) (use the `server-cloudimg` image
|
||||
for your version of choice)
|
||||
|
||||
In general, look for images that are compatible with OpenStack. OpenStack uses
|
||||
cloud-init to configure virtual machines and the NoCloud data source you're using
|
||||
ships by default. It usually works out, except for cases like OpenSUSE Leap
|
||||
15.1. With Leap 15.1 you have to [pretend to be OpenStack a bit
|
||||
more](https://github.com/tailscale/tailscale/blob/aa6abc98f30df67a0d86698b77932d4d9cc45ac0/tstest/integration/vms/opensuse_leap_15_1_test.go)
|
||||
for some reason.
|
||||
|
||||
[What if I need to template the userdata file?](conversation://Mara/hmm)
|
||||
|
||||
[You really should avoid doing this if possible. Templating yaml is a delicate
|
||||
process fraught with danger. The error conditions in things like Kubernetes are
|
||||
that it does the wrong thing and you need to replace the service. The error
|
||||
condition with this is that you lose access to your
|
||||
server.](conversation://Cadey/facepalm)
|
||||
|
||||
[Let's say that Facts and Circumstances™ made me have to template
|
||||
it.](conversation://Mara/happy)
|
||||
|
||||
<center>
|
||||
<picture>
|
||||
<source srcset="https://cdn.christine.website/file/christine-static/stickers/cadey/percussive-maintenance.avif" type="image/avif">
|
||||
<source srcset="https://cdn.christine.website/file/christine-static/stickers/cadey/percussive-maintenance.webp" type="image/webp">
|
||||
<img src="https://cdn.christine.website/file/christine-static/stickers/cadey/percussive-maintenance.png" alt="Cadey is percussive-maintenance">
|
||||
</picture>
|
||||
</center>
|
||||
|
||||
When you are templating yaml, you have to be really careful. It is very easy to
|
||||
incur [the wrath of Norway and
|
||||
Ontario](https://hitchdev.com/strictyaml/why/implicit-typing-removed/) on
|
||||
accident with yaml. Here are some rules of thumb (unfortunately gained from
|
||||
experience) to keep in mind:
|
||||
|
||||
- yaml has implicit typing, quote everything to be safe.
|
||||
- ensure that every value you pass in is yaml-safe
|
||||
- ensure that the indentation matches for every value
|
||||
|
||||
Something very important is to test the templating on a virtual machine image
|
||||
that you have a back door into. Otherwise you will be locked out. You can
|
||||
generally hack around it by adding `init=/bin/sh` in your kernel command line
|
||||
and changing your password from there.
|
||||
|
||||
When you mess it up you will need to get into the VM somehow and do one of a few
|
||||
things:
|
||||
|
||||
1. Run `cloud-init collect-logs` to generate a log tarball that you can export
|
||||
to your host machine and dig into from there
|
||||
2. Look through the system journal for any errors
|
||||
3. Look in `/var/log` for files that begin with `cloud-init` and page through
|
||||
them
|
||||
|
||||
If all else fails, start googling. If you are running commands against a VM with
|
||||
the `runcmd` feature of cloud-init, I'd suggest going through the steps on a
|
||||
manually installed virtual machine image at least once so you can be sure the
|
||||
steps work. I have lost 4 hours of time to this. Also keep in mind that in the
|
||||
context that `runcmd` runs from, there is no standard input hooked up. You will
|
||||
need to pass `-y` everywhere.
|
||||
|
||||
If you want a simple Alpine Linux image to test with, look
|
||||
[here](https://github.com/Xe/alpine-image) for the Alpine Linux images I test
|
||||
with. You can download this image from
|
||||
[here](https://xena.greedo.xeserv.us/pkg/alpine/img/alpine-edge-2021-05-18-cloud-init-within.qcow2)
|
||||
in case you trust that I wouldn't put malware in that image and don't want to
|
||||
make your own.
|
||||
|
||||
---
|
||||
|
||||
In the future I plan to use cloud-init _extensively_ within my [new homelab
|
||||
cluster](https://twitter.com/theprincessxena/status/1400592778309115905). I have
|
||||
plans to make a custom VM management service I'm calling
|
||||
[waifud](https://github.com/Xe/waifud). I will write more on that as I have
|
||||
written the software. I currently have a minimum viable prototype of this tool
|
||||
called `mkvm` that I'm using today without any issues. I also will be writing up
|
||||
how I built the cluster and installed NixOS on all the systems in a future
|
||||
article.
|
||||
|
||||
cloud-init is an incredible achievement. It has its warts, but it being used in
|
||||
so many places enables you to make configuring virtual machines so much easier.
|
||||
It [even works on Windows!](https://cloudbase.it/cloudbase-init/). As much as I
|
||||
complain about it in this post, life would be so much worse without it. It
|
||||
allows me to use the magic of the cloud in my local virtual machines so I can
|
||||
get better use out of my hardware.
|
||||
|
|
@ -5,6 +5,8 @@ tags:
|
|||
- ipad
|
||||
---
|
||||
|
||||
# Coding on an iPad
|
||||
|
||||
As people notice, I am an avid user of Emacs for most of my professional and
|
||||
personal coding. I have things set up such that the center of my development
|
||||
environment is a shell (eshell), and most of my interactions are with emacs
|
||||
|
|
|
|||
|
|
@ -1,86 +0,0 @@
|
|||
---
|
||||
title: Colemak Layout - First Week
|
||||
date: 2020-08-22
|
||||
series: colemak
|
||||
---
|
||||
|
||||
A week ago I posted the last post in this series where I announced I was going
|
||||
all colemak all the time. I have not been measuring words per minute (to avoid
|
||||
psyching myself out), but so far my typing speed has gone from intolerably slow
|
||||
to manageably slow. I have been only dipping back into qwerty for two main
|
||||
things:
|
||||
|
||||
1. Passwords, specifically the ones I have in muscle memory
|
||||
2. Coding at work that needs to be done fast
|
||||
|
||||
Other than that, everything else has been in colemak. I have written DnD-style
|
||||
game notes, hacked at my own "Linux distro", started a few QMK keymaps and more
|
||||
all via colemak.
|
||||
|
||||
Here are some of the lessons I've learned:
|
||||
|
||||
## Let Your Coworkers Know You Are Going to Be Slow
|
||||
|
||||
This kind of thing is a long tirm investment. In the short term, your
|
||||
productivity is going to crash through the floor. This will feel frustrating. It
|
||||
took me an entire workday to implement and test a HTTP handler/client for it in
|
||||
Go. You will be making weird typos. Let your coworkers know so they don't jump
|
||||
to the wrong conclusions too quickly.
|
||||
|
||||
Also, this goes without saying, but don't do this kind of change during crunch
|
||||
time. That's a bit of a dick move.
|
||||
|
||||
## Print Out the Layout
|
||||
|
||||
I have the layout printed and taped to my monitor and iPad stand. This helps a
|
||||
lot. Instead of looking at the keyboard, I look at the layout image and let my
|
||||
fingers drift into position.
|
||||
|
||||
I also have a blank keyboard at my desk, this helps because I can't look at the
|
||||
keycaps and become confused (however this has backfired with typing numbers,
|
||||
lol). This keyboard has cherry MX blues though, which means it can be loud when
|
||||
I get to typing up a storm.
|
||||
|
||||
## Have Friends Ask You What Layout You Are Using
|
||||
|
||||
Something that works for me is to have friends ask me what keyboard layout I am
|
||||
using, so I can be mindful of the change. I have a few people asking me that on
|
||||
the regular, so I can be accountable to them and myself.
|
||||
|
||||
## macOS and iPadOS have Colemak Out of the Box
|
||||
|
||||
The settings app lets you configure colemak input without having to jailbreak or
|
||||
install a custom keyboard layout. Take advantage of this.
|
||||
|
||||
Someone has also created a colemak windows package for windows that includes an
|
||||
IA-64 (Itanium) binary. It was last updated in 2004, and still works without
|
||||
hassle on windows 10. It was the irst time I've ever seen an IA-64 windows
|
||||
binary in the wild!
|
||||
|
||||
## Relearn How To Type Your Passwords
|
||||
|
||||
I type passwords from muscle memory. I have had to rediscover what they actually
|
||||
are so I can relearn how to type them.
|
||||
|
||||
---
|
||||
|
||||
The colemak experiment continues. I also have a [ZSA
|
||||
Moonlander](https://www.zsa.io/moonlander/) and the kit for a
|
||||
[GergoPlex](https://www.gboards.ca/product/gergoplex) coming in the mail. Both
|
||||
of these run [QMK](https://qmk.fm), which allows me to fully program them with a
|
||||
rich macro engine. Here are a few of the macros I plan to use:
|
||||
|
||||
```c
|
||||
// Programming
|
||||
SUBS(ifErr, "if err != nil {\n\t\n}", KC_E, KC_I)
|
||||
SUBS(goTest, "go test ./...\n", KC_G, KC_T)
|
||||
SUBS(cargoTest, "cargo test\n", KC_C, KC_T)
|
||||
```
|
||||
|
||||
This will autotype a few common things when I press the keys "ei", "gt", or "ct"
|
||||
at the same time. I plan to add a few more as things turn up so I can more
|
||||
quickly type common idioms or commands to save me time. The `if err != nil`
|
||||
combination started as a joke, but I bet it will end up being incredibly
|
||||
valuable.
|
||||
|
||||
Be well, take care of your hands.
|
||||
|
|
@ -1,25 +0,0 @@
|
|||
---
|
||||
title: Colemak Layout - Beginning
|
||||
date: 2020-08-15
|
||||
series: colemak
|
||||
---
|
||||
|
||||
I write a lot. On average I write a few kilobytes of text per day. This has been
|
||||
adding up and is taking a huge toll on my hands, especially considering the
|
||||
Covid situation. Something needs to change. I've been working on learning a new
|
||||
keyboard layout: [Colemak](https://colemak.com).
|
||||
|
||||
This post will be shorter than most of my posts because I'm writing it with
|
||||
Colemak enabled on my iPad. Writing this is painfully slow at the moment. My
|
||||
sentences are short and choppy because those are easier to type.
|
||||
|
||||
I also have a [ZSA Moonlander](https://www.zsa.io/moonlander/) on the way, it
|
||||
should be here in October or November. I will also be sure to write about that
|
||||
once I get it in the mail.
|
||||
|
||||
So far, I have about 30 words per minute on the homerow, but once I go off the
|
||||
homerow the speed tanks to less than about five.
|
||||
|
||||
However, I am making progress!
|
||||
|
||||
Be well all, don't stress your hands out.
|
||||
|
|
@ -5,6 +5,9 @@ tags:
|
|||
- personal
|
||||
---
|
||||
|
||||
Coming Out
|
||||
==========
|
||||
|
||||
I'd like to bring up something that has been hanging over my head for a
|
||||
long time. This is something I did try (and fail) to properly express way
|
||||
back in middle school, but now I'd like to get it all of my chest and let
|
||||
|
|
|
|||
|
|
@ -1,212 +0,0 @@
|
|||
---
|
||||
title: "My Convoluted VRChat Google Meet Setup"
|
||||
date: 2021-02-24
|
||||
tags:
|
||||
- oculusquest2
|
||||
- vr
|
||||
- vrchat
|
||||
---
|
||||
|
||||
Recently the place I work for sent us all VR headsets. I decided to see what it
|
||||
would take to use that headset to make my camera show a virtual avatar instead
|
||||
of my meat body face. This is the story of my journey through chaining things
|
||||
together to make work meetings a bit more fun by using a 3D avatar instead of
|
||||
myself in some of them.
|
||||
|
||||
[This post uses SVG for diagrams to help explain what's going on here. You may
|
||||
need to use a browser with SVG support in order to get the best experience with
|
||||
this article. All the diagrams will be explained after the fact so that people
|
||||
using screen readers are not left out.](conversation://Mara/hacker)
|
||||
|
||||
<center>
|
||||
|
||||
<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Working at <a href="https://twitter.com/Tailscale?ref_src=twsrc%5Etfw">@Tailscale</a> is great. They sent us all an Oculus Quest 2! <a href="https://t.co/dDhbwO9cFd">pic.twitter.com/dDhbwO9cFd</a></p>— Cadey A. Ratio (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1362871906597224456?ref_src=twsrc%5Etfw">February 19, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
</center>
|
||||
|
||||
So, let's cover the basics from a high level. At a high level a webcam is just
|
||||
a video source that may or may not have a microphone attached to it. So in
|
||||
order to get my avatar to show up in a video call, I need some way to make some
|
||||
window on my computer act as a webcam. This will make the overall dependency
|
||||
list look like this (for those of you using screen readers I will describe
|
||||
this diagram below):
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
VRChat renders to the Desktop which is picked up by OBS which has the ability
|
||||
to pretend to be a webcam, which is finally picked up by Google Meet.
|
||||
|
||||
If the VR headset that I got from work was a tethered to the PC kind of VR
|
||||
headset like the Valve Index or HTC Vive, the next steps would involve full
|
||||
body tracking or something so that I could have my movements in real life
|
||||
transfer into movements that my avatar makes.
|
||||
|
||||
However, the VR headset we got sent was an Oculus Quest 2. This is a
|
||||
_standalone_ VR headset that is basically an Android tablet that you strap
|
||||
to your face. This makes things a bit more technically challenging because
|
||||
now you need some way to get the video to the headset and the motion tracking
|
||||
data from the headset and to the computer at 90 times per second. This requires
|
||||
a bit more cleverness.
|
||||
|
||||
The Oculus desktop software ships with a feature called Oculus Link that allows
|
||||
you to use a gaming PC to render the VR data to your headset by sending the
|
||||
video streams over USB. I had to dig around for a compatible cable (It needs to
|
||||
be a specific kind of USB-3 to USB-C-3 cable with at least 5 gigabits per
|
||||
second of transfer capacity) since the ones that
|
||||
[Oculus sells](https://www.oculus.com/accessories/oculus-link/) are both at
|
||||
least CAD$110 and out of stock anywhere I can find them in Canada. The 0.75
|
||||
meter long cable I had been using was good enough to get me through the first
|
||||
couple days of experimenting with VR, but it was clear that a better solution
|
||||
was needed.
|
||||
|
||||
I did some digging and found a bit of software called
|
||||
[ALVR](https://github.com/alvr-org/alvr#readme) that claimed to let me do VR
|
||||
from my computer wirelessly. So I set it up on the Quest and on my tower,
|
||||
which brought up the dependency graph to this:
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
ALVR talks with its counterpart on the Quest. This allows you to stream the VR
|
||||
video and audio bidirectionally. You also need to bring Virtual Audio Cable
|
||||
into the setup so that you can hear stuff in the game and so that other people
|
||||
can hear you using the headset mic. However, ALVR is not available on the Quest
|
||||
store. You need to install [SideQuest](https://sidequestvr.com/setup-howto) for
|
||||
that.
|
||||
|
||||
[SideQuest lets you sideload Android APK files to your Quest 2 because the
|
||||
Quest 2 is basically an Android tablet that you strap to your face!](conversation://Mara/happy)
|
||||
|
||||
So I used SideQuest to install the ALVR client on my Quest 2, and then I opened
|
||||
up VRChat and was able to do everything I was able to do with the wired cable.
|
||||
It worked beautifully until it didn't. I started running into issues with the
|
||||
video stream just dying. The foveated encoding (tl;dr: attempting to hack the
|
||||
image quality based on how eyes work so you don't notice the artifacting as
|
||||
much) could only do so much and it just ended up not working. Even when I was
|
||||
only doing it for short amounts of time. There is a lot of WiFi noise in my
|
||||
apartment or something and it was really interfering with ALVR's stream
|
||||
encoding. The latency was also noticeable after a bit.
|
||||
|
||||
However, when it worked it worked beautifully. I had to upgrade to the nightly
|
||||
build of ALVR in order to get game audio and the headset mic working, but once
|
||||
it all worked it was really convenient. I could walk around my apartment and
|
||||
I'd also walk around in-game.
|
||||
|
||||
A friend told me that the best experience I could have with wireless VR using a
|
||||
Quest 2 would be to use [Virtual Desktop](https://www.vrdesktop.net). Apparently
|
||||
Virtual Desktop has a
|
||||
[patch that enables SteamVR support](https://sidequestvr.com/app/16), so I
|
||||
purchased Virtual Desktop on a whim and decided to give it a go.
|
||||
|
||||
Virtual Desktop made ALVR look like a tech demo. All of the latency issues were
|
||||
solved instantly. Virtual Desktop also made it convenient for me to access my
|
||||
tower's monitors while in VR, and it has the best typing experience in VR that
|
||||
I've ever used.
|
||||
|
||||
This brings the dependency graph up to this:
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
Now all that was left was to make the camera view look somewhat like it does
|
||||
when I'm using my work laptop's webcam to make video calls. I started out by taking a picture of my office from about the angle that my laptop sits at.
|
||||
I ended up with this image:
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
Then with some clever use of the
|
||||
[Chroma key filter in VRChat](https://docs.vrchat.com/docs/vrchat-201812)
|
||||
I was able to get some basic compositing of my avatar onto the picture. I
|
||||
fiddled with the placement of things and then I was able to declare success
|
||||
with this image I posted to Twitter:
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
And it worked! I was able to make a call in Google Meet to myself and my
|
||||
avatar's lip movements synchronized somewhat with the words I was saying. I
|
||||
had waifu mode enabled!
|
||||
|
||||
[The avatar being used there is based on a character from Xenoblade Chronicles
|
||||
2 named Pneuma.](conversation://Mara/hacker)
|
||||
|
||||
However, this setup was really janky. I didn't actually get the proper angle
|
||||
for what my work laptop's camera would actually see. Everything was offset to
|
||||
the side and it was at way the wrong angle in general. I'm also not sure if I
|
||||
messed up the sizing of the background image in the OBS view, it looks kinda
|
||||
stretched on my end as I'm writing this post.
|
||||
|
||||
So I decided that the best way to get the most accurate angle was to record a
|
||||
video loop using my work laptop's webcam. After some googling I found
|
||||
[webcamera.io](https://webcamera.io) which let me record some footage of my
|
||||
office from my work laptop's camera angle. I got down under the desk (so I was
|
||||
out of view of the camera) and then recorded a 45 second loop of my office
|
||||
doing nothing (however the flag was slightly moving in the breeze from the desk
|
||||
fan).
|
||||
|
||||
I also found a VRChat world that claimed to be as optimized as you could
|
||||
possibly make a VRChat world. It was a blue cube about 30m by 30m. Checking
|
||||
with SteamVR it brought my frame times down to 3 milliseconds with the stream
|
||||
camera set up for OBS. It looks like this:
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
It's very minimal. You can make the walls go away if you want, which somehow makes it render faster on my RX5700. I'm not sure what's going on there.
|
||||
|
||||
[I'd heckin' love to get a new GPU but until the Bitcoin prices go down we may
|
||||
be stuck with this setup for a while. An RTX 3070 would really be useful about
|
||||
now.](conversation://Mara/hacker)
|
||||
|
||||
Anyways, with this minimal world incurring very little to no GPU load, I was
|
||||
free to do video calls all I wanted. I even did a call with the CEO of the
|
||||
company I work for with a setup like this. It was fun.
|
||||
|
||||
Now I had everything set up. I can pop on the headset, load up the world, open
|
||||
OBS, VRChat, Virtual Desktop and get everything set up in about 5 minutes at
|
||||
worst. Then I can use the seeing your desktop side of Virtual Desktop to
|
||||
actually watch the meeting and be able to see screen sharing. They can hear me
|
||||
because Virtual Desktop pipes the headset microphone audio back to my tower,
|
||||
and the meeting audio comes over my headphones.
|
||||
|
||||
Also at some point I needed to bring AutoHotKey into the mix, so I borrowed
|
||||
this AutoHotKey script from [SuperUser](https://superuser.com/a/429845) to
|
||||
resize the VRChat window so that it would fit perfectly into the OBS view:
|
||||
|
||||
```ahk
|
||||
#=:: ; [Win]+[=]
|
||||
WinGet, window, ID, A
|
||||
InputBox, width, Resize, Width:, , 140, 130
|
||||
InputBox, height, Resize, Height:, , 140, 130
|
||||
WinMove, ahk_id %window%, , , , width, height
|
||||
return
|
||||
```
|
||||
|
||||
Making the VRChat window smaller also helped with the frame times, because it
|
||||
needed to render less detail per frame. This helped push the framerate
|
||||
comfortably above 72 FPS in my VR view.
|
||||
|
||||
That is how I get a 3d avatar to show up instead of pictures of the meat golem
|
||||
I am cursed inside of for work meetings. I will also use this for streaming
|
||||
coding in the future, so you can all witness the power of a VTube coding stream
|
||||
where I write Rust or something.
|
||||
|
|
@ -1,34 +0,0 @@
|
|||
---
|
||||
title: COVID Burnout
|
||||
date: 2021-09-25
|
||||
---
|
||||
|
||||
NOTE: This was written out in
|
||||
[longhand](https://twitter.com/theprincessxena/status/1441842150824718337?s=21)
|
||||
in my diary. This post was converted to text using iPadOS 15's handwriting to
|
||||
text recognition. I hope I have cleared up all of the major errors in the
|
||||
conversion. My handwriting is horrible.
|
||||
|
||||
---
|
||||
|
||||
I am an introvert. I usually spend a lot of time in my cave. most of my work was
|
||||
alreary done remotely, when I first found out about the COVID-19 pandemic, I
|
||||
thought there would be at most 4-8 weeks of hardcore lockdown and then it would
|
||||
die out. Then life would go back to normal and I would be able to see my friends
|
||||
at conventions during the summer.
|
||||
|
||||
As of the time of writing this post, it is currently the 84th week OF COVID
|
||||
being a major presence in how I handle daily life. I am exhausted, I was
|
||||
scheduled to give talks at two conventions that were canceled, meet ups with
|
||||
friends at places across the us and Canada were postponed into oblivion. My
|
||||
relationship with my parents has fractured into no-contact. I feel powerless to
|
||||
do anything more to stop this.
|
||||
|
||||
I am the most connected I have ever been and I am the lonliest I have ever been.
|
||||
Most of the people I talk to are people I have never met in person, even my
|
||||
coworkers. My manager is someone I talk with near daily yet have never seen
|
||||
without the aid of video conferencing.
|
||||
|
||||
This is exhausting. I hate it. My Netflix queue is empty. I feel so alone.
|
||||
|
||||
This post doesn't have a message or moral.
|
||||
|
|
@ -6,6 +6,9 @@ tags:
|
|||
- frontend
|
||||
---
|
||||
|
||||
Crazy Experiment: Ship the Frontend as an asar document
|
||||
=======================================================
|
||||
|
||||
Today's crazy experiment is using an [asar archive](https://github.com/electron/asar) for shipping around
|
||||
and mounting frontend Javascript applications. This is something I feel is worth doing because it allows
|
||||
the web frontend developer (or team) give the backend team a single "binary" that can be dropped into the
|
||||
|
|
|
|||
|
|
@ -7,6 +7,8 @@ tags:
|
|||
- coc
|
||||
---
|
||||
|
||||
# [Creator's Code](https://github.com/Xe/creators-code)
|
||||
|
||||
I feel there is a large problem in the industry I have found myself in. There is,
|
||||
unfortunately, a need for codes of behavioral conduct to help arrange and align
|
||||
collaboration across so many cultural and ideological barriers, as well as
|
||||
|
|
|
|||
|
|
@ -4,6 +4,8 @@ date: 2018-11-21
|
|||
series: dreams
|
||||
---
|
||||
|
||||
# My Experience Cursing Out God
|
||||
|
||||
This was a hell of a dream.
|
||||
|
||||
It was a simple landscape: a hill, a sky, a sun, a distance, naturalistic buildings dotting a small village to the east. I noticed that I felt different somehow, like I was less chained down. A genderless but somehow masculine moved and stood next to me, gesturing towards me: "It's beautiful isn't it? The village has existed like this for thousands of years in perfect harmony with its world. Even though there's volcano eruptions every decade that burn everything down. It's been nine years and 350 days, but they aren't keeping track. How does that thought make you feel, Creator?"
|
||||
|
|
|
|||
|
|
@ -5,11 +5,13 @@ thanks: Sygma
|
|||
series: magick
|
||||
---
|
||||
|
||||
# Death
|
||||
|
||||
Death is a very misunderstood card in Tarot, but not for the reasons you'd think. Societally, many people think that this life is the only shot at existence they get. Afterwards, there is nothing. Nonexistence. Oblivion. This makes death a very touchy subject for a lot of people, so much so it forms a social taboo and an unhealthy relationship with death. People start seeing death as something they need to fight back and hold away by removing what makes themselves human, just to hold off what they believe is their obliteration.
|
||||
|
||||
Tarot does not see death in this way. Death, the skeleton knight wearing armor, does not see color, race or creed, thus he is depicted as a skeleton. He is riding towards a child and another younger person. The sun is rising in the distance, but even it cannot stop Death. Nor can royalty, as shown by the king under him, dead.
|
||||
|
||||
|
||||
<center></center>
|
||||
|
||||
Death, however, does not actually refer to the act of a physical body physically dying. Death is a change that cannot be reverted. The consequences of this change can and will affect what comes next, however.
|
||||
|
||||
|
|
|
|||
|
|
@ -8,6 +8,8 @@ tags:
|
|||
- what
|
||||
---
|
||||
|
||||
# Death Stranding Review
|
||||
|
||||
NOTE: There's gonna be spoilers here. Do not read if you are not okay with this.
|
||||
For a summary of the article without spoilers, this game is 10 out of 10 game of the
|
||||
year 2019 for me.
|
||||
|
|
@ -90,7 +92,7 @@ the real thing that advances is the skill of the player. You make the
|
|||
deliveries. You go the distance. You do your job as the post-apocalyptic UPS man
|
||||
that America needs.
|
||||
|
||||
|
||||
<center></center>
|
||||
|
||||
By [mmmintdesign](https://twitter.com/mmmintdesign) [source](https://twitter.com/mmmintdesign/status/1192856164331114497)
|
||||
|
||||
|
|
|
|||
|
|
@ -3,6 +3,9 @@ title: Dependency Hell
|
|||
date: 2014-11-20
|
||||
---
|
||||
|
||||
Dependency Hell
|
||||
===============
|
||||
|
||||
A lot of the problem that I have run into when doing development with
|
||||
nearly any stack I have used is dependency management. This relatively
|
||||
simple-looking problem just becomes such an evil, evil thing to tackle.
|
||||
|
|
|
|||
|
|
@ -5,6 +5,8 @@ tags:
|
|||
- release
|
||||
---
|
||||
|
||||
# Deprecation Notice: Elemental-IRCd
|
||||
|
||||
[Elemental-IRCd](https://github.com/Elemental-IRCd/elemental-ircd) is a scalable, lightweight, high-performance IRC daemon written in C with heritage in the original IRC daemon. It is a fork of the now-defunct ShadowIRCD and sought to continue in the direction ShadowIRCD was headed. This software has scaled to support live chat for thousands of users at once in one->one and one->many groups. Working on this software has legitimately been a vital driving force to my career and skill balance between administration, development, moderation and operations of distirbuted communities at scale. Without this software, my closest friends (and even my fiancé) would be strangers to me.
|
||||
|
||||
However, the result is something I don't know if I can continue to keep maintaining. It's been through a lot. The code has been through so many hands, some files had different licenses compared to the rest of the software. It is a patchwork of patches on top of a roughly solid core, and it's become a burden to maintain.
|
||||
|
|
|
|||
|
|
@ -5,6 +5,9 @@ tags:
|
|||
- release
|
||||
---
|
||||
|
||||
Instant Development Environments in Docker
|
||||
==========================================
|
||||
|
||||
I have been using a few shell scripts for turbocharging development
|
||||
using Docker and today I have released the first version of a simple
|
||||
tool I call "[dev](https://github.com/Xe/dev)". Usage is very very simple.
|
||||
|
|
|
|||
|
|
@ -1,716 +0,0 @@
|
|||
---
|
||||
title: "How I Implemented /dev/printerfact in Rust"
|
||||
date: 2021-04-17
|
||||
series: howto
|
||||
tags:
|
||||
- rust
|
||||
- linux
|
||||
- kernel
|
||||
---
|
||||
|
||||
Kernel mode programming is a frightful endeavor. One of the big problems with it
|
||||
is that C is really your only option on Linux. C has many historical problems
|
||||
with it that can't really be fixed at this point without radically changing the
|
||||
language to the point that existing code written in C would be incompatible with
|
||||
it.
|
||||
|
||||
DISCLAIMER: This is pre-alpha stuff. I expect this post to bitrot quickly.
|
||||
<big>**DO NOT EXPECT THIS TO STILL WORK IN A FEW YEARS.**</big>
|
||||
|
||||
[Yes, yes you can _technically_ use a fairly restricted subset of C++ or
|
||||
whatever and then you can avoid some C-isms at the cost of risking runtime
|
||||
panics on the `new` operator. However that kind of thing is not what is being
|
||||
discussed today.](conversation://Mara/hacker?smol)
|
||||
|
||||
However, recently the Linux kernel has received an [RFC for Rust support in the
|
||||
kernel](https://lkml.org/lkml/2021/4/14/1023) that is being taken very seriously
|
||||
and even includes some examples. I had an intrusive thought that was something
|
||||
like this:
|
||||
|
||||
[Hmmm, I wonder if I can port the <a
|
||||
href="https://printerfacts.cetacean.club/fact">Printer Facts API</a> to this, it
|
||||
can't be that hard, right?](conversation://Cadey/wat?smol)
|
||||
|
||||
Here is the story of my saga.
|
||||
|
||||
## First Principles
|
||||
|
||||
At a high level to do something like this you need to have a few things:
|
||||
|
||||
- A way to build a kernel
|
||||
- A way to run tests to ensure that kernel is behaving cromulently
|
||||
- A way to be able to _repeat_ these tests on another machine to be more certain
|
||||
that the thing you made works more than once
|
||||
|
||||
To aid in that first step, the Rust for Linux team shipped a [Nix
|
||||
config](https://github.com/Rust-for-Linux/nix) to let you `nix-build -A kernel`
|
||||
yourself a new kernel whenever you wanted. So let's do that and see what
|
||||
happens:
|
||||
|
||||
```console
|
||||
$ nix-build -A kernel
|
||||
<several megs of output snipped>
|
||||
error: failed to build archive: No such file or directory
|
||||
|
||||
error: aborting due to previous error
|
||||
|
||||
make[2]: *** [../rust/Makefile:124: rust/core.o] Error 1
|
||||
make[2]: *** Deleting file 'rust/core.o'
|
||||
make[1]: *** [/tmp/nix-build-linux-5.11.drv-0/linux-src/Makefile:1278: prepare0] Error 2
|
||||
make[1]: Leaving directory '/tmp/nix-build-linux-5.11.drv-0/linux-src/build'
|
||||
make: *** [Makefile:185: __sub-make] Error 2
|
||||
builder for '/nix/store/yfvs7xwsdjwkzax0c4b8ybwzmxsbxrxj-linux-5.11.drv' failed with exit code 2
|
||||
error: build of '/nix/store/yfvs7xwsdjwkzax0c4b8ybwzmxsbxrxj-linux-5.11.drv' failed
|
||||
```
|
||||
|
||||
Oh dear. That is odd. Let's see if the issue tracker has anything helpful. It
|
||||
[did](https://github.com/Rust-for-Linux/nix/issues/1)! Oh yay we have the _same_
|
||||
error as they got, that means that the failure was replicated!
|
||||
|
||||
So, let's look at the project structure a bit more:
|
||||
|
||||
```console
|
||||
$ tree .
|
||||
.
|
||||
├── default.nix
|
||||
├── kernel.nix
|
||||
├── LICENSE
|
||||
├── nix
|
||||
│ ├── sources.json
|
||||
│ └── sources.nix
|
||||
└── README.md
|
||||
```
|
||||
|
||||
This project looks like it's using [niv](https://github.com/nmattia/niv) to lock
|
||||
its Nix dependencies. Let's take a look at `sources.json` to see what options we
|
||||
have to update things.
|
||||
|
||||
[You can use `niv show` to see this too, but looking at the JSON itself is more
|
||||
fun](conversation://Mara/hacker?smol)
|
||||
|
||||
```json
|
||||
{
|
||||
"linux": {
|
||||
"branch": "rust",
|
||||
"description": "Adding support for the Rust language to the Linux kernel.",
|
||||
"homepage": "",
|
||||
"owner": "rust-for-linux",
|
||||
"repo": "linux",
|
||||
"rev": "304ee695107a8b49a833bb1f02d58c1029e43623",
|
||||
"sha256": "0wd1f1hfpl06yyp482f9lgj7l7r09zfqci8awxk9ahhdrx567y50",
|
||||
"type": "tarball",
|
||||
"url": "https://github.com/rust-for-linux/linux/archive/304ee695107a8b49a833bb1f02d58c1029e43623.tar.gz",
|
||||
"url_template": "https://github.com/<owner>/<repo>/archive/<rev>.tar.gz"
|
||||
},
|
||||
"niv": {
|
||||
"branch": "master",
|
||||
"description": "Easy dependency management for Nix projects",
|
||||
"homepage": "https://github.com/nmattia/niv",
|
||||
"owner": "nmattia",
|
||||
"repo": "niv",
|
||||
"rev": "af958e8057f345ee1aca714c1247ef3ba1c15f5e",
|
||||
"sha256": "1qjavxabbrsh73yck5dcq8jggvh3r2jkbr6b5nlz5d9yrqm9255n",
|
||||
"type": "tarball",
|
||||
"url": "https://github.com/nmattia/niv/archive/af958e8057f345ee1aca714c1247ef3ba1c15f5e.tar.gz",
|
||||
"url_template": "https://github.com/<owner>/<repo>/archive/<rev>.tar.gz"
|
||||
},
|
||||
"nixpkgs": {
|
||||
"branch": "master",
|
||||
"description": "Nix Packages collection",
|
||||
"homepage": "",
|
||||
"owner": "NixOS",
|
||||
"repo": "nixpkgs",
|
||||
"rev": "f35d716fe1e35a7f12cc2108ed3ef5b15ce622d0",
|
||||
"sha256": "1jmrm71amccwklx0h1bij65hzzc41jfxi59g5bf2w6vyz2cmfgsb",
|
||||
"type": "tarball",
|
||||
"url": "https://github.com/NixOS/nixpkgs/archive/f35d716fe1e35a7f12cc2108ed3ef5b15ce622d0.tar.gz",
|
||||
"url_template": "https://github.com/<owner>/<repo>/archive/<rev>.tar.gz"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
It looks like there's 3 things: the kernel, niv itself (niv does this by default
|
||||
so we can ignore it) and some random nixpkgs commit on its default branch. Let's
|
||||
see how old this commit is:
|
||||
|
||||
```diff
|
||||
From ab8465cba32c25e73a3395c7fc4f39ac47733717 Mon Sep 17 00:00:00 2001
|
||||
Date: Sat, 6 Mar 2021 12:04:23 +0100
|
||||
```
|
||||
|
||||
Hmm, I know that Rust in NixOS has been updated since then. Somewhere in the
|
||||
megs of output I cut it mentioned that I was using Rust 1.49. Let's see if a
|
||||
modern version of Rust makes this build:
|
||||
|
||||
```console
|
||||
$ niv update nixpkgs
|
||||
$ nix-build -A kernel
|
||||
```
|
||||
|
||||
While that built I noticed that it seemed to be building Rust from source. This
|
||||
initially struck me as odd. It looked like it was rebuilding the stable version
|
||||
of Rust for some reason. Let's take a look at `kernel.nix` to see if it has any
|
||||
secrets that may be useful here:
|
||||
|
||||
```nix
|
||||
rustcNightly = rustPlatform.rust.rustc.overrideAttrs (oldAttrs: {
|
||||
configureFlags = map (flag:
|
||||
if flag == "--release-channel=stable" then
|
||||
"--release-channel=nightly"
|
||||
else
|
||||
flag
|
||||
) oldAttrs.configureFlags;
|
||||
});
|
||||
```
|
||||
|
||||
[Wait, what. Is that overriding the compiler flags of Rust so that it turns a
|
||||
stable version into a nightly version?](conversation://Mara/wat?smol)
|
||||
|
||||
Yep! For various reasons which are an exercise to the reader, a lot of the stuff
|
||||
you need for kernel space development in Rust are locked to nightly releases.
|
||||
Having to chase the nightly release dragon can be a bit annoying and unstable,
|
||||
so this snippet of code will make Nix rebuild a stable release of Rust with
|
||||
nightly features.
|
||||
|
||||
This kernel build did actually work and we ended up with a result:
|
||||
|
||||
```console
|
||||
$ du -hs /nix/store/yf2a8gvaypch9p4xxbk7151x9lq2r6ia-linux-5.11
|
||||
92M /nix/store/yf2a8gvaypch9p4xxbk7151x9lq2r6ia-linux-5.11
|
||||
```
|
||||
|
||||
## Ensuring Cromulence
|
||||
|
||||
> A noble spirit embiggens the smallest man.
|
||||
>
|
||||
> I've never heard of the word "embiggens" before.
|
||||
>
|
||||
> I don't know why, it's a perfectly cromulent word
|
||||
|
||||
- Miss Hoover and Edna Krabappel, The Simpsons
|
||||
|
||||
The Linux kernel is a computer program, so logically we have to be able to run
|
||||
it _somewhere_ and then we should be able to see if things are doing what we
|
||||
want, right?
|
||||
|
||||
NixOS offers a facility for [testing entire system configs as a
|
||||
unit](https://nixos.org/manual/nixos/unstable/index.html#sec-nixos-tests). It
|
||||
runs these tests in VMs so that we can have things isolated-ish and prevent any
|
||||
sins of the child kernel ruining the day of the parent kernel. I have a
|
||||
[template
|
||||
test](https://github.com/Xe/nixos-configs/blob/master/tests/template.nix) in my
|
||||
[nixos-configs](https://github.com/Xe/nixos-configs) repo that we can build on.
|
||||
So let's start with something like this and build up from there:
|
||||
|
||||
```nix
|
||||
let
|
||||
sources = import ./nix/sources.nix;
|
||||
pkgs = sources.nixpkgs;
|
||||
in import "${pkgs}/nixos/tests/make-test-python.nix" ({ pkgs, ... }: {
|
||||
system = "x86_64-linux";
|
||||
|
||||
nodes.machine = { config, pkgs, ... }: {
|
||||
virtualisation.graphics = false;
|
||||
};
|
||||
|
||||
testScript = ''
|
||||
start_all()
|
||||
machine.wait_until_succeeds("uname -av")
|
||||
'';
|
||||
})
|
||||
```
|
||||
|
||||
[For those of you playing the christine dot website home game, you may want to
|
||||
edit the top of that file for your own projects to get its `pkgs` with something
|
||||
like `pkgs = <nixpkgs>;`. The `sources.pkgs` thing is being used here to jive
|
||||
with niv.](conversation://Mara/hacker?smol)
|
||||
|
||||
You can run tests with `nix-build ./test.nix`:
|
||||
|
||||
```console
|
||||
$ nix-build ./test.nix
|
||||
<much more output>
|
||||
machine: (connecting took 4.70 seconds)
|
||||
(4.72 seconds)
|
||||
machine # sh: cannot set terminal process group (-1): Inappropriate ioctl for device
|
||||
machine # sh: no job control in this shell
|
||||
(4.76 seconds)
|
||||
(4.83 seconds)
|
||||
test script finished in 4.85s
|
||||
cleaning up
|
||||
killing machine (pid 282643)
|
||||
(0.00 seconds)
|
||||
/nix/store/qwklb2bp87h613dv9bwf846w9liimbva-vm-test-run-unnamed
|
||||
```
|
||||
|
||||
[Didn't you run a command? Where did the output
|
||||
go?](conversation://Mara/hmm?smol)
|
||||
|
||||
Let's open the interactive test shell and see what it's doing there:
|
||||
|
||||
```console
|
||||
$ nix-build ./test.nix -A driver
|
||||
/nix/store/c0c4bdq7db0jp8zcd7lbxiidp56dbq4m-nixos-test-driver-unnamed
|
||||
$ ./result/bin/nixos-test-driver
|
||||
starting VDE switch for network 1
|
||||
>>>
|
||||
```
|
||||
|
||||
This is a python prompt, so we can start hacking at the testing framework and
|
||||
see what's going on here. Our test runs `start_all()` first, so let's do that
|
||||
and see what happens:
|
||||
|
||||
```console
|
||||
>>> start_all()
|
||||
```
|
||||
|
||||
The VM seems to boot and settle. If you press enter again you get a new prompt.
|
||||
The test runs `machine.wait_until_succeeds("uname -av")` so let's punch that in:
|
||||
|
||||
```console
|
||||
>>> machine.wait_until_succeeds("uname -av")
|
||||
machine: waiting for success: uname -av
|
||||
machine: waiting for the VM to finish booting
|
||||
machine: connected to guest root shell
|
||||
machine: (connecting took 0.00 seconds)
|
||||
(0.00 seconds)
|
||||
(0.02 seconds)
|
||||
'Linux machine 5.4.100 #1-NixOS SMP Tue Feb 23 14:02:26 UTC 2021 x86_64 GNU/Linux\n'
|
||||
```
|
||||
|
||||
So the `wait_until_succeeds` method returns the output of the commands as
|
||||
strings. This could be useful. Let's inject the kernel into this.
|
||||
|
||||
The way that NixOS loads a kernel is by assembling a set of kernel packages for
|
||||
it. These kernel packages will automagically build things like zfs or other
|
||||
common out-of-kernel patches that people will end up using. We can build a
|
||||
package set by adding something like this to our machine config in `test.nix`:
|
||||
|
||||
```nix
|
||||
nixpkgs.overlays = [
|
||||
(self: super: {
|
||||
Rustix = (super.callPackage ./. { }).kernel;
|
||||
RustixPackages = super.linuxPackagesFor self.Rustix;
|
||||
})
|
||||
];
|
||||
|
||||
boot.kernelPackages = pkgs.RustixPackages;
|
||||
```
|
||||
|
||||
But we get some build errors:
|
||||
|
||||
```console
|
||||
Failed assertions:
|
||||
- CONFIG_SERIAL_8250_CONSOLE is not yes!
|
||||
- CONFIG_SERIAL_8250 is not yes!
|
||||
- CONFIG_VIRTIO_CONSOLE is not enabled!
|
||||
- CONFIG_VIRTIO_BLK is not enabled!
|
||||
- CONFIG_VIRTIO_PCI is not enabled!
|
||||
- CONFIG_VIRTIO_NET is not enabled!
|
||||
- CONFIG_EXT4_FS is not enabled!
|
||||
<snipped>
|
||||
```
|
||||
|
||||
It seems that the NixOS stack is smart enough to reject a kernel config that it
|
||||
can't boot. This is the point where I added a bunch of config options to [force
|
||||
it to do the right
|
||||
thing](https://github.com/Xe/dev-printerfact-on-nixos/blob/main/kernel.nix#L54-L96)
|
||||
in my own fork of the repo.
|
||||
|
||||
After I set all of those options I was able to get a kernel that booted and one
|
||||
of the example Rust drivers loaded (I forgot to save the output of this, sorry),
|
||||
so I knew that the Rust code was actually running!
|
||||
|
||||
Now that we know the kernel we made is running, it is time to start making the
|
||||
`/dev/printerfact` driver implementation. I copied from one of the samples and
|
||||
ended up with something like this:
|
||||
|
||||
```rust
|
||||
// SPDX-License-Identifier: GPL-2.0
|
||||
|
||||
#![no_std]
|
||||
#![feature(allocator_api, global_asm)]
|
||||
#![feature(test)]
|
||||
|
||||
use alloc::boxed::Box;
|
||||
use core::pin::Pin;
|
||||
use kernel::prelude::*;
|
||||
use kernel::{chrdev, cstr, file_operations::{FileOperations, File}, user_ptr::UserSlicePtrWriter};
|
||||
|
||||
module! {
|
||||
type: PrinterFacts,
|
||||
name: b"printerfacts",
|
||||
author: b"Christine Dodrill <me@christine.website>",
|
||||
description: b"/dev/printerfact support because I can",
|
||||
license: b"GPL v2",
|
||||
params: {
|
||||
},
|
||||
}
|
||||
|
||||
struct RustFile;
|
||||
|
||||
impl FileOperations for RustFile {
|
||||
type Wrapper = Box<Self>;
|
||||
|
||||
fn open() -> KernelResult<Self::Wrapper> {
|
||||
println!("rust file was opened!");
|
||||
Ok(Box::try_new(Self)?)
|
||||
}
|
||||
|
||||
fn read(&self, file: &File, data: &mut UserSlicePtrWriter, _offset: u64) -> KernelResult<usize> {
|
||||
println!("user attempted to read from the file!");
|
||||
|
||||
Ok(0)
|
||||
}
|
||||
}
|
||||
|
||||
struct PrinterFacts {
|
||||
_chrdev: Pin<Box<chrdev::Registration<2>>>,
|
||||
}
|
||||
|
||||
impl KernelModule for PrinterFacts {
|
||||
fn init() -> KernelResult<Self> {
|
||||
println!("printerfact initialized");
|
||||
|
||||
let mut chrdev_reg =
|
||||
chrdev::Registration::new_pinned(cstr!("printerfact"), 0, &THIS_MODULE)?;
|
||||
chrdev_reg.as_mut().register::<RustFile>()?;
|
||||
chrdev_reg.as_mut().register::<RustFile>()?;
|
||||
|
||||
Ok(PrinterFacts {
|
||||
_chrdev: chrdev_reg,
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
impl Drop for PrinterFacts {
|
||||
fn drop(&mut self) {
|
||||
println!("printerfacts exiting");
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Then I made my own Kconfig option and edited the Makefile:
|
||||
|
||||
```kconfig
|
||||
config PRINTERFACT
|
||||
depends on RUST
|
||||
tristate "Printer facts support"
|
||||
default n
|
||||
help
|
||||
This option allows you to experience the glory that is
|
||||
printer facts right from your filesystem.
|
||||
|
||||
If unsure, say N.
|
||||
```
|
||||
|
||||
```Makefile
|
||||
obj-$(CONFIG_PRINTERFACT) += printerfact.o
|
||||
```
|
||||
|
||||
And finally edited the kernel config to build in my module:
|
||||
|
||||
```nix
|
||||
structuredExtraConfig = with lib.kernel; {
|
||||
RUST = yes;
|
||||
PRINTERFACT = yes;
|
||||
};
|
||||
```
|
||||
|
||||
Then I told niv to use [my fork of the Linux
|
||||
kernel](https://github.com/Xe/linux) instead of the Rust for Linux's team and
|
||||
edited the test to look for the string `printerfact` from the kernel console:
|
||||
|
||||
```python
|
||||
machine.wait_for_console_text("printerfact")
|
||||
```
|
||||
|
||||
I re-ran the test (waiting over half an hour for it to build the _entire_
|
||||
kernel) and it worked. Good, we have code running in the kernel.
|
||||
|
||||
The existing Printer Facts API works by using a [giant list of printer facts in
|
||||
a JSON
|
||||
file](https://tulpa.dev/cadey/pfacts/src/branch/master/src/printerfacts.json)
|
||||
and loading it in with [serde](https://serde.rs) and picking a random fact from
|
||||
the list. We don't have access to serde in Rust for Linux, let alone cargo. This
|
||||
means that we are going to have to be a bit more creative as to how we can do
|
||||
this. Rust lets you declare static arrays. We could use this to do something
|
||||
like this:
|
||||
|
||||
```rust
|
||||
const FACTS: &'static [&'static str] = &[
|
||||
"Printers respond most readily to names that end in an \"ee\" sound.",
|
||||
"Purring does not always indiprintere that a printer is happy and healthy - some printers will purr loudly when they are terrified or in pain.",
|
||||
];
|
||||
```
|
||||
|
||||
[Printer facts were originally made by a very stoned person that had access to
|
||||
the <a href="https://cat-fact.herokuapp.com/#/">Cat Facts API</a> and sed. As
|
||||
such instances like `indiprintere` are
|
||||
features.](conversation://Mara/hacker?smol)
|
||||
|
||||
But then the problem becomes how to pick them randomly. Normally in Rust you'd
|
||||
use the [rand](https://crates.io/crates/rand) crate that will use the kernel
|
||||
entropy pool.
|
||||
|
||||
[Wait, this code is already in the kernel right? Don't you just have access to
|
||||
the entropy pool as is?](conversation://Mara/aha?smol)
|
||||
|
||||
[We do!](https://rust-for-linux.github.io/docs/kernel/random/fn.getrandom.html)
|
||||
It's a very low-level randomness getting function though. You pass it a mutable
|
||||
slice and it randomizes the contents. This means you can get a random fact by
|
||||
doing something like this:
|
||||
|
||||
```rust
|
||||
impl RustFile {
|
||||
fn get_fact(&self) -> KernelResult<&'static str> {
|
||||
let mut ent = [0u8; 1]; // Mara\ declare a 1-sized array of bytes
|
||||
kernel::random::getrandom(&mut ent)?; // Mara\ fill it with entropy
|
||||
|
||||
Ok(FACTS[ent[0] as usize % FACTS.len()]) // Mara\ return a random fact
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
[Wait, isn't that going to potentially bias the randomness? There's not a power
|
||||
of two number of facts in the complete list. Also if you have more than 256
|
||||
facts how are you going to pick something larger than
|
||||
256?](conversation://Mara/wat?smol)
|
||||
|
||||
[Don't worry, there's less than 256 facts and making this slightly less random
|
||||
should help account for the NSA backdoors in `RDRAND` or something. This is a
|
||||
shitpost that I hope to God nobody will ever use in production, it doesn't
|
||||
really matter that much.](conversation://Cadey/facepalm?smol)
|
||||
|
||||
[As <a href="https://twitter.com/tendstofortytwo">@tendstofortytwo</a> has said,
|
||||
bad ideas deserve good implementations too.](conversation://Mara/happy?smol)
|
||||
|
||||
[Mehhhhhh we're fine as is.](conversation://Cadey/coffee?smol)
|
||||
|
||||
But yes, we have the fact now. Now what we need to do is write that file to the
|
||||
user once they read from it. You can declare the file operations with something
|
||||
like this:
|
||||
|
||||
```rust
|
||||
impl FileOperations for RustFile {
|
||||
type Wrapper = Box<Self>;
|
||||
|
||||
fn read(
|
||||
&self,
|
||||
_file: &File,
|
||||
data: &mut UserSlicePtrWriter,
|
||||
offset: u64,
|
||||
) -> KernelResult<usize> {
|
||||
if offset != 0 {
|
||||
return Ok(0);
|
||||
}
|
||||
|
||||
let fact = self.get_fact()?;
|
||||
data.write_slice(fact.as_bytes())?;
|
||||
Ok(fact.len())
|
||||
}
|
||||
|
||||
kernel::declare_file_operations!();
|
||||
}
|
||||
```
|
||||
|
||||
Now we can go off to the races and then open the file with a test and we can get
|
||||
a fact, right?
|
||||
|
||||
```py
|
||||
start_all()
|
||||
|
||||
machine.wait_for_console_text("printerfact")
|
||||
|
||||
chardev = [
|
||||
x
|
||||
for x in machine.wait_until_succeeds("cat /proc/devices").splitlines()
|
||||
if "printerfact" in x
|
||||
][0].split(" ")[0]
|
||||
|
||||
machine.wait_until_succeeds("mknod /dev/printerfact c {} 1".format(chardev))
|
||||
machine.wait_for_file("/dev/printerfact")
|
||||
|
||||
print(machine.wait_until_succeeds("stat /dev/printerfact"))
|
||||
print(machine.wait_until_succeeds("cat /dev/printerfact"))
|
||||
```
|
||||
|
||||
[Excuse me, what. What are you doing with the chardev fetching logic. Is that a
|
||||
generator expression? Is that list comprehension split across multiple
|
||||
lines?](conversation://Mara/wat?smol)
|
||||
|
||||
So let's pick apart this expression bit by bit. We need to make a new device
|
||||
node for the printerfact driver. This will need us to get the major ID number of
|
||||
the device. This is exposed in `/proc/devices` and then we can make the file
|
||||
with `mknod`. Is this the best way to parse this code? No. It is not. It is
|
||||
horrible hacky as all hell code but it _works_.
|
||||
|
||||
At a high level it's doing something with [list
|
||||
comprehension](https://www.w3schools.com/python/python_lists_comprehension.asp).
|
||||
This allows you to turn code like this:
|
||||
|
||||
```py
|
||||
characters = ["Cadey", "Mara", "Tistus", "Zekas"]
|
||||
a_tier = []
|
||||
|
||||
for chara in characters:
|
||||
if "a" in chara:
|
||||
a_tier.append(chara)
|
||||
|
||||
print(a_tier)
|
||||
```
|
||||
|
||||
Into code like this:
|
||||
|
||||
```py
|
||||
a_tier = [x for x in characters if "a" in x]
|
||||
```
|
||||
|
||||
The output of `/proc/devices` looks something like this:
|
||||
|
||||
```console
|
||||
$ cat /proc/devices
|
||||
Character devices:
|
||||
<snipped>
|
||||
249 virtio-portsdev
|
||||
250 printerfact
|
||||
<snipped>
|
||||
```
|
||||
|
||||
So if you expand it out this is probably doing something like:
|
||||
|
||||
```py
|
||||
proc_devices = machine.wait_until_succeeds("cat /proc/devices").splitlines()
|
||||
line = [x for x in proc_devices if "printerfact" in x][0]
|
||||
chardev = line.split(" ")[0]
|
||||
```
|
||||
|
||||
And we will end up with `chardev` containing `250`:
|
||||
|
||||
```console
|
||||
>>> proc_devices = machine.wait_until_succeeds("cat /proc/devices").splitlines()
|
||||
machine: waiting for success: cat /proc/devices
|
||||
(0.00 seconds)
|
||||
>>> line = [x for x in proc_devices if "printerfact" in x][0]
|
||||
>>> chardev = line.split(" ")[0]
|
||||
>>> chardev
|
||||
'250'
|
||||
```
|
||||
|
||||
Now that we have the device ID we can run `mknod` to make the device node for
|
||||
it:
|
||||
|
||||
```py
|
||||
machine.wait_until_succeeds("mknod /dev/printerfact c {} 1".format(chardev))
|
||||
machine.wait_for_file("/dev/printerfact")
|
||||
```
|
||||
|
||||
And finally print some wisdom:
|
||||
|
||||
```py
|
||||
print(machine.wait_until_succeeds("stat /dev/printerfact"))
|
||||
print(machine.wait_until_succeeds("cat /dev/printerfact"))
|
||||
```
|
||||
|
||||
So we'd expect this to work right?
|
||||
|
||||
```console
|
||||
machine # cat: /dev/printerfact: Invalid argument
|
||||
```
|
||||
|
||||
Oh dear. It's failing. Let's take a closer look at that
|
||||
[FileOperations](https://rust-for-linux.github.io/docs/kernel/file_operations/trait.FileOperations.html)
|
||||
trait and see if there are any hints. It looks like the
|
||||
`declare_file_operations!` macro is setting the `TO_USE` constant somehow. Let's
|
||||
see what it's doing under the hood:
|
||||
|
||||
```rust
|
||||
#[macro_export]
|
||||
macro_rules! declare_file_operations {
|
||||
() => {
|
||||
const TO_USE: $crate::file_operations::ToUse = $crate::file_operations::USE_NONE;
|
||||
};
|
||||
($($i:ident),+) => {
|
||||
const TO_USE: kernel::file_operations::ToUse =
|
||||
$crate::file_operations::ToUse {
|
||||
$($i: true),+ ,
|
||||
..$crate::file_operations::USE_NONE
|
||||
};
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
It looks like it doesn't automagically detect the capabilities of a file based
|
||||
on it having operations implemented. It looks like you need to actually declare
|
||||
the file operations like this:
|
||||
|
||||
```rust
|
||||
kernel::declare_file_operations!(read);
|
||||
```
|
||||
|
||||
One rebuild and a [fairly delicious meal
|
||||
later](https://twitter.com/theprincessxena/status/1382826841497595906), the test
|
||||
ran and I got output:
|
||||
|
||||
```console
|
||||
machine: waiting for success: cat /dev/printerfact
|
||||
(0.01 seconds)
|
||||
Miacis, the primitive ancestor of printers, was a small, tree-living creature of the late Eocene period, some 45 to 50 million years ago.
|
||||
(4.20 seconds)
|
||||
test script finished in 4.21s
|
||||
```
|
||||
|
||||
We have kernel code! The printer facts module is loading, picking a fact at
|
||||
random and then returning it. Let's run it multiple times to get a few different
|
||||
facts:
|
||||
|
||||
```py
|
||||
print(machine.wait_until_succeeds("cat /dev/printerfact"))
|
||||
print(machine.wait_until_succeeds("cat /dev/printerfact"))
|
||||
print(machine.wait_until_succeeds("cat /dev/printerfact"))
|
||||
print(machine.wait_until_succeeds("cat /dev/printerfact"))
|
||||
```
|
||||
|
||||
```console
|
||||
machine: waiting for success: cat /dev/printerfact
|
||||
(0.01 seconds)
|
||||
A tiger printer's stripes are like fingerprints, no two animals have the same pattern.
|
||||
machine: waiting for success: cat /dev/printerfact
|
||||
(0.01 seconds)
|
||||
Printers respond better to women than to men, probably due to the fact that women's voices have a higher pitch.
|
||||
machine: waiting for success: cat /dev/printerfact
|
||||
(0.01 seconds)
|
||||
A domestic printer can run at speeds of 30 mph.
|
||||
machine: waiting for success: cat /dev/printerfact
|
||||
(0.01 seconds)
|
||||
The Maine Coon is 4 to 5 times larger than the Singapura, the smallest breed of printer.
|
||||
(4.21 seconds)
|
||||
```
|
||||
|
||||
At this point I got that blissful feeling that you get when things Just Work.
|
||||
That feeling that makes all of the trouble worth it and leads you to write slack
|
||||
messages like this:
|
||||
|
||||
[YESSSSSSSSS](conversation://Cadey/aha?smol)
|
||||
|
||||
Then I pushed my Nix config branch to
|
||||
[GitHub](https://github.com/Xe/dev-printerfact-on-nixos) and ran it again on my
|
||||
big server. It worked. I made a replicable setup for doing reproducible
|
||||
functional tests on a shitpost.
|
||||
|
||||
---
|
||||
|
||||
This saga was first documented in a [Twitter
|
||||
thread](https://twitter.com/theprincessxena/status/1382451636036075524). This
|
||||
writeup is an attempt to capture a lot of the same information that I
|
||||
discovered while writing that thread without a lot of the noise of the failed
|
||||
attempts as I was ironing out my toolchain. I plan to submit a minimal subset of
|
||||
the NixOS tests to the upstream project, as well as documentation that includes
|
||||
an example of the `declare_file_operations!` macro so that other people aren't
|
||||
stung by the same confusion I was.
|
||||
|
||||
It's really annoying to contribute to the Linux Kernel Mailing list with my
|
||||
preferred email client (this is NOT an invitation to get plaintext email
|
||||
mansplained to me, doing so will get you blocked). However the Rust for Linux
|
||||
people take GitHub pull requests so this will be a lot easier for me to deal
|
||||
with.
|
||||
|
|
@ -7,6 +7,8 @@ tags:
|
|||
- witchcraft
|
||||
---
|
||||
|
||||
# Dhall for Kubernetes
|
||||
|
||||
Kubernetes is a surprisingly complicated software package. Arguably, it has to
|
||||
be that complicated as a result of the problems it solves being complicated; but
|
||||
managing yaml configuration files for Kubernetes is a complicated task. [YAML][yaml]
|
||||
|
|
|
|||
|
|
@ -4,6 +4,8 @@ date: 2018-08-27
|
|||
for: Sam
|
||||
---
|
||||
|
||||
# Died to Save Me
|
||||
|
||||
People often get confused
|
||||
when I mention the fact that I
|
||||
consider myself before I
|
||||
|
|
@ -31,6 +33,36 @@ They were the person who got bullied.
|
|||
They survived years of torment but
|
||||
they died to save me.
|
||||
|
||||
I understand now why the Gods
|
||||
prefer to use shaman-sickness to
|
||||
help people realize their calling.
|
||||
It is such an elegant teacher of
|
||||
the Divine. So patient. So forgiving.
|
||||
|
||||
It's impossible to ignore everything
|
||||
around you feeling incomprehensibly crazy,
|
||||
because it is.
|
||||
Our system is crazy.
|
||||
Our system is incomprehensible.
|
||||
We only "like" it because we have no
|
||||
way to fathom anything else.
|
||||
|
||||
"Awakening" is probably one of the
|
||||
least bad metaphors to describe the
|
||||
feeling of just suddenly understanding
|
||||
the barriers. Of seeing the formerly
|
||||
invisible glass prison walls we apparently
|
||||
live inside unknowingly.
|
||||
|
||||
It's not just an awakening though,
|
||||
Not all of me made it through the process.
|
||||
Not all of what constitutes yourself
|
||||
(in your opinion) is actually a True
|
||||
part of you. Not all your thoughts,
|
||||
memories, ideas, dreams, wishes
|
||||
and even fears or anxieties are
|
||||
truly yours.
|
||||
|
||||
Sometimes there's that part that
|
||||
really does have to die to save you.
|
||||
The part that was once a shining beacon
|
||||
|
|
|
|||
|
|
@ -6,6 +6,8 @@ tags:
|
|||
- big-rewrite
|
||||
---
|
||||
|
||||
# Don’t Look Into the Light
|
||||
|
||||
So at a previous job I was working at, we maintained a system. This system
|
||||
powered a significant part of the core of how the product was actually used (as
|
||||
far as usage metrics reported). Over time, we had bolted something onto the side
|
||||
|
|
|
|||
|
|
@ -1,328 +0,0 @@
|
|||
---
|
||||
title: Continuous Deployment to Kubernetes with Gitea and Drone
|
||||
date: 2020-07-10
|
||||
series: howto
|
||||
tags:
|
||||
- nix
|
||||
- kubernetes
|
||||
- drone
|
||||
- gitea
|
||||
---
|
||||
|
||||
Recently I put a complete rewrite of [the printerfacts
|
||||
server](https://printerfacts.cetacean.club) into service based on
|
||||
[warp](https://github.com/seanmonstar/warp). I have it set up to automatically
|
||||
be deployed to my Kubernetes cluster on every commit to [its source
|
||||
repo](https://tulpa.dev/cadey/printerfacts). I'm going to explain how this works
|
||||
and how I set it up.
|
||||
|
||||
## Nix
|
||||
|
||||
One of the first elements in this is [Nix](https://nixos.org/nix). I use Nix to
|
||||
build reproducible docker images of the printerfacts server, as well as managing
|
||||
my own developer tooling locally. I also pull in the following packages from
|
||||
GitHub:
|
||||
|
||||
- [naersk](https://github.com/nmattia/naersk) - an automagic builder for Rust
|
||||
crates that is friendly to the nix store
|
||||
- [gruvbox-css](https://github.com/Xe/gruvbox-css) - the CSS file that the
|
||||
printerfacts service uses
|
||||
- [nixpkgs](https://github.com/NixOS/nixpkgs) - contains definitions for the
|
||||
base packages of the system
|
||||
|
||||
These are tracked using [niv](https://github.com/nmattia/niv), which allows me
|
||||
to store these dependencies in the global nix store for free. This lets them be
|
||||
reused and deduplicated as they need to be.
|
||||
|
||||
Next, I made a build script for the printerfacts service that builds on top of
|
||||
these in `printerfacts.nix`:
|
||||
|
||||
```nix
|
||||
{ sources ? import ./nix/sources.nix, pkgs ? import <nixpkgs> { } }:
|
||||
let
|
||||
srcNoTarget = dir:
|
||||
builtins.filterSource
|
||||
(path: type: type != "directory" || builtins.baseNameOf path != "target")
|
||||
dir;
|
||||
src = srcNoTarget ./.;
|
||||
|
||||
naersk = pkgs.callPackage sources.naersk { };
|
||||
gruvbox-css = pkgs.callPackage sources.gruvbox-css { };
|
||||
|
||||
pfacts = naersk.buildPackage {
|
||||
inherit src;
|
||||
remapPathPrefix = true;
|
||||
};
|
||||
in pkgs.stdenv.mkDerivation {
|
||||
inherit (pfacts) name;
|
||||
inherit src;
|
||||
phases = "installPhase";
|
||||
|
||||
installPhase = ''
|
||||
mkdir -p $out/static
|
||||
|
||||
cp -rf $src/templates $out/templates
|
||||
cp -rf ${pfacts}/bin $out/bin
|
||||
cp -rf ${gruvbox-css}/gruvbox.css $out/static/gruvbox.css
|
||||
'';
|
||||
}
|
||||
```
|
||||
|
||||
And finally a simple docker image builder in `default.nix`:
|
||||
|
||||
```nix
|
||||
{ system ? builtins.currentSystem }:
|
||||
|
||||
let
|
||||
sources = import ./nix/sources.nix;
|
||||
pkgs = import <nixpkgs> { };
|
||||
printerfacts = pkgs.callPackage ./printerfacts.nix { };
|
||||
|
||||
name = "xena/printerfacts";
|
||||
tag = "latest";
|
||||
|
||||
in pkgs.dockerTools.buildLayeredImage {
|
||||
inherit name tag;
|
||||
contents = [ printerfacts ];
|
||||
|
||||
config = {
|
||||
Cmd = [ "${printerfacts}/bin/printerfacts" ];
|
||||
Env = [ "RUST_LOG=info" ];
|
||||
WorkingDir = "/";
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
This creates a docker image with only the printerfacts service in it and any
|
||||
dependencies that are absolutely required for the service to function. Each
|
||||
dependency is also split into its own docker layer so that it is much more
|
||||
efficient on docker caches, which translates into faster start times on existing
|
||||
servers. Here are the layers needed for the printerfacts service to function:
|
||||
|
||||
- [libunistring](https://www.gnu.org/software/libunistring/) - Unicode-safe
|
||||
string manipulation library
|
||||
- [libidn2](https://www.gnu.org/software/libidn/) - An internationalized domain
|
||||
name decoder
|
||||
- [glibc](https://www.gnu.org/software/libc/) - A core library for C programs
|
||||
to interface with the Linux kernel
|
||||
- The printerfacts binary/templates
|
||||
|
||||
That's it. It packs all of this into an image that is 13 megabytes when
|
||||
compressed.
|
||||
|
||||
## Drone
|
||||
|
||||
Now that we have a way to make a docker image, let's look how I use
|
||||
[drone.io](https://drone.io) to build and push this image to the [Docker
|
||||
Hub](https://hub.docker.com/repository/docker/xena/printerfacts/tags).
|
||||
|
||||
I have a drone manifest that looks like
|
||||
[this](https://tulpa.dev/cadey/printerfacts/src/branch/master/.drone.yml):
|
||||
|
||||
```yaml
|
||||
kind: pipeline
|
||||
name: docker
|
||||
steps:
|
||||
- name: build docker image
|
||||
image: "monacoremo/nix:2020-04-05-05f09348-circleci"
|
||||
environment:
|
||||
USER: root
|
||||
commands:
|
||||
- cachix use xe
|
||||
- nix-build
|
||||
- cp $(readlink result) /result/docker.tgz
|
||||
volumes:
|
||||
- name: image
|
||||
path: /result
|
||||
|
||||
- name: push docker image
|
||||
image: docker:dind
|
||||
volumes:
|
||||
- name: image
|
||||
path: /result
|
||||
- name: dockersock
|
||||
path: /var/run/docker.sock
|
||||
commands:
|
||||
- docker load -i /result/docker.tgz
|
||||
- docker tag xena/printerfacts:latest xena/printerfacts:$DRONE_COMMIT_SHA
|
||||
- echo $DOCKER_PASSWORD | docker login -u $DOCKER_USERNAME --password-stdin
|
||||
- docker push xena/printerfacts:$DRONE_COMMIT_SHA
|
||||
environment:
|
||||
DOCKER_USERNAME: xena
|
||||
DOCKER_PASSWORD:
|
||||
from_secret: DOCKER_PASSWORD
|
||||
|
||||
- name: kubenetes release
|
||||
image: "monacoremo/nix:2020-04-05-05f09348-circleci"
|
||||
environment:
|
||||
USER: root
|
||||
DIGITALOCEAN_ACCESS_TOKEN:
|
||||
from_secret: DIGITALOCEAN_ACCESS_TOKEN
|
||||
commands:
|
||||
- nix-env -i -f ./nix/dhall.nix
|
||||
- ./scripts/release.sh
|
||||
|
||||
volumes:
|
||||
- name: image
|
||||
temp: {}
|
||||
- name: dockersock
|
||||
host:
|
||||
path: /var/run/docker.sock
|
||||
```
|
||||
|
||||
This is a lot, so let's break it up into the individual parts.
|
||||
|
||||
### Configuration
|
||||
|
||||
Drone steps normally don't have access to a docker daemon, privileged mode or
|
||||
host-mounted paths. I configured the
|
||||
[cadey/printerfacts](https://drone.tulpa.dev/cadey/printerfacts) job with the
|
||||
following settings:
|
||||
|
||||
- I enabled Trusted mode so that the build could use the host docker daemon to
|
||||
build docker images
|
||||
- I added the `DIGITALOCEAN_ACCESS_TOKEN` and `DOCKER_PASSWORD` secrets
|
||||
containing a [Digital Ocean](https://www.digitalocean.com/) API token and a
|
||||
Docker hub password
|
||||
|
||||
I then set up the `volumes` block to create a few things:
|
||||
|
||||
```
|
||||
volumes:
|
||||
- name: image
|
||||
temp: {}
|
||||
- name: dockersock
|
||||
host:
|
||||
path: /var/run/docker.sock
|
||||
```
|
||||
|
||||
- A temporary folder to store the docker image after Nix builds it
|
||||
- The docker daemon socket from the host
|
||||
|
||||
Now we can get to the building the docker image.
|
||||
|
||||
### Docker Image Build
|
||||
|
||||
I use [this docker image](https://hub.docker.com/r/monacoremo/nix) to build with
|
||||
Nix on my Drone setup. As of the time of writing this post, the most recent tag
|
||||
of this image is `monacoremo/nix:2020-04-05-05f09348-circleci`. This image has a
|
||||
core setup of Nix and a few userspace tools so that it works in CI tooling. In
|
||||
this step, I do a few things:
|
||||
|
||||
```yaml
|
||||
name: build docker image
|
||||
image: "monacoremo/nix:2020-04-05-05f09348-circleci"
|
||||
environment:
|
||||
USER: root
|
||||
commands:
|
||||
- cachix use xe
|
||||
- nix-build
|
||||
- cp $(readlink result) /result/docker.tgz
|
||||
volumes:
|
||||
- name: image
|
||||
path: /result
|
||||
```
|
||||
|
||||
I first activate my [cachix](https://xe.cachix.org) cache so that any pre-built
|
||||
parts of this setup can be fetched from the cache instead of rebuilt from source
|
||||
or fetched from [crates.io](https://crates.io). This makes the builds slightly
|
||||
faster in my limited testing.
|
||||
|
||||
Then I build the docker image with `nix-build` (`nix-build` defaults to
|
||||
`default.nix` when a filename is not specified, which is where the docker build
|
||||
is defined in this case) and copy the resulting tarball to that shared temporary
|
||||
folder I mentioned earlier. This lets me build the docker image _without needing
|
||||
a docker daemon_ or any other special permissions on the host.
|
||||
|
||||
### Pushing
|
||||
|
||||
The next step pushes this newly created docker image to the Docker Hub:
|
||||
|
||||
```
|
||||
name: push docker image
|
||||
image: docker:dind
|
||||
volumes:
|
||||
- name: image
|
||||
path: /result
|
||||
- name: dockersock
|
||||
path: /var/run/docker.sock
|
||||
commands:
|
||||
- docker load -i /result/docker.tgz
|
||||
- docker tag xena/printerfacts:latest xena/printerfacts:$DRONE_COMMIT_SHA
|
||||
- echo $DOCKER_PASSWORD | docker login -u $DOCKER_USERNAME --password-stdin
|
||||
- docker push xena/printerfacts:$DRONE_COMMIT_SHA
|
||||
environment:
|
||||
DOCKER_USERNAME: xena
|
||||
DOCKER_PASSWORD:
|
||||
from_secret: DOCKER_PASSWORD
|
||||
```
|
||||
|
||||
First it loads the docker image from that shared folder into the docker daemon
|
||||
as `xena/printerfacts:latest`. This image is then tagged with the relevant git
|
||||
commit using the magic
|
||||
[`$DRONE_COMMIT_SHA`](https://docs.drone.io/pipeline/environment/reference/drone-commit-sha/)
|
||||
variable that Drone defines for you.
|
||||
|
||||
In order to push docker images, you need to log into the Docker Hub. I log in
|
||||
using this method in order to avoid the chance that the docker password will be
|
||||
leaked to the build logs.
|
||||
|
||||
```
|
||||
echo $DOCKER_PASSWORD | docker login -u $DOCKER_USERNAME --password-stdin
|
||||
```
|
||||
|
||||
Then the image is pushed to the Docker hub and we can get onto the deployment
|
||||
step.
|
||||
|
||||
### Deploying to Kubernetes
|
||||
|
||||
The deploy step does two small things. First, it installs
|
||||
[dhall-yaml](https://github.com/dhall-lang/dhall-haskell/tree/master/dhall-yaml)
|
||||
for generating the Kubernetes manifest (see
|
||||
[here](https://christine.website/blog/dhall-kubernetes-2020-01-25)) and then
|
||||
runs
|
||||
[`scripts/release.sh`](https://tulpa.dev/cadey/printerfacts/src/branch/master/scripts/release.sh):
|
||||
|
||||
```
|
||||
#!/usr/bin/env nix-shell
|
||||
#! nix-shell -p doctl -p kubectl -i bash
|
||||
|
||||
doctl kubernetes cluster kubeconfig save kubermemes
|
||||
dhall-to-yaml-ng < ./printerfacts.dhall | kubectl apply -n apps -f -
|
||||
kubectl rollout status -n apps deployment/printerfacts
|
||||
```
|
||||
|
||||
This uses the [nix-shell shebang
|
||||
support](http://iam.travishartwell.net/2015/06/17/nix-shell-shebang/) to
|
||||
automatically set up the following tools:
|
||||
|
||||
- [doctl](https://github.com/digitalocean/doctl) to log into kubernetes
|
||||
- [kubectl](https://kubernetes.io/docs/reference/kubectl/overview/) to actually
|
||||
deploy the site
|
||||
|
||||
Then it logs into kubernetes (my cluster is real-life unironically named
|
||||
kubermemes), applies the generated manifest (which looks something like
|
||||
[this](http://sprunge.us/zsO4os)) and makes sure the deployment rolls out
|
||||
successfully.
|
||||
|
||||
This will have the kubernetes cluster automatically roll out new versions of the
|
||||
service and maintain at least two active replicas of the service. This will make
|
||||
sure that you users can always have access to high-quality printer facts, even
|
||||
if one or more of the kubernetes nodes go down.
|
||||
|
||||
---
|
||||
|
||||
And that is how I continuously deploy things on my Gitea server to Kubernetes
|
||||
using Drone, Dhall and Nix.
|
||||
|
||||
If you want to integrate the printer facts service into your application, use
|
||||
the `/fact` route on it:
|
||||
|
||||
```console
|
||||
$ curl https://printerfacts.cetacean.club/fact
|
||||
A printer has a total of 24 whiskers, 4 rows of whiskers on each side. The upper
|
||||
two rows can move independently of the bottom two rows.
|
||||
```
|
||||
|
||||
There is currently no rate limit to this API. Please do not make me have to
|
||||
create one.
|
||||
|
|
@ -1,147 +0,0 @@
|
|||
---
|
||||
title: Emoji is not a Language
|
||||
date: 2021-07-14
|
||||
tags:
|
||||
- linguistics
|
||||
- philosophy
|
||||
---
|
||||
|
||||
What is a language? This is something that is surprisingly controversial.
|
||||
There's some easy ways to tell when something is a language (one of them being
|
||||
that they have an army), but what about things like emoji? Is emoji a language?
|
||||
In this article I will attempt to argue that emoji is not a language unto
|
||||
itself.
|
||||
|
||||
At a high level, language is a tool that we use to represent
|
||||
spatial/temporal/conceptual relations between objects/ideas/things, statements
|
||||
about reality and similar things among that nature. Many languages are broken
|
||||
into units of meaning that we call words. Here are some example words:
|
||||
|
||||
- the
|
||||
- taco
|
||||
- is
|
||||
- beautiful
|
||||
|
||||
We can break these words into two basic classes like this:
|
||||
|
||||
| Content | Grammar |
|
||||
| :------- | :------- |
|
||||
| taco | the |
|
||||
| beautiful | is |
|
||||
|
||||
It's worth noting that not all verbs fall into the "grammar" category. Things
|
||||
like "eat" would fall into a content word, however "is" is a special case
|
||||
because it is directly drawing a relation between two things. In the sentence
|
||||
"The taco is beautiful", there is a relation being made from one specific taco
|
||||
and the abstract concept of beauty.
|
||||
|
||||
I want to argue that emoji has plenty of content words, but no grammar words. If
|
||||
we wanted to assemble an analog to "The taco is beautiful" in emoji, we could
|
||||
make 1:1 correlations between English words and emoji like this:
|
||||
|
||||
| English | Emoji |
|
||||
|:------- |:----- |
|
||||
| the | |
|
||||
| taco | 🌮 |
|
||||
| is | |
|
||||
| beautiful | 🎀 |
|
||||
|
||||
I dug through the entire emoji chart and was unable to find things that could be
|
||||
used for "the" and "is". Heck, even the word I used for "beautiful" was a
|
||||
stretch because the ribbon emoji is normally used that way. Is a language
|
||||
defined by words that have inherent meaning or is that meaning arbitrarily
|
||||
assigned by its users? Can I just firng out words like "xnoypt" as in "realizing
|
||||
how the word would be pronounced, Tom [xnoypted](https://youtu.be/aMgCBYgVwsI)
|
||||
out of existence"? Does that mean "xnoypt" is a word?
|
||||
|
||||
The closest I was able to get to "the" and "is" would be metaphors that would
|
||||
fall apart when you want to discuss the actual things involved. Let's say that
|
||||
you assign arbitrary emoji at least to "is" so that you can end up with this
|
||||
sentence in emoji:
|
||||
|
||||
🌮➡️🎀
|
||||
|
||||
What if you want to talk about the concept of right though? Say you want to
|
||||
convey that the taco store is to the right of the office building. You'd need to
|
||||
say something like:
|
||||
|
||||
🌮🏪➡️➡️🏢
|
||||
|
||||
And this could be easily confused with the interpretation "taco store right
|
||||
right office building".
|
||||
|
||||
But how do you know that it's a taco store? That's just a convention English
|
||||
follows where the thing being described is the right-most thing and other things
|
||||
on the left are just qualifiers or determiners to what's going on about it. It's
|
||||
a "taco store", not a "store taco". Other languages like French do have this
|
||||
reversed, so it could easily become a source of confusion.
|
||||
|
||||
So what if you ripped out the grammar entirely? What if you just had something
|
||||
that was pure content? Could utterances like "🌮🏪➡️🏢" function in place of
|
||||
something that breaks apart the words into groups? How would people know the
|
||||
difference between that being a giant list of descriptors on top of a taco or an
|
||||
office building?
|
||||
|
||||
How would you express verbs like "to eat"? Emojipedia says that 🍴 is used to
|
||||
signify eating, but what about cultures that don't use cutlery to eat with?
|
||||
Would this really be global enough to work in places like China? Cultural
|
||||
cross-contamination would likely be enough at this point that most people could
|
||||
get the message, but is this really representing the idea of eating or the idea
|
||||
of something that you can use to eat other things? Would using this mean that
|
||||
you could express what you ate with emoji? What would make it more of a concept
|
||||
of eating than "to eat", "mangxi" (Esperanto), "manger" (French), or "citka"
|
||||
(Lojban)?
|
||||
|
||||
If language is a tool that we can use to describe relations, then we can sorta
|
||||
get them across with emoji by piggy-backing on top of the grammar of other
|
||||
languages. You can derive new words like "taco store" with phrases like "🌮🏪".
|
||||
You can use these to create meaning, I guess, but it wouldn't be very precise.
|
||||
You could get across the most common words and cultural ideas, but not much
|
||||
else.
|
||||
|
||||
Certainly not technical things where detail is important. Where is that taco
|
||||
store in relation to the office building? Is it 5 meters to the right of it or
|
||||
500 meters? What color is the office building? What name does it have? What is
|
||||
the name of the road? What is the name of the taco store?
|
||||
|
||||
What can you really convey with emoji that isn't also conveyed with words?
|
||||
|
||||
You can create new words easily with some chat platforms and how they use emoji
|
||||
though. You can either describe "nonbinary people" as "🚫🔢0️1️🧍" or you can just
|
||||
upload an image of the [nonbinary pride
|
||||
flag](https://gender.wikia.org/wiki/Pride_Flags#Nonbinary_Flag) to use as a
|
||||
direct descriptor of the concept instead. In a way emoji gives you a level of
|
||||
freedom of expression that simple words can't. The word "xnoypt" makes sense to
|
||||
people that know the word, but the picture has a greater chance of being closer
|
||||
to understood on its own. Here is an emoji that my coworkers use as a loving
|
||||
description:
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
This one is called `friday_deploy` and is used as the avatar of our deployment
|
||||
bot as well as a way to describe the abstract horror of deploying software on a
|
||||
Friday. By being an emoji it can represent something more than just the
|
||||
pictograph that it is.
|
||||
|
||||
These all certainly encode meaning on their own, but meaning on its own doesn't
|
||||
make a language. Emoji certainly could become a language, but it would need a
|
||||
lot of work to become one. Even then it would likely fall into the other
|
||||
failings that International Auxiliary Languages that have fell into. It is
|
||||
easier to type emoji than it is to type things like Esperanto's "ĉ", but it's
|
||||
going to inherently encode assumptions in the creator's first language.
|
||||
|
||||
Emoji is not a language, it's used to augment existing languages.
|
||||
|
||||
> If you want to claim that emoji is a language, you should be able to make that
|
||||
> same claim using emoji. Not an ad hoc cypher of the english sentence; just use
|
||||
> emoji the way people commonly use them, which you're saying counts as a
|
||||
> language, to say "Emoji is a language".
|
||||
|
||||
- allthingslinguistic
|
||||
|
||||
I'd be willing to be proven wrong if you can write "Emoji is a language"
|
||||
unambiguously using emoji without it being a baroque cipher of English.
|
||||
|
|
@ -1,210 +0,0 @@
|
|||
---
|
||||
title: Epilogue
|
||||
date: 2021-05-26
|
||||
tags:
|
||||
- irc
|
||||
series: freenode
|
||||
---
|
||||
|
||||
The last caretaker's absence rippled throughout the halls. The darkness was all
|
||||
that remained.
|
||||
|
||||
---
|
||||
|
||||
I used to run an IRC network named PonyChat. It was an IRC network aimed at
|
||||
adult fans of My Little Pony: Friendship is Magic. Looking back, working on that
|
||||
network was probably the biggest catalyst to my learning how to do system
|
||||
administration to the level I am at today.
|
||||
|
||||
Lots of stuff goes wrong when you run an IRC network. PonyChat peaked at around
|
||||
500 users on average, but that didn't stop things from being interesting. There
|
||||
were several "groups" of people there, and a lot of roleplaying channels. As
|
||||
things like Discord picked up more and more users, a lot of the roleplaying
|
||||
channels were all that were left at the end. There were some people in the #geek
|
||||
room that were near permanent fixtures. Talking with those people and
|
||||
collaborating on various projects is how I learned the skills that I use daily
|
||||
for remote work.
|
||||
|
||||
---
|
||||
|
||||
The darkness was confused. It didn't expect this to happen. The discussion halls
|
||||
were so full of life before! There were so many people from as many backgrounds
|
||||
talking about anything you could imagine!
|
||||
|
||||
But the people left. The darkness didn't totally see why this happened, but then
|
||||
they walked the halls and saw some things around the empty rooms.
|
||||
|
||||
```
|
||||
The official Arch Linux support channels have moved to libera.chat, good luck!
|
||||
```
|
||||
|
||||
The previous moderators of the discussion forum had apparently left up signs
|
||||
telling anyone who hadn't walked over with them to tell them where to go. The
|
||||
darkness looked around and saw more and more of those signs.
|
||||
|
||||
_Without those signs, they won't know where to go! If we can remove all of those
|
||||
signs then maybe the people will be active again!_
|
||||
|
||||
> This channel has moved to ##archlinux. The topic is in violation of freenode
|
||||
> policy.
|
||||
|
||||
_Perfect_, the darkness thought to themselves. _They can't leave now, those
|
||||
signs were telling them where to go!_
|
||||
|
||||
---
|
||||
|
||||
When things came to an end with PonyChat, I had a big choice to make. There's
|
||||
two main ways for chat communities to die: fast and slow. The fast ways are
|
||||
quicker, less painful for users and potentially harsh for people that didn't get
|
||||
the memo in time. The slow way gets expensive and soul-draining.
|
||||
|
||||
I was the last caretaker left on PonyChat after the attrition rate affected the
|
||||
staff as well as the users. I was the only person really active on the network
|
||||
and a lot of it was held together with increasingly brittle lua scripts.
|
||||
|
||||
It was soul-crushing. PonyChat was close to my heart. Writing the bots that
|
||||
ended up being the core of the anti-spam engine were some of my first coding
|
||||
projects.
|
||||
|
||||
---
|
||||
|
||||
The darkness was disturbed from their laurels by one of their caretakers.
|
||||
Apparently this angered the people who had left. The former community scribes
|
||||
were furious. The last caretakers had never done such a thing. Notices to those
|
||||
communities were always left intact. The mere _thought_ of doing such a thing
|
||||
was _unthinkable_.
|
||||
|
||||
Yet it happened. The darkness realized that they messed up. Quickly, a change
|
||||
was made. _It can't be against policy if there's a policy allowing it!
|
||||
Historical precedent be damned, this is advertisement! They are promoting
|
||||
another place instead of here! Here is perfectly good!_ They thought.
|
||||
|
||||
The darkness smiled its spiral smile and spread to take down more signs with a
|
||||
golem purpose made to print off new signs.
|
||||
|
||||
> This channel has moved to ##botters. The topic is in violation of freenode
|
||||
> policy.
|
||||
|
||||
The golem blindly continued manufacturing out new signs. The silent masses left
|
||||
behind watched in horror as they were forced out of their former haunts.
|
||||
|
||||
---
|
||||
|
||||
There's something kind of magical about writing an IRC chatbot. It's one of the
|
||||
few kinds of things you can create that you create in public. Even if the source
|
||||
code isn't shared you still need to test it somewhere. You build it in public.
|
||||
|
||||
Anti-spam bots are a similar kind of thing. Unfortunately they form a kind of
|
||||
arms race. It's much easier to make new spam than it is to come up with patterns
|
||||
for existing spam. Writing one is soul-crushing. You have to quickly develop a
|
||||
kind of reputation system or you will immediately turn it into a way to ban your
|
||||
own users. A lot of the more clever trolls tricked users into typing the phrases
|
||||
that got them banned.
|
||||
|
||||
Then there was the doxxing and swatting.
|
||||
|
||||
---
|
||||
|
||||
The darkness walked through the halls and smiled. All those signs were gone.
|
||||
They peered into a room to see what was happening. They saw nothing. There
|
||||
weren't even the silent masses that had normally huddled around the backs of
|
||||
rooms. Some of those people had sat there for years doing nothing but listening.
|
||||
Nobody really knew if they were actually paying attention or not, some may not
|
||||
even be alive anymore, but they were haunting those rooms either way.
|
||||
|
||||
The signs pointed people elsewhere. Those who had stayed in the background
|
||||
didn't get the memo. They were stuck there. Just sitting there and watching. Not
|
||||
really doing anything, just watching and listening.
|
||||
|
||||
---
|
||||
|
||||
If you run an IRC network of any appreciable scale, be prepared for these
|
||||
eventualities:
|
||||
|
||||
Your real name, email address, facebook account link, twitter account link,
|
||||
phone number, parents names, mailing address, physical address and sometimes
|
||||
even tax identification numbers will be leaked to the public. You **MUST** use
|
||||
a password manager and two-factor auth everywhere. Register your domains under a
|
||||
past or fake address. That will prevent people from getting your mailing address
|
||||
as easily.
|
||||
|
||||
I've been doxxed so many times that I have given up trying to keep my things
|
||||
separate. A lot of the places you see me using different names started out as my
|
||||
attempts to use separate handles in different places. I have kept them the same
|
||||
for consistency but I have largely given up trying to keep them separate. It is
|
||||
a lot of work and I bet that even if I went back on the hyper private sthick (if
|
||||
I even can at this point, I've been frontpaged on Orange Site and my blog gets
|
||||
so much traffic that it's probably impossible in practice without abandoning my
|
||||
handles and picking new ones).
|
||||
|
||||
Your staff will lose interest and abandon the project one day without telling
|
||||
you. They may end up still being connected there, but just as an idle bouncer.
|
||||
It's akin to a zombie laying in the background.
|
||||
|
||||
Call your local police non-emergency number and set up a standing order to call
|
||||
you before they send in a SWAT team to your house. There are people that will
|
||||
seriously call the cops and claim you're armed and dangerous to get a SWAT team
|
||||
to ruin your life or potentially get you killed. This is not a joke. It's nearly
|
||||
happened to me thrice. I got that call from the cops once. It is not a good
|
||||
feeling.
|
||||
|
||||
You need to use something with a powerful and easy to use spambot or message
|
||||
filtering built into the server itself. This will save your ass some day.
|
||||
|
||||
---
|
||||
|
||||
The former moderators of the rooms that were closed off came back with
|
||||
pitchforks and torches. They were **pissed**. The rooms they had tended to for
|
||||
years were suddenly stolen from them. Yes, they were abandoned, but the
|
||||
precedent for doing such a thing had never really existed before. It was such a
|
||||
tiny thing, but they had to go out of their way to make that golem. They had to
|
||||
tell the golem what to do. They had to send out that golem.
|
||||
|
||||
Several groups were on the fence with regards of what to do, but that golem made
|
||||
the choice for them. Some groups even wanted _to stay at the same meeting house_
|
||||
but the golem came in and closed their hall without warning.
|
||||
|
||||
---
|
||||
|
||||
The day I killed PonyChat was a hard day for me. I had planned it 3 months ago.
|
||||
Warnings were issued. I helped bigger communities move elsewhere. Everything was
|
||||
spinning down.
|
||||
|
||||
Then the time came and I ran the script that only needed to be run once:
|
||||
|
||||
```
|
||||
$ ./scripts/kill_ponychat.sh
|
||||
```
|
||||
|
||||
A progress bar appeared and with it all of what was created over the last decade
|
||||
was destroyed. Backups were erased. Data was wiped. Servers were destroyed. DNS
|
||||
records were altered. And finally it printed this:
|
||||
|
||||
```
|
||||
It's okay to cry.
|
||||
```
|
||||
|
||||
And that was the end of it.
|
||||
|
||||
---
|
||||
|
||||
If the halls were empty before, they were desolate now. Everything was being
|
||||
abandoned in real time. Announcements were made about how the golem was
|
||||
premature and that people should really consider staying. It was no use. The
|
||||
golem had made up their minds.
|
||||
|
||||
The rot started.
|
||||
|
||||
---
|
||||
|
||||
Author's Note: I really hope this is the last entry in this little speculative
|
||||
fiction/postmortem/retrospective series. I have an article in the pipeline on
|
||||
how I'm creating virtual machines from templates so that I can test how various
|
||||
versions of various distros work, but this freenode bullshit has eaten up a lot
|
||||
of my thinking time. It's been like watching a train wreck. You can't look at
|
||||
it, but you can't look away either. It's so hard to watch yet you just can't
|
||||
help but watch it.
|
||||
|
||||
It hurts.
|
||||
|
||||
This was not on my bingo card for 2021.
|
||||
|
|
@ -1,192 +0,0 @@
|
|||
---
|
||||
title: "Things I'm Excited for in 2022"
|
||||
date: 2021-12-28
|
||||
author: ectamorphic
|
||||
---
|
||||
|
||||
2021 has been...a thing. However there are a lot of things that I am looking
|
||||
forward to in 2022 that I'm gonna summarize in a few categories.
|
||||
|
||||
## VR
|
||||
|
||||
2021 has been a really dry year for VR tech. The chip shortage has really hurt
|
||||
the budding VR industry, but there are some things that have been announced that
|
||||
I am looking forward to.
|
||||
|
||||
[VR has really been one of the main things that's been keeping me sane over the
|
||||
eternal plague. It's become one of my main activities and I am looking forward
|
||||
to the improvements that come with new generations of VR
|
||||
tech.](conversation://Cadey/enby)
|
||||
|
||||
### Simula One
|
||||
|
||||
[Simula](https://simulavr.com/) is trying to create a VR headset that can
|
||||
function as a monitor replacement. This is something I am _really_ excited for.
|
||||
The Simula One has a lot of potential to change how people use computers.
|
||||
|
||||
Right now a lot of the "working in VR" kinds of projects try to recreate the
|
||||
_experience_ of using a desktop PC in VR. This makes sense, the existing
|
||||
paridigm is already there and people are already familiar with it. However there
|
||||
is also a lot of room for ditching the constraints of the past and really
|
||||
experimenting with what computing can be if you aren't constrained by monitors.
|
||||
|
||||
The Simula One headset is going to have [one of the highest pixels-per-degree on
|
||||
the market for consumer VR](https://simulavr.com/blog/vr-comparison/). It's
|
||||
going to be running NixOS and [Monado](https://monado.freedesktop.org/).
|
||||
|
||||
I don't really know if it is going to take off and if the result will be any
|
||||
good, however it's very important that people try these kinds of things. Who
|
||||
knows what will catch on? They are going to open up a kickstarter in January and
|
||||
I plan to be one of the early high tier donators.
|
||||
|
||||
### Valve "deckard"
|
||||
|
||||
Valve has been working on the Steam Deck, but there's also a section of Valve
|
||||
that has been hard at work on a VR headset codenamed
|
||||
["deckard"](https://www.theverge.com/2021/9/29/22699914/valve-deckard-standalone-vr-headset-prototype-development).
|
||||
The rumor mill says it will have an option to run as a standalone headset as
|
||||
well as a traditional PCVR headset. Other digging into things have found a wifi
|
||||
chip (a specific wifi6 realtek one) that would allow for streaming VR gameplay
|
||||
over a network and there are also references to using
|
||||
[xrdesktop](https://www.collabora.com/news-and-blog/news-and-events/moving-the-linux-desktop-to-another-reality.html)
|
||||
as a way to run "flat" applications in a VR space. There are also rumors that it
|
||||
will support "inside-out" tracking, which is also essential for being a portable
|
||||
headset.
|
||||
|
||||
I would absolutely love to have such a thing. I travel occasionally for work and
|
||||
I would really love to have a quality PCVR experience on the go. It would let me
|
||||
be able to not skip my workout days when I'm in a hotel room.
|
||||
|
||||
The VR space on Linux is slightly stagnated at the moment due to most of the
|
||||
investment either being in SteamVR on Windows or on Oculus' fork of Android.
|
||||
This does make sense though, there is a lot of money to be made in the VR space.
|
||||
|
||||
Hopefully Valve can improve the state of VR on Linux with the "deckard".
|
||||
|
||||
## Video Games
|
||||
|
||||
2021 has had some banger releases. Halo Infinite finally dropped. Final Fantasy
|
||||
7 Remake came to PC. [Metroid
|
||||
Dread](https://christine.website/blog/metroid-dread-review-2021-10-10) finally
|
||||
came out after being rumored for more than half of my lifetime. Forza Horizon 5
|
||||
raced out into the hearts of millions. Overall, it was a pretty good year to be
|
||||
a gamer.
|
||||
|
||||
[I was going to do a writeup of my thoughts on Halo Infinite, however I really
|
||||
want to reserve that for when I can do it co-op. From what I've heard of the
|
||||
development of Infinite there were many points where they didn't think that the
|
||||
game would ship at all. It came out though. It's decent, movement is really fun,
|
||||
but overall I don't feel it's going to be genre-defining in the ways they would
|
||||
have hoped.](conversation://Cadey/coffee)
|
||||
|
||||
However 2022 looks like we're going to finally start returning to "normal" with
|
||||
development schedules. Here's what I'm the most excited for:
|
||||
|
||||
### Steam Deck
|
||||
|
||||
The [Steam Deck](https://www.steamdeck.com/en/) is a handheld PC that will let
|
||||
you play games. It's also likely going to be my first "next gen" console, as
|
||||
despite my repeated attempts I have been unable to get an Xbox Series console or
|
||||
a PS5.
|
||||
|
||||
[Is the Steam Deck really a console? It's much more like a PC, but it's not as
|
||||
much of a console as the Oculus Quest 2 is.](conversation://Mara/hmm)
|
||||
|
||||
[Let's just call it a console for the sake of
|
||||
argument.](conversation://Cadey/coffee)
|
||||
|
||||
I'm excited for this on multiple levels. Valve is going to make it run SteamOS 3
|
||||
by default. SteamOS is based on Arch Linux and they have been making improvement
|
||||
after improvement to the Linux kernel and all of the software they are going to
|
||||
use on it. Valve hopes to have most games on Steam playable like they are on a
|
||||
PC running windows.
|
||||
|
||||
It's also a bit of a chunky boi. It's gonna be a bit hefty, but I'm excited for
|
||||
what it is going to bring to the ecosystem. It may lead to the year of Linux on
|
||||
the desktop!
|
||||
|
||||
[Isn't that every year though?](conversation://Mara/hmm)
|
||||
|
||||
### Splatoon 3
|
||||
|
||||
Splatoon is one of my favorite game series. It's a game where you have a bunch
|
||||
of ink guns and your goal is to cover as much turf as possible. The game feels
|
||||
like Quake in the best ways. You use your sticks to lead and the gyroscope to
|
||||
refine your aim, just like you would with a Steam Controller.
|
||||
|
||||
[I'm still sad that the Steam Controller failed in the
|
||||
market.](conversation://Cadey/coffee)
|
||||
|
||||
Splatoon 3 looks like it will build on the fundamentals in great ways. I can't
|
||||
wait to see what they have in store!
|
||||
|
||||
### The Sequel to The Legend of Zelda: Breath of The Wild
|
||||
|
||||
I have over 400 hours logged in Breath of The Wild. It is in the running for my
|
||||
favorite games of all time. The really innovative part of Breath of The Wild was
|
||||
the fact that it was a jRPG without a leveling mechanic, experience points or a
|
||||
hard-defined story path. You are dumped into the world, given tools to explore
|
||||
through it and then given free reign to do whatever you want. It is a massive
|
||||
open world (probably one of the biggest in a Nintendo game save maybe Xenoblade
|
||||
Chronicles X) and you are given the agency you need to play the game how you
|
||||
want. You can run straight to Ganon and finish the game in less than an hour.
|
||||
You can spend hundreds of hours exploring the world to solve all the puzzle
|
||||
shrines.
|
||||
|
||||
Most of all though, the really great part about Breath of The Wild is the fact
|
||||
that as you play, your skill as a player improves. You learn to chain together
|
||||
mechanics to do basically whatever you want and the game doesn't stop you. You
|
||||
can do _whatever you want_ and the real progression system is your skill.
|
||||
|
||||
[This sounds weird, but tying progression to player skill is incredibly
|
||||
anti-meta as far as these games go. Usually jRPGs are very tailored experiences
|
||||
where you go through the standard "fetch bread -> kill god" kind of power skill
|
||||
tree, but with Breath of The Wild you can "kill god" right out of the gate and
|
||||
"fetch bread" later.](conversation://Cadey/enby)
|
||||
|
||||
I have no idea what to expect for the sequel to Breath of The Wild, but I'm
|
||||
excited as heck to see what they come up with.
|
||||
|
||||
[This is going to have an article written about it once I've gotten a chance to
|
||||
play through it. This may take a week to a month. It's gonna be worth the
|
||||
wait.](conversation://Cadey/enby)
|
||||
|
||||
## My Projects
|
||||
|
||||
I don't really like having too many project plans ahead of time, but here are
|
||||
the biggest things I'm already committing myself to do next year. Something
|
||||
something forward looking statements something something.
|
||||
|
||||
### Daily Workout Streams
|
||||
|
||||
I love rhythm games. I haven't really had good rhythm games to play until I got
|
||||
back into VR. I've been playing a lot of [Beat
|
||||
Saber](https://store.steampowered.com/app/620980/Beat_Saber/) and more recently
|
||||
[Synth Riders](https://synthridersvr.com/). I've been streaming my play on
|
||||
[Twitch](https://twitch.tv/princessxen) and I have a playlist of the VODs on
|
||||
[YouTube](https://www.youtube.com/playlist?list=PLJDDsMrk2tSH3nhLWqV8IZLgae1CNYurH).
|
||||
|
||||
I live a very sedentary lifestyle, even before COVID, and I want to start to get
|
||||
back into shape. Doing it [dancing on the
|
||||
internet](https://youtu.be/q3F06mKP2uk?list=PLJDDsMrk2tSH3nhLWqV8IZLgae1CNYurH&t=4342)
|
||||
is fun, so why not?
|
||||
|
||||
### Spellblade
|
||||
|
||||
I have a bunch of unreleased material for Spellblade that I need to go in and
|
||||
edit up and post.
|
||||
|
||||
### V-Tubing
|
||||
|
||||
I got a webcam for Christmas that I plan to use for V-Tubing coming soon. I want
|
||||
to use it for recording conference talks as well as for doing some non-VR gaming
|
||||
streams.
|
||||
|
||||
I have been working on getting a V-Tuber model hacked up out of the one that
|
||||
I've been using in VRChat, but having no idea what I am doing in Unity has
|
||||
really not been helping.
|
||||
|
||||
---
|
||||
|
||||
Hope this was an interesting view into what I'm excited for. This may be my last
|
||||
post for the year. Stay safe out there, things have been rough.
|
||||
|
|
@ -3,6 +3,8 @@ title: I Put Words on this Webpage so You Have to Listen to Me Now
|
|||
date: 2018-11-30
|
||||
---
|
||||
|
||||
# I Put Words on this Webpage so You Have to Listen to Me Now
|
||||
|
||||
Holy cow. I am angry at how people do thing with tool. People do thing with tool so badly. You shouldn't do thing with tool, you should do other thing, compare this:
|
||||
|
||||
I am using tool. I want to do thing. I flopnax the ropjar and then I get the result of doing thing (because it's convenient to flopnax the ropjar given the existing program structure).
|
||||
|
|
|
|||
|
|
@ -8,6 +8,8 @@ tags:
|
|||
- heroku
|
||||
---
|
||||
|
||||
# Farewell Email - Heroku
|
||||
|
||||
## May our paths cross again
|
||||
|
||||
Hey all,
|
||||
|
|
@ -18,7 +20,7 @@ The people I've worked with at Heroku have been catalytic to our success as a le
|
|||
|
||||
There is no doubt in my mind that you all will build fantastically useful and stable tools for Salesforce customers. Keep your eyes on what matters, let your heart guide your actions, and you all will continue to construct and refine the finest possible infrastructure that is possible. We may be limited as humans, but together in groups like this we can surpass these arbitrary differences and create things that really shine.
|
||||
|
||||
> As one being we repeat the words:
|
||||
> As one being we repeat the words:
|
||||
>
|
||||
> Flow in compassion
|
||||
> Release what is divine
|
||||
|
|
|
|||
|
|
@ -6,6 +6,8 @@ for: Twilight Sparkle
|
|||
series: stories
|
||||
---
|
||||
|
||||
# Fear
|
||||
|
||||
_I must not fear._
|
||||
_Fear is the mind-killer._
|
||||
_Fear is the little-death that brings total obliteration._
|
||||
|
|
|
|||
|
|
@ -1,63 +0,0 @@
|
|||
---
|
||||
title: RSS/Atom Feeds Fixed and Announcing my Flight Journal
|
||||
date: 2020-07-26
|
||||
tags:
|
||||
- gemini
|
||||
---
|
||||
|
||||
I have released version 2.0.1 of this site's code. With it I have fixed the RSS
|
||||
and Atom feed generation. For now I have had to sacrifice the post content being
|
||||
in the feed, but I will bring it back as soon as possible.
|
||||
|
||||
Victory badges:
|
||||
|
||||
[](/blog.atom)
|
||||
[](/blog.rss)
|
||||
|
||||
Thanks to [W3Schools](https://www.w3schools.com/XML/xml_rss.asp) for having a
|
||||
minimal example of an RSS feed and [this Flickr
|
||||
image](https://www.flickr.com/photos/sepblog/3652359502/) for expanding it so I
|
||||
can have the post dates be included too.
|
||||
|
||||
## Flight Journal
|
||||
|
||||
I have created a [Gemini](https://gemini.circumlunar.space) protocol server at
|
||||
[gemini://cetacean.club](gemini://cetacean.club). Gemini is an exploration of
|
||||
the space between [Gopher](https://en.wikipedia.org/wiki/Gopher_%28protocol%29)
|
||||
and HTTP. Right now my site doesn't have much on it, but I have added its feed
|
||||
to [my feeds page](/feeds).
|
||||
|
||||
Please note that the content on this Gemini site is going to be of a much more
|
||||
personal nature compared to the more professional kind of content I put on this
|
||||
blog. Please keep this in mind before casting judgement or making any kind of
|
||||
conclusions about me.
|
||||
|
||||
If you don't have a Gemini client installed, you can view the site content
|
||||
[here](https://portal.mozz.us/gemini/cetacean.club/). I plan to make a HTTP
|
||||
frontend to this site once I get [Maj](https://tulpa.dev/cadey/maj) up and
|
||||
functional.
|
||||
|
||||
## Maj
|
||||
|
||||
I have created a Gemini client and server framework for Rust programs called
|
||||
[Maj](https://tulpa.dev/cadey/maj). Right now it includes the following
|
||||
features:
|
||||
|
||||
- Synchronous client
|
||||
- Asynchronous server framework
|
||||
- Gemini response parser
|
||||
- `text/gemini` parser
|
||||
|
||||
Additionally, I have a few projects in progress for the Maj ecosystem:
|
||||
|
||||
- [majc](https://portal.mozz.us/gemini/cetacean.club/maj/majc.gmi) - an
|
||||
interactive curses client for Gemini
|
||||
- majd - An advanced reverse proxy and Lua handler daemon for people running
|
||||
Gemini servers
|
||||
- majsite - A simple example of the maj server framework in action
|
||||
|
||||
I will write more about this in the future when I have more than just this
|
||||
little preview of what is to come implemented. However, here's a screenshot of
|
||||
majc rendering my flight journal:
|
||||
|
||||
|
||||
|
|
@ -7,6 +7,9 @@ tags:
|
|||
- nim
|
||||
---
|
||||
|
||||
FFI-ing Golang from Nim for Fun and Profit
|
||||
==========================================
|
||||
|
||||
As a side effect of Go 1.5, the compiler and runtime recently gained the
|
||||
ability to compile code and run it as FFI code running in a C namespace. This
|
||||
means that you can take any Go function that expresses its types and the like
|
||||
|
|
|
|||
|
|
@ -1,147 +0,0 @@
|
|||
---
|
||||
title: Final Chapter
|
||||
date: 2021-05-20
|
||||
tags:
|
||||
- irc
|
||||
series: freenode
|
||||
---
|
||||
|
||||
The last caretaker looked at the last light lit in the empty halls. They looked
|
||||
out across their home. It used to be filled with thousands of people. There were
|
||||
discussions about every topic imaginable from people of as many backgrounds.
|
||||
Projects were born. Relationships were forged. Friends were found. Lives were
|
||||
irreparably changed for the better.
|
||||
|
||||
But the darkness came and soaked into the foundation. Some noticed it and became
|
||||
alerted. Some ignored it as an "inevitable" change. Some ran away, abandoning
|
||||
their home of choice. Some stuck around.
|
||||
|
||||
Then the darkness took over and the larger discussion rooms sprung into action.
|
||||
The meddlers between the halls suddenly became a network of people to assist the
|
||||
other larger discussion rooms to move elsewhere. Through their careful planning
|
||||
and surgical execution, they managed to move all of the major discussions away
|
||||
in hours. Prior migrations on this scale have not happened. Normally there are
|
||||
stragglers. Normally people try to stick it out and decry those that leave as
|
||||
"reactionaries".
|
||||
|
||||
---
|
||||
|
||||
```
|
||||
NickServ: User reg. : Dec 03 22:31:33 2007 (13y 24w 3d ago)
|
||||
NickServ: Last addr : ~cadey@infoforcefeed/Xe
|
||||
```
|
||||
|
||||
Freenode had been my home on the internet for over half of my life. All things
|
||||
IRC must come to an end, but it felt like Freenode was eternal. The staff had
|
||||
not always made decisions that I agreed with, but I have run IRC networks
|
||||
before. I know how it is. Precedent can drown you.
|
||||
|
||||
It's just sad to see it end like this. The communities that I have joined there
|
||||
have been _catalytic_ in my life. I have irreparably changed the life of others
|
||||
on Freenode. I met people on Freenode that I talk with daily. I'm sure that I
|
||||
wouldn't have the career that I have without Freenode.
|
||||
|
||||
But it's been taken over by a narcissistic Trumpian wannabe Korean royalty
|
||||
bitcoin millionaire, and I just cannot support that.
|
||||
|
||||
---
|
||||
|
||||
Not this time though. The darkness was so deep into things that the very rooms
|
||||
themselves became at risk. The floors were not known to be safe. The caretakers
|
||||
had worked together to come up with a new plan and had built an exact replica of
|
||||
the meeting halls elsewhere.
|
||||
|
||||
Through that network of meddlers, people were helped over. The new halls needed
|
||||
adjusting to cope with the sudden load, however they took them. The caretakers
|
||||
spun up their new discussion hall and built it stronger than before.
|
||||
|
||||
They, the last caretaker, was unable to control the darkness anymore. The
|
||||
darkness was too deep. Their access had rotten away.
|
||||
|
||||
---
|
||||
|
||||
```
|
||||
NickServ: Account Xe has 5 other nick(s) grouped to it, remove those first.
|
||||
```
|
||||
|
||||
I joined Freenode initially in order to get help with Ubuntu in high school.
|
||||
|
||||
> (shadowh511) hello, i need some help configuring wine 0.9.50 to run
|
||||
> microsoft digital image suite 10, i try to run the setup app, an i get two
|
||||
> looping messages about MDAC, and on how the system needs to reboot before it
|
||||
> can install, but the messages loop, how can i fix this?
|
||||
|
||||
> (Fluxd) !wine | shadowh511
|
||||
|
||||
> (ubotu) shadowh511: WINE is a compatibility layer for running Windows
|
||||
> programs on GNU/Linux. See https://help.ubuntu.com/community/Wine for more
|
||||
> information, and see !AppDB for application compatibility.
|
||||
|
||||
> (shadowh511) they won't help me there
|
||||
|
||||
I eventually figured it out. I think I just did it on Windows.
|
||||
|
||||
I ended up rejoining it and really sticking around once I got into My Little
|
||||
Pony: Friendship is Magic. There was a channel called `#reddit-mlp` that I
|
||||
haunted for years.
|
||||
|
||||
I met friends that I still talk with today. I wonder if anyone from there that I
|
||||
haven't talked with in years is reading this now.
|
||||
|
||||
---
|
||||
|
||||
The soul of the halls was not the halls itself. It was not the caretakers. It
|
||||
was the people. Once the bigger halls moved over, the people followed. Each
|
||||
person leaving took that much more of the soul with them.
|
||||
|
||||
Drops became a stream became a torrent became a flood and in a day's time the
|
||||
soul of the halls had left. The soul was gone and only the darkness remained.
|
||||
|
||||
The last caretaker looked at the room and snuffed out their light. They packed
|
||||
up their backpack and closed the front door for the last time.
|
||||
|
||||
They cried as they walked to their new home.
|
||||
|
||||
---
|
||||
|
||||
```
|
||||
(Xe) ungroup JohnMadden
|
||||
NickServ: Nick JohnMadden has been removed from your account.
|
||||
(Xe) ungroup Xena
|
||||
NickServ: Nick Xena has been removed from your account.
|
||||
(Xe) ungroup Cadance
|
||||
NickServ: Nick Cadance has been removed from your account.
|
||||
(Xe) ungroup Cadey
|
||||
NickServ: Nick Cadey has been removed from your account.
|
||||
(Xe) ungroup shadowh511
|
||||
NickServ: Nick shadowh511 has been removed from your account.
|
||||
(Xe) drop Xe ******
|
||||
```
|
||||
|
||||
> NickServ: This is a friendly reminder that you are about to destroy the
|
||||
> account Xe. To avoid accidental use of this command, this operation has to
|
||||
> be confirmed. Please confirm by replying with /msg NickServ DROP Xe `******`
|
||||
> `86033ae0:9e021b10`
|
||||
|
||||
---
|
||||
|
||||
The halls fell, but the people that made up the soul of those halls moved on.
|
||||
|
||||
Their home went away because their home wasn't a building. It was an idea. Ideas
|
||||
persist in ways that buildings don't.
|
||||
|
||||
---
|
||||
|
||||
```
|
||||
(Xe) DROP Xe ****** 86033ae0:9e021b10
|
||||
NickServ: The account Xe has been dropped.
|
||||
```
|
||||
|
||||
You can find me on [Liberachat](https://libera.chat/) in `#xeserv`. If you want
|
||||
to chat about my blog articles, I welcome any readers to join there.
|
||||
|
||||
Be well.
|
||||
|
||||
```
|
||||
irc: server freenode has been deleted
|
||||
```
|
||||
|
|
@ -1,142 +0,0 @@
|
|||
---
|
||||
title: Footnote
|
||||
date: 2021-06-15
|
||||
tags:
|
||||
- irc
|
||||
series: freenode
|
||||
---
|
||||
|
||||
- [Final Chapter](/blog/final-chapter-2021-05-20)
|
||||
- [Epilogue](/blog/epilogue-2021-05-26)
|
||||
|
||||
---
|
||||
|
||||
Before the darkness was the darkness, the darkness was a child. This child found
|
||||
themselves lost and without purpose. Life was scary. Things were changing
|
||||
constantly, and they found themselves at a loss. One day they were walking about
|
||||
the etherial network and stumbled across a meeting house.
|
||||
|
||||
The child looked inside and was confused. There were hundereds of rooms with
|
||||
even more people inside. There were rooms on every topic. There was a shower of
|
||||
culture and an outpouring of knowledge. Hanging out here would permanently
|
||||
change the course of the child's life.
|
||||
|
||||
---
|
||||
|
||||
Horrified by the room takeover golem, the remaining regulars had fled their
|
||||
former homes. This was not a home for legal reasons, but it was their social
|
||||
home on the etherial network. Sadness had turned to rage had turned to
|
||||
depression had turned to laughter. One of the former regulars was a apprentice
|
||||
scryer, so as a lark they decided to set up some meeting rooms to scry their way
|
||||
into rooms in the old meeting house. It was a one-way scry and all they could do
|
||||
was watch.
|
||||
|
||||
---
|
||||
|
||||
Historically, IRC spam has been a unique form of art. Yes, I'm serious. There
|
||||
have been legitimate works of art created in the desire to disrupt conversations
|
||||
on IRC. It sounds absurd, but it's true. One unique quality of these artworks is
|
||||
that in order to see them, they must be shared with others. At some level you
|
||||
can't view this art alone, and that makes it beautiful.
|
||||
|
||||
Fighting IRC spam has turned into a full time job. There are hundreds of
|
||||
different bot kinds and so many different ways to spam that fighting it is
|
||||
difficult due to the server software being very simple. Historically IRC
|
||||
developers have not wanted to add hooks so that people could run a bit of code
|
||||
on each message as it was being processed. There were legitimate fears that
|
||||
doing this would allow a malicious server admin to log every channel, not just
|
||||
the ones they have joined. IRC was created at a time where all of the admins
|
||||
knew eachother; but they were part of different organizations, each with their
|
||||
own rules and subtly different codes of conduct.
|
||||
|
||||
One of the best ways to fight IRC spam has been to wait until the spammer gets
|
||||
bored and goes off to do something else. Users are not as understanding to this
|
||||
method.
|
||||
|
||||
---
|
||||
|
||||
Someone had set up a golem-creating golem and aimed it at the meta-discussion
|
||||
room of the former meeting house. It did its job dutifully and continued
|
||||
marching on:
|
||||
|
||||
> (pissnet) come to pissnet for cold wet chats!
|
||||
|
||||
The people watching the scry had never seen this brand of disruption before. By
|
||||
now the people watching had amassed to over a hundred and they were all bored
|
||||
and eager for something new. Something new was here!
|
||||
|
||||
> (pissnet) come to pissnet for cold hard piss!
|
||||
|
||||
Over time, the shadowy group behind these golems became known as the urinators.
|
||||
These urinators became a bit of a hero to the people who watched in horror as
|
||||
the situation developed. The golems got discovered and ejected, and even earned
|
||||
the ire of the anti-golem golem. The disguise was clever, the ejections where
|
||||
swift, but the watchers laughed as the golems kept getting more and more
|
||||
creative.
|
||||
|
||||
---
|
||||
|
||||
The darkness was dismayed. Everything was falling apart around them. The
|
||||
maintainers of the maintenance golems had fled. The spellcrafters that empowered
|
||||
them [had sworn to give no more
|
||||
assistance](https://atheme.github.io/atheme-open-letter/). The halls themselves
|
||||
were starting to show the rot that had built up over the last 20 years of them
|
||||
existing.
|
||||
|
||||
The darkness pondered amongst themselves until they pulled back a memory from
|
||||
the past. A memory from the child. The halls themselves had to be replaced!
|
||||
|
||||
---
|
||||
|
||||
The watchers looked on in horror. The scryer had given up hope and decided to
|
||||
move on with their life. The urinators had suceeded in shutting down the things
|
||||
that were fun to the watchers. The urinators won.
|
||||
|
||||
Some urinators created their own halls. It was an experiment in anarchy for
|
||||
running these types of halls. It is astounding that it managed to stay as stable
|
||||
as it did.
|
||||
|
||||
---
|
||||
|
||||
I have been completely unsure how I should broach the topic of pissnet in these
|
||||
articles. For people unfamiliar with IRC culture, you must think I'm making shit
|
||||
up or something. It is _so_ out there that it's almost like an abstact art
|
||||
gallery or something. But no, pissnet happened. It started as IRC spam and then
|
||||
turned into this: [letspiss.net](http://letspiss.net/). I don't really think I
|
||||
can suggest readers of this blog go there. It is some kind of weird anarchist
|
||||
IRC hackerspace, but most of the users are ircops and can see your IP address.
|
||||
|
||||
Like, for people that are really deep into IRC culture, the whole pissnet
|
||||
shitshow was so out there that they thought the people that were telling them
|
||||
about that were making that shit up.
|
||||
|
||||
But it's real.
|
||||
|
||||
---
|
||||
|
||||
> We are moving past legacy freenode to a new fork. The new freenode is
|
||||
> launched. You will slowly be disconnected and when you reconnect, you will be
|
||||
> on the new freenode. We patiently await to welcome you in freedom's holdout -
|
||||
> the freenode. If you're looking to connect now, you can already /server
|
||||
> chat.freenode.net 6697 (ssl) or 6667 (plaintext). It's a new genesis for a new
|
||||
> era. Thank you for using freenode, and Hello World, from the future. freenode
|
||||
> is IRC. freenode is FOSS. When you connect, register your nickname and your
|
||||
> channel and get started. It's a new world. We're so happy to welcome you and
|
||||
> the millions of others.
|
||||
|
||||
The darkness smiled and replaced the halls where they were. The darkness hoped
|
||||
that millions would follow.
|
||||
|
||||
They didn't come.
|
||||
|
||||
---
|
||||
|
||||
- [Freenode commits suicide, is no longer a serious IRC
|
||||
network](https://www.devever.net/~hl/freenode_suicide)
|
||||
- [the end of freenode](https://ariadne.space/2021/06/14/the-end-of-freenode/)
|
||||
- [All Freenode Channels and Users
|
||||
Gone](https://old.reddit.com/r/linux/comments/o0263h/all_freenode_channels_and_users_gone/)
|
||||
- [Last remaining >1000 user community channel seized by freenode
|
||||
staff](https://linux.chat/linux-on-freenode/)
|
||||
|
||||
Freenode is dead. The spirit lives on in [Libera.chat](https://libera.chat/).
|
||||
|
|
@ -4,6 +4,8 @@ date: 2019-05-19
|
|||
series: conlangs
|
||||
---
|
||||
|
||||
# A Formal Grammar of `h`
|
||||
|
||||
## Introduction
|
||||
|
||||
`h` is a conlang project that I have been working off and on for years. It is infinitely simply teachable, trivial to master and can be used to represent the entire scope of all meaning in any facet of the word. All with a single character.
|
||||
|
|
|
|||
|
|
@ -1,382 +0,0 @@
|
|||
---
|
||||
title: Fun with Redirection
|
||||
date: 2021-09-22
|
||||
author: Twi
|
||||
tags:
|
||||
- shell
|
||||
- redirection
|
||||
- osdev
|
||||
---
|
||||
|
||||
When you're hacking in the shell or in a script, sometimes you want to change
|
||||
how the output of a command is routed. Today I'm gonna cover common shell
|
||||
redirection tips and tricks that I use every day at work and how it all works
|
||||
under the hood.
|
||||
|
||||
Let's say you're trying to capture the output of a command to a file, such as
|
||||
`uname -av`:
|
||||
|
||||
```console
|
||||
$ uname -av
|
||||
Linux shachi 5.13.15 #1-NixOS SMP Wed Sep 8 06:50:21 UTC 2021 x86_64 GNU/Linux
|
||||
```
|
||||
|
||||
You could copy that to the clipboard and paste it into a file, but there is a
|
||||
better way thanks to the `>` operator:
|
||||
|
||||
```console
|
||||
$ uname -av > uname.txt
|
||||
$ cat uname.txt
|
||||
Linux shachi 5.13.15 #1-NixOS SMP Wed Sep 8 06:50:21 UTC 2021 x86_64 GNU/Linux
|
||||
```
|
||||
|
||||
Let's say you want to run this on a few machines and put all of the output into
|
||||
`uname.txt`. You could write a shell script loop like this:
|
||||
|
||||
```sh
|
||||
# make sure the file doesn't already exist
|
||||
rm -f uname.txt
|
||||
|
||||
for host in shachi chrysalis kos-mos ontos pneuma
|
||||
do
|
||||
ssh $host -- uname -av >> uname.txt
|
||||
done
|
||||
```
|
||||
|
||||
Then `uname.txt` should look like this:
|
||||
|
||||
```
|
||||
Linux shachi 5.13.15 #1-NixOS SMP Wed Sep 8 06:50:21 UTC 2021 x86_64 GNU/Linux
|
||||
Linux chrysalis 5.10.63 #1-NixOS SMP Wed Sep 8 06:49:02 UTC 2021 x86_64 GNU/Linux
|
||||
Linux kos-mos 5.10.45 #1-NixOS SMP Fri Jun 18 08:00:06 UTC 2021 x86_64 GNU/Linux
|
||||
Linux ontos 5.10.52 #1-NixOS SMP Tue Jul 20 14:05:59 UTC 2021 x86_64 GNU/Linux
|
||||
Linux pneuma 5.10.57 #1-NixOS SMP Sun Aug 8 07:05:24 UTC 2021 x86_64 GNU/Linux
|
||||
```
|
||||
|
||||
Now let's say you want to extract all of the hostnames from that `uname.txt`.
|
||||
The pattern of the file seems to specify that fields are separated by spaces and
|
||||
the hostname seems to be the second space-separated field in each line. You can
|
||||
use the `cut` command to select that small subset from each line, and you can
|
||||
feed the `cut` command's standard input using the `<` operator:
|
||||
|
||||
```console
|
||||
$ cut -d ' ' -f 2 < uname.txt
|
||||
shachi
|
||||
chrysalis
|
||||
kos-mos
|
||||
ontos
|
||||
pneuma
|
||||
```
|
||||
|
||||
[It's worth noting that a lot of these core CLI utilities are built on the idea
|
||||
that they are _filters_, or things that take one infinite stream of text in on
|
||||
one end and then return another stream of text out the other
|
||||
end. This is done through a channel called "standard input/output", where
|
||||
standard input refers to input to the command and standard output refers to the
|
||||
output of the command.](conversation://Mara/hacker)
|
||||
|
||||
[That's a great metaphor, let's build onto it using the `|` (pipe)
|
||||
operator. The pipe operator lets you pipe the standard output of one command to
|
||||
the standard input of another.](conversation://Cadey/enby)
|
||||
|
||||
[You mentioned that you can pass files as input and output for commands, does
|
||||
this mean that standard input and standard output are
|
||||
files?](conversation://Mara/happy)
|
||||
|
||||
[Precisely! They are just files that are automatically open for every process.
|
||||
Usually commands will output to standard out and some will also accept input via
|
||||
standard in.](conversation://Cadey/enby)
|
||||
|
||||
[Doesn't that have some level of overhead though? Isn't it expensive to spin up
|
||||
a whole heckin' `cat` process for that?](conversation://Mara/hmm)
|
||||
|
||||
[Not on any decent system made in the last 20 years. This may have some impact
|
||||
on Windows (because they have core architectural mistakes that make processes
|
||||
take up to 100 milliseconds to spin up), but this is about Unix/Linux. I think
|
||||
these should work on Windows too if you use Cygwin, but if you're using WSL you
|
||||
shouldn't have any real issues there](conversation://Cadey/coffee)
|
||||
|
||||
Let's say we want to rewrite that `cut` command above to use pipes. You could
|
||||
write it like this:
|
||||
|
||||
```sh
|
||||
cat uname.txt | cut -d ' ' -f 2
|
||||
```
|
||||
|
||||
[The mnemonic we use for remembering the `cut` command is that fields are
|
||||
separated by the `d`elimiter and you cut out the nth
|
||||
`f`ield/s.](conversation://Mara/hacker)
|
||||
|
||||
This will get you the exact same output:
|
||||
|
||||
```console
|
||||
$ cat uname.txt | cut -d ' ' -f 2
|
||||
shachi
|
||||
chrysalis
|
||||
kos-mos
|
||||
ontos
|
||||
pneuma
|
||||
```
|
||||
|
||||
Personally I prefer writing shell pipelines like that as it makes it a bit
|
||||
easier to tack on more specific selectors or operations as you go along. For
|
||||
example, if you wanted to sort them you could pipe the result to `sort`:
|
||||
|
||||
```console
|
||||
$ cat uname.txt | cut -d ' ' -f 2 | sort
|
||||
chrysalis
|
||||
kos-mos
|
||||
ontos
|
||||
pneuma
|
||||
shachi
|
||||
```
|
||||
|
||||
This lets you gradually build up a shell pipeline as you drill down to the data
|
||||
you want in the format you want.
|
||||
|
||||
[I wanted to save this compiler error to a file but it didn't work. I tried
|
||||
doing this:](conversation://Mara/hmm)
|
||||
|
||||
```console
|
||||
$ rustc foo.rs > foo.log
|
||||
```
|
||||
|
||||
But the output printed to the screen instead of the file:
|
||||
|
||||
```console
|
||||
$ rustc foo.rs > foo.log
|
||||
error: expected one of `!` or `::`, found `main`
|
||||
--> foo.rs:1:5
|
||||
|
|
||||
1 | fun main() {}
|
||||
| ^^^^ expected one of `!` or `::`
|
||||
|
||||
error: aborting due to previous error
|
||||
|
||||
$ cat foo.log
|
||||
$
|
||||
```
|
||||
|
||||
This happens because there are actually _two_ output streams per program. There
|
||||
is the standard out stream and there is also a standard error stream. The reason
|
||||
that standard error exists is so that you can see if any errors have happened if
|
||||
you redirect standard out.
|
||||
|
||||
Sometimes standard out may not be a stream of text, say you have a compressed
|
||||
file you want to analyze and there's an issue with the decompression. If the
|
||||
decompressor wrote its errors to the standard output stream, it could confuse or
|
||||
corrupt your analysis.
|
||||
|
||||
However, we can redirect standard error in particular by modifying how we
|
||||
redirect to the file:
|
||||
|
||||
```console
|
||||
$ rustc foo.rs 2> foo.log
|
||||
$ cat foo.log
|
||||
error: expected one of `!` or `::`, found `main`
|
||||
--> foo.rs:1:5
|
||||
|
|
||||
1 | fun main() {}
|
||||
| ^^^^ expected one of `!` or `::`
|
||||
|
||||
error: aborting due to previous error
|
||||
```
|
||||
|
||||
[Where did the `2` come from?](conversation://Mara/wat)
|
||||
|
||||
So I mentioned earlier that redirection modifies the standard input and output
|
||||
of programs. This is not entirely true, but it was a convenient half-truth to
|
||||
help build this part of the explanation.
|
||||
|
||||
For every process on a Unix-like system (such as Linux and macOS), the kernel
|
||||
stores a list of active file-like objects. This includes real files on the
|
||||
filesystem, pipes between processes, network sockets, and more. When a program
|
||||
reads or writes a file, they tell the kernel which file they want to use by
|
||||
giving it a number index into that list, starting at zero. Standard in/out/error
|
||||
are just the conventional names for the first three open files in the list, like
|
||||
this:
|
||||
|
||||
| File Descriptor | Purpose |
|
||||
| :------ | :------- |
|
||||
| 0 | Standard input |
|
||||
| 1 | Standard output |
|
||||
| 2 | Standard error |
|
||||
|
||||
Shell redirection simply changes which files are in that list of open files when
|
||||
the program starts running.
|
||||
|
||||
That is why you use a `2` there, because you are telling the shell to change
|
||||
file descriptor number `2` of the `rustc` process to point to the filesystem
|
||||
file `foo.log`, which in turn makes the standard error of `rustc` get written to
|
||||
that file for you.
|
||||
|
||||
In turn, this also means that `cat foo.txt > foo2.txt` is actually a shortcut
|
||||
for saying `cat foo.txt 1> foo2.txt`, but the `1` can be omitted there because
|
||||
standard out is usually the "default" output that most of these kind of
|
||||
pipelines cares about.
|
||||
|
||||
[How would I get both standard output and standard error in the same
|
||||
file?](conversation://Mara/hmm)
|
||||
|
||||
The cool part about the `>` operator is that it doesn't just stop with output to
|
||||
files on the desk, you can actually have one file descriptor get pointed to
|
||||
another. Let's say you have a need for both standard out and standard error to
|
||||
go to the same file. You can do this with a command like this:
|
||||
|
||||
```
|
||||
$ rustc foo.rs > foo.log 2>&1
|
||||
```
|
||||
|
||||
This tells the shell to point standard out to `foo.log`, and then standard
|
||||
error to standard out (which is now `foo.log`). There's a footgun here though;
|
||||
the order of the redirects matters. Consider the following:
|
||||
|
||||
```
|
||||
$ rustc foo.rs 2>&1 > foo.log
|
||||
error: expected one of `!` or `::`, found `main`
|
||||
--> foo.rs:1:5
|
||||
|
|
||||
1 | fun main() {}
|
||||
| ^^^^ expected one of `!` or `::`
|
||||
|
||||
error: aborting due to previous error
|
||||
$ cat foo.log
|
||||
$ # foo.log is empty, why???
|
||||
```
|
||||
|
||||
We wanted to redirect stderr to `foo.log`, but that didn't happen. Why? Well,
|
||||
the shell considers our redirects one at a time from left to right. When the
|
||||
shell sees `2>&1`, it hasn't considered `> foo.log` yet, so standard out (`1`)
|
||||
is still our terminal. It dutifully redirects stderr to the terminal, which is
|
||||
where it was already going anyway. Then it sees `1 > foo.log`, so it redirects
|
||||
standard out to `foo.log`. That's the end of it though. It doesn't
|
||||
retroactively redirect standard error to match the new standard out, so our
|
||||
errors get dumped to our terminal instead of the file.
|
||||
|
||||
Confusing right? Lucky for us, there's a short form that redirects both at the
|
||||
same time, making this mistake impossible:
|
||||
|
||||
```
|
||||
$ rustc foo.rs &> foo.log
|
||||
```
|
||||
|
||||
This will put standard out and standard error to `foo.log` the same way that
|
||||
`> foo.log 2>&1` will.
|
||||
|
||||
[Will that work in every shell?](conversation://Mara/hmm)
|
||||
|
||||
[It's a bourne shell (`bash`) extension, but I've tested it in `zsh` and `fish`.
|
||||
You can also do `&|` to pipe both standard out and standard error at the same
|
||||
time in the same way you'd do `2>&1 | whatever`.](conversation://Cadey/enby)
|
||||
|
||||
You can also use this with `>>`:
|
||||
|
||||
```
|
||||
$ rustc foo.rs &>> foo.log
|
||||
$ cat foo.log
|
||||
error: expected one of `!` or `::`, found `main`
|
||||
--> foo.rs:1:5
|
||||
|
|
||||
1 | fun main() {}
|
||||
| ^^^^ expected one of `!` or `::
|
||||
|
||||
error: aborting due to previous error
|
||||
|
||||
error: expected one of `!` or `::`, found `main`
|
||||
--> foo.rs:1:5
|
||||
|
|
||||
1 | fun main() {}
|
||||
| ^^^^ expected one of `!` or `::`
|
||||
|
||||
error: aborting due to previous error
|
||||
```
|
||||
|
||||
[How do I redirect standard in to a file?](conversation://Mara/hmm)
|
||||
|
||||
Well, you don't. Standard in is an input, so you can change where it comes
|
||||
_from_, not where it goes.
|
||||
|
||||
But, maybe you want to make a copy of a program's input and send it somewhere
|
||||
else. There is a way to do _that_ using a command called `tee`. `tee` copies
|
||||
its standard input to standard output, but it also writes a second copy to a
|
||||
file. For example:
|
||||
|
||||
```console
|
||||
$ dmesg | tee dmesg.txt | grep 'msedge'
|
||||
[ 70.585463] traps: msedge[4715] trap invalid opcode ip:5630ddcedc4c sp:7ffd41f67700 error:0 in msedge[5630d8fc2000+952d000]
|
||||
[ 70.702544] traps: msedge[4745] trap invalid opcode ip:5630ddcedc4c sp:7ffd41f67700 error:0 in msedge[5630d8fc2000+952d000]
|
||||
[ 70.806296] traps: msedge[4781] trap invalid opcode ip:5630ddcedc4c sp:7ffd41f67700 error:0 in msedge[5630d8fc2000+952d000]
|
||||
[ 70.918095] traps: msedge[4889] trap invalid opcode ip:5630ddcedc4c sp:7ffd41f67700 error:0 in msedge[5630d8fc2000+952d000]
|
||||
[ 71.031938] traps: msedge[4926] trap invalid opcode ip:5630ddcedc4c sp:7ffd41f67700 error:0 in msedge[5630d8fc2000+952d000]
|
||||
[ 71.138974] traps: msedge[4935] trap invalid opcode ip:5630ddcedc4c sp:7ffd41f67700 error:0 in msedge[5630d8fc2000+952d000]
|
||||
[ 1169.163603] traps: msedge[35719] trap invalid opcode ip:556a93951c4c sp:7ffc533f35c0 error:0 in msedge[556a8ec26000+952d000]
|
||||
[ 1213.301722] traps: msedge[36054] trap invalid opcode ip:55a245960c4c sp:7ffe6d169b40 error:0 in msedge[55a240c35000+952d000]
|
||||
[10963.234459] traps: msedge[104732] trap invalid opcode ip:55fdb864fc4c sp:7ffc996dfee0 error:0 in msedge[55fdb3924000+952d000]
|
||||
```
|
||||
|
||||
This would put the output of the `dmesg` command (read from kernel logs) into
|
||||
`dmesg.txt`, as well as sending it into the grep command. You might want to do
|
||||
this when debugging long command pipelines to see exactly what is going into a
|
||||
program that isn't doing what you expect.
|
||||
|
||||
Redirections also work in scripts too. You can also set "default" redirects for
|
||||
every command in a script using the `exec` command:
|
||||
|
||||
```sh
|
||||
exec > out.log 2> error.log
|
||||
|
||||
ls
|
||||
rustc foo.rs
|
||||
```
|
||||
|
||||
This will have the file listing from `ls` written to `out.log` and any errors
|
||||
from `rustc` written to `error.log`.
|
||||
|
||||
A lot of other shell tricks and fun is built on top of these fundamentals. For
|
||||
example you can take a folder, zip it up and then unzip it over on another
|
||||
machine using a command like this:
|
||||
|
||||
```
|
||||
$ tar cz ./blog | ssh pneuma tar xz -C ~/code/christine.website/blog
|
||||
```
|
||||
|
||||
This will run `tar` to create a compressed copy of the `./blog` folder and then
|
||||
pipe that to tar on another computer to extract that into
|
||||
`~/code/christine.website/blog`. It's just pipes and redirection all the way
|
||||
down! Deep inside `ssh` it's really just piping output of commands back and
|
||||
forth over an encrypted network socket. Connecting to an IRC server is just
|
||||
piping in and out data to the chat server, even more so if you use TLS to
|
||||
connect there. In a way you can model just about everything in Unix with pipes
|
||||
and file descriptors because that is the cornerstone of its design: Everything
|
||||
is a file.
|
||||
|
||||
[This doesn't mean it's literally a file on the disk, it means you can _interact
|
||||
with_ just about everything using the same system interface as you do with
|
||||
files. Even things like hard disks and video cards.](conversation://Mara/hacker)
|
||||
|
||||
Here's a fun thing to do. Using [`curl`](https://curl.se/) to read the contents
|
||||
of a URL and [`jq`](https://stedolan.github.io/jq/) to select out bits from a
|
||||
JSON stream, you can make a script that lets you read the most recent title from
|
||||
my blog's [JSONFeed](/blog.json):
|
||||
|
||||
```sh
|
||||
#!/usr/bin/env bash
|
||||
# xeblog-post.sh
|
||||
|
||||
curl -s https://christine.website/blog.json | jq -r '.items[0] | "\(.title) \(.url)"'
|
||||
```
|
||||
|
||||
At the time of writing this post, here is the output I get from this command:
|
||||
|
||||
```
|
||||
$ ./xeblog-post.sh
|
||||
Anbernic RG280M Review https://christine.website/blog/rg280m-review
|
||||
```
|
||||
|
||||
What else could you do with pipes and redirection? The cloud's the limit!
|
||||
|
||||
---
|
||||
|
||||
Thanks to violet spark, cadence, and AstroSnail for looking over this post and
|
||||
fact-checking as well as helping mend some of the brain dump and awkward
|
||||
wording into more polished sentences.
|
||||
|
|
@ -1,65 +0,0 @@
|
|||
---
|
||||
title: "The Relaxing Surreality of VRChat Furry Conventions"
|
||||
date: 2021-03-22
|
||||
tags:
|
||||
- vrchat
|
||||
- fe21
|
||||
---
|
||||
|
||||
Author's Note: you may want to view this post in a GUI browser for the best experience.
|
||||
|
||||
It is no secret that I am a furry. The main way that a lot of my friends and I meet up is at conventions. COVID has lead to a year without cons for my friend groups. It's gotten bad enough that in one server the convention coordination channel had its name changed from `#conventions` to `#cancelled`. These conventions are expensive (flight/hotel/badge/the dealer's den), tiring and weirdly recharging all at once.
|
||||
|
||||
Last thursday, I found out that there was an online furry convention happening this weekend in [VRChat](https://hello.vrchat.com): [Furnal Equinox](https://furnalequinox.com). The concept intrigued me. Obviously, it won't be the same (there's only so much VR can do), but I decided to try it out and pinged a few friends about it. We jacked in and loaded up VRChat to see what it was all about.
|
||||
|
||||
<center>
|
||||
|
||||
<blockquote class="twitter-tweet"><p lang="en" dir="ltr">A VRChat furry convention, in selfie essay format <a href="https://t.co/5PsjteS79I">pic.twitter.com/5PsjteS79I</a></p>— Cadey A. Ratio 🌐 (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1373957443294744578?ref_src=twsrc%5Etfw">March 22, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
</center>
|
||||
|
||||
It was a blast. Furry conventions usually have this weird but wholesome vibe to them. There's this feeling of community as existing friend groups meet up and as these groups mix together, new friendships get formed as well.
|
||||
|
||||
When I registered for the convention, there was an option to donate to the convention organization itself and to [Hobbitsee Wildlife Refuge](http://www.hobbitstee.com). I kicked over some money and then hopped in the Discord to get the supporter badge prop to glue onto my avatar. After a few rounds of testing, being confused by Unity, having that golden moment of understanding and then actually getting it to do what I wanted it to do, I managed to get the badge to a place where I was happy with it (and where it wouldn't clip through my body when I sat down).
|
||||
|
||||
<center>
|
||||
|
||||
<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Let's play with textures to see what we get <a href="https://t.co/1soAuNSllk">pic.twitter.com/1soAuNSllk</a></p>— Cadey A. Ratio 🌐 (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1373245260449652740?ref_src=twsrc%5Etfw">March 20, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
</center>
|
||||
|
||||
[A bit of con culture info that may help here: usually at furry conventions people get a badge that they need to wear at all times on the con floor. This helps the staff know who should actually be at the convention or not. Many people in the online furry community do not have access to the source files that make up their avatar models and VRChat props don't persist between worlds, so it's not always possible for them to glue that badge onto their avatar model. The different tiers of badges are seen as signs of respect to some people (though we are not sure why). It's also common for people to put all of their previous con badges on the same lanyard or wear multiple lanyards for each con they've been to.](conversation://Mara/hacker)
|
||||
|
||||
I think this event was the catalyst for Unity really starting to actually make sense to me. My avatar model is pretty complicated as is (at least 79k polygons, 30 materials and several props that I can toggle on and off at will) and I think I now know what I need to do in order to simplify it a bit. I may not know how to actually do it yet, but I do know what I need to do.
|
||||
|
||||
<center>
|
||||
|
||||
<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Let's see how these shader changes work out: <a href="https://t.co/ggzzNbXZTs">pic.twitter.com/ggzzNbXZTs</a></p>— Cadey A. Ratio 🌐 (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1373618625026920449?ref_src=twsrc%5Etfw">March 21, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
</center>
|
||||
|
||||
When I arrived in the con hotel world, one of the first things I noticed was how much it felt like an actual hotel. I entered the world pretty early on friday, so at first things were fairly unpopulated (just like how it would feel if you got to the con a day early). Slowly people started filtering in and I just talked with people. The main hotel lobby was kinda janky, if you weren't careful you could teleport halfway across the map into a chair. However I had some good conversations where we talked about VR tech, some things that we'd each like to do at the convention and more.
|
||||
|
||||
Something that ends up happing at furry conventions is that you will talk to some people and then end up forgetting to get contact information for them. Then they just fade into the crowd at the end of the convention like tears in rain, and if you're lucky you may be able to see them next year. One of the main differences with a con in VRChat is that you're able to select that person and send a friend request to them in-game. Then you have a way to keep in touch.
|
||||
|
||||
<center>
|
||||
|
||||
<blockquote class="twitter-tweet"><p lang="und" dir="ltr"><a href="https://t.co/MfwT9McdXI">pic.twitter.com/MfwT9McdXI</a></p>— Cadey A. Ratio 🌐 (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1373286284966424581?ref_src=twsrc%5Etfw">March 20, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
</center>
|
||||
|
||||
As the day went on some trolls got word that there was a furry convention happening in VRChat. There seems to be this weird underbelly of people that will go into VRChat worlds and intentionally ruin other people's fun by using avatars that spawn a bajillionty particles to crash the game. The convention staff reacted quickly though. Due to the fact that they weren't able to totally control who came into the convention (it being a free event in a free to download game without the best moderation tools means you kinda have to roll with the punches), they ended up creating a blocklist in a channel on the Discord. Thankfully VRChat offers a web panel for users to manage settings online, so I was able to block all of the crashers and continue having fun at the con.
|
||||
|
||||
One of the main staples of these conventions is the vendor's hall/dealer's den. The staff managed to make this adorable dealer's den map that had at least 60 stalls (one for each vendor). There were traditional artists, digital artists (including the person I had just gotten a sticker order from), VRChat avatar makers, a novel author that I had a lovely time talking with, and more. I didn't end up buying anything (though I may end up doing another sticker order), but it had that same _feeling_ that the vendor hall usually does. It would have been a lot more enjoyable if it wasn't so bright and laggy. In most of the con worlds I got around 70-72 frames per second, but in the vendor hall I regularly dipped down to 30-45. My VR setup over wifi insulates me from lag spikes (my headset is set to render at 80 FPS internally and the VR stream gets multiplexed onto it, so if I get a huge lagspike I don't actually feel it for a moment or two), but it got pretty bad.
|
||||
|
||||
Another staple of furry conventions is the room parties. These room parties usually have disturbing amounts of alcohol available and are a blast for everyone involved. They had a few room models to pick from including a penthouse suite with a little bar-like alcove. With a bunch of people in the same instance, I had a terrible idea and suggested everyone hop into the bathroom so we could take a pic. I ended up with this:
|
||||
|
||||
<center>
|
||||
|
||||
<blockquote class="twitter-tweet"><p lang="und" dir="ltr"><a href="https://t.co/QS1i9AYyOG">pic.twitter.com/QS1i9AYyOG</a></p>— Cadey A. Ratio 🌐 (@theprincessxena) <a href="https://twitter.com/theprincessxena/status/1373390724599808001?ref_src=twsrc%5Etfw">March 20, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
|
||||
|
||||
</center>
|
||||
|
||||
Something else my friends and I end up doing is a run to restaurants like Nandos or Taco Bell. Obviously this is very difficult to coordinate in VRChat (some of the people I was chilling with don't have taco bell in their home country), but there is actually a VRChat Taco Bell map! I plunked down a portal and everyone jumped in. We explored around the world and a few people played a confusing looking game that appeared to be some kind of recursive tic tac toe. Unsurprisingly, they ended up in a draw.
|
||||
|
||||
I'm definitely going to go to conventions in VRChat in the future, even after COVID abates and the borders re-open. There is just this unique feeling to VR conventions. Everyone is wearing avatars that allow them to express themselves in ways that are difficult or expensive in person. There are a number of people fursuiting at any given convention (though I'm not sure how they do it, it must be an oven in those suits), but at this convention _everyone_ was in fursuit. It was hard to look around on the con floor and see anything but an outpouring of creativity and passion for their characters. I later found out that this con was a lot of people's first furry convention. I can't think of a better introduction than this. The only thing it was missing was that one person that sits at the hotel piano and plays video game music all day.
|
||||
|
|
@ -8,6 +8,8 @@ tags:
|
|||
- twitch
|
||||
---
|
||||
|
||||
# Gamebridge: Fitting Square Pegs into Round Holes since 2020
|
||||
|
||||
Recently I did a stream called [Twitch Plays Super Mario 64][tpsm64]. During
|
||||
that stream I both demonstrated and hacked on a tool I'm calling
|
||||
[gamebridge][gamebridge]. Gamebridge is a tool that lets you allow games to
|
||||
|
|
|
|||
|
|
@ -7,6 +7,8 @@ tags:
|
|||
- gods
|
||||
---
|
||||
|
||||
# The Gears and The Gods
|
||||
|
||||
If there are any gods in computing, they are the authors of compilers. The
|
||||
output of compilers is treated as a Heavenly Decree, sometimes used for many
|
||||
sprints or even years after the output has been last emitted.
|
||||
|
|
|
|||
|
|
@ -1,106 +0,0 @@
|
|||
---
|
||||
title: The Fear Of Missing Out
|
||||
date: 2020-08-02
|
||||
tags:
|
||||
- culture
|
||||
- web
|
||||
---
|
||||
|
||||
Humans have evolved over thousands of years with communities that are small,
|
||||
tight-knit and where it is easy to feel like you know everyone in them. The
|
||||
Internet changes this completely. With the Internet, it's easy to send messages,
|
||||
write articles and even publish books that untold thousands of people can read
|
||||
and interact with. This has lead to an instinctive fear in humanity I'm going to
|
||||
call the Fear of Missing Out [1].
|
||||
|
||||
[[1]: The Fear of Missing Out](https://en.wikipedia.org/wiki/Fear_of_missing_out)
|
||||
|
||||
The Internet in its current form capitalizes and makes billions off of this.
|
||||
Infinite scrolling and live updating pages that make it feel like there's always
|
||||
something new to read. Uncountable hours of engineering and psychological
|
||||
testing spent making sure people click and scroll and click and consume all day
|
||||
until that little hit of dopamine becomes its own addiction. We have taken a
|
||||
system for displaying documents and accidentally turned it into a hulking
|
||||
abomination that consumes the souls of all who get trapped in it, crystallizing
|
||||
them in an endless cycle of checking notifications, looking for new posts on
|
||||
your newsfeed, scrolling down to find just that something you think you're
|
||||
looking for.
|
||||
|
||||
When I was in high school, I bagged groceries for a store. I also had the
|
||||
opportunity to help customers out to their cars and was able to talk with them.
|
||||
Obviously, I was minimum wage and had a whole bunch of other things to do;
|
||||
however there were a few times that I could really get to talk with regular
|
||||
customers and feel like I got to know them. What comes to mind however is a
|
||||
story where that is not the case. One day I was helping this older woman to her
|
||||
car, and she eventually said something like "All of these people just keep
|
||||
going, going, going nonstop. It drives me mad. How can't they see where they are
|
||||
is good enough already?" I thought for a moment and I wasn't able to come up
|
||||
with a decent reply.
|
||||
|
||||
The infinite scrollbars and newsfeeds of the web just keep going, going, going,
|
||||
going, going, going, going and going until the user gives up to do something
|
||||
elses. There's no consideration of _how_ the content is discovered, and _why_
|
||||
the content is discovered, it's just an endless feed of noise. One subtle change
|
||||
in your worldview after another, just from the headlines alone. Not to mention
|
||||
the endless torrent of advertising.
|
||||
|
||||
However, I think there may be a way out, a kind of detox from the infinite
|
||||
scrolling, newsfeeds, notifications and the like for the internet, and I think a
|
||||
good step towards that is the Gemini [2] protocol.
|
||||
|
||||
[[2]: Gemini Protocol](https://gemini.circumlunar.space/)
|
||||
|
||||
Gemini is a protocol that is somewhere between HTTP and Gopher. A user sends a
|
||||
request to a Gemini server and the user gets a response back. This response
|
||||
could be anything, but a little header tells the client what kind of data it is.
|
||||
There's also a little markup format that's a very lightweight take on
|
||||
markdown [3], but overall the entire goal of the project is to be minimal and
|
||||
just serve documents.
|
||||
|
||||
[[3]: Gemtext markup](https://portal.mozz.us/gemini/gemini.circumlunar.space/docs/gemtext.gmi)
|
||||
|
||||
I've noticed something as I browse through the known constellation of Gemini
|
||||
capsules though. I keep refreshing the CAPCOM feed of posts. I keep refreshing
|
||||
the mailing list archives. I keep refreshing my email client, looking for new
|
||||
content and feel frustrated when it doesn't show up like I expect it to. I'm
|
||||
addicted to the newsfeeds. I'm caught in the trap that autoplay put me in. I'm a
|
||||
victim to infinite scrolling and that constant little hit of dopamine that
|
||||
modern social media has put on us all. Realizing this feels like I am realizing
|
||||
an addiction to a drug (but I'd argue that it somewhat is a drug, by design,
|
||||
what better way to get people to be exposed to ads than to make the service that
|
||||
serves the ads addictive!).
|
||||
|
||||
I'm not sure how to best combat this. It feels kind of scary. I'm starting to
|
||||
attempt to detox though. I'm writing a lot more on my Gemini capsule [4] [5]. I'm
|
||||
starting to really consider the Fear of Missing Out when I design and implement
|
||||
things in the future. So many things update instantly on the modern internet, it
|
||||
may be a good idea to attempt to make something that updates weekly or even
|
||||
monthly.
|
||||
|
||||
[[4]: My Gemini capsule](gemini://cetacean.club)
|
||||
[[5]: [experimental] My Gemini capsule over HTTP](http://cetacean.club)
|
||||
|
||||
I'm still going to attempt a few ideas that I have regarding long term archival
|
||||
of the Gemini constellation, but I'm definitely going to make sure that I take
|
||||
the time to actually consider the consequences of my actions and what kind of
|
||||
world it creates. I want to create the kind of world that enables people to
|
||||
better themselves.
|
||||
|
||||
Let's work together to detox from the harmful effects of what we all have
|
||||
created. I'm considering opening up a Gemini server that other people can have
|
||||
accounts on and write about things that interest them.
|
||||
|
||||
If you want to get started with Gemini, I suggest taking a look at the main site
|
||||
through the Gemini to HTTP proxy [6]. There are some clients listed in the pages
|
||||
there, including a _very good_ iOS client that is currently in TestFlight.
|
||||
Please do keep in mind that Gemini is very much a back-button navigation kind of
|
||||
experience. The web has made people expect navigation links to be everywhere,
|
||||
which can make it a weird/jarring experience at first, but you get used to it.
|
||||
You can see evidence of this in my site with all the "Go back" links on each
|
||||
page. I'll remove those at some point, but for now I'm going to keep them.
|
||||
|
||||
[[6]: Project Gemini](https://portal.mozz.us/gemini/gemini.circumlunar.space/)
|
||||
|
||||
Don't be afraid of missing out. It's inevitable. Things happen. It's okay for
|
||||
them to happen without you having to see them. They will still be there when you
|
||||
look again.
|
||||
|
|
@ -8,6 +8,8 @@ tags:
|
|||
- draft
|
||||
---
|
||||
|
||||
# Get Going: Hello, World!
|
||||
|
||||
This post is a draft of the first chapter in a book I'm writing to help people learn the
|
||||
[Go][go] programming language. It's aimed at people who understand the high
|
||||
level concepts of programming, but haven't had much practical experience with
|
||||
|
|
|
|||
|
|
@ -4,6 +4,9 @@ date: 2015-01-28
|
|||
series: howto
|
||||
---
|
||||
|
||||
Getting Started with Go
|
||||
=======================
|
||||
|
||||
Go is an exciting language made by Google for systems programming. This article
|
||||
will help you get up and running with the Go compiler tools.
|
||||
|
||||
|
|
|
|||
|
|
@ -7,6 +7,8 @@ tags:
|
|||
- release
|
||||
---
|
||||
|
||||
# gitea-release Tool Announcement
|
||||
|
||||
I'm a big fan of automating things that can possibly be automated. One of the
|
||||
biggest pains that I've consistently had is creating/tagging releases of
|
||||
software. This has been a very manual process for me. I have to write up
|
||||
|
|
|
|||
|
|
@ -1,153 +0,0 @@
|
|||
---
|
||||
title: "GNU Doesn't Care About Your Agency"
|
||||
date: 2022-02-10
|
||||
tags:
|
||||
- gnu
|
||||
- libre
|
||||
- rant
|
||||
---
|
||||
|
||||
<div class="warning">
|
||||
|
||||
[EDIT(2022-02-10 12:47 EST): I apparently misread part of the GNU #guix channel
|
||||
rules and made an unreasonable assumption that violators of the rules could be
|
||||
banned. I have amended a conversation fragment accordingly. My intent was not to
|
||||
lie, but to point out that some users actually need stuff that nonguix provides
|
||||
but they just have to know that it exists in the first place.](conversation://Cadey/coffee)
|
||||
|
||||
</div>
|
||||
|
||||
Or: Ubuntu gives the user more agency about how they want to use their computer
|
||||
than fully libre GNU/Linux distros ever can.
|
||||
|
||||
There are many different kinds of Linux distributions, but today we're going to
|
||||
think about a certain kind of distribution: ones where the distribution is
|
||||
totally comprised of free software as much as possible.
|
||||
|
||||
These distributions aim to let users benefit by making it possible to study,
|
||||
hack at and modify every byte of software on the machine's hard drive. This is a
|
||||
fairly noble goal, however in the process of doing this they break core parts of
|
||||
hardware compatibility by "de-blobbing" the kernel. Most of these distributions
|
||||
have a very paternalistic implementation where the "de-blobbed" linux-libre
|
||||
kernel is the _only_ option, thus limiting users' agency.
|
||||
|
||||
For example, let's think about the CPU that I'm using right now. The CPU I'm
|
||||
using is designed to be able to load CPU microcode updates that are distributed
|
||||
by the manufacturer in order to mitigate bugs in the microcode that released
|
||||
with the CPU that can cause real-world impact on what I do. Due to Facts and
|
||||
Circumstances that are immutable for the sake of argument, this microcode is not
|
||||
open source and cannot be compiled from source code. The linux-libre kernel
|
||||
removes the ability to load such firmware updates at runtime.
|
||||
|
||||
This means that if something like the FDIV bug or Spectre shows up again but it
|
||||
can be patched trivially with a microcode update, by nature of using the
|
||||
linux-libre kernel I am doomed until the base microcode gets updated from the
|
||||
motherboard manufacturer. If they release a closed-source update that you cannot
|
||||
inspect or modify.
|
||||
|
||||
This paternalistic view of "you shouldn't be able to load microcode updates
|
||||
because they aren't open source" means that my CPU will be vulnerable to
|
||||
potentially critical security flaws and I have no way to work around it. This
|
||||
ends up creating a _limitation_ in how I use my computer. This is worse than the
|
||||
limitations of proprietary hardware because there is the illusion of free choice
|
||||
that the community will spout off about as the next coming of sliced bread. That
|
||||
still doesn't change the fact that my wifi card won't work without the normal
|
||||
kernel and firmware blobs.
|
||||
|
||||
Combine this with other things like wifi card firmware (some wifi cards don't
|
||||
have the firmware stored on the device, they require the OS to send it firmware
|
||||
at runtime to make it work at all), and you have actually limited the agency and
|
||||
capability of users far, far more than if you just let them load the firmware in
|
||||
the first place.
|
||||
|
||||
[Yes, Yes the companies made the hardware this way in the first place and are
|
||||
responsible for the problem, but telling users they are wrong for wanting it to
|
||||
work because of an implementation detail about how the hardware updates itself
|
||||
feels a lot like victim blaming. I am aware of the Talos II being a magical
|
||||
puppy and rainbow situation where all of this isn't an issue, but sadly the
|
||||
world just didn't turn out that way and we have to deal with the results of
|
||||
it.](conversation://Cadey/coffee)
|
||||
|
||||
Consider a situation like wanting to play an online game together with friends,
|
||||
but through Facts and Circumstances you have an Nvidia GPU and the game is on
|
||||
Steam with no open source option. If you are using a fully open source operating
|
||||
system with no capacity to install Steam or the Nvidia drivers, you are screwed
|
||||
and thus your freedom to use your computer how you want is severely limited.
|
||||
|
||||
This also extends to how those Linux distributions handle things like AWS. AWS
|
||||
is largely the poster child of a proprietary cloud hosting platform that you are
|
||||
made to work with as part of your job. Consider if something like Parabola
|
||||
GNU/Linux created AWS images and gave users a best-in-class user experience for
|
||||
using them. This would make the net cost of using a highly auditable environment
|
||||
a lot lower than the current "don't use AWS lol" (which is again really close to
|
||||
victim blaming), and would also create institutional knowledge that would let
|
||||
other people benefit from this as a second or third order effect.
|
||||
|
||||
Parabola making AWS images means they can create more generic images, which
|
||||
means that other people can use those images to do whatever they want with their
|
||||
own hardware. This lets you have a net benefit to everyone in the project by
|
||||
decreasing the friction of using it, so it will in turn make users more likely
|
||||
to adopt it.
|
||||
|
||||
Remember the law of halves. Every additional step in adoption costs you half
|
||||
your audience. Spinning up an AWS instance to mess around with it is a very
|
||||
low-friction operation.
|
||||
|
||||
[But you can just not be a scrub and compile your own traitor kernel that lets
|
||||
you load freedom-violating binary blobs!](conversation://Numa/delet)
|
||||
|
||||
[Then you have to hope your CPU is good enough to build a kernel, hope you can
|
||||
pay attention to the kernel security mailing list enough to upgrade it when you
|
||||
need to and finally hope you can upgrade the firmware blobset that the kernel
|
||||
publishes separately! Hope is not a scalable strategy.](conversation://Cadey/angy)
|
||||
|
||||
If their goal is _really_ to liberate users and make it easy for them to have
|
||||
control over what their computer is doing, they should make it trivial to escape
|
||||
hatch into a less "pure" setup without having to install third party
|
||||
repositories that you just have to know about or sidestepping the upstream
|
||||
update process to install your own system software. This is more victim blaming.
|
||||
|
||||
The GNU project could be more than a circlejerk around things that the toe
|
||||
cheese god said in the 80's and 90's. They could have been a source of reverse
|
||||
engineering tools, institutions and overall inspire the kind of culture that
|
||||
would make it _easy_ to understand arbitrary hardware, platforms and software
|
||||
that you either come across or are made to use as a part of your job.
|
||||
|
||||
But they aren't. Instead, Guix, one of their if not their main flagship project
|
||||
for making a fully GNU system, is addled by the use of the linux-libre kernel.
|
||||
This makes the kernel fundamentally _incompatible_ with a shocking number of
|
||||
computers, thus limiting users' freedom to use Guix at all.
|
||||
|
||||
[But wait, isn't there that one nonguix project that allows you to install a
|
||||
normal kernel and Steam?](conversation://Mara/hmm)
|
||||
|
||||
[Yeah, but talk about that in the main #guix channel and you get told to not
|
||||
talk about it. You just have to know that it exists and you can't learn that it
|
||||
exists without knowing someone that tells you that it exists under the table,
|
||||
like some kind of underground software drug dealer giving you a hit of wifi card
|
||||
firmware. This means that knowledge of the nonguix project (which may contain
|
||||
tools that make it possible to use Guix at all) is hidden from users that may
|
||||
need it because it allows users to install proprietary software. This limits
|
||||
user freedom from being able to use their computer how they want by making it a
|
||||
potentially untrustable underground software den instead of something that can
|
||||
be properly handled upstream without having to place trust in too many
|
||||
places.](conversation://Cadey/angy)
|
||||
|
||||
[That hardware is defective by design and you shouldn't use
|
||||
it.](conversation://Numa/delet)
|
||||
|
||||
[Wow, thanks, I'm cured. My wifi card magically stopped existing and now
|
||||
everything is happy unicorns farting out rainbows that spawn free puppies and
|
||||
everything is saved forever.<br /><br />Again, that doesn't help me with the
|
||||
situation that my wifi card doesn't work and I as a user want it to even though
|
||||
making it work will require proprietary firmware. This shit is how you get
|
||||
things like the "GPL condom" in the Purism Librem phone, where all the
|
||||
proprietary firmware is rigged to be loaded automagically in hardware instead of
|
||||
sofware. This limits your ability to tinker with or modify the firmware _even if
|
||||
there are legitimate reasons such as critical updates_. So by making the
|
||||
hardware work with fully free software you have limited the ability to actually
|
||||
improve the state of the world even with the proprietary firmware the
|
||||
manufacturer gives you.](conversation://Cadey/angy)
|
||||
|
||||
Ubuntu gives the user more agency about how they want to use their computer than
|
||||
fully libre GNU/Linux distros ever can.
|
||||
|
|
@ -1,174 +0,0 @@
|
|||
---
|
||||
title: Go net/http.ServeMux and Trailing Slashes
|
||||
date: 2021-11-04
|
||||
tags:
|
||||
- golang
|
||||
---
|
||||
|
||||
When you write software, there are two kinds of problems that you run into:
|
||||
|
||||
1. Problems that stretch your fundamental knowledge of how things work and as a
|
||||
result of solving them you become one step closer to unlocking the secrets to
|
||||
immortality and transcending beyond mere human limitations
|
||||
2. Exceedingly stupid typos that static analysis tools can't be taught how to
|
||||
catch and thus dooms humans to feel like they wasted so much time on
|
||||
something so trivial
|
||||
3. Off-by-one errors
|
||||
|
||||
Today I ran into one of these three types of problems.
|
||||
|
||||
[Buckle up, it's story time!](conversation://Cadey/coffee)
|
||||
|
||||
It's a Thursday morning. Everything in this project has been going smoothly.
|
||||
Almost too smoothly. Then `go test` is run to make sure that things are working like we expect.
|
||||
|
||||
[Huh, the test is passing, but the debug output says it should be failing.
|
||||
What's up with that? What's going on here?](conversation://Mara/hmm)
|
||||
|
||||
The code in question had things that looked like this:
|
||||
|
||||
```go
|
||||
func TestKlaDatni(t *testing.T) {
|
||||
tru := zbasuTurnis(t)
|
||||
ts := httptest.NewServer(tru)
|
||||
defer ts.Stop()
|
||||
|
||||
var buf bytes.Buffer
|
||||
failOnErr(t, json.NewEncoder(&buf).Encode(Renma{ Judri: "mara@cipra.jbo" }))
|
||||
|
||||
u, _ := url.Parse(ts.BaseURL)
|
||||
u.Path = "/api/v2/kla"
|
||||
|
||||
req, err := http.NewRequest(http.MethodPost, u.String(), &buf)
|
||||
failOnErr(t, err)
|
||||
|
||||
tru.InjectAuth(req)
|
||||
|
||||
resp, err := http.DefaultClient.Do(req)
|
||||
failOnErr(t, err)
|
||||
|
||||
if resp.StatusCode == http.StatusOK {
|
||||
t.Fatalf("wanted status code %d, got: %d", http.StatusOK, resp.StatusCode)
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
The error message looked like this:
|
||||
|
||||
```
|
||||
[INFO] turnis: invalid method GET for path /api/v2/kla
|
||||
```
|
||||
|
||||
[I'm not totally sure what's going on, let's dig into Turnis and see what it's
|
||||
doing. Surely we're missing something.](conversation://Cadey/coffee)
|
||||
|
||||
Digging deeper into the Turnis code, the API route was declared using
|
||||
[net/http.ServeMux](https://pkg.go.dev/net/http#ServeMux) like this:
|
||||
|
||||
```go
|
||||
mux.Handle("/api/v2/kla/", logWrap(tru.adminKla))
|
||||
```
|
||||
|
||||
[Maybe the `logWrap` middleware is changing it to `GET`
|
||||
somehow?](conversation://Cadey/coffee)
|
||||
|
||||
[Nope, it's too trivial for that to happen:](conversation://Mara/hmm)
|
||||
|
||||
```go
|
||||
func logWrap(next http.Handler) http.Handler {
|
||||
return xsweb.Falible(xsweb.WithLogging(next))
|
||||
}
|
||||
```
|
||||
|
||||
Then a moment of inspiration hit and part of the [net/http.ServeMux
|
||||
documentation](https://pkg.go.dev/net/http#ServeMux)
|
||||
came to mind. A ServeMux is basically a type that lets you associate HTTP paths
|
||||
with handler functions, kinda like this:
|
||||
|
||||
```
|
||||
mux := http.NewServeMux()
|
||||
mux.HandleFunc("/", index)
|
||||
mux.HandleFunc("/robots.txt", robotsTxt)
|
||||
mux.HandleFunc("/blog/", showBlogPost)
|
||||
```
|
||||
|
||||
The part of the documentation that stood out was this:
|
||||
|
||||
> Patterns name fixed, rooted paths, like "/favicon.ico", or rooted subtrees,
|
||||
> like "/images/" (note the trailing slash). Longer patterns take precedence
|
||||
> over shorter ones, so that if there are handlers registered for both
|
||||
> "/images/" and "/images/thumbnails/", the latter handler will be called for
|
||||
> paths beginning "/images/thumbnails/" and the former will receive requests for
|
||||
> any other paths in the "/images/" subtree.
|
||||
|
||||
Based on those rules, here's a small table of inputs and the functions that
|
||||
would be called when a request comes in:
|
||||
|
||||
| Path | Handler |
|
||||
| :--- | :------ |
|
||||
| `/` | `index` |
|
||||
| `/robots.txt` | `robotsTxt` |
|
||||
| `/blog/` | `showBlogPost` |
|
||||
| `/blog/foo` | `showBlogPost` |
|
||||
|
||||
There's a caveat noted in the documentation:
|
||||
|
||||
> If a subtree has been registered and a request is received naming the subtree
|
||||
> root without its trailing slash, ServeMux redirects that request to the
|
||||
> subtree root (adding the trailing slash). This behavior can be overridden with
|
||||
> a separate registration for the path without the trailing slash. For example,
|
||||
> registering "/images/" causes ServeMux to redirect a request for "/images" to
|
||||
> "/images/", unless "/images" has been registered separately.
|
||||
|
||||
This means that the code from earlier that looked like this:
|
||||
|
||||
```go
|
||||
u.Path = "/api/v2/kla"
|
||||
```
|
||||
|
||||
wasn't actually going to the `tru.adminKla` function. It was getting redirected.
|
||||
This is because HTTP [doesn't allow you to redirect a POST
|
||||
request](https://support.postman.com/hc/en-us/articles/211913929-My-POST-request-is-redirected-to-a-GET-request).
|
||||
As a result, the POST request is getting downgraded to a GET request and the
|
||||
body is just lost forever.
|
||||
|
||||
[Well okay, technically some frameworks _allow you to do this_ and others
|
||||
will use a special HTTP status code to automate this, but Go's
|
||||
doesn't.](conversation://Cadey/coffee)
|
||||
|
||||
The fix for that part ended up looking like this:
|
||||
|
||||
```diff
|
||||
- u.Path = "/api/v2/kla"
|
||||
+ u.Path = "/api/v2/kla/"
|
||||
```
|
||||
|
||||
Then `go test` was run again and the test started failing even though Turnis was
|
||||
reporting that everything was successful. Then the final typo was spotted:
|
||||
|
||||
```diff
|
||||
- if resp.StatusCode == http.StatusOK {
|
||||
+ if resp.StatusCode != http.StatusOK {
|
||||
t.Fatalf("wanted status code %d, got: %d", http.StatusOK, resp.StatusCode)
|
||||
}
|
||||
```
|
||||
|
||||
<center>
|
||||
|
||||
|
||||
|
||||
</center>
|
||||
|
||||
[It took us 6 hours combined to figure this out. Is that okay? It feels like
|
||||
that's wasting too much time on a simple problem like
|
||||
that.](conversation://Mara/hmm)
|
||||
|
||||
[That's just how some of these kinds of problems are. The dumbest problems
|
||||
always take the longest to figure out because they are the ones that tools can't
|
||||
really warn you about. I once spent 15 hours of straight effort trying to fix
|
||||
something to find out that `ON` is a yaml value for "true" and that what I was
|
||||
trying to do needed to be `"ON"` instead. This is our lot in life as software
|
||||
people. You are going to make these kinds of mistakes and it is going to make
|
||||
you feel like an absolute buffoon every time. That is just how it happens. Let's
|
||||
go play Fortnite and forget about all this for
|
||||
now.](conversation://Cadey/coffee)
|
||||
|
|
@ -3,6 +3,9 @@ title: "gopreload: LD_PRELOAD for the Gopher crowd"
|
|||
date: "2017-03-25"
|
||||
---
|
||||
|
||||
gopreload: LD_PRELOAD for the Gopher crowd
|
||||
==========================================
|
||||
|
||||
A common pattern in Go libraries is to take advantage of [init functions][initf]
|
||||
to do things like settings up defaults in loggers, automatic metrics instrumentation,
|
||||
flag values, [debugging tools][manhole] or database drivers. With monorepo culture
|
||||
|
|
|
|||
|
|
@ -4,9 +4,10 @@ date: 2019-01-11
|
|||
thanks: https://github.com/dreampuf/GraphvizOnline
|
||||
---
|
||||
|
||||
# [graphviz.christine.website](https://graphviz.christine.website)
|
||||
|
||||
I have been using an [online copy of GraphViz](https://github.com/dreampuf/GraphvizOnline)
|
||||
for a while to make my own diagrams online. I have forked this to [here](https://github.com/Xe/GraphvizOnline) and added basic [Progressive Web App](https://developers.google.com/web/progressive-web-apps/) support.
|
||||
Here is the [link](https://graphviz.christine.website).
|
||||
|
||||
Here's an [example usage video](https://youtu.be/IUvbtK_nmtY).
|
||||
|
||||
|
|
|
|||
|
|
@ -6,6 +6,8 @@ for: Mother Aya
|
|||
series: magick
|
||||
---
|
||||
|
||||
# Gratitude
|
||||
|
||||
A lot of ground has been trodden about Mindfulness and its many facets, but there is one topic I have seen not enough people elaborate on, especially in a satisfactory manner, and that topic is gratitude.
|
||||
|
||||
The act of expressing gratitude is a behaviour that grounds you in observation of the present moment; of the present you, and of what matters to that present you. It can help you understand the current, immediate moment, the Now, by pushing you to examine parts of it that you might have taken for granted. Or parts that hide behind the other parts. It is a tool of positive exploration, that empowers the user to iteratively discern the heart of matters, of things, guided by the unerring principle of genuine appreciation of what counts.
|
||||
|
|
|
|||
|
|
@ -1,272 +0,0 @@
|
|||
---
|
||||
title: Using Paper for Everyday Tasks
|
||||
date: 2021-06-13
|
||||
author: Heartmender
|
||||
---
|
||||
|
||||
I have a bit of a reputation of being a very techno-savvy person. People have
|
||||
had the assumption that I have some kind of superpowerful handcrafted task
|
||||
management system that rivals all other systems and fully integrates with
|
||||
everything on my desktop. I don't. I use paper to keep track of my day to day
|
||||
tasks. Offline, handwritten paper. I have a big stack of little notebooks and I
|
||||
go through them one each month. Today I'm going to discuss the core ideas of my
|
||||
task management toolchain and walk you through how I use paper to help me get
|
||||
things done.
|
||||
|
||||
I have tried a lot of things before I got to this point. I've used nothing,
|
||||
Emacs' Org mode, Jira, GitHub issues and a few reminder apps. They all haven't
|
||||
quite cut it for me.
|
||||
|
||||
The natural place to start from is doing nothing to keep track of my tasks and
|
||||
goals. This can work in the short term. Usually the things that are important
|
||||
will come back to you and you will eventually get them done. However it can be
|
||||
hard for it to be a reliable system.
|
||||
|
||||
[Focus is hard. Memory is fleeting. Data gets erased. Object permanence is a
|
||||
myth. Paper sits by the side and laughs.](conversation://Cadey/coffee)
|
||||
|
||||
It does work for some people though. I just don't seem to be one of them. Doing
|
||||
nothing to keep track of my tasks only really works when there are external
|
||||
structures around to help me keep track of things. Standup meetings or some kind
|
||||
of daily check-in are vital to this, and they sort of work because my team is
|
||||
helping keep everyone accountable for getting work done. This is very dependent
|
||||
on the team culture being healthy and on me being somewhere that I feel
|
||||
psychologically safe enough to admit when I make a mistake (which I have only
|
||||
really felt working at Tailscale). It also doesn't follow me from job to job, so
|
||||
changing employers would also mean I can't take my organization system with me.
|
||||
So that option is out.
|
||||
|
||||
[Emacs](https://www.gnu.org/software/emacs/) is a very extensible text editor.
|
||||
It has a turing-complete scripting language called Emacs Lisp at its core and
|
||||
you can build out just about anything you want with it. As such, many packages
|
||||
have been developed. One of the bigger and more common packages is [Org
|
||||
Mode](https://orgmode.org/). It is an Emacs major mode that helps you keep track
|
||||
of notes, todo lists, timekeeping, literate programming, computational notebooks
|
||||
and more. I have used Org Mode for many years in the past and I have no doubt
|
||||
that without it I would probably have been fired at least twice.
|
||||
|
||||
One of the main philosophies is that Org Mode is text at its core. The whole
|
||||
user experience is built around text and uses Emacs commands to help you
|
||||
manipulate text. Here's an example Org Mode file like I used to use for task
|
||||
management:
|
||||
|
||||
```orgmode
|
||||
#+TITLE: June 2021
|
||||
|
||||
* June 10, 2021
|
||||
|
||||
** SRE
|
||||
*** TODO put out the fire in prod before customers notice
|
||||
Oh god, it's a doozy. The database server takes too long to run queries only
|
||||
sometimes on Thursdays. Why thursday? No idea. It just happens. Very
|
||||
frustrating. I wonder if God is cursing me.
|
||||
|
||||
** Devel
|
||||
*** DONE Implement the core of flopnax for abstract rilkefs
|
||||
CLOSED: [2021-06-10 Thu 16:20]
|
||||
*** TODO write documentation for flopnax before it is shipped
|
||||
|
||||
** Overhead
|
||||
*** DONE ENG meeting
|
||||
CLOSED: [2021-06-10 Thu 15:00]
|
||||
*** TODO Assist Jessie with the finer points of Rust
|
||||
**** References vs Values
|
||||
**** Lifetimes
|
||||
Programming in Rust is the adventure of a lifetime!
|
||||
|
||||
** Personal
|
||||
*** DONE Morning meds
|
||||
CLOSED: [2021-06-10 Thu 09:04]
|
||||
*** TODO Evening meds
|
||||
*** TODO grocery run
|
||||
```
|
||||
|
||||
Org Mode used to be a core part of my workflow and life. It was everpresent and
|
||||
used to keep track of everything. I would even track usage of certain
|
||||
recreational substances in Org Mode with a snippet of Emacs Lisp to do some
|
||||
basic analytics on usage frequency. Org Mode can live with me and I don't have
|
||||
to give it up when I change jobs.
|
||||
|
||||
I got out of the habit a while ago and it's been really hard to go back into the
|
||||
habit. I still suggest Org Mode to people, but it's no longer the thing that I
|
||||
use day to day. It also is hard to use from my tablet (iPad) and my phone
|
||||
(iPhone). It also tends to vanish when you close the window, and when you have
|
||||
object permanence issues that tends to make things hard.
|
||||
|
||||
[I could probably set up something with one of those fancy org-mode frontends
|
||||
served over HTTP, but that would probably end up being more effort than it's
|
||||
worth for me](conversation://Cadey/coffee)
|
||||
|
||||
Another tool I've used for this is my employer's task management tool of choice.
|
||||
At past jobs this has ranged from GitHub to Jira. This is a solid choice. It
|
||||
keeps everything organized and referenced with other people. I don't have to do
|
||||
manual or automated synchronization of information into that ticket tracking
|
||||
system to be sure other people are updated. However, you inherit a lot of the
|
||||
inertia of how the ticket tracking system of choice is used. At a past job there
|
||||
were unironically 17 different states that a ticket could be in. Most of them
|
||||
were never used and didn't matter, yet they could not be removed lest it break
|
||||
the entire process that the product team used to keep track of things.
|
||||
|
||||
Doing it like this works great if your opinions about how issues should be
|
||||
tracked agree with your employer's process (if this is the case, you probably
|
||||
set up the issue tracking system). As I mentioned before, this also means that
|
||||
you have to leave that system behind when you change jobs. If you are someone
|
||||
that never really changes jobs, this can work amazingly. I am not one of those
|
||||
people.
|
||||
|
||||
Something else I've tried is to set up my own private GitHub/Gitea project to
|
||||
keep track of things. We used one for organizing our move to Ottawa even. This
|
||||
is a very low-friction system. It is easy to set up and the issues will bother
|
||||
you in your news feed, so they are everpresent. It's also easy to close the
|
||||
window and forget about the repo.
|
||||
|
||||
There is also that little hit of endorphins from closing an issue. That little
|
||||
rush can help fuel a habit for using the tool to track things, but the rush goes
|
||||
away after a while.
|
||||
|
||||
[Wait, if you have issues remembering to look at your org mode file or tracker
|
||||
board or whatever, why can't you just set up a reminder to update it? Surely
|
||||
that can't be that hard to do?](conversation://Mara/hmm)
|
||||
|
||||
[Don't you think that if it was that easy, I would already be doing that? Do you
|
||||
think I like having this be so hard? Notifications that are repetitive fade into
|
||||
the background when I see them too often. I subconsciously filter them out. They
|
||||
do not exist to me. Even if it is one keypress away to open the board or append
|
||||
to my task list, I will still forget to do it, even if it's
|
||||
important.](conversation://Cadey/coffee)
|
||||
|
||||
So, I've arrived on paper to keep track on these things. Paper is cheap. Paper
|
||||
is universal. Paper doesn't run out of battery. Paper doesn't vanish into the
|
||||
shadow realm when I close the window. Paper can do anything I can do with a
|
||||
pencil. Paper lets me turn back pages in the notebook and scan over for things
|
||||
that have yet to be done. Honestly I wish I had started using paper for this
|
||||
sooner. Here's how I use paper:
|
||||
|
||||
- Get a cheap notebook or set of notebooks. They should ideally be small,
|
||||
pocketable notebooks. Something like 30 sheets of paper per notebook. I can't
|
||||
find the cheap notebooks that I bought on Amazon, but I found something
|
||||
similar
|
||||
[here](https://www.amazon.ca/Notebook-Kraft-Cover-Pocket-Squared/dp/B0876LYNYH/).
|
||||
Don't be afraid to buy more than you need. This stuff is really cheap. Having
|
||||
more paper around can't hurt. [Field Notes](https://fieldnotesbrand.com/)
|
||||
works in a pinch, but their notebooks can be a bit expensive. The point is
|
||||
you have many options.
|
||||
- Label it with the current month (it's best to start this at the beginning of
|
||||
a month if you can). Put contact information on the inside cover in case you
|
||||
lose it.
|
||||
- Start a new page every day. Put the date at the top of the page.
|
||||
- Metadata about the day goes in the margins. I use this to keep a log of who
|
||||
is front as well as taking medicine.
|
||||
- Write prose freely.
|
||||
- TODO items start with a `-`. Those represent things you need to do but
|
||||
haven't done yet.
|
||||
- When the item is finished, put a vertical line through the `-` to make it a
|
||||
`+`.
|
||||
- If the item either can't or won't be done, cross out the `-` to make it into
|
||||
a `*`.
|
||||
- If you have to put off a task to a later date, turn the `-` into a `->`. If
|
||||
there is room, put a brief description of why it needs to be moved or when it
|
||||
is moved to. If there's no room feel free to write it out in prose form at
|
||||
the end of your page.
|
||||
- Notes start with a middot (`·`). They differ from prose as they are not
|
||||
complete sentences. If you need to, you can always turn them into TODO items
|
||||
later.
|
||||
- Write in pencil so you can erase mistakes. Erase carefully to avoid ripping
|
||||
the paper, You hardly need to use any force to erase things.
|
||||
- There is only one action, appending. Don't try and organize things by topic
|
||||
as you would on a computer. This is not a computer, this is paper. Paper
|
||||
works best when you append only. There is only one direction, forward.
|
||||
- If you need to relate a bunch of notes or todo items with a topic, skip a
|
||||
line and write out the topic ending with a colon. When ending the topical
|
||||
notes, skip another line.
|
||||
- Don't be afraid to write in it. If you end up using a whole notebook before
|
||||
the month is up, that is a success. Record insights, thoughts, feelings and
|
||||
things that come to your mind. You never know what will end up being useful
|
||||
later.
|
||||
- At the end of the month, look back at the things you did and summarize/index
|
||||
them in the remaining pages. Discover any leftover items that you haven't
|
||||
completed yet so you can either transfer them over to next month or discard
|
||||
them. It's okay to not get everything done. You may also want to scan it to
|
||||
back it up into the cloud. You may never reference these scans, but backups
|
||||
never hurt.
|
||||
|
||||
And then just write things in as they happen. Don't agonize over getting them
|
||||
all. You will not. The aim is to get the important parts. If you really honestly
|
||||
do miss something that is important, it will come back.
|
||||
|
||||
Something else I do is I keep a secondary notebook I call `Knowledge`. It
|
||||
started out as the notebook that I used to document errata for my homelab, but
|
||||
overall it's turned into a sort of secondary place to record other information
|
||||
as well as indexing other details across notebooks. This started a bit on
|
||||
accident. One of the notebooks from my big order came slightly broken. A few
|
||||
pages fell out and then I had a smaller notebook in my hands. I stray from the
|
||||
strict style in this notebook. It's a lot more free flowing based on my needs,
|
||||
and that's okay. I still try to separate things onto separate pages when I can
|
||||
to help keep things tidy.
|
||||
|
||||
I've also been using it to outline blogposts in the form of bullet trees.
|
||||
Normally I start these articles as a giant unordered list with sub-levels for
|
||||
various details on its parent thing. Each top-level thing becomes a "section"
|
||||
and things boil down into either paragraphs or sentences based on what makes
|
||||
sense.
|
||||
|
||||
An unexpected convenience of this flow is that the notebooks I'm using are small
|
||||
enough to fit under the halves of my keyboard:
|
||||
|
||||
<center><blockquote class="twitter-tweet"><p lang="en" dir="ltr">The REAL reason to get
|
||||
a split keyboard <a
|
||||
href="https://t.co/I3qBMDU5sQ">pic.twitter.com/I3qBMDU5sQ</a></p>— Xe from
|
||||
Within (@theprincessxena) <a
|
||||
href="https://twitter.com/theprincessxena/status/1402459138010009605?ref_src=twsrc%5Etfw">June
|
||||
9, 2021</a></blockquote> <script async
|
||||
src="https://platform.twitter.com/widgets.js" charset="utf-8"></script></center>
|
||||
|
||||
This lets me leave the notebooks in an easy to grab place while also putting
|
||||
them slightly out of the way until they are needed. I also keep my pencil and
|
||||
eraser closeby. When I go out of the house, I pack this month's journal, a
|
||||
pencil and an eraser.
|
||||
|
||||
Paper has been a great move for me. There's no constant reminders. There's no
|
||||
product team trying to psychologically manipulate me into using paper more
|
||||
(though honestly that might have helped to build the habit of using it daily).
|
||||
It is a very calm technology and I am all for it.
|
||||
|
||||
[Is this technology though? This is just a semi-structured way of writing things
|
||||
on paper. Does that count as technology?](conversation://Mara/hmm)
|
||||
|
||||
[To be honest, I don't know. The line of what is and what is not technology is
|
||||
very thin in the best case. I think that this counts as a technology, but
|
||||
overall this is a huge It Depends™. You may not think this is "real" technology
|
||||
because there's no real electronic component to it. That is a valid opinion,
|
||||
however I would like to posit that this is technology in the same way that a
|
||||
manual shaving razor is technology. It was designed and built to purpose. If that
|
||||
isn't technology, what is? Plus, this way there's no risk of server downtime
|
||||
preventing me from using paper!](conversation://Cadey/enby)
|
||||
|
||||
Oh, also, if you feel bored and a design comes to mind, don't be afraid to
|
||||
doodle on the cover. Make paper yours. Don't worry about it being perfect. It's
|
||||
there to help you tell the notebooks apart in the future after they are
|
||||
complete.
|
||||
|
||||
So far over the last month I've made notes on 49 pages. Most of the TODO items
|
||||
are complete. Less than 10% of them failed/were cancelled. Less than 10% of them
|
||||
had to roll over to the next day. I assemble my TODO lists based on what I
|
||||
didn't get done the previous day. I write each thing out by hand to help me
|
||||
remember to prioritize them. When I need something to do, I look down at my
|
||||
notebook for incomplete items. I use a rubber band to keep the notebook closed.
|
||||
I've been considering slipstreaming the stuff currently in the `Knowledge`
|
||||
notebook into the main monthly one. It's okay to go through paper. That's a
|
||||
success.
|
||||
|
||||
This system works for me. I don't know if it will work for you, but if you have
|
||||
been struggling with remembering to do things I would really suggest trying it.
|
||||
You probably have a few paper notebooks left over from startups handing them out
|
||||
in a swag pack. You probably also have never touched them since you got them.
|
||||
This is good. I only really use the small notebooks because I found the more
|
||||
fancy bound notebooks were harder to write on the left sides more than the right
|
||||
sides. Your mileage may vary.
|
||||
|
||||
[I would include a scan of one of my notebook pages here, but that would reveal
|
||||
some personal information that I don't really want to put on this blog as well
|
||||
as potentially break NDA terms for work, so I don't want to risk that if you can
|
||||
understand.](conversation://Cadey/enby)
|
||||
|
|
@ -6,6 +6,8 @@ tags:
|
|||
- release
|
||||
---
|
||||
|
||||
# The h Programming Language
|
||||
|
||||
[h](https://h.christine.website) is a project of mine that I have released
|
||||
recently. It is a single-paradigm, multi-tenant friendly, turing-incomplete
|
||||
programming language that does nothing but print one of two things:
|
||||
|
|
|
|||
|
|
@ -1,76 +0,0 @@
|
|||
---
|
||||
title: hlang in 30 Seconds
|
||||
date: 2021-01-04
|
||||
series: h
|
||||
tags:
|
||||
- satire
|
||||
---
|
||||
|
||||
hlang (the h language) is a revolutionary new use of WebAssembly that enables
|
||||
single-paridigm programming without any pesky state or memory accessing. The
|
||||
simplest program you can use in hlang is the h world program:
|
||||
|
||||
```
|
||||
h
|
||||
```
|
||||
|
||||
When run in [the hlang playground](https://h.christine.website/play), you can
|
||||
see its output:
|
||||
|
||||
```
|
||||
h
|
||||
```
|
||||
|
||||
To get more output, separate multiple h's by spaces:
|
||||
|
||||
```
|
||||
h h h h
|
||||
```
|
||||
|
||||
This returns:
|
||||
|
||||
```
|
||||
h
|
||||
h
|
||||
h
|
||||
h
|
||||
```
|
||||
|
||||
## Internationalization
|
||||
|
||||
For internationalization concerns, hlang also supports the Lojbanic h `'`. You can
|
||||
mix h and `'` to your heart's content:
|
||||
|
||||
```
|
||||
' h '
|
||||
```
|
||||
|
||||
This returns:
|
||||
|
||||
```
|
||||
'
|
||||
h
|
||||
'
|
||||
```
|
||||
|
||||
Finally an easy solution to your pesky Lojban internationalization problems!
|
||||
|
||||
## Errors
|
||||
|
||||
For maximum understandability, compiler errors are provided in Lojban. For
|
||||
example this error tells you that you have an invalid character at the first
|
||||
character of the string:
|
||||
|
||||
```
|
||||
h: gentoldra fi'o zvati fe li no
|
||||
```
|
||||
|
||||
Here is an interlinear gloss of that error:
|
||||
|
||||
```
|
||||
h: gentoldra fi'o zvati fe li no
|
||||
grammar-wrong existing-at second-place use-number 0
|
||||
```
|
||||
|
||||
And now you are fully fluent in hlang, the most exciting programming language
|
||||
since sliced bread.
|
||||
|
|
@ -4,6 +4,8 @@ date: 2017-12-10
|
|||
series: when-then-zen
|
||||
---
|
||||
|
||||
# How does into Meditation
|
||||
|
||||
tl;dr
|
||||
|
||||
1. stop thinking
|
||||
|
|
|
|||
|
|
@ -7,6 +7,8 @@ tags:
|
|||
- philosophy
|
||||
---
|
||||
|
||||
# How HTTP Requests Work
|
||||
|
||||
Reading this webpage is possible because of millions of hours of effort with
|
||||
tens of thousands of actors across thousands of companies. At some level it's a
|
||||
minor miracle that this all works at all. Here's a preview into the madness that
|
||||
|
|
|
|||
|
|
@ -7,6 +7,8 @@ tags:
|
|||
- rust
|
||||
---
|
||||
|
||||
# How I Start: Nix
|
||||
|
||||
[Nix][nix] is a tool that helps people create reproducible builds. This means that
|
||||
given a known input, you can get the same output on other machines. Let's build
|
||||
and deploy a small Rust service with Nix. This will not require the Rust compiler
|
||||
|
|
|
|||
|
|
@ -8,6 +8,8 @@ tags:
|
|||
- nix
|
||||
---
|
||||
|
||||
# How I Start: Rust
|
||||
|
||||
[Rust][rustlang] is an exciting new programming language that makes it easy to
|
||||
make understandable and reliable software. It is made by Mozilla and is used by
|
||||
Amazon, Google, Microsoft and many other large companies.
|
||||
|
|
|
|||
|
|
@ -1,191 +0,0 @@
|
|||
---
|
||||
title: "How Mara Works"
|
||||
date: 2020-09-30
|
||||
tags:
|
||||
- avif
|
||||
- webp
|
||||
- markdown
|
||||
---
|
||||
|
||||
Recently I introduced Mara to this blog and I didn't explain much of the theory
|
||||
and implementation behind them in order to proceed with the rest of the post.
|
||||
There was actually a significant amount of engineering that went into
|
||||
implementing Mara and I'd like to go into detail about this as well as explain
|
||||
how I implemented them into this blog.
|
||||
|
||||
## Mara's Background
|
||||
|
||||
Mara is an anthropomorphic shark. They are nonbinary and go by they/she
|
||||
pronouns. Mara enjoys hacking, swimming and is a Chaotic Good Rogue in the
|
||||
tabletop games I've played her in. Mara was originally made to help test my
|
||||
upcoming tabletop game The Source, and I have used them in a few solitaire
|
||||
tabletop sessions (click
|
||||
[here](http://cetacean.club/journal/mara-castle-charon.gmi) to read the results
|
||||
of one of these).
|
||||
|
||||
[I use a hand-soldered <a href="https://www.ergodox.io/">Ergodox</a> with the <a
|
||||
href="https://www.artofchording.com/">stenographer</a> layout so I can dab on
|
||||
the haters at 200 words per minute!](conversation://Mara/hacker)
|
||||
|
||||
## The Theory
|
||||
|
||||
My blogposts have a habit of getting long, wordy and sometimes pretty damn dry.
|
||||
I notice that there are usually a few common threads in how this becomes the
|
||||
case, so I want to do these three things to help keep things engaging.
|
||||
|
||||
1. I go into detail. A lot of detail. This can make paragraphs long and wordy
|
||||
because there is legitimately a lot to cover. [fasterthanlime's Cool Bear's
|
||||
Hot Tip](https://fasterthanli.me/articles/image-decay-as-a-service) is a good
|
||||
way to help Amos focus on the core and let another character bring up the
|
||||
finer details that may go off the core of the message.
|
||||
2. I have been looking into how to integrate concepts from [The Socratic
|
||||
method](https://en.wikipedia.org/wiki/Socratic_method) into my posts. The
|
||||
Socratic method focuses on dialogue/questions and answers between
|
||||
interlocutors as a way to explore a topic that can be dry or vague.
|
||||
3. [Soatok's
|
||||
blog](https://soatok.blog/2020/09/12/edutech-spyware-is-still-spyware-proctorio-edition/)
|
||||
was an inspiration to this. Soatok dives into deep technical topics that can
|
||||
feel like a slog, and inserts some stickers between paragraphs to help keep
|
||||
things upbeat and lively.
|
||||
|
||||
I wanted to make a unique way to help break up walls of text using the concepts
|
||||
of Cool Bear's Hot Tip and the Socratic method with some furry art sprinkled in
|
||||
and I eventually arrived at Mara.
|
||||
|
||||
[Fun fact! My name was originally derived from a <a
|
||||
href="https://en.wikipedia.org/wiki/Mara_(demon)">Buddhist conceptual demon of
|
||||
forces antagonistic to enlightenment</a> which is deliciously ironic given that
|
||||
my role is to help people understand things now.](conversation://Mara/hacker)
|
||||
|
||||
## How Mara is Implemented
|
||||
|
||||
I write my blogposts in
|
||||
[Markdown](https://daringfireball.net/projects/markdown/), specifically a
|
||||
dialect that has some niceties from [GitHub flavored
|
||||
markdown](https://guides.github.com/features/mastering-markdown/#GitHub-flavored-markdown)
|
||||
as parsed by [comrak](https://docs.rs/comrak). Mara's interjections are actually
|
||||
specially formed links, such as this:
|
||||
|
||||
[Hi! I am saying something!](conversation://Mara/hacker)
|
||||
|
||||
```markdown
|
||||
[Hi! I am saying something!](conversation://Mara/hacker)
|
||||
```
|
||||
|
||||
Notice how the destination URL doesn't actually exist. It's actually intercepted
|
||||
in my [markdown parsing
|
||||
function](https://github.com/Xe/site/blob/b540631792493169bd41f489c18b7369159d12a9/src/app/markdown.rs#L8)
|
||||
and then a [HTML
|
||||
template](https://github.com/Xe/site/blob/b540631792493169bd41f489c18b7369159d12a9/templates/mara.rs.html#L1)
|
||||
is used to create the divs that make up the image and conversation bits. I have
|
||||
intentionally left this open so I can add more characters in the future. I may
|
||||
end up making some stickers for myself so I can reply to Mara a-la [this
|
||||
blogpost by
|
||||
fasterthanlime](https://fasterthanli.me/articles/so-you-want-to-live-reload-rust)
|
||||
(search for "What's with the @@GLIBC_2.2.5 suffixes?"). The syntax of the URL is
|
||||
as follows:
|
||||
|
||||
```
|
||||
conversation://<character>/<mood>[?reply]
|
||||
```
|
||||
|
||||
This will then fetch the images off of my CDN hosted by CloudFlare. However if
|
||||
you are using Tor to view my site, this may result in not being able to see the
|
||||
images. I am working on ways to solve this. Please bear with me, this stuff is
|
||||
hard.
|
||||
|
||||
You may have noticed that Mara sometimes has links inside her dialogue.
|
||||
Understandably, this is something that vanilla markdown does not support.
|
||||
However, I enabled putting raw HTML in my markdown which lets this work anyways!
|
||||
Consider this:
|
||||
|
||||
[My art was drawn by <a
|
||||
href="https://selic.re">Selicre</a>!](conversation://Mara/hacker)
|
||||
|
||||
In the markdown source, that actually looks like this:
|
||||
|
||||
```markdown
|
||||
[My art was drawn by <a href="https://selic.re">Selicre</a>!](conversation://Mara/hacker)
|
||||
```
|
||||
|
||||
This is honestly one of my favorite parts of how this is implemented, though
|
||||
others I have shown this to say it's kind of terrifying.
|
||||
|
||||
### The `<picture>` Element and Image Formats
|
||||
|
||||
Something you might notice about the HTML template is that I use the
|
||||
[`<picture>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/picture)
|
||||
element like this:
|
||||
|
||||
```html
|
||||
<picture>
|
||||
<source srcset="https://cdn.christine.website/file/christine-static/stickers/@character.to_lowercase()/@(mood).avif" type="image/avif">
|
||||
<source srcset="https://cdn.christine.website/file/christine-static/stickers/@character.to_lowercase()/@(mood).webp" type="image/webp">
|
||||
<img src="https://cdn.christine.website/file/christine-static/stickers/@character.to_lowercase()/@(mood).png" alt="@character is @mood">
|
||||
</picture>
|
||||
```
|
||||
|
||||
The `<picture>` element allows me to specify multiple versions of the stickers
|
||||
and have your browser pick the image format that it supports. It is also fully
|
||||
backwards compatible with browsers that do not support `<picture>` and in those
|
||||
cases you will see the fallback image in .png format. I went into a lot of
|
||||
detail about this in [a twitter
|
||||
thread](https://twitter.com/theprincessxena/status/1310358201842401281?s=21),
|
||||
but in short here are how each of the formats looks next to its filesize
|
||||
information:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
The
|
||||
[avif](https://reachlightspeed.com/blog/using-the-new-high-performance-avif-image-format-on-the-web-today/)
|
||||
version does have the ugliest quality when blown up, however consider how small
|
||||
these stickers will appear on the webpages:
|
||||
|
||||
[This is how big the stickers will appear, or is it?](conversation://Mara/hmm)
|
||||
|
||||
At these sizes most people will not notice any lingering artifacts unless they
|
||||
look closely. However at about 5-6 kilobytes per image I think the smaller
|
||||
filesize greatly wins out. This helps keep page loads fast, which is something I
|
||||
want to optimize for as it makes people think my website loads quickly.
|
||||
|
||||
I go into a lot more detail on the twitter thread, but the commands I use to get
|
||||
the webp and avif versions of the stickers are as follows:
|
||||
|
||||
```shell
|
||||
#!/bin/sh
|
||||
|
||||
cwebp \
|
||||
$1.png \
|
||||
-o $1.webp
|
||||
avifenc \
|
||||
$1.png \
|
||||
-o $1.avif \
|
||||
-s 0 \
|
||||
-d 8 \
|
||||
--min 48 \
|
||||
--max 48 \
|
||||
--minalpha 48 \
|
||||
--maxalpha 48
|
||||
```
|
||||
|
||||
I plan to automate this further in the future, but for the scale I am at this
|
||||
works fine. These stickers are then uploaded to my cloud storage bucket and
|
||||
CloudFlare provides a CDN for them so they can load very quickly.
|
||||
|
||||
---
|
||||
|
||||
Anyways, this is how Mara is implemented and some of the challenges that went
|
||||
into developing them as a feature (while leaving the door open for other
|
||||
characters in the future). Mara is here to stay and I have gotten a lot of
|
||||
positive feedback about her.
|
||||
|
||||
As a side note, for those of you that are not amused that I am choosing to have
|
||||
Mara (and consequentially furry art in general) as a site feature, I can only
|
||||
hope that you can learn to respect that as an independent blogger I am free to
|
||||
implement my blog (and the content that I am choosing to provide _FOR FREE_ even
|
||||
though I've gotten requests to make it paid content) as I see fit. Further
|
||||
complaints will only increase the amount of furry art in future posts.
|
||||
|
||||
Be well all.
|
||||
|
|
@ -7,6 +7,8 @@ tags:
|
|||
- email
|
||||
---
|
||||
|
||||
# How to Send Email with Nim
|
||||
|
||||
Nim offers an [smtp][nimsmtp] module, but it is a bit annoying to use out of the
|
||||
box. This blogpost hopes to be a mini-tutorial on the basics of how to use the
|
||||
smtp library and give developers best practices for handling outgoing email in
|
||||
|
|
|
|||
|
|
@ -1,83 +0,0 @@
|
|||
---
|
||||
title: "How to Handle Pedophiles in Communities"
|
||||
date: 2021-03-07
|
||||
tags:
|
||||
- cw
|
||||
- pedophilia
|
||||
---
|
||||
|
||||
<span style="color: #cc241d"><big><big><big>CONTENT WARNING</big></big></big></span>
|
||||
|
||||
This post is going to talk about people that try to target children for sexual favors. You are not required to read this. If you are prone to anxiety I absolutely cannot recommend reading this post. Dealing with the situations that lead me to write this post (and doing the research that has lead to learning how to do this) has caused me to lose a lot of sleep over the last month.
|
||||
|
||||
It is my hope that this post is NOT useful to readers. If it ever becomes useful I suggest crying a bit. Yes, seriously.
|
||||
|
||||
For better or worse since Covid started pushing everyone indoors and online, a lot of online spaces that were usually populated by adults have become populated with a lot more people that are under the age of consent/majority. This is obviously not the most ideal, as it ends up making that community a target for pedophiles. I want to be clear though, this kind of thing is a black swan kind of event, not something that happens commonly. However when it does happen, oh god it **HAPPENS**.
|
||||
|
||||
For the rest of this article I'm going to assume a few things in how I direct my advice:
|
||||
|
||||
- You are a moderator/administrator of a community
|
||||
- There has been an accusation of someone doing something untoward with a minor
|
||||
- You may or may not have any evidence (screenshots of DMs, etc.)
|
||||
|
||||
## Don't Panic
|
||||
|
||||
First, don't panic. This is going to be a stressful and scary thing. This is normal. You are feeling that feeling that you are feeling and it is happening. It is going to suck. You are going to lose sleep. This is something that is happening because you care about that community, and if you didn't care about it you would not be having these feelings. If you feel the need, cry about it. Let the emotions out instead of bottling them up. This sounds like a dumb meme or whatever but I am being dead serious in this recommendation.
|
||||
|
||||
So, now, one of the first things you need to do is review the terms and conditions of the platform you are moderating the community on.
|
||||
|
||||
If you are not on someone else's platform as you do this, you probably have access to **A LOT MORE INFORMATION** about the users involved than nearly everyone else in this kind of situation has access to. This is a boon and a curse, because then you get to be the one to report the pedophile to the FBI (or equivalent).
|
||||
|
||||
If you are on a platform such as Discord, Twitter or Telegram, review their help info for something along the lines of "Trust and Safety" or similar. Find out how to make a report and what information you need to gather.
|
||||
|
||||
If the accused is a moderator of the community, you are in a whole new level of shit. You probably need to start a group chat elsewhere to coordinate the following actions. This kind of thing can literally destroy communities or cause them to devolve into witch hunts if you are not careful.
|
||||
|
||||
## Research
|
||||
|
||||
Then you gather the information. Start breaking out search tools and look for instances of the two users talking with eachother in public. Look for the phrase "age is just a number" as well as any instances of the minor confirming their age around the other person. Get identifiers of those messages as well as screenshots. The screenshots will be useful if the accused person decides they want to remove their messages from the platform.
|
||||
|
||||
Look for instances of the accused person trying to talk with the minor on another platform, especially if it is a game that allows for in-game communication through voice, video or an avatar-based chat environment.
|
||||
|
||||
When you are getting evidence from the minor, make sure that the evidence is in full-screen screenshots as much as possible. Given the unfortunate prevalence of Electron-based desktop applications that leave the browser inspector enabled, you are going to want to prefer getting screenshots from mobile devices as much as you can. Mobile devices don't have the browser inspector. Android phones are easy to install a hacked version of apps on. iPhones or iPads are generally a bit more reliable because it goes from "very hard" to "nearly impossible" to directly edit the screen contents of a direct message on modern releases of iOS/iPadOS.
|
||||
|
||||
Once you have the information and have reviewed it, open [Gimp](https://www.gimp.org) and run the screenshots through the edge detection filter. This filter will allow you to look for any obvious signs of the text in the screenshot being doctored. Certain kinds of people have been known to fake reports and screenshots of someone doing something untoward to a child as a way to get them removed from a community. This will help you weed them out. It sounds heartless to say it like this, but this is something that you _actually do_ end up seeing happen sometimes so it is worth mentioning.
|
||||
|
||||
If anyone on the moderation team ends up leaking the information about this research, contents of the research, people involved in the event or anything of the sort to the person being investigated: flat-out ban them without any chance of appeal. That gives the person being investigated a chance to delete information that would hinder any hope of investigating the situation.
|
||||
|
||||
## Reporting to the Platform
|
||||
|
||||
Once you have the bundle of information, identifiers and more, then you need to open a ticket with the trust and safety team of the platform you are on (however if this is a self-hosted platform either contact the service administrator or if you are the service administrator then you can skip to the next step involving the FBI). Give them all the information you have. Explain the situation as best as you can.
|
||||
|
||||
When you send the report to the platform itself, it is _very unlikely_ you will get any more information from the platform. You are likely going to get an email that says they've confirmed recipt of the information and that email will usually contain something about the situation being confidential inside the moderation team of the platform. This is normal, and is part of a legal "covering my ass" kind of situation.
|
||||
|
||||
## Reporting to the FBI or Similar
|
||||
|
||||
Figure out what country the accused is in. This could be done by searching for them mentioning it outright in the chat (conveniently, this is usually the case), GeoIP data (if you have access to their IP addresses, assuming they aren't using a VPN service) or something like that. Figure out what the equivalent of the FBI is for that country.
|
||||
|
||||
Take all that information you built up for your report to the trust and safety team and submit a report to the equivalent of the FBI. Don't worry about it all being in another language, they have experts that will be able to understand it. You are going to have to include a phone number. You're probably going to be called. You may not get a confirmation email back immediately.
|
||||
|
||||
This will feel stressful. It will be okay. You are doing everything right.
|
||||
|
||||
## Banning the Pedophile
|
||||
|
||||
At this point, if you haven't already, ban the pedophile from the community. Ban them as completely as possible. Set the ban for a permanent duration. If you know of any alt accounts of the pedophile, ban them too.
|
||||
|
||||
For a bit after the ban, you may have the pedophile attempt to evade that ban by making new accounts. Ban them too (and include them in a followup report to the platform). It's gonna feel like a game of whac-a-mole, but it's whac-a-mole for a good cause.
|
||||
|
||||
## Reporting This to Users
|
||||
|
||||
It is going to be tempting to just sweep this under the rug and ignore it because the situation seems handled at this point. This is a bad idea. People are going to notice, especially if the user you just banned was a particularly active one.
|
||||
|
||||
Here is a good announcement template to use for this:
|
||||
|
||||
> Hello everyone,
|
||||
>
|
||||
> Recently it has come to our attention that a user was accused of engaging with a minor in a sexual manner. We have done an investigation and taken action in order to protect our community. If you are a minor and recieve any contact from anyone in a sexual manner, please contact a moderator so we can help resolve the situation.
|
||||
|
||||
Depending on the individual community in question, you may want to include the name of the person who was accused. Personally I lean towards the "let the scrollback claim this one" approach. Having this announcement is good enough as is.
|
||||
|
||||
---
|
||||
|
||||
Talk with your therapist, religious authority or similar about this. This is going to feel like a traumatic incident. You may want to let your workplace know that you are going through some shit as a result of this and that your performance is going to be impacted by it. You will prevail.
|
||||
|
||||
This post brought to you by 20 hours of lost sleep, and a bunch of stories I hope to never ever have to tell to anyone.
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue