tmuxinator 3.1.2 → 3.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8504ca7800e02e8b5482f803b30ba5238cf5c4fc1bb48c63cf138bb285121156
-  data.tar.gz: 572802d765b16507d33adffc8156da4e51d17d019c7fa8ace9fd5e0405010e4d
+  metadata.gz: 837a353050a6ac064ea463e3e33113a845a1b555a9069c2514045b59440a634b
+  data.tar.gz: '008ef11a9c0734010632d58c06ea63f9ebc1d46eba0cfb4153c1dc63b1c7b6bc'
 SHA512:
-  metadata.gz: 03071e9633bd650640876315252a6b4e8993709cc04409cf8fd78bfba015c804f17bd800ada0501302616341025ca6655c27e99cb75a22051e7376c330f55031
-  data.tar.gz: e32877dfef9c3ab5106a4e2e1292e0fcfabb9b96e32bf5d54be7d982e0d35e5fdc7960f5a9f366447e154cb75a1c9628b38c1ed7b487a8e4e6b63e4241099819
+  metadata.gz: 81c8a46ec5380f78d7db741ee707d69e25ac5d6edb56892e861ebfe06131d1c7d2725f6ce4e8880192564e761ff4e2a4de50087b01addfa0d3a6305df444c4f1
+  data.tar.gz: 39c755d7aa5c61ff52b225ab1a2a3f5f7eef68c58cfefcd421c217f350e304b2b3f920df61af349d004e7cc53eff61d69e84afd9179fd113a4ca86dda185f039

data/bin/tmuxinator

@@ -1,5 +1,7 @@
 #!/usr/bin/env ruby
-$:.unshift File.expand_path("../../lib/", __FILE__)
+# frozen_string_literal: true
+
+$:.unshift File.expand_path("../lib", __dir__)
 
 require "thor"
 require "tmuxinator"

data/completion/tmuxinator.bash

@@ -19,5 +19,4 @@ _tmuxinator() {
     fi
 }
 
-complete -F _tmuxinator tmuxinator mux
-alias mux="tmuxinator"
+complete -F _tmuxinator tmuxinator

data/completion/tmuxinator.fish

@@ -20,5 +20,3 @@ complete -f -c $__fish_tmuxinator_program_cmd -n '__fish_tmuxinator_using_comman
 complete -f -c $__fish_tmuxinator_program_cmd -n '__fish_tmuxinator_using_command open'      -a "(__fish_tmuxinator_program completions open)"
 complete -f -c $__fish_tmuxinator_program_cmd -n '__fish_tmuxinator_using_command copy'      -a "(__fish_tmuxinator_program completions copy)"
 complete -f -c $__fish_tmuxinator_program_cmd -n '__fish_tmuxinator_using_command delete'    -a "(__fish_tmuxinator_program completions delete)"
-
-abbr --add mux "tmuxinator"

data/lib/tmuxinator/assets/template.erb

@@ -21,9 +21,15 @@ cd <%= root || "." %>
 
   # Create the session and the first window. Manually switch to root
   # directory if required to support tmux < 1.9
-  TMUX= <%= tmux_new_session_command %>
   <% if windows.first.root? %>
+    <% if Tmuxinator::Config.version < 1.9 %>
+  TMUX= <%= tmux_new_session_command %>
   <%= windows.first.tmux_window_command_prefix %> <%= "cd #{windows.first.root}".shellescape %> C-m
+    <%- else -%>
+  TMUX= <%= tmux_new_session_command %> -c <%= windows.first.root.shellescape %>
+    <% end %>
+  <%- else -%>
+  TMUX= <%= tmux_new_session_command %>
   <% end %>
 
   <% if Tmuxinator::Config.version < 1.7 %>
@@ -33,6 +39,15 @@ cd <%= root || "." %>
     <% end %>
   <% end %>
 
