fig 2.0.0.pre.alpha.4 → 2.0.0.pre.alpha.5

data/spec/statement/asset_spec.rb

@@ -0,0 +1,203 @@
+# coding: utf-8
+
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+require 'fig/statement/archive'
+require 'fig/statement/resource'
+
+[Fig::Statement::Archive, Fig::Statement::Resource].each do
+  |statement_type|
+
+  describe statement_type do
+    describe '.validate_and_process_escapes_in_location()' do
+      def test_should_equal_and_should_glob(
+        statement_type, original_location, location
+      )
+        block_message = nil
+        location      = location.clone
+
+        tokenized_location =
+          statement_type.validate_and_process_escapes_in_location(location) do
+            |message| block_message = message
+          end
+
+        block_message.should be_nil
+
+        location     = tokenized_location.to_expanded_string
+        need_to_glob = ! tokenized_location.single_quoted?
+
+        location.should       == original_location
+        need_to_glob.should   be true
+
+        return
+      end
+
+      def test_should_equal_and_should_not_glob(
+        statement_type, original_location, location
+      )
+        block_message = nil
+        location      = location.clone
+
+        tokenized_location =
+          statement_type.validate_and_process_escapes_in_location(location) do
+            |message| block_message = message
+          end
+
+        location     = tokenized_location.to_expanded_string
+        need_to_glob = ! tokenized_location.single_quoted?
+
+        block_message.should  be_nil
+        location.should       == original_location
+        need_to_glob.should   be false
+
+        return
+      end
+
+      # "foo * bar": whitespace and glob character
+      [%q<foo * bar>].each do
+        |original_location|
+
+        it %Q<does not modify «#{original_location}» and says that it should be globbed> do
+          test_should_equal_and_should_glob(
+            statement_type, original_location, original_location
+          )
+        end
+        it %Q<strips quotes from «"#{original_location}"» and says that it should be globbed> do
+          test_should_equal_and_should_glob(
+            statement_type, original_location, %Q<"#{original_location}">
+          )
+        end
+
+        it %Q<strips quotes from «'#{original_location}'» and says that it should not be globbed> do
+          test_should_equal_and_should_not_glob(
+            statement_type, original_location, %Q<'#{original_location}'>
+          )
+        end
+      end
+
+      %w< \\ ' >.each do
+        |character|
+
+        escaped_location = %Q<foo \\#{character} bar>
+        unescaped_location = %Q<foo #{character} bar>
+        it %Q<processes escapes from «'#{escaped_location}'» and says that it should not be globbed> do
+          test_should_equal_and_should_not_glob(
+            statement_type, unescaped_location, %Q<'#{escaped_location}'>
+          )
+        end
+      end
+
+      %w< \\ " >.each do
+        |character|
+
+        escaped_location = %Q<foo \\#{character} bar>
+        unescaped_location = %Q<foo #{character} bar>
+        it %Q<processes escapes from «#{escaped_location}» and says that it should be globbed> do
+          test_should_equal_and_should_glob(
+            statement_type, unescaped_location, escaped_location
+          )
+        end
+        it %Q<processes escapes from «"#{escaped_location}"» and says that it should be globbed> do
+          test_should_equal_and_should_glob(
+            statement_type, unescaped_location, %Q<"#{escaped_location}">
+          )
+        end
+      end
+
+      def test_got_error_message(statement_type, location, error_regex)
+        block_message = nil
+
+        statement_type.validate_and_process_escapes_in_location(location.dup) do
+          |message| block_message = message
+        end
+
+        block_message.should =~ error_regex
+
+        return
+      end
+
+      def test_contains_bad_escape(statement_type, location)
+        test_got_error_message(
+          statement_type, location, /contains a bad escape sequence/i
+        )
+
+        return
+      end
+
+      %w< @ " >.each do
+        |character|
+
+        it %Q<says «'foo \\#{character} bar'» isn't allowed> do
+          test_contains_bad_escape(statement_type, %Q<'foo \\#{character} bar'>)
+        end
+      end
+
+      %w< ' 'xxx xxx' '\' '\\ >.each do
+        |location|
+
+        it %Q<says «#{location}» has unbalanced quotes> do
+          test_got_error_message(
+            statement_type, location, /has unbalanced single quotes/i
+          )
+        end
+      end
+
+      %w< " "xxx xxx" "\" "\\ >.each do
+        |location|
+
+        it %Q<says «#{location}» has unbalanced quotes> do
+          test_got_error_message(
+            statement_type, location, /has unbalanced double quotes/i
+          )
+        end
+      end
+
+      %w< xxx'xxx xxx"xxx >.each do
+        |location|
+
+        it %Q<says «#{location}» has unescaped quote> do
+          test_got_error_message(
+            statement_type, location, /unescaped .* quote/i
+          )
+        end
+      end
+
+      %w< \\ xxx\\ >.each do
+        |location|
+
+        it %Q<says «#{location}» has incomplete escape> do
+          test_got_error_message(statement_type, location, /incomplete escape/i)
+        end
+      end
+
+      %w< \\n '\\n' "\\n" >.each do
+        |location|
+
+        it %Q<says «#{location}» has bad escape> do
+          test_got_error_message(statement_type, location, /bad escape/i)
+        end
+      end
+
+      %w<
+        foo\\\\\\\\bar\\\\baz 'foo\\\\\\\\bar\\\\baz' "foo\\\\\\\\bar\\\\baz"
+      >.each do
+        |original_location|
+
+        it %Q<collapses the backslashes in «#{original_location}»> do
+          location           = original_location.clone
+          block_message = nil
+
+          tokenized_location =
+            statement_type.validate_and_process_escapes_in_location(location) do
+              |message| block_message = message
+            end
+
+          tokenized_location.to_expanded_string == 'foo\\\\bar\\baz'
+          block_message.should                  be_nil
+        end
+      end
+    end
+  end
+end
+
+# vim: set fileencoding=utf8 :

