Add 'build' DSL method.

Disallow processing Environments until configuration is performed.

build_tests/cfile/Rsconscript

@@ -1,4 +1,6 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.CFile("lexer.c", "lexer.l")
     env.CFile("parser.c", "parser.y")
+  end
 end

build_tests/cfile/error_unknown_extension.rb

@@ -1,3 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.CFile("file.c", "foo.bar")
+  end
 end

build_tests/clone_env/Rsconscript

@@ -1,10 +1,12 @@
-debug = Rscons::Environment.new(echo: :command) do |env|
+build do
+  debug = Rscons::Environment.new(echo: :command) do |env|
     env['CFLAGS'] = '-O2'
     env['CPPFLAGS'] = '-DSTRING="Debug Version"'
     env.Program('program-debug.exe', Dir['src/*.c'])
-end
+  end
 
-release = debug.clone do |env|
+  release = debug.clone do |env|
     env["CPPFLAGS"] = '-DSTRING="Release Version"'
     env.Program('program-release.exe', Dir['src/*.c'])
+  end
 end

build_tests/clone_env/clone_all.rb

@@ -1,4 +1,5 @@
-env1 = Rscons::Environment.new(echo: :command) do |env|
+build do
+  env1 = Rscons::Environment.new(echo: :command) do |env|
     env['CFLAGS'] = '-O2'
     env.add_build_hook do |build_op|
       build_op[:vars]['CPPFLAGS'] = '-DSTRING="Hello"'
@@ -7,8 +8,9 @@ env1 = Rscons::Environment.new(echo: :command) do |env|
       $stdout.puts "post #{build_op[:target]}"
     end
     env.Program('program.exe', Dir['src/*.c'])
-end
+  end
 
-env2 = env1.clone do |env|
+  env2 = env1.clone do |env|
     env.Program('program2.exe', Dir['src/*.c'])
+  end
 end

build_tests/configure/check_c_header_no_fail_set_define.rb

@@ -2,6 +2,8 @@ configure do
   check_c_header "not___found.h", fail: false, set_define: "HAVE_NOT___FOUND_H"
 end
 
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env.Object("simple.o", "simple.c")
+  end
 end

build_tests/configure/check_c_header_success_set_define.rb

@@ -2,6 +2,8 @@ configure do
   check_c_header "string.h", set_define: "HAVE_STRING_H"
 end
 
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env.Object("simple.o", "simple.c")
+  end
 end

build_tests/configure/check_cfg.rb

@@ -2,6 +2,8 @@ configure do
   check_cfg program: "my-config"
 end
 
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env.Program("myconfigtest", "simple.c")
+  end
 end

build_tests/configure/check_cfg_package.rb

@@ -2,6 +2,8 @@ configure do
   check_cfg package: "mypackage"
 end
 
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env.Program("myconfigtest", "simple.c")
+  end
 end

build_tests/configure/error_env_process_before_configure.rb

@@ -0,0 +1,4 @@
+Environment.new do |env|
+  env.Object("simple.o", "simple.cc")
+  env.process
+end

build_tests/configure/multiple_set_define.rb

@@ -3,6 +3,8 @@ configure do
   check_c_header "stdio.h", set_define: "HAVE_STDIO_H"
 end
 
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env.Object("simple.o", "simple.c")
+  end
 end

build_tests/custom_builder/Rsconscript

@@ -9,8 +9,10 @@ EOF
   end
 end
 
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.add_builder(MySource.new)
     env.MySource('inc.h', [])
     env.Program('program.exe', Dir['*.c'])
+  end
 end

build_tests/custom_builder/build_after.rb