+  <% if enable_pane_titles? %>
+    <% if Tmuxinator::Config.version < 2.6 %>
+  <%= pane_titles_not_supported_warning %>
+    <% end %>
+    <% if pane_title_position? && !pane_title_position_valid? %>
+  <%= pane_title_position_not_valid_warning %>
+    <% end %>
+  <% end %>
+
   # Create other windows.
   <% windows.drop(1).each do |window| %>
   <%= window.tmux_new_window_command %>
@@ -44,6 +59,12 @@ cd <%= root || "." %>
     <% if window.synchronize_before? %>
   <%= window.tmux_synchronize_panes %>
     <% end %>
+
+    <% if enable_pane_titles? && Tmuxinator::Config.version >= 2.6 %>
+  <%= tmux_set_pane_title_position(window.tmux_window_target) %>
+  <%= tmux_set_pane_title_format(window.tmux_window_target) %>
+    <% end %>
+
     <% unless window.panes? %>
       <% if window.project.pre_window %>
   <%= window.tmux_pre_window_command %>

data/lib/tmuxinator/cli.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "open3"
 
 module Tmuxinator
@@ -167,9 +169,8 @@ module Tmuxinator
       end
 
       def generate_project_file(name, path)
-        template = Tmuxinator::Config.default? ? :default : :sample
-        content = File.read(Tmuxinator::Config.send(template.to_sym))
-        erb = Erubis::Eruby.new(content).result(binding)
+        config = Tmuxinator::Config.default_or_sample
+        erb = Tmuxinator::Project.render_template(config, binding)
         File.open(path, "w") { |f| f.write(erb) }
         path
       end
@@ -194,7 +195,7 @@ module Tmuxinator
 
         begin
           Tmuxinator::Config.validate(options)
-        rescue => e
+        rescue StandardError => e
           exit! e.message
         end
       end
@@ -341,12 +342,12 @@ module Tmuxinator
       new_config_path = Tmuxinator::Config.project(new)
 
       exit!("Project #{existing} doesn't exist!") \
-        unless Tmuxinator::Config.exists?(name: existing)
+        unless Tmuxinator::Config.exist?(name: existing)
 
-      new_exists = Tmuxinator::Config.exists?(name: new)
+      new_exists = Tmuxinator::Config.exist?(name: new)
       question = "#{new} already exists, would you like to overwrite it?"
       if !new_exists || yes?(question, :red)
-        say "Overwriting #{new}" if Tmuxinator::Config.exists?(name: new)
+        say "Overwriting #{new}" if Tmuxinator::Config.exist?(name: new)
         FileUtils.copy_file(existing_config_path, new_config_path)
       end
 
@@ -359,7 +360,7 @@ module Tmuxinator
 
     def delete(*projects)
       projects.each do |project|
-        if Tmuxinator::Config.exists?(name: 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)
@@ -433,7 +434,7 @@ module Tmuxinator
       if args.empty? && Tmuxinator::Config.local?
         Tmuxinator::Cli.new.local
       elsif name && !Tmuxinator::Cli::RESERVED_COMMANDS.include?(name) &&
-            Tmuxinator::Config.exists?(name: name)
+            Tmuxinator::Config.exist?(name: name)
         Tmuxinator::Cli.new.start(name, *args.drop(1))
       else
         Tmuxinator::Cli.start(args)

data/lib/tmuxinator/config.rb

@@ -1,9 +1,10 @@
+# frozen_string_literal: true
+
 module Tmuxinator
   class Config
     LOCAL_DEFAULTS = ["./.tmuxinator.yml", "./.tmuxinator.yaml"].freeze
-    NO_LOCAL_FILE_MSG =
-      "Project file at ./.tmuxinator.yml doesn't exist.".freeze
-    NO_PROJECT_FOUND_MSG = "Project could not be found.".freeze
+    NO_LOCAL_FILE_MSG = "Project file at ./.tmuxinator.yml doesn't exist."
+    NO_PROJECT_FOUND_MSG = "Project could not be found."
     TMUX_MASTER_VERSION = Float::INFINITY
 
     class << self
