README
¶
Name
lab - R&D Lab
Description
"I hear, and I forget; I see, and I remember; I do, and I understand" -- source
Lab is the place to tinker with ideas, learn by doing, and don't be shy of making mistakes. This is where we grow.
Projects
| Package | Status | Notes |
|---|---|---|
book/ |
 |
ideas from books |
check/ |
 |
pre-commit checks |
go/ |
 |
Go libraries |
iq/ |
 |
Interview Questions |
infra/ |
Infrastructure configuration & doc | |
x/ |
 |
experimental area |
C++ development
Run //:gazelle target to generate Bazel BUILD files:
% bazel run :gazelle
Use refresh_commands script to run :gazelle and capture compile_commands.json from Bazel build and update the links for FreeBSD jail installation (Ubuntu apt(1) installs LLVM under /usr, FreeBSD pkg(1) installs it under /usr/local ):
% ./refresh_commands
ibazel is configured to fix build errors, see .bazel_fix_commands.json:
% ibazel --run_output --run_output_interactive=false test //...
Directories
¶
| Path | Synopsis |
|---|---|
|
book
|
|
|
algos/c2/s4/cmd/multiway
command
Multiway merges multiples sorted files.
|
Multiway merges multiples sorted files. |
|
algos/c2/s4/cmd/topm
command
Topm finds top N transactions in the standard input.
|
Topm finds top N transactions in the standard input. |
|
ostep/cpu/cmd/process-run
command
|
|
|
ostep/cpu/cmd/sched
command
Scheduler implements basic CPU scheduler policies: first-in-first-out, shortest job run.
|
Scheduler implements basic CPU scheduler policies: first-in-first-out, shortest job run. |
|
ostep/cpu/cmd/sched/internal/job
Package job provides basic primitives describing jobs.
|
Package job provides basic primitives describing jobs. |
|
ostep/cpu/cmd/sched/internal/report
Package report generates simulation reports.
|
Package report generates simulation reports. |
|
ostep/cpu/cmd/sched/internal/sched
Package scheduler implements scheduling policies to select next job to run: First-in-First-Out, Shortest job first, Shortest Time to Complete First, etc.
|
Package scheduler implements scheduling policies to select next job to run: First-in-First-Out, Shortest job first, Shortest Time to Complete First, etc. |
|
ostep/cpu/cmd/sched/internal/sim
Package sim is responsible for drivin jobs scheduling sicmulation.
|
Package sim is responsible for drivin jobs scheduling sicmulation. |
|
ostep/cpu/cmd/sched/internal/trace
Package trace provides tracing facilities for scheduler simulations.
|
Package trace provides tracing facilities for scheduler simulations. |
|
check
|
|
|
cmd/check-go-test
command
Gotest runs `go test` on package for Go files.
|
Gotest runs `go test` on package for Go files. |
|
cmd/check-go-test/internal/check
Package test gives access to failed `go test` for Go file packages.
|
Package test gives access to failed `go test` for Go file packages. |
|
cmd/check-godoc
command
|
|
|
cmd/check-godoc/internal/check
Package check ensures that Go exported symbols and the package include documentation.
|
Package check ensures that Go exported symbols and the package include documentation. |
|
cmd/check-issue
command
Check-issue verifies that git commit message includes an issue.
|
Check-issue verifies that git commit message includes an issue. |
|
cmd/check-license
command
Check-copyright verifies that the file includes a copyright statement.
|
Check-copyright verifies that the file includes a copyright statement. |
|
cmd/check-license/internal/license
Package license provides checker and fixer for license pre-commit check.
|
Package license provides checker and fixer for license pre-commit check. |
|
cmd/check-nextid
command
Check-nextid verifies that a Protocol buffer definition has a next-id comment set to the next value to the maximum used field identifier.
|
Check-nextid verifies that a Protocol buffer definition has a next-id comment set to the next value to the maximum used field identifier. |
|
cmd/check-nextid/internal/nextid
Package nextid implements Protobuf checks for next-id comments.
|
Package nextid implements Protobuf checks for next-id comments. |
|
cmd/check-nosubmit
command
Check-nosubmit checks for presence of "DO NOT SUBMIT" comment.
|
Check-nosubmit checks for presence of "DO NOT SUBMIT" comment. |
|
cmd/check-nosubmit/internal/nosubmit
Package nosubmit checks files against presence of "DO NOT SUBMIT" comment.
|
Package nosubmit checks files against presence of "DO NOT SUBMIT" comment. |
|
cmd/check-pbdoc
command
Check-pbdoc verifies that every item in a Protobuf definition includes a documentation comment.
|
Check-pbdoc verifies that every item in a Protobuf definition includes a documentation comment. |
|
cmd/check-pbdoc/internal/check
Package check verifies that Protobuf declarations are documented.
|
Package check verifies that Protobuf declarations are documented. |
|
cmd/check-todo
command
Lint-todo validates todo-comments.
|
Lint-todo validates todo-comments. |
|
cmd/check-todo/internal/todo
Package todo validates todo-lines.
|
Package todo validates todo-lines. |
|
go
|
|
|
flags
Package flags implements auxiliary command-line flag types for flags package.
|
Package flags implements auxiliary command-line flag types for flags package. |
|
tests
Package tests implements auxiliary tools for testing package.
|
Package tests implements auxiliary tools for testing package. |
|
infra
|
|
|
cmd/alpine
command
Alpine fetches latest releases and prints a URL to ISO image for requested flavor, defaulted to "alpine-virt".
|
Alpine fetches latest releases and prints a URL to ISO image for requested flavor, defaulted to "alpine-virt". |
|
iq
|
|
|
cmd/iq
command
Iq gives access to the interview questions registry.
|
Iq gives access to the interview questions registry. |
|
cmd/iq/internal/registry
Package registry gives access to the interview questions.
|
Package registry gives access to the interview questions. |
|
x
|
|
|
ast
command
Ast pases a Go file and prints Abstract Syntax Tree.
|
Ast pases a Go file and prints Abstract Syntax Tree. |
|
ast/internal/proto
Package proto implements functions to print Protobuf AST.
|
Package proto implements functions to print Protobuf AST. |
|
balancer
command
|
|
|
compdb/cmd/compdb
command
Compdb generates a compilation database from a Bazel project.
|
Compdb generates a compilation database from a Bazel project. |
|
compdb/internal/bazel
Bazel provides integration points with Bazel build system such as running actions query.
|
Bazel provides integration points with Bazel build system such as running actions query. |
|
compdb/internal/compdb
Compdb generates LLVM compilation database for Bazel targets.
|
Compdb generates LLVM compilation database for Bazel targets. |
|
feed/cmd/feedreader
command
Feedreader implements an RSS, Atom, etc.
|
Feedreader implements an RSS, Atom, etc. |
|
feed/internal/feed
Package feed implements streaming interface to access RSS, Atom, etc.
|
Package feed implements streaming interface to access RSS, Atom, etc. |
|
feed/internal/pb
Package pb holds Protocol Buffers for the feed package.
|
Package pb holds Protocol Buffers for the feed package. |
|
fin/cmd/csv2pb
command
csv2pb converts Shiller market data from CSV to Protobuf format, https://shillerdata.com.
|
csv2pb converts Shiller market data from CSV to Protobuf format, https://shillerdata.com. |
|
fin/cmd/finsim
command
Finsim simulates financial market using Shiller data.
|
Finsim simulates financial market using Shiller data. |
|
fin/internal/csv
Package csv implements reading and parsing of Shiller data from CSV format into Protobuf representation.
|
Package csv implements reading and parsing of Shiller data from CSV format into Protobuf representation. |
|
fin/internal/fin
Package fin provides common units for market analysis.
|
Package fin provides common units for market analysis. |
|
fin/internal/pb
Package pb holds Protobuf schema for Shiller market data.
|
Package pb holds Protobuf schema for Shiller market data. |
|
fin/internal/report
Package report generates reports for simulated results.
|
Package report generates reports for simulated results. |
|
fin/internal/ror
Package ror calculates rates of return.
|
Package ror calculates rates of return. |
|
fin/internal/sim
Package sim runs financial simulation.
|
Package sim runs financial simulation. |
|
fin/internal/stat
Package stat holds statistical tools for financial simulation.
|
Package stat holds statistical tools for financial simulation. |
|
fin/internal/strategy
Package strategy implements different market strategies.
|
Package strategy implements different market strategies. |
|
fin/internal/tests
Package tests provides helpers for testing.
|
Package tests provides helpers for testing. |
|
freebsd/kqueue/kquser
command
User demonstrates kqueue(2) send and receive a user event.
|
User demonstrates kqueue(2) send and receive a user event. |
|
go/concurrency/balancer/roundrobin
command
Balancer demonstrates a round-robin work load balancer.
|
Balancer demonstrates a round-robin work load balancer. |
|
go/json
Package json collects demonstrations of various JSON techniques in Go.
|
Package json collects demonstrations of various JSON techniques in Go. |
|
mdview
command
Mdview runs a server to preview markdown files rotted at current working directory.
|
Mdview runs a server to preview markdown files rotted at current working directory. |
|
mdview/internal/mdview
Package mdview runs an HTTP server to serve markdown file at localhost:8080/.
|
Package mdview runs an HTTP server to serve markdown file at localhost:8080/. |
|
tools/cmd/urlescape
command
|
Click to show internal directories.
Click to hide internal directories.