@@ -1,4 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Command("inc.c",
                 [],
                 "CMD" => %w[ruby gen.rb ${_TARGET}],
@@ -7,4 +8,5 @@ Rscons::Environment.new do |env|
     env["inc_c"] = "inc.c"
     env.build_after("${build_root}/program.o", "${inc_c}")
     env.Program("program.exe", ["program.c", "inc.c"])
+  end
 end

build_tests/custom_builder/cvar_expansion.rb

@@ -9,10 +9,12 @@ EOF
   end
 end
 
-env = Rscons::Environment.new do |env|
+build do
+  env = Rscons::Environment.new do |env|
     env["hdr"] = "inc.h"
     env["src"] = "program.c"
     env.add_builder(MySource.new)
     env.MySource('${hdr}')
     env.Program('program.exe', "${src}")
+  end
 end

build_tests/custom_builder/cvar_lambda.rb

@@ -9,7 +9,8 @@ EOF
   end
 end
 
-e1 = Rscons::Environment.new do |env|
+build do
+  e1 = Rscons::Environment.new do |env|
     env.add_builder(MySource.new)
     env["one"] = "5"
     env[:cfg] = {val: "9"}
@@ -19,10 +20,11 @@ e1 = Rscons::Environment.new do |env|
     env["the_value"] = lambda do |args|
       "${one}${two}78"
     end
-end
+  end
 
-e1.clone do |env|
+  e1.clone do |env|
     env[:cfg][:val] = "6"
     env.MySource('inc.h', [])
     env.Program('program.exe', Dir['*.c'])
+  end
 end

build_tests/custom_builder/multiple_targets.rb

@@ -12,8 +12,10 @@ class CHGen < Rscons::Builder
   end
 end
 
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.add_builder(CHGen.new)
     env.CHGen("inc.c", ["program.c"])
     env.Program("program.exe", %w[program.c inc.c])
+  end
 end

build_tests/custom_builder/produces.rb

@@ -1,4 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["build_root"] = env.build_root
     env["inc_h"] = "inc.h"
 
@@ -11,4 +12,5 @@ Rscons::Environment.new do |env|
                 "CMD" => %w[ruby gen.rb ${_TARGET}],
                 "CMD_DESC" => "Generating")
     env.produces("inc.c", "inc.h")
+  end
 end

build_tests/d/Rsconscript

@@ -1,3 +1,5 @@
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env.Program("hello-d.exe", Rscons.glob("*.d"))
+  end
 end

build_tests/header/Rsconscript

@@ -1,3 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Program('header.exe', Dir['*.c'])
+  end
 end

build_tests/json_to_yaml/Rsconscript

@@ -1,4 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     require 'json'
     require 'yaml'
     env.add_builder(:JsonToYaml) do |target, sources, cache, env, vars|
@@ -12,4 +13,5 @@ Rscons::Environment.new do |env|
       target
     end
     env.JsonToYaml('foo.yml', 'foo.json')
+  end
 end

build_tests/library/Rsconscript

@@ -1,4 +1,6 @@
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env.Program('library.exe', ['lib.a', 'three.c'])
     env.Library("lib.a", ['one.c', 'two.c'], 'CPPFLAGS' => ['-Dmake_lib'])
+  end
 end

build_tests/library/override_arcmd.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env["ARCMD"] = %w[ar rcf ${_TARGET} ${_SOURCES}]
     env.Library("lib.a", Rscons.glob("*.c"))
+  end
 end

build_tests/preprocess/Rsconscript

@@ -1,3 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Preprocess("pp", "foo.h")
+  end
 end

build_tests/shared_library/Rsconscript