@@ -12,6 +13,7 @@ module Tmuxinator
         return environment if environment?
         return xdg if xdg?
         return home if home?
+
         # No project directory specified or existent, default to XDG:
         FileUtils::mkdir_p(xdg)
         xdg
@@ -40,6 +42,7 @@ module Tmuxinator
       def environment
         environment = ENV["TMUXINATOR_CONFIG"]
         return "" if environment.to_s.empty? # variable is unset (nil) or blank
+
         FileUtils::mkdir_p(environment) unless File.directory?(environment)
         environment
       end
@@ -48,6 +51,10 @@ module Tmuxinator
         File.directory?(environment)
       end
 
+      def default_or_sample
+        default? ? default : sample
+      end
+
       def sample
         asset_path "sample.yml"
       end
@@ -57,7 +64,7 @@ module Tmuxinator
       end
 
       def default?
-        exists?(name: "default")
+        exist?(name: "default")
       end
 
       def version
@@ -76,9 +83,10 @@ module Tmuxinator
         version && version < 1.8 ? "default-path" : "-c"
       end
 
-      def exists?(name: nil, path: nil)
+      def exist?(name: nil, path: nil)
         return File.exist?(path) if path
         return File.exist?(project(name)) if name
+
         false
       end
 
@@ -140,21 +148,24 @@ module Tmuxinator
 
       def valid_project_config?(project_config)
         return false unless project_config
-        unless exists?(path: project_config)
+        unless exist?(path: project_config)
           raise "Project config (#{project_config}) doesn't exist."
         end
+
         true
       end
 
       def valid_local_project?(name)
         return false if name
         raise NO_LOCAL_FILE_MSG unless local?
+
         true
       end
 
       def valid_standard_project?(name)
         return false unless name
-        raise "Project #{name} doesn't exist." unless exists?(name: name)
+        raise "Project #{name} doesn't exist." unless exist?(name: name)
+
         true
       end
 
@@ -193,6 +204,7 @@ module Tmuxinator
       # recursively searching 'directory'
       def project_in(directory, name)
         return nil if String(directory).empty?
+
         projects = Dir.glob("#{directory}/**/*.{yml,yaml}").sort
         projects.detect { |project| File.basename(project, ".*") == name }
       end

data/lib/tmuxinator/deprecations.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tmuxinator
   module Deprecations
     def rvm?

data/lib/tmuxinator/doctor.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tmuxinator
   class Doctor
     class << self

data/lib/tmuxinator/hooks/project.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tmuxinator
   module Hooks
     module Project
@@ -37,6 +39,6 @@ module Tmuxinator
         # this method can only be used from inside Tmuxinator::Project
         Tmuxinator::Hooks.commands_from self, "on_project_stop"
       end
-    end # End Project
-  end # End Hooks
-end # End Tmuxinator
+    end
+  end
+end

data/lib/tmuxinator/hooks.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tmuxinator
   module Hooks
     module_function

data/lib/tmuxinator/pane.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tmuxinator
   class Pane
     attr_reader :commands, :project, :index, :tab, :title
@@ -7,7 +9,7 @@ module Tmuxinator
       @index = index
       @project = project
       @tab = tab
-      @title = title
+      @title = title.to_s.shellescape unless title.nil?
     end
 
     def tmux_window_and_pane_target
@@ -61,12 +63,12 @@ module Tmuxinator
 
     private
 
-    def _send_target(e)
-      _send_keys(tmux_window_and_pane_target, e)
+    def _send_target(keys)
+      _send_keys(tmux_window_and_pane_target, keys)
     end
 
-    def _send_keys(t, e)
-      "#{project.tmux} send-keys -t #{t} #{e} C-m"
+    def _send_keys(target, keys)
+      "#{project.tmux} send-keys -t #{target} #{keys} C-m"
     end
 
     def _set_title(title)

