bonchi 0.2.0.rc1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c8bcf10affa988d4bff6b9d78fd53ea1be600a9c03e93bf95f083fadd210e3e6
-  data.tar.gz: 40a744831b24891e328d4dbc400a4da030a98680279e06cd55ab77b0306d5375
+  metadata.gz: f726dfa32881aaae2a225b30e26b3a31fe3bfa2714709a33738910c4a42d2daf
+  data.tar.gz: 4ef9df6de06aecfc41d5bf69fe651114123bccb48b0fb9cc67ed8c26f1ab6bcb
 SHA512:
-  metadata.gz: 511dfe169d347f644e9f5c24db3a03ba3faba965ceda23848d06295b58bca16c7de3020164febd7cc2611f26878d421663a709d599edede7a71dc164e8ae891a
-  data.tar.gz: 26f08d5c1e6725088ba9d2268a7ef0fe0daa604351c63afd4a44dd45208f21c68fce9270b8dbbabd104313b950f776de700e8b1a07eececa14d0007676260704
+  metadata.gz: 5388c61deec0daf249af8c2033772bf9c2b22d51a894b6cfb75f887d65d14c1bdf298d7e96d6c7513717b0d0676fcb0f5f5a7bf518227be3b380487afd8774f3
+  data.tar.gz: 919fe02691d9f5b4c7ca3c2ac31c8cb365b6bb9533ac56470d2803d972881f3375ee3b72a64ecbb4e983e29898629d331f451808ee20b56e418df7d4ab91a671

data/lib/bonchi/cli.rb

@@ -14,6 +14,13 @@ module Bonchi
     map "-v" => :version
 
     desc "create BRANCH [BASE]", "Create new branch + worktree"
+    long_desc <<~DESC
+      Create a new branch and worktree. BASE defaults to the repository's default branch
+      (e.g. main). If a worktree for BRANCH already exists, switches to it instead.
+
+      When a .worktree.yml exists in the main worktree, setup runs automatically
+      (copy files, allocate ports, run pre_setup and setup commands). Skip with --no-setup.
+    DESC
     option :setup, type: :boolean, default: true, desc: "Run setup after creating worktree"
     def create(branch, base = nil)
       base ||= Git.default_base_branch
@@ -38,6 +45,13 @@ module Bonchi
     end
 
     desc "switch BRANCH", "Switch to existing branch in worktree"
+    long_desc <<~DESC
+      Create a worktree for an existing branch and cd into it.
+      If a worktree for BRANCH already exists, switches to it instead.
+
+      The branch must already exist locally or on the remote.
+      To create a new branch, use `bonchi create` instead.
+    DESC
     def switch(branch)
       existing = Git.worktree_path_for(branch)
       if existing
@@ -58,6 +72,13 @@ module Bonchi
     end
 
     desc "pr NUMBER_OR_URL", "Checkout GitHub PR in worktree"
+    long_desc <<~DESC
+      Fetch a GitHub pull request and check it out in a new worktree.
+      Accepts a PR number (e.g. 123) or a full GitHub PR URL.
+
+      The worktree branch will be named pr-<number>.
+      If the worktree already exists, switches to it instead.
+    DESC
     def pr(input)
       pr_number = extract_pr_number(input)
       branch = "pr-#{pr_number}"
@@ -77,6 +98,22 @@ module Bonchi
       signal_cd(path)
     end
 
+    desc "init", "Generate a .worktree.yml in the current project"
+    long_desc <<~DESC
+      Generate a .worktree.yml config file in the current directory with
+      sensible defaults. Edit the file to customize which files to copy,
+      which ports to allocate, and what setup command to run.
+    DESC
+    def init
+      path = File.join(Dir.pwd, ".worktree.yml")
+      if File.exist?(path)
+        abort "Error: .worktree.yml already exists"
+      end
+
+      File.write(path, WORKTREE_YML_TEMPLATE)
+      puts "Created #{path}"
+    end
+
     desc "setup [-- ARGS...]", "Run setup in current worktree (ports, copy, pre_setup, setup cmd)"
     def setup(*args)
       Setup.new.run(args)
@@ -88,6 +125,12 @@ module Bonchi
     end
 
     desc "remove BRANCH", "Remove a worktree"
+    long_desc <<~DESC
+      Remove a worktree and its directory. Refuses to remove worktrees
+      with uncommitted changes or untracked files (use `git worktree remove --force` to override).
+
+      Aliases: rm
+    DESC
     def remove(branch)
       path = Git.worktree_path_for(branch)
       abort "Error: No worktree found for branch: #{branch}" unless path
@@ -97,6 +140,13 @@ module Bonchi
     end
 
     desc "prune", "Prune stale worktree admin files"
+    long_desc <<~DESC
+      Clean up stale worktree tracking data. Git internally tracks worktrees in
+      .git/worktrees/. When a worktree directory is deleted manually (e.g. rm -rf)
+      instead of via `bonchi remove`, the tracking data becomes stale.
+
+      This runs `git worktree prune` to remove those orphaned entries.
+    DESC
     def prune
       Git.worktree_prune
       puts "Pruned stale worktree administrative files"
@@ -133,6 +183,23 @@ module Bonchi
       end
     end
 
+    WORKTREE_YML_TEMPLATE = <<~'YAML'
+      # Files to copy from the main worktree before setup.
+      # copy:
+      #   - .env.local
+
+      # Env var names to allocate unique ports for (from global pool).
+      # ports:
+      #   - PORT
+
+      # Commands to run before the setup command (port env vars are available).
+      # pre_setup:
+      #   - sed -i '' "s|^PORT=.*|PORT=$PORT|" .env.local
+
+      # The setup command to run (default: bin/setup).
+      setup: bin/setup
+    YAML
+
     SHELL_ENV = <<~'SHELL'
       bonchi() {
           local bonchi_cd_file="${TMPDIR:-/tmp}/bonchi_cd.$$"

data/lib/bonchi/version.rb

@@ -1,3 +1,3 @@
 module Bonchi
-  VERSION = "0.2.0.rc1"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bonchi
 version: !ruby/object:Gem::Version
-  version: 0.2.0.rc1
+  version: 0.2.0
 platform: ruby
 authors:
 - Gert Goet