tmuxinator 3.3.5 → 3.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e954effc3cf016798540aa6c25ddf5465797a6653fb9400616d288892bde9c9c
-  data.tar.gz: b501066e62a1cb5b46d286e86bfc866ebeefbbadf157e588a4934dbdd41eb7d4
+  metadata.gz: 1674129e2d3d0001468bb6ab7e8b304d758d8b1f41fd109f8373de858858e0bc
+  data.tar.gz: f2c815caabc1a64161cb0afad01d6347c51826af3882f2ec26661ba48340bf3e
 SHA512:
-  metadata.gz: e29c29f221505b683afb040e11b9e771a3a6b4526e5f716c8c52fe06c27dc642577c6e1f02ff2ead907bcac72ce81b778e65c9763b1adfc0b5d3d4c621b5caad
-  data.tar.gz: 4429eb7736ef16c2d78acb2a70c27df6843bd7dcb1d6abef1940e7852735436e6d8d709e5ac8b6de5041968232cd062b727a03dd3f92af9eb31ba7944677c33d
+  metadata.gz: b8959a219874dc1bf4717880a83e529601fb5641327c70b89736cef1192328394df9320167d922540b71b96a1d31d7034e473ed4d61fdabd2a36dbd12b6f4407
+  data.tar.gz: 5ed4a6024b65078227ee4bcabe33042f9e26bc612daf27e81dbdbf77188ad1ba3d0817e8da3655e1dfb303b334f46507cf82f087e0cd4216176ef8292f71cad9

data/lib/tmuxinator/cli.rb

@@ -23,6 +23,7 @@ module Tmuxinator
       delete: "Deletes given project",
       doctor: "Look for problems in your configuration",
       edit: "Alias of new",
+      help: "Shows help for a specific command",
       implode: "Deletes all tmuxinator projects",
       local: "Start a tmux session using ./.tmuxinator.y[a]ml",
       list: "Lists all tmuxinator projects",
@@ -83,8 +84,16 @@ module Tmuxinator
     method_option :local, type: :boolean,
                           aliases: ["-l"],
                           desc: "Create local project file at ./.tmuxinator.yml"
+    method_option :help, type: :boolean,
+                         aliases: ["-h"],
+                         desc: "Display usage information"
+
+    def new(name = nil, session = nil)
+      if options[:help] || name.nil?
+        invoke :help, ["new"]
+        return
+      end
 
-    def new(name, session = nil)
       if session
         new_project_with_session(name, session)
       else
@@ -259,7 +268,15 @@ module Tmuxinator
                                  "the current session"
     method_option "no-pre-window", type: :boolean, default: false,
                                    desc: "Skip pre_window commands"
+    method_option :help, type: :boolean,
+                         aliases: "-h",
+                         desc: "Display usage information"
     def start(name = nil, *args)