@@ -1,4 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["CPPPATH"] << "src/lib"
     libmine = env.SharedLibrary("mine", Rscons.glob("src/lib/*.c"))
     env.Program("test-shared.exe",
@@ -8,4 +9,5 @@ Rscons::Environment.new do |env|
     env.build_after("test-shared.exe", libmine.to_s)
     env.Program("test-static.exe",
                 Rscons.glob("src/**/*.c"))
+  end
 end

build_tests/shared_library/error_unknown_suffix.rb

@@ -1,6 +1,8 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     File.open("foo.xyz", "wb") do |fh|
       fh.puts("hi")
     end
     env.SharedObject("foo.o", "foo.xyz")
+  end
 end

build_tests/shared_library/shared_library_cxx.rb

@@ -1,4 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["CPPPATH"] << "src/lib"
     libmine = env.SharedLibrary("mine", Rscons.glob("src/lib/*.cc"))
     env.Program("test-shared.exe",
@@ -8,4 +9,5 @@ Rscons::Environment.new do |env|
     env.build_after("test-shared.exe", libmine.to_s)
     env.Program("test-static.exe",
                 Rscons.glob("src/**/*.cc"))
+  end
 end

build_tests/shared_library/shared_library_d.rb

@@ -1,4 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["CPPPATH"] << "src/lib"
     libmine = env.SharedLibrary("mine", Rscons.glob("src/lib/*.d"))
     env.Program("test-shared.exe",
@@ -6,4 +7,5 @@ Rscons::Environment.new do |env|
                 "LIBPATH" => %w[.],
                 "LIBS" => %w[mine])
     env.build_after("test-shared.exe", libmine.to_s)
+  end
 end

build_tests/shared_library/shared_library_set_shld.rb

@@ -1,4 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["CPPPATH"] << "src/lib"
     env["SHLD"] = "gcc"
     libmine = env.SharedLibrary("mine", Rscons.glob("src/lib/*.c"))
@@ -9,4 +10,5 @@ Rscons::Environment.new do |env|
     env.build_after("test-shared.exe", libmine.to_s)
     env.Program("test-static.exe",
                 Rscons.glob("src/**/*.c"))
+  end
 end

build_tests/simple/Rsconscript

@@ -1,3 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Program('simple.exe', Dir['*.c'])
+  end
 end

build_tests/simple/absolute_source_path.rb

@@ -1,4 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     tempdir = ENV["TEMP"] || ENV["TMP"] || "/tmp"
     source_file = File.join(tempdir, "abs.c")
     File.open(source_file, "w") do |fh|
@@ -10,4 +11,5 @@ Rscons::Environment.new do |env|
       EOF
     end
     env.Program("abs.exe", source_file)
+  end
 end

build_tests/simple/bc_produces.rb

@@ -12,7 +12,8 @@ class MyObject < Rscons::Builder
   end
 end
 
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.add_builder(MyObject.new)
     File.open("test.xyz", "w") do |fh|
       fh.puts <<EOF
@@ -25,4 +26,5 @@ int main(int argc, char * argv[])
 EOF
     env.Program("test", "test.xyz")
     end
+  end
 end

build_tests/simple/build_sources.rb

@@ -8,7 +8,8 @@ class MyProgram < Rscons::Builder
   end
 end
 
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.add_builder(MyProgram.new)
     env.Object("simple.o", "simple.c")
     File.open("two.c", "wb") do |fh|
@@ -19,4 +20,5 @@ Rscons::Environment.new do |env|
       EOF
     end
     env.MyProgram("simple.exe", ["simple.o", "two.c"])
+  end
 end

build_tests/simple/builder_no_sources.rb

@@ -3,7 +3,9 @@ class TestBuilder < Rscons::Builder
     target
   end
 end
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.add_builder(TestBuilder.new)
     env.TestBuilder("file")
+  end
 end

build_tests/simple/cache_command_change.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["LIBS"] += ["c"]
     env.Program('simple.exe', Dir['*.c'])
+  end
 end

build_tests/simple/cache_debugging.rb

@@ -25,10 +25,12 @@ class DebugBuilder < Rscons::Builder
   end
 end
 
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.add_builder(DebugBuilder.new)
     if Rscons.vars["new_user_dep"]
       env.depends("foo.o", "new_dep")
     end
     env.DebugBuilder("foo.o", "simple.c")
+  end
 end

build_tests/simple/cache_dep_checksum_change.rb

@@ -1,3 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Copy("simple.copy", "simple.c")
+  end
 end

build_tests/simple/cache_new_dep1.rb

@@ -1,6 +1,8 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Object("simple.o", "simple.c")
     env.process
     env["LDCMD"] = %w[gcc -o ${_TARGET} simple.o]
     env.Program('simple.exe', [])
+  end
 end

build_tests/simple/cache_new_dep2.rb

@@ -1,5 +1,7 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Object("simple.o", "simple.c")
     env["LDCMD"] = %w[gcc -o ${_TARGET} simple.o]
     env.Program('simple.exe', ["simple.o"])
+  end
 end

build_tests/simple/cache_successful_builds_when_one_fails.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Object("simple.o", "simple.c")
     env.Object("two.o", "two.c")
+  end
 end

build_tests/simple/cache_user_dep.rb

@@ -1,5 +1,7 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     target = env.Program("simple.exe", "simple.c")
     user_deps = File.read("user_deps", mode: "rb").split(" ")
     target.depends(*user_deps)
+  end
 end

build_tests/simple/cache_varset.rb

@@ -14,7 +14,9 @@ class TestBuilder < Rscons::Builder
   end
 end
 
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.add_builder(TestBuilder.new)
     env.TestBuilder("foo")
+  end
 end

build_tests/simple/clear_targets.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Program("simple.exe", "simple.c")
     env.clear_targets
+  end
 end

build_tests/simple/clone_n_threads.rb

@@ -1,7 +1,9 @@
-base_env = Rscons::Environment.new do |env|
+build do
+  base_env = Rscons::Environment.new do |env|
     env.n_threads = 165
+  end
+
+  my_env = base_env.clone
+
+  puts my_env.n_threads
 end
-
-my_env = base_env.clone
-
-puts my_env.n_threads

build_tests/simple/command.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env["LD"] = "gcc"
     env.Program('simple.exe', Dir['*.c'])
+  end
 end

build_tests/simple/command_builder.rb

@@ -1,7 +1,9 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     command = %W[gcc -o ${_TARGET} ${_SOURCES}]
     env.Command("simple.exe",
                 "simple.c",
                 "CMD" => command,
                 "CMD_DESC" => "BuildIt")
+  end
 end

build_tests/simple/command_redirect.rb

@@ -1,8 +1,10 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Object("simple.o", "simple.c")
     env.Command("simple.txt",
                 "simple.o",
                 "CMD" => %w[objdump --disassemble --source ${_SOURCES}],
                 "CMD_STDOUT" => "${_TARGET}",
                 "CMD_DESC" => "My Disassemble")
+  end
 end

build_tests/simple/cvar_array.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["sources"] = Rscons.glob("*.c")
     env.Program("simple.exe", "${sources}")
+  end
 end

build_tests/simple/directory.rb

@@ -1,3 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Directory("teh_dir")
+  end
 end

build_tests/simple/disassemble.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Object("simple.o", "simple.c")
     env.Disassemble("simple.txt", "simple.o")
+  end
 end

build_tests/simple/dump.rb

@@ -1,5 +1,7 @@
-env = Rscons::Environment.new do |env|
+build do
+  env = Rscons::Environment.new do |env|
     env["CFLAGS"] += %w[-O2 -fomit-frame-pointer]
     env[:foo] = :bar
+  end
+  env.dump
 end
-env.dump

build_tests/simple/error_circular_dependency.rb

@@ -1,5 +1,7 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Command("foo", "bar")
     env.Command("bar", "baz")
     env.Command("baz", "foo")
+  end
 end

build_tests/simple/error_circular_dependency2.rb

@@ -1,3 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Command("foo", "foo")
+  end
 end

build_tests/simple/error_unknown_suffix.rb

@@ -1,6 +1,8 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     File.open("foo.xyz", "wb") do |fh|
       fh.puts("hi")
     end
     env.Object("foo.o", "foo.xyz")
+  end
 end

build_tests/simple/link_flag_change.rb

@@ -1,5 +1,7 @@
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env["LD"] = "gcc"
     env["LIBPATH"] += ["libdir"]
     env.Program('simple.exe', Dir['*.c'])
+  end
 end

build_tests/simple/override_cccmd.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env.Object("simple.o", "simple.c",
                "CCCMD" => %w[${CC} -c -o ${_TARGET} -Dfoobar ${_SOURCES}])
+  end
 end

build_tests/simple/override_depfilesuffix.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env["DEPFILESUFFIX"] = ".deppy"
     env.Object("simple.o", "simple.c")
+  end
 end

build_tests/simple/phony_target.rb

@@ -1,4 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.add_builder(:Checker) do |target, sources, cache, env, vars|
       unless cache.up_to_date?(target, :Checker, sources, env)
         puts "Checker #{sources.first}" if env.echo != :off
@@ -8,4 +9,5 @@ Rscons::Environment.new do |env|
     end
     env.Program("simple.exe", "simple.c")
     env.Checker(:checker, "simple.exe")
+  end
 end

build_tests/simple/preprocess.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Preprocess("simplepp.c", "simple.c")
     env.Program("simple.exe", "simplepp.c")
+  end
 end

build_tests/simple/progsuffix.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["PROGSUFFIX"] = ".out"
     env.Program("simple", Dir["*.c"])
+  end
 end

build_tests/simple/progsuffix2.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["MYSUFFIX"] = ".out"
     env.Program("simple${MYSUFFIX}", Dir["*.c"])
+  end
 end

build_tests/simple/progsuffix3.rb

@@ -1,3 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Program("simple", Dir["*.c"], "PROGSUFFIX" => ".xyz")
+  end
 end

build_tests/simple/register_target_in_build_hook.rb

@@ -1,8 +1,10 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Program("simple.exe", Dir["*.c"])
     env.add_build_hook do |build_op|
       if build_op[:target].end_with?(".o")
         env.Disassemble("#{build_op[:target]}.txt", build_op[:target])
       end
     end
+  end
 end

build_tests/simple/run_builder.rb

@@ -5,8 +5,10 @@ class MyObject < Rscons::Builder
   end
 end
 
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.add_builder(MyObject.new)
     env.MyObject("simple.o", "simple.c")
     env.Program("simple.exe", "simple.o")
+  end
 end

build_tests/simple/standard_build.rb

@@ -1,4 +1,5 @@
-class MyCommand < Rscons::Builder
+build do
+  class MyCommand < Rscons::Builder
     def run(target, sources, cache, env, vars)
       vars = vars.merge({
         "_TARGET" => target,
@@ -8,10 +9,11 @@ class MyCommand < Rscons::Builder
       cmd_desc = vars["CMD_DESC"] || "MyCommand"
       standard_build("#{cmd_desc} #{target}", target, command, sources, env, cache)
     end
-end
+  end
 
-Rscons::Environment.new do |env|
+  Rscons::Environment.new do |env|
     env.add_builder(MyCommand.new)
     command = %w[gcc -c -o ${_TARGET} ${_SOURCES}]
     env.MyCommand("simple.o", "simple.c", "CMD" => command)
+  end
 end

build_tests/simple/threading.rb

@@ -18,11 +18,13 @@ class NonThreadedTestBuilder < Rscons::Builder
   end
 end
 
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.add_builder(ThreadedTestBuilder.new)
     env.add_builder(NonThreadedTestBuilder.new)
     env.ThreadedTestBuilder("a")
     env.ThreadedTestBuilder("b")
     env.ThreadedTestBuilder("c")
     env.NonThreadedTestBuilder("d")
+  end
 end

build_tests/simple/user_dep_build_order.rb

@@ -14,9 +14,11 @@ class TestBuilder < Rscons::Builder
   end
 end
 
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.add_builder(TestBuilder.new)
     env.TestBuilder("one", [], "wait_time" => "3")
     env.TestBuilder("two", [], "wait_time" => "0")
     env.depends("two", "one")
+  end
 end

build_tests/simple/user_dependencies.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     program = env.Program("simple.exe", Dir["*.c"])
     env.depends(program, "program.ld")
+  end
 end

build_tests/simple/wait_for_builds_on_failure.rb

@@ -11,10 +11,12 @@ class Fail < Rscons::Builder
   end
 end
 
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.add_builder(Fail.new)
     4.times do |i|
       wait_time = i + 1
       env.Fail("foo_#{wait_time}", [], "wait_time" => wait_time.to_s)
     end
+  end
 end

build_tests/simple_cc/Rsconscript

@@ -1,3 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Program('simple.exe', Dir['*.cc'])
+  end
 end

build_tests/simple_cc/cxxsuffix.rb

@@ -1,5 +1,7 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["CXXSUFFIX"] = %w[.cccc .cc]
     env["CXXFLAGS"] += %w[-x c++]
     env.Program("simple.exe", Dir["*.cc"] + Dir["*.cccc"])
+  end
 end

build_tests/simple_cc/preprocess.rb

@@ -1,4 +1,6 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Preprocess("simplepp.cc", "simple.cc")
     env.Program("simple.exe", "simplepp.cc")
+  end
 end

build_tests/two_sources/Rsconscript

@@ -1,4 +1,6 @@
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env.Object("one.o", "one.c", 'CPPFLAGS' => ['-DONE'])
     env.Program('two_sources.exe', ['one.o', 'two.c'])
+  end
 end

build_tests/two_sources/assuffix.rb

@@ -1,7 +1,9 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["ASSUFFIX"] = %w[.ssss .sss]
     env["CFLAGS"] += %w[-S]
     env.Object("one.ssss", "one.c", "CPPFLAGS" => ["-DONE"])
     env.Object("two.sss", "two.c")
     env.Program("two_sources.exe", %w[one.ssss two.sss], "ASFLAGS" => env["ASFLAGS"] + %w[-x assembler])
+  end
 end

build_tests/two_sources/cache_strict_deps.rb

@@ -10,10 +10,12 @@ class StrictBuilder < Rscons::Builder
   end
 end
 
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env.add_builder(StrictBuilder.new)
     env.Object("one.o", "one.c", "CCFLAGS" => %w[-DONE])
     env.Object("two.o", "two.c")
     sources = File.read("sources", mode: "rb").split(" ")
     env.StrictBuilder("program.exe", sources)
+  end
 end

build_tests/two_sources/libsuffix.rb

@@ -1,6 +1,8 @@
-Rscons::Environment.new() do |env|
+build do
+  Rscons::Environment.new() do |env|
     env["LIBSUFFIX"] = %w[.aaaa .aaa]
     env.Library("one.aaaa", "one.c", "CPPFLAGS" => ["-DONE"])
     env.Library("two.aaa", "two.c")
     env.Program("two_sources.exe", %w[one.aaaa two.aaa])
+  end
 end

build_tests/two_sources/objsuffix.rb

@@ -1,6 +1,8 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["OBJSUFFIX"] = %w[.oooo .ooo]
     env.Object("one.oooo", "one.c", "CPPFLAGS" => ["-DONE"])
     env.Object("two.ooo", "two.c")
     env.Program("two_sources.exe", %w[one.oooo two.ooo])
+  end
 end

build_tests/typical/backward_compatible_build_hooks.rb

@@ -4,7 +4,8 @@ class MyObject < Rscons::Builder
   end
 end
 
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env.add_builder(MyObject.new)
     env.append('CPPPATH' => Rscons.glob('src/**'))
     env.add_build_hook do |build_op|
@@ -19,4 +20,5 @@ Rscons::Environment.new(echo: :command) do |env|
     end
     env.MyObject('one.o', 'src/one/one.c')
     env.MyObject('two.o', 'src/two/two.c')
+  end
 end

build_tests/typical/build_hooks.rb

@@ -1,4 +1,5 @@
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env.append('CPPPATH' => Rscons.glob('src/**/*/'))
     env.add_build_hook do |build_op|
       if File.basename(build_op[:target]) == "one.o"
@@ -8,4 +9,5 @@ Rscons::Environment.new(echo: :command) do |env|
       end
     end
     env.Program('build_hook.exe', Rscons.glob('src/**/*.c'))
+  end
 end

build_tests/typical/carat.rb

@@ -1,7 +1,9 @@
-Rscons::Environment.new(echo: :command) do |env|
+build do
+  Rscons::Environment.new(echo: :command) do |env|
     env.append('CPPPATH' => Rscons.glob('src/**').sort)
     FileUtils.mkdir_p(env.build_root)
     FileUtils.mv("src/one/one.c", env.build_root)
     env.Object("^/one.o", "^/one.c")
     env.Program("program.exe", Rscons.glob('src/**/*.c') + ["^/one.o"])
+  end
 end

build_tests/typical/copy.rb

@@ -1,3 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Copy("inst.exe", "copy.rb")
+  end
 end

build_tests/typical/csuffix.rb

@@ -1,6 +1,8 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["CSUFFIX"] = %w[.yargh .c]
     env["CFLAGS"] += %w[-x c]
     env["CPPPATH"] += Rscons.glob("src/**")
     env.Program("program.exe", Rscons.glob("src/**/*.{c,yargh}"))
+  end
 end

build_tests/typical/echo_command_ruby_builder.rb

@@ -1,5 +1,7 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.echo = :command
     env.Install("inst.exe", "install.rb")
-end
+  end
 
+end

build_tests/typical/echo_command_string.rb

@@ -6,8 +6,10 @@ class MyBuilder < Rscons::Builder
   end
 end
 
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.echo = :command
     env.add_builder(MyBuilder.new)
     env.MyBuilder("foo")
+  end
 end

build_tests/typical/install.rb

@@ -1,3 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Install("inst.exe", "install.rb")
+  end
 end

build_tests/typical/install_directory.rb

@@ -1,4 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env.Directory("inst")
     env.Install("inst", "install_directory.rb")
 
@@ -6,4 +7,5 @@ Rscons::Environment.new do |env|
 
     env.Directory("exist/src")
     env.Install("exist/src", "src")
+  end
 end

build_tests/typical/multiple_targets_same_name.rb

@@ -1,5 +1,7 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["CPPPATH"] << "src/two"
     env.Object("one.o", "src/one/one.c")
     env.Object("one.o", "src/two/two.c")
+  end
 end

build_tests/typical/post_build_hook_expansion.rb

@@ -1,4 +1,5 @@
-Rscons::Environment.new do |env|
+build do
+  Rscons::Environment.new do |env|
     env["CPPPATH"] << "src/two"
     env.Object("one.o", "src/one/one.c")
     env.add_post_build_hook do |build_op|
@@ -7,4 +8,5 @@ Rscons::Environment.new do |env|
         env.Object("${MODULE}.o", "src/${MODULE}/${MODULE}.c")
       end
     end
+  end
 end

lib/rscons/application.rb

@@ -68,6 +68,7 @@ module Rscons
     #   Exit code.
     def build(options)
       begin
+        @script.build
         Environment.environments.each do |env|
           env.process
         end

lib/rscons/environment.rb

@@ -15,6 +15,11 @@ module Rscons
       #   All Environments.
       attr_reader :environments
 
+      # Initialize class instance variables.
+      def class_init
+        @environments = []
+      end
+
       # Get an ID for a new Environment. This is a monotonically increasing
       # integer.
       #
@@ -77,8 +82,7 @@ module Rscons
         end
       end
       @echo = options[:echo] || :short
-      # TODO: remove the || "build" below when autoconf is turned on for build test specs
+      @build_root = "#{Cache.instance.configuration_data["build_dir"]}/e.#{@id}"
-      @build_root = "#{Cache.instance.configuration_data["build_dir"] || "build"}/e.#{@id}"
       load_configuration_data!
 
       if block_given?
@@ -273,6 +277,9 @@ module Rscons
     # @return [void]
     def process
       cache = Cache.instance
+      unless cache.configuration_data["configured"]
+        raise "Project must be configured before processing an Environment"
+      end
       failure = nil
       begin
         while @job_set.size > 0 or @threaded_commands.size > 0
@@ -1083,4 +1090,6 @@ module Rscons
     end
 
   end
+
+  Environment.class_init
 end

lib/rscons/script.rb

@@ -19,6 +19,11 @@ module Rscons
         @script.autoconf = autoconf
       end
 
+      # Enter build block.
+      def build(&block)
+        @script.operations["build"] = block
+      end
+
       # Enter configuration block.
       def configure(&block)
         @script.operations["configure"] = block
@@ -81,6 +86,13 @@ module Rscons
       Dsl.new(self).instance_eval(script_contents, path, 1)
     end
 
+    # Perform build operation.
+    def build
+      if build_proc = @operations["build"]
+        build_proc.call
+      end
+    end
+
     # Perform configure operation.
     def configure(configure_op)
       if operation_lambda = @operations["configure"]

spec/build_tests_spec.rb

@@ -1886,6 +1886,13 @@ EOF
       expect(result.stdout).to match /Checking for C compiler\.\.\. not found/
       expect(result.status).to_not eq 0
     end
+
+    it "exits with an error if configuration has not been performed before attempting to process an environment" do
+      test_dir "configure"
+      result = run_rscons(rsconscript: "error_env_process_before_configure.rb")
+      expect(result.stderr).to match /Project must be configured before processing an Environment/
+      expect(result.status).to_not eq 0
+    end
   end
 
 end