I am Tony Narlock#

This is my professional website, I’ve been a software developer for 15 years. If you’re not one, what I do likely won’t make sense to you.

I work at tech startups building web-based apps. I use React, TypeScript, and Relay (GraphQL) on the frontend and Python / Amazon Web Services on the backend.

In my spare time I plan, develop, and maintain a fleet of developer tools. For example, tmuxp constructs tmux sessions from a JSON or YAML file. To that end, I’ve also written a book about tmux a few years ago, The Tao of tmux. Another tool I’ve created is cihai, which is built around Unicode’s UNIHAN dataset for Chinese, Japanese, and Korean languages.

I contribute to open source software projects; find me on GitHub, GitLab, OpenHub.

My CV tracks everything I’ve ever done - work, my projects, and open source (I’m a polyglot, there is some C++ in there).

What’s going on in my life as a programmer#

What am I busy with outside of work?

May 2023 - cihai is being revamped

After 5+ years of inactivity, the suite of packages is being dusted off.

cihai 0.20.0 adds mypy --strict compliant typings

In the future, cihai will have:
- SQLAlchemy updated to 1.4, then 2.0+.
- its API simplified - ensuring all usages will be typed and have awesome completions.
December 2022 - I’m not giving up being successful

In 2023:
- Snappable, expressive configurations will enliven tmuxp and vcspull
  
  Dataclasses will resemble the structure of the:
  - libtmux: tmux session, and
  - libvcs: the file paths of the user’s repository checkouts
- My oldest library - libtmux - will be renewed with dataclasses, documentation, and improve tests
September 2022 - One more thing on doctest

I wrote a doctest module that can parse reStructuredText and markdown:

Doctest w/ docutils

It also has a pytest plugin

On that note, I also made a pytest plugin for libtmux and libvcs:
- tmux pytest plugin - bootstrap tmux sessions in your tests
- libvcs pytest plugin - setup and teardown git, mercurial and subversion repos in your tests.
Mid August 2022 - Promises keep coming

Additionally, test and quality infrastructure has been improved across all projects:
- libtmux now has comprehensive typings (--strict mypy compliance) as of 0.13.0
- All projects except vcspull now have basic mypy and doctest support.
Early August 2022 - Promises kept (and keep coming)

libvcs 0.14.0 released w/ typing annotations and doctests.

Also, added a URL Parser (compare to urlparse) for git, hg, and svn URLs. Extensible using framework tools. Built on dataclasses and uses doctest.

In the process, “side inventions” (License MIT):
- QueryList: Nested searching of dict-like data.
- SubprocessCommand: Deferrable subprocess commands.
- SkipDefaultFieldsReprMixin: Exclude default fields (useful for clearer pytest assertions / printing). Thanks Pietro Oldrati.
June 2022
- libvcs and vcspull are being rebuilt from the ground up. This will be a fresh take on one of my earliest python projects. What they’ll be using:
  - doctest: actual code demo in documentation which also function as tests
  - mypy: type checking through annotations (PEP 484, PEP 526)
  - dataclasses (experimental): As a library creator, I will put these to the test
  The projects will be a proving ground for quality standards and patterns I’ll adopt across my other and future packages.
March 2022
- All sites moved to new design.
June 2021
- tmux-python (tmuxp + libtmux), vcs-python (vcspull + libvcs), cihai (cihai, cihai-cli, unihan-etl, unihan-db) moved to markdown
April 2021
- Created @social-embed web component / library in TypeScript + LitElement: Homepage, GitHub
Feb 2021
- Experimenting with new CV: cv-react-v2.git-pull.com

Publications#

The Tao of tmux

Available on Leanpub and Kindle (Amazon). Read the book for free on the web.

Language Projects#

cihai

United front for creating open, permissive, standardized CJK datasets.

HSK FlashCards

Study chinese flashcards for Hànyǔ Shuǐpíng Kǎoshì, (New) Practical Chinese Reader and Integrated Chinese

Unix-like Utilities#

tmuxp (中文)

tmux session manager via JSON and YAML file

libtmux

pilot tmux with python

vcspull

manage and update multiple git / hg / svn projects via JSON or YAML file

libvcs

pythonic API for version control systems

Coding around the web#

My ports for the FreeBSD operating system on portscout
My issues for FreeBSD in Bugzilla
Software porting from Linux to BSD on my FreeBSD Wiki Page
Unofficial tally / roster of open source contributions on OpenHub
GitHub @tony for recent / current coding

Porting (Linux-to-BSD)#

Elementary Algorithms – Book of Elementary Algorithms and Data structures #16
pymux – tmux(1) clone in python #34
aseprite – Cross-platform sprite / pixel art editor #888 #893
tmux-mem-cpu-load memory, CPU and load averages for tmux status lines #30
uMario_Jakowski – Super Mario NES clone in SDL2 and C++. Add CMake and get building on FreeBSD and OS X #1
spdlog - C++11 logger #254
python-cmake-buildsystem - CMake buildsystem for CPython #133 #136
nanogui - C++11 gui library for opengl #128 #147
pyston - An open-source Python implementation using JIT techniques #1072, #1073, #1085
libpypa - Python parser implemented in pure C++ #50