data/spec/statement/configuration_spec.rb

@@ -0,0 +1,41 @@
+# coding: utf-8
+
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+require 'fig/statement/command'
+require 'fig/statement/configuration'
+require 'fig/statement/include'
+require 'fig/statement/override'
+require 'fig/statement/path'
+require 'fig/statement/set'
+require 'fig/statement/synthetic_raw_text'
+
+describe 'Statement::Configuration' do
+  it 'moves override statements to the front of the set of statements' do
+    override_c = Fig::Statement::Override.new(nil, nil, 'C', 'version')
+    override_b = Fig::Statement::Override.new(nil, nil, 'B', 'version')
+    override_a = Fig::Statement::Override.new(nil, nil, 'A', 'version')
+
+    command = Fig::Statement::Command.new(nil, nil, %w< something to run >)
+    incorporate = Fig::Statement::Include.new(nil, nil, nil, nil, nil)
+
+    parsed_name, parsed_value =
+      Fig::Statement::Path.parse_name_value 'name=value'
+    path = Fig::Statement::Path.new(nil, nil, parsed_name, parsed_value)
+    set = Fig::Statement::Set.new(nil, nil, parsed_name, parsed_value)
+
+    config = Fig::Statement::Configuration.new(
+      nil,
+      nil,
+      'name',
+      [command, override_c, incorporate, override_b, path, override_a, set]
+    )
+
+    statements_to_be_checked =
+      config.statements.reject {
+        |statement| statement.is_a? Fig::Statement::SyntheticRawText
+      }
+    statements_to_be_checked.should ==
+      [override_c, override_b, override_a, command, incorporate, path, set]
+  end
+end

data/spec/support/formatters/seed_spitter.rb

@@ -0,0 +1,12 @@
+# coding: utf-8
+
+require 'rspec/core/formatters/documentation_formatter'
+
+class SeedSpitter < RSpec::Core::Formatters::DocumentationFormatter
+
+  def start(*)
+    super
+    output.puts "\nSeed: #{RSpec.configuration.seed}"
+  end
+
+end