data/lib/tmuxinator/project.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tmuxinator
   class Project
     include Tmuxinator::Util
@@ -41,16 +43,14 @@ module Tmuxinator
 
     def self.load(path, options = {})
       yaml = begin
-        raw_content = File.read(path)
-
         args = options[:args] || []
         @settings = parse_settings(args)
         @args = args
 
-        content = Erubis::Eruby.new(raw_content).result(binding)
+        content = render_template(path, binding)
         YAML.safe_load(content, aliases: true)
-      rescue SyntaxError, StandardError => error
-        raise "Failed to parse config file: #{error.message}"
+             rescue SyntaxError, StandardError => error
+               raise "Failed to parse config file: #{error.message}"
       end
 
       new(yaml, options)
@@ -73,6 +73,7 @@ module Tmuxinator
         unless windows?
       raise "Your project file didn't specify a 'project_name'" \
         unless name?
+
       self
     end
 
@@ -103,7 +104,7 @@ module Tmuxinator
 
     def self.render_template(template, bndg)
       content = File.read(template)
-      Erubis::Eruby.new(content).result(bndg)
+      bndg.eval(Erubi::Engine.new(content).src)
     end
 
     def windows
@@ -239,8 +240,8 @@ module Tmuxinator
       !name.nil?
     end
 
-    def window(i)
-      "#{name}:#{i}"
+    def window(index)
+      "#{name}:#{index}"
     end
 
     def send_pane_command(cmd, window_index, _pane_index)
@@ -336,6 +337,44 @@ module Tmuxinator
       "#{tmux} kill-session -t #{name}"
     end
 
+    def enable_pane_titles?
+      yaml["enable_pane_titles"]
+    end
+
+    def tmux_set_pane_title_position(tmux_window_target)
+      command = set_window_option(tmux_window_target)
+      if pane_title_position? && pane_title_position_valid?
+        "#{command} pane-border-status #{yaml['pane_title_position']}"
+      else
+        "#{command} pane-border-status top"
+      end
+    end
+
+    def tmux_set_pane_title_format(tmux_window_target)
+      command = set_window_option(tmux_window_target)
+      if pane_title_format?
+        "#{command} pane-border-format \"#{yaml['pane_title_format']}\""
+      else
+        "#{command} pane-border-format \"\#{pane_index}: \#{pane_title}\""
+      end
+    end
+
+    def pane_title_position_not_valid_warning
+      print_warning(
+        "The specified pane title position " +
+        "\"#{yaml['pane_title_position']}\" is not valid. " +
+        "Please choose one of: top, bottom, or off."
+      )
+    end
+
+    def pane_titles_not_supported_warning
+      print_warning(
+        "You have enabled pane titles in your configuration, " +
+        "but the feature is not supported by your version of tmux.\n" +
+        "Please consider upgrading to a version that supports it (tmux >=2.6)."
+      )
+    end
+
     private
 
     def blank?(object)
@@ -349,9 +388,10 @@ module Tmuxinator
     def extract_tmux_config
       options_hash = {}
 
-      options_string = `#{show_tmux_options}`
-      options_string.encode!("UTF-8", invalid: :replace)
-      options_string.split("\n").map do |entry|
+      `#{show_tmux_options}`.
+        encode("UTF-8", invalid: :replace).
+        split("\n").
+        map do |entry|
         key, value = entry.split("\s")
         options_hash[key] = value
         options_hash
@@ -381,5 +421,28 @@ module Tmuxinator
     def wemux?
       yaml["tmux_command"] == "wemux"
     end
+
+    def pane_title_position?
+      yaml["pane_title_position"]
+    end
+
+    def pane_title_position_valid?
+      ["top", "bottom", "off"].include? yaml["pane_title_position"]
+    end
+
+    def pane_title_format?
+      yaml["pane_title_format"]
+    end
+
+    def print_warning(message)
+      yellow = '\033[1;33m'
+      no_color = '\033[0m'
+      msg = "WARNING: #{message}\n"
+      "printf \"#{yellow}#{msg}#{no_color}\""
+    end
+
+    def set_window_option(tmux_window_target)
+      "#{tmux} set-window-option -t #{tmux_window_target}"
+    end
   end
 end

