tmux 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 225f31971e201d9baeeec68e3f920d8a72f727012a15e0617bb09d551a0af4a9
+  data.tar.gz: 103f4cbd898b274d9901e825c3eecb95fdd534d2178fe6a59428066e58448f59
+SHA512:
+  metadata.gz: 3006eeaaca5dbf9449c9c2f8081096cc4c172c1f2cb3b1933348409b4a9f231522749213e025f0a187e0ceccbb2eaf63a6905fca3f772d8f58682f6ab5034bbf
+  data.tar.gz: 316d61e9d40ae7c52f4352f350d38cb4f78c9b42c5bc047b2cab32d04ab66c4f1a646eeea52de19bee5b6f7111e29db325167381d5203410b5b617ef00228f8f

data/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+## 0.1.0 (unreleased)
+
+First public release, as the `tmux` gem (`require "tmux"`), with the
+`tmux.rb` command (also installed as `tmux_rb`).
+
+### Library
+
+- `Tmux.configure` and `Tmux.format` DSLs that compile to deterministic
+  tmux configuration and format strings. `Tmux.load_file` evaluates a
+  configuration file in its own anonymous module.
+- `text` with interpolated expressions kept dynamic and everything else
+  literal (escaping `#`, and `%` once per conditional nesting level), plus
+  `strftime`, `append`, and `#(...)` `command` content, each with its own
+  escaping, verified by rendering in real tmux servers.
+- Expressions: `!`, string `==`/`!=`, numeric `>`, `<`, `>=`,
+  `<=`, `matches`, and `substitute`. Booleans and other non-expression values
+  raise instead of compiling silently.
+- Automatic `&&` / `||` capture in `if?` / `.elsif?` conditions and inline
+  `switch` / `switch_style` keys in files compiled by the CLI or `Tmux.load_file`.
+  The private source compiler uses Prism; no public `condition` helper or
+  expression `&` / `|` operators are needed.
+- Runtime selection with `Tmux.switch` and `switch_style`, Powerline helpers
+  (`left_flag`, `right_segment`, `chip`, ...), and `Tmux.pane_border` zones.
+- Complete target-specific option discovery from the selected tmux executable
+  (`--tmux PATH` or `tmux:` in Ruby). Scoped setters validate built-in names,
+  scopes, and array indices; inactive version branches are excluded. Custom
+  options use scoped brackets such as `global[:@plugin]`. Generic option-setting
+  helpers are removed. Loading refuses a mismatched server version.
+- Option names grouped by tmux's own scopes (`global`, `window`,
+  `server`), key-binding command blocks and menus, configuration
+  `if?`/`.elsif?`/`.else` chains with tmux expressions or deferred `shell(...)`
+  exit-status checks (including background checks), compiled to `{ }` command
+  blocks, and `tmux_from`/`tmux_below` compiled to `%if` checks
+  on the running server's version. Generated configurations need tmux 3.2+;
+  CI tests every release from 3.2 to 3.8 and tmux's development branch.
+- Nested blocks keep helper methods and instance variables in scope; a block
+  may also take its builder as a parameter.
+
+### CLI
+
+- `tmux.rb build`, `check`, `diff`, and `load` (with `-S`/`-L` to choose the
+  server), plus `--version` and per-command `--help`.
+- `build --output` writes atomically, follows a symlinked destination, and
+  keeps an existing file's permissions.
+- Errors raised by a configuration name the file and line that raised them.
+
+### Examples
+
+- `examples/author_config.rb`, a complete real-world configuration with
+  pinned output and tmux-rendered window-tab tests.
+- Ten ports of popular public tmux configurations, checked for equivalence
+  against their upstream originals in isolated tmux servers on every tested
+  tmux version.
+
+### Development
+
+- `rake test:tmux` and a CI job build tmux 3.2a through 3.8 and the
+  development branch from source and run the suite against each.

data/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Nick deLannoy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+