data/spec/working_directory_maintainer_spec.rb

@@ -0,0 +1,102 @@
+# coding: utf-8
+
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+require 'fig/operating_system'
+require 'fig/working_directory_maintainer'
+
+describe 'WorkingDirectoryMaintainer' do
+  let(:base_directory)    { "#{CURRENT_DIRECTORY}/retrieve-test" }
+  let(:working_directory) { "#{base_directory}/working" }
+  let(:source_directory)  { "#{base_directory}/source" }
+
+  def new_maintainer
+    return Fig::WorkingDirectoryMaintainer.new(
+      working_directory, Fig::OperatingSystem.macos?,
+    )
+  end
+
+  before(:each) do
+    clean_up_test_environment
+    set_up_test_environment
+
+    [working_directory, source_directory].each do
+      |directory|
+
+      FileUtils.rm_rf(directory)
+      FileUtils.mkdir_p(directory)
+    end
+  end
+
+  it 'maintains files for a single package' do
+    # Set up some test files
+    source_foo = "#{source_directory}/foo.txt"
+    source_bar = "#{source_directory}/bar.txt"
+    source_baz = "#{source_directory}/baz.txt"
+    File.open(source_foo, 'w') {|f| f << 'FOO'}
+    File.open(source_bar, 'w') {|f| f << 'BAR'}
+    File.open(source_baz, 'w') {|f| f << 'BAZ'}
+
+    working_foo = File.join(working_directory, 'foo.txt')
+    working_bar = File.join(working_directory, 'bar.txt')
+    working_baz = File.join(working_directory, 'baz.txt')
+
+    # Retrieve files A and B
+    maintainer = new_maintainer
+    maintainer.switch_to_package_version('foo', '1.2.3')
+    maintainer.retrieve(source_foo, 'foo.txt')
+    maintainer.retrieve(source_bar, 'bar.txt')
+    File.read(working_foo).should == 'FOO'
+    File.read(working_bar).should == 'BAR'
+
+    # Retrieve files B and C for a different version
+    maintainer.switch_to_package_version('foo', '4.5.6')
+    maintainer.retrieve(source_bar, 'bar.txt')
+    maintainer.retrieve(source_baz, 'baz.txt')
+    File.read(working_bar).should == 'BAR'
+    File.read(working_baz).should == 'BAZ'
+    File.exist?(working_foo).should == false
+
+    # Save and reload
+    maintainer.prepare_for_shutdown(:purged_unused_packages)
+    maintainer = new_maintainer
+
+    # Switch back to original version
+    maintainer.switch_to_package_version('foo', '1.2.3')
+    maintainer.retrieve(source_foo, 'foo.txt')
+    maintainer.retrieve(source_bar, 'bar.txt')
+
+    File.read(working_foo).should == 'FOO'
+    File.read(working_bar).should == 'BAR'
+    File.exist?(working_baz).should == false
+  end
+
+  it 'preserves executable bit' do
+    File.open("#{source_directory}/plain", 'w') {|f| f << 'plain'}
+    File.open("#{source_directory}/executable", 'w') {|f| f << 'executable.exe'}
+    FileUtils.chmod(0755, "#{source_directory}/executable")
+
+    maintainer = new_maintainer
+    maintainer.switch_to_package_version('foo', '1.2.3')
+    maintainer.retrieve("#{source_directory}/plain", 'plain')
+    maintainer.retrieve("#{source_directory}/executable", 'executable.exe')
+
+    File.stat(File.join(working_directory, 'plain')).executable?.should == false
+    File.stat(File.join(working_directory, 'executable.exe')).executable?.should == true
+  end
+
+  it 'fails on corrupted metadata' do
+    FileUtils.mkdir_p("#{working_directory}/.fig")
+
+    metadata_file = "#{working_directory}/.fig/retrieve"
+    IO.write(metadata_file, 'random garbage')
+
+    expect { new_maintainer }.to raise_error(/parse error/)
+
+    # This is so much fun.  It appears that once we've had a file open within
+    # this process, we cannot delete that file, i.e. "File.rm(metadata_file)"
+    # results in an EACCESS on Windows.  So, in lieu of removing the file, we
+    # just make it empty.
+    IO.write(metadata_file, '')
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: fig
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre.alpha.4
+  version: 2.0.0.pre.alpha.5
 platform: ruby
 authors:
 - Fig Folks
 bindir: bin
 cert_chain: []