data/lib/tmuxinator/tmux_version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tmuxinator
   module TmuxVersion
     SUPPORTED_TMUX_VERSIONS = [
@@ -29,7 +31,7 @@ module Tmuxinator
       1.6,
       1.5,
     ].freeze
-    UNSUPPORTED_VERSION_MSG = <<-MSG.freeze
+    UNSUPPORTED_VERSION_MSG = <<-MSG
     WARNING: You are running tmuxinator with an unsupported version of tmux.
     Please consider using a supported version:
     (#{SUPPORTED_TMUX_VERSIONS.join(', ')})

data/lib/tmuxinator/util.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tmuxinator
   module Util
     include Thor::Actions

data/lib/tmuxinator/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tmuxinator
-  VERSION = "3.1.2".freeze
+  VERSION = "3.2.1"
 end

data/lib/tmuxinator/wemux_support.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tmuxinator
   module WemuxSupport
     def render

data/lib/tmuxinator/window.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tmuxinator
   class Window
     include Tmuxinator::Util

data/lib/tmuxinator.rb

@@ -1,4 +1,6 @@
-require "erubis"
+# frozen_string_literal: true
+
+require "erubi"
 require "fileutils"
 require "shellwords"
 require "thor"

data/spec/factories/projects.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 def yaml_load(file)
   YAML.safe_load(File.read(File.expand_path(file)))
 end

data/spec/lib/tmuxinator/cli_spec.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "spec_helper"
 
 describe Tmuxinator::Cli do
@@ -15,7 +17,7 @@ describe Tmuxinator::Cli do
       File.new(local_project_path, "w").tap do |f|
         f.write content
       end.close
-      expect(File.exists?(local_project_path)).to be_truthy
+      expect(File.exist?(local_project_path)).to be_truthy
       expect(File.read(local_project_path)).to eq content
     end
 
@@ -26,7 +28,7 @@ describe Tmuxinator::Cli do
 
   subject(:cli) { described_class }
 
-  let(:fixtures_dir) { File.expand_path("../../../fixtures/", __FILE__) }
+  let(:fixtures_dir) { File.expand_path("../../fixtures", __dir__) }
   let(:project) { FactoryBot.build(:project) }
   let(:project_config) do
     File.join(fixtures_dir, "sample_with_project_config.yml")
@@ -93,7 +95,7 @@ describe Tmuxinator::Cli do
         context "a tmuxinator project name" do
           before do
             expect(Tmuxinator::Config).to \
-              receive(:exists?).with(name: arg1) { true }
+              receive(:exist?).with(name: arg1) { true }
           end
 
           it "should call #start" do
@@ -127,7 +129,7 @@ describe Tmuxinator::Cli do
         context "something else" do
           before do
             expect(Tmuxinator::Config).to \
-              receive(:exists?).with(name: arg1) { false }
+              receive(:exist?).with(name: arg1) { false }
           end
 
           it "should call ::start" do
@@ -622,7 +624,7 @@ describe Tmuxinator::Cli do
   describe "#copy" do
     before do
       ARGV.replace(["copy", "foo", "bar"])
-      allow(Tmuxinator::Config).to receive(:exists?) { true }
+      allow(Tmuxinator::Config).to receive(:exist?) { true }
     end
 
     context "new project already exists" do
@@ -638,7 +640,7 @@ describe Tmuxinator::Cli do
 
     context "existing project doesn't exist" do
       before do
-        allow(Tmuxinator::Config).to receive(:exists?) { false }
+        allow(Tmuxinator::Config).to receive(:exist?) { false }
       end
 
       it "exit with error code" do
@@ -714,7 +716,7 @@ describe Tmuxinator::Cli do
 
       context "project exists" do
         before do
-          allow(Tmuxinator::Config).to receive(:exists?) { true }
+          allow(Tmuxinator::Config).to receive(:exist?) { true }
         end
 
         it "deletes the project" do
@@ -725,7 +727,7 @@ describe Tmuxinator::Cli do
 
       context "local project exists" do
         before do
-          allow(Tmuxinator::Config).to receive(:exists?) { true }
+          allow(Tmuxinator::Config).to receive(:exist?) { true }
           expect(Tmuxinator::Config).to receive(:project) { "local" }
         end
 
@@ -737,7 +739,7 @@ describe Tmuxinator::Cli do
 
       context "project doesn't exist" do
         before do
-          allow(Tmuxinator::Config).to receive(:exists?) { false }
+          allow(Tmuxinator::Config).to receive(:exist?) { false }
         end
 
         it "outputs an error message" do
@@ -754,7 +756,7 @@ describe Tmuxinator::Cli do
 
       context "all projects exist" do
         before do
-          allow(Tmuxinator::Config).to receive(:exists?).and_return(true)
+          allow(Tmuxinator::Config).to receive(:exist?).and_return(true)
         end
 
         it "deletes the projects" do
@@ -765,10 +767,10 @@ describe Tmuxinator::Cli do
 
       context "only one project exists" do
         before do
-          allow(Tmuxinator::Config).to receive(:exists?).with(name: "foo") {
+          allow(Tmuxinator::Config).to receive(:exist?).with(name: "foo") {
             true
           }
-          allow(Tmuxinator::Config).to receive(:exists?).with(name: "bar") {
+          allow(Tmuxinator::Config).to receive(:exist?).with(name: "bar") {
             false
           }
         end
@@ -785,7 +787,7 @@ describe Tmuxinator::Cli do
 
       context "all projects do not exist" do
         before do
-          allow(Tmuxinator::Config).to receive(:exists?).and_return(false)
+          allow(Tmuxinator::Config).to receive(:exist?).and_return(false)
         end
 
         it "outputs multiple error messages" do
@@ -952,7 +954,7 @@ describe Tmuxinator::Cli do
     let(:name) { "sample" }
     let(:custom_name) { nil }
     let(:cli_options) { {} }
-    let(:path) { File.expand_path("../../../fixtures", __FILE__) }
+    let(:path) { File.expand_path("../../fixtures", __dir__) }
 
     shared_examples_for :a_proper_project do
       it "should create a valid project" do

data/spec/lib/tmuxinator/config_spec.rb

@@ -1,7 +1,9 @@
+# frozen_string_literal: true
+
 require "spec_helper"
 
 describe Tmuxinator::Config do
-  let(:fixtures_dir) { File.expand_path("../../../fixtures/", __FILE__) }
+  let(:fixtures_dir) { File.expand_path("../../fixtures", __dir__) }
   let(:xdg_config_dir) { "#{fixtures_dir}/xdg-tmuxinator" }
   let(:home_config_dir) { "#{fixtures_dir}/dot-tmuxinator" }
 
@@ -150,6 +152,30 @@ describe Tmuxinator::Config do
     end
   end
 
+  describe "#default_or_sample" do
+    context "with default? true" do
+      before do
+        allow(described_class).to receive(:default?).and_return true
+        allow(described_class).to receive(:default).and_return("default_path")
+      end
+
+      it "gets the default config when it exists" do
+        expect(described_class.default_or_sample).to eq "default_path"
+      end
+    end
+
+    context "with default? false" do
+      before do
+        allow(described_class).to receive(:default?)
+        allow(described_class).to receive(:sample).and_return("sample_path")
+      end
+
+      it "falls back to the sample config when the default is missing" do
+        expect(described_class.default_or_sample).to eq "sample_path"
+      end
+    end
+  end
+
   describe "#version" do
     subject { described_class.version }
 
@@ -160,25 +186,25 @@ describe Tmuxinator::Config do
     end
 
     version_mapping = {
-      "0.8"      => 0.8,
-      "1.0"      => 1.0,
-      "1.9"      => 1.9,
-      "1.9a"     => 1.9,
-      "2.4"      => 2.4,
-      "2.9a"     => 2.9,
-      "3.0-rc5"  => 3.0,
+      "0.8" => 0.8,
+      "1.0" => 1.0,
+      "1.9" => 1.9,
+      "1.9a" => 1.9,
+      "2.4" => 2.4,
+      "2.9a" => 2.9,
+      "3.0-rc5" => 3.0,
       "next-3.1" => 3.1,
-      "master"   => Float::INFINITY,
+      "master" => Float::INFINITY,
       # Failsafes
-      "foobar"   => 0.0,
-      "-123-"    => 123.0,
-      "5935"     => 5935.0,
-      ""         => 0.0,
-      "!@#^%"    => 0.0,
-      "2.9ä"     => 2.9,
-      "v3.5"     => 3.5,
-      "v3.12.0"  => 3.12,
-      "v3.12.5"  => 3.12
+      "foobar" => 0.0,
+      "-123-" => 123.0,
+      "5935" => 5935.0,
+      "" => 0.0,
+      "!@#^%" => 0.0,
+      "2.9ä" => 2.9,
+      "v3.5" => 3.5,
+      "v3.12.0" => 3.12,
+      "v3.12.5" => 3.12
     }.freeze
 
     version_mapping.each do |string_version, parsed_numeric_version|
@@ -262,14 +288,14 @@ describe Tmuxinator::Config do
     end
   end
 
-  describe "#exists?" do
+  describe "#exist?" do
     before do
       allow(File).to receive_messages(exist?: true)
       allow(described_class).to receive_messages(project: "")
     end
 
     it "checks if the given project exists" do
-      expect(described_class.exists?(name: "test")).to be_truthy
+      expect(described_class.exist?(name: "test")).to be_truthy
     end
   end
 

data/spec/lib/tmuxinator/doctor_spec.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "spec_helper"
 
 describe Tmuxinator::Doctor do

data/spec/lib/tmuxinator/hooks/project_spec.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "spec_helper"
 
 shared_examples_for "a project hook" do

data/spec/lib/tmuxinator/hooks_spec.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "spec_helper"
 
 describe Tmuxinator::Hooks do

data/spec/lib/tmuxinator/pane_spec.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "spec_helper"
 
 describe Tmuxinator::Pane do
@@ -10,7 +12,7 @@ describe Tmuxinator::Pane do
   let(:project) { double }
   let(:window) { double }
   let(:commands) { ["vim", "bash"] }
-  let(:title) { "test" }
+  let(:title) { "test (a test)" }
 
   before do
     allow(project).to receive(:name).and_return "foo"
@@ -39,7 +41,7 @@ describe Tmuxinator::Pane do
 
     it "sets pane title" do
       expect(subject.tmux_set_title).to eql(
-        "tmux select-pane -t foo:0.1 -T test"
+        "tmux select-pane -t foo:0.1 -T test\\ \\(a\\ test\\)"
       )
     end
   end

data/spec/lib/tmuxinator/project_spec.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "spec_helper"
 
 describe Tmuxinator::Project do
@@ -589,7 +591,7 @@ describe Tmuxinator::Project do
   end
 
   describe "::load" do
-    let(:path) { File.expand_path("../../../fixtures/sample.yml", __FILE__) }
+    let(:path) { File.expand_path("../../fixtures/sample.yml", __dir__) }
     let(:options) { {} }
 
     it "should raise if the project file doesn't parse" do
@@ -635,4 +637,77 @@ describe Tmuxinator::Project do
       end.to raise_error RuntimeError, %r{didn't.specify.a.'project_name'}
     end
   end
+
+  describe "#pane_titles" do
+    before do
+      allow(project).to receive(:tmux).and_return "tmux"
+    end
+
+    context "pane_titles not enabled" do
+      before { project.yaml["enable_pane_titles"] = false }
+
+      it "returns false" do
+        expect(project.enable_pane_titles?).to be false
+      end
+    end
+
+    context "pane_titles enabled" do
+      before { project.yaml["enable_pane_titles"] = true }
+
+      it "returns true" do
+        expect(project.enable_pane_titles?).to be true
+      end
+    end
+
+    context "pane_title_position not configured" do
+      before { project.yaml["pane_title_position"] = nil }
+
+      it "configures a default position of top" do
+        expect(project.tmux_set_pane_title_position("x")).to eq(
+          "tmux set-window-option -t x pane-border-status top"
+        )
+      end
+    end
+
+    context "pane_title_position configured" do
+      before { project.yaml["pane_title_position"] = "bottom" }
+
+      it "configures a position of bottom" do
+        expect(project.tmux_set_pane_title_position("x")).to eq(
+          "tmux set-window-option -t x pane-border-status bottom"
+        )
+      end
+    end
+
+    context "pane_title_position invalid" do
+      before { project.yaml["pane_title_position"] = "other" }
+
+      it "configures the default position" do
+        expect(project.tmux_set_pane_title_position("x")).to eq(
+          "tmux set-window-option -t x pane-border-status top"
+        )
+      end
+    end
+
+    context "pane_title_format not configured" do
+      before { project.yaml["pane_title_format"] = nil }
+
+      it "configures a default format" do
+        resp = ""\
+          "tmux set-window-option -t x pane-border-format"\
+          " \"\#{pane_index}: \#{pane_title}\""
+        expect(project.tmux_set_pane_title_format("x")).to eq(resp)
+      end
+    end
+
+    context "pane_title_format configured" do
+      before { project.yaml["pane_title_format"] = " [ #T ] " }
+
+      it "configures the provided format" do
+        expect(project.tmux_set_pane_title_format("x")).to eq(
+          'tmux set-window-option -t x pane-border-format " [ #T ] "'
+        )
+      end
+    end
+  end
 end

data/spec/lib/tmuxinator/util_spec.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "spec_helper"
 
 describe Tmuxinator::Util do

data/spec/lib/tmuxinator/wemux_support_spec.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "spec_helper"
 
 describe Tmuxinator::WemuxSupport do

data/spec/lib/tmuxinator/window_spec.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "spec_helper"
 
 describe Tmuxinator::Window do

data/spec/matchers/pane_matcher.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 RSpec::Matchers.alias_matcher :be_a_pane, :a_pane
 RSpec::Matchers.define :a_pane do
   attr_reader :commands

data/spec/spec_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "coveralls"
 require "pry"
 require "simplecov"
@@ -39,7 +41,7 @@ def capture_io
 
   yield
 
-  return captured_stdout.string, captured_stderr.string
+  [captured_stdout.string, captured_stderr.string]
 ensure
   $stdout = orig_stdout
   $stderr = orig_stderr

metadata

@@ -1,30 +1,30 @@
 --- !ruby/object:Gem::Specification
 name: tmuxinator
 version: !ruby/object:Gem::Version
-  version: 3.1.2
+  version: 3.2.1
 platform: ruby
 authors:
 - Allen Bargi
 - Christopher Chow
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-02-16 00:00:00.000000000 Z
+date: 2024-05-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: erubis
+  name: erubi
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '1.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '1.7'
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -177,14 +177,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.48.1
+        version: 0.61.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.48.1
+        version: 0.61.1
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -302,8 +302,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.8.23
 requirements: []
-rubygems_version: 3.3.5
-signing_key: 
+rubygems_version: 3.2.15
+signing_key:
 specification_version: 4
 summary: Create and manage complex tmux sessions easily.
 test_files: