Ari auser

Rust Engineering Best Practices

A complete project standard for writing correct, explicit, allocation-aware, production-grade Rust.

This document is intended to replace the previous rust-best-practices.md Gist in full. It integrates ownership, API design, error handling, testing, linting, performance, debug_assert!() usage, and heap-allocation discipline into one coherent set of rules.

Status and terminology

This is a normative engineering guide, not an introductory Rust tutorial.

Keybase proof

I hereby claim:

I am auser on github.
I am auser (https://keybase.io/auser) on keybase.
I have a public key ASAmUp6O5pKPPrq1HOrLDcA70zfA3gKBOo1NL-Oe3pGEvgo

To claim this, I am signing this object:

	# AgentZero task runner

	# Default recipe - show help
	default:
	@just --list

	# ── Docs ──────────────────────────────────────────

	# Install site dependencies
	docs-install:

	use async_trait::async_trait;
	use chrono::Local;
	use graph_flow::{
	Context, ExecutionStatus, FlowRunner, GraphBuilder, GraphStorage, InMemoryGraphStorage,
	InMemorySessionStorage, NextAction, Session, SessionStorage, Task, TaskResult,
	};
	use image::{ImageBuffer, Rgb};
	use minifb::{Key, Window, WindowOptions};
	use nokhwa::{
	pixel_format::RgbFormat,

	#!/usr/bin/env bash

	# untar the ova
	tar -xvf [path-to-ova]

	# Convert to qcow2
	qemu-img convert -O qcow2 jangow\ 01-disk001.vmdk jangow.qcow2

	# Create a new machine in UTM
	# Select emulated

	#!/usr/bin/env bash

	declare -A Colors=(
	[Color_Off]='\033[0m'
	[Black]='\033[0;30m'
	[Red]='\033[0;31m'
	[Green]='\033[0;32m'
	[Yellow]='\033[0;33m'
	[Blue]='\033[0;34m'
	[Purple]='\033[0;35m'

	#!/usr/bin/env bash

	# Default configuration
	IMAGE_NAME="auser/dev"

	# Color definitions
	declare -A Colors=(
	[Color_Off]='\033[0m'
	[Black]='\033[0;30m'
	[Red]='\033[0;31m'

	#!/usr/bin/env sh

	repos='bridge bridge-react chat cli coreth dao docs exchange explorer faucet finance gsn indexer lattice lpm luxjs marketplace multiparty netrunner netrunner-sdk node oraclevm plugins-core safe safe-ios sites standard subnet-evm town ui vault vmsdk wallet zchain'

	for r in $repos;
	do git clone git@github.com:luxdefi/$r
	done

	# /etc/systemd/system/vncserver@.service
	[Unit]
	Description=Manage VNC Server on this droplet
	After = syslog.target network.target

	[Service]
	Type=forking
	PidFile = /home/auser/.vnc/%H:%i.pid
	ExecPreStart=/usr/bin/tigervncserver -kill %i >/dev/null 2>&1
	ExecStart=/usr/bin/tigervncserver -depth 24 -geometry 1920x1080 -localhost %i

	<html>
	<head>
	<title>My Post Secret</title>
	</head>
	<body>
	<div id="app"></div>
	<form>
	<input type="text" name="name" />
	</form>
	</body>