-date: 2025-06-02 00:00:00.000000000 Z
+date: 2025-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bcrypt_pbkdf
@@ -306,7 +306,7 @@ dependencies:
 description: |-
   Fig is a utility for configuring environments and managing dependencies across a team of developers. Given a list of packages and a command to run, Fig builds environment variables named in those packages (e.g., CLASSPATH), then executes the command in that environment. The caller's environment is not affected.
 
-  Built from git SHA1: c0b5d8c
+  Built from git SHA1: ac8e555-dirty
 email: maintainer@figpackagemanager.org
 executables:
 - fig
@@ -448,6 +448,7 @@ files:
 - lib/fig/repository_error.rb
 - lib/fig/repository_package_publisher.rb
 - lib/fig/runtime_environment.rb
+- lib/fig/spec_utils.rb
 - lib/fig/statement.rb
 - lib/fig/statement/archive.rb
 - lib/fig/statement/asset.rb
@@ -475,10 +476,46 @@ files:
 - lib/fig/working_directory_maintainer.rb
 - lib/fig/working_directory_metadata.rb
 - lib/git_helper.rb
+- spec/application_configuration_spec.rb
+- spec/command/clean_spec.rb
+- spec/command/command_line_vs_package_spec.rb
+- spec/command/dump_package_definition_spec.rb
+- spec/command/environment_variables_spec.rb
+- spec/command/grammar_asset_spec.rb
+- spec/command/grammar_command_spec.rb
+- spec/command/grammar_environment_variable_spec.rb
+- spec/command/grammar_retrieve_spec.rb
+- spec/command/grammar_spec.rb
+- spec/command/grammar_spec_helper.rb
+- spec/command/include_file_spec.rb
+- spec/command/listing_spec.rb
+- spec/command/miscellaneous_spec.rb
+- spec/command/publish_local_and_updates_spec.rb
+- spec/command/publishing_retrieval_spec.rb
+- spec/command/publishing_spec.rb
+- spec/command/running_commands_spec.rb
+- spec/command/suppress_includes_spec.rb
+- spec/command/suppress_warning_include_statement_missing_version_spec.rb
+- spec/command/update_lock_response_spec.rb
+- spec/command/usage_errors_spec.rb
+- spec/command_options_spec.rb
+- spec/command_spec.rb
+- spec/deparser/v1_spec.rb
+- spec/environment_variables_spec.rb
+- spec/figrc_spec.rb
+- spec/parser_spec.rb
+- spec/repository_spec.rb
+- spec/runtime_environment_spec.rb
+- spec/spec_helper.rb
+- spec/split_repo_url_spec.rb
+- spec/statement/asset_spec.rb
+- spec/statement/configuration_spec.rb
+- spec/support/formatters/seed_spitter.rb
+- spec/working_directory_maintainer_spec.rb
 licenses:
 - BSD-3-Clause
 metadata:
-  git_sha: c0b5d8c
+  git_sha: ac8e555-dirty
 rdoc_options: []
 require_paths:
 - lib
@@ -496,5 +533,5 @@ requirements: []
 rubygems_version: 3.6.1
 specification_version: 4
 summary: 'Utility for configuring environments and managing dependencies across a
-  team of developers. Built from git SHA1: c0b5d8c'
+  team of developers. Built from git SHA1: ac8e555-dirty'
 test_files: []