+      if options[:help]
+        invoke :help, ["start"]
+        return
+      end
+
       params = start_params(name, *args)
 
       show_version_warning if version_warning?(
@@ -276,8 +293,16 @@ module Tmuxinator
                                     desc: "Path to project config file"
     method_option "suppress-tmux-version-warning",
                   desc: "Don't show a warning for unsupported tmux versions"
+    method_option :help, type: :boolean,
+                         aliases: "-h",
+                         desc: "Display usage information"
 
     def stop(name = nil)
+      if options[:help]
+        invoke :help, ["stop"]
+        return
+      end
+
       # project-config takes precedence over a named project in the case that
       # both are provided.
       if options["project-config"]
@@ -342,7 +367,15 @@ module Tmuxinator
                                  "the current session"
     method_option "no-pre-window", type: :boolean, default: false,
                                    desc: "Skip pre_window commands"
+    method_option :help, type: :boolean,
+                         aliases: "-h",
+                         desc: "Display usage information"
     def debug(name = nil, *args)
+      if options[:help]
+        invoke :help, ["debug"]
+        return
+      end
+
       params = start_params(name, *args)
 
       project = create_project(params)
@@ -353,8 +386,16 @@ module Tmuxinator
     desc "copy [EXISTING] [NEW]", COMMANDS[:copy]
     map "c" => :copy
     map "cp" => :copy
+    method_option :help, type: :boolean,
+                         aliases: "-h",
+                         desc: "Display usage information"
+
+    def copy(existing = nil, new = nil)
+      if options[:help] || existing.nil? || new.nil?
+        invoke :help, ["copy"]
+        return
+      end
 
-    def copy(existing, new)
       existing_config_path = Tmuxinator::Config.project(existing)
       new_config_path = Tmuxinator::Config.project(new)
 
@@ -374,18 +415,32 @@ module Tmuxinator
     desc "delete [PROJECT1] [PROJECT2] ...", COMMANDS[:delete]
     map "d" => :delete
     map "rm" => :delete
+    method_option :help, type: :boolean,
+                         aliases: "-h",
+                         desc: "Display usage information"
 
     def delete(*projects)
-      projects.each do |project|
-        if Tmuxinator::Config.exist?(name: project)
-          config = Tmuxinator::Config.project(project)
+      if options[:help] || projects.empty?
+        invoke :help, ["delete"]
+        return
+      end
+
+      delete_projects(*projects)
+    end
 
-          if yes?("Are you sure you want to delete #{project}?(y/n)", :red)
-            FileUtils.rm(config)
-            say "Deleted #{project}"
+    no_commands do
+      def delete_projects(*projects)
+        projects.each do |project|
+          if Tmuxinator::Config.exist?(name: project)
+            config = Tmuxinator::Config.project(project)
+
+            if yes?("Are you sure you want to delete #{project}?(y/n)", :red)
+              FileUtils.rm(config)
+              say "Deleted #{project}"
+            end
+          else
+            say "#{project} does not exist!"
           end
-        else
-          say "#{project} does not exist!"
         end
       end
     end
@@ -411,8 +466,16 @@ module Tmuxinator
     method_option :active, type: :boolean,
                            aliases: ["-a"],
                            desc: "Filter output by active project sessions."
+    method_option :help, type: :boolean,
+                         aliases: ["-h"],
+                         desc: "Display usage information"
 
     def list
+      if options[:help]
+        invoke :help, ["list"]
+        return
+      end
+
       say "tmuxinator projects:"
       configs = Tmuxinator::Config.configs(active: options[:active])
       if options[:newline]

data/lib/tmuxinator/tmux_version.rb

@@ -3,6 +3,7 @@
 module Tmuxinator
   module TmuxVersion
     SUPPORTED_TMUX_VERSIONS = [
+      3.6,
       "3.5a",
       3.5,
       3.4,

data/lib/tmuxinator/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tmuxinator
-  VERSION = "3.3.5"
+  VERSION = "3.3.6"
 end

data/spec/lib/tmuxinator/cli_spec.rb

@@ -206,6 +206,7 @@ describe Tmuxinator::Cli do
         delete
         doctor
         edit
+        help
         implode
         local
         list
@@ -297,6 +298,24 @@ describe Tmuxinator::Cli do
       end
     end
 
+    context "with --help flag" do
+      it "shows help instead of starting project" do
+        ARGV.replace(["start", "--help"])
+        expect(Kernel).not_to receive(:exec)
+        out, _err = capture_io { cli.start }
+        expect(out).to include("start [PROJECT] [ARGS]")
+        expect(out).to include("Options:")
+      end
+
+      it "shows help with -h flag" do
+        ARGV.replace(["start", "-h"])
+        expect(Kernel).not_to receive(:exec)
+        out, _err = capture_io { cli.start }
+        expect(out).to include("start [PROJECT] [ARGS]")
+        expect(out).to include("Options:")
+      end
+    end
+
     context "deprecations" do
       before do
         allow($stdin).to receive_messages(getc: "y")
@@ -340,6 +359,16 @@ describe Tmuxinator::Cli do
       end
     end
 
+    context "with --help flag" do
+      it "shows help instead of stopping project" do
+        ARGV.replace(["stop", "--help"])
+        expect(Kernel).not_to receive(:exec)
+        out, _err = capture_io { cli.start }
+        expect(out).to include("stop [PROJECT]")
+        expect(out).to include("Options:")
+      end
+    end
+
     include_examples :unsupported_version_message, :stop, :foo
   end
 
@@ -526,6 +555,15 @@ describe Tmuxinator::Cli do
       allow(File).to receive(:open) { |&block| block.yield file }
     end
 
+    context "with --help flag" do
+      it "shows help instead of creating project" do
+        ARGV.replace(["new", "--help"])
+        out, _err = capture_io { cli.start }
+        expect(out).to include("new [PROJECT]")
+        expect(out).to include("Options:")
+      end
+    end
+
     context "without the --local option" do
       before do
         ARGV.replace(["new", name])
@@ -651,6 +689,31 @@ describe Tmuxinator::Cli do
       allow(Tmuxinator::Config).to receive(:exist?) { true }
     end
 
+    context "with --help flag" do
+      it "shows help instead of copying project" do
+        ARGV.replace(["copy", "--help"])
+        expect(FileUtils).not_to receive(:copy_file)
+        out, _err = capture_io { cli.start }
+        expect(out).to include("copy [EXISTING] [NEW]")
+        expect(out).to include("Options:")
+      end
+
+      it "shows help with -h flag" do
+        ARGV.replace(["copy", "-h"])
+        expect(FileUtils).not_to receive(:copy_file)
+        out, _err = capture_io { cli.start }
+        expect(out).to include("copy [EXISTING] [NEW]")
+        expect(out).to include("Options:")
+      end
+
+      it "shows help when only one argument provided" do
+        ARGV.replace(["copy", "foo"])
+        expect(FileUtils).not_to receive(:copy_file)
+        out, _err = capture_io { cli.start }
+        expect(out).to include("copy [EXISTING] [NEW]")
+      end
+    end
+
     context "new project already exists" do
       before do
         allow(Thor::LineEditor).to receive_messages(readline: "y")
@@ -732,6 +795,31 @@ describe Tmuxinator::Cli do
   end
 
   describe "#delete" do
+    context "with --help flag" do
+      it "shows help instead of deleting project" do
+        ARGV.replace(["delete", "--help"])
+        expect(FileUtils).not_to receive(:rm)
+        out, _err = capture_io { cli.start }
+        expect(out).to include("delete [PROJECT1] [PROJECT2]")
+        expect(out).to include("Options:")
+      end
+
+      it "shows help with -h flag" do
+        ARGV.replace(["delete", "-h"])
+        expect(FileUtils).not_to receive(:rm)
+        out, _err = capture_io { cli.start }
+        expect(out).to include("delete [PROJECT1] [PROJECT2]")
+        expect(out).to include("Options:")
+      end
+
+      it "shows help when no arguments provided" do
+        ARGV.replace(["delete"])
+        expect(FileUtils).not_to receive(:rm)
+        out, _err = capture_io { cli.start }
+        expect(out).to include("delete [PROJECT1] [PROJECT2]")
+      end
+    end
+
     context "with a single argument" do
       before do
         ARGV.replace(["delete", "foo"])

data/spec/lib/tmuxinator/config_spec.rb

@@ -203,6 +203,7 @@ describe Tmuxinator::Config do
       "!@#^%" => 0.0,
       "2.9ä" => 2.9,
       "v3.5" => 3.5,
+      "v3.6" => 3.6,
       "v3.12.0" => 3.12,
       "v3.12.5" => 3.12
     }.freeze

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tmuxinator
 version: !ruby/object:Gem::Version
-  version: 3.3.5
+  version: 3.3.6
 platform: ruby
 authors:
 - Allen Bargi
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-02 00:00:00.000000000 Z
+date: 2025-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: erubi