pax_global_header00006660000000000000000000000064132546323120014513gustar00rootroot0000000000000052 comment=c963dc0e96b4454665fa5be2ead04181426fd220 rake-12.3.1/000077500000000000000000000000001325463231200125215ustar00rootroot00000000000000rake-12.3.1/.gitignore000066400000000000000000000001351325463231200145100ustar00rootroot00000000000000*.bak *.rbc *.swp *~ .#* .DS_Store .idea .rbx /.rdoc /TAGS /coverage /html /pkg Gemfile.lock rake-12.3.1/.rubocop.yml000066400000000000000000000015301325463231200147720ustar00rootroot00000000000000AllCops: TargetRubyVersion: 2.3 DisabledByDefault: true Exclude: - doc/**/*.rb - rake.gemspec Metrics/LineLength: Enabled: true Max: 120 Style/HashSyntax: Enabled: true Style/StringLiterals: Enabled: true EnforcedStyle: double_quotes Style/MultilineIfThen: Enabled: true Style/MethodDefParentheses: Enabled: true Style/BracesAroundHashParameters: Enabled: true Layout/IndentationWidth: Enabled: true Layout/Tab: Enabled: true Layout/EmptyLines: Enabled: true Layout/TrailingBlankLines: Enabled: true Layout/TrailingWhitespace: Enabled: true Layout/SpaceBeforeBlockBraces: Enabled: true Layout/SpaceInsideBlockBraces: Enabled: true Layout/SpaceInsideHashLiteralBraces: Enabled: true Layout/CaseIndentation: Enabled: true Layout/EndAlignment: Enabled: true EnforcedStyleAlignWith: variable rake-12.3.1/.travis.yml000066400000000000000000000003451325463231200146340ustar00rootroot00000000000000language: ruby sudo: false rvm: - 2.0.0 - 2.1.10 - 2.2.9 - 2.3.6 - 2.4.3 - 2.5.0 - ruby-head - jruby-9.1.16.0 - jruby-head before_script: - unset JRUBY_OPTS - unset _JAVA_OPTIONS script: ruby -Ilib exe/rake rake-12.3.1/CONTRIBUTING.rdoc000066400000000000000000000021111325463231200152740ustar00rootroot00000000000000= Source Repository Rake is currently hosted at github. The github web page is https://github.com/ruby/rake . The public git clone URL is git://github.com/ruby/rake.git = Running the Rake Test Suite If you wish to run the unit and functional tests that come with Rake: * +cd+ into the top project directory of rake. * Install gem dependency using bundler: bundle install # Install bundler, minitest and rdoc * Type one of the following: rake # If you have run rake's tests = Issues and Bug Reports Feel free to submit commits or feature requests. If you send a patch, remember to update the corresponding unit tests. In fact, I prefer new feature to be submitted in the form of new unit tests. For other information, feel free to ask on the ruby-talk mailing list. If you have found a bug in rake please try with the latest version of rake before filing an issue. Also check History.rdoc for bug fixes that may have addressed your issue. When submitting pull requests please check the rake Travis-CI page for test failures: https://travis-ci.org/ruby/rake rake-12.3.1/Gemfile000066400000000000000000000000471325463231200140150ustar00rootroot00000000000000source "https://rubygems.org" gemspec rake-12.3.1/History.rdoc000066400000000000000000002116111325463231200150350ustar00rootroot00000000000000=== 12.3.1 ==== Bug fixes * Support did_you_mean >= v1.2.0 which has a breaking change on formatters. Pull request #262 by FUJI Goro. ==== Enhancements: * Don't run task if it depends on already invoked but failed task. Pull request #252 by Gonzalo Rodriguez. * Make space trimming consistent for all task arguments. Pull request #259 by Gonzalo Rodriguez. * Removes duplicated inclusion of Rake::DSL in tests. Pull request #254 by Gonzalo Rodriguez. * Re-raise a LoadError that didn't come from require in the test loader. Pull request #250 by Dylan Thacker-Smith. === 12.3.0 ==== Compatibility Changes * Bump `required_ruby_version` to Ruby 2.0.0. Rake has already removed support for Ruby 1.9.x. ==== Enhancements: * Support `test-bundled-gems` task on ruby core. === 12.2.1 ==== Bug fixes * Fixed to break Capistrano::Application on capistrano3. === 12.2.0 ==== Enhancements: * Make rake easier to use as a library Pull request #211 by @drbrain * Fix quadratic performance in FileTask#out_of_date? Pull request #224 by @doudou * Clarify output when printing nested exception traces Pull request #232 by @urbanautomaton ==== Bug fixes * Account for a file that match 2 or more patterns. Pull request #231 by @styd === 12.1.0 ==== Enhancements: * Added did_you_mean feature for invalid rake task. Pull request #221 by @xtina-starr * Enabled to dependency chained by extensions. Pull request #39 by Petr Skocik. * Make all of string literals to frozen objects on Ruby 2.4 or later. ==== Bug fixes * Typo fixes in rakefile.rdoc. Pull request #180 by Yuta Kurotaki. * Fix unexpected behavior of file task with dryrun option. Pull request #183 by @aycabta. * Make LoadError from running tests more obvious. Pull request #195 by Eric Hodel. * Fix unexpected TypeError with hash style option. Pull request #202 by Kuniaki IGARASHI. === 12.0.0 ==== Compatibility Changes * Removed arguments on clear #157 by Jesse Bowes * Removed `rake/contrib` packages. These are extracted to `rake-contrib` gem. * Removed deprecated method named `last\_comment`. ==== Enhancements: * Re-use trace option on `cleanup` task. #164 by Brian Henderson * Actions adore keyword arguments #174 by Josh Cheek * Rake::TaskArguments#key? alias of #has_key? #175 by Paul Annesley === 11.3.0 / 2016-09-20 ==== Enhancements: * Remove to reference `Fixnum` constant. Pull request #160 by nobu === 11.2.2 / 2016-06-12 ==== Bug fixes * Fix unexpected behavior with multiple dependencies on Rake::TestTask === 11.2.1 / 2016-06-12 ==== Bug fixes * Fix regression of dependencies handling on Rake::TestTask. Report #139 === 11.2.0 / 2016-06-11 ==== Bug fixes * Fix unexpected cut-out behavior on task description using triple dots and exclamation. Report #106 from Stephan Kämper and Pull request #134 by Lee * Fix empty argument assignment with `with_defaults` option. Pull request #135 by bakunyo * Ignore to use `hwprefs` on Darwin platform. Use sysctl now. Report #128 ==== Enhancements * Spawn options for sh Pull equest #138 by Eric Hodel. * Allow to specify dependencies(prerequisites) for Rake::TestTask Pull request #117 by Tim Maslyuchenko * Use Bundler task instead of hoe for gem release. * Remove explicitly load to rubygems for Ruby 1.8. * Unify to declare `Rake::VERSION`. * Support xz format for PackageTask. === 11.1.2 / 2016-03-28 ==== Bug fixes * Remove `-W` option when Rake::TestTask#verbose enabled. It's misunderstanding specification change with Rake 11. Partly revert #67 === 11.1.1 / 2016-03-14 ==== Bug fixes * Use `-W` instead of `--verbose` when Rake::TestTask#verbose enabled. JRuby doesn't have `--verbose` option. === 11.1.0 / 2016-03-11 ==== Compatibility Changes * Revert to remove `last\_comment`. It will remove Rake 12. === 11.0.1 / 2016-03-09 ==== Bug fixes * Fixed packaging manifest. === 11.0.0 / 2016-03-09 ==== Bug fixes * Correctly handle bad encoding in exception messages. Pull request #113 by Tomer Brisker * Fix verbose option at TestTask. Pull request #67 by Mike Blumtritt ==== Enhancements * Make FileList#exclude more analogous to FileList#include. * Use IO.open instead of Open3.popen3 for CPU counter. * Make Rake::Task#already_invoked publicly accessible. Pull request #93 by Joe Rafaniello * Lookup prerequisites with same name outside of scope instead of matching self. Pull request #96 by Sandy Vanderbleek * Make FileList#pathmap behave like String#pathmap. Pull request #61 by Daniel Tamai * Add fetch method to task arguments. Pull request #12 by Chris Keathley * Use ruby warnings by default. Pull request #97 by Harold Giménez ==== Compatibility Changes * Removed to support Ruby 1.8.x * Removed constant named `RAKEVERSION` * Removed Rake::AltSystem * Removed Rake::RubyForgePublisher * Removed Rake::TaskManager#last\_comment. Use last\_description. * Removed Rake::TaskLib#paste * Removed Top-level SshDirPublisher, SshFreshDirPublisher, SshFilePublisher and CompositePublisher from lib/rake/contrib/publisher.rb * Removed "rake/runtest.rb" === 10.5.0 / 2016-01-13 ==== Enhancements * Removed monkey patching for Ruby 1.8. Pull request #46 by Pablo Herrero. * Inheritance class of Rake::FileList returns always self class. Pull request #74 by Thomas Scholz === 10.4.2 / 2014-12-02 ==== Bug fixes * Rake no longer edits ARGV. This allows you to re-exec rake from a rake task. Pull requset #9 by Matt Palmer. * Documented how Rake::DSL#desc handles sentences in task descriptions. Issue #7 by Raza Sayed. * Fixed test error on 1.9.3 with legacy RubyGems. Issue #8 by Matt Palmer. * Deleted duplicated History entry. Pull request #10 by Yuji Yamamoto. === 10.4.1 / 2014-12-01 ==== Bug fixes * Reverted fix for #277 as it caused numerous issues for rake users. rails/spring issue #366 by Gustavo Dutra. === 10.4.0 / 2014-11-22 ==== Enhancements * Upgraded to minitest 5. Pull request #292 by Teo Ljungberg. * Added support for Pathname in rake tasks. Pull request #271 by Randy Coulman. * Rake now ignores falsy dependencies which allows for easier programmatic creation of tasks. Pull request #273 by Manav. * Rake no longer edits ARGV. This allows you to re-exec rake from a rake task. Issue #277 by Matt Palmer. * Etc.nprocessors is used for counting the number of CPUs. ==== Bug fixes * Updated rake manpage. Issue #283 by Nathan Long, pull request #291 by skittleys. * Add Rake::LATE to allow rebuilding of files that depend on deleted files. Bug #286, pull request #287 by David Grayson. * Fix relinking of files when repackaging. Bug #276 by Muenze. * Fixed some typos. Pull request #280 by Jed Northridge. * Try counting CPUs via cpuinfo if host_os was not matched. Pull request #282 by Edouard B. === 10.3.2 / 2014-05-15 ==== Bug fixes * Rake no longer infinitely loops when showing exception causes that refer to each other. Bug #272 by Chris Bandy. * Fixed documentation typos. Bug #275 by Jake Worth. === 10.3.1 / 2014-04-17 ==== Bug fixes * Really stop reporting an error when cleaning already-deleted files. Pull request #269 by Randy Coulman * Fixed infinite loop when cleaning already-deleted files on windows. === 10.3 / 2014-04-15 ==== Enhancements * Added --build-all option to rake which treats all file prerequisites as out-of-date. Pull request #254 by Andrew Gilbert. * Added Rake::NameSpace#scope. Issue #263 by Jon San Miguel. ==== Bug fixes * Suppress org.jruby package files in rake error messages for JRuby users. Issue #213 by Charles Nutter. * Fixed typo, removed extra "h". Pull request #267 by Hsing-Hui Hsu. * Rake no longer reports an error when cleaning already-deleted files. Pull request #266 by Randy Coulman. * Consume stderr while determining CPU count to avoid hang. Issue #268 by Albert Sun. === 10.2.2 / 2014-03-27 ==== Bug fixes * Restored Ruby 1.8.7 compatibility === 10.2.1 / 2014-03-25 ==== Bug fixes * File tasks including a ':' are now top-level tasks again. Issue #262 by Josh Holtrop. * Use sysctl for CPU count for all BSDs. Pull request #261 by Joshua Stein. * Fixed CPU detection for unknown platforms. === 10.2.0 / 2014-03-24 ==== Enhancements * Rake now requires Ruby 1.9 or newer. For me, this is a breaking change, but it seems that Jim planned to release it with Rake 10.2. See also pull request #247 by Philip Arndt. * Rake now allows you to declare tasks under a namespace like: task 'a:b' do ... end Pull request #232 by Judson Lester. * Task#source defaults to the first prerequisite in non-rule tasks. Pull request #215 by Avdi Grimm. * Rake now automatically rebuilds and reloads imported files. Pull request #209 by Randy Coulman. * The rake task arguments can contain escaped commas. Pull request #214 by Filip Hrbek. * Rake now prints the exception class on errors. Patch #251 by David Cornu. ==== Bug fixes * Fixed typos. Pull request #256 by Valera Rozuvan, #250 via Jake Worth, #260 by Zachary Scott. * Fixed documentation for calling tasks with arguments. Pull request #235 by John Varghese. * Clarified `rake -f` usage message. Pull request #252 by Marco Pfatschbacher. * Fixed a test failure on windows. Pull request #231 by Hiroshi Shirosaki. * Fixed corrupted rake.1.gz. Pull request #225 by Michel Boaventura. * Fixed bug in can\_detect\_signals? in test. Patch from #243 by Alexey Borzenkov. === 10.1.1 * Use http://github.com/jimweirich/rake instead of http://rake.rubyforge.org for canonical project url. === 10.1.0 ==== Changes ===== New Features * Add support for variable length task argument lists. If more actual arguments are supplied than named arguments, then the extra arguments values will be in args.extras. * Application name is not displayed in the help banner. (Previously "rake" was hardcoded, now rake-based applications can display their own names). ===== Bug Fixes Bug fixes include: * Fix backtrace suppression issues. * Rules now explicit get task arguments passed to them. * Rename FileList#exclude? to FileList#exclude\_from\_list? to avoid conflict with new Rails method. * Clean / Clobber tasks now report failure to remove files. * Plus heaps of internal code cleanup. ==== Thanks As usual, it was input from users that drove a lot of these changes. The following people contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Michael Nikitochkin (general code cleanup) * Vipul A M (general code cleanup) * Dennis Bell (variable length task argument lists) * Jacob Swanner (rules arguments) * Rafael Rosa Fu (documentation typo) * Stuart Nelson (install.rb fixes) * Lee Hambley (application name in help banner) -- Jim Weirich === 10.0.3 "Jim, when will Rake reach version 1.0?" Over the past several years I've been asked that question at conferences, panels and over twitter. Due to historical reasons (or maybe just plain laziness) Rake has (incorrectly) been treating the second digit of the version as the major release number. So in my head Rake was already at version 9. Well, it's time to fix things. This next version of Rake drops old, crufty, backwards compatibility hacks such as top level constants, DSL methods defined in Object and numerous other features that are just no longer desired. It's also time to drop the leading zero from the version number as well and call this new version of rake what it really is: Version 10. So, welcome to Rake 10.0! Rake 10 is actually feature identical to the latest version of Rake 9 (that would be the version spelled 0.9.3), *except* that Rake 10 drops all the sundry deprecated features that have accumulated over the years. If your Rakefile is up to date and current with all the new features of Rake 10, you are ready to go. If your Rakefile still uses a few deprecated feeatures, feel free to use Rake 9 (0.9.3) with the same feature set. Just be aware that future features will be in Rake 10 family line. ==== Changes As mentioned above, there are no new features in Rake 10. However, there are a number of features missing: * Classic namespaces are now gone. Rake is no longer able to reflect the options settings in the global variables ($rakefile, $show\_tasks, $show\_prereqs, $trace, $dryrun and $silent). The --classic-namespace option is no longer supported. * Global constants are no longer supported. This includes Task, FileTask, FileCreationTask and RakeApp). The constant missing hook to warn about using global rake constants has been removed. * The Rake DSL methods (task, file, directory, etc) are in their own module (Rake::DSL). The stub versions of these methods (that printed warnings) in Object have been removed. However, the DSL methods are added to the top-level main object. Since main is not in the inheritance tree, the presence of the DSL methods in main should be low impact on other libraries. If you want to use the Rake DSL commands from your own code, just include Rake::DSL into your own classes and modules. * The deprecated syntax for task arguments (the one using :needs) has been removed. * The --reduce-compat flag has been removed (it's not needed anymore). * The deprecated rake/sys.rb library has been removed. * The deprecated rake/rdoctask.rb library has been removed. RDoc supplies its own rake task now. * The deprecated rake/gempackagetask.rb library has been removed. Gem supplies its own package task now. There is one small behavioral change: * Non-file tasks now always report the current time as their time stamp. This is different from the previous behavior where non-file tasks reported current time only if there were no prerequisites, and the max prerequisite timestamp otherwise. This lead to inconsistent and surprising behavior when adding prerequisites to tasks that in turn were prequisites to file tasks. The new behavior is more consistent and predictable. ==== Changes (from 0.9.3, 0.9.4, 0.9.5) Since Rake 10 includes the changes from the last version of Rake 9, we'll repeat the changes for versions 0.9.3 through 0.9.5 here. ===== New Features (in 0.9.3) * Multitask tasks now use a thread pool. Use -j to limit the number of available threads. * Use -m to turn regular tasks into multitasks (use at your own risk). * You can now do "Rake.add_rakelib 'dir'" in your Rakefile to programatically add rake task libraries. * You can specific backtrace suppression patterns (see --suppress-backtrace) * Directory tasks can now take prerequisites and actions * Use --backtrace to request a full backtrace without the task trace. * You can say "--backtrace=stdout" and "--trace=stdout" to route trace output to standard output rather than standard error. * Optional 'phony' target (enable with 'require 'rake/phony'") for special purpose builds. * Task#clear now clears task comments as well as actions and prerequisites. Task#clear_comment will specifically target comments. * The --all option will force -T and -D to consider all the tasks, with and without descriptions. ===== Bug Fixes (in 0.9.3) * Semi-colons in windows rakefile paths now work. * Improved Control-C support when invoking multiple test suites. * egrep method now reads files in text mode (better support for Windows) * Better deprecation line number reporting. * The -W option now works with all tasks, whether they have a description or not. * File globs in rake should not be sorted alphabetically, independent of file system and platform. * Numerous internal improvements. * Documentation typos and fixes. ===== Bug Fixes (in 0.9.4) * Exit status with failing tests is not correctly set to non-zero. * Simplified syntax for phony task (for older versions of RDoc). * Stand alone FileList usage gets glob function (without loading in extra dependencies) ===== Bug Fixes (in 0.9.5) * --trace and --backtrace no longer swallow following task names. ==== Thanks As usual, it was input from users that drove a lot of these changes. The following people contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Aaron Patterson * Dylan Smith * Jo Liss * Jonas Pfenniger * Kazuki Tsujimoto * Michael Bishop * Michael Elufimov * NAKAMURA Usaku * Ryan Davis * Sam Grönblom * Sam Phippen * Sergio Wong * Tay Ray Chuan * grosser * quix Also, many thanks to Eric Hodel for assisting with getting this release out the door. -- Jim Weirich === 10.0.2 ==== Changes ===== Bug Fixes * --trace and --backtrace no longer swallow following task names. ==== Thanks As usual, it was input from users that drove a lot of these changes. The following people contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Aaron Patterson * Dylan Smith * Jo Liss * Jonas Pfenniger * Kazuki Tsujimoto * Michael Bishop * Michael Elufimov * NAKAMURA Usaku * Ryan Davis * Sam Grönblom * Sam Phippen * Sergio Wong * Tay Ray Chuan * grosser * quix Also, many thanks to Eric Hodel for assisting with getting this release out the door. -- Jim Weirich === 10.0.1 ==== Changes ===== Bug Fixes * Exit status with failing tests is not correctly set to non-zero. * Simplified syntax for phony task (for older versions of RDoc). * Stand alone FileList usage gets glob function (without loading in extra dependencies) ==== Thanks As usual, it was input from users that drove a lot of these changes. The following people contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Aaron Patterson * Dylan Smith * Jo Liss * Jonas Pfenniger * Kazuki Tsujimoto * Michael Bishop * Michael Elufimov * NAKAMURA Usaku * Ryan Davis * Sam Grönblom * Sam Phippen * Sergio Wong * Tay Ray Chuan * grosser * quix Also, many thanks to Eric Hodel for assisting with getting this release out the door. -- Jim Weirich === 10.0.0 "Jim, when will Rake reach version 1.0?" Over the past several years I've been asked that question at conferences, panels and over twitter. Due to historical reasons (or maybe just plain laziness) Rake has (incorrectly) been treating the second digit of the version as the major release number. So in my head Rake was already at version 9. Well, it's time to fix things. This next version of Rake drops old, crufty, backwards compatibility hacks such as top level constants, DSL methods defined in Object and numerous other features that are just no longer desired. It's also time to drop the leading zero from the version number as well and call this new version of rake what it really is: Version 10. So, welcome to Rake 10.0! Rake 10 is actually feature identical to the latest version of Rake 9 (that would be the version spelled 0.9.3), *except* that Rake 10 drops all the sundry deprecated features that have accumulated over the years. If your Rakefile is up to date and current with all the new features of Rake 10, you are ready to go. If your Rakefile still uses a few deprecated feeatures, feel free to use Rake 9 (0.9.3) with the same feature set. Just be aware that future features will be in Rake 10 family line. ==== Changes in 10.0 As mentioned above, there are no new features in Rake 10. However, there are a number of features missing: * Classic namespaces are now gone. Rake is no longer able to reflect the options settings in the global variables ($rakefile, $show\_tasks, $show\_prereqs, $trace, $dryrun and $silent). The --classic-namespace option is no longer supported. * Global constants are no longer supported. This includes Task, FileTask, FileCreationTask and RakeApp). The constant missing hook to warn about using global rake constants has been removed. * The Rake DSL methods (task, file, directory, etc) are in their own module (Rake::DSL). The stub versions of these methods (that printed warnings) in Object have been removed. However, the DSL methods are added to the top-level main object. Since main is not in the inheritance tree, the presence of the DSL methods in main should be low impact on other libraries. If you want to use the Rake DSL commands from your own code, just include Rake::DSL into your own classes and modules. * The deprecated syntax for task arguments (the one using :needs) has been removed. * The --reduce-compat flag has been removed (it's not needed anymore). * The deprecated rake/sys.rb library has been removed. * The deprecated rake/rdoctask.rb library has been removed. RDoc supplies its own rake task now. * The deprecated rake/gempackagetask.rb library has been removed. Gem supplies its own package task now. There is one small behavioral change: * Non-file tasks now always report the current time as their time stamp. This is different from the previous behavior where non-file tasks reported current time only if there were no prerequisites, and the max prerequisite timestamp otherwise. This lead to inconsistent and surprising behavior when adding prerequisites to tasks that in turn were prequisites to file tasks. The new behavior is more consistent and predictable. ==== Changes (from 0.9.3) Since Rake 10 includes the changes from the last version of Rake 9, we'll repeat the changes for version 0.9.3 here. ===== New Features * Multitask tasks now use a thread pool. Use -j to limit the number of available threads. * Use -m to turn regular tasks into multitasks (use at your own risk). * You can now do "Rake.add_rakelib 'dir'" in your Rakefile to programatically add rake task libraries. * You can specific backtrace suppression patterns (see --suppress-backtrace) * Directory tasks can now take prerequisites and actions * Use --backtrace to request a full backtrace without the task trace. * You can say "--backtrace=stdout" and "--trace=stdout" to route trace output to standard output rather than standard error. * Optional 'phony' target (enable with 'require 'rake/phony'") for special purpose builds. * Task#clear now clears task comments as well as actions and prerequisites. Task#clear_comment will specifically target comments. * The --all option will force -T and -D to consider all the tasks, with and without descriptions. ===== Bug Fixes * Semi-colons in windows rakefile paths now work. * Improved Control-C support when invoking multiple test suites. * egrep method now reads files in text mode (better support for Windows) * Better deprecation line number reporting. * The -W option now works with all tasks, whether they have a description or not. * File globs in rake should not be sorted alphabetically, independent of file system and platform. * Numerous internal improvements. * Documentation typos and fixes. ==== Thanks As usual, it was input from users that drove a lot of these changes. The following people contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Aaron Patterson * Dylan Smith * Jo Liss * Jonas Pfenniger * Kazuki Tsujimoto * Michael Bishop * Michael Elufimov * NAKAMURA Usaku * Ryan Davis * Sam Grönblom * Sam Phippen * Sergio Wong * Tay Ray Chuan * grosser * quix Also, many thanks to Eric Hodel for assisting with getting this release out the door. -- Jim Weirich === 0.9.6 Rake version 0.9.6 contains a number of fixes mainly for merging Rake into the Ruby source tree and fixing tests. ==== Changes ===== Bug Fixes (0.9.6) * Better trace output when using a multi-threaded Rakefile. * Arg parsing is now consistent for tasks and multitasks. * Skip exit code test in versions of Ruby that don't support it well. Changes for better integration with the Ruby source tree: * Fix version literal for Ruby source tree build. * Better loading of libraries for testing in Ruby build. * Use the ruby version provided by Ruby's tests. ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Aaron Patterson * Dylan Smith * Jo Liss * Jonas Pfenniger * Kazuki Tsujimoto * Michael Bishop * Michael Elufimov * NAKAMURA Usaku * Ryan Davis * Sam Grönblom * Sam Phippen * Sergio Wong * Tay Ray Chuan * grosser * quix Also, many thanks to Eric Hodel for assisting with getting this release out the door. -- Jim Weirich === 0.9.5 Rake version 0.9.5 contains a number of bug fixes. ==== Changes ===== Bug Fixes (0.9.5) * --trace and --backtrace no longer swallow following task names. ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Aaron Patterson * Dylan Smith * Jo Liss * Jonas Pfenniger * Kazuki Tsujimoto * Michael Bishop * Michael Elufimov * NAKAMURA Usaku * Ryan Davis * Sam Grönblom * Sam Phippen * Sergio Wong * Tay Ray Chuan * grosser * quix Also, many thanks to Eric Hodel for assisting with getting this release out the door. -- Jim Weirich === 0.9.4 Rake version 0.9.4 contains a number of bug fixes. ==== Changes ===== Bug Fixes (0.9.4) * Exit status with failing tests is not correctly set to non-zero. * Simplified syntax for phony task (for older versions of RDoc). * Stand alone FileList usage gets glob function (without loading in extra dependencies) ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Aaron Patterson * Dylan Smith * Jo Liss * Jonas Pfenniger * Kazuki Tsujimoto * Michael Bishop * Michael Elufimov * NAKAMURA Usaku * Ryan Davis * Sam Grönblom * Sam Phippen * Sergio Wong * Tay Ray Chuan * grosser * quix Also, many thanks to Eric Hodel for assisting with getting this release out the door. -- Jim Weirich === 0.9.3 Rake version 0.9.3 contains some new, backwards compatible features and a number of bug fixes. ==== Changes ===== New Features * Multitask tasks now use a thread pool. Use -j to limit the number of available threads. * Use -m to turn regular tasks into multitasks (use at your own risk). * You can now do "Rake.add_rakelib 'dir'" in your Rakefile to programatically add rake task libraries. * You can specific backtrace suppression patterns (see --suppress-backtrace) * Directory tasks can now take prerequisites and actions * Use --backtrace to request a full backtrace without the task trace. * You can say "--backtrace=stdout" and "--trace=stdout" to route trace output to standard output rather than standard error. * Optional 'phony' target (enable with 'require 'rake/phony'") for special purpose builds. * Task#clear now clears task comments as well as actions and prerequisites. Task#clear_comment will specifically target comments. * The --all option will force -T and -D to consider all the tasks, with and without descriptions. ===== Bug Fixes * Semi-colons in windows rakefile paths now work. * Improved Control-C support when invoking multiple test suites. * egrep method now reads files in text mode (better support for Windows) * Better deprecation line number reporting. * The -W option now works with all tasks, whether they have a description or not. * File globs in rake should not be sorted alphabetically, independent of file system and platform. * Numerous internal improvements. * Documentation typos and fixes. ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Aaron Patterson * Dylan Smith * Jo Liss * Jonas Pfenniger * Kazuki Tsujimoto * Michael Bishop * Michael Elufimov * NAKAMURA Usaku * Ryan Davis * Sam Grönblom * Sam Phippen * Sergio Wong * Tay Ray Chuan * grosser * quix Also, many thanks to Eric Hodel for assisting with getting this release out the door. -- Jim Weirich === Rake 0.9.2.2 Rake version 0.9.2.2 is mainly bug fixes. ==== Changes * The rake test loader now removes arguments it has processed. Issue #51 * Rake::TaskArguments now responds to #values\_at * RakeFileUtils.verbose_flag = nil silences output the same as 0.8.7 * Rake tests are now directory-independent * Rake tests are no longer require flexmock * Commands constant is no longer polluting top level namespace. * Show only the interesting portion of the backtrace by default (James M. Lawrence). * Added --reduce-compat option to remove backward compatible DSL hacks (James M. Lawrence). ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * James M. Lawrence (quix) * Roger Pack * Cezary Baginski * Sean Scot August Moon * R.T. Lechow * Alex Chaffee * James Tucker * Matthias Lüdtke * Santiago Pastorino Also, bit thanks to Eric Hodel for assisting with getting this release out the door (where "assisting" includes, but is not by any means limited to, "pushing" me to get it done). -- Jim Weirich === 0.9.2 Rake version 0.9.2 has a few small fixes. See below for details. ==== Changes * Support for Ruby 1.8.6 was fixed. * Global DSL warnings now honor --no-deprecate ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * James M. Lawrence (quix) * Roger Pack * Cezary Baginski * Sean Scot August Moon * R.T. Lechow * Alex Chaffee * James Tucker * Matthias Lüdtke * Santiago Pastorino Also, bit thanks to Eric Hodel for assisting with getting this release out the door (where "assisting" includes, but is not by any means limited to, "pushing" me to get it done). -- Jim Weirich === 0.9.1 Rake version 0.9.1 has a number of bug fixes and enhancments (see below for more details). Additionally, the internals have be slightly restructured and improved. ==== Changes Rake 0.9.1 adds back the global DSL methods, but with deprecation messages. This allows Rake 0.9.1 to be used with older rakefiles with warning messages. ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * James M. Lawrence (quix) * Roger Pack * Cezary Baginski * Sean Scot August Moon * R.T. Lechow * Alex Chaffee * James Tucker * Matthias Lüdtke * Santiago Pastorino Also, bit thanks to Eric Hodel for assisting with getting this release out the door (where "assisting" includes, but is not by any means limited to, "pushing" me to get it done). -- Jim Weirich === 0.9.0 Rake version 0.9.0 has a number of bug fixes and enhancments (see below for more details). Additionally, the internals have be slightly restructured and improved. ==== Changes ===== New Features / Enhancements / Bug Fixes in Version 0.9.0 * Rake now warns when the deprecated :needs syntax used (and suggests the proper syntax in the warning). * Moved Rake DSL commands to top level ruby object 'main'. Rake DSL commands are no longer private methods in Object. (Suggested by James M. Lawrence/quix) * Rake now uses case-insensitive comparisons to find the Rakefile on Windows. Based on patch by Roger Pack. * Rake now requires (instead of loads) files in the test task. Patch by Cezary Baginski. * Fixed typos. Patches by Sean Scot August Moon and R.T. Lechow. * Rake now prints the Rakefile directory only when it's different from the current directory. Patch by Alex Chaffee. * Improved rakefile_location discovery on Windows. Patch by James Tucker. * Rake now recognizes "Windows Server" as a windows system. Patch by Matthias Lüdtke * Rake::RDocTask is deprecated. Use RDoc::Task from RDoc 2.4.2+ (require 'rdoc/task') * Rake::GemPackageTask is deprecated. Use Gem::PackageTask (require 'rubygems/package\_task') * Rake now outputs various messages to $stderr instead of $stdout. * Rake no longer emits warnings for Config. Patch by Santiago Pastorino. * Removed Rake's DSL methods from the top level scope. If you need to call 'task :xzy' in your code, include Rake::DSL into your class, or put the code in a Rake::DSL.environment do ... end block. * Split rake.rb into individual files. * Support for the --where (-W) flag for showing where a task is defined. * Fixed quoting in test task. (http://onestepback.org/redmine/issues/show/44, http://www.pivotaltracker.com/story/show/1223138) * Fixed the silent option parsing problem. (http://onestepback.org/redmine/issues/show/47) * Fixed :verbose=>false flag on sh and ruby commands. * Rake command line options may be given by default in a RAKEOPT environment variable. * Errors in Rake will now display the task invocation chain in effect at the time of the error. * Accepted change by warnickr to not expand test patterns in shell (allowing more files in the test suite). * Fixed that file tasks did not perform prereq lookups in scope (Redmine #57). ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * James M. Lawrence (quix) * Roger Pack * Cezary Baginski * Sean Scot August Moon * R.T. Lechow * Alex Chaffee * James Tucker * Matthias Lüdtke * Santiago Pastorino Also, bit thanks to Eric Hodel for assisting with getting this release out the door (where "assisting" includes, but is not by any means limited to, "pushing" me to get it done). -- Jim Weirich === 0.8.7 Rake version 0.8.5 introduced greatly improved support for executing commands on Windows. The "sh" command now has the same semantics on Windows that it has on Unix based platforms. Rake version 0.8.6 includes minor fixes the the RDoc generation. Rake version 0.8.7 includes a minor fix for JRuby running on windows. ==== Changes ===== New Features / Enhancements in Version 0.8.5 * Improved implementation of the Rake system command for Windows. (patch from James M. Lawrence/quix) * Support for Ruby 1.9's improved system command. (patch from James M. Lawrence/quix) * Rake now includes the configured extension when invoking an executable (Config::CONFIG['EXEEXT]) ===== Bug Fixes in Version 0.8.5 * Environment variable keys are now correctly cased (it matters in some implementations). ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Charles Nutter -- Jim Weirich === 0.8.6 Rake version 0.8.5 introduced greatly improved support for executing commands on Windows. The "sh" command now has the same semantics on Windows that it has on Unix based platforms. Rake version 0.8.5 includes minor fixes the the RDoc generation. ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * James M. Lawrence/quix * Luis Lavena -- Jim Weirich === 0.8.5 Rake version 0.8.5 is a new release of Rake with greatly improved support for executing commands on Windows. The "sh" command now has the same semantics on Windows that it has on Unix based platforms. ==== Changes ===== New Features / Enhancements in Version 0.8.5 * Improved implementation of the Rake system command for Windows. (patch from James M. Lawrence/quix) * Support for Ruby 1.9's improved system command. (patch from James M. Lawrence/quix) * Rake now includes the configured extension when invoking an executable (Config::CONFIG['EXEEXT]) ===== Bug Fixes in Version 0.8.5 * Environment variable keys are now correctly cased (it matters in some implementations). ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * James M. Lawrence/quix * Luis Lavena -- Jim Weirich === 0.8.4 Rake version 0.8.4 is a bug-fix release of rake. NOTE: The version of Rake that comes with Ruby 1.9 has diverged slightly from the core Rake code base. Rake 0.8.4 will work with Ruby 1.9, but is not a strict upgrade for the Rake that comes with Ruby 1.9. A (near) future release of Rake will unify those two codebases. ==== Letter Writing Campaign Thanks to Aaron Patterson (@tenderlove) and Eric Hodel (@drbrain) for their encouraging support in organizing a letter writing campaign to lobby for the "Warning Free" release of rake 0.8.4. A special callout goes to Jonathan D. Lord, Sr (Dr. Wingnut) whose postcard was the first to actually reach me. (see http://tenderlovemaking.com/2009/02/26/we-need-a-new-version-of-rake/ for details) ==== Changes ===== New Features / Enhancements in Version 0.8.4 * Case is preserved on rakefile names. (patch from James M. Lawrence/quix) * Improved Rakefile case insensitivity testing (patch from Luis Lavena). * Windows system dir search order is now: HOME, HOMEDRIVE + HOMEPATH, APPDATA, USERPROFILE (patch from Luis Lavena) * MingGW is now recognized as a windows platform. (patch from Luis Lavena) ===== Bug Fixes in Version 0.8.4 * Removed reference to manage_gem to fix the warning produced by the gem package task. * Fixed stray ARGV option problem that was interfering with Test::Unit::Runner. (patch from Pivotal Labs) ===== Infrastructure Improvements in Version 0.8.4 * Numerous fixes to the windows test suite (patch from Luis Lavena). * Improved Rakefile case insensitivity testing (patch from Luis Lavena). * Better support for windows paths in the test task (patch from Simon Chiang/bahuvrihi) ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * James M. Lawrence/quix * Luis Lavena * Pivotal Labs * Simon Chiang/bahuvrihi -- Jim Weirich === 0.8.3 Rake version 0.8.3 is a bug-fix release of rake. ==== Changes ===== Bug Fixes in Version 0.8.3 * Enhanced the system directory detection in windows. We now check HOMEDRIVE/HOMEPATH and USERPROFILE if APPDATA isn't found. (Patch supplied by James Tucker). Rake no long aborts if it can't find the directory. * Added fix to handle ruby installations in directories with spaces in their name. ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Edwin Pratomo * Gavin Stark * Adam Q. Salter * Adam Majer * Emanuel Indermühle * Ittay Dror * Bheeshmar Redheendran (for spending an afternoon with me debugging windows issues) -- Jim Weirich === 0.8.2 Rake version 0.8.2 is a new release of rake that includes a number of new features and numerous bug fixes. ==== Changes ===== New Features in Version 0.8.2 * Switched from getoptlong to optparse (patches supplied by Edwin Pratomo). * The -T option will now attempt to dynamically sense the size of the terminal. The -T output will only self-truncate if the output is a tty. However, if RAKE_COLUMNS is explicitly set, it will be honored in any case. (Patch provided by Gavin Stark). * The following public methods have been added to rake task objects: * task.clear -- Clear both the prerequisites and actions of the target rake task. * task.clear_prerequisites -- Clear all the existing prerequisites from the target rake task. * task.clear_actions -- Clear all the existing actions from the target rake task. * task.reenable -- Re-enable a task, allowing its actions to be executed again if the task is invoked. * Changed RDoc test task to have no default template. This makes it easier for the tempate to pick up the template from the environment. * Default values for task arguments can easily be specified with the :with_defaults method. (Idea for default argument merging supplied by (Adam Q. Salter) ===== Bug Fixes in Version 0.8.2 * Fixed bug in package task so that it will include the subdir directory in the package for testing. (Bug found by Adam Majer) * Fixed filename dependency order bug in test\_inspect\_pending and test\_to\_s\_pending. (Bug found by Adam Majer) * Fixed check for file utils options to make them immune to the symbol/string differences. (Patch supplied by Edwin Pratomo) * Fixed bug with rules involving multiple source, where only the first dependency of a rule has any effect (Patch supplied by Emanuel Indermühle) * FileList#clone and FileList#dup have better sematics w.r.t. taint and freeze. * Changed from using Mutex to Monitor. Evidently Mutex causes thread join errors when Ruby is compiled with -disable-pthreads. (Patch supplied by Ittay Dror) * Fixed bug in makefile parser that had problems with extra spaces in file task names. (Patch supplied by Ittay Dror) ==== Other changes in Version 0.8.2 * Added ENV var to rake's own Rakefile to prevent OS X from including extended attribute junk in the rake package tar file. (Bug found by Adam Majer) * Added a performance patch for reading large makefile dependency files. (Patch supplied by Ittay Dror) ==== Task Argument Examples Prior to version 0.8.0, rake was only able to handle command line arguments of the form NAME=VALUE that were passed into Rake via the ENV hash. Many folks had asked for some kind of simple command line arguments, perhaps using "--" to separate regular task names from argument values on the command line. The problem is that there was no easy way to associate positional arguments on the command line with different tasks. Suppose both tasks :a and :b expect a command line argument: does the first value go with :a? What if :b is run first? Should it then get the first command line argument. Rake 0.8.0 solves this problem by explicitly passing values directly to the tasks that need them. For example, if I had a release task that required a version number, I could say: rake release[0.8.2] And the string "0.8.2" will be passed to the :release task. Multiple arguments can be passed by separating them with a comma, for example: rake name[john,doe] Just a few words of caution. The rake task name and its arguments need to be a single command line argument to rake. This generally means no spaces. If spaces are needed, then the entire rake + argument string should be quoted. Something like this: rake "name[billy bob, smith]" (Quoting rules vary between operating systems and shells, so make sure you consult the proper docs for your OS/shell). ===== Tasks that Expect Parameters Parameters are only given to tasks that are setup to expect them. In order to handle named parameters, the task declaration syntax for tasks has been extended slightly. For example, a task that needs a first name and last name might be declared as: task :name, :first_name, :last_name The first argument is still the name of the task (:name in this case). The next to argumements are the names of the parameters expected by :name (:first_name and :last_name in the example). To access the values of the parameters, the block defining the task behaviour can now accept a second parameter: task :name, :first_name, :last_name do |t, args| puts "First name is #{args.first_name}" puts "Last name is #{args.last_name}" end The first argument of the block "t" is always bound to the current task object. The second argument "args" is an open-struct like object that allows access to the task arguments. Extra command line arguments to a task are ignored. Missing command line arguments are given the nil value. ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Edwin Pratomo * Gavin Stark * Adam Q. Salter * Adam Majer * Emanuel Indermühle * Ittay Dror * Bheeshmar Redheendran (for spending an afternoon with me debugging windows issues) -- Jim Weirich === 0.8.0/0.8.1 Rake version 0.8.0 is a new release of rake that includes serveral new features. ==== Changes ===== New Features in Version 0.8.0 * Tasks can now receive command line parameters. See the examples below for more details. * Comments are limited to 80 columns on output, but full comments can be seen by using the -D parameter. (feature suggested by Jamis Buck). * Explicit exit(n) calls will now set the exit status to n. (patch provided by Stephen Touset). * Rake is now compatible with Ruby 1.9. Version 0.8.1 is a minor update that includes additional Ruby 1.9 compatibility fixes. ==== Task Argument Examples Prior to version 0.8.0, rake was only able to handle command line arguments of the form NAME=VALUE that were passed into Rake via the ENV hash. Many folks had asked for some kind of simple command line arguments, perhaps using "--" to separate regular task names from argument values on the command line. The problem is that there was no easy way to associate positional arguments on the command line with different tasks. Suppose both tasks :a and :b expect a command line argument: does the first value go with :a? What if :b is run first? Should it then get the first command line argument. Rake 0.8.0 solves this problem by explicitly passing values directly to the tasks that need them. For example, if I had a release task that required a version number, I could say: rake release[0.8.0] And the string "0.8.0" will be passed to the :release task. Multiple arguments can be passed by separating them with a comma, for example: rake name[john,doe] Just a few words of caution. The rake task name and its arguments need to be a single command line argument to rake. This generally means no spaces. If spaces are needed, then the entire rake + argument string should be quoted. Something like this: rake "name[billy bob, smith]" (Quoting rules vary between operating systems and shells, so make sure you consult the proper docs for your OS/shell). ===== Tasks that Expect Parameters Parameters are only given to tasks that are setup to expect them. In order to handle named parameters, the task declaration syntax for tasks has been extended slightly. For example, a task that needs a first name and last name might be declared as: task :name, :first_name, :last_name The first argument is still the name of the task (:name in this case). The next to argumements are the names of the parameters expected by :name (:first_name and :last_name in the example). To access the values of the parameters, the block defining the task behaviour can now accept a second parameter: task :name, :first_name, :last_name do |t, args| puts "First name is #{args.first_name}" puts "Last name is #{args.last_name}" end The first argument of the block "t" is always bound to the current task object. The second argument "args" is an open-struct like object that allows access to the task arguments. Extra command line arguments to a task are ignored. Missing command line arguments are given the nil value. ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Jamis Buck (for comment formatting suggestions) * Stephen Touset (for exit status patch). -- Jim Weirich === 0.7.3 Rake version 0.7.3 is a minor release that includes some refactoring to better support custom Rake applications. ==== Changes ===== New Features in Version 0.7.3 * Added the +init+ and +top_level+ methods to make the creation of custom Rake applications a bit easier. E.g. gem 'rake', ">= 0.7.3" require 'rake' Rake.application.init('myrake') task :default do something_interesting end Rake.application.top_level ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... -- Jim Weirich === 0.7.2 Version 0.7.2 supplies a bug fix and a few minor enhancements. In particular, the new version fixes an incompatibility with the soon to be released Ruby 1.8.6. We strongly recommend upgrading to Rake 0.7.2 in order to be compatible with the new version of Ruby. ==== Changes ===== Bug Fixes in 0.7.2 There are quite a number of bug fixes in the new 0.7.2 version of Rake: * Removed dependency on internal fu_xxx functions from FileUtils. * Error messages are now send to stderr rather than stdout (from Payton Quackenbush). * Better error handling on invalid command line arguments (from Payton Quackenbush). * Fixed some bugs where the application object was going to the global appliation instead of using its own data. * Fixed the method name leak from FileUtils (bug found by Glenn Vanderburg). * Added test for noop, bad_option and verbose flags to sh command. * Added a description to the gem task in GemPackageTask. * Fixed a bug when rules have multiple prerequisites (patch by Joel VanderWerf) * Added the handful of RakeFileUtils to the private method as well. ===== New Features in 0.7.2 The following new features are available in Rake version 0.7.2: * Added square and curly bracket patterns to FileList#include (Tilman Sauerbeck). * FileLists can now pass a block to FileList#exclude to exclude files based on calculated values. * Added plain filename support to rule dependents (suggested by Nobu Nakada). * Added pathmap support to rule dependents. In other words, if a pathmap format (beginning with a '%') is given as a Rake rule dependent, then the name of the depend will be the name of the target with the pathmap format applied. * Added a 'tasks' method to a namespace to get a list of tasks associated with the namespace. * Added tar_command and zip_command options to the Package task. * The clean task will no longer delete 'core' if it is a directory. ===== Internal Rake Improvements The following changes will are mainly internal improvements and refactorings and have little effect on the end user. But they may be of interest to the general public. * Added rcov task and updated unit testing for better code coverage. * Added a 'shame' task to the Rakefile. * Added rake_extension to handle detection of extension collisions. * Added a protected 'require "rubygems"' to test/test_application to unbreak cruisecontrol.rb. * Removed rake\_dup. Now we just simply rescue a bad dup. * Refactored the FileList reject logic to remove duplication. * Removed if \_\_FILE\_\_ at the end of the rake.rb file. ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Payton Quackenbush -- For several error handling improvements. * Glenn Vanderburg -- For finding and fixing the method name leak from FileUtils. * Joel VanderWerf -- for finding and fixing a bug in the handling of multiple prerequisites. * Tilman Sauerbeck -- For some enhancing FileList to support more advanced file globbing. * Nobu Nakada -- For suggesting plain file name support to rule dependents. -- Jim Weirich === 0.7.1 Version 0.7.1 supplies a bug fix and a few minor enhancements. ==== Changes ===== Bug Fixes in 0.7.1 * Changes in the exception reported for the FileUtils.ln caused safe_ln to fail with a NotImplementedError. Rake 0.7.1 will now catch that error or any StandardError and properly fall back to using +cp+. ===== New Features in 0.7.1 * You can filter the results of the --task option by supplying an optional regular expression. This allows the user to easily find a particular task name in a long list of possible names. * Transforming procs in a rule may now return a list of prerequisites. This allows more flexible rule formation. * FileList and String now support a +pathmap+ melthod that makes the transforming paths a bit easier. See the API docs for +pathmap+ for details. * The -f option without a value will disable the search for a Rakefile. This allows the Rakefile to be defined entirely in a library (and loaded with the -r option). The current working directory is not changed when this is done. ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * James Britt and Assaph Mehr for reporting and helping to debug the safe_ln issue. -- Jim Weirich === 0.7.0 These changes for Rake have been brewing for a long time. Here they are, I hope you enjoy them. ==== Changes ===== New Features * Name space support for task names (see below). * Prerequisites can be executed in parallel (see below). * Added safe_ln support for openAFS (via Ludvig Omholt). * RDoc defaults to internal (in-process) invocation. The old behavior is still available by setting the +external+ flag to true. * Rakefiles are now loaded with the expanded path to prevent accidental pollution from the Ruby load path. * Task objects my now be used in prerequisite lists directly. * Task objects (in addition to task names) may now be included in the prerequisite list of a task. * Internals cleanup and refactoring. ===== Bug Fixes * Compatibility fixes for Ruby 1.8.4 FileUtils changes. ===== Namespaces Tasks can now be nested inside their own namespaces. Tasks within one namespace will not accidentally interfer with tasks named in a different namespace. For example: namespace "main" do task :build do # Build the main program end end namespace "samples" do task :build do # Build the sample programs end end task :build_all => ["main:build", "samples:build"] Even though both tasks are named :build, they are separate tasks in their own namespaces. The :build_all task (defined in the toplevel namespace) references both build tasks in its prerequisites. You may invoke each of the individual build tasks with the following commands: rake main:build rake samples:build Or invoke both via the :build_all command: rake build_all Namespaces may be nested arbitrarily. Since the name of file tasks correspond to the name of a file in the external file system, FileTasks are not affected by the namespaces. See the Rakefile format documentation (in the Rake API documents) for more information. ===== Parallel Tasks Sometimes you have several tasks that can be executed in parallel. By specifying these tasks as prerequisites to a +multitask+ task. In the following example the tasks copy\_src, copy\_doc and copy\_bin will all execute in parallel in their own thread. multitask :copy_files => [:copy_src, :copy_doc, :copy_bin] do puts "All Copies Complete" end ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Doug Young (inspiration for the parallel task) * David Heinemeier Hansson (for --trace message enhancement and for pushing for namespace support). * Ludvig Omholt (for the openAFS fix) -- Jim Weirich === 0.6.1 * Rebuilt 0.6.0 gem without signing. === 0.6.0 Its time for some long requested enhancements and lots of bug fixes ... And a whole new web page. ==== New Web Page The primary documentation for rake has moved from the RubyForge based wiki to its own Hieraki based web site. Constant spam on the wiki made it a difficult to keep clean. The new site will be easier to update and organize. Check out the new documentation at: http://docs.rubyrake.org We will be adding new documentation to the site as time goes on. In addition to the new docs page, make sure you check out Martin Fowlers article on rake at http://martinfowler.com/articles/rake.html ==== Changes ===== New Features * Multiple prerequisites on Rake rules now allowed. However, keep the following in mind: 1. All the prerequisites of a rule must be available before a rule is triggered, where "enabled" means (a) an existing file, (b) a defined rule, or (c) another rule which also must be trigger-able. 2. Rules are checked in order of definition, so it is important to order your rules properly. If a file can be created by two different rules, put the more specific rule first (otherwise the more general rule will trigger first and the specific one will never be triggered). 3. The source method now returns the name of the first prerequisite listed in the rule. sources returns the names of all the rule prerequisites, ordered as they are defined in the rule. If the task has other prerequisites not defined in the rule (but defined in an explicit task definition), then they will _not_ be included in the sources list. * FileLists may now use the egrep command. This popular enhancement is now a core part of the FileList object. If you want to get a list of all your to-dos, fixmes and TBD comments, add the following to your Rakefile. desc "Look for TODO and FIXME tags in the code" task :todo do FileList['**/*.rb'].egrep /#.*(FIXME|TODO|TBD)/ end * The investigation method was added to task object to dump out some important values. This makes it a bit easier to debug Rake tasks. For example, if you are having problems with a particular task, just print it out: task :huh do puts Rake::Task['huh'].investigation end * The Rake::TestTask class now supports a "ruby\_opts" option to pass arbitrary ruby options to a test subprocess. ===== Some Incompatibilities * When using the ruby command to start a Ruby subprocess, the Ruby interpreter that is currently running rake is used by default. This makes it easier to use rake in an environment with multiple ruby installation. (Previously, the first ruby command found in the PATH was used). If you wish to chose a different Ruby interpreter, you can explicitly choose the interpreter via the sh command. * The major rake classes (Task, FileTask, FileCreationTask, RakeApp) have been moved out of the toplevel scope and are now accessible as Rake::Task, Rake::FileTask, Rake::FileCreationTask and Rake::Application. If your Rakefile directly references any one of these tasks, you may: 1. Update your Rakefile to use the new classnames 2. Use the --classic-namespace option on the rake command to get the old behavior, 3. Add require 'rake/classic_namespace' to the Rakefile to get the old behavior. rake will print a rather annoying warning whenever a deprecated class name is referenced without enabling classic namespace. ===== Bug Fixes * Several unit tests and functional tests were fixed to run better under windows. * Directory tasks are now a specialized version of a File task. A directory task will only be triggered if it doesn't exist. It will not be triggered if it is out of date w.r.t. any of its prerequisites. * Fixed a bug in the Rake::GemPackageTask class so that the gem now properly contains the platform name. * Fixed a bug where a prerequisite on a file task would cause an exception if the prerequisite did not exist. ==== Thanks As usual, it was input from users that drove a alot of these changes. The following people either contributed patches, made suggestions or made otherwise helpful comments. Thanks to ... * Greg Fast (better ruby_opt test options) * Kelly Felkins (requested by better namespace support) * Martin Fowler (suggested Task.investigation) * Stuart Jansen (send initial patch for multiple prerequisites). * Masao Mutch (better support for non-ruby Gem platforms) * Philipp Neubeck (patch for file task exception fix) -- Jim Weirich === 0.5.4 Time for some minor bug fixes and small enhancements ==== Changes Here are the changes for version 0.5.4 ... * Added double quotes to the test runner. This allows the location of the tests (and runner) to be in a directory path that contains spaces (e.g. "C:/Program Files/ruby/bin"). * Added .svn to default ignore list. Now subversion project metadata is automatically ignored by Rake's FileList. * Updated FileList#include to support nested arrays and filelists. FileLists are flat lists of file names. Using a FileList in an include will flatten out the nested file names. == Thanks As usual, it was input from users that drove a alot of these changes. Thanks to ... * Tilman Sauerbeck for the nested FileList suggestion. * Josh Knowles for pointing out the spaces in directory name problem. -- Jim Weirich === 0.5.3 Although it has only been two weeks since the last release, we have enough updates to the Rake program to make it time for another release. ==== Changes Here are the changes for version 0.5.3 ... * FileLists have been extensively changed so that they mimic the behavior of real arrays even more closely. In particular, operations on FileLists that return a new collection (e.g. collect, reject) will now return a FileList rather than an array. In addition, several places where FileLists were not properly expanded before use have been fixed. * A method (+ext+) to simplify the handling of file extensions was added to String and to Array. * The 'testrb' script in test/unit tends to silently swallow syntax errors in test suites. Because of that, the default test loader is now a rake-provided script. You can still use 'testrb' by setting the loader flag in the test task to :testrb. (See the API documents for TestTask for all the loader flag values). * FileUtil methods (e.g. cp, mv, install) are now declared to be private. This will cut down on the interference with user defined methods of the same name. * Fixed the verbose flag in the TestTask so that the test code is controlled by the flag. Also shortened up some failure messages. (Thanks to Tobias Luetke for the suggestion). * Rules will now properly detect a task that can generate a source file. Previously rules would only consider source files that were already present. * Added an +import+ command that allows Rake to dynamically import dependendencies into a running Rake session. The +import+ command can run tasks to update the dependency file before loading them. Dependency files can be in rake or make format, allowing rake to work with tools designed to generate dependencies for make. ==== Thanks As usual, it was input from users that drove a alot of these changes. Thanks to ... * Brian Gernhardt for the rules fix (especially for the patience to explain the problem to me until I got what he was talking about). * Stefan Lang for pointing out problems in the dark corners of the FileList implementation. * Alexey Verkhovsky pointing out the silently swallows syntax errors in tests. * Tobias Luetke for beautifying the test task output. * Sam Roberts for some of the ideas behind dependency loading. -- Jim Weirich === 0.5.0 It has been a long time in coming, but we finally have a new version of Rake available. ==== Changes * Fixed documentation that was lacking the Rake module name (Tilman Sauerbeck). * Added tar.gz and tar.bz2 support to package task (Tilman Sauerbeck). * Recursive rules are now supported (Tilman Sauerbeck). * Added warning option for the Test Task (requested by Eric Hodel). * The jamis rdoc template is only used if it exists. * Added fix for Ruby 1.8.2 test/unit and rails problem. * Added contributed rake man file (Jani Monoses). * Added Brian Candler's fix for problems in --trace and --dry-run mode. ==== Thanks Lots of people provided input to this release. Thanks to Tilman Sauerbeck for numerous patches, documentation fixes and suggestions. And for also pushing me to get this release out. Also, thanks to Brian Candler for the finding and fixing --trace/dry-run fix. That was an obscure bug. Also to Eric Hodel for some good suggestions. -- Jim Weirich === 0.4.15 ==== Changes Version 0.4.15 is a bug fix update for the Ruby 1.8.2 compatibility changes. This release includes: * Fixed a bug that prevented the TESTOPTS flag from working with the revised for 1.8.2 test task. * Updated the docs on --trace to indicate that it also enables a full backtrace on errors. * Several fixes for new warnings generated. ==== Mini-Roadmap I will continue to issue Rake updates in the 0.4.xx series as new Ruby-1.8.2 issues become manifest. Once the codebase stabilizes, I will release a 0.5.0 version incorporating all the changes. If you are not using Ruby-1.8.2 and wish to avoid version churn, I recommend staying with a release prior to Rake-0.4.14. === 0.4.14 Version 0.4.14 is a compatibility fix to allow Rake's test task to work under Ruby 1.8.2. A change in the Test::Unit autorun feature prevented Rake from running any tests. This release fixes the problem. Rake 0.4.14 is the recommended release for anyone using Ruby 1.8.2. === 0.4.13 * Fixed the dry-run flag so it is operating again. * Multiple arguments to sh and ruby commands will not be interpreted by the shell (patch provided by Jonathan Paisley). === 0.4.12 * Added --silent (-s) to suppress the (in directory) rake message. === 0.4.11 * Changed the "don't know how to rake" message (finally) * Changes references to a literal "Rakefile" to reference the global variable $rakefile (which contains the actual name of the rakefile). === 0.4.10 * Added block support to the "sh" command, allowing users to take special actions on the result of the system call. E.g. sh "shell_command" do |ok, res| puts "Program returned #{res.exitstatus}" if ! ok end === 0.4.9 * Switched to Jamis Buck's RDoc template. * Removed autorequire from Rake's gem spec. This prevents the Rake libraries from loading while using rails. === 0.4.8 * Added support for .rb versions of Rakefile. * Removed \\\n's from test task. * Fixed Ruby 1.9 compatibility issue with FileList. === 0.4.7 * Fixed problem in FileList that caused Ruby 1.9 to go into infinite recursion. Since to_a was removed from Object, it does not need to added back into the list of methods to rewrite in FileList. (Thanks to Kent Sibilev for pointing this out). === 0.4.6 * Removed test version of ln in FileUtils that prevented safe_ln from using ln. === 0.4.5 * Upgraded comments in TestTask. * FileList to_s and inspect now automatically resolve pending changes. * FileList#exclude properly returns the FileList. === 0.4.4 * Fixed initialization problem with @comment. * Now using multi -r technique in TestTask. Switch Rakefile back to using the built-in test task macros because the rake runtime is no longer needed. * Added 'TEST=filename' and 'TESTOPTS=options' to the Test Task macros. * Allow a +test_files+ attribute in test tasks. This allows more flexibility in specifying test files. === 0.4.3 * Fixed Comment leakage. === 0.4.2 * Added safe_ln that falls back to a copy if a file link is not supported. * Package builder now uses safe\_ln. === 0.4.1 * Task comments are now additive, combined with "/". * Works with (soon to be released) rubygems 0.6.2 (or 0.7.0) === 0.4.0 * FileList now uses deferred loading. The file system is not searched until the first call that needs the file names. * VAR=VALUE options are now accepted on the command line and are treated like environment variables. The values may be tested in a Rakefile by referencing ENV['VAR']. * File.mtime is now used (instead of File.new().mtime). === 0.3.2.x * Removed some hidden dependencies on rubygems. Tests now will test gems only if they are installed. * Removed Sys from some example files. I believe that is that last reference to Sys outside of the contrib area. * Updated all copyright notices to include 2004. === 0.3.2 * GEM Installation now works with the application stub. === 0.3.1 * FileLists now automatically ignore CVS, .bak, ! * GEM Installation now works. === 0.3.0 Promoted 0.2.10. === 0.2.10 General * Added title to Rake's rdocs * Contrib packages are no longer included in the documentation. RDoc Issues * Removed default for the '--main' option * Fixed rendering of the rdoc options * Fixed clean/clobber confusion with rerdoc * 'title' attribute added Package Task Library Issues * Version (or explicit :noversion) is required. * +package_file+ attribute is now writable FileList Issues * Dropped bang version of exclude. Now using ant-like include/exclude semantics. * Enabled the "yield self" idiom in FileList#initialize. === 0.2.9 This version contains numerous changes as the RubyConf.new(2003) presentation was being prepared. The changes include: * The monolithic rubyapp task library is in the process of being dropped in favor of lighter weight task libraries. === 0.2.7 * Added "desc" for task descriptions. * -T will now display tasks with descriptions. * -P will display tasks and prerequisites. * Dropped the Sys module in favor of the 1.8.x FileUtils module. Sys is still supported in the contrib area. === 0.2.6 * Moved to RubyForge === 0.2.5 * Switched to standard ruby app builder. * Added no_match option to file matcher. === 0.2.4 * Fixed indir, which neglected to actually change directories. === 0.2.3 * Added rake module for a help target * Added 'for\_files' to Sys * Added a $rakefile constant * Added test for selecting proper rule with multiple targets. rake-12.3.1/MIT-LICENSE000066400000000000000000000020331325463231200141530ustar00rootroot00000000000000Copyright (c) Jim Weirich Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. rake-12.3.1/README.rdoc000066400000000000000000000123621325463231200143330ustar00rootroot00000000000000= RAKE -- Ruby Make home :: https://github.com/ruby/rake bugs :: https://github.com/ruby/rake/issues docs :: https://ruby.github.io/rake build status :: {travis-ci}[https://travis-ci.org/ruby/rake] {appveyor}[https://ci.appveyor.com/project/ruby/rake] == Description Rake is a Make-like program implemented in Ruby. Tasks and dependencies are specified in standard Ruby syntax. Rake has the following features: * Rakefiles (rake's version of Makefiles) are completely defined in standard Ruby syntax. No XML files to edit. No quirky Makefile syntax to worry about (is that a tab or a space?) * Users can specify tasks with prerequisites. * Rake supports rule patterns to synthesize implicit tasks. * Flexible FileLists that act like arrays but know about manipulating file names and paths. * A library of prepackaged tasks to make building rakefiles easier. For example, tasks for building tarballs. (Formerly tasks for building RDoc, Gems, and publishing to FTP were included in rake but they're now available in RDoc, RubyGems, and rake-contrib respectively.) * Supports parallel execution of tasks. == Installation === Gem Installation Download and install rake with the following. gem install rake == Usage === Simple Example First, you must write a "Rakefile" file which contains the build rules. Here's a simple example: task default: %w[test] task :test do ruby "test/unittest.rb" end This Rakefile has two tasks: * A task named "test", which -- upon invocation -- will run a unit test file in Ruby. * A task named "default". This task does nothing by itself, but it has exactly one dependency, namely the "test" task. Invoking the "default" task will cause Rake to invoke the "test" task as well. Running the "rake" command without any options will cause it to run the "default" task in the Rakefile: % ls Rakefile test/ % rake (in /home/some_user/Projects/rake) ruby test/unittest.rb ....unit test output here... Type "rake --help" for all available options. == Resources === Rake Information * {Rake command-line}[rdoc-ref:doc/command_line_usage.rdoc] * {Writing Rakefiles}[rdoc-ref:doc/rakefile.rdoc] * The original {Rake announcement}[rdoc-ref:doc/rational.rdoc] * Rake {glossary}[rdoc-ref:doc/glossary.rdoc] === Presentations and Articles about Rake * Avdi Grimm's rake series: 1. {Rake Basics}[http://devblog.avdi.org/2014/04/21/rake-part-1-basics/] 2. {Rake File Lists}[http://devblog.avdi.org/2014/04/22/rake-part-2-file-lists/] 3. {Rake Rules}[http://devblog.avdi.org/2014/04/23/rake-part-3-rules/] 4. {Rake Pathmap}[http://devblog.avdi.org/2014/04/24/rake-part-4-pathmap/] 5. {File Operations}[http://devblog.avdi.org/2014/04/25/rake-part-5-file-operations/] 6. {Clean and Clobber}[http://devblog.avdi.org/2014/04/28/rake-part-6-clean-and-clobber/] 7. {MultiTask}[http://devblog.avdi.org/2014/04/29/rake-part-7-multitask/] * {Jim Weirich's 2003 RubyConf presentation}[http://web.archive.org/web/20140221123354/http://onestepback.org/articles/buildingwithrake/] * Martin Fowler's article on Rake: http://martinfowler.com/articles/rake.html == Other Make Re-envisionings ... Rake is a late entry in the make replacement field. Here are links to other projects with similar (and not so similar) goals. * http://directory.fsf.org/wiki/Bras -- Bras, one of earliest implementations of "make in a scripting language". * http://www.a-a-p.org -- Make in Python * http://ant.apache.org -- The Ant project * http://search.cpan.org/search?query=PerlBuildSystem -- The Perl Build System * http://www.rubydoc.info/gems/rant/0.5.7/frames -- Rant, another Ruby make tool. == Credits [Jim Weirich] Who originally created Rake. [Ryan Dlugosz] For the initial conversation that sparked Rake. [Nobuyoshi Nakada ] For the initial patch for rule support. [Tilman Sauerbeck ] For the recursive rule patch. [Eric Hodel] For aid in maintaining rake. [Hiroshi SHIBATA] Maintainer of Rake 10.X and Rake 11.X == License Rake is available under an MIT-style license. :include: MIT-LICENSE --- = Other stuff Author:: Jim Weirich Requires:: Ruby 2.0.0 or later License:: Copyright Jim Weirich. Released under an MIT-style license. See the MIT-LICENSE file included in the distribution. == Warranty This software is provided "as is" and without any express or implied warranties, including, without limitation, the implied warranties of merchantability and fitness for a particular purpose. == Historical Rake was originally created by Jim Weirich, who unfortunately passed away in February 2014. This repository was originally hosted at {github.com/jimweirich/rake}[https://github.com/jimweirich/rake/], however with his passing, has been moved to {ruby/rake}[https://github.com/ruby/rake]. You can view Jim's last commit here: https://github.com/jimweirich/rake/tree/336559f28f55bce418e2ebcc0a57548dcbac4025 You can {read more about Jim}[https://en.wikipedia.org/wiki/Jim_Weirich] at Wikipedia. Thank you for this great tool, Jim. We'll remember you. rake-12.3.1/Rakefile000066400000000000000000000017051325463231200141710ustar00rootroot00000000000000# Rakefile for rake -*- ruby -*- # Copyright 2003, 2004, 2005 by Jim Weirich (jim@weirichhouse.org) # All rights reserved. # This file may be distributed under an MIT style license. See # MIT-LICENSE for details. lib = File.expand_path("../lib", __FILE__) $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib) begin require "bundler/gem_tasks" rescue LoadError end require "rake/testtask" Rake::TestTask.new(:test) do |t| t.libs << "test" t.verbose = true t.test_files = FileList["test/**/test_*.rb"] end require "rdoc/task" RDoc::Task.new do |doc| doc.main = "README.rdoc" doc.title = "Rake -- Ruby Make" doc.rdoc_files = FileList.new %w[lib MIT-LICENSE doc/**/*.rdoc *.rdoc] doc.rdoc_dir = "html" end task ghpages: :rdoc do %x[git checkout gh-pages] require "fileutils" FileUtils.rm_rf "/tmp/html" FileUtils.mv "html", "/tmp" FileUtils.rm_rf "*" FileUtils.cp_r Dir.glob("/tmp/html/*"), "." end task default: :test rake-12.3.1/appveyor.yml000066400000000000000000000007751325463231200151220ustar00rootroot00000000000000--- clone_depth: 10 install: - SET PATH=C:\Ruby%ruby_version%\bin;%PATH% - gem install minitest build: off test_script: - ruby -Ilib exe/rake deploy: off environment: matrix: - ruby_version: "200" - ruby_version: "200-x64" - ruby_version: "21" - ruby_version: "21-x64" - ruby_version: "22" - ruby_version: "22-x64" - ruby_version: "23" - ruby_version: "23-x64" - ruby_version: "24" - ruby_version: "24-x64" - ruby_version: "25" - ruby_version: "25-x64" rake-12.3.1/bin/000077500000000000000000000000001325463231200132715ustar00rootroot00000000000000rake-12.3.1/bin/console000077500000000000000000000001251325463231200146570ustar00rootroot00000000000000#!/usr/bin/env ruby require "bundler/setup" require "rake" require "irb" IRB.start rake-12.3.1/bin/setup000077500000000000000000000001121325463231200143510ustar00rootroot00000000000000#!/usr/bin/env bash set -euo pipefail IFS=$'\n\t' set -vx bundle install rake-12.3.1/doc/000077500000000000000000000000001325463231200132665ustar00rootroot00000000000000rake-12.3.1/doc/command_line_usage.rdoc000066400000000000000000000135061325463231200177550ustar00rootroot00000000000000= Rake Command Line Usage Rake is invoked from the command line using: % rake [options ...] [VAR=VALUE ...] [targets ...] Options are: [name=value] Set the environment variable name to value during the execution of the rake command. You can access the value by using ENV['name']. [--all (-A)] Used in combination with the -T and -D options, will force those options to show all the tasks, even the ones without comments. [--backtrace{=_output_} (-n)] Enable a full backtrace (i.e. like --trace, but without the task tracing details). The _output_ parameter is optional, but if specified it controls where the backtrace output is sent. If _output_ is stdout, then backtrace output is directed to standard output. If _output_ is stderr, or if it is missing, then the backtrace output is sent to standard error. [--comments] Used in combination with the -W options to force the output to contain commented options only. This is the reverse of --all. [--describe _pattern_ (-D)] Describe the tasks (matching optional PATTERN), then exit. [--dry-run (-n)] Do a dry run. Print the tasks invoked and executed, but do not actually execute any of the actions. [--execute _code_ (-e)] Execute some Ruby code and exit. [--execute-print _code_ (-p)] Execute some Ruby code, print the result, and exit. [--execute-continue _code_ (-E)] Execute some Ruby code, then continue with normal task processing. [--help (-H)] Display some help text and exit. [--jobs _number_ (-j)] Specifies the maximum number of concurrent threads allowed. Rake will allocate threads as needed up to this maximum number. If omitted, Rake will attempt to estimate the number of CPUs on the system and add 4 to that number. The concurrent threads are used to execute the multitask prerequisites. Also see the -m option which turns all tasks into multitasks. Sample values: (no -j) : Allow up to (# of CPUs + 4) number of threads --jobs : Allow unlimited number of threads --jobs=1 : Allow only one thread (the main thread) --jobs=16 : Allow up to 16 concurrent threads [--job-stats _level_] Display job statistics at the completion of the run. By default, this will display the requested number of active threads (from the -j options) and the maximum number of threads in play at any given time. If the optional _level_ is history, then a complete trace of task history will be displayed on standard output. [--libdir _directory_ (-I)] Add _directory_ to the list of directories searched for require. [--multitask (-m)] Treat all tasks as multitasks. ('make/drake' semantics) [--nosearch (-N)] Do not search for a Rakefile in parent directories. [--prereqs (-P)] Display a list of all tasks and their immediate prerequisites. [--quiet (-q)] Do not echo commands from FileUtils. [--rakefile _filename_ (-f)] Use _filename_ as the name of the rakefile. The default rakefile names are +rakefile+ and +Rakefile+ (with +rakefile+ taking precedence). If the rakefile is not found in the current directory, +rake+ will search parent directories for a match. The directory where the Rakefile is found will become the current directory for the actions executed in the Rakefile. [--rakelibdir _rakelibdir_ (-R)] Auto-import any .rake files in RAKELIBDIR. (default is 'rakelib') [--require _name_ (-r)] Require _name_ before executing the Rakefile. [--rules] Trace the rules resolution. [--silent (-s)] Like --quiet, but also suppresses the 'in directory' announcement. [--suppress-backtrace _pattern_ ] Line matching the regular expression _pattern_ will be removed from the backtrace output. Note that the --backtrace option is the full backtrace without these lines suppressed. [--system (-g)] Use the system wide (global) rakefiles. The project Rakefile is ignored. By default, the system wide rakefiles are used only if no project Rakefile is found. On Unix-like system, the system wide rake files are located in $HOME/.rake. On a windows system they are stored in $APPDATA/Rake. [--no-system (-G)] Use the project level Rakefile, ignoring the system-wide (global) rakefiles. [--tasks pattern (-T)] Display a list of the major tasks and their comments. Comments are defined using the "desc" command. If a pattern is given, then only tasks matching the pattern are displayed. [--trace{=_output_} (-t)] Turn on invoke/execute tracing. Also enable full backtrace on errors. The _output_ parameter is optional, but if specified it controls where the trace output is sent. If _output_ is stdout, then trace output is directed to standard output. If _output_ is stderr, or if it is missing, then trace output is sent to standard error. [--verbose (-v)] Echo the Sys commands to standard output. [--version (-V)] Display the program version and exit. [--where pattern (-W)] Display tasks that match pattern and the file and line number where the task is defined. By default this option will display all tasks, not just the tasks that have descriptions. [--no-deprecation-warnings (-X)] Do not display the deprecation warnings. In addition, any command line option of the form VAR=VALUE will be added to the environment hash ENV and may be tested in the Rakefile. rake-12.3.1/doc/example/000077500000000000000000000000001325463231200147215ustar00rootroot00000000000000rake-12.3.1/doc/example/Rakefile1000066400000000000000000000012361325463231200164510ustar00rootroot00000000000000# Example Rakefile -*- ruby -*- task :default => [:main] file "a.o" => ["a.c"] do |t| src = t.name.sub(/\.o$/, '.c') sh "gcc #{src} -c -o #{t.name}" end file "b.o" => ["b.c"] do |t| src = t.name.sub(/\.o$/, '.c') sh "gcc #{src} -c -o #{t.name}" end file "main.o" => ["main.c"] do |t| src = t.name.sub(/\.o$/, '.c') sh "gcc #{src} -c -o #{t.name}" end OBJFILES = ["a.o", "b.o", "main.o"] task :obj => OBJFILES file "main" => OBJFILES do |t| sh "gcc -o #{t.name} main.o a.o b.o" end task :clean do rm_f FileList['*.o'] Dir['*~'].each { |fn| rm_f fn } end task :clobber => [:clean] do rm_f "main" end task :run => ["main"] do sh "./main" end rake-12.3.1/doc/example/Rakefile2000066400000000000000000000011271325463231200164510ustar00rootroot00000000000000# Example Rakefile -*- ruby -*- # Using the power of Ruby task :default => [:main] def ext(fn, newext) fn.sub(/\.[^.]+$/, newext) end SRCFILES = Dir['*.c'] OBJFILES = SRCFILES.collect { |fn| ext(fn,".o") } OBJFILES.each do |objfile| srcfile = ext(objfile, ".c") file objfile => [srcfile] do |t| sh "gcc #{srcfile} -c -o #{t.name}" end end file "main" => OBJFILES do |t| sh "gcc -o #{t.name} main.o a.o b.o" end task :clean do rm_f FileList['*.o'] Dir['*~'].each { |fn| rm_f fn } end task :clobber => [:clean] do rm_f "main" end task :run => ["main"] do sh "./main" end rake-12.3.1/doc/example/a.c000066400000000000000000000001011325463231200152750ustar00rootroot00000000000000#include void a() { printf ("In function a\n"); } rake-12.3.1/doc/example/b.c000066400000000000000000000001011325463231200152760ustar00rootroot00000000000000#include void b() { printf ("In function b\n"); } rake-12.3.1/doc/example/main.c000066400000000000000000000001471325463231200160130ustar00rootroot00000000000000#include extern void a(); extern void b(); int main () { a(); b(); return 0; } rake-12.3.1/doc/glossary.rdoc000066400000000000000000000033641325463231200160100ustar00rootroot00000000000000= Glossary action :: Code to be executed in order to perform a task. Actions in a Rakefile are specified in a code block. (Usually delimited by +do+/+end+ pairs.) execute :: When a task is executed, all of its actions are performed in the order they were defined. Note that, unlike invoke, execute always executes the actions (without invoking or executing the prerequisites). file task (Rake::FileTask) :: A file task is a task whose purpose is to create a file (which has the same name as the task). When invoked, a file task will only execute if one or more of the following conditions are true. 1. The associated file does not exist. 2. A prerequisite has a later time stamp than the existing file. Because normal Tasks always have the current time as timestamp, a FileTask that has a normal Task prerequisite will always execute. invoke :: When a task is invoked, first we check to see if it has been invoked before. If it has been, then nothing else is done. If this is the first time it has been invoked, then we invoke each of its prerequisites. Finally, we check to see if we need to execute the actions of this task by calling Rake::Task#needed?. If the task is needed, we execute its actions. NOTE: Prerequisites are still invoked even if the task is not needed. prerequisites :: Every task has a (possibly empty) set of prerequisites. A prerequisite P to Task T is itself a task that must be invoked before Task T. rule :: A rule is a recipe for synthesizing a task when no task is explicitly defined. Rules generally synthesize file tasks. task (Rake::Task) :: The basic unit of work in a Rakefile. A task has a name, a set of prerequisites, and a list of actions to be performed. rake-12.3.1/doc/jamis.rb000066400000000000000000000261651325463231200147300ustar00rootroot00000000000000# frozen_string_literal: true module RDoc module Page FONTS = "\"Bitstream Vera Sans\", Verdana, Arial, Helvetica, sans-serif" STYLE = < pre { padding: 0.5em; border: 1px dotted black; background: #FFE; } CSS XHTML_PREAMBLE = %{ } HEADER = XHTML_PREAMBLE + < %title% ENDHEADER FILE_PAGE = <
File
%short_name%
Path: %full_path% IF:cvsurl  (CVS) ENDIF:cvsurl
Modified: %dtm_modified%

HTML ################################################################### CLASS_PAGE = < %classmod%
%full_name% IF:parent ENDIF:parent
In: START:infiles HREF:full_path_url:full_path: IF:cvsurl  (CVS) ENDIF:cvsurl END:infiles
Parent: IF:par_url ENDIF:par_url %parent% IF:par_url ENDIF:par_url
HTML ################################################################### METHOD_LIST = < IF:diagram
%diagram%
ENDIF:diagram IF:description
%description%
ENDIF:description IF:requires
Required Files
    START:requires
  • HREF:aref:name:
  • END:requires
ENDIF:requires IF:toc
Contents
ENDIF:toc IF:methods
Methods
    START:methods
  • HREF:aref:name:
  • END:methods
ENDIF:methods IF:includes
Included Modules
    START:includes
  • HREF:aref:name:
  • END:includes
ENDIF:includes START:sections IF:sectitle IF:seccomment
%seccomment%
ENDIF:seccomment ENDIF:sectitle IF:classlist
Classes and Modules
%classlist% ENDIF:classlist IF:constants
Constants
START:constants IF:desc ENDIF:desc END:constants
%name% = %value%
  %desc%
ENDIF:constants IF:attributes
Attributes
START:attributes END:attributes
IF:rw [%rw%] ENDIF:rw %name% %a_desc%
ENDIF:attributes IF:method_list START:method_list IF:methods
%type% %category% methods
START:methods
IF:callseq %callseq% ENDIF:callseq IFNOT:callseq %name%%params% ENDIF:callseq IF:codeurl [ source ] ENDIF:codeurl
IF:m_desc
%m_desc%
ENDIF:m_desc IF:aka
This method is also aliased as START:aka %name% END:aka
ENDIF:aka IF:sourcecode
%sourcecode%
ENDIF:sourcecode
END:methods ENDIF:methods END:method_list ENDIF:method_list END:sections HTML FOOTER = < ENDFOOTER BODY = HEADER + <
#{METHOD_LIST}
#{FOOTER} ENDBODY ########################## Source code ########################## SRC_PAGE = XHTML_PREAMBLE + < %title%
%code%
HTML ########################## Index ################################ FR_INDEX_BODY = <
START:entries %name%
END:entries
HTML CLASS_INDEX = FILE_INDEX METHOD_INDEX = FILE_INDEX INDEX = XHTML_PREAMBLE + < %title% IF:inline_source ENDIF:inline_source IFNOT:inline_source ENDIF:inline_source <body bgcolor="white"> Click <a href="html/index.html">here</a> for a non-frames version of this page. </body> HTML end end rake-12.3.1/doc/proto_rake.rdoc000066400000000000000000000047071325463231200163140ustar00rootroot00000000000000= Original Prototype Rake This is the original 100 line prototype rake program. --- #!/usr/bin/env ruby require 'ftools' class Task TASKS = Hash.new attr_reader :prerequisites def initialize(task_name) @name = task_name @prerequisites = [] @actions = [] end def enhance(deps=nil, &block) @prerequisites |= deps if deps @actions << block if block_given? self end def name @name.to_s end def invoke @prerequisites.each { |n| Task[n].invoke } execute if needed? end def execute return if @triggered @triggered = true @actions.collect { |act| result = act.call(self) }.last end def needed? true end def timestamp Time.now end class << self def [](task_name) TASKS[intern(task_name)] or fail "Don't know how to rake #{task_name}" end def define_task(args, &block) case args when Hash fail "Too Many Target Names: #{args.keys.join(' ')}" if args.size > 1 fail "No Task Name Given" if args.size < 1 task_name = args.keys[0] deps = args[task_name] else task_name = args deps = [] end deps = deps.collect {|d| intern(d) } get(task_name).enhance(deps, &block) end def get(task_name) name = intern(task_name) TASKS[name] ||= self.new(name) end def intern(task_name) (Symbol === task_name) ? task_name : task_name.intern end end end class FileTask < Task def needed? return true unless File.exist?(name) latest_prereq = @prerequisites.collect{|n| Task[n].timestamp}.max return false if latest_prereq.nil? timestamp < latest_prereq end def timestamp File.new(name.to_s).mtime end end def task(args, &block) Task.define_task(args, &block) end def file(args, &block) FileTask.define_task(args, &block) end def sys(cmd) puts cmd system(cmd) or fail "Command Failed: [#{cmd}]" end def rake begin here = Dir.pwd while ! File.exist?("Rakefile") Dir.chdir("..") fail "No Rakefile found" if Dir.pwd == here here = Dir.pwd end puts "(in #{Dir.pwd})" load "./Rakefile" ARGV.push("default") if ARGV.size == 0 ARGV.each { |task_name| Task[task_name].invoke } rescue Exception => ex puts "rake aborted ... #{ex.message}" puts ex.backtrace.find {|str| str =~ /Rakefile/ } || "" end end if __FILE__ == $0 then rake end rake-12.3.1/doc/rake.1000066400000000000000000000072151325463231200142770ustar00rootroot00000000000000.Dd June 12, 2016 .Dt RAKE 1 .Os rake 11.2.2 .Sh NAME .Nm rake .Nd make-like build utility for Ruby .Sh SYNOPSIS .Nm .Op Fl f Ar rakefile .Op Ar options .Ar targets ... .Sh DESCRIPTION .Nm is a .Xr make 1 Ns -like build utility for Ruby. Tasks and dependencies are specified in standard Ruby syntax. .Sh OPTIONS .Bl -tag -width Ds .It Fl m , Fl -multitask Treat all tasks as multitasks. .It Fl B , Fl -build-all Build all prerequisites, including those which are up\-to\-date. .It Fl j , Fl -jobs Ar num_jobs Specifies the maximum number of tasks to execute in parallel (default is number of CPU cores + 4). .El .Ss Modules .Bl -tag -width Ds .It Fl I , Fl -libdir Ar libdir Include .Ar libdir in the search path for required modules. .It Fl r , Fl -require Ar module Require .Ar module before executing .Pa rakefile . .El .Ss Rakefile location .Bl -tag -width Ds .It Fl f , Fl -rakefile Ar filename Use .Ar filename as the rakefile to search for. .It Fl N , Fl -no-search , Fl -nosearch Do not search parent directories for the Rakefile. .It Fl G , Fl -no-system , Fl -nosystem Use standard project Rakefile search paths, ignore system wide rakefiles. .It Fl R , Fl -rakelib Ar rakelibdir , Fl -rakelibdir Ar rakelibdir Auto-import any .rake files in .Ar rakelibdir (default is .Sq rakelib ) .It Fl g , Fl -system Use system-wide (global) rakefiles (usually .Pa ~/.rake/*.rake ) . .El .Ss Debugging .Bl -tag -width Ds .It Fl -backtrace Ns = Ns Ar out Enable full backtrace. .Ar out can be .Dv stderr (default) or .Dv stdout . .It Fl t , Fl -trace Ns = Ns Ar out Turn on invoke/execute tracing, enable full backtrace. .Ar out can be .Dv stderr (default) or .Dv stdout . .It Fl -suppress-backtrace Ar pattern Suppress backtrace lines matching regexp .Ar pattern . Ignored if .Fl -trace is on. .It Fl -rules Trace the rules resolution. .It Fl n , Fl -dry-run Do a dry run without executing actions. .It Fl T , Fl -tasks Op Ar pattern Display the tasks (matching optional .Ar pattern ) with descriptions, then exit. .It Fl D , Fl -describe Op Ar pattern Describe the tasks (matching optional .Ar pattern ) , then exit. .It Fl W , Fl -where Op Ar pattern Describe the tasks (matching optional .Ar pattern ) , then exit. .It Fl P , Fl -prereqs Display the tasks and dependencies, then exit. .It Fl e , Fl -execute Ar code Execute some Ruby code and exit. .It Fl p , Fl -execute-print Ar code Execute some Ruby code, print the result, then exit. .It Fl E , Fl -execute-continue Ar code Execute some Ruby code, then continue with normal task processing. .El .Ss Information .Bl -tag -width Ds .It Fl v , Fl -verbose Log message to standard output. .It Fl q , Fl -quiet Do not log messages to standard output. .It Fl s , Fl -silent Like .Fl -quiet , but also suppresses the .Sq in directory announcement. .It Fl X , Fl -no-deprecation-warnings Disable the deprecation warnings. .It Fl -comments Show commented tasks only .It Fl A , Fl -all Show all tasks, even uncommented ones (in combination with .Fl T or .Fl D ) .It Fl -job-stats Op Ar level Display job statistics. If .Ar level is .Sq history , displays a complete job list. .It Fl V , Fl -version Display the program version. .It Fl h , Fl H , Fl -help Display a help message. .El .Sh SEE ALSO The complete documentation for .Nm rake has been installed at .Pa /usr/share/doc/rake-doc/html/index.html . It is also available online at .Lk https://ruby.github.io/rake . .Sh AUTHORS .An -nosplit .Nm was written by .An Jim Weirich Aq Mt jim@weirichhouse.org . .Pp This manual was created by .An Caitlin Matos Aq Mt caitlin.matos@zoho.com for the Debian project (but may be used by others). It was inspired by the manual by .An Jani Monoses Aq Mt jani@iv.ro for the Ubuntu project. rake-12.3.1/doc/rakefile.rdoc000066400000000000000000000503421325463231200157250ustar00rootroot00000000000000= Rakefile Format First of all, there is no special format for a Rakefile. A Rakefile contains executable Ruby code. Anything legal in a ruby script is allowed in a Rakefile. Now that we understand there is no special syntax in a Rakefile, there are some conventions that are used in a Rakefile that are a little unusual in a typical Ruby program. Since a Rakefile is tailored to specifying tasks and actions, the idioms used in a Rakefile are designed to support that. So, what goes into a Rakefile? == Tasks Tasks are the main unit of work in a Rakefile. Tasks have a name (usually given as a symbol or a string), a list of prerequisites (more symbols or strings) and a list of actions (given as a block). === Simple Tasks A task is declared by using the +task+ method. +task+ takes a single parameter that is the name of the task. task :name === Tasks with Prerequisites Any prerequisites are given as a list (enclosed in square brackets) following the name and an arrow (=>). task name: [:prereq1, :prereq2] *NOTE:* Although this syntax looks a little funky, it is legal Ruby. We are constructing a hash where the key is :name and the value for that key is the list of prerequisites. It is equivalent to the following ... hash = Hash.new hash[:name] = [:prereq1, :prereq2] task(hash) You can also use strings for task names and prerequisites, rake doesn't care. This is the same task definition: task 'name' => %w[prereq1 prereq2] As is this: task name: %w[prereq1 prereq2] We'll prefer this style for regular tasks with prerequisites throughout the rest of the document. Using an array of strings for the prerequisites means you will need to make fewer changes if you need to move tasks into namespaces or perform other refactorings. === Tasks with Actions Actions are defined by passing a block to the +task+ method. Any Ruby code can be placed in the block. The block may reference the task object via the block parameter. task name: [:prereq1, :prereq2] do |t| # actions (may reference t) end === Multiple Definitions A task may be specified more than once. Each specification adds its prerequisites and actions to the existing definition. This allows one part of a rakefile to specify the actions and a different rakefile (perhaps separately generated) to specify the dependencies. For example, the following is equivalent to the single task specification given above. task :name task name: :prereq1 task name: %w[prereq2] task :name do |t| # actions end == File Tasks Some tasks are designed to create a file from one or more other files. Tasks that generate these files may be skipped if the file already exists. File tasks are used to specify file creation tasks. File tasks are declared using the +file+ method (instead of the +task+ method). In addition, file tasks are usually named with a string rather than a symbol. The following file task creates a executable program (named +prog+) given two object files named +a.o+ and +b.o+. The tasks for creating +a.o+ and +b.o+ are not shown. file "prog" => ["a.o", "b.o"] do |t| sh "cc -o #{t.name} #{t.prerequisites.join(' ')}" end == Directory Tasks It is common to need to create directories upon demand. The +directory+ convenience method is a short-hand for creating a FileTask that creates the directory. For example, the following declaration ... directory "testdata/examples/doc" is equivalent to ... file "testdata" do |t| mkdir t.name end file "testdata/examples" => ["testdata"] do |t| mkdir t.name end file "testdata/examples/doc" => ["testdata/examples"] do |t| mkdir t.name end The +directory+ method does not accept prerequisites or actions, but both prerequisites and actions can be added later. For example ... directory "testdata" file "testdata" => ["otherdata"] file "testdata" do cp Dir["standard_data/*.data"], "testdata" end == Tasks with Parallel Prerequisites Rake allows parallel execution of prerequisites using the following syntax: multitask copy_files: %w[copy_src copy_doc copy_bin] do puts "All Copies Complete" end In this example, +copy_files+ is a normal rake task. Its actions are executed whenever all of its prerequisites are done. The big difference is that the prerequisites (+copy_src+, +copy_bin+ and +copy_doc+) are executed in parallel. Each of the prerequisites are run in their own Ruby thread, possibly allowing faster overall runtime. === Secondary Prerequisites If any of the primary prerequisites of a multitask have common secondary prerequisites, all of the primary/parallel prerequisites will wait until the common prerequisites have been run. For example, if the copy_xxx tasks have the following prerequisites: task copy_src: :prep_for_copy task copy_bin: :prep_for_copy task copy_doc: :prep_for_copy Then the +prep_for_copy+ task is run before starting all the copies in parallel. Once +prep_for_copy+ is complete, +copy_src+, +copy_bin+, and +copy_doc+ are all run in parallel. Note that +prep_for_copy+ is run only once, even though it is referenced in multiple threads. === Thread Safety The Rake internal data structures are thread-safe with respect to the multitask parallel execution, so there is no need for the user to do extra synchronization for Rake's benefit. However, if there are user data structures shared between the parallel prerequisites, the user must do whatever is necessary to prevent race conditions. == Tasks with Arguments Prior to version 0.8.0, rake was only able to handle command line arguments of the form NAME=VALUE that were passed into Rake via the ENV hash. Many folks had asked for some kind of simple command line arguments, perhaps using "--" to separate regular task names from argument values on the command line. The problem is that there was no easy way to associate positional arguments on the command line with different tasks. Suppose both tasks :a and :b expect a command line argument: does the first value go with :a? What if :b is run first? Should it then get the first command line argument. Rake 0.8.0 solves this problem by explicitly passing values directly to the tasks that need them. For example, if I had a release task that required a version number, I could say: rake release[0.8.2] And the string "0.8.2" will be passed to the :release task. Multiple arguments can be passed by separating them with a comma, for example: rake name[john,doe] Just a few words of caution. The rake task name and its arguments need to be a single command line argument to rake. This generally means no spaces. If spaces are needed, then the entire name + argument string should be quoted. Something like this: rake "name[billy bob, smith]" (Quoting rules vary between operating systems and shells, so make sure you consult the proper docs for your OS/shell). === Tasks that Expect Parameters Parameters are only given to tasks that are setup to expect them. In order to handle named parameters, the task declaration syntax for tasks has been extended slightly. For example, a task that needs a first name and last name might be declared as: task :name, [:first_name, :last_name] The first argument is still the name of the task (:name in this case). The next two arguments are the names of the parameters expected by :name in an array (:first_name and :last_name in the example). To access the values of the parameters, the block defining the task behaviour can now accept a second parameter: task :name, [:first_name, :last_name] do |t, args| puts "First name is #{args.first_name}" puts "Last name is #{args.last_name}" end The first argument of the block "t" is always bound to the current task object. The second argument "args" is an open-struct like object that allows access to the task arguments. Extra command line arguments to a task are ignored. If you wish to specify default values for the arguments, you can use the with_defaults method in the task body. Here is the above example where we specify default values for the first and last names: task :name, [:first_name, :last_name] do |t, args| args.with_defaults(:first_name => "John", :last_name => "Dough") puts "First name is #{args.first_name}" puts "Last name is #{args.last_name}" end === Tasks that Expect Parameters and Have Prerequisites Tasks that use parameters have a slightly different format for prerequisites. Use the arrow notation to indicate the prerequisites for tasks with arguments. For example: task :name, [:first_name, :last_name] => [:pre_name] do |t, args| args.with_defaults(:first_name => "John", :last_name => "Dough") puts "First name is #{args.first_name}" puts "Last name is #{args.last_name}" end === Tasks that take Variable-length Parameters Tasks that need to handle a list of values as a parameter can use the extras method of the args variable. This allows for tasks that can loop over a variable number of values, and its compatible with named parameters as well: task :email, [:message] do |t, args| mail = Mail.new(args.message) recipients = args.extras recipients.each do |target| mail.send_to(target) end end There is also the convenience method to_a that returns all parameters in the sequential order they were given, including those associated with named parameters. === Deprecated Task Parameters Format There is an older format for declaring task parameters that omitted the task argument array and used the :needs keyword to introduce the dependencies. That format is still supported for compatibility, but is not recommended for use. The older format may be dropped in future versions of rake. == Accessing Task Programmatically Sometimes it is useful to manipulate tasks programmatically in a Rakefile. To find a task object use Rake::Task.[]. === Programmatic Task Example For example, the following Rakefile defines two tasks. The :doit task simply prints a simple "DONE" message. The :dont class will lookup the doit class and remove (clear) all of its prerequisites and actions. task :doit do puts "DONE" end task :dont do Rake::Task[:doit].clear end Running this example: $ rake doit (in /Users/jim/working/git/rake/x) DONE $ rake dont doit (in /Users/jim/working/git/rake/x) $ The ability to programmatically manipulate tasks gives rake very powerful meta-programming capabilities w.r.t. task execution, but should be used with caution. == Rules When a file is named as a prerequisite, but does not have a file task defined for it, Rake will attempt to synthesize a task by looking at a list of rules supplied in the Rakefile. Suppose we were trying to invoke task "mycode.o", but no task is defined for it. But the rakefile has a rule that look like this ... rule '.o' => ['.c'] do |t| sh "cc #{t.source} -c -o #{t.name}" end This rule will synthesize any task that ends in ".o". It has a prerequisite a source file with an extension of ".c" must exist. If Rake is able to find a file named "mycode.c", it will automatically create a task that builds "mycode.o" from "mycode.c". If the file "mycode.c" does not exist, rake will attempt to recursively synthesize a rule for it. When a task is synthesized from a rule, the +source+ attribute of the task is set to the matching source file. This allows us to write rules with actions that reference the source file. === Advanced Rules Any regular expression may be used as the rule pattern. Additionally, a proc may be used to calculate the name of the source file. This allows for complex patterns and sources. The following rule is equivalent to the example above. rule( /\.o$/ => [ proc {|task_name| task_name.sub(/\.[^.]+$/, '.c') } ]) do |t| sh "cc #{t.source} -c -o #{t.name}" end *NOTE:* Because of a _quirk_ in Ruby syntax, parenthesis are required on *rule* when the first argument is a regular expression. The following rule might be used for Java files ... rule '.class' => [ proc { |tn| tn.sub(/\.class$/, '.java').sub(/^classes\//, 'src/') } ] do |t| java_compile(t.source, t.name) end *NOTE:* +java_compile+ is a hypothetical method that invokes the java compiler. == Importing Dependencies Any ruby file (including other rakefiles) can be included with a standard Ruby +require+ command. The rules and declarations in the required file are just added to the definitions already accumulated. Because the files are loaded _before_ the rake targets are evaluated, the loaded files must be "ready to go" when the rake command is invoked. This makes generated dependency files difficult to use. By the time rake gets around to updating the dependencies file, it is too late to load it. The +import+ command addresses this by specifying a file to be loaded _after_ the main rakefile is loaded, but _before_ any targets on the command line are invoked. In addition, if the file name matches an explicit task, that task is invoked before loading the file. This allows dependency files to be generated and used in a single rake command invocation. Example: require 'rake/loaders/makefile' file ".depends.mf" => [SRC_LIST] do |t| sh "makedepend -f- -- #{CFLAGS} -- #{t.prerequisites} > #{t.name}" end import ".depends.mf" If ".depends" does not exist, or is out of date w.r.t. the source files, a new ".depends" file is generated using +makedepend+ before loading. == Comments Standard Ruby comments (beginning with "#") can be used anywhere it is legal in Ruby source code, including comments for tasks and rules. However, if you wish a task to be described using the "-T" switch, then you need to use the +desc+ command to describe the task. Example: desc "Create a distribution package" task package: %w[ ... ] do ... end The "-T" switch (or "--tasks" if you like to spell things out) will display a list of tasks that have a description. If you use +desc+ to describe your major tasks, you have a semi-automatic way of generating a summary of your Rake file. $ rake -T (in /home/.../rake) rake clean # Remove any temporary products. rake clobber # Remove any generated file. rake clobber_rdoc # Remove rdoc products rake contrib_test # Run tests for contrib_test rake default # Default Task rake install # Install the application rake lines # Count lines in the main rake file rake rdoc # Build the rdoc HTML Files rake rerdoc # Force a rebuild of the RDOC files rake test # Run tests rake testall # Run all test targets Only tasks with descriptions will be displayed with the "-T" switch. Use "-P" (or "--prereqs") to get a list of all tasks and their prerequisites. == Namespaces As projects grow (and along with it, the number of tasks), it is common for task names to begin to clash. For example, if you might have a main program and a set of sample programs built by a single Rakefile. By placing the tasks related to the main program in one namespace, and the tasks for building the sample programs in a different namespace, the task names will not interfere with each other. For example: namespace "main" do task :build do # Build the main program end end namespace "samples" do task :build do # Build the sample programs end end task build: %w[main:build samples:build] Referencing a task in a separate namespace can be achieved by prefixing the task name with the namespace and a colon (e.g. "main:build" refers to the :build task in the +main+ namespace). Nested namespaces are supported. Note that the name given in the +task+ command is always the unadorned task name without any namespace prefixes. The +task+ command always defines a task in the current namespace. === FileTasks File task names are not scoped by the namespace command. Since the name of a file task is the name of an actual file in the file system, it makes little sense to include file task names in name space. Directory tasks (created by the +directory+ command) are a type of file task and are also not affected by namespaces. === Name Resolution When looking up a task name, rake will start with the current namespace and attempt to find the name there. If it fails to find a name in the current namespace, it will search the parent namespaces until a match is found (or an error occurs if there is no match). The "rake" namespace is a special implicit namespace that refers to the toplevel names. If a task name begins with a "^" character, the name resolution will start in the parent namespace. Multiple "^" characters are allowed. Here is an example file with multiple :run tasks and how various names resolve in different locations. task :run namespace "one" do task :run namespace "two" do task :run # :run => "one:two:run" # "two:run" => "one:two:run" # "one:two:run" => "one:two:run" # "one:run" => "one:run" # "^run" => "one:run" # "^^run" => "rake:run" (the top level task) # "rake:run" => "rake:run" (the top level task) end # :run => "one:run" # "two:run" => "one:two:run" # "^run" => "rake:run" end # :run => "rake:run" # "one:run" => "one:run" # "one:two:run" => "one:two:run" == FileLists FileLists are the way Rake manages lists of files. You can treat a FileList as an array of strings for the most part, but FileLists support some additional operations. === Creating a FileList Creating a file list is easy. Just give it the list of file names: fl = FileList['file1.rb', file2.rb'] Or give it a glob pattern: fl = FileList['*.rb'] == Odds and Ends === do/end versus { } Blocks may be specified with either a +do+/+end+ pair, or with curly braces in Ruby. We _strongly_ recommend using +do+/+end+ to specify the actions for tasks and rules. Because the rakefile idiom tends to leave off parentheses on the task/file/rule methods, unusual ambiguities can arise when using curly braces. For example, suppose that the method +object_files+ returns a list of object files in a project. Now we use +object_files+ as the prerequisites in a rule specified with actions in curly braces. # DON'T DO THIS! file "prog" => object_files { # Actions are expected here (but it doesn't work)! } Because curly braces have a higher precedence than +do+/+end+, the block is associated with the +object_files+ method rather than the +file+ method. This is the proper way to specify the task ... # THIS IS FINE file "prog" => object_files do # Actions go here end == Rakefile Path When issuing the +rake+ command in a terminal, Rake will look for a Rakefile in the current directory. If a Rakefile is not found, it will search parent directories until one is found. For example, if a Rakefile resides in the +project/+ directory, moving deeper into the project's directory tree will not have an adverse effect on rake tasks: $ pwd /home/user/project $ cd lib/foo/bar $ pwd /home/user/project/lib/foo/bar $ rake run_pwd /home/user/project As far as rake is concerned, all tasks are run from the directory in which the Rakefile resides. === Multiple Rake Files Not all tasks need to be included in a single Rakefile. Additional rake files (with the file extension "+.rake+") may be placed in +rakelib+ directory located at the top level of a project (i.e. the same directory that contains the main +Rakefile+). Also, rails projects may include additional rake files in the +lib/tasks+ directory. === Clean and Clobber Tasks Through require 'rake/clean' Rake provides +clean+ and +clobber+ tasks: +clean+ :: Clean up the project by deleting scratch files and backup files. Add files to the +CLEAN+ FileList to have the +clean+ target handle them. +clobber+ :: Clobber all generated and non-source files in a project. The task depends on +clean+, so all the +CLEAN+ files will be deleted as well as files in the +CLOBBER+ FileList. The intent of this task is to return a project to its pristine, just unpacked state. You can add file names or glob patterns to both the +CLEAN+ and +CLOBBER+ lists. === Phony Task The phony task can be used as a dependency to allow file-based tasks to use non-file-based-tasks as prerequisites without forcing them to rebuild. You can require 'rake/phony' to add the +phony+ task. ---- == See * README.rdoc -- Main documentation for Rake. rake-12.3.1/doc/rational.rdoc000066400000000000000000000141101325463231200157450ustar00rootroot00000000000000= Why rake? Ok, let me state from the beginning that I never intended to write this code. I'm not convinced it is useful, and I'm not convinced anyone would even be interested in it. All I can say is that Why's onion truck must by been passing through the Ohio valley. What am I talking about? ... A Ruby version of Make. See, I can sense you cringing already, and I agree. The world certainly doesn't need yet another reworking of the "make" program. I mean, we already have "ant". Isn't that enough? It started yesterday. I was helping a coworker fix a problem in one of the Makefiles we use in our project. Not a particularly tough problem, but during the course of the conversation I began lamenting some of the shortcomings of make. In particular, in one of my makefiles I wanted to determine the name of a file dynamically and had to resort to some simple scripting (in Ruby) to make it work. "Wouldn't it be nice if you could just use Ruby inside a Makefile" I said. My coworker (a recent convert to Ruby) agreed, but wondered what it would look like. So I sketched the following on the whiteboard... "What if you could specify the make tasks in Ruby, like this ..." task "build" do java_compile(...args, etc ...) end "The task function would register "build" as a target to be made, and the block would be the action executed whenever the build system determined that it was time to do the build target." We agreed that would be cool, but writing make from scratch would be WAY too much work. And that was the end of that! ... Except I couldn't get the thought out of my head. What exactly would be needed to make the about syntax work as a make file? Hmmm, you would need to register the tasks, you need some way of specifying dependencies between tasks, and some way of kicking off the process. Hey! What if we did ... and fifteen minutes later I had a working prototype of Ruby make, complete with dependencies and actions. I showed the code to my coworker and we had a good laugh. It was just about a page worth of code that reproduced an amazing amount of the functionality of make. We were both truly stunned with the power of Ruby. But it didn't do everything make did. In particular, it didn't have timestamp based file dependencies (where a file is rebuilt if any of its prerequisite files have a later timestamp). Obviously THAT would be a pain to add and so Ruby Make would remain an interesting experiment. ... Except as I walked back to my desk, I started thinking about what file based dependencies would really need. Rats! I was hooked again, and by adding a new class and two new methods, file/timestamp dependencies were implemented. Ok, now I was really hooked. Last night (during CSI!) I massaged the code and cleaned it up a bit. The result is a bare-bones replacement for make in exactly 100 lines of code. For the curious, you can see it at ... * doc/proto_rake.rdoc Oh, about the name. When I wrote the example Ruby Make task on my whiteboard, my coworker exclaimed "Oh! I have the perfect name: Rake ... Get it? Ruby-Make. Rake!" He said he envisioned the tasks as leaves and Rake would clean them up ... or something like that. Anyways, the name stuck. Some quick examples ... A simple task to delete backup files ... task :clean do Dir['*~'].each {|fn| rm fn rescue nil} end Note that task names are symbols (they are slightly easier to type than quoted strings ... but you may use quoted string if you would rather). Rake makes the methods of the FileUtils module directly available, so we take advantage of the rm command. Also note the use of "rescue nil" to trap and ignore errors in the rm command. To run it, just type "rake clean". Rake will automatically find a Rakefile in the current directory (or above!) and will invoke the targets named on the command line. If there are no targets explicitly named, rake will invoke the task "default". Here's another task with dependencies ... task :clobber => [:clean] do rm_r "tempdir" end Task :clobber depends upon task :clean, so :clean will be run before :clobber is executed. Files are specified by using the "file" command. It is similar to the task command, except that the task name represents a file, and the task will be run only if the file doesn't exist, or if its modification time is earlier than any of its prerequisites. Here is a file based dependency that will compile "hello.cc" to "hello.o". file "hello.cc" file "hello.o" => ["hello.cc"] do |t| srcfile = t.name.sub(/\.o$/, ".cc") sh %{g++ #{srcfile} -c -o #{t.name}} end I normally specify file tasks with string (rather than symbols). Some file names can't be represented by symbols. Plus it makes the distinction between them more clear to the casual reader. Currently writing a task for each and every file in the project would be tedious at best. I envision a set of libraries to make this job easier. For instance, perhaps something like this ... require 'rake/ctools' Dir['*.c'].each do |fn| c_source_file(fn) end where "c_source_file" will create all the tasks need to compile all the C source files in a directory. Any number of useful libraries could be created for rake. That's it. There's no documentation (other than whats in this message). Does this sound interesting to anyone? If so, I'll continue to clean it up and write it up and publish it on RAA. Otherwise, I'll leave it as an interesting exercise and a tribute to the power of Ruby. Why /might/ rake be interesting to Ruby programmers. I don't know, perhaps ... * No weird make syntax (only weird Ruby syntax :-) * No need to edit or read XML (a la ant) * Platform independent build scripts. * Will run anywhere Ruby exists, so no need to have "make" installed. If you stay away from the "sys" command and use things like 'ftools', you can have a perfectly platform independent build script. Also rake is only 100 lines of code, so it can easily be packaged along with the rest of your code. So ... Sorry for the long rambling message. Like I said, I never intended to write this code at all. rake-12.3.1/exe/000077500000000000000000000000001325463231200133025ustar00rootroot00000000000000rake-12.3.1/exe/rake000077500000000000000000000022361325463231200141550ustar00rootroot00000000000000#!/usr/bin/env ruby #-- # Copyright (c) 2003, 2004, 2005, 2006, 2007 Jim Weirich # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to # deal in the Software without restriction, including without limitation the # rights to use, copy, modify, merge, publish, distribute, sublicense, and/or # sell copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS # IN THE SOFTWARE. #++ require "rake" Rake.application.run rake-12.3.1/lib/000077500000000000000000000000001325463231200132675ustar00rootroot00000000000000rake-12.3.1/lib/rake.rb000066400000000000000000000041621325463231200145410ustar00rootroot00000000000000# frozen_string_literal: true #-- # Copyright 2003-2010 by Jim Weirich (jim.weirich@gmail.com) # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to # deal in the Software without restriction, including without limitation the # rights to use, copy, modify, merge, publish, distribute, sublicense, and/or # sell copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS # IN THE SOFTWARE. #++ module Rake; end require "rake/version" require "rbconfig" require "fileutils" require "singleton" require "monitor" require "optparse" require "ostruct" require "rake/ext/string" require "rake/win32" require "rake/linked_list" require "rake/cpu_counter" require "rake/scope" require "rake/task_argument_error" require "rake/rule_recursion_overflow_error" require "rake/rake_module" require "rake/trace_output" require "rake/pseudo_status" require "rake/task_arguments" require "rake/invocation_chain" require "rake/task" require "rake/file_task" require "rake/file_creation_task" require "rake/multi_task" require "rake/dsl_definition" require "rake/file_utils_ext" require "rake/file_list" require "rake/default_loader" require "rake/early_time" require "rake/late_time" require "rake/name_space" require "rake/task_manager" require "rake/application" require "rake/backtrace" $trace = false # :stopdoc: # # Some top level Constants. FileList = Rake::FileList RakeFileUtils = Rake::FileUtilsExt rake-12.3.1/lib/rake/000077500000000000000000000000001325463231200142115ustar00rootroot00000000000000rake-12.3.1/lib/rake/application.rb000066400000000000000000000607771325463231200170620ustar00rootroot00000000000000# frozen_string_literal: true require "optparse" require "rake/task_manager" require "rake/file_list" require "rake/thread_pool" require "rake/thread_history_display" require "rake/trace_output" require "rake/win32" module Rake CommandLineOptionError = Class.new(StandardError) ## # Rake main application object. When invoking +rake+ from the # command line, a Rake::Application object is created and run. class Application include TaskManager include TraceOutput # The name of the application (typically 'rake') attr_reader :name # The original directory where rake was invoked. attr_reader :original_dir # Name of the actual rakefile used. attr_reader :rakefile # Number of columns on the terminal attr_accessor :terminal_columns # List of the top level task names (task names from the command line). attr_reader :top_level_tasks # Override the detected TTY output state (mostly for testing) attr_writer :tty_output DEFAULT_RAKEFILES = [ "rakefile", "Rakefile", "rakefile.rb", "Rakefile.rb" ].freeze # Initialize a Rake::Application object. def initialize super @name = "rake" @rakefiles = DEFAULT_RAKEFILES.dup @rakefile = nil @pending_imports = [] @imported = [] @loaders = {} @default_loader = Rake::DefaultLoader.new @original_dir = Dir.pwd @top_level_tasks = [] add_loader("rb", DefaultLoader.new) add_loader("rf", DefaultLoader.new) add_loader("rake", DefaultLoader.new) @tty_output = STDOUT.tty? @terminal_columns = ENV["RAKE_COLUMNS"].to_i set_default_options end # Run the Rake application. The run method performs the following # three steps: # # * Initialize the command line options (+init+). # * Define the tasks (+load_rakefile+). # * Run the top level tasks (+top_level+). # # If you wish to build a custom rake command, you should call # +init+ on your application. Then define any tasks. Finally, # call +top_level+ to run your top level tasks. def run(argv = ARGV) standard_exception_handling do init "rake", argv load_rakefile top_level end end # Initialize the command line parameters and app name. def init(app_name="rake", argv = ARGV) standard_exception_handling do @name = app_name begin args = handle_options argv rescue ArgumentError # Backword compatibility for capistrano args = handle_options end collect_command_line_tasks(args) end end # Find the rakefile and then load it and any pending imports. def load_rakefile standard_exception_handling do raw_load_rakefile end end # Run the top level tasks of a Rake application. def top_level run_with_threads do if options.show_tasks display_tasks_and_comments elsif options.show_prereqs display_prerequisites else top_level_tasks.each { |task_name| invoke_task(task_name) } end end end # Run the given block with the thread startup and shutdown. def run_with_threads thread_pool.gather_history if options.job_stats == :history yield thread_pool.join if options.job_stats stats = thread_pool.statistics puts "Maximum active threads: #{stats[:max_active_threads]} + main" puts "Total threads in play: #{stats[:total_threads_in_play]} + main" end ThreadHistoryDisplay.new(thread_pool.history).show if options.job_stats == :history end # Add a loader to handle imported files ending in the extension # +ext+. def add_loader(ext, loader) ext = ".#{ext}" unless ext =~ /^\./ @loaders[ext] = loader end # Application options from the command line def options @options ||= OpenStruct.new end # Return the thread pool used for multithreaded processing. def thread_pool # :nodoc: @thread_pool ||= ThreadPool.new(options.thread_pool_size || Rake.suggested_thread_count-1) end # internal ---------------------------------------------------------------- # Invokes a task with arguments that are extracted from +task_string+ def invoke_task(task_string) # :nodoc: name, args = parse_task_string(task_string) t = self[name] t.invoke(*args) end def parse_task_string(string) # :nodoc: /^([^\[]+)(?:\[(.*)\])$/ =~ string.to_s name = $1 remaining_args = $2 return string, [] unless name return name, [] if remaining_args.empty? args = [] begin /\s*((?:[^\\,]|\\.)*?)\s*(?:,\s*(.*))?$/ =~ remaining_args remaining_args = $2 args << $1.gsub(/\\(.)/, '\1') end while remaining_args return name, args end # Provide standard exception handling for the given block. def standard_exception_handling # :nodoc: yield rescue SystemExit # Exit silently with current status raise rescue OptionParser::InvalidOption => ex $stderr.puts ex.message exit(false) rescue Exception => ex # Exit with error message display_error_message(ex) exit_because_of_exception(ex) end # Exit the program because of an unhandled exception. # (may be overridden by subclasses) def exit_because_of_exception(ex) # :nodoc: exit(false) end # Display the error message that caused the exception. def display_error_message(ex) # :nodoc: trace "#{name} aborted!" display_exception_details(ex) trace "Tasks: #{ex.chain}" if has_chain?(ex) trace "(See full trace by running task with --trace)" unless options.backtrace end def display_exception_details(ex) # :nodoc: display_exception_details_seen << ex display_exception_message_details(ex) display_exception_backtrace(ex) display_cause_details(ex.cause) if has_cause?(ex) end def display_cause_details(ex) # :nodoc: return if display_exception_details_seen.include? ex trace "\nCaused by:" display_exception_details(ex) end def display_exception_details_seen # :nodoc: Thread.current[:rake_display_exception_details_seen] ||= [] end def has_cause?(ex) # :nodoc: ex.respond_to?(:cause) && ex.cause end def display_exception_message_details(ex) # :nodoc: if ex.instance_of?(RuntimeError) trace ex.message else trace "#{ex.class.name}: #{ex.message}" end end def display_exception_backtrace(ex) # :nodoc: if options.backtrace trace ex.backtrace.join("\n") else trace Backtrace.collapse(ex.backtrace).join("\n") end end # Warn about deprecated usage. # # Example: # Rake.application.deprecate("import", "Rake.import", caller.first) # def deprecate(old_usage, new_usage, call_site) # :nodoc: unless options.ignore_deprecate $stderr.puts "WARNING: '#{old_usage}' is deprecated. " + "Please use '#{new_usage}' instead.\n" + " at #{call_site}" end end # Does the exception have a task invocation chain? def has_chain?(exception) # :nodoc: exception.respond_to?(:chain) && exception.chain end private :has_chain? # True if one of the files in RAKEFILES is in the current directory. # If a match is found, it is copied into @rakefile. def have_rakefile # :nodoc: @rakefiles.each do |fn| if File.exist?(fn) others = FileList.glob(fn, File::FNM_CASEFOLD) return others.size == 1 ? others.first : fn elsif fn == "" return fn end end return nil end # True if we are outputting to TTY, false otherwise def tty_output? # :nodoc: @tty_output end # We will truncate output if we are outputting to a TTY or if we've been # given an explicit column width to honor def truncate_output? # :nodoc: tty_output? || @terminal_columns.nonzero? end # Display the tasks and comments. def display_tasks_and_comments # :nodoc: displayable_tasks = tasks.select { |t| (options.show_all_tasks || t.comment) && t.name =~ options.show_task_pattern } case options.show_tasks when :tasks width = displayable_tasks.map { |t| t.name_with_args.length }.max || 10 if truncate_output? max_column = terminal_width - name.size - width - 7 else max_column = nil end displayable_tasks.each do |t| printf("#{name} %-#{width}s # %s\n", t.name_with_args, max_column ? truncate(t.comment, max_column) : t.comment) end when :describe displayable_tasks.each do |t| puts "#{name} #{t.name_with_args}" comment = t.full_comment || "" comment.split("\n").each do |line| puts " #{line}" end puts end when :lines displayable_tasks.each do |t| t.locations.each do |loc| printf "#{name} %-30s %s\n", t.name_with_args, loc end end else fail "Unknown show task mode: '#{options.show_tasks}'" end end def terminal_width # :nodoc: if @terminal_columns.nonzero? result = @terminal_columns else result = unix? ? dynamic_width : 80 end (result < 10) ? 80 : result rescue 80 end # Calculate the dynamic width of the def dynamic_width # :nodoc: @dynamic_width ||= (dynamic_width_stty.nonzero? || dynamic_width_tput) end def dynamic_width_stty # :nodoc: %x{stty size 2>/dev/null}.split[1].to_i end def dynamic_width_tput # :nodoc: %x{tput cols 2>/dev/null}.to_i end def unix? # :nodoc: RbConfig::CONFIG["host_os"] =~ /(aix|darwin|linux|(net|free|open)bsd|cygwin|solaris|irix|hpux)/i end def windows? # :nodoc: Win32.windows? end def truncate(string, width) # :nodoc: if string.nil? "" elsif string.length <= width string else (string[0, width - 3] || "") + "..." end end # Display the tasks and prerequisites def display_prerequisites # :nodoc: tasks.each do |t| puts "#{name} #{t.name}" t.prerequisites.each { |pre| puts " #{pre}" } end end def trace(*strings) # :nodoc: options.trace_output ||= $stderr trace_on(options.trace_output, *strings) end def sort_options(options) # :nodoc: options.sort_by { |opt| opt.select { |o| o =~ /^-/ }.map(&:downcase).sort.reverse } end private :sort_options # A list of all the standard options used in rake, suitable for # passing to OptionParser. def standard_rake_options # :nodoc: sort_options( [ ["--all", "-A", "Show all tasks, even uncommented ones (in combination with -T or -D)", lambda { |value| options.show_all_tasks = value } ], ["--backtrace=[OUT]", "Enable full backtrace. OUT can be stderr (default) or stdout.", lambda { |value| options.backtrace = true select_trace_output(options, "backtrace", value) } ], ["--build-all", "-B", "Build all prerequisites, including those which are up-to-date.", lambda { |value| options.build_all = true } ], ["--comments", "Show commented tasks only", lambda { |value| options.show_all_tasks = !value } ], ["--describe", "-D [PATTERN]", "Describe the tasks (matching optional PATTERN), then exit.", lambda { |value| select_tasks_to_show(options, :describe, value) } ], ["--dry-run", "-n", "Do a dry run without executing actions.", lambda { |value| Rake.verbose(true) Rake.nowrite(true) options.dryrun = true options.trace = true } ], ["--execute", "-e CODE", "Execute some Ruby code and exit.", lambda { |value| eval(value) exit } ], ["--execute-print", "-p CODE", "Execute some Ruby code, print the result, then exit.", lambda { |value| puts eval(value) exit } ], ["--execute-continue", "-E CODE", "Execute some Ruby code, " + "then continue with normal task processing.", lambda { |value| eval(value) } ], ["--jobs", "-j [NUMBER]", "Specifies the maximum number of tasks to execute in parallel. " + "(default is number of CPU cores + 4)", lambda { |value| if value.nil? || value == "" value = Float::INFINITY elsif value =~ /^\d+$/ value = value.to_i else value = Rake.suggested_thread_count end value = 1 if value < 1 options.thread_pool_size = value - 1 } ], ["--job-stats [LEVEL]", "Display job statistics. " + "LEVEL=history displays a complete job list", lambda { |value| if value =~ /^history/i options.job_stats = :history else options.job_stats = true end } ], ["--libdir", "-I LIBDIR", "Include LIBDIR in the search path for required modules.", lambda { |value| $:.push(value) } ], ["--multitask", "-m", "Treat all tasks as multitasks.", lambda { |value| options.always_multitask = true } ], ["--no-search", "--nosearch", "-N", "Do not search parent directories for the Rakefile.", lambda { |value| options.nosearch = true } ], ["--prereqs", "-P", "Display the tasks and dependencies, then exit.", lambda { |value| options.show_prereqs = true } ], ["--quiet", "-q", "Do not log messages to standard output.", lambda { |value| Rake.verbose(false) } ], ["--rakefile", "-f [FILENAME]", "Use FILENAME as the rakefile to search for.", lambda { |value| value ||= "" @rakefiles.clear @rakefiles << value } ], ["--rakelibdir", "--rakelib", "-R RAKELIBDIR", "Auto-import any .rake files in RAKELIBDIR. " + "(default is 'rakelib')", lambda { |value| options.rakelib = value.split(File::PATH_SEPARATOR) } ], ["--require", "-r MODULE", "Require MODULE before executing rakefile.", lambda { |value| begin require value rescue LoadError => ex begin rake_require value rescue LoadError raise ex end end } ], ["--rules", "Trace the rules resolution.", lambda { |value| options.trace_rules = true } ], ["--silent", "-s", "Like --quiet, but also suppresses the " + "'in directory' announcement.", lambda { |value| Rake.verbose(false) options.silent = true } ], ["--suppress-backtrace PATTERN", "Suppress backtrace lines matching regexp PATTERN. " + "Ignored if --trace is on.", lambda { |value| options.suppress_backtrace_pattern = Regexp.new(value) } ], ["--system", "-g", "Using system wide (global) rakefiles " + "(usually '~/.rake/*.rake').", lambda { |value| options.load_system = true } ], ["--no-system", "--nosystem", "-G", "Use standard project Rakefile search paths, " + "ignore system wide rakefiles.", lambda { |value| options.ignore_system = true } ], ["--tasks", "-T [PATTERN]", "Display the tasks (matching optional PATTERN) " + "with descriptions, then exit. " + "-AT combination displays all of tasks contained no description.", lambda { |value| select_tasks_to_show(options, :tasks, value) } ], ["--trace=[OUT]", "-t", "Turn on invoke/execute tracing, enable full backtrace. " + "OUT can be stderr (default) or stdout.", lambda { |value| options.trace = true options.backtrace = true select_trace_output(options, "trace", value) Rake.verbose(true) } ], ["--verbose", "-v", "Log message to standard output.", lambda { |value| Rake.verbose(true) } ], ["--version", "-V", "Display the program version.", lambda { |value| puts "rake, version #{Rake::VERSION}" exit } ], ["--where", "-W [PATTERN]", "Describe the tasks (matching optional PATTERN), then exit.", lambda { |value| select_tasks_to_show(options, :lines, value) options.show_all_tasks = true } ], ["--no-deprecation-warnings", "-X", "Disable the deprecation warnings.", lambda { |value| options.ignore_deprecate = true } ], ]) end def select_tasks_to_show(options, show_tasks, value) # :nodoc: options.show_tasks = show_tasks options.show_task_pattern = Regexp.new(value || "") Rake::TaskManager.record_task_metadata = true end private :select_tasks_to_show def select_trace_output(options, trace_option, value) # :nodoc: value = value.strip unless value.nil? case value when "stdout" options.trace_output = $stdout when "stderr", nil options.trace_output = $stderr else fail CommandLineOptionError, "Unrecognized --#{trace_option} option '#{value}'" end end private :select_trace_output # Read and handle the command line options. Returns the command line # arguments that we didn't understand, which should (in theory) be just # task names and env vars. def handle_options(argv) # :nodoc: set_default_options OptionParser.new do |opts| opts.banner = "#{Rake.application.name} [-f rakefile] {options} targets..." opts.separator "" opts.separator "Options are ..." opts.on_tail("-h", "--help", "-H", "Display this help message.") do puts opts exit end standard_rake_options.each { |args| opts.on(*args) } opts.environment("RAKEOPT") end.parse(argv) end # Similar to the regular Ruby +require+ command, but will check # for *.rake files in addition to *.rb files. def rake_require(file_name, paths=$LOAD_PATH, loaded=$") # :nodoc: fn = file_name + ".rake" return false if loaded.include?(fn) paths.each do |path| full_path = File.join(path, fn) if File.exist?(full_path) Rake.load_rakefile(full_path) loaded << fn return true end end fail LoadError, "Can't find #{file_name}" end def find_rakefile_location # :nodoc: here = Dir.pwd until (fn = have_rakefile) Dir.chdir("..") return nil if Dir.pwd == here || options.nosearch here = Dir.pwd end [fn, here] ensure Dir.chdir(Rake.original_dir) end def print_rakefile_directory(location) # :nodoc: $stderr.puts "(in #{Dir.pwd})" unless options.silent or original_dir == location end def raw_load_rakefile # :nodoc: rakefile, location = find_rakefile_location if (! options.ignore_system) && (options.load_system || rakefile.nil?) && system_dir && File.directory?(system_dir) print_rakefile_directory(location) glob("#{system_dir}/*.rake") do |name| add_import name end else fail "No Rakefile found (looking for: #{@rakefiles.join(', ')})" if rakefile.nil? @rakefile = rakefile Dir.chdir(location) print_rakefile_directory(location) Rake.load_rakefile(File.expand_path(@rakefile)) if @rakefile && @rakefile != "" options.rakelib.each do |rlib| glob("#{rlib}/*.rake") do |name| add_import name end end end load_imports end def glob(path, &block) # :nodoc: FileList.glob(path.tr("\\", "/")).each(&block) end private :glob # The directory path containing the system wide rakefiles. def system_dir # :nodoc: @system_dir ||= begin if ENV["RAKE_SYSTEM"] ENV["RAKE_SYSTEM"] else standard_system_dir end end end # The standard directory containing system wide rake files. if Win32.windows? def standard_system_dir #:nodoc: Win32.win32_system_dir end else def standard_system_dir #:nodoc: File.join(File.expand_path("~"), ".rake") end end private :standard_system_dir # Collect the list of tasks on the command line. If no tasks are # given, return a list containing only the default task. # Environmental assignments are processed at this time as well. # # `args` is the list of arguments to peruse to get the list of tasks. # It should be the command line that was given to rake, less any # recognised command-line options, which OptionParser.parse will # have taken care of already. def collect_command_line_tasks(args) # :nodoc: @top_level_tasks = [] args.each do |arg| if arg =~ /^(\w+)=(.*)$/m ENV[$1] = $2 else @top_level_tasks << arg unless arg =~ /^-/ end end @top_level_tasks.push(default_task_name) if @top_level_tasks.empty? end # Default task name ("default"). # (May be overridden by subclasses) def default_task_name # :nodoc: "default" end # Add a file to the list of files to be imported. def add_import(fn) # :nodoc: @pending_imports << fn end # Load the pending list of imported files. def load_imports # :nodoc: while fn = @pending_imports.shift next if @imported.member?(fn) fn_task = lookup(fn) and fn_task.invoke ext = File.extname(fn) loader = @loaders[ext] || @default_loader loader.load(fn) if fn_task = lookup(fn) and fn_task.needed? fn_task.reenable fn_task.invoke loader.load(fn) end @imported << fn end end def rakefile_location(backtrace=caller) # :nodoc: backtrace.map { |t| t[/([^:]+):/, 1] } re = /^#{@rakefile}$/ re = /#{re.source}/i if windows? backtrace.find { |str| str =~ re } || "" end def set_default_options options.always_multitask = false options.backtrace = false options.build_all = false options.dryrun = false options.ignore_deprecate = false options.ignore_system = false options.job_stats = false options.load_system = false options.nosearch = false options.rakelib = %w[rakelib] options.show_all_tasks = false options.show_prereqs = false options.show_task_pattern = nil options.show_tasks = nil options.silent = false options.suppress_backtrace_pattern = nil options.thread_pool_size = Rake.suggested_thread_count options.trace = false options.trace_output = $stderr options.trace_rules = false end end end rake-12.3.1/lib/rake/backtrace.rb000066400000000000000000000016001325463231200164520ustar00rootroot00000000000000# frozen_string_literal: true module Rake module Backtrace # :nodoc: all SYS_KEYS = RbConfig::CONFIG.keys.grep(/(?:[a-z]prefix|libdir)\z/) SYS_PATHS = RbConfig::CONFIG.values_at(*SYS_KEYS).uniq + [ File.join(File.dirname(__FILE__), "..") ] SUPPRESSED_PATHS = SYS_PATHS. map { |s| s.tr("\\", "/") }. map { |f| File.expand_path(f) }. reject { |s| s.nil? || s =~ /^ *$/ } SUPPRESSED_PATHS_RE = SUPPRESSED_PATHS.map { |f| Regexp.quote(f) }.join("|") SUPPRESSED_PATHS_RE << "|^org\\/jruby\\/\\w+\\.java" if Object.const_defined?(:RUBY_ENGINE) and RUBY_ENGINE == "jruby" SUPPRESS_PATTERN = %r!(\A(#{SUPPRESSED_PATHS_RE})|bin/rake:\d+)!i def self.collapse(backtrace) pattern = Rake.application.options.suppress_backtrace_pattern || SUPPRESS_PATTERN backtrace.reject { |elem| elem =~ pattern } end end end rake-12.3.1/lib/rake/clean.rb000066400000000000000000000040341325463231200156210ustar00rootroot00000000000000# frozen_string_literal: true # The 'rake/clean' file defines two file lists (CLEAN and CLOBBER) and # two rake tasks (:clean and :clobber). # # [:clean] Clean up the project by deleting scratch files and backup # files. Add files to the CLEAN file list to have the :clean # target handle them. # # [:clobber] Clobber all generated and non-source files in a project. # The task depends on :clean, so all the clean files will # be deleted as well as files in the CLOBBER file list. # The intent of this task is to return a project to its # pristine, just unpacked state. require "rake" # :stopdoc: module Rake module Cleaner extend FileUtils module_function def cleanup_files(file_names) file_names.each do |file_name| cleanup(file_name) end end def cleanup(file_name, opts={}) begin opts = { verbose: Rake.application.options.trace }.merge(opts) rm_r file_name, opts rescue StandardError => ex puts "Failed to remove #{file_name}: #{ex}" unless file_already_gone?(file_name) end end def file_already_gone?(file_name) return false if File.exist?(file_name) path = file_name prev = nil while path = File.dirname(path) return false if cant_be_deleted?(path) break if [prev, "."].include?(path) prev = path end true end private_class_method :file_already_gone? def cant_be_deleted?(path_name) File.exist?(path_name) && (!File.readable?(path_name) || !File.executable?(path_name)) end private_class_method :cant_be_deleted? end end CLEAN = ::Rake::FileList["**/*~", "**/*.bak", "**/core"] CLEAN.clear_exclude.exclude { |fn| fn.pathmap("%f").downcase == "core" && File.directory?(fn) } desc "Remove any temporary products." task :clean do Rake::Cleaner.cleanup_files(CLEAN) end CLOBBER = ::Rake::FileList.new desc "Remove any generated files." task clobber: [:clean] do Rake::Cleaner.cleanup_files(CLOBBER) end rake-12.3.1/lib/rake/cloneable.rb000066400000000000000000000007001325463231200164570ustar00rootroot00000000000000# frozen_string_literal: true module Rake ## # Mixin for creating easily cloned objects. module Cloneable # :nodoc: # The hook that is invoked by 'clone' and 'dup' methods. def initialize_copy(source) super source.instance_variables.each do |var| src_value = source.instance_variable_get(var) value = src_value.clone rescue src_value instance_variable_set(var, value) end end end end rake-12.3.1/lib/rake/cpu_counter.rb000066400000000000000000000045121325463231200170660ustar00rootroot00000000000000# frozen_string_literal: true module Rake # Based on a script at: # http://stackoverflow.com/questions/891537/ruby-detect-number-of-cpus-installed class CpuCounter # :nodoc: all def self.count new.count_with_default end def count_with_default(default=4) count || default rescue StandardError default end begin require "etc" rescue LoadError else if Etc.respond_to?(:nprocessors) def count return Etc.nprocessors end end end end end unless Rake::CpuCounter.method_defined?(:count) Rake::CpuCounter.class_eval <<-'end;', __FILE__, __LINE__+1 require 'rbconfig' def count if defined?(Java::Java) count_via_java_runtime else case RbConfig::CONFIG['host_os'] when /linux/ count_via_cpuinfo when /darwin|bsd/ count_via_sysctl when /mswin|mingw/ count_via_win32 else # Try everything count_via_win32 || count_via_sysctl || count_via_cpuinfo end end end def count_via_java_runtime Java::Java.lang.Runtime.getRuntime.availableProcessors rescue StandardError nil end def count_via_win32 require 'win32ole' wmi = WIN32OLE.connect("winmgmts://") cpu = wmi.ExecQuery("select NumberOfCores from Win32_Processor") # TODO count hyper-threaded in this cpu.to_enum.first.NumberOfCores rescue StandardError, LoadError nil end def count_via_cpuinfo open('/proc/cpuinfo') { |f| f.readlines }.grep(/processor/).size rescue StandardError nil end def count_via_sysctl run 'sysctl', '-n', 'hw.ncpu' end def run(command, *args) cmd = resolve_command(command) if cmd IO.popen [cmd, *args] do |io| io.read.to_i end else nil end end def resolve_command(command) look_for_command("/usr/sbin", command) || look_for_command("/sbin", command) || in_path_command(command) end def look_for_command(dir, command) path = File.join(dir, command) File.exist?(path) ? path : nil end def in_path_command(command) IO.popen ['which', command] do |io| io.eof? ? nil : command end end end; end rake-12.3.1/lib/rake/default_loader.rb000066400000000000000000000004111325463231200175040ustar00rootroot00000000000000# frozen_string_literal: true module Rake # Default Rakefile loader used by +import+. class DefaultLoader ## # Loads a rakefile into the current application from +fn+ def load(fn) Rake.load_rakefile(File.expand_path(fn)) end end end rake-12.3.1/lib/rake/dsl_definition.rb000066400000000000000000000127521325463231200175370ustar00rootroot00000000000000# frozen_string_literal: true # Rake DSL functions. require "rake/file_utils_ext" module Rake ## # DSL is a module that provides #task, #desc, #namespace, etc. Use this # when you'd like to use rake outside the top level scope. # # For a Rakefile you run from the command line this module is automatically # included. module DSL #-- # Include the FileUtils file manipulation functions in the top # level module, but mark them private so that they don't # unintentionally define methods on other objects. #++ include FileUtilsExt private(*FileUtils.instance_methods(false)) private(*FileUtilsExt.instance_methods(false)) private # :call-seq: # task task_name # task task_name: dependencies # task task_name, arguments => dependencies # # Declare a basic task. The +task_name+ is always the first argument. If # the task name contains a ":" it is defined in that namespace. # # The +dependencies+ may be a single task name or an Array of task names. # The +argument+ (a single name) or +arguments+ (an Array of names) define # the arguments provided to the task. # # The task, argument and dependency names may be either symbols or # strings. # # A task with a single dependency: # # task clobber: %w[clean] do # rm_rf "html" # end # # A task with an argument and a dependency: # # task :package, [:version] => :test do |t, args| # # ... # end # # To invoke this task from the command line: # # $ rake package[1.2.3] # def task(*args, &block) # :doc: Rake::Task.define_task(*args, &block) end # Declare a file task. # # Example: # file "config.cfg" => ["config.template"] do # open("config.cfg", "w") do |outfile| # open("config.template") do |infile| # while line = infile.gets # outfile.puts line # end # end # end # end # def file(*args, &block) # :doc: Rake::FileTask.define_task(*args, &block) end # Declare a file creation task. # (Mainly used for the directory command). def file_create(*args, &block) Rake::FileCreationTask.define_task(*args, &block) end # Declare a set of files tasks to create the given directories on # demand. # # Example: # directory "testdata/doc" # def directory(*args, &block) # :doc: result = file_create(*args, &block) dir, _ = *Rake.application.resolve_args(args) dir = Rake.from_pathname(dir) Rake.each_dir_parent(dir) do |d| file_create d do |t| mkdir_p t.name unless File.exist?(t.name) end end result end # Declare a task that performs its prerequisites in # parallel. Multitasks does *not* guarantee that its prerequisites # will execute in any given order (which is obvious when you think # about it) # # Example: # multitask deploy: %w[deploy_gem deploy_rdoc] # def multitask(*args, &block) # :doc: Rake::MultiTask.define_task(*args, &block) end # Create a new rake namespace and use it for evaluating the given # block. Returns a NameSpace object that can be used to lookup # tasks defined in the namespace. # # Example: # # ns = namespace "nested" do # # the "nested:run" task # task :run # end # task_run = ns[:run] # find :run in the given namespace. # # Tasks can also be defined in a namespace by using a ":" in the task # name: # # task "nested:test" do # # ... # end # def namespace(name=nil, &block) # :doc: name = name.to_s if name.kind_of?(Symbol) name = name.to_str if name.respond_to?(:to_str) unless name.kind_of?(String) || name.nil? raise ArgumentError, "Expected a String or Symbol for a namespace name" end Rake.application.in_namespace(name, &block) end # Declare a rule for auto-tasks. # # Example: # rule '.o' => '.c' do |t| # sh 'cc', '-o', t.name, t.source # end # def rule(*args, &block) # :doc: Rake::Task.create_rule(*args, &block) end # Describes the next rake task. Duplicate descriptions are discarded. # Descriptions are shown with rake -T (up to the first # sentence) and rake -D (the entire description). # # Example: # desc "Run the Unit Tests" # task test: [:build] # # ... run tests # end # def desc(description) # :doc: Rake.application.last_description = description end # Import the partial Rakefiles +fn+. Imported files are loaded # _after_ the current file is completely loaded. This allows the # import statement to appear anywhere in the importing file, and yet # allowing the imported files to depend on objects defined in the # importing file. # # A common use of the import statement is to include files # containing dependency declarations. # # See also the --rakelibdir command line option. # # Example: # import ".depend", "my_rules" # def import(*fns) # :doc: fns.each do |fn| Rake.application.add_import(fn) end end end extend FileUtilsExt end # Extend the main object with the DSL commands. This allows top-level # calls to task, etc. to work from a Rakefile without polluting the # object inheritance tree. self.extend Rake::DSL rake-12.3.1/lib/rake/early_time.rb000066400000000000000000000005621325463231200166730ustar00rootroot00000000000000# frozen_string_literal: true module Rake # EarlyTime is a fake timestamp that occurs _before_ any other time value. class EarlyTime include Comparable include Singleton ## # The EarlyTime always comes before +other+! def <=>(other) -1 end def to_s # :nodoc: "" end end EARLY = EarlyTime.instance end rake-12.3.1/lib/rake/ext/000077500000000000000000000000001325463231200150115ustar00rootroot00000000000000rake-12.3.1/lib/rake/ext/core.rb000066400000000000000000000012341325463231200162660ustar00rootroot00000000000000# frozen_string_literal: true class Module # Check for an existing method in the current class before extending. If # the method already exists, then a warning is printed and the extension is # not added. Otherwise the block is yielded and any definitions in the # block will take effect. # # Usage: # # class String # rake_extension("xyz") do # def xyz # ... # end # end # end # def rake_extension(method) # :nodoc: if method_defined?(method) $stderr.puts "WARNING: Possible conflict with Rake extension: " + "#{self}##{method} already exists" else yield end end end rake-12.3.1/lib/rake/ext/string.rb000066400000000000000000000135621325463231200166530ustar00rootroot00000000000000# frozen_string_literal: true require "rake/ext/core" class String rake_extension("ext") do # Replace the file extension with +newext+. If there is no extension on # the string, append the new extension to the end. If the new extension # is not given, or is the empty string, remove any existing extension. # # +ext+ is a user added method for the String class. # # This String extension comes from Rake def ext(newext="") return self.dup if [".", ".."].include? self if newext != "" newext = "." + newext unless newext =~ /^\./ end self.chomp(File.extname(self)) << newext end end rake_extension("pathmap") do # Explode a path into individual components. Used by +pathmap+. # # This String extension comes from Rake def pathmap_explode head, tail = File.split(self) return [self] if head == self return [tail] if head == "." || tail == "/" return [head, tail] if head == "/" return head.pathmap_explode + [tail] end protected :pathmap_explode # Extract a partial path from the path. Include +n+ directories from the # front end (left hand side) if +n+ is positive. Include |+n+| # directories from the back end (right hand side) if +n+ is negative. # # This String extension comes from Rake def pathmap_partial(n) dirs = File.dirname(self).pathmap_explode partial_dirs = if n > 0 dirs[0...n] elsif n < 0 dirs.reverse[0...-n].reverse else "." end File.join(partial_dirs) end protected :pathmap_partial # Perform the pathmap replacement operations on the given path. The # patterns take the form 'pat1,rep1;pat2,rep2...'. # # This String extension comes from Rake def pathmap_replace(patterns, &block) result = self patterns.split(";").each do |pair| pattern, replacement = pair.split(",") pattern = Regexp.new(pattern) if replacement == "*" && block_given? result = result.sub(pattern, &block) elsif replacement result = result.sub(pattern, replacement) else result = result.sub(pattern, "") end end result end protected :pathmap_replace # Map the path according to the given specification. The specification # controls the details of the mapping. The following special patterns are # recognized: # # %p :: The complete path. # %f :: The base file name of the path, with its file extension, # but without any directories. # %n :: The file name of the path without its file extension. # %d :: The directory list of the path. # %x :: The file extension of the path. An empty string if there # is no extension. # %X :: Everything *but* the file extension. # %s :: The alternate file separator if defined, otherwise use # # the standard file separator. # %% :: A percent sign. # # The %d specifier can also have a numeric prefix (e.g. '%2d'). # If the number is positive, only return (up to) +n+ directories in the # path, starting from the left hand side. If +n+ is negative, return (up # to) +n+ directories from the right hand side of the path. # # Examples: # # 'a/b/c/d/file.txt'.pathmap("%2d") => 'a/b' # 'a/b/c/d/file.txt'.pathmap("%-2d") => 'c/d' # # Also the %d, %p, %f, %n, # %x, and %X operators can take a pattern/replacement # argument to perform simple string substitutions on a particular part of # the path. The pattern and replacement are separated by a comma and are # enclosed by curly braces. The replacement spec comes after the % # character but before the operator letter. (e.g. "%{old,new}d"). # Multiple replacement specs should be separated by semi-colons (e.g. # "%{old,new;src,bin}d"). # # Regular expressions may be used for the pattern, and back refs may be # used in the replacement text. Curly braces, commas and semi-colons are # excluded from both the pattern and replacement text (let's keep parsing # reasonable). # # For example: # # "src/org/onestepback/proj/A.java".pathmap("%{^src,class}X.class") # # returns: # # "class/org/onestepback/proj/A.class" # # If the replacement text is '*', then a block may be provided to perform # some arbitrary calculation for the replacement. # # For example: # # "/path/to/file.TXT".pathmap("%X%{.*,*}x") { |ext| # ext.downcase # } # # Returns: # # "/path/to/file.txt" # # This String extension comes from Rake def pathmap(spec=nil, &block) return self if spec.nil? result = "".dup spec.scan(/%\{[^}]*\}-?\d*[sdpfnxX%]|%-?\d+d|%.|[^%]+/) do |frag| case frag when "%f" result << File.basename(self) when "%n" result << File.basename(self).ext when "%d" result << File.dirname(self) when "%x" result << File.extname(self) when "%X" result << self.ext when "%p" result << self when "%s" result << (File::ALT_SEPARATOR || File::SEPARATOR) when "%-" # do nothing when "%%" result << "%" when /%(-?\d+)d/ result << pathmap_partial($1.to_i) when /^%\{([^}]*)\}(\d*[dpfnxX])/ patterns, operator = $1, $2 result << pathmap("%" + operator).pathmap_replace(patterns, &block) when /^%/ fail ArgumentError, "Unknown pathmap specifier #{frag} in '#{spec}'" else result << frag end end result end end end rake-12.3.1/lib/rake/file_creation_task.rb000066400000000000000000000012741325463231200203670ustar00rootroot00000000000000# frozen_string_literal: true require "rake/file_task" require "rake/early_time" module Rake # A FileCreationTask is a file task that when used as a dependency will be # needed if and only if the file has not been created. Once created, it is # not re-triggered if any of its dependencies are newer, nor does trigger # any rebuilds of tasks that depend on it whenever it is updated. # class FileCreationTask < FileTask # Is this file task needed? Yes if it doesn't exist. def needed? ! File.exist?(name) end # Time stamp for file creation task. This time stamp is earlier # than any other time stamp. def timestamp Rake::EARLY end end end rake-12.3.1/lib/rake/file_list.rb000066400000000000000000000307141325463231200165150ustar00rootroot00000000000000# frozen_string_literal: true require "rake/cloneable" require "rake/file_utils_ext" require "rake/ext/string" module Rake ## # A FileList is essentially an array with a few helper methods defined to # make file manipulation a bit easier. # # FileLists are lazy. When given a list of glob patterns for possible files # to be included in the file list, instead of searching the file structures # to find the files, a FileList holds the pattern for latter use. # # This allows us to define a number of FileList to match any number of # files, but only search out the actual files when then FileList itself is # actually used. The key is that the first time an element of the # FileList/Array is requested, the pending patterns are resolved into a real # list of file names. # class FileList include Cloneable # == Method Delegation # # The lazy evaluation magic of FileLists happens by implementing all the # array specific methods to call +resolve+ before delegating the heavy # lifting to an embedded array object (@items). # # In addition, there are two kinds of delegation calls. The regular kind # delegates to the @items array and returns the result directly. Well, # almost directly. It checks if the returned value is the @items object # itself, and if so will return the FileList object instead. # # The second kind of delegation call is used in methods that normally # return a new Array object. We want to capture the return value of these # methods and wrap them in a new FileList object. We enumerate these # methods in the +SPECIAL_RETURN+ list below. # List of array methods (that are not in +Object+) that need to be # delegated. ARRAY_METHODS = (Array.instance_methods - Object.instance_methods).map(&:to_s) # List of additional methods that must be delegated. MUST_DEFINE = %w[inspect <=>] # List of methods that should not be delegated here (we define special # versions of them explicitly below). MUST_NOT_DEFINE = %w[to_a to_ary partition * <<] # List of delegated methods that return new array values which need # wrapping. SPECIAL_RETURN = %w[ map collect sort sort_by select find_all reject grep compact flatten uniq values_at + - & | ] DELEGATING_METHODS = (ARRAY_METHODS + MUST_DEFINE - MUST_NOT_DEFINE).map(&:to_s).sort.uniq # Now do the delegation. DELEGATING_METHODS.each do |sym| if SPECIAL_RETURN.include?(sym) ln = __LINE__ + 1 class_eval %{ def #{sym}(*args, &block) resolve result = @items.send(:#{sym}, *args, &block) self.class.new.import(result) end }, __FILE__, ln else ln = __LINE__ + 1 class_eval %{ def #{sym}(*args, &block) resolve result = @items.send(:#{sym}, *args, &block) result.object_id == @items.object_id ? self : result end }, __FILE__, ln end end GLOB_PATTERN = %r{[*?\[\{]} # Create a file list from the globbable patterns given. If you wish to # perform multiple includes or excludes at object build time, use the # "yield self" pattern. # # Example: # file_list = FileList.new('lib/**/*.rb', 'test/test*.rb') # # pkg_files = FileList.new('lib/**/*') do |fl| # fl.exclude(/\bCVS\b/) # end # def initialize(*patterns) @pending_add = [] @pending = false @exclude_patterns = DEFAULT_IGNORE_PATTERNS.dup @exclude_procs = DEFAULT_IGNORE_PROCS.dup @items = [] patterns.each { |pattern| include(pattern) } yield self if block_given? end # Add file names defined by glob patterns to the file list. If an array # is given, add each element of the array. # # Example: # file_list.include("*.java", "*.cfg") # file_list.include %w( math.c lib.h *.o ) # def include(*filenames) # TODO: check for pending filenames.each do |fn| if fn.respond_to? :to_ary include(*fn.to_ary) else @pending_add << Rake.from_pathname(fn) end end @pending = true self end alias :add :include # Register a list of file name patterns that should be excluded from the # list. Patterns may be regular expressions, glob patterns or regular # strings. In addition, a block given to exclude will remove entries that # return true when given to the block. # # Note that glob patterns are expanded against the file system. If a file # is explicitly added to a file list, but does not exist in the file # system, then an glob pattern in the exclude list will not exclude the # file. # # Examples: # FileList['a.c', 'b.c'].exclude("a.c") => ['b.c'] # FileList['a.c', 'b.c'].exclude(/^a/) => ['b.c'] # # If "a.c" is a file, then ... # FileList['a.c', 'b.c'].exclude("a.*") => ['b.c'] # # If "a.c" is not a file, then ... # FileList['a.c', 'b.c'].exclude("a.*") => ['a.c', 'b.c'] # def exclude(*patterns, &block) patterns.each do |pat| if pat.respond_to? :to_ary exclude(*pat.to_ary) else @exclude_patterns << Rake.from_pathname(pat) end end @exclude_procs << block if block_given? resolve_exclude unless @pending self end # Clear all the exclude patterns so that we exclude nothing. def clear_exclude @exclude_patterns = [] @exclude_procs = [] self end # A FileList is equal through array equality. def ==(array) to_ary == array end # Return the internal array object. def to_a resolve @items end # Return the internal array object. def to_ary to_a end # Lie about our class. def is_a?(klass) klass == Array || super(klass) end alias kind_of? is_a? # Redefine * to return either a string or a new file list. def *(other) result = @items * other case result when Array self.class.new.import(result) else result end end def <<(obj) resolve @items << Rake.from_pathname(obj) self end # Resolve all the pending adds now. def resolve if @pending @pending = false @pending_add.each do |fn| resolve_add(fn) end @pending_add = [] resolve_exclude end self end def resolve_add(fn) # :nodoc: case fn when GLOB_PATTERN add_matching(fn) else self << fn end end private :resolve_add def resolve_exclude # :nodoc: reject! { |fn| excluded_from_list?(fn) } self end private :resolve_exclude # Return a new FileList with the results of running +sub+ against each # element of the original list. # # Example: # FileList['a.c', 'b.c'].sub(/\.c$/, '.o') => ['a.o', 'b.o'] # def sub(pat, rep) inject(self.class.new) { |res, fn| res << fn.sub(pat, rep) } end # Return a new FileList with the results of running +gsub+ against each # element of the original list. # # Example: # FileList['lib/test/file', 'x/y'].gsub(/\//, "\\") # => ['lib\\test\\file', 'x\\y'] # def gsub(pat, rep) inject(self.class.new) { |res, fn| res << fn.gsub(pat, rep) } end # Same as +sub+ except that the original file list is modified. def sub!(pat, rep) each_with_index { |fn, i| self[i] = fn.sub(pat, rep) } self end # Same as +gsub+ except that the original file list is modified. def gsub!(pat, rep) each_with_index { |fn, i| self[i] = fn.gsub(pat, rep) } self end # Apply the pathmap spec to each of the included file names, returning a # new file list with the modified paths. (See String#pathmap for # details.) def pathmap(spec=nil, &block) collect { |fn| fn.pathmap(spec, &block) } end # Return a new FileList with String#ext method applied to # each member of the array. # # This method is a shortcut for: # # array.collect { |item| item.ext(newext) } # # +ext+ is a user added method for the Array class. def ext(newext="") collect { |fn| fn.ext(newext) } end # Grep each of the files in the filelist using the given pattern. If a # block is given, call the block on each matching line, passing the file # name, line number, and the matching line of text. If no block is given, # a standard emacs style file:linenumber:line message will be printed to # standard out. Returns the number of matched items. def egrep(pattern, *options) matched = 0 each do |fn| begin open(fn, "r", *options) do |inf| count = 0 inf.each do |line| count += 1 if pattern.match(line) matched += 1 if block_given? yield fn, count, line else puts "#{fn}:#{count}:#{line}" end end end end rescue StandardError => ex $stderr.puts "Error while processing '#{fn}': #{ex}" end end matched end # Return a new file list that only contains file names from the current # file list that exist on the file system. def existing select { |fn| File.exist?(fn) }.uniq end # Modify the current file list so that it contains only file name that # exist on the file system. def existing! resolve @items = @items.select { |fn| File.exist?(fn) }.uniq self end # FileList version of partition. Needed because the nested arrays should # be FileLists in this version. def partition(&block) # :nodoc: resolve result = @items.partition(&block) [ self.class.new.import(result[0]), self.class.new.import(result[1]), ] end # Convert a FileList to a string by joining all elements with a space. def to_s resolve self.join(" ") end # Add matching glob patterns. def add_matching(pattern) self.class.glob(pattern).each do |fn| self << fn unless excluded_from_list?(fn) end end private :add_matching # Should the given file name be excluded from the list? # # NOTE: This method was formerly named "exclude?", but Rails # introduced an exclude? method as an array method and setup a # conflict with file list. We renamed the method to avoid # confusion. If you were using "FileList#exclude?" in your user # code, you will need to update. def excluded_from_list?(fn) return true if @exclude_patterns.any? do |pat| case pat when Regexp fn =~ pat when GLOB_PATTERN flags = File::FNM_PATHNAME # Ruby <= 1.9.3 does not support File::FNM_EXTGLOB flags |= File::FNM_EXTGLOB if defined? File::FNM_EXTGLOB File.fnmatch?(pat, fn, flags) else fn == pat end end @exclude_procs.any? { |p| p.call(fn) } end DEFAULT_IGNORE_PATTERNS = [ /(^|[\/\\])CVS([\/\\]|$)/, /(^|[\/\\])\.svn([\/\\]|$)/, /\.bak$/, /~$/ ] DEFAULT_IGNORE_PROCS = [ proc { |fn| fn =~ /(^|[\/\\])core$/ && ! File.directory?(fn) } ] def import(array) # :nodoc: @items = array self end class << self # Create a new file list including the files listed. Similar to: # # FileList.new(*args) def [](*args) new(*args) end # Get a sorted list of files matching the pattern. This method # should be preferred to Dir[pattern] and Dir.glob(pattern) because # the files returned are guaranteed to be sorted. def glob(pattern, *args) Dir.glob(pattern, *args).sort end end end end module Rake class << self # Yield each file or directory component. def each_dir_parent(dir) # :nodoc: old_length = nil while dir != "." && dir.length != old_length yield(dir) old_length = dir.length dir = File.dirname(dir) end end # Convert Pathname and Pathname-like objects to strings; # leave everything else alone def from_pathname(path) # :nodoc: path = path.to_path if path.respond_to?(:to_path) path = path.to_str if path.respond_to?(:to_str) path end end end # module Rake rake-12.3.1/lib/rake/file_task.rb000066400000000000000000000030031325463231200164730ustar00rootroot00000000000000# frozen_string_literal: true require "rake/task.rb" require "rake/early_time" module Rake # A FileTask is a task that includes time based dependencies. If any of a # FileTask's prerequisites have a timestamp that is later than the file # represented by this task, then the file must be rebuilt (using the # supplied actions). # class FileTask < Task # Is this file task needed? Yes if it doesn't exist, or if its time stamp # is out of date. def needed? ! File.exist?(name) || out_of_date?(timestamp) || @application.options.build_all end # Time stamp for file task. def timestamp if File.exist?(name) File.mtime(name.to_s) else Rake::LATE end end private # Are there any prerequisites with a later time than the given time stamp? def out_of_date?(stamp) all_prerequisite_tasks.any? { |prereq| prereq_task = application[prereq, @scope] if prereq_task.instance_of?(Rake::FileTask) prereq_task.timestamp > stamp || @application.options.build_all else prereq_task.timestamp > stamp end } end # ---------------------------------------------------------------- # Task class methods. # class << self # Apply the scope to the task name according to the rules for this kind # of task. File based tasks ignore the scope when creating the name. def scope_name(scope, task_name) Rake.from_pathname(task_name) end end end end rake-12.3.1/lib/rake/file_utils.rb000066400000000000000000000074631325463231200167070ustar00rootroot00000000000000# frozen_string_literal: true require "rbconfig" require "fileutils" #-- # This a FileUtils extension that defines several additional commands to be # added to the FileUtils utility functions. module FileUtils # Path to the currently running Ruby program RUBY = ENV["RUBY"] || File.join( RbConfig::CONFIG["bindir"], RbConfig::CONFIG["ruby_install_name"] + RbConfig::CONFIG["EXEEXT"]). sub(/.*\s.*/m, '"\&"') # Run the system command +cmd+. If multiple arguments are given the command # is run directly (without the shell, same semantics as Kernel::exec and # Kernel::system). # # It is recommended you use the multiple argument form over interpolating # user input for both usability and security reasons. With the multiple # argument form you can easily process files with spaces or other shell # reserved characters in them. With the multiple argument form your rake # tasks are not vulnerable to users providing an argument like # ; rm # -rf /. # # If a block is given, upon command completion the block is called with an # OK flag (true on a zero exit status) and a Process::Status object. # Without a block a RuntimeError is raised when the command exits non-zero. # # Examples: # # sh 'ls -ltr' # # sh 'ls', 'file with spaces' # # # check exit status after command runs # sh %{grep pattern file} do |ok, res| # if ! ok # puts "pattern not found (status = #{res.exitstatus})" # end # end # def sh(*cmd, &block) options = (Hash === cmd.last) ? cmd.pop : {} shell_runner = block_given? ? block : create_shell_runner(cmd) set_verbose_option(options) verbose = options.delete :verbose noop = options.delete(:noop) || Rake::FileUtilsExt.nowrite_flag Rake.rake_output_message sh_show_command cmd if verbose unless noop res = (Hash === cmd.last) ? system(*cmd) : system(*cmd, options) status = $? status = Rake::PseudoStatus.new(1) if !res && status.nil? shell_runner.call(res, status) end end def create_shell_runner(cmd) # :nodoc: show_command = sh_show_command cmd show_command = show_command[0, 42] + "..." unless $trace lambda do |ok, status| ok or fail "Command failed with status (#{status.exitstatus}): " + "[#{show_command}]" end end private :create_shell_runner def sh_show_command(cmd) # :nodoc: cmd = cmd.dup if Hash === cmd.first env = cmd.first env = env.map { |name, value| "#{name}=#{value}" }.join " " cmd[0] = env end cmd.join " " end private :sh_show_command def set_verbose_option(options) # :nodoc: unless options.key? :verbose options[:verbose] = (Rake::FileUtilsExt.verbose_flag == Rake::FileUtilsExt::DEFAULT) || Rake::FileUtilsExt.verbose_flag end end private :set_verbose_option # Run a Ruby interpreter with the given arguments. # # Example: # ruby %{-pe '$_.upcase!' 1 sh(*([RUBY] + args + [options]), &block) else sh("#{RUBY} #{args.first}", options, &block) end end LN_SUPPORTED = [true] # Attempt to do a normal file link, but fall back to a copy if the link # fails. def safe_ln(*args) if ! LN_SUPPORTED[0] cp(*args) else begin ln(*args) rescue StandardError, NotImplementedError LN_SUPPORTED[0] = false cp(*args) end end end # Split a file path into individual directory names. # # Example: # split_all("a/b/c") => ['a', 'b', 'c'] # def split_all(path) head, tail = File.split(path) return [tail] if head == "." || tail == "/" return [head, tail] if head == "/" return split_all(head) + [tail] end end rake-12.3.1/lib/rake/file_utils_ext.rb000066400000000000000000000101231325463231200175520ustar00rootroot00000000000000# frozen_string_literal: true require "rake/file_utils" module Rake # # FileUtilsExt provides a custom version of the FileUtils methods # that respond to the verbose and nowrite # commands. # module FileUtilsExt include FileUtils class << self attr_accessor :verbose_flag, :nowrite_flag end DEFAULT = Object.new FileUtilsExt.verbose_flag = DEFAULT FileUtilsExt.nowrite_flag = false FileUtils.commands.each do |name| opts = FileUtils.options_of name default_options = [] if opts.include?("verbose") default_options << ":verbose => FileUtilsExt.verbose_flag" end if opts.include?("noop") default_options << ":noop => FileUtilsExt.nowrite_flag" end next if default_options.empty? module_eval(<<-EOS, __FILE__, __LINE__ + 1) def #{name}( *args, &block ) super( *rake_merge_option(args, #{default_options.join(', ')} ), &block) end EOS end # Get/set the verbose flag controlling output from the FileUtils # utilities. If verbose is true, then the utility method is # echoed to standard output. # # Examples: # verbose # return the current value of the # # verbose flag # verbose(v) # set the verbose flag to _v_. # verbose(v) { code } # Execute code with the verbose flag set # # temporarily to _v_. Return to the # # original value when code is done. def verbose(value=nil) oldvalue = FileUtilsExt.verbose_flag FileUtilsExt.verbose_flag = value unless value.nil? if block_given? begin yield ensure FileUtilsExt.verbose_flag = oldvalue end end FileUtilsExt.verbose_flag end # Get/set the nowrite flag controlling output from the FileUtils # utilities. If verbose is true, then the utility method is # echoed to standard output. # # Examples: # nowrite # return the current value of the # # nowrite flag # nowrite(v) # set the nowrite flag to _v_. # nowrite(v) { code } # Execute code with the nowrite flag set # # temporarily to _v_. Return to the # # original value when code is done. def nowrite(value=nil) oldvalue = FileUtilsExt.nowrite_flag FileUtilsExt.nowrite_flag = value unless value.nil? if block_given? begin yield ensure FileUtilsExt.nowrite_flag = oldvalue end end oldvalue end # Use this function to prevent potentially destructive ruby code # from running when the :nowrite flag is set. # # Example: # # when_writing("Building Project") do # project.build # end # # The following code will build the project under normal # conditions. If the nowrite(true) flag is set, then the example # will print: # # DRYRUN: Building Project # # instead of actually building the project. # def when_writing(msg=nil) if FileUtilsExt.nowrite_flag $stderr.puts "DRYRUN: #{msg}" if msg else yield end end # Merge the given options with the default values. def rake_merge_option(args, defaults) if Hash === args.last defaults.update(args.last) args.pop end args.push defaults args end # Send the message to the default rake output (which is $stderr). def rake_output_message(message) $stderr.puts(message) end # Check that the options do not contain options not listed in # +optdecl+. An ArgumentError exception is thrown if non-declared # options are found. def rake_check_options(options, *optdecl) h = options.dup optdecl.each do |name| h.delete name end raise ArgumentError, "no such option: #{h.keys.join(' ')}" unless h.empty? end extend self end end rake-12.3.1/lib/rake/invocation_chain.rb000066400000000000000000000022761325463231200200600ustar00rootroot00000000000000# frozen_string_literal: true module Rake # InvocationChain tracks the chain of task invocations to detect # circular dependencies. class InvocationChain < LinkedList # Is the invocation already in the chain? def member?(invocation) head == invocation || tail.member?(invocation) end # Append an invocation to the chain of invocations. It is an error # if the invocation already listed. def append(invocation) if member?(invocation) fail RuntimeError, "Circular dependency detected: #{to_s} => #{invocation}" end conj(invocation) end # Convert to string, ie: TOP => invocation => invocation def to_s "#{prefix}#{head}" end # Class level append. def self.append(invocation, chain) chain.append(invocation) end private def prefix "#{tail} => " end # Null object for an empty chain. class EmptyInvocationChain < LinkedList::EmptyLinkedList @parent = InvocationChain def member?(obj) false end def append(invocation) conj(invocation) end def to_s "TOP" end end EMPTY = EmptyInvocationChain.new end end rake-12.3.1/lib/rake/invocation_exception_mixin.rb000066400000000000000000000007151325463231200221740ustar00rootroot00000000000000# frozen_string_literal: true module Rake module InvocationExceptionMixin # Return the invocation chain (list of Rake tasks) that were in # effect when this exception was detected by rake. May be null if # no tasks were active. def chain @rake_invocation_chain ||= nil end # Set the invocation chain in effect when this exception was # detected. def chain=(value) @rake_invocation_chain = value end end end rake-12.3.1/lib/rake/late_time.rb000066400000000000000000000004471325463231200165060ustar00rootroot00000000000000# frozen_string_literal: true module Rake # LateTime is a fake timestamp that occurs _after_ any other time value. class LateTime include Comparable include Singleton def <=>(other) 1 end def to_s "" end end LATE = LateTime.instance end rake-12.3.1/lib/rake/linked_list.rb000066400000000000000000000054241325463231200170440ustar00rootroot00000000000000# frozen_string_literal: true module Rake # Polylithic linked list structure used to implement several data # structures in Rake. class LinkedList include Enumerable attr_reader :head, :tail # Polymorphically add a new element to the head of a list. The # type of head node will be the same list type as the tail. def conj(item) self.class.cons(item, self) end # Is the list empty? # .make guards against a list being empty making any instantiated LinkedList # object not empty by default # You should consider overriding this method if you implement your own .make method def empty? false end # Lists are structurally equivalent. def ==(other) current = self while !current.empty? && !other.empty? return false if current.head != other.head current = current.tail other = other.tail end current.empty? && other.empty? end # Convert to string: LL(item, item...) def to_s items = map(&:to_s).join(", ") "LL(#{items})" end # Same as +to_s+, but with inspected items. def inspect items = map(&:inspect).join(", ") "LL(#{items})" end # For each item in the list. def each current = self while !current.empty? yield(current.head) current = current.tail end self end # Make a list out of the given arguments. This method is # polymorphic def self.make(*args) # return an EmptyLinkedList if there are no arguments return empty if !args || args.empty? # build a LinkedList by starting at the tail and iterating # through each argument # inject takes an EmptyLinkedList to start args.reverse.inject(empty) do |list, item| list = cons(item, list) list # return the newly created list for each item in the block end end # Cons a new head onto the tail list. def self.cons(head, tail) new(head, tail) end # The standard empty list class for the given LinkedList class. def self.empty self::EMPTY end protected def initialize(head, tail=EMPTY) @head = head @tail = tail end # Represent an empty list, using the Null Object Pattern. # # When inheriting from the LinkedList class, you should implement # a type specific Empty class as well. Make sure you set the class # instance variable @parent to the associated list class (this # allows conj, cons and make to work polymorphically). class EmptyLinkedList < LinkedList @parent = LinkedList def initialize end def empty? true end def self.cons(head, tail) @parent.cons(head, tail) end end EMPTY = EmptyLinkedList.new end end rake-12.3.1/lib/rake/loaders/000077500000000000000000000000001325463231200156425ustar00rootroot00000000000000rake-12.3.1/lib/rake/loaders/makefile.rb000066400000000000000000000025421325463231200177470ustar00rootroot00000000000000# frozen_string_literal: true module Rake # Makefile loader to be used with the import file loader. Use this to # import dependencies from make dependency tools: # # require 'rake/loaders/makefile' # # file ".depends.mf" => [SRC_LIST] do |t| # sh "makedepend -f- -- #{CFLAGS} -- #{t.prerequisites} > #{t.name}" # end # # import ".depends.mf" # # See {Importing Dependencies}[link:doc/rakefile_rdoc.html#label-Importing+Dependencies] # for further details. class MakefileLoader include Rake::DSL SPACE_MARK = "\0" # :nodoc: # Load the makefile dependencies in +fn+. def load(fn) # :nodoc: lines = File.read fn lines.gsub!(/\\ /, SPACE_MARK) lines.gsub!(/#[^\n]*\n/m, "") lines.gsub!(/\\\n/, " ") lines.each_line do |line| process_line(line) end end private # Process one logical line of makefile data. def process_line(line) # :nodoc: file_tasks, args = line.split(":", 2) return if args.nil? dependents = args.split.map { |d| respace(d) } file_tasks.scan(/\S+/) do |file_task| file_task = respace(file_task) file file_task => dependents end end def respace(str) # :nodoc: str.tr SPACE_MARK, " " end end # Install the handler Rake.application.add_loader("mf", MakefileLoader.new) end rake-12.3.1/lib/rake/multi_task.rb000066400000000000000000000005311325463231200167110ustar00rootroot00000000000000# frozen_string_literal: true module Rake # Same as a regular task, but the immediate prerequisites are done in # parallel using Ruby threads. # class MultiTask < Task private def invoke_prerequisites(task_args, invocation_chain) # :nodoc: invoke_prerequisites_concurrently(task_args, invocation_chain) end end end rake-12.3.1/lib/rake/name_space.rb000066400000000000000000000012761325463231200166370ustar00rootroot00000000000000# frozen_string_literal: true ## # The NameSpace class will lookup task names in the scope defined by a # +namespace+ command. class Rake::NameSpace ## # Create a namespace lookup object using the given task manager # and the list of scopes. def initialize(task_manager, scope_list) @task_manager = task_manager @scope = scope_list.dup end ## # Lookup a task named +name+ in the namespace. def [](name) @task_manager.lookup(name, @scope) end ## # The scope of the namespace (a LinkedList) def scope @scope.dup end ## # Return the list of tasks defined in this and nested namespaces. def tasks @task_manager.tasks_in_scope(@scope) end end rake-12.3.1/lib/rake/packagetask.rb000066400000000000000000000131071325463231200170160ustar00rootroot00000000000000# frozen_string_literal: true # Define a package task library to aid in the definition of # redistributable package files. require "rake" require "rake/tasklib" module Rake # Create a packaging task that will package the project into # distributable files (e.g zip archive or tar files). # # The PackageTask will create the following targets: # # +:package+ :: # Create all the requested package files. # # +:clobber_package+ :: # Delete all the package files. This target is automatically # added to the main clobber target. # # +:repackage+ :: # Rebuild the package files from scratch, even if they are not out # of date. # # "package_dir/name-version.tgz" :: # Create a gzipped tar package (if need_tar is true). # # "package_dir/name-version.tar.gz" :: # Create a gzipped tar package (if need_tar_gz is true). # # "package_dir/name-version.tar.bz2" :: # Create a bzip2'd tar package (if need_tar_bz2 is true). # # "package_dir/name-version.zip" :: # Create a zip package archive (if need_zip is true). # # Example: # # Rake::PackageTask.new("rake", "1.2.3") do |p| # p.need_tar = true # p.package_files.include("lib/**/*.rb") # end # class PackageTask < TaskLib # Name of the package (from the GEM Spec). attr_accessor :name # Version of the package (e.g. '1.3.2'). attr_accessor :version # Directory used to store the package files (default is 'pkg'). attr_accessor :package_dir # True if a gzipped tar file (tgz) should be produced (default is # false). attr_accessor :need_tar # True if a gzipped tar file (tar.gz) should be produced (default # is false). attr_accessor :need_tar_gz # True if a bzip2'd tar file (tar.bz2) should be produced (default # is false). attr_accessor :need_tar_bz2 # True if a xz'd tar file (tar.xz) should be produced (default is false) attr_accessor :need_tar_xz # True if a zip file should be produced (default is false) attr_accessor :need_zip # List of files to be included in the package. attr_accessor :package_files # Tar command for gzipped or bzip2ed archives. The default is 'tar'. attr_accessor :tar_command # Zip command for zipped archives. The default is 'zip'. attr_accessor :zip_command # Create a Package Task with the given name and version. Use +:noversion+ # as the version to build a package without a version or to provide a # fully-versioned package name. def initialize(name=nil, version=nil) init(name, version) yield self if block_given? define unless name.nil? end # Initialization that bypasses the "yield self" and "define" step. def init(name, version) @name = name @version = version @package_files = Rake::FileList.new @package_dir = "pkg" @need_tar = false @need_tar_gz = false @need_tar_bz2 = false @need_tar_xz = false @need_zip = false @tar_command = "tar" @zip_command = "zip" end # Create the tasks defined by this task library. def define fail "Version required (or :noversion)" if @version.nil? @version = nil if :noversion == @version desc "Build all the packages" task :package desc "Force a rebuild of the package files" task repackage: [:clobber_package, :package] desc "Remove package products" task :clobber_package do rm_r package_dir rescue nil end task clobber: [:clobber_package] [ [need_tar, tgz_file, "z"], [need_tar_gz, tar_gz_file, "z"], [need_tar_bz2, tar_bz2_file, "j"], [need_tar_xz, tar_xz_file, "J"] ].each do |need, file, flag| if need task package: ["#{package_dir}/#{file}"] file "#{package_dir}/#{file}" => [package_dir_path] + package_files do chdir(package_dir) do sh @tar_command, "#{flag}cvf", file, package_name end end end end if need_zip task package: ["#{package_dir}/#{zip_file}"] file "#{package_dir}/#{zip_file}" => [package_dir_path] + package_files do chdir(package_dir) do sh @zip_command, "-r", zip_file, package_name end end end directory package_dir_path => @package_files do @package_files.each do |fn| f = File.join(package_dir_path, fn) fdir = File.dirname(f) mkdir_p(fdir) unless File.exist?(fdir) if File.directory?(fn) mkdir_p(f) else rm_f f safe_ln(fn, f) end end end self end # The name of this package def package_name @version ? "#{@name}-#{@version}" : @name end # The directory this package will be built in def package_dir_path "#{package_dir}/#{package_name}" end # The package name with .tgz added def tgz_file "#{package_name}.tgz" end # The package name with .tar.gz added def tar_gz_file "#{package_name}.tar.gz" end # The package name with .tar.bz2 added def tar_bz2_file "#{package_name}.tar.bz2" end # The package name with .tar.xz added def tar_xz_file "#{package_name}.tar.xz" end # The package name with .zip added def zip_file "#{package_name}.zip" end end end rake-12.3.1/lib/rake/phony.rb000066400000000000000000000005751325463231200157020ustar00rootroot00000000000000# frozen_string_literal: true # Defines a :phony task that you can use as a dependency. This allows # file-based tasks to use non-file-based tasks as prerequisites # without forcing them to rebuild. # # See FileTask#out_of_date? and Task#timestamp for more info. require "rake" task :phony Rake::Task[:phony].tap do |task| def task.timestamp # :nodoc: Time.at 0 end end rake-12.3.1/lib/rake/private_reader.rb000066400000000000000000000006121325463231200175310ustar00rootroot00000000000000# frozen_string_literal: true module Rake # Include PrivateReader to use +private_reader+. module PrivateReader # :nodoc: all def self.included(base) base.extend(ClassMethods) end module ClassMethods # Declare a list of private accessors def private_reader(*names) attr_reader(*names) private(*names) end end end end rake-12.3.1/lib/rake/promise.rb000066400000000000000000000044411325463231200162170ustar00rootroot00000000000000# frozen_string_literal: true module Rake # A Promise object represents a promise to do work (a chore) in the # future. The promise is created with a block and a list of # arguments for the block. Calling value will return the value of # the promised chore. # # Used by ThreadPool. # class Promise # :nodoc: all NOT_SET = Object.new.freeze # :nodoc: attr_accessor :recorder # Create a promise to do the chore specified by the block. def initialize(args, &block) @mutex = Mutex.new @result = NOT_SET @error = NOT_SET @args = args @block = block end # Return the value of this promise. # # If the promised chore is not yet complete, then do the work # synchronously. We will wait. def value unless complete? stat :sleeping_on, item_id: object_id @mutex.synchronize do stat :has_lock_on, item_id: object_id chore stat :releasing_lock_on, item_id: object_id end end error? ? raise(@error) : @result end # If no one else is working this promise, go ahead and do the chore. def work stat :attempting_lock_on, item_id: object_id if @mutex.try_lock stat :has_lock_on, item_id: object_id chore stat :releasing_lock_on, item_id: object_id @mutex.unlock else stat :bailed_on, item_id: object_id end end private # Perform the chore promised def chore if complete? stat :found_completed, item_id: object_id return end stat :will_execute, item_id: object_id begin @result = @block.call(*@args) rescue Exception => e @error = e end stat :did_execute, item_id: object_id discard end # Do we have a result for the promise def result? ! @result.equal?(NOT_SET) end # Did the promise throw an error def error? ! @error.equal?(NOT_SET) end # Are we done with the promise def complete? result? || error? end # free up these items for the GC def discard @args = nil @block = nil end # Record execution statistics if there is a recorder def stat(*args) @recorder.call(*args) if @recorder end end end rake-12.3.1/lib/rake/pseudo_status.rb000066400000000000000000000006251325463231200174430ustar00rootroot00000000000000# frozen_string_literal: true module Rake ## # Exit status class for times the system just gives us a nil. class PseudoStatus # :nodoc: all attr_reader :exitstatus def initialize(code=0) @exitstatus = code end def to_i @exitstatus << 8 end def >>(n) to_i >> n end def stopped? false end def exited? true end end end rake-12.3.1/lib/rake/rake_module.rb000066400000000000000000000027701325463231200170330ustar00rootroot00000000000000# frozen_string_literal: true require "rake/application" module Rake class << self # Current Rake Application def application @application ||= Rake::Application.new end # Set the current Rake application object. def application=(app) @application = app end def suggested_thread_count # :nodoc: @cpu_count ||= Rake::CpuCounter.count @cpu_count + 4 end # Return the original directory where the Rake application was started. def original_dir application.original_dir end # Load a rakefile. def load_rakefile(path) load(path) end # Add files to the rakelib list def add_rakelib(*files) application.options.rakelib ||= [] application.options.rakelib.concat(files) end # Make +block_application+ the default rake application inside a block so # you can load rakefiles into a different application. # # This is useful when you want to run rake tasks inside a library without # running rake in a sub-shell. # # Example: # # Dir.chdir 'other/directory' # # other_rake = Rake.with_application do |rake| # rake.load_rakefile # end # # puts other_rake.tasks def with_application(block_application = Rake::Application.new) orig_application = Rake.application Rake.application = block_application yield block_application block_application ensure Rake.application = orig_application end end end rake-12.3.1/lib/rake/rake_test_loader.rb000066400000000000000000000007711325463231200200520ustar00rootroot00000000000000# frozen_string_literal: true require "rake" # Load the test files from the command line. argv = ARGV.select do |argument| begin case argument when /^-/ then argument when /\*/ then FileList[argument].to_a.each do |file| require File.expand_path file end false else require File.expand_path argument false end rescue LoadError => e raise unless e.path abort "\nFile does not exist: #{e.path}\n\n" end end ARGV.replace argv rake-12.3.1/lib/rake/rule_recursion_overflow_error.rb000066400000000000000000000005761325463231200227420ustar00rootroot00000000000000# frozen_string_literal: true module Rake # Error indicating a recursion overflow error in task selection. class RuleRecursionOverflowError < StandardError def initialize(*args) super @targets = [] end def add_target(target) @targets << target end def message super + ": [" + @targets.reverse.join(" => ") + "]" end end end rake-12.3.1/lib/rake/scope.rb000066400000000000000000000016031325463231200156470ustar00rootroot00000000000000# frozen_string_literal: true module Rake class Scope < LinkedList # :nodoc: all # Path for the scope. def path map(&:to_s).reverse.join(":") end # Path for the scope + the named path. def path_with_task_name(task_name) "#{path}:#{task_name}" end # Trim +n+ innermost scope levels from the scope. In no case will # this trim beyond the toplevel scope. def trim(n) result = self while n > 0 && ! result.empty? result = result.tail n -= 1 end result end # Scope lists always end with an EmptyScope object. See Null # Object Pattern) class EmptyScope < EmptyLinkedList @parent = Scope def path "" end def path_with_task_name(task_name) task_name end end # Singleton null object for an empty scope. EMPTY = EmptyScope.new end end rake-12.3.1/lib/rake/task.rb000066400000000000000000000277241325463231200155140ustar00rootroot00000000000000# frozen_string_literal: true require "rake/invocation_exception_mixin" module Rake ## # A Task is the basic unit of work in a Rakefile. Tasks have associated # actions (possibly more than one) and a list of prerequisites. When # invoked, a task will first ensure that all of its prerequisites have an # opportunity to run and then it will execute its own actions. # # Tasks are not usually created directly using the new method, but rather # use the +file+ and +task+ convenience methods. # class Task # List of prerequisites for a task. attr_reader :prerequisites # List of actions attached to a task. attr_reader :actions # Application owning this task. attr_accessor :application # Array of nested namespaces names used for task lookup by this task. attr_reader :scope # File/Line locations of each of the task definitions for this # task (only valid if the task was defined with the detect # location option set). attr_reader :locations # Has this task already been invoked? Already invoked tasks # will be skipped unless you reenable them. attr_reader :already_invoked # Return task name def to_s name end def inspect # :nodoc: "<#{self.class} #{name} => [#{prerequisites.join(', ')}]>" end # List of sources for task. attr_writer :sources def sources if defined?(@sources) @sources else prerequisites end end # List of prerequisite tasks def prerequisite_tasks prerequisites.map { |pre| lookup_prerequisite(pre) } end def lookup_prerequisite(prerequisite_name) # :nodoc: scoped_prerequisite_task = application[prerequisite_name, @scope] if scoped_prerequisite_task == self unscoped_prerequisite_task = application[prerequisite_name] end unscoped_prerequisite_task || scoped_prerequisite_task end private :lookup_prerequisite # List of all unique prerequisite tasks including prerequisite tasks' # prerequisites. # Includes self when cyclic dependencies are found. def all_prerequisite_tasks seen = {} collect_prerequisites(seen) seen.values end def collect_prerequisites(seen) # :nodoc: prerequisite_tasks.each do |pre| next if seen[pre.name] seen[pre.name] = pre pre.collect_prerequisites(seen) end end protected :collect_prerequisites # First source from a rule (nil if no sources) def source sources.first end # Create a task named +task_name+ with no actions or prerequisites. Use # +enhance+ to add actions and prerequisites. def initialize(task_name, app) @name = task_name.to_s @prerequisites = [] @actions = [] @already_invoked = false @comments = [] @lock = Monitor.new @application = app @scope = app.current_scope @arg_names = nil @locations = [] @invocation_exception = nil end # Enhance a task with prerequisites or actions. Returns self. def enhance(deps=nil, &block) @prerequisites |= deps if deps @actions << block if block_given? self end # Name of the task, including any namespace qualifiers. def name @name.to_s end # Name of task with argument list description. def name_with_args # :nodoc: if arg_description "#{name}#{arg_description}" else name end end # Argument description (nil if none). def arg_description # :nodoc: @arg_names ? "[#{arg_names.join(',')}]" : nil end # Name of arguments for this task. def arg_names @arg_names || [] end # Reenable the task, allowing its tasks to be executed if the task # is invoked again. def reenable @already_invoked = false end # Clear the existing prerequisites, actions, comments, and arguments of a rake task. def clear clear_prerequisites clear_actions clear_comments clear_args self end # Clear the existing prerequisites of a rake task. def clear_prerequisites prerequisites.clear self end # Clear the existing actions on a rake task. def clear_actions actions.clear self end # Clear the existing comments on a rake task. def clear_comments @comments = [] self end # Clear the existing arguments on a rake task. def clear_args @arg_names = nil self end # Invoke the task if it is needed. Prerequisites are invoked first. def invoke(*args) task_args = TaskArguments.new(arg_names, args) invoke_with_call_chain(task_args, InvocationChain::EMPTY) end # Same as invoke, but explicitly pass a call chain to detect # circular dependencies. # # If multiple tasks depend on this # one in parallel, they will all fail if the first execution of # this task fails. def invoke_with_call_chain(task_args, invocation_chain) new_chain = Rake::InvocationChain.append(self, invocation_chain) @lock.synchronize do begin if application.options.trace application.trace "** Invoke #{name} #{format_trace_flags}" end if @already_invoked if @invocation_exception if application.options.trace application.trace "** Previous invocation of #{name} failed #{format_trace_flags}" end raise @invocation_exception else return end end @already_invoked = true invoke_prerequisites(task_args, new_chain) execute(task_args) if needed? rescue Exception => ex add_chain_to(ex, new_chain) @invocation_exception = ex raise ex end end end protected :invoke_with_call_chain def add_chain_to(exception, new_chain) # :nodoc: exception.extend(InvocationExceptionMixin) unless exception.respond_to?(:chain) exception.chain = new_chain if exception.chain.nil? end private :add_chain_to # Invoke all the prerequisites of a task. def invoke_prerequisites(task_args, invocation_chain) # :nodoc: if application.options.always_multitask invoke_prerequisites_concurrently(task_args, invocation_chain) else prerequisite_tasks.each { |p| prereq_args = task_args.new_scope(p.arg_names) p.invoke_with_call_chain(prereq_args, invocation_chain) } end end # Invoke all the prerequisites of a task in parallel. def invoke_prerequisites_concurrently(task_args, invocation_chain)# :nodoc: futures = prerequisite_tasks.map do |p| prereq_args = task_args.new_scope(p.arg_names) application.thread_pool.future(p) do |r| r.invoke_with_call_chain(prereq_args, invocation_chain) end end futures.each(&:value) end # Format the trace flags for display. def format_trace_flags flags = [] flags << "first_time" unless @already_invoked flags << "not_needed" unless needed? flags.empty? ? "" : "(" + flags.join(", ") + ")" end private :format_trace_flags # Execute the actions associated with this task. def execute(args=nil) args ||= EMPTY_TASK_ARGS if application.options.dryrun application.trace "** Execute (dry run) #{name}" return end application.trace "** Execute #{name}" if application.options.trace application.enhance_with_matching_rule(name) if @actions.empty? @actions.each { |act| act.call(self, args) } end # Is this task needed? def needed? true end # Timestamp for this task. Basic tasks return the current time for their # time stamp. Other tasks can be more sophisticated. def timestamp Time.now end # Add a description to the task. The description can consist of an option # argument list (enclosed brackets) and an optional comment. def add_description(description) return unless description comment = description.strip add_comment(comment) if comment && ! comment.empty? end def comment=(comment) # :nodoc: add_comment(comment) end def add_comment(comment) # :nodoc: return if comment.nil? @comments << comment unless @comments.include?(comment) end private :add_comment # Full collection of comments. Multiple comments are separated by # newlines. def full_comment transform_comments("\n") end # First line (or sentence) of all comments. Multiple comments are # separated by a "/". def comment transform_comments(" / ") { |c| first_sentence(c) } end # Transform the list of comments as specified by the block and # join with the separator. def transform_comments(separator, &block) if @comments.empty? nil else block ||= lambda { |c| c } @comments.map(&block).join(separator) end end private :transform_comments # Get the first sentence in a string. The sentence is terminated # by the first period, exclamation mark, or the end of the line. # Decimal points do not count as periods. def first_sentence(string) string.split(/(?<=\w)(\.|!)[ \t]|(\.$|!)|\n/).first end private :first_sentence # Set the names of the arguments for this task. +args+ should be # an array of symbols, one for each argument name. def set_arg_names(args) @arg_names = args.map(&:to_sym) end # Return a string describing the internal state of a task. Useful for # debugging. def investigation result = "------------------------------\n".dup result << "Investigating #{name}\n" result << "class: #{self.class}\n" result << "task needed: #{needed?}\n" result << "timestamp: #{timestamp}\n" result << "pre-requisites: \n" prereqs = prerequisite_tasks prereqs.sort! { |a, b| a.timestamp <=> b.timestamp } prereqs.each do |p| result << "--#{p.name} (#{p.timestamp})\n" end latest_prereq = prerequisite_tasks.map(&:timestamp).max result << "latest-prerequisite time: #{latest_prereq}\n" result << "................................\n\n" return result end # ---------------------------------------------------------------- # Rake Module Methods # class << self # Clear the task list. This cause rake to immediately forget all the # tasks that have been assigned. (Normally used in the unit tests.) def clear Rake.application.clear end # List of all defined tasks. def tasks Rake.application.tasks end # Return a task with the given name. If the task is not currently # known, try to synthesize one from the defined rules. If no rules are # found, but an existing file matches the task name, assume it is a file # task with no dependencies or actions. def [](task_name) Rake.application[task_name] end # TRUE if the task name is already defined. def task_defined?(task_name) Rake.application.lookup(task_name) != nil end # Define a task given +args+ and an option block. If a rule with the # given name already exists, the prerequisites and actions are added to # the existing task. Returns the defined task. def define_task(*args, &block) Rake.application.define_task(self, *args, &block) end # Define a rule for synthesizing tasks. def create_rule(*args, &block) Rake.application.create_rule(*args, &block) end # Apply the scope to the task name according to the rules for # this kind of task. Generic tasks will accept the scope as # part of the name. def scope_name(scope, task_name) scope.path_with_task_name(task_name) end end # class << Rake::Task end # class Rake::Task end rake-12.3.1/lib/rake/task_argument_error.rb000066400000000000000000000002251325463231200206120ustar00rootroot00000000000000# frozen_string_literal: true module Rake # Error indicating an ill-formed task declaration. class TaskArgumentError < ArgumentError end end rake-12.3.1/lib/rake/task_arguments.rb000066400000000000000000000046441325463231200175750ustar00rootroot00000000000000# frozen_string_literal: true module Rake ## # TaskArguments manage the arguments passed to a task. # class TaskArguments include Enumerable # Argument names attr_reader :names # Create a TaskArgument object with a list of argument +names+ and a set # of associated +values+. +parent+ is the parent argument object. def initialize(names, values, parent=nil) @names = names @parent = parent @hash = {} @values = values names.each_with_index { |name, i| next if values[i].nil? || values[i] == "" @hash[name.to_sym] = values[i] } end # Retrieve the complete array of sequential values def to_a @values.dup end # Retrieve the list of values not associated with named arguments def extras @values[@names.length..-1] || [] end # Create a new argument scope using the prerequisite argument # names. def new_scope(names) values = names.map { |n| self[n] } self.class.new(names, values + extras, self) end # Find an argument value by name or index. def [](index) lookup(index.to_sym) end # Specify a hash of default values for task arguments. Use the # defaults only if there is no specific value for the given # argument. def with_defaults(defaults) @hash = defaults.merge(@hash) end # Enumerates the arguments and their values def each(&block) @hash.each(&block) end # Extracts the argument values at +keys+ def values_at(*keys) keys.map { |k| lookup(k) } end # Returns the value of the given argument via method_missing def method_missing(sym, *args) lookup(sym.to_sym) end # Returns a Hash of arguments and their values def to_hash @hash.dup end def to_s # :nodoc: inspect end def inspect # :nodoc: inspection = @hash.map do |k,v| "#{k.to_s}: #{v.to_s}" end.join(", ") "#<#{self.class} #{inspection}>" end # Returns true if +key+ is one of the arguments def has_key?(key) @hash.has_key?(key) end alias key? has_key? def fetch(*args, &block) @hash.fetch(*args, &block) end protected def lookup(name) # :nodoc: if @hash.has_key?(name) @hash[name] elsif @parent @parent.lookup(name) end end end EMPTY_TASK_ARGS = TaskArguments.new([], []) # :nodoc: end rake-12.3.1/lib/rake/task_manager.rb000066400000000000000000000231231325463231200171730ustar00rootroot00000000000000# frozen_string_literal: true module Rake # The TaskManager module is a mixin for managing tasks. module TaskManager # Track the last comment made in the Rakefile. attr_accessor :last_description def initialize # :nodoc: super @tasks = Hash.new @rules = Array.new @scope = Scope.make @last_description = nil end def create_rule(*args, &block) # :nodoc: pattern, args, deps = resolve_args(args) pattern = Regexp.new(Regexp.quote(pattern) + "$") if String === pattern @rules << [pattern, args, deps, block] end def define_task(task_class, *args, &block) # :nodoc: task_name, arg_names, deps = resolve_args(args) original_scope = @scope if String === task_name and not task_class.ancestors.include? Rake::FileTask task_name, *definition_scope = *(task_name.split(":").reverse) @scope = Scope.make(*(definition_scope + @scope.to_a)) end task_name = task_class.scope_name(@scope, task_name) deps = [deps] unless deps.respond_to?(:to_ary) deps = deps.map { |d| Rake.from_pathname(d).to_s } task = intern(task_class, task_name) task.set_arg_names(arg_names) unless arg_names.empty? if Rake::TaskManager.record_task_metadata add_location(task) task.add_description(get_description(task)) end task.enhance(deps, &block) ensure @scope = original_scope end # Lookup a task. Return an existing task if found, otherwise # create a task of the current type. def intern(task_class, task_name) @tasks[task_name.to_s] ||= task_class.new(task_name, self) end # Find a matching task for +task_name+. def [](task_name, scopes=nil) task_name = task_name.to_s self.lookup(task_name, scopes) or enhance_with_matching_rule(task_name) or synthesize_file_task(task_name) or fail generate_message_for_undefined_task(task_name) end def generate_message_for_undefined_task(task_name) message = "Don't know how to build task '#{task_name}' (see --tasks)" message + generate_did_you_mean_suggestions(task_name) end def generate_did_you_mean_suggestions(task_name) return "" unless defined?(::DidYouMean::SpellChecker) suggestions = ::DidYouMean::SpellChecker.new(dictionary: @tasks.keys).correct(task_name.to_s) if ::DidYouMean.respond_to?(:formatter)# did_you_mean v1.2.0 or later ::DidYouMean.formatter.message_for(suggestions) elsif defined?(::DidYouMean::Formatter) # before did_you_mean v1.2.0 ::DidYouMean::Formatter.new(suggestions).to_s else "" end end def synthesize_file_task(task_name) # :nodoc: return nil unless File.exist?(task_name) define_task(Rake::FileTask, task_name) end # Resolve the arguments for a task/rule. Returns a triplet of # [task_name, arg_name_list, prerequisites]. def resolve_args(args) if args.last.is_a?(Hash) deps = args.pop resolve_args_with_dependencies(args, deps) else resolve_args_without_dependencies(args) end end # Resolve task arguments for a task or rule when there are no # dependencies declared. # # The patterns recognized by this argument resolving function are: # # task :t # task :t, [:a] # def resolve_args_without_dependencies(args) task_name = args.shift if args.size == 1 && args.first.respond_to?(:to_ary) arg_names = args.first.to_ary else arg_names = args end [task_name, arg_names, []] end private :resolve_args_without_dependencies # Resolve task arguments for a task or rule when there are # dependencies declared. # # The patterns recognized by this argument resolving function are: # # task :t => [:d] # task :t, [a] => [:d] # def resolve_args_with_dependencies(args, hash) # :nodoc: fail "Task Argument Error" if hash.size != 1 key, value = hash.map { |k, v| [k, v] }.first if args.empty? task_name = key arg_names = [] deps = value || [] else task_name = args.shift arg_names = key deps = value end deps = [deps] unless deps.respond_to?(:to_ary) [task_name, arg_names, deps] end private :resolve_args_with_dependencies # If a rule can be found that matches the task name, enhance the # task with the prerequisites and actions from the rule. Set the # source attribute of the task appropriately for the rule. Return # the enhanced task or nil of no rule was found. def enhance_with_matching_rule(task_name, level=0) fail Rake::RuleRecursionOverflowError, "Rule Recursion Too Deep" if level >= 16 @rules.each do |pattern, args, extensions, block| if pattern && pattern.match(task_name) task = attempt_rule(task_name, pattern, args, extensions, block, level) return task if task end end nil rescue Rake::RuleRecursionOverflowError => ex ex.add_target(task_name) fail ex end # List of all defined tasks in this application. def tasks @tasks.values.sort_by { |t| t.name } end # List of all the tasks defined in the given scope (and its # sub-scopes). def tasks_in_scope(scope) prefix = scope.path tasks.select { |t| /^#{prefix}:/ =~ t.name } end # Clear all tasks in this application. def clear @tasks.clear @rules.clear end # Lookup a task, using scope and the scope hints in the task name. # This method performs straight lookups without trying to # synthesize file tasks or rules. Special scope names (e.g. '^') # are recognized. If no scope argument is supplied, use the # current scope. Return nil if the task cannot be found. def lookup(task_name, initial_scope=nil) initial_scope ||= @scope task_name = task_name.to_s if task_name =~ /^rake:/ scopes = Scope.make task_name = task_name.sub(/^rake:/, "") elsif task_name =~ /^(\^+)/ scopes = initial_scope.trim($1.size) task_name = task_name.sub(/^(\^+)/, "") else scopes = initial_scope end lookup_in_scope(task_name, scopes) end # Lookup the task name def lookup_in_scope(name, scope) loop do tn = scope.path_with_task_name(name) task = @tasks[tn] return task if task break if scope.empty? scope = scope.tail end nil end private :lookup_in_scope # Return the list of scope names currently active in the task # manager. def current_scope @scope end # Evaluate the block in a nested namespace named +name+. Create # an anonymous namespace if +name+ is nil. def in_namespace(name) name ||= generate_name @scope = Scope.new(name, @scope) ns = NameSpace.new(self, @scope) yield(ns) ns ensure @scope = @scope.tail end private # Add a location to the locations field of the given task. def add_location(task) loc = find_location task.locations << loc if loc task end # Find the location that called into the dsl layer. def find_location locations = caller i = 0 while locations[i] return locations[i + 1] if locations[i] =~ /rake\/dsl_definition.rb/ i += 1 end nil end # Generate an anonymous namespace name. def generate_name @seed ||= 0 @seed += 1 "_anon_#{@seed}" end def trace_rule(level, message) # :nodoc: options.trace_output.puts "#{" " * level}#{message}" if Rake.application.options.trace_rules end # Attempt to create a rule given the list of prerequisites. def attempt_rule(task_name, task_pattern, args, extensions, block, level) sources = make_sources(task_name, task_pattern, extensions) prereqs = sources.map { |source| trace_rule level, "Attempting Rule #{task_name} => #{source}" if File.exist?(source) || Rake::Task.task_defined?(source) trace_rule level, "(#{task_name} => #{source} ... EXIST)" source elsif parent = enhance_with_matching_rule(source, level + 1) trace_rule level, "(#{task_name} => #{source} ... ENHANCE)" parent.name else trace_rule level, "(#{task_name} => #{source} ... FAIL)" return nil end } task = FileTask.define_task(task_name, { args => prereqs }, &block) task.sources = prereqs task end # Make a list of sources from the list of file name extensions / # translation procs. def make_sources(task_name, task_pattern, extensions) result = extensions.map { |ext| case ext when /%/ task_name.pathmap(ext) when %r{/} ext when /^\./ source = task_name.sub(task_pattern, ext) source == ext ? task_name.ext(ext) : source when String ext when Proc, Method if ext.arity == 1 ext.call(task_name) else ext.call end else fail "Don't know how to handle rule dependent: #{ext.inspect}" end } result.flatten end # Return the current description, clearing it in the process. def get_description(task) desc = @last_description @last_description = nil desc end class << self attr_accessor :record_task_metadata # :nodoc: TaskManager.record_task_metadata = false end end end rake-12.3.1/lib/rake/tasklib.rb000066400000000000000000000002451325463231200161700ustar00rootroot00000000000000# frozen_string_literal: true require "rake" module Rake # Base class for Task Libraries. class TaskLib include Cloneable include Rake::DSL end end rake-12.3.1/lib/rake/testtask.rb000066400000000000000000000137761325463231200164160ustar00rootroot00000000000000# frozen_string_literal: true require "rake" require "rake/tasklib" module Rake # Create a task that runs a set of tests. # # Example: # require "rake/testtask" # # Rake::TestTask.new do |t| # t.libs << "test" # t.test_files = FileList['test/test*.rb'] # t.verbose = true # end # # If rake is invoked with a "TEST=filename" command line option, # then the list of test files will be overridden to include only the # filename specified on the command line. This provides an easy way # to run just one test. # # If rake is invoked with a "TESTOPTS=options" command line option, # then the given options are passed to the test process after a # '--'. This allows Test::Unit options to be passed to the test # suite. # # Examples: # # rake test # run tests normally # rake test TEST=just_one_file.rb # run just one test file. # rake test TESTOPTS="-v" # run in verbose mode # rake test TESTOPTS="--runner=fox" # use the fox test runner # class TestTask < TaskLib # Name of test task. (default is :test) attr_accessor :name # List of directories added to $LOAD_PATH before running the # tests. (default is 'lib') attr_accessor :libs # True if verbose test output desired. (default is false) attr_accessor :verbose # Test options passed to the test suite. An explicit # TESTOPTS=opts on the command line will override this. (default # is NONE) attr_accessor :options # Request that the tests be run with the warning flag set. # E.g. warning=true implies "ruby -w" used to run the tests. # (default is true) attr_accessor :warning # Glob pattern to match test files. (default is 'test/test*.rb') attr_accessor :pattern # Style of test loader to use. Options are: # # * :rake -- Rake provided test loading script (default). # * :testrb -- Ruby provided test loading script. # * :direct -- Load tests using command line loader. # attr_accessor :loader # Array of command line options to pass to ruby when running test loader. attr_accessor :ruby_opts # Description of the test task. (default is 'Run tests') attr_accessor :description # Task prerequisites. attr_accessor :deps # Explicitly define the list of test files to be included in a # test. +list+ is expected to be an array of file names (a # FileList is acceptable). If both +pattern+ and +test_files+ are # used, then the list of test files is the union of the two. def test_files=(list) @test_files = list end # Create a testing task. def initialize(name=:test) @name = name @libs = ["lib"] @pattern = nil @options = nil @test_files = nil @verbose = false @warning = true @loader = :rake @ruby_opts = [] @description = "Run tests" + (@name == :test ? "" : " for #{@name}") @deps = [] if @name.is_a?(Hash) @deps = @name.values.first @name = @name.keys.first end yield self if block_given? @pattern = "test/test*.rb" if @pattern.nil? && @test_files.nil? define end # Create the tasks defined by this task lib. def define desc @description task @name => Array(deps) do FileUtilsExt.verbose(@verbose) do puts "Use TESTOPTS=\"--verbose\" to pass --verbose" \ ", etc. to runners." if ARGV.include? "--verbose" args = "#{ruby_opts_string} #{run_code} " + "#{file_list_string} #{option_list}" ruby args do |ok, status| if !ok && status.respond_to?(:signaled?) && status.signaled? raise SignalException.new(status.termsig) elsif !ok status = "Command failed with status (#{status.exitstatus})" details = ": [ruby #{args}]" message = if Rake.application.options.trace or @verbose status + details else status end fail message end end end end self end def option_list # :nodoc: (ENV["TESTOPTS"] || ENV["TESTOPT"] || ENV["TEST_OPTS"] || ENV["TEST_OPT"] || @options || "") end def ruby_opts_string # :nodoc: opts = @ruby_opts.dup opts.unshift("-I\"#{lib_path}\"") unless @libs.empty? opts.unshift("-w") if @warning opts.join(" ") end def lib_path # :nodoc: @libs.join(File::PATH_SEPARATOR) end def file_list_string # :nodoc: file_list.map { |fn| "\"#{fn}\"" }.join(" ") end def file_list # :nodoc: if ENV["TEST"] FileList[ENV["TEST"]] else result = [] result += @test_files.to_a if @test_files result += FileList[@pattern].to_a if @pattern result end end def ruby_version # :nodoc: RUBY_VERSION end def run_code # :nodoc: case @loader when :direct "-e \"ARGV.each{|f| require f}\"" when :testrb "-S testrb" when :rake "#{rake_include_arg} \"#{rake_loader}\"" end end def rake_loader # :nodoc: find_file("rake/rake_test_loader") or fail "unable to find rake test loader" end def find_file(fn) # :nodoc: $LOAD_PATH.each do |path| file_path = File.join(path, "#{fn}.rb") return file_path if File.exist? file_path end nil end def rake_include_arg # :nodoc: spec = Gem.loaded_specs["rake"] if spec.respond_to?(:default_gem?) && spec.default_gem? "" else "-I\"#{rake_lib_dir}\"" end end def rake_lib_dir # :nodoc: find_dir("rake") or fail "unable to find rake lib" end def find_dir(fn) # :nodoc: $LOAD_PATH.each do |path| file_path = File.join(path, "#{fn}.rb") return path if File.exist? file_path end nil end end end rake-12.3.1/lib/rake/thread_history_display.rb000066400000000000000000000022041325463231200213110ustar00rootroot00000000000000# frozen_string_literal: true require "rake/private_reader" module Rake class ThreadHistoryDisplay # :nodoc: all include Rake::PrivateReader private_reader :stats, :items, :threads def initialize(stats) @stats = stats @items = { _seq_: 1 } @threads = { _seq_: "A" } end def show puts "Job History:" stats.each do |stat| stat[:data] ||= {} rename(stat, :thread, threads) rename(stat[:data], :item_id, items) rename(stat[:data], :new_thread, threads) rename(stat[:data], :deleted_thread, threads) printf("%8d %2s %-20s %s\n", (stat[:time] * 1_000_000).round, stat[:thread], stat[:event], stat[:data].map do |k, v| "#{k}:#{v}" end.join(" ")) end end private def rename(hash, key, renames) if hash && hash[key] original = hash[key] value = renames[original] unless value value = renames[:_seq_] renames[:_seq_] = renames[:_seq_].succ renames[original] = value end hash[key] = value end end end end rake-12.3.1/lib/rake/thread_pool.rb000066400000000000000000000112571325463231200170440ustar00rootroot00000000000000# frozen_string_literal: true require "set" require "rake/promise" module Rake class ThreadPool # :nodoc: all # Creates a ThreadPool object. The +thread_count+ parameter is the size # of the pool. def initialize(thread_count) @max_active_threads = [thread_count, 0].max @threads = Set.new @threads_mon = Monitor.new @queue = Queue.new @join_cond = @threads_mon.new_cond @history_start_time = nil @history = [] @history_mon = Monitor.new @total_threads_in_play = 0 end # Creates a future executed by the +ThreadPool+. # # The args are passed to the block when executing (similarly to # Thread#new) The return value is an object representing # a future which has been created and added to the queue in the # pool. Sending #value to the object will sleep the # current thread until the future is finished and will return the # result (or raise an exception thrown from the future) def future(*args, &block) promise = Promise.new(args, &block) promise.recorder = lambda { |*stats| stat(*stats) } @queue.enq promise stat :queued, item_id: promise.object_id start_thread promise end # Waits until the queue of futures is empty and all threads have exited. def join @threads_mon.synchronize do begin stat :joining @join_cond.wait unless @threads.empty? stat :joined rescue Exception => e stat :joined $stderr.puts e $stderr.print "Queue contains #{@queue.size} items. " + "Thread pool contains #{@threads.count} threads\n" $stderr.print "Current Thread #{Thread.current} status = " + "#{Thread.current.status}\n" $stderr.puts e.backtrace.join("\n") @threads.each do |t| $stderr.print "Thread #{t} status = #{t.status}\n" $stderr.puts t.backtrace.join("\n") end raise e end end end # Enable the gathering of history events. def gather_history #:nodoc: @history_start_time = Time.now if @history_start_time.nil? end # Return a array of history events for the thread pool. # # History gathering must be enabled to be able to see the events # (see #gather_history). Best to call this when the job is # complete (i.e. after ThreadPool#join is called). def history # :nodoc: @history_mon.synchronize { @history.dup }. sort_by { |i| i[:time] }. each { |i| i[:time] -= @history_start_time } end # Return a hash of always collected statistics for the thread pool. def statistics # :nodoc: { total_threads_in_play: @total_threads_in_play, max_active_threads: @max_active_threads, } end private # processes one item on the queue. Returns true if there was an # item to process, false if there was no item def process_queue_item #:nodoc: return false if @queue.empty? # Even though we just asked if the queue was empty, it # still could have had an item which by this statement # is now gone. For this reason we pass true to Queue#deq # because we will sleep indefinitely if it is empty. promise = @queue.deq(true) stat :dequeued, item_id: promise.object_id promise.work return true rescue ThreadError # this means the queue is empty false end def safe_thread_count @threads_mon.synchronize do @threads.count end end def start_thread # :nodoc: @threads_mon.synchronize do next unless @threads.count < @max_active_threads t = Thread.new do begin while safe_thread_count <= @max_active_threads break unless process_queue_item end ensure @threads_mon.synchronize do @threads.delete Thread.current stat :ended, thread_count: @threads.count @join_cond.broadcast if @threads.empty? end end end @threads << t stat( :spawned, new_thread: t.object_id, thread_count: @threads.count) @total_threads_in_play = @threads.count if @threads.count > @total_threads_in_play end end def stat(event, data=nil) # :nodoc: return if @history_start_time.nil? info = { event: event, data: data, time: Time.now, thread: Thread.current.object_id, } @history_mon.synchronize { @history << info } end # for testing only def __queue__ # :nodoc: @queue end end end rake-12.3.1/lib/rake/trace_output.rb000066400000000000000000000010771325463231200172610ustar00rootroot00000000000000# frozen_string_literal: true module Rake module TraceOutput # :nodoc: all # Write trace output to output stream +out+. # # The write is done as a single IO call (to print) to lessen the # chance that the trace output is interrupted by other tasks also # producing output. def trace_on(out, *strings) sep = $\ || "\n" if strings.empty? output = sep else output = strings.map { |s| next if s.nil? s.end_with?(sep) ? s : s + sep }.join end out.print(output) end end end rake-12.3.1/lib/rake/version.rb000066400000000000000000000003201325463231200162160ustar00rootroot00000000000000# frozen_string_literal: true module Rake VERSION = "12.3.1" module Version # :nodoc: all MAJOR, MINOR, BUILD, *OTHER = Rake::VERSION.split "." NUMBERS = [MAJOR, MINOR, BUILD, *OTHER] end end rake-12.3.1/lib/rake/win32.rb000066400000000000000000000030201325463231200154730ustar00rootroot00000000000000# frozen_string_literal: true require "rbconfig" module Rake # Win 32 interface methods for Rake. Windows specific functionality # will be placed here to collect that knowledge in one spot. module Win32 # :nodoc: all # Error indicating a problem in locating the home directory on a # Win32 system. class Win32HomeError < RuntimeError end class << self # True if running on a windows system. def windows? RbConfig::CONFIG["host_os"] =~ %r!(msdos|mswin|djgpp|mingw|[Ww]indows)! end # The standard directory containing system wide rake files on # Win 32 systems. Try the following environment variables (in # order): # # * HOME # * HOMEDRIVE + HOMEPATH # * APPDATA # * USERPROFILE # # If the above are not defined, the return nil. def win32_system_dir #:nodoc: win32_shared_path = ENV["HOME"] if win32_shared_path.nil? && ENV["HOMEDRIVE"] && ENV["HOMEPATH"] win32_shared_path = ENV["HOMEDRIVE"] + ENV["HOMEPATH"] end win32_shared_path ||= ENV["APPDATA"] win32_shared_path ||= ENV["USERPROFILE"] raise Win32HomeError, "Unable to determine home path environment variable." if win32_shared_path.nil? or win32_shared_path.empty? normalize(File.join(win32_shared_path, "Rake")) end # Normalize a win32 path so that the slashes are all forward slashes. def normalize(path) path.gsub(/\\/, "/") end end end end rake-12.3.1/rake.gemspec000066400000000000000000000035701325463231200150150ustar00rootroot00000000000000# frozen_string_literal: true $LOAD_PATH.unshift File.expand_path('../lib', __FILE__) require 'rake/version' Gem::Specification.new do |s| s.name = "rake".freeze s.version = Rake::VERSION s.authors = ["Hiroshi SHIBATA".freeze, "Eric Hodel".freeze, "Jim Weirich".freeze] s.email = ["hsbt@ruby-lang.org".freeze, "drbrain@segment7.net".freeze, "".freeze] s.summary = "Rake is a Make-like program implemented in Ruby".freeze s.description = <<-DESCRIPTION Rake is a Make-like program implemented in Ruby. Tasks and dependencies are specified in standard Ruby syntax. Rake has the following features: * Rakefiles (rake's version of Makefiles) are completely defined in standard Ruby syntax. No XML files to edit. No quirky Makefile syntax to worry about (is that a tab or a space?) * Users can specify tasks with prerequisites. * Rake supports rule patterns to synthesize implicit tasks. * Flexible FileLists that act like arrays but know about manipulating file names and paths. * Supports parallel execution of tasks. DESCRIPTION s.homepage = "https://github.com/ruby/rake".freeze s.licenses = ["MIT".freeze] s.files = %x[git ls-files -z].split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) } - %w[.rubocop.yml .travis.yml appveyor.yml] s.bindir = "exe" s.executables = s.files.grep(%r{^exe/}) { |f| File.basename(f) } s.require_paths = ["lib".freeze] s.required_ruby_version = Gem::Requirement.new(">= 2.0.0".freeze) s.rubygems_version = "2.6.1".freeze s.required_rubygems_version = Gem::Requirement.new(">= 1.3.2".freeze) s.rdoc_options = ["--main".freeze, "README.rdoc".freeze] s.add_development_dependency(%q.freeze) s.add_development_dependency(%q.freeze) s.add_development_dependency(%q.freeze) s.add_development_dependency(%q.freeze) s.add_development_dependency(%q.freeze) end rake-12.3.1/test/000077500000000000000000000000001325463231200135005ustar00rootroot00000000000000rake-12.3.1/test/helper.rb000066400000000000000000000053041325463231200153060ustar00rootroot00000000000000# frozen_string_literal: true $:.unshift File.expand_path("../../lib", __FILE__) begin gem "coveralls" require "coveralls" Coveralls.wear! rescue Gem::LoadError end gem "minitest", "~> 5" require "minitest/autorun" require "rake" require "tmpdir" require_relative "support/file_creation" require_relative "support/ruby_runner" require_relative "support/rakefile_definitions" class Rake::TestCase < Minitest::Test include FileCreation include Rake::DSL class TaskManager include Rake::TaskManager end RUBY = ENV["BUNDLE_RUBY"] || Gem.ruby def setup ARGV.clear @verbose = ENV["VERBOSE"] @rake_root = File.expand_path "../../", __FILE__ @rake_exec = File.join @rake_root, "exe", "rake" @rake_lib = File.join @rake_root, "lib" @ruby_options = ["-I#{@rake_lib}", "-I."] @orig_pwd = Dir.pwd @orig_appdata = ENV["APPDATA"] @orig_home = ENV["HOME"] @orig_homedrive = ENV["HOMEDRIVE"] @orig_homepath = ENV["HOMEPATH"] @orig_rake_columns = ENV["RAKE_COLUMNS"] @orig_rake_system = ENV["RAKE_SYSTEM"] @orig_rakeopt = ENV["RAKEOPT"] @orig_userprofile = ENV["USERPROFILE"] ENV.delete "RAKE_COLUMNS" ENV.delete "RAKE_SYSTEM" ENV.delete "RAKEOPT" tmpdir = Dir.chdir Dir.tmpdir do Dir.pwd end @tempdir = File.join tmpdir, "test_rake_#{$$}" FileUtils.mkdir_p @tempdir Dir.chdir @tempdir Rake.application = Rake::Application.new Rake::TaskManager.record_task_metadata = true RakeFileUtils.verbose_flag = false end def teardown Dir.chdir @orig_pwd FileUtils.rm_rf @tempdir if @orig_appdata ENV["APPDATA"] = @orig_appdata else ENV.delete "APPDATA" end ENV["HOME"] = @orig_home ENV["HOMEDRIVE"] = @orig_homedrive ENV["HOMEPATH"] = @orig_homepath ENV["RAKE_COLUMNS"] = @orig_rake_columns ENV["RAKE_SYSTEM"] = @orig_rake_system ENV["RAKEOPT"] = @orig_rakeopt ENV["USERPROFILE"] = @orig_userprofile end def ignore_deprecations Rake.application.options.ignore_deprecate = true yield ensure Rake.application.options.ignore_deprecate = false end def rake_system_dir @system_dir = "system" FileUtils.mkdir_p @system_dir open File.join(@system_dir, "sys1.rake"), "w" do |io| io << <<-SYS task "sys1" do puts "SYS1" end SYS end ENV["RAKE_SYSTEM"] = @system_dir end def rakefile(contents) open "Rakefile", "w" do |io| io << contents end end def jruby? defined?(JRUBY_VERSION) end def jruby17? jruby? && (JRUBY_VERSION < "9.0.0.0") end def jruby9? jruby? && (JRUBY_VERSION >= "9.0.0.0") end include RakefileDefinitions end rake-12.3.1/test/support/000077500000000000000000000000001325463231200152145ustar00rootroot00000000000000rake-12.3.1/test/support/file_creation.rb000066400000000000000000000015111325463231200203420ustar00rootroot00000000000000# frozen_string_literal: true module FileCreation OLDFILE = "old" NEWFILE = "new" def create_timed_files(oldfile, *newfiles) return if (File.exist?(oldfile) && newfiles.all? { |newfile| File.exist?(newfile) && File.stat(newfile).mtime > File.stat(oldfile).mtime }) now = Time.now create_file(oldfile, now - 60) newfiles.each do |newfile| create_file(newfile, now) end end def create_dir(dirname) FileUtils.mkdir_p(dirname) unless File.exist?(dirname) File.stat(dirname).mtime end def create_file(name, file_time=nil) create_dir(File.dirname(name)) FileUtils.touch(name) unless File.exist?(name) File.utime(file_time, file_time, name) unless file_time.nil? File.stat(name).mtime end def delete_file(name) File.delete(name) rescue nil end end rake-12.3.1/test/support/rakefile_definitions.rb000066400000000000000000000205771325463231200217310ustar00rootroot00000000000000# frozen_string_literal: true module RakefileDefinitions include FileUtils def rakefile_access rakefile <<-ACCESS TOP_LEVEL_CONSTANT = 0 def a_top_level_function end task :default => [:work, :obj, :const] task :work do begin a_top_level_function puts "GOOD:M Top level methods can be called in tasks" rescue NameError => ex puts "BAD:M Top level methods can not be called in tasks" end end task :obj do begin Object.new.instance_eval { task :xyzzy } puts "BAD:D Rake DSL are polluting objects" rescue StandardError => ex puts "GOOD:D Rake DSL are not polluting objects" end end task :const do begin TOP_LEVEL_CONSTANT puts "GOOD:C Top level constants are available in tasks" rescue StandardError => ex puts "BAD:C Top level constants are NOT available in tasks" end end ACCESS end def rakefile_test_task rakefile <<-RAKEFILE require "rake/testtask" Rake::TestTask.new(:unit) do |t| t.description = "custom test task description" end RAKEFILE end def rakefile_test_task_verbose rakefile <<-RAKEFILE require "rake/testtask" Rake::TestTask.new(:unit) do |t| t.verbose = true end RAKEFILE end def rakefile_chains rakefile <<-DEFAULT task :default => "play.app" file "play.scpt" => "base" do |t| cp t.prerequisites.first, t.name end rule ".app" => ".scpt" do |t| cp t.source, t.name end file 'base' do touch 'base' end DEFAULT end def rakefile_file_chains rakefile <<-RAKEFILE file "fileA" do |t| sh "echo contentA >\#{t.name}" end file "fileB" => "fileA" do |t| sh "(cat fileA; echo transformationB) >\#{t.name}" end file "fileC" => "fileB" do |t| sh "(cat fileB; echo transformationC) >\#{t.name}" end task default: "fileC" RAKEFILE end def rakefile_comments rakefile <<-COMMENTS # comment for t1 task :t1 do end # no comment or task because there's a blank line task :t2 do end desc "override comment for t3" # this is not the description multitask :t3 do end # this is not the description desc "override comment for t4" file :t4 do end COMMENTS end def rakefile_override rakefile <<-OVERRIDE task :t1 do puts :foo end task :t1 do puts :bar end OVERRIDE end def rakefile_default rakefile <<-DEFAULT if ENV['TESTTOPSCOPE'] puts "TOPSCOPE" end task :default do puts "DEFAULT" end task :other => [:default] do puts "OTHER" end task :task_scope do if ENV['TESTTASKSCOPE'] puts "TASKSCOPE" end end DEFAULT end def rakefile_dryrun rakefile <<-DRYRUN task :default => ["temp_main"] file "temp_main" => [:all_apps] do touch "temp_main" end task :all_apps => [:one, :two] task :one => ["temp_one"] task :two => ["temp_two"] file "temp_one" do |t| touch "temp_one" end file "temp_two" do |t| touch "temp_two" end task :clean do ["temp_one", "temp_two", "temp_main"].each do |file| rm_f file end end DRYRUN FileUtils.touch "temp_main" FileUtils.touch "temp_two" end def rakefile_extra rakefile "task :default" FileUtils.mkdir_p "rakelib" open File.join("rakelib", "extra.rake"), "w" do |io| io << <<-EXTRA_RAKE # Added for testing namespace :extra do desc "An Extra Task" task :extra do puts "Read all about it" end end EXTRA_RAKE end end def rakefile_file_creation rakefile <<-'FILE_CREATION' N = 2 task :default => :run BUILD_DIR = 'build' task :clean do rm_rf 'build' rm_rf 'src' end task :run TARGET_DIR = 'build/copies' FileList['src/*'].each do |src| directory TARGET_DIR target = File.join TARGET_DIR, File.basename(src) file target => [src, TARGET_DIR] do cp src, target end task :run => target end task :prep => :clean do mkdir_p 'src' N.times do |n| touch "src/foo#{n}" end end FILE_CREATION end def rakefile_imports rakefile <<-IMPORTS require 'rake/loaders/makefile' task :default task :other do puts "OTHER" end file "dynamic_deps" do |t| open(t.name, "w") do |f| f.puts "puts 'DYNAMIC'" end end import "dynamic_deps" import "static_deps" import "static_deps" import "deps.mf" puts "FIRST" IMPORTS open "deps.mf", "w" do |io| io << <<-DEPS default: other DEPS end open "static_deps", "w" do |f| f.puts 'puts "STATIC"' end end def rakefile_regenerate_imports rakefile <<-REGENERATE_IMPORTS task :default task :regenerate do open("deps", "w") do |f| f << <<-CONTENT file "deps" => :regenerate puts "REGENERATED" CONTENT end end import "deps" REGENERATE_IMPORTS open "deps", "w" do |f| f << <<-CONTENT file "deps" => :regenerate puts "INITIAL" CONTENT end end def rakefile_multidesc rakefile <<-MULTIDESC task :b desc "A" task :a desc "B" task :b desc "A2" task :a task :c desc "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" task :d MULTIDESC end def rakefile_namespace rakefile <<-NAMESPACE desc "copy" task :copy do puts "COPY" end namespace "nest" do desc "nest copy" task :copy do puts "NEST COPY" end task :xx => :copy end anon_ns = namespace do desc "anonymous copy task" task :copy do puts "ANON COPY" end end desc "Top level task to run the anonymous version of copy" task :anon => anon_ns[:copy] namespace "very" do namespace "nested" do task "run" => "rake:copy" end end namespace "a" do desc "Run task in the 'a' namespace" task "run" do puts "IN A" end end namespace "b" do desc "Run task in the 'b' namespace" task "run" => "a:run" do puts "IN B" end end namespace "file1" do file "xyz.rb" do puts "XYZ1" end end namespace "file2" do file "xyz.rb" do puts "XYZ2" end end namespace "scopedep" do task :prepare do touch "scopedep.rb" puts "PREPARE" end file "scopedep.rb" => [:prepare] do puts "SCOPEDEP" end end NAMESPACE end def rakefile_nosearch FileUtils.touch "dummy" end def rakefile_rakelib FileUtils.mkdir_p "rakelib" Dir.chdir "rakelib" do open "test1.rb", "w" do |io| io << <<-TEST1 task :default do puts "TEST1" end TEST1 end open "test2.rake", "w" do |io| io << <<-TEST1 task :default do puts "TEST2" end TEST1 end end end def rakefile_rbext open "rakefile.rb", "w" do |io| io << 'task :default do puts "OK" end' end end def rakefile_unittest rakefile "# Empty Rakefile for Unit Test" readme = File.join "subdir", "README" FileUtils.mkdir_p File.dirname readme FileUtils.touch readme end def rakefile_verbose rakefile <<-VERBOSE task :standalone_verbose_true do verbose true sh "#{RUBY} -e '0'" end task :standalone_verbose_false do verbose false sh "#{RUBY} -e '0'" end task :inline_verbose_default do sh "#{RUBY} -e '0'" end task :inline_verbose_false do sh "#{RUBY} -e '0'", :verbose => false end task :inline_verbose_true do sh "#{RUBY} -e '0'", :verbose => true end task :block_verbose_true do verbose(true) do sh "#{RUBY} -e '0'" end end task :block_verbose_false do verbose(false) do sh "#{RUBY} -e '0'" end end VERBOSE end def rakefile_test_signal rakefile <<-TEST_SIGNAL require 'rake/testtask' Rake::TestTask.new(:a) do |t| t.test_files = ['a_test.rb'] end Rake::TestTask.new(:b) do |t| t.test_files = ['b_test.rb'] end task :test do Rake::Task[:a].invoke Rake::Task[:b].invoke end task :default => :test TEST_SIGNAL open "a_test.rb", "w" do |io| io << 'puts "ATEST"' << "\n" io << "$stdout.flush" << "\n" io << 'Process.kill("TERM", $$)' << "\n" end open "b_test.rb", "w" do |io| io << 'puts "BTEST"' << "\n" io << "$stdout.flush" << "\n" end end def rakefile_failing_test_task rakefile <<-TEST_TASK require 'rake/testtask' task :default => :test Rake::TestTask.new(:test) do |t| t.test_files = ['a_test.rb'] end TEST_TASK open "a_test.rb", "w" do |io| io << "require 'minitest/autorun'\n" io << "class ExitTaskTest < Minitest::Test\n" io << " def test_exit\n" io << " assert false, 'this should fail'\n" io << " end\n" io << "end\n" end end def rakefile_stand_alone_filelist open "stand_alone_filelist.rb", "w" do |io| io << "require 'rake/file_list'\n" io << "FL = Rake::FileList['*.rb']\n" io << "puts FL\n" end end end rake-12.3.1/test/support/ruby_runner.rb000066400000000000000000000017541325463231200201220ustar00rootroot00000000000000# frozen_string_literal: true module RubyRunner include FileUtils # Run a shell Ruby command with command line options (using the # default test options). Output is captured in @out and @err def ruby(*option_list) run_ruby(@ruby_options + option_list) end # Run a command line rake with the give rake options. Default # command line ruby options are included. Output is captured in # @out and @err def rake(*rake_options) run_ruby @ruby_options + [@rake_exec] + rake_options end # Low level ruby command runner ... def run_ruby(option_list) puts "COMMAND: [#{RUBY} #{option_list.join ' '}]" if @verbose Open3.popen3(RUBY, *option_list) do |inn, out, err, wait| inn.close @exit = wait ? wait.value : $? @out = out.read @err = err.read end puts "OUTPUT: [#{@out}]" if @verbose puts "ERROR: [#{@err}]" if @verbose puts "EXIT: [#{@exit.inspect}]" if @verbose puts "PWD: [#{Dir.pwd}]" if @verbose end end rake-12.3.1/test/test_private_reader.rb000066400000000000000000000013321325463231200200570ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "rake/private_reader" class TestPrivateAttrs < Rake::TestCase class Sample include Rake::PrivateReader private_reader :reader, :a def initialize @reader = :RVALUE end def get_reader reader end end def setup super @sample = Sample.new end def test_private_reader_is_private assert_private do @sample.reader end assert_private do @sample.a end end def test_private_reader_returns_data assert_equal :RVALUE, @sample.get_reader end private def assert_private ex = assert_raises(NoMethodError) do yield end assert_match(/private/, ex.message) end end rake-12.3.1/test/test_rake.rb000066400000000000000000000020101325463231200157770ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRake < Rake::TestCase def test_each_dir_parent assert_equal ["a"], alldirs("a") assert_equal ["a/b", "a"], alldirs("a/b") assert_equal ["/a/b", "/a", "/"], alldirs("/a/b") if File.dirname("c:/foo") == "c:" # Under Unix assert_equal ["c:/a/b", "c:/a", "c:"], alldirs("c:/a/b") assert_equal ["c:a/b", "c:a"], alldirs("c:a/b") else # Under Windows assert_equal ["c:/a/b", "c:/a", "c:/"], alldirs("c:/a/b") assert_equal ["c:a/b", "c:a"], alldirs("c:a/b") end end def alldirs(fn) result = [] Rake.each_dir_parent(fn) { |d| result << d } result end def test_can_override_application old_app = Rake.application fake_app = Object.new Rake.application = fake_app assert_equal fake_app, Rake.application ensure Rake.application = old_app end def test_original_dir_reports_current_dir assert_equal @tempdir, Rake.original_dir end end rake-12.3.1/test/test_rake_application.rb000066400000000000000000000363651325463231200204060ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeApplication < Rake::TestCase def setup super @app = Rake.application @app.options.rakelib = [] end def test_class_with_application orig_app = Rake.application return_app = Rake.with_application do |yield_app| refute_equal orig_app, yield_app, "new application must be yielded" assert_equal yield_app, Rake.application, "new application must be default in block" end refute_equal orig_app, return_app, "new application not returned" assert_equal orig_app, Rake.application, "original application not default" end def test_class_with_application_user_defined orig_app = Rake.application user_app = Rake::Application.new return_app = Rake.with_application user_app do |yield_app| assert_equal user_app, yield_app, "user application must be yielded" assert_equal user_app, Rake.application, "user application must be default in block" end assert_equal user_app, return_app, "user application not returned" assert_equal orig_app, Rake.application, "original application not default" end def test_display_exception_details obj = Object.new obj.instance_eval("def #{__method__}; raise 'test'; end", "ruby") begin obj.__send__(__method__) rescue => ex end out, err = capture_io do @app.set_default_options # reset trace output IO @app.display_error_message ex end assert_empty out assert_match "rake aborted!", err assert_match __method__.to_s, err end def test_display_exception_details_bad_encoding begin raise "El Niño is coming!".dup.force_encoding("US-ASCII") rescue => ex end out, err = capture_io do @app.set_default_options # reset trace output IO @app.display_error_message ex end assert_empty out assert_match "El Niño is coming!", err.force_encoding("UTF-8") end def test_display_exception_details_cause skip "Exception#cause not implemented" unless Exception.method_defined? :cause begin raise "cause a" rescue begin raise "cause b" rescue => ex end end out, err = capture_io do @app.set_default_options # reset trace output IO @app.display_error_message ex end assert_empty out assert_match "Caused by:", err assert_match "cause a", err assert_match "cause b", err end def test_display_tasks @app.options.show_tasks = :tasks @app.options.show_task_pattern = // @app.last_description = "COMMENT" @app.define_task(Rake::Task, "t") out, = capture_io do @app.instance_eval { display_tasks_and_comments } end assert_match(/^rake t/, out) assert_match(/# COMMENT/, out) end def test_display_tasks_with_long_comments @app.terminal_columns = 80 @app.options.show_tasks = :tasks @app.options.show_task_pattern = // numbers = "1234567890" * 8 @app.last_description = numbers @app.define_task(Rake::Task, "t") out, = capture_io do @app.instance_eval { display_tasks_and_comments } end assert_match(/^rake t/, out) assert_match(/# #{numbers[0, 65]}\.\.\./, out) end def test_display_tasks_with_task_name_wider_than_tty_display @app.terminal_columns = 80 @app.options.show_tasks = :tasks @app.options.show_task_pattern = // task_name = "task name" * 80 @app.last_description = "something short" @app.define_task(Rake::Task, task_name) out, = capture_io do @app.instance_eval { display_tasks_and_comments } end # Ensure the entire task name is output and we end up showing no description assert_match(/rake #{task_name} # .../, out) end def test_display_tasks_with_very_long_task_name_to_a_non_tty_shows_name_and_comment @app.options.show_tasks = :tasks @app.options.show_task_pattern = // @app.tty_output = false description = "something short" task_name = "task name" * 80 @app.last_description = "something short" @app.define_task(Rake::Task, task_name) out, = capture_io do @app.instance_eval { display_tasks_and_comments } end # Ensure the entire task name is output and we end up showing no description assert_match(/rake #{task_name} # #{description}/, out) end def test_display_tasks_with_long_comments_to_a_non_tty_shows_entire_comment @app.options.show_tasks = :tasks @app.options.show_task_pattern = // @app.tty_output = false @app.last_description = "1234567890" * 8 @app.define_task(Rake::Task, "t") out, = capture_io do @app.instance_eval { display_tasks_and_comments } end assert_match(/^rake t/, out) assert_match(/# #{@app.last_description}/, out) end def test_truncating_comments_to_a_non_tty @app.terminal_columns = 80 @app.options.show_tasks = :tasks @app.options.show_task_pattern = // @app.tty_output = false numbers = "1234567890" * 8 @app.last_description = numbers @app.define_task(Rake::Task, "t") out, = capture_io do @app.instance_eval { display_tasks_and_comments } end assert_match(/^rake t/, out) assert_match(/# #{numbers[0, 65]}\.\.\./, out) end def test_describe_tasks @app.options.show_tasks = :describe @app.options.show_task_pattern = // @app.last_description = "COMMENT" @app.define_task(Rake::Task, "t") out, = capture_io do @app.instance_eval { display_tasks_and_comments } end assert_match(/^rake t$/, out) assert_match(/^ {4}COMMENT$/, out) end def test_show_lines @app.options.show_tasks = :lines @app.options.show_task_pattern = // @app.last_description = "COMMENT" @app.define_task(Rake::Task, "t") @app["t"].locations << "HERE:1" out, = capture_io do @app.instance_eval { display_tasks_and_comments } end assert_match(/^rake t +[^:]+:\d+ *$/, out) end def test_finding_rakefile rakefile_default assert_match(/Rakefile/i, @app.instance_eval { have_rakefile }) end def test_not_finding_rakefile @app.instance_eval { @rakefiles = ["NEVER_FOUND"] } assert(! @app.instance_eval do have_rakefile end) assert_nil @app.rakefile end def test_load_rakefile rakefile_unittest @app.instance_eval do handle_options [] options.silent = true load_rakefile end assert_equal "rakefile", @app.rakefile.downcase assert_equal @tempdir, Dir.pwd end def test_load_rakefile_doesnt_print_rakefile_directory_from_same_dir rakefile_unittest _, err = capture_io do @app.instance_eval do # pretend we started from the unittest dir @original_dir = File.expand_path(".") raw_load_rakefile end end assert_empty err end def test_load_rakefile_from_subdir rakefile_unittest Dir.chdir "subdir" @app.instance_eval do handle_options [] options.silent = true load_rakefile end assert_equal "rakefile", @app.rakefile.downcase assert_equal @tempdir, Dir.pwd end def test_load_rakefile_prints_rakefile_directory_from_subdir rakefile_unittest Dir.chdir "subdir" app = Rake::Application.new app.options.rakelib = [] _, err = capture_io do app.instance_eval do raw_load_rakefile end end assert_equal "(in #{@tempdir}\)\n", err end def test_load_rakefile_doesnt_print_rakefile_directory_from_subdir_if_silent rakefile_unittest Dir.chdir "subdir" _, err = capture_io do @app.instance_eval do handle_options [] options.silent = true raw_load_rakefile end end assert_empty err end def test_load_rakefile_not_found skip if jruby9? Dir.chdir @tempdir ENV["RAKE_SYSTEM"] = "not_exist" @app.instance_eval do handle_options [] options.silent = true end ex = assert_raises(RuntimeError) do @app.instance_eval do raw_load_rakefile end end assert_match(/no rakefile found/i, ex.message) end def test_load_from_system_rakefile rake_system_dir @app.instance_eval do handle_options [] options.silent = true options.load_system = true options.rakelib = [] load_rakefile end assert_equal @system_dir, @app.system_dir assert_nil @app.rakefile rescue SystemExit flunk "failed to load rakefile" end def test_load_from_calculated_system_rakefile rakefile_default def @app.standard_system_dir "__STD_SYS_DIR__" end ENV["RAKE_SYSTEM"] = nil @app.instance_eval do handle_options [] options.silent = true options.load_system = true options.rakelib = [] load_rakefile end assert_equal "__STD_SYS_DIR__", @app.system_dir rescue SystemExit flunk "failed to find system rakefile" end def test_terminal_columns old_rake_columns = ENV["RAKE_COLUMNS"] ENV["RAKE_COLUMNS"] = "42" app = Rake::Application.new assert_equal 42, app.terminal_columns ensure if old_rake_columns ENV["RAKE_COLUMNS"] = old_rake_columns else ENV.delete "RAKE_COLUMNS" end end def test_windows assert ! (@app.windows? && @app.unix?) end def test_loading_imports loader = util_loader @app.instance_eval do add_loader("dummy", loader) add_import("x.dummy") load_imports end # HACK no assertions end def test_building_imported_files_on_demand loader = util_loader @app.instance_eval do intern(Rake::Task, "x.dummy").enhance do loader.make_dummy end add_loader("dummy", loader) add_import("x.dummy") load_imports end # HACK no assertions end def test_handle_options_should_not_strip_options_from_argv assert !@app.options.trace argv = %w[--trace] @app.handle_options argv assert_includes argv, "--trace" assert @app.options.trace end def test_handle_options_trace_default_is_stderr @app.handle_options %w[--trace] assert_equal STDERR, @app.options.trace_output assert @app.options.trace end def test_handle_options_trace_overrides_to_stdout @app.handle_options %w[--trace=stdout] assert_equal STDOUT, @app.options.trace_output assert @app.options.trace end def test_handle_options_trace_does_not_eat_following_task_names assert !@app.options.trace argv = %w[--trace sometask] @app.handle_options argv assert argv.include?("sometask") assert @app.options.trace end def test_good_run ran = false @app.options.silent = true @app.instance_eval do intern(Rake::Task, "default").enhance { ran = true } end rakefile_default out, err = capture_io do @app.run %w[--rakelib=""] end assert ran assert_empty err assert_equal "DEFAULT\n", out end def test_display_task_run ran = false @app.last_description = "COMMENT" @app.define_task(Rake::Task, "default") out, = capture_io { @app.run %w[-f -s --tasks --rakelib=""] } assert @app.options.show_tasks assert ! ran assert_match(/rake default/, out) assert_match(/# COMMENT/, out) end def test_display_prereqs ran = false @app.last_description = "COMMENT" t = @app.define_task(Rake::Task, "default") t.enhance([:a, :b]) @app.define_task(Rake::Task, "a") @app.define_task(Rake::Task, "b") out, = capture_io { @app.run %w[-f -s --prereqs --rakelib=""] } assert @app.options.show_prereqs assert ! ran assert_match(/rake a$/, out) assert_match(/rake b$/, out) assert_match(/rake default\n( *(a|b)\n){2}/m, out) end def test_bad_run @app.intern(Rake::Task, "default").enhance { fail } _, err = capture_io { assert_raises(SystemExit) { @app.run %w[-f -s --rakelib=""] } } assert_match(/see full trace/i, err) end def test_bad_run_with_trace @app.intern(Rake::Task, "default").enhance { fail } _, err = capture_io { @app.set_default_options assert_raises(SystemExit) { @app.run %w[-f -s -t] } } refute_match(/see full trace/i, err) end def test_bad_run_with_backtrace @app.intern(Rake::Task, "default").enhance { fail } _, err = capture_io { assert_raises(SystemExit) { @app.run %w[-f -s --backtrace] } } refute_match(/see full trace/, err) end CustomError = Class.new(RuntimeError) def test_bad_run_includes_exception_name @app.intern(Rake::Task, "default").enhance { raise CustomError, "intentional" } _, err = capture_io { assert_raises(SystemExit) { @app.run %w[-f -s] } } assert_match(/CustomError: intentional/, err) end def test_rake_error_excludes_exception_name @app.intern(Rake::Task, "default").enhance { fail "intentional" } _, err = capture_io { assert_raises(SystemExit) { @app.run %w[-f -s] } } refute_match(/RuntimeError/, err) assert_match(/intentional/, err) end def cause_supported? ex = StandardError.new ex.respond_to?(:cause) end def test_printing_original_exception_cause custom_error = Class.new(StandardError) @app.intern(Rake::Task, "default").enhance { begin raise custom_error, "Original Error" rescue custom_error raise custom_error, "Secondary Error" end } _ ,err = capture_io { assert_raises(SystemExit) { @app.run %w[-f -s] } } if cause_supported? assert_match(/Original Error/, err) end assert_match(/Secondary Error/, err) end def test_run_with_bad_options @app.intern(Rake::Task, "default").enhance { fail } assert_raises(SystemExit) { capture_io { @app.run %w[-f -s --xyzzy] } } end def test_standard_exception_handling_invalid_option out, err = capture_io do e = assert_raises SystemExit do @app.standard_exception_handling do raise OptionParser::InvalidOption, "blah" end end assert_equal 1, e.status end assert_empty out assert_equal "invalid option: blah\n", err end def test_standard_exception_handling_other out, err = capture_io do @app.set_default_options # reset trace output IO e = assert_raises SystemExit do @app.standard_exception_handling do raise "blah" end end assert_equal 1, e.status end assert_empty out assert_match "rake aborted!\n", err assert_match "blah\n", err end def test_standard_exception_handling_system_exit out, err = capture_io do e = assert_raises SystemExit do @app.standard_exception_handling do exit 0 end end assert_equal 0, e.status end assert_empty out assert_empty err end def test_standard_exception_handling_system_exit_nonzero out, err = capture_io do e = assert_raises SystemExit do @app.standard_exception_handling do exit 5 end end assert_equal 5, e.status end assert_empty out assert_empty err end def util_loader loader = Object.new loader.instance_variable_set :@load_called, false def loader.load(arg) raise ArgumentError, arg unless arg == "x.dummy" @load_called = true end loader.instance_variable_set :@make_dummy_called, false def loader.make_dummy @make_dummy_called = true end loader end end rake-12.3.1/test/test_rake_application_options.rb000066400000000000000000000303151325463231200221460ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) TESTING_REQUIRE = [] class TestRakeApplicationOptions < Rake::TestCase def setup super @testkey = ENV["TESTKEY"] Rake::FileUtilsExt.verbose_flag = false Rake::FileUtilsExt.nowrite_flag = false TESTING_REQUIRE.clear end def teardown ENV["TESTKEY"] = @testkey Rake::FileUtilsExt.verbose_flag = false Rake::FileUtilsExt.nowrite_flag = false super end def test_default_options opts = command_line assert_equal false, opts.backtrace assert_equal false, opts.dryrun assert_equal false, opts.ignore_system assert_equal false, opts.load_system assert_equal false, opts.always_multitask assert_equal false, opts.nosearch assert_equal ["rakelib"], opts.rakelib assert_equal false, opts.show_prereqs assert_nil opts.show_task_pattern assert_nil opts.show_tasks assert_equal false, opts.silent assert_equal false, opts.trace assert_equal Rake.suggested_thread_count, opts.thread_pool_size assert_equal ["rakelib"], opts.rakelib assert ! Rake::FileUtilsExt.verbose_flag assert ! Rake::FileUtilsExt.nowrite_flag end def test_dry_run flags("--dry-run", "-n") do |opts| assert opts.dryrun assert opts.trace assert Rake::FileUtilsExt.verbose_flag assert Rake::FileUtilsExt.nowrite_flag end end def test_describe flags("--describe") do |opts| assert_equal :describe, opts.show_tasks assert_equal(//.to_s, opts.show_task_pattern.to_s) end end def test_describe_with_pattern flags("--describe=X") do |opts| assert_equal :describe, opts.show_tasks assert_equal(/X/.to_s, opts.show_task_pattern.to_s) end end def test_execute $xyzzy = 0 flags("--execute=$xyzzy=1", "-e $xyzzy=1") do assert_equal 1, $xyzzy assert_equal :exit, @exit $xyzzy = 0 end end def test_execute_and_continue $xyzzy = 0 flags("--execute-continue=$xyzzy=1", "-E $xyzzy=1") do assert_equal 1, $xyzzy refute_equal :exit, @exit $xyzzy = 0 end end def test_execute_and_print $xyzzy = 0 out, = capture_io do flags('--execute-print=$xyzzy="pugh"', '-p $xyzzy="pugh"') do assert_equal "pugh", $xyzzy assert_equal :exit, @exit $xyzzy = 0 end end assert_match(/^pugh$/, out) end def test_help out, = capture_io do flags "--help", "-H", "-h" end assert_match(/\Arake/, out) assert_match(/\boptions\b/, out) assert_match(/\btargets\b/, out) assert_equal :exit, @exit end def test_jobs flags([]) do |opts| assert_equal Rake.suggested_thread_count, opts.thread_pool_size end flags(["--jobs", "0"], ["-j", "0"]) do |opts| assert_equal 0, opts.thread_pool_size end flags(["--jobs", "1"], ["-j", "1"]) do |opts| assert_equal 0, opts.thread_pool_size end flags(["--jobs", "4"], ["-j", "4"]) do |opts| assert_equal 3, opts.thread_pool_size end flags(["--jobs", "asdas"], ["-j", "asdas"]) do |opts| assert_equal Rake.suggested_thread_count-1, opts.thread_pool_size end flags("--jobs", "-j") do |opts| assert opts.thread_pool_size > 1_000_000, "thread pool size should be huge (was #{opts.thread_pool_size})" end end def test_libdir flags(["--libdir", "xx"], ["-I", "xx"], ["-Ixx"]) do $:.include?("xx") end ensure $:.delete("xx") end def test_multitask flags("--multitask", "-m") do |opts| assert_equal opts.always_multitask, true end end def test_rakefile flags(["--rakefile", "RF"], ["--rakefile=RF"], ["-f", "RF"], ["-fRF"]) do assert_equal ["RF"], @app.instance_eval { @rakefiles } end end def test_rakelib dirs = %w(A B C).join(File::PATH_SEPARATOR) flags( ["--rakelibdir", dirs], ["--rakelibdir=#{dirs}"], ["-R", dirs], ["-R#{dirs}"]) do |opts| assert_equal ["A", "B", "C"], opts.rakelib end end def test_require $LOAD_PATH.unshift @tempdir open "reqfile.rb", "w" do |io| io << "TESTING_REQUIRE << 1" end open "reqfile2.rb", "w" do |io| io << "TESTING_REQUIRE << 2" end open "reqfile3.rake", "w" do |io| io << "TESTING_REQUIRE << 3" end flags(["--require", "reqfile"], "-rreqfile2", "-rreqfile3") assert_includes TESTING_REQUIRE, 1 assert_includes TESTING_REQUIRE, 2 assert_includes TESTING_REQUIRE, 3 assert_equal 3, TESTING_REQUIRE.size ensure $LOAD_PATH.delete @tempdir end def test_missing_require ex = assert_raises(LoadError) do flags(["--require", "test/missing"]) do |opts| end end assert_match(/such file/, ex.message) assert_match(/test\/missing/, ex.message) end def test_prereqs flags("--prereqs", "-P") do |opts| assert opts.show_prereqs end end def test_quiet Rake::FileUtilsExt.verbose_flag = true flags("--quiet", "-q") do |opts| assert ! Rake::FileUtilsExt.verbose_flag, "verbose flag should be false" assert ! opts.silent, "should not be silent" end end def test_no_search flags("--nosearch", "--no-search", "-N") do |opts| assert opts.nosearch end end def test_silent Rake::FileUtilsExt.verbose_flag = true flags("--silent", "-s") do |opts| assert ! Rake::FileUtilsExt.verbose_flag, "verbose flag should be false" assert opts.silent, "should be silent" end end def test_system flags("--system", "-g") do |opts| assert opts.load_system end end def test_no_system flags("--no-system", "-G") do |opts| assert opts.ignore_system end end def test_trace flags("--trace", "-t") do |opts| assert opts.trace, "should enable trace option" assert opts.backtrace, "should enabled backtrace option" assert_equal $stderr, opts.trace_output assert Rake::FileUtilsExt.verbose_flag assert ! Rake::FileUtilsExt.nowrite_flag end end def test_trace_with_stdout flags("--trace=stdout", "-tstdout") do |opts| assert opts.trace, "should enable trace option" assert opts.backtrace, "should enabled backtrace option" assert_equal $stdout, opts.trace_output assert Rake::FileUtilsExt.verbose_flag assert ! Rake::FileUtilsExt.nowrite_flag end end def test_trace_with_stderr flags("--trace=stderr", "-tstderr") do |opts| assert opts.trace, "should enable trace option" assert opts.backtrace, "should enabled backtrace option" assert_equal $stderr, opts.trace_output assert Rake::FileUtilsExt.verbose_flag assert ! Rake::FileUtilsExt.nowrite_flag end end def test_trace_with_error ex = assert_raises(Rake::CommandLineOptionError) do flags("--trace=xyzzy") do |opts| end end assert_match(/un(known|recognized).*\btrace\b.*xyzzy/i, ex.message) end def test_trace_with_following_task_name flags(["--trace", "taskname"], ["-t", "taskname"]) do |opts| assert opts.trace, "should enable trace option" assert opts.backtrace, "should enabled backtrace option" assert_equal $stderr, opts.trace_output assert Rake::FileUtilsExt.verbose_flag assert_equal ["taskname"], @app.top_level_tasks end end def test_backtrace flags("--backtrace") do |opts| assert opts.backtrace, "should enable backtrace option" assert_equal $stderr, opts.trace_output assert ! opts.trace, "should not enable trace option" end end def test_backtrace_with_stdout flags("--backtrace=stdout") do |opts| assert opts.backtrace, "should enable backtrace option" assert_equal $stdout, opts.trace_output assert ! opts.trace, "should not enable trace option" end end def test_backtrace_with_stderr flags("--backtrace=stderr") do |opts| assert opts.backtrace, "should enable backtrace option" assert_equal $stderr, opts.trace_output assert ! opts.trace, "should not enable trace option" end end def test_backtrace_with_error ex = assert_raises(Rake::CommandLineOptionError) do flags("--backtrace=xyzzy") do |opts| end end assert_match(/un(known|recognized).*\bbacktrace\b.*xyzzy/i, ex.message) end def test_backtrace_with_following_task_name flags(["--backtrace", "taskname"]) do |opts| assert ! opts.trace, "should enable trace option" assert opts.backtrace, "should enabled backtrace option" assert_equal $stderr, opts.trace_output assert_equal ["taskname"], @app.top_level_tasks end end def test_trace_rules flags("--rules") do |opts| assert opts.trace_rules end end def test_tasks flags("--tasks", "-T") do |opts| assert_equal :tasks, opts.show_tasks assert_equal(//.to_s, opts.show_task_pattern.to_s) assert_equal false, opts.show_all_tasks end flags(["--tasks", "xyz"], ["-Txyz"]) do |opts| assert_equal :tasks, opts.show_tasks assert_equal(/xyz/.to_s, opts.show_task_pattern.to_s) assert_equal false, opts.show_all_tasks end flags(["--tasks", "xyz", "--comments"]) do |opts| assert_equal :tasks, opts.show_tasks assert_equal(/xyz/.to_s, opts.show_task_pattern.to_s) assert_equal false, opts.show_all_tasks end end def test_where flags("--where", "-W") do |opts| assert_equal :lines, opts.show_tasks assert_equal(//.to_s, opts.show_task_pattern.to_s) assert_equal true, opts.show_all_tasks end flags(["--where", "xyz"], ["-Wxyz"]) do |opts| assert_equal :lines, opts.show_tasks assert_equal(/xyz/.to_s, opts.show_task_pattern.to_s) assert_equal true, opts.show_all_tasks end flags(["--where", "xyz", "--comments"], ["-Wxyz", "--comments"]) do |opts| assert_equal :lines, opts.show_tasks assert_equal(/xyz/.to_s, opts.show_task_pattern.to_s) assert_equal false, opts.show_all_tasks end end def test_no_deprecated_messages flags("--no-deprecation-warnings", "-X") do |opts| assert opts.ignore_deprecate end end def test_verbose capture_io do flags("--verbose", "-v") do |opts| assert Rake::FileUtilsExt.verbose_flag, "verbose should be true" assert ! opts.silent, "opts should not be silent" end end end def test_version out, _ = capture_io do flags "--version", "-V" end assert_match(/\bversion\b/, out) assert_match(/\b#{Rake::VERSION}\b/, out) assert_equal :exit, @exit end def test_bad_option _, err = capture_io do ex = assert_raises(OptionParser::InvalidOption) do flags("--bad-option") end if ex.message =~ /^While/ # Ruby 1.9 error message assert_match(/while parsing/i, ex.message) else # Ruby 1.8 error message assert_match(/(invalid|unrecognized) option/i, ex.message) assert_match(/--bad-option/, ex.message) end end assert_equal "", err end def test_task_collection command_line("a", "b") assert_equal ["a", "b"], @tasks.sort end def test_default_task_collection command_line() assert_equal ["default"], @tasks end def test_environment_definition ENV.delete("TESTKEY") command_line("TESTKEY=12") assert_equal "12", ENV["TESTKEY"] end def test_multiline_environment_definition ENV.delete("TESTKEY") command_line("TESTKEY=a\nb\n") assert_equal "a\nb\n", ENV["TESTKEY"] end def test_environment_and_tasks_together ENV.delete("TESTKEY") command_line("a", "b", "TESTKEY=12") assert_equal ["a", "b"], @tasks.sort assert_equal "12", ENV["TESTKEY"] end def test_rake_explicit_task_library Rake.add_rakelib "app/task", "other" libs = Rake.application.options.rakelib assert libs.include?("app/task") assert libs.include?("other") end private def flags(*sets) sets.each do |set| @exit = catch(:system_exit) { command_line(*set) } yield(@app.options) if block_given? end end def command_line(*options) @app = Rake::Application.new def @app.exit(*args) throw :system_exit, :exit end @app.instance_eval do args = handle_options options collect_command_line_tasks(args) end @tasks = @app.top_level_tasks @app.options end end rake-12.3.1/test/test_rake_backtrace.rb000066400000000000000000000052441325463231200200120ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "open3" class TestBacktraceSuppression < Rake::TestCase def test_bin_rake_suppressed paths = ["something/bin/rake:12"] actual = Rake::Backtrace.collapse(paths) assert_equal [], actual end def test_system_dir_suppressed path = RbConfig::CONFIG["rubylibprefix"] skip if path.nil? path = File.expand_path path paths = [path + ":12"] actual = Rake::Backtrace.collapse(paths) assert_equal [], actual end def test_near_system_dir_isnt_suppressed path = RbConfig::CONFIG["rubylibprefix"] skip if path.nil? path = File.expand_path path paths = [" " + path + ":12"] actual = Rake::Backtrace.collapse(paths) assert_equal paths, actual end end class TestRakeBacktrace < Rake::TestCase include RubyRunner def setup super skip "tmpdir is suppressed in backtrace" if Rake::Backtrace::SUPPRESS_PATTERN =~ Dir.pwd end def invoke(*args) rake(*args) @err end def test_single_collapse rakefile %q{ task :foo do raise "foooo!" end } lines = invoke("foo").split("\n") assert_equal "rake aborted!", lines[0] assert_equal "foooo!", lines[1] assert_something_matches %r!\A#{Regexp.quote Dir.pwd}/Rakefile:3!i, lines assert_something_matches %r!\ATasks:!, lines end def test_multi_collapse rakefile %q{ task :foo do Rake.application.invoke_task(:bar) end task :bar do raise "barrr!" end } lines = invoke("foo").split("\n") assert_equal "rake aborted!", lines[0] assert_equal "barrr!", lines[1] assert_something_matches %r!\A#{Regexp.quote Dir.pwd}/Rakefile:6!i, lines assert_something_matches %r!\A#{Regexp.quote Dir.pwd}/Rakefile:3!i, lines assert_something_matches %r!\ATasks:!, lines end def test_suppress_option rakefile %q{ task :baz do raise "bazzz!" end } lines = invoke("baz").split("\n") assert_equal "rake aborted!", lines[0] assert_equal "bazzz!", lines[1] assert_something_matches %r!Rakefile!i, lines lines = invoke("--suppress-backtrace", ".ak.file", "baz").split("\n") assert_equal "rake aborted!", lines[0] assert_equal "bazzz!", lines[1] refute_match %r!Rakefile!i, lines[2] end private # Assert that the pattern matches at least one line in +lines+. def assert_something_matches(pattern, lines) lines.each do |ln| if pattern =~ ln assert_match pattern, ln return end end flunk "expected #{pattern.inspect} to match something in:\n" + "#{lines.join("\n ")}" end end rake-12.3.1/test/test_rake_clean.rb000066400000000000000000000057271325463231200171630ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "rake/clean" class TestRakeClean < Rake::TestCase def test_clean load "rake/clean.rb", true assert Rake::Task["clean"], "Should define clean" assert Rake::Task["clobber"], "Should define clobber" assert Rake::Task["clobber"].prerequisites.include?("clean"), "Clobber should require clean" end def test_cleanup file_name = create_undeletable_file out, _ = capture_io do Rake::Cleaner.cleanup(file_name, verbose: false) end assert_match(/failed to remove/i, out) ensure remove_undeletable_file end def test_cleanup_ignores_missing_files file_name = File.join(@tempdir, "missing_directory", "no_such_file") out, _ = capture_io do Rake::Cleaner.cleanup(file_name, verbose: false) end refute_match(/failed to remove/i, out) end def test_cleanup_trace file_name = create_file assert_output "", "rm -r #{file_name}\n" do with_trace true do Rake::Cleaner.cleanup(file_name) end end end def test_cleanup_without_trace file_name = create_file assert_output "", "" do with_trace false do Rake::Cleaner.cleanup(file_name) end end end def test_cleanup_opt_overrides_trace_silent file_name = create_file assert_output "", "" do with_trace true do Rake::Cleaner.cleanup(file_name, verbose: false) end end end def test_cleanup_opt_overrides_trace_verbose file_name = create_file assert_output "", "rm -r #{file_name}\n" do with_trace false do Rake::Cleaner.cleanup(file_name, verbose: true) end end end private def create_file dir_name = File.join(@tempdir, "deletedir") file_name = File.join(dir_name, "deleteme") FileUtils.mkdir(dir_name) FileUtils.touch(file_name) file_name end def create_undeletable_file dir_name = File.join(@tempdir, "deletedir") file_name = File.join(dir_name, "deleteme") FileUtils.mkdir(dir_name) FileUtils.touch(file_name) FileUtils.chmod(0, file_name) FileUtils.chmod(0, dir_name) begin FileUtils.chmod(0644, file_name) rescue file_name else skip "Permission to delete files is different on this system" end end def remove_undeletable_file dir_name = File.join(@tempdir, "deletedir") file_name = File.join(dir_name, "deleteme") FileUtils.chmod(0777, dir_name) FileUtils.chmod(0777, file_name) Rake::Cleaner.cleanup(file_name, verbose: false) Rake::Cleaner.cleanup(dir_name, verbose: false) end def with_trace(value) old, Rake.application.options.trace = Rake.application.options.trace, value # FileUtils caches the $stderr object, which breaks capture_io et. al. # We hack it here where it's convenient to do so. Rake::Cleaner.instance_variable_set :@fileutils_output, nil yield ensure Rake.application.options.trace = old end end rake-12.3.1/test/test_rake_cpu_counter.rb000066400000000000000000000027071325463231200204220ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeCpuCounter < Rake::TestCase def setup super @cpu_counter = Rake::CpuCounter.new end def test_count num = @cpu_counter.count skip "cannot count CPU" if num == nil assert_kind_of Numeric, num assert_operator num, :>=, 1 end def test_count_with_default_nil def @cpu_counter.count; nil; end assert_equal(8, @cpu_counter.count_with_default(8)) assert_equal(4, @cpu_counter.count_with_default) end def test_count_with_default_raise def @cpu_counter.count; raise; end assert_equal(8, @cpu_counter.count_with_default(8)) assert_equal(4, @cpu_counter.count_with_default) end class TestClassMethod < Rake::TestCase def setup super @klass = Class.new(Rake::CpuCounter) end def test_count @klass.class_eval do def count; 8; end end assert_equal(8, @klass.count) end def test_count_nil counted = false @klass.class_eval do define_method(:count) do counted = true nil end end assert_equal(4, @klass.count) assert_equal(true, counted) end def test_count_raise counted = false @klass.class_eval do define_method(:count) do counted = true raise end end assert_equal(4, @klass.count) assert_equal(true, counted) end end end rake-12.3.1/test/test_rake_definitions.rb000066400000000000000000000036661325463231200204140ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "fileutils" class TestRakeDefinitions < Rake::TestCase include Rake EXISTINGFILE = "existing" def setup super Task.clear end def test_task done = false task one: [:two] do done = true end task :two task three: [:one, :two] check_tasks(:one, :two, :three) assert done, "Should be done" end def test_file_task done = false file "one" => "two" do done = true end file "two" file "three" => ["one", "two"] check_tasks("one", "two", "three") assert done, "Should be done" end def check_tasks(n1, n2, n3) t = Task[n1] assert Task === t, "Should be a Task" assert_equal n1.to_s, t.name assert_equal [n2.to_s], t.prerequisites.map(&:to_s) t.invoke t2 = Task[n2] assert_equal FileList[], t2.prerequisites t3 = Task[n3] assert_equal [n1.to_s, n2.to_s], t3.prerequisites.map(&:to_s) end def test_incremental_definitions runs = [] task t1: [:t2] do runs << "A"; 4321 end task t1: [:t3] do runs << "B"; 1234 end task t1: [:t3] task :t2 task :t3 Task[:t1].invoke assert_equal ["A", "B"], runs assert_equal ["t2", "t3"], Task[:t1].prerequisites end def test_missing_dependencies task x: ["missing"] assert_raises(RuntimeError) { Task[:x].invoke } end def test_falsey_dependencies task x: nil assert_equal [], Task[:x].prerequisites end def test_implicit_file_dependencies runs = [] create_existing_file task y: [EXISTINGFILE] do |t| runs << t.name end Task[:y].invoke assert_equal runs, ["y"] end private # ---------------------------------------------------------- def create_existing_file Dir.mkdir File.dirname(EXISTINGFILE) unless File.exist?(File.dirname(EXISTINGFILE)) open(EXISTINGFILE, "w") do |f| f.puts "HI" end unless File.exist?(EXISTINGFILE) end end rake-12.3.1/test/test_rake_directory_task.rb000066400000000000000000000035401325463231200211160ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "fileutils" require "pathname" class TestRakeDirectoryTask < Rake::TestCase include Rake def test_directory desc "DESC" directory "a/b/c" assert_equal FileCreationTask, Task["a"].class assert_equal FileCreationTask, Task["a/b"].class assert_equal FileCreationTask, Task["a/b/c"].class assert_nil Task["a"].comment assert_nil Task["a/b"].comment assert_equal "DESC", Task["a/b/c"].comment verbose(false) { Task["a/b"].invoke } assert File.exist?("a/b") refute File.exist?("a/b/c") end def test_directory_colon directory "a:b" assert_equal FileCreationTask, Task["a:b"].class end unless Rake::Win32.windows? if Rake::Win32.windows? def test_directory_win32 desc "WIN32 DESC" directory "c:/a/b/c" assert_equal FileTask, Task["c:"].class assert_equal FileCreationTask, Task["c:/a"].class assert_equal FileCreationTask, Task["c:/a/b"].class assert_equal FileCreationTask, Task["c:/a/b/c"].class assert_nil Task["c:/"].comment assert_equal "WIN32 DESC", Task["c:/a/b/c"].comment assert_nil Task["c:/a/b"].comment end end def test_can_use_blocks runlist = [] t1 = directory("a/b/c" => :t2) { |t| runlist << t.name } task(:t2) { |t| runlist << t.name } verbose(false) { t1.invoke } assert_equal Task["a/b/c"], t1 assert_equal FileCreationTask, Task["a/b/c"].class assert_equal ["t2", "a/b/c"], runlist assert File.directory?("a/b/c") end def test_can_use_pathname directory Pathname.new "a/b/c" assert_equal FileCreationTask, Task["a/b/c"].class verbose(false) { Task["a/b/c"].invoke } assert File.directory?("a/b/c") end end rake-12.3.1/test/test_rake_dsl.rb000066400000000000000000000014271325463231200166540ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeDsl < Rake::TestCase def setup super Rake::Task.clear end def test_namespace_command namespace "n" do task "t" end refute_nil Rake::Task["n:t"] end def test_namespace_command_with_bad_name ex = assert_raises(ArgumentError) do namespace 1 do end end assert_match(/string/i, ex.message) assert_match(/symbol/i, ex.message) end def test_namespace_command_with_a_string_like_object name = Object.new def name.to_str "bob" end namespace name do task "t" end refute_nil Rake::Task["bob:t"] end def test_no_commands_constant assert ! defined?(Commands), "should not define Commands" end end rake-12.3.1/test/test_rake_early_time.rb000066400000000000000000000013621325463231200202220ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeEarlyTime < Rake::TestCase def test_create early = Rake::EarlyTime.instance assert early <= Time.now assert early < Time.now assert early != Time.now assert Time.now > early assert Time.now >= early assert Time.now != early end def test_equality early = Rake::EarlyTime.instance assert_equal early, early, "two early times should be equal" end def test_original_time_compare_is_not_messed_up t1 = Time.mktime(1970, 1, 1, 0, 0, 0) t2 = Time.now assert t1 < t2 assert t2 > t1 assert t1 == t1 assert t2 == t2 end def test_to_s assert_equal "", Rake::EARLY.to_s end end rake-12.3.1/test/test_rake_extension.rb000066400000000000000000000022741325463231200201070ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "stringio" class TestRakeExtension < Rake::TestCase module Redirect def error_redirect old_err = $stderr result = StringIO.new $stderr = result yield result ensure $stderr = old_err end end class Sample extend Redirect def duplicate_method :original end OK_ERRS = error_redirect do rake_extension("a") do def ok_method end end end DUP_ERRS = error_redirect do rake_extension("duplicate_method") do def duplicate_method :override end end end end def test_methods_actually_exist sample = Sample.new sample.ok_method sample.duplicate_method end def test_no_warning_when_defining_ok_method assert_equal "", Sample::OK_ERRS.string end def test_extension_complains_when_a_method_that_is_present assert_match(/warning:/i, Sample::DUP_ERRS.string) assert_match(/already exists/i, Sample::DUP_ERRS.string) assert_match(/duplicate_method/i, Sample::DUP_ERRS.string) assert_equal :original, Sample.new.duplicate_method end end rake-12.3.1/test/test_rake_file_creation_task.rb000066400000000000000000000032311325463231200217120ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "fileutils" class TestRakeFileCreationTask < Rake::TestCase include Rake DUMMY_DIR = "dummy_dir" def setup super Task.clear end def test_file_needed create_dir DUMMY_DIR fc_task = Task[DUMMY_DIR] assert_equal DUMMY_DIR, fc_task.name FileUtils.rm_rf fc_task.name assert fc_task.needed?, "file should be needed" FileUtils.mkdir fc_task.name assert_nil fc_task.prerequisites.map { |n| Task[n].timestamp }.max assert ! fc_task.needed?, "file should not be needed" end def test_directory directory DUMMY_DIR fc_task = Task[DUMMY_DIR] assert_equal DUMMY_DIR, fc_task.name assert FileCreationTask === fc_task end def test_no_retriggers_on_filecreate_task create_timed_files(OLDFILE, NEWFILE) t1 = Rake.application.intern(FileCreationTask, OLDFILE).enhance([NEWFILE]) t2 = Rake.application.intern(FileCreationTask, NEWFILE) assert ! t2.needed?, "Should not need to build new file" assert ! t1.needed?, "Should not need to rebuild old file because of new" end def test_no_retriggers_on_file_task create_timed_files(OLDFILE, NEWFILE) t1 = Rake.application.intern(FileCreationTask, OLDFILE).enhance([NEWFILE]) t2 = Rake.application.intern(FileCreationTask, NEWFILE) assert ! t2.needed?, "Should not need to build new file" assert ! t1.needed?, "Should not need to rebuild old file because of new" end def test_very_early_timestamp t1 = Rake.application.intern(FileCreationTask, OLDFILE) assert t1.timestamp < Time.now assert t1.timestamp < Time.now - 1_000_000 end end rake-12.3.1/test/test_rake_file_list.rb000066400000000000000000000423341325463231200200460ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "pathname" class TestRakeFileList < Rake::TestCase FileList = Rake::FileList def setup super FileUtils.mkdir "CVS" rescue nil FileUtils.mkdir ".svn" rescue nil @cdir = "cfiles" FileUtils.mkdir @cdir rescue nil FileUtils.touch ".dummy" FileUtils.touch "x.bak" FileUtils.touch "x~" FileUtils.touch "core" FileUtils.touch "x.c" FileUtils.touch "xyz.c" FileUtils.touch "abc.c" FileUtils.touch "abc.h" FileUtils.touch "abc.x" FileUtils.touch "existing" open "xyzzy.txt", "w" do |io| io.puts "x" io.puts "XYZZY" end end def test_delegating_methods_do_not_include_to_a_or_to_ary assert ! FileList::DELEGATING_METHODS.include?("to_a"), "should not include to_a" assert ! FileList::DELEGATING_METHODS.include?(:to_a), "should not include to_a" assert ! FileList::DELEGATING_METHODS.include?("to_ary"), "should not include to_ary" assert ! FileList::DELEGATING_METHODS.include?(:to_ary), "should not include to_ary" end def test_create fl = FileList.new assert_equal 0, fl.size end def test_create_with_args fl = FileList.new("*.c", "x") assert_equal ["abc.c", "x.c", "xyz.c", "x"].sort, fl.sort end def test_create_with_pathname fl = FileList.new(Pathname.new("*.c")) assert_equal ["abc.c", "x.c", "xyz.c"].sort, fl.sort end def test_create_with_block fl = FileList.new { |f| f.include("x") } assert_equal ["x"], fl.resolve end def test_create_with_brackets fl = FileList["*.c", "x"] assert_equal ["abc.c", "x.c", "xyz.c", "x"].sort, fl.sort end def test_create_with_brackets_and_filelist fl = FileList[FileList["*.c", "x"]] assert_equal ["abc.c", "x.c", "xyz.c", "x"].sort, fl.sort end def test_include_with_another_array fl = FileList.new.include(["x", "y", "z"]) assert_equal ["x", "y", "z"].sort, fl.sort end def test_include_with_another_filelist fl = FileList.new.include(FileList["*.c", "x"]) assert_equal ["abc.c", "x.c", "xyz.c", "x"].sort, fl.sort end def test_include_with_pathname fl = FileList.new.include(Pathname.new("*.c")) assert_equal ["abc.c", "x.c", "xyz.c"].sort, fl.sort end def test_append fl = FileList.new fl << "a.rb" << "b.rb" assert_equal ["a.rb", "b.rb"], fl end def test_append_pathname fl = FileList.new fl << Pathname.new("a.rb") assert_equal ["a.rb"], fl end def test_add_many fl = FileList.new fl.include %w(a d c) fl.include("x", "y") assert_equal ["a", "d", "c", "x", "y"], fl assert_equal ["a", "d", "c", "x", "y"], fl.resolve end def test_add_return f = FileList.new g = f << "x" assert_equal f.object_id, g.object_id h = f.include("y") assert_equal f.object_id, h.object_id end def test_match fl = FileList.new fl.include "*.c" assert_equal %w[abc.c x.c xyz.c], fl.sort end def test_add_matching fl = FileList.new fl << "a.java" fl.include "*.c" assert_equal %w[a.java abc.c x.c xyz.c], fl.sort end def test_multiple_patterns fl = FileList.new fl.include("*.z", "*foo*") assert_equal [], fl fl.include("*.c", "*xist*") assert_equal %w[x.c xyz.c abc.c existing].sort, fl.sort end def test_square_bracket_pattern fl = FileList.new fl.include("abc.[ch]") assert fl.size == 2 assert fl.include?("abc.c") assert fl.include?("abc.h") end def test_curly_bracket_pattern fl = FileList.new fl.include("abc.{c,h}") assert fl.size == 2 assert fl.include?("abc.c") assert fl.include?("abc.h") end def test_reject fl = FileList.new fl.include %w(x.c abc.c xyz.c existing) fl.reject! { |fn| fn =~ /^x/ } assert_equal %w[abc.c existing], fl end def test_exclude fl = FileList["x.c", "abc.c", "xyz.c", "existing"] fl.each { |fn| touch fn, verbose: false } x = fl.exclude(%r{^x.+\.}) assert_equal FileList, x.class assert_equal %w(x.c abc.c existing), fl assert_equal fl.object_id, x.object_id fl.exclude("*.c") assert_equal ["existing"], fl fl.exclude("existing") assert_equal [], fl end def test_exclude_pathname fl = FileList["x.c", "abc.c", "other"] fl.each { |fn| touch fn, verbose: false } fl.exclude(Pathname.new("*.c")) assert_equal ["other"], fl end def test_excluding_via_block fl = FileList["a.c", "b.c", "xyz.c"] fl.exclude { |fn| fn.pathmap("%n") == "xyz" } assert fl.excluded_from_list?("xyz.c"), "Should exclude xyz.c" assert_equal ["a.c", "b.c"], fl end def test_exclude_return_on_create fl = FileList["*"].exclude(/.*\.[hcx]$/) assert_equal %w[cfiles existing xyzzy.txt], fl.sort assert_equal FileList, fl.class end def test_exclude_with_string_return_on_create fl = FileList["*"].exclude("abc.c") assert_equal %w[abc.h abc.x cfiles existing x.c xyz.c xyzzy.txt], fl.sort assert_equal FileList, fl.class end def test_exclude_curly_bracket_pattern skip "brace pattern matches not supported" unless defined? File::FNM_EXTGLOB fl = FileList["*"].exclude("{abc,xyz}.c") assert_equal %w[abc.h abc.x cfiles existing x.c xyzzy.txt], fl end def test_exclude_an_array fl = FileList["*"].exclude(["existing", "*.c"]) assert_equal %w[abc.h abc.x cfiles xyzzy.txt], fl end def test_exclude_a_filelist excluded = FileList["existing", "*.c"] fl = FileList["*"].exclude(excluded) assert_equal %w[abc.h abc.x cfiles xyzzy.txt], fl end def test_default_exclude fl = FileList.new fl.clear_exclude fl.include("**/*~", "**/*.bak", "**/core") assert fl.member?("core"), "Should include core" assert fl.member?("x.bak"), "Should include .bak files" end def test_unique fl = FileList.new fl << "x.c" << "a.c" << "b.rb" << "a.c" assert_equal ["x.c", "a.c", "b.rb", "a.c"], fl fl.uniq! assert_equal ["x.c", "a.c", "b.rb"], fl end def test_to_string fl = FileList.new fl << "a.java" << "b.java" assert_equal "a.java b.java", fl.to_s assert_equal "a.java b.java", "#{fl}" end def test_to_array fl = FileList["a.java", "b.java"] assert_equal ["a.java", "b.java"], fl.to_a assert_equal Array, fl.to_a.class assert_equal ["a.java", "b.java"], fl.to_ary assert_equal Array, fl.to_ary.class end def test_to_s_pending fl = FileList["abc.*"] result = fl.to_s assert_match(%r{abc\.c}, result) assert_match(%r{abc\.h}, result) assert_match(%r{abc\.x}, result) assert_match(%r{(abc\..\b ?){2}}, result) end def test_inspect_pending fl = FileList["abc.*"] result = fl.inspect assert_match(%r{"abc\.c"}, result) assert_match(%r{"abc\.h"}, result) assert_match(%r{"abc\.x"}, result) assert_match(%r|^\[("abc\..", ){2}"abc\.."\]$|, result) end def test_sub fl = FileList["*.c"] f2 = fl.sub(/\.c$/, ".o") assert_equal FileList, f2.class assert_equal ["abc.o", "x.o", "xyz.o"].sort, f2.sort f3 = fl.gsub(/\.c$/, ".o") assert_equal FileList, f3.class assert_equal ["abc.o", "x.o", "xyz.o"].sort, f3.sort end def test_claim_to_be_a_kind_of_array fl = FileList["*.c"] assert fl.is_a?(Array) assert fl.kind_of?(Array) end def test_claim_to_be_a_kind_of_filelist fl = FileList["*.c"] assert fl.is_a?(FileList) assert fl.kind_of?(FileList) end def test_claim_to_be_a_filelist_instance fl = FileList["*.c"] assert fl.instance_of?(FileList) end def test_dont_claim_to_be_an_array_instance fl = FileList["*.c"] assert ! fl.instance_of?(Array) end def test_sub! f = "x/a.c" fl = FileList[f, "x/b.c"] res = fl.sub!(/\.c$/, ".o") assert_equal ["x/a.o", "x/b.o"].sort, fl.sort assert_equal "x/a.c", f assert_equal fl.object_id, res.object_id end def test_sub_with_block fl = FileList["src/org/onestepback/a.java", "src/org/onestepback/b.java"] # The block version doesn't work the way I want it to ... # f2 = fl.sub(%r{^src/(.*)\.java$}) { |x| "classes/" + $1 + ".class" } f2 = fl.sub(%r{^src/(.*)\.java$}, "classes/\\1.class") assert_equal [ "classes/org/onestepback/a.class", "classes/org/onestepback/b.class" ].sort, f2.sort end def test_string_ext assert_equal "one.net", "one.two".ext("net") assert_equal "one.net", "one.two".ext(".net") assert_equal "one.net", "one".ext("net") assert_equal "one.net", "one".ext(".net") assert_equal "one.two.net", "one.two.c".ext(".net") assert_equal "one/two.net", "one/two.c".ext(".net") assert_equal "one.x/two.net", "one.x/two.c".ext(".net") assert_equal "one.x/two.net", "one.x/two".ext(".net") assert_equal ".onerc.net", ".onerc.dot".ext("net") assert_equal ".onerc.net", ".onerc".ext("net") assert_equal ".a/.onerc.net", ".a/.onerc".ext("net") assert_equal "one", "one.two".ext("") assert_equal "one", "one.two".ext assert_equal ".one", ".one.two".ext assert_equal ".one", ".one".ext assert_equal ".", ".".ext("c") assert_equal "..", "..".ext("c") # These only need to work in windows if Rake::Win32.windows? assert_equal "one.x\\two.net", "one.x\\two.c".ext(".net") assert_equal "one.x\\two.net", "one.x\\two".ext(".net") end end def test_filelist_ext assert_equal FileList["one.c", ".one.c"], FileList["one.net", ".one"].ext("c") end def test_gsub fl = FileList["*.c"] f2 = fl.gsub(/a/, "A") assert_equal ["Abc.c", "x.c", "xyz.c"].sort, f2.sort end def test_gsub! f = FileList["*.c"] f.gsub!(/a/, "A") assert_equal ["Abc.c", "x.c", "xyz.c"].sort, f.sort end def test_egrep_returns_0_if_no_matches files = FileList["test/lib/*_test.rb"].exclude("test/lib/filelist_test.rb") assert_equal 0, files.egrep(/XYZZY/) {} end def test_egrep_with_output files = FileList["*.txt"] out, = capture_io do files.egrep(/XYZZY/) end assert_equal "xyzzy.txt:2:XYZZY\n", out end def test_egrep_with_block files = FileList["*.txt"] found = nil files.egrep(/XYZZY/) do |fn, ln, line| found = [fn, ln, line] end assert_equal ["xyzzy.txt", 2, "XYZZY\n"], found end def test_egrep_with_error files = FileList["*.txt"] _, err = capture_io do files.egrep(/XYZZY/) do |fn, ln, line | raise "_EGREP_FAILURE_" end end assert_equal "Error while processing 'xyzzy.txt': _EGREP_FAILURE_\n", err end def test_existing fl = FileList["*c.c", "notthere.c", "a*.c"] assert_equal ["abc.c"], fl.existing assert fl.existing.is_a?(FileList) end def test_existing! fl = FileList["*c.c", "notthere.c", "a*.c"] result = fl.existing! assert_equal ["abc.c"], fl assert_equal fl.object_id, result.object_id end def test_ignore_special f = FileList["*"] assert ! f.include?("CVS"), "Should not contain CVS" assert ! f.include?(".svn"), "Should not contain .svn" assert ! f.include?(".dummy"), "Should not contain dot files" assert ! f.include?("x.bak"), "Should not contain .bak files" assert ! f.include?("x~"), "Should not contain ~ files" assert ! f.include?("core"), "Should not contain core files" end def test_clear_ignore_patterns f = FileList["*", ".svn"] f.clear_exclude assert f.include?("abc.c") assert f.include?("xyz.c") assert f.include?("CVS") assert f.include?(".svn") assert f.include?("x.bak") assert f.include?("x~") end def test_exclude_with_alternate_file_seps fl = FileList.new assert fl.excluded_from_list?("x/CVS/y") assert fl.excluded_from_list?("x\\CVS\\y") assert fl.excluded_from_list?("x/.svn/y") assert fl.excluded_from_list?("x\\.svn\\y") assert fl.excluded_from_list?("x/core") assert fl.excluded_from_list?("x\\core") end def test_add_default_exclude_list fl = FileList.new fl.exclude(/~\d+$/) assert fl.excluded_from_list?("x/CVS/y") assert fl.excluded_from_list?("x\\CVS\\y") assert fl.excluded_from_list?("x/.svn/y") assert fl.excluded_from_list?("x\\.svn\\y") assert fl.excluded_from_list?("x/core") assert fl.excluded_from_list?("x\\core") assert fl.excluded_from_list?("x/abc~1") end def test_basic_array_functions f = FileList["b", "c", "a"] assert_equal "b", f.first assert_equal "b", f[0] assert_equal "a", f.last assert_equal "a", f[2] assert_equal "a", f[-1] assert_equal ["a", "b", "c"], f.sort f.sort! assert_equal ["a", "b", "c"], f end def test_flatten assert_equal ["a", "x.c", "xyz.c", "abc.c"].sort, ["a", FileList["*.c"]].flatten.sort end def test_clone_and_dup a = FileList["a", "b", "c"] c = a.clone d = a.dup a << "d" assert_equal ["a", "b", "c", "d"], a assert_equal ["a", "b", "c"], c assert_equal ["a", "b", "c"], d end def test_dup_and_clone_replicate_taint a = FileList["a", "b", "c"] a.taint c = a.clone d = a.dup assert c.tainted?, "Clone should be tainted" assert d.tainted?, "Dup should be tainted" end def test_duped_items_will_thaw a = FileList["a", "b", "c"] a.freeze d = a.dup d << "more" assert_equal ["a", "b", "c", "more"], d end def test_cloned_items_stay_frozen a = FileList["a", "b", "c"] a.freeze c = a.clone assert_raises(TypeError, RuntimeError) do c << "more" end end def test_array_comparisons fl = FileList["b", "b"] a = ["b", "a"] b = ["b", "b"] c = ["b", "c"] assert_equal(1, fl <=> a) assert_equal(0, fl <=> b) assert_equal(-1, fl <=> c) assert_equal(-1, a <=> fl) assert_equal(0, b <=> fl) assert_equal(1, c <=> fl) end def test_array_equality a = FileList["a", "b"] b = ["a", "b"] assert a == b assert b == a # assert a.eql?(b) # assert b.eql?(a) assert ! a.equal?(b) assert ! b.equal?(a) end def test_enumeration_methods a = FileList["a", "b"] b = a.map(&:upcase) assert_equal ["A", "B"], b assert_equal FileList, b.class b = a.map(&:upcase) assert_equal ["A", "B"], b assert_equal FileList, b.class b = a.sort assert_equal ["a", "b"], b assert_equal FileList, b.class b = a.sort_by { |it| it } assert_equal ["a", "b"], b assert_equal FileList, b.class b = a.select { |it| it == "b" } assert_equal ["b"], b assert_equal FileList, b.class b = a.select { |it| it.size == 1 } assert_equal ["a", "b"], b assert_equal FileList, b.class b = a.reject { |it| it == "b" } assert_equal ["a"], b assert_equal FileList, b.class b = a.grep(/./) assert_equal ["a", "b"], b assert_equal FileList, b.class b = a.partition { |it| it == "b" } assert_equal [["b"], ["a"]], b assert_equal Array, b.class assert_equal FileList, b[0].class assert_equal FileList, b[1].class b = a.zip(["x", "y"]).to_a assert_equal [["a", "x"], ["b", "y"]], b assert_equal Array, b.class assert_equal Array, b[0].class assert_equal Array, b[1].class end def test_array_operators a = ["a", "b"] b = ["c", "d"] f = FileList["x", "y"] g = FileList["w", "z"] r = f + g assert_equal ["x", "y", "w", "z"], r assert_equal FileList, r.class r = a + g assert_equal ["a", "b", "w", "z"], r assert_equal Array, r.class r = f + b assert_equal ["x", "y", "c", "d"], r assert_equal FileList, r.class r = FileList["w", "x", "y", "z"] - f assert_equal ["w", "z"], r assert_equal FileList, r.class r = FileList["w", "x", "y", "z"] & f assert_equal ["x", "y"], r assert_equal FileList, r.class r = f * 2 assert_equal ["x", "y", "x", "y"], r assert_equal FileList, r.class r = f * "," assert_equal "x,y", r assert_equal String, r.class r = f | ["a", "x"] assert_equal ["a", "x", "y"].sort, r.sort assert_equal FileList, r.class end def test_other_array_returning_methods f = FileList["a", nil, "b"] r = f.compact assert_equal ["a", "b"], r assert_equal FileList, r.class f = FileList["a", "b"] r = f.concat(["x", "y"]) assert_equal ["a", "b", "x", "y"], r assert_equal FileList, r.class f = FileList["a", ["b", "c"], FileList["d", "e"]] r = f.flatten assert_equal ["a", "b", "c", "d", "e"], r assert_equal FileList, r.class f = FileList["a", "b", "a"] r = f.uniq assert_equal ["a", "b"], r assert_equal FileList, r.class f = FileList["a", "b", "c", "d"] r = f.values_at(1, 3) assert_equal ["b", "d"], r assert_equal FileList, r.class end def test_special_return_delegating_methods_object_type custom_file_list = Class.new(FileList) f = custom_file_list.new FileList::SPECIAL_RETURN.each do |m| r = if [].method(m).arity == 1 f.send(m, []) else f.send(m) end assert_equal custom_file_list, r.class end end def test_file_utils_can_use_filelists cfiles = FileList["*.c"] cp cfiles, @cdir, verbose: false assert File.exist?(File.join(@cdir, "abc.c")) assert File.exist?(File.join(@cdir, "xyz.c")) assert File.exist?(File.join(@cdir, "x.c")) end end rake-12.3.1/test/test_rake_file_list_path_map.rb000066400000000000000000000006761325463231200217220ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeFileListPathMap < Rake::TestCase def test_file_list_supports_pathmap assert_equal ["a", "b"], FileList["dir/a.rb", "dir/b.rb"].pathmap("%n") end def test_file_list_supports_pathmap_with_a_block mapped = FileList["dir/a.rb", "dir/b.rb"].pathmap("%{.*,*}n") do |name| name.upcase end assert_equal ["A", "B"], mapped end end rake-12.3.1/test/test_rake_file_task.rb000066400000000000000000000106431325463231200200330ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "fileutils" require "pathname" class TestRakeFileTask < Rake::TestCase include Rake def setup super Task.clear @runs = Array.new FileUtils.rm_f NEWFILE FileUtils.rm_f OLDFILE end def test_file_need name = "dummy" file name ftask = Task[name] assert_equal name.to_s, ftask.name File.delete(ftask.name) rescue nil assert ftask.needed?, "file should be needed" assert_equal Rake::LATE, ftask.timestamp open(ftask.name, "w") { |f| f.puts "HI" } assert_nil ftask.prerequisites.map { |n| Task[n].timestamp }.max assert ! ftask.needed?, "file should not be needed" ensure File.delete(ftask.name) rescue nil end def test_file_times_new_depends_on_old create_timed_files(OLDFILE, NEWFILE) t1 = Rake.application.intern(FileTask, NEWFILE).enhance([OLDFILE]) t2 = Rake.application.intern(FileTask, OLDFILE) assert ! t2.needed?, "Should not need to build old file" assert ! t1.needed?, "Should not need to rebuild new file because of old" end def test_file_times_new_depend_on_regular_task_timestamps load_phony name = "dummy" task name create_timed_files(NEWFILE) t1 = Rake.application.intern(FileTask, NEWFILE).enhance([name]) assert t1.needed?, "depending on non-file task uses Time.now" task(name => :phony) assert t1.needed?, "unless the non-file task has a timestamp" end def test_file_times_old_depends_on_new create_timed_files(OLDFILE, NEWFILE) t1 = Rake.application.intern(FileTask, OLDFILE).enhance([NEWFILE]) t2 = Rake.application.intern(FileTask, NEWFILE) assert ! t2.needed?, "Should not need to build new file" preq_stamp = t1.prerequisites.map { |t| Task[t].timestamp }.max assert_equal t2.timestamp, preq_stamp assert t1.timestamp < preq_stamp, "T1 should be older" assert t1.needed?, "Should need to rebuild old file because of new" end def test_file_depends_on_task_depend_on_file create_timed_files(OLDFILE, NEWFILE) file NEWFILE => [:obj] do |t| @runs << t.name end task obj: [OLDFILE] do |t| @runs << t.name end file OLDFILE do |t| @runs << t.name end Task[:obj].invoke Task[NEWFILE].invoke assert @runs.include?(NEWFILE) end def test_existing_file_depends_on_non_existing_file create_file(OLDFILE) delete_file(NEWFILE) file NEWFILE do |t| @runs << t.name end file OLDFILE => NEWFILE do |t| @runs << t.name end Task[OLDFILE].invoke assert_equal [NEWFILE, OLDFILE], @runs end def test_needed_eh_build_all create_file "a" file "a" a_task = Task["a"] refute a_task.needed? Rake.application.options.build_all = true assert a_task.needed? ensure delete_file "a" end def test_needed_eh_dependency create_file "a", Time.now create_file "b", Time.now - 60 create_file "c", Time.now create_file "d", Time.now - 60 file "b" => "a" b_task = Task["b"] assert b_task.needed? file "c" => "d" c_task = Task["c"] refute c_task.needed? ensure delete_file "old" delete_file "new" end def test_needed_eh_exists name = "dummy" file name ftask = Task[name] assert ftask.needed? create_file name refute ftask.needed? ensure delete_file name end def test_source_is_first_prerequisite t = file f: ["preqA", "preqB"] assert_equal "preqA", t.source end def test_sources_is_all_prerequisites t = file f: ["preqA", "preqB"] assert_equal ["preqA", "preqB"], t.sources end def test_task_can_be_pathname name = "dummy" file Pathname.new name ftask = Task[name] assert_equal name.to_s, ftask.name end def test_prerequisite_can_be_pathname t = file f: Pathname.new("preq") assert_equal "preq", t.source end # I have currently disabled this test. I'm not convinced that # deleting the file target on failure is always the proper thing to # do. I'm willing to hear input on this topic. def ztest_file_deletes_on_failure task :obj file NEWFILE => [:obj] do |t| FileUtils.touch NEWFILE fail "Ooops" end assert Task[NEWFILE] begin Task[NEWFILE].invoke rescue Exception end assert(! File.exist?(NEWFILE), "NEWFILE should be deleted") end def load_phony load File.join(@rake_lib, "rake/phony.rb") end end rake-12.3.1/test/test_rake_file_utils.rb000066400000000000000000000175401325463231200202340ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "fileutils" require "stringio" class TestRakeFileUtils < Rake::TestCase def setup super @rake_test_sh = ENV["RAKE_TEST_SH"] end def teardown FileUtils::LN_SUPPORTED[0] = true RakeFileUtils.verbose_flag = Rake::FileUtilsExt::DEFAULT ENV["RAKE_TEST_SH"] = @rake_test_sh super end def test_rm_one_file create_file("a") FileUtils.rm_rf "a" refute File.exist?("a") end def test_rm_two_files create_file("a") create_file("b") FileUtils.rm_rf ["a", "b"] refute File.exist?("a") refute File.exist?("b") end def test_rm_filelist list = Rake::FileList.new << "a" << "b" list.each { |fn| create_file(fn) } FileUtils.rm_r list refute File.exist?("a") refute File.exist?("b") end def test_ln open("a", "w") { |f| f.puts "TEST_LN" } Rake::FileUtilsExt.safe_ln("a", "b", verbose: false) assert_equal "TEST_LN\n", File.read("b") end class BadLink include Rake::FileUtilsExt attr_reader :cp_args def initialize(klass) @failure_class = klass end def cp(*args) @cp_args = args end def ln(*args) fail @failure_class, "ln not supported" end public :safe_ln end def test_safe_ln_failover_to_cp_on_standard_error FileUtils::LN_SUPPORTED[0] = true c = BadLink.new(StandardError) c.safe_ln "a", "b" assert_equal ["a", "b"], c.cp_args c.safe_ln "x", "y" assert_equal ["x", "y"], c.cp_args end def test_safe_ln_failover_to_cp_on_not_implemented_error FileUtils::LN_SUPPORTED[0] = true c = BadLink.new(NotImplementedError) c.safe_ln "a", "b" assert_equal ["a", "b"], c.cp_args end def test_safe_ln_fails_on_script_error FileUtils::LN_SUPPORTED[0] = true c = BadLink.new(ScriptError) assert_raises(ScriptError) do c.safe_ln "a", "b" end end def test_verbose verbose true assert_equal true, verbose verbose false assert_equal false, verbose verbose(true) { assert_equal true, verbose } assert_equal false, verbose end def test_nowrite nowrite true assert_equal true, nowrite nowrite false assert_equal false, nowrite nowrite(true) { assert_equal true, nowrite } assert_equal false, nowrite end def test_file_utils_methods_are_available_at_top_level create_file("a") capture_io do rm_rf "a" end refute File.exist?("a") end def test_fileutils_methods_dont_leak obj = Object.new assert_raises(NoMethodError) { obj.copy } # from FileUtils assert_raises(NoMethodError) { obj.ruby "-v" } # from RubyFileUtils end def test_sh shellcommand verbose(false) { sh %{#{Rake::TestCase::RUBY} shellcommand.rb} } assert true, "should not fail" end def test_sh_with_a_single_string_argument check_expansion ENV["RAKE_TEST_SH"] = "someval" verbose(false) { sh %{#{RUBY} check_expansion.rb #{env_var} someval} } end def test_sh_with_env check_environment env = { "RAKE_TEST_SH" => "someval" } verbose(false) { sh env, RUBY, "check_environment.rb", "RAKE_TEST_SH", "someval" } end def test_sh_with_multiple_arguments skip if jruby9? # https://github.com/jruby/jruby/issues/3653 check_no_expansion ENV["RAKE_TEST_SH"] = "someval" verbose(false) { sh RUBY, "check_no_expansion.rb", env_var, "someval" } end def test_sh_with_spawn_options skip "JRuby does not support spawn options" if jruby? echocommand r, w = IO.pipe verbose(false) { sh RUBY, "echocommand.rb", out: w } w.close assert_equal "echocommand.rb\n", r.read end def test_sh_with_hash_option skip "JRuby does not support spawn options" if jruby? check_expansion verbose(false) { sh "#{RUBY} check_expansion.rb", { chdir: "." }, verbose: false } end def test_sh_failure shellcommand assert_raises(RuntimeError) { verbose(false) { sh %{#{RUBY} shellcommand.rb 1} } } end def test_sh_special_handling shellcommand count = 0 verbose(false) { sh(%{#{RUBY} shellcommand.rb}) do |ok, res| assert(ok) assert_equal 0, res.exitstatus count += 1 end sh(%{#{RUBY} shellcommand.rb 1}) do |ok, res| assert(!ok) assert_equal 1, res.exitstatus count += 1 end } assert_equal 2, count, "Block count should be 2" end def test_sh_noop shellcommand verbose(false) { sh %{shellcommand.rb 1}, noop: true } assert true, "should not fail" end def test_sh_bad_option # Skip on JRuby because option checking is performed by spawn via system # now. skip "JRuby does not support spawn options" if jruby? shellcommand ex = assert_raises(ArgumentError) { verbose(false) { sh %{shellcommand.rb}, bad_option: true } } assert_match(/bad_option/, ex.message) end def test_sh_verbose shellcommand _, err = capture_io do verbose(true) { sh %{shellcommand.rb}, noop: true } end assert_equal "shellcommand.rb\n", err end def test_sh_verbose_false shellcommand _, err = capture_io do verbose(false) { sh %{shellcommand.rb}, noop: true } end assert_equal "", err end def test_sh_verbose_flag_nil shellcommand RakeFileUtils.verbose_flag = nil assert_silent do sh %{shellcommand.rb}, noop: true end end def test_ruby_with_a_single_string_argument check_expansion ENV["RAKE_TEST_SH"] = "someval" verbose(false) { replace_ruby { ruby %{check_expansion.rb #{env_var} someval} } } end def test_sh_show_command env = { "RAKE_TEST_SH" => "someval" } cmd = [env, RUBY, "some_file.rb", "some argument"] show_cmd = send :sh_show_command, cmd expected_cmd = "RAKE_TEST_SH=someval #{RUBY} some_file.rb some argument" assert_equal expected_cmd, show_cmd end def test_ruby_with_multiple_arguments skip if jruby9? # https://github.com/jruby/jruby/issues/3653 check_no_expansion ENV["RAKE_TEST_SH"] = "someval" verbose(false) { replace_ruby { ruby "check_no_expansion.rb", env_var, "someval" } } end def test_split_all assert_equal ["a"], Rake::FileUtilsExt.split_all("a") assert_equal [".."], Rake::FileUtilsExt.split_all("..") assert_equal ["/"], Rake::FileUtilsExt.split_all("/") assert_equal ["a", "b"], Rake::FileUtilsExt.split_all("a/b") assert_equal ["/", "a", "b"], Rake::FileUtilsExt.split_all("/a/b") assert_equal ["..", "a", "b"], Rake::FileUtilsExt.split_all("../a/b") end def command(name, text) open name, "w", 0750 do |io| io << text end end def check_no_expansion command "check_no_expansion.rb", <<-CHECK_EXPANSION if ARGV[0] != ARGV[1] exit 0 else exit 1 end CHECK_EXPANSION end def check_environment command "check_environment.rb", <<-CHECK_ENVIRONMENT if ENV[ARGV[0]] != ARGV[1] exit 1 else exit 0 end CHECK_ENVIRONMENT end def check_expansion command "check_expansion.rb", <<-CHECK_EXPANSION if ARGV[0] != ARGV[1] exit 1 else exit 0 end CHECK_EXPANSION end def echocommand command "echocommand.rb", <<-ECHOCOMMAND #!/usr/bin/env ruby puts "echocommand.rb" exit 0 ECHOCOMMAND end def replace_ruby ruby = FileUtils::RUBY FileUtils.send :remove_const, :RUBY FileUtils.const_set :RUBY, RUBY yield ensure FileUtils.send :remove_const, :RUBY FileUtils.const_set:RUBY, ruby end def shellcommand command "shellcommand.rb", <<-SHELLCOMMAND #!/usr/bin/env ruby exit((ARGV[0] || "0").to_i) SHELLCOMMAND end def env_var windows? ? "%RAKE_TEST_SH%" : "$RAKE_TEST_SH" end def windows? ! File::ALT_SEPARATOR.nil? end end rake-12.3.1/test/test_rake_functional.rb000066400000000000000000000242561325463231200202410ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "fileutils" require "open3" class TestRakeFunctional < Rake::TestCase include RubyRunner def setup super if @verbose puts puts puts "-" * 80 puts @__name__ puts "-" * 80 end end def test_rake_default rakefile_default rake assert_match(/^DEFAULT$/, @out) end def test_rake_error_on_bad_task rakefile_default rake "-t", "xyz" assert_match(/rake aborted/, @err) end def test_env_available_at_top_scope rakefile_default rake "TESTTOPSCOPE=1" assert_match(/^TOPSCOPE$/, @out) end def test_env_available_at_task_scope rakefile_default rake "TESTTASKSCOPE=1", "task_scope" assert_match(/^TASKSCOPE$/, @out) end def test_task_override rakefile_override rake "t1" assert_match(/foo\nbar\n/, @out) end def test_multi_desc ENV["RAKE_COLUMNS"] = "80" rakefile_multidesc rake "-T" assert_match %r{^rake a *# A / A2 *$}, @out assert_match %r{^rake b *# B *$}, @out refute_match %r{^rake c}, @out assert_match %r{^rake d *# x{65}\.\.\.$}, @out end def test_long_description rakefile_multidesc rake "--describe" assert_match %r{^rake a\n *A\n *A2 *$}m, @out assert_match %r{^rake b\n *B *$}m, @out assert_match %r{^rake d\n *x{80}}m, @out refute_match %r{^rake c\n}m, @out end def test_proper_namespace_access rakefile_access rake refute_match %r{^BAD:}, @out end def test_rbext rakefile_rbext rake "-N" assert_match %r{^OK$}, @out end def test_system rake_system_dir rake "-g", "sys1" assert_match %r{^SYS1}, @out end def test_system_excludes_rakelib_files_too rake_system_dir rake "-g", "sys1", "-T", "extra" refute_match %r{extra:extra}, @out end def test_by_default_rakelib_files_are_included rake_system_dir rakefile_extra rake "-T", "extra", "--trace" assert_match %r{extra:extra}, @out end def test_implicit_system skip if jruby9? rake_system_dir Dir.chdir @tempdir rake "sys1", "--trace" assert_match %r{^SYS1}, @out end def test_no_system rake_system_dir rakefile_extra rake "-G", "sys1" assert_match %r{^Don't know how to build task}, @err # emacs wart: ' end def test_nosearch_with_rakefile_uses_local_rakefile rakefile_default rake "--nosearch" assert_match %r{^DEFAULT}, @out end def test_nosearch_without_rakefile_finds_system rakefile_nosearch rake_system_dir rake "--nosearch", "sys1" assert_match %r{^SYS1}, @out end def test_nosearch_without_rakefile_and_no_system_fails rakefile_nosearch ENV["RAKE_SYSTEM"] = "not_exist" rake "--nosearch" assert_match %r{^No Rakefile found}, @err end def test_invalid_command_line_options rakefile_default rake "--bad-options" assert_match %r{invalid +option}i, @err end def test_inline_verbose_default_should_show_command rakefile_verbose rake "inline_verbose_default" assert_match(/#{Regexp.quote(RUBY)} -e/, @err) end def test_inline_verbose_true_should_show_command rakefile_verbose rake "inline_verbose_true" assert_match(/#{Regexp.quote(RUBY)} -e/, @err) end def test_inline_verbose_false_should_not_show_command rakefile_verbose rake "inline_verbose_false" refute_match(/#{Regexp.quote(RUBY)} -e/, @err) end def test_block_verbose_false_should_not_show_command rakefile_verbose rake "block_verbose_false" refute_match(/#{Regexp.quote(RUBY)} -e/, @err) end def test_block_verbose_true_should_show_command rakefile_verbose rake "block_verbose_true" assert_match(/#{Regexp.quote(RUBY)} -e/, @err) end def test_standalone_verbose_true_should_show_command rakefile_verbose rake "standalone_verbose_true" assert_match(/#{Regexp.quote(RUBY)} -e/, @err) end def test_standalone_verbose_false_should_not_show_command rakefile_verbose rake "standalone_verbose_false" refute_match(/#{Regexp.quote(RUBY)} -e/, @err) end def test_dry_run rakefile_default rake "-n", "other" assert_match %r{Execute \(dry run\) default}, @err assert_match %r{Execute \(dry run\) other}, @err refute_match %r{DEFAULT}, @out refute_match %r{OTHER}, @out end # Test for the trace/dry_run bug found by Brian Chandler def test_dry_run_bug rakefile_dryrun rake FileUtils.rm_f "temp_one" rake "--dry-run" refute_match(/No such file/, @out) end # Test for the trace/dry_run bug found by Brian Chandler def test_trace_bug rakefile_dryrun rake FileUtils.rm_f "temp_one" rake "--trace" refute_match(/No such file/, @out) end def test_imports rakefile_imports rake assert File.exist?(File.join(@tempdir, "dynamic_deps")), "'dynamic_deps' file should exist" assert_match(/^FIRST$\s+^DYNAMIC$\s+^STATIC$\s+^OTHER$/, @out) end def test_regenerate_imports rakefile_regenerate_imports rake assert_match(/^INITIAL\s+^REGENERATED$/, @out) end def test_rules_chaining_to_file_task rakefile_chains rake assert File.exist?(File.join(@tempdir, "play.app")), "'play.app' file should exist" end def dryrun_tasks @err.split("\n").select { |line| line.match(/^\*\* Execute/) }.map { |line| line.gsub(/^\*\* Execute \(dry run\) /, "") } end def test_update_midway_through_chaining_to_file_task rakefile_file_chains rake "-n" assert_equal(%w{fileA fileB fileC default}, dryrun_tasks) rake sleep 1 # Ensure the timestamp is on a new second FileUtils.touch("fileA") rake "-n" assert_equal(%w{fileB fileC default}, dryrun_tasks) end def test_file_creation_task rakefile_file_creation rake "prep" rake "run" rake "run" assert(@err !~ /^cp src/, "Should not recopy data") end def test_dash_f_with_no_arg_foils_rakefile_lookup rakefile_rakelib rake "-I", "rakelib", "-rtest1", "-f" assert_match(/^TEST1$/, @out) end def test_dot_rake_files_can_be_loaded_with_dash_r rakefile_rakelib rake "-I", "rakelib", "-rtest2", "-f" assert_empty @err assert_match(/^TEST2$/, @out) end def test_can_invoke_task_in_toplevel_namespace rakefile_namespace rake "copy" assert_match(/^COPY$/, @out) end def test_can_invoke_task_in_nested_namespace rakefile_namespace rake "nest:copy" assert_match(/^NEST COPY$/, @out) end def test_tasks_can_reference_task_in_same_namespace rakefile_namespace rake "nest:xx" assert_match(/^NEST COPY$/m, @out) end def test_tasks_can_reference_task_in_other_namespaces rakefile_namespace rake "b:run" assert_match(/^IN A\nIN B$/m, @out) end def test_anonymous_tasks_can_be_invoked_indirectly rakefile_namespace rake "anon" assert_match(/^ANON COPY$/m, @out) end def test_rake_namespace_refers_to_toplevel rakefile_namespace rake "very:nested:run" assert_match(/^COPY$/m, @out) end def test_file_task_are_not_scoped_by_namespaces rakefile_namespace rake "xyz.rb" assert_match(/^XYZ1\nXYZ2$/m, @out) end def test_file_task_dependencies_scoped_by_namespaces rakefile_namespace rake "scopedep.rb" assert_match(/^PREPARE\nSCOPEDEP$/m, @out) end def test_test_task_descriptions rakefile_test_task rake "-T" assert_match(/custom test task description/, @out) end def test_test_task_when_verbose_unless_verbose_passed_not_prompt_testopts rakefile_test_task_verbose rake "unit" exp = /TESTOPTS="--verbose" to pass --verbose/ refute_match exp, @out end def test_test_task_when_verbose_passed_prompts_testopts rakefile_test_task rake "--verbose", "unit" exp = /TESTOPTS="--verbose" to pass --verbose/ assert_match exp, @out end def test_comment_before_task_acts_like_desc rakefile_comments rake "-T" refute_match(/comment for t1/, @out) end def test_comment_separated_from_task_by_blank_line_is_not_picked_up rakefile_comments rake "-T" refute_match("t2", @out) end def test_comment_after_desc_is_ignored rakefile_comments rake "-T" assert_match("override comment for t3", @out) end def test_comment_before_desc_is_ignored rakefile_comments rake "-T" assert_match("override comment for t4", @out) end def test_correct_number_of_tasks_reported rakefile_comments rake "-T" assert_equal(2, @out.split(/\n/).grep(/t\d/).size) end def test_file_list_is_requirable_separately skip if jruby9? # https://github.com/jruby/jruby/issues/3655 ruby "-rrake/file_list", "-e", 'puts Rake::FileList["a"].size' assert_equal "1\n", @out end def can_detect_signals? system RUBY, "-e", 'Process.kill "TERM", $$' status = $? if @verbose puts " SIG status = #{$?.inspect}" puts " SIG status.respond_to?(:signaled?) = " + "#{$?.respond_to?(:signaled?).inspect}" puts " SIG status.signaled? = #{status.signaled?}" if status.respond_to?(:signaled?) end status.respond_to?(:signaled?) && status.signaled? end def test_signal_propagation_in_tests if !jruby? && can_detect_signals? rakefile_test_signal rake assert_match(/ATEST/, @out) refute_match(/BTEST/, @out) else skip "Signal detect seems broken on this system" end end def test_failing_test_sets_exit_status skip if uncertain_exit_status? rakefile_failing_test_task rake assert @exit.exitstatus > 0, "should be non-zero" end def test_stand_alone_filelist rakefile_stand_alone_filelist run_ruby @ruby_options + ["stand_alone_filelist.rb"] assert_match(/^stand_alone_filelist\.rb$/, @out) assert_equal 0, @exit.exitstatus unless uncertain_exit_status? end private # We are unable to accurately verify that Rake returns a proper # error exit status using popen3 in Ruby 1.8.7 and JRuby. This # predicate function can be used to skip tests or assertions as # needed. def uncertain_exit_status? defined?(JRUBY_VERSION) end end rake-12.3.1/test/test_rake_invocation_chain.rb000066400000000000000000000030151325463231200214000ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeInvocationChain < Rake::TestCase include Rake def setup super @empty = InvocationChain.empty @first_member = "A" @second_member = "B" @one = @empty.append(@first_member) @two = @one.append(@second_member) end def test_conj_on_invocation_chains list = InvocationChain.empty.conj("B").conj("A") assert_equal InvocationChain.make("A", "B"), list assert_equal InvocationChain, list.class end def test_make_on_invocation_chains assert_equal @empty, InvocationChain.make() assert_equal @one, InvocationChain.make(@first_member) assert_equal @two, InvocationChain.make(@second_member, @first_member) end def test_append_with_one_argument chain = @empty.append("A") assert_equal "TOP => A", chain.to_s # HACK end def test_append_one_circular ex = assert_raises RuntimeError do @one.append(@first_member) end assert_match(/circular +dependency/i, ex.message) assert_match(/A.*=>.*A/, ex.message) end def test_append_two_circular ex = assert_raises RuntimeError do @two.append(@first_member) end assert_match(/A.*=>.*B.*=>.*A/, ex.message) end def test_member_eh_one assert @one.member?(@first_member) end def test_member_eh_two assert @two.member?(@first_member) assert @two.member?(@second_member) end def test_to_s_empty assert_equal "TOP", @empty.to_s assert_equal "TOP => A", @one.to_s end end rake-12.3.1/test/test_rake_late_time.rb000066400000000000000000000007011325463231200200270ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeLateTime < Rake::TestCase def test_late_time_comparisons late = Rake::LATE assert_equal late, late assert late >= Time.now assert late > Time.now assert late != Time.now assert Time.now < late assert Time.now <= late assert Time.now != late end def test_to_s assert_equal "", Rake::LATE.to_s end end rake-12.3.1/test/test_rake_linked_list.rb000066400000000000000000000043471325463231200203770ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestLinkedList < Rake::TestCase include Rake def test_empty_list empty = LinkedList::EMPTY assert empty.empty?, "should be empty" end def test_list_with_one_item list = LinkedList.make(:one) assert ! list.empty?, "should not be empty" assert_equal :one, list.head assert_equal LinkedList::EMPTY, list.tail end def test_make_with_no_arguments empty = LinkedList.make() assert_equal LinkedList::EMPTY, empty end def test_make_with_one_argument list = LinkedList.make(:one) assert ! list.empty? assert_equal :one, list.head assert_equal LinkedList::EMPTY, list.tail end def test_make_with_two_arguments list = LinkedList.make(:one, :two) assert ! list.empty? assert_equal :one, list.head assert_equal :two, list.tail.head assert_equal LinkedList::EMPTY, list.tail.tail end def test_list_with_several_items list = LinkedList.make(:one, :two, :three) assert ! list.empty?, "should not be empty" assert_equal :one, list.head assert_equal :two, list.tail.head assert_equal :three, list.tail.tail.head assert_equal LinkedList::EMPTY, list.tail.tail.tail end def test_lists_are_structurally_equivalent list = LinkedList.make(1, 2, 3) same = LinkedList.make(1, 2, 3) diff = LinkedList.make(1, 2, 4) short = LinkedList.make(1, 2) assert_equal list, same refute_equal list, diff refute_equal list, short refute_equal short, list end def test_conversion_to_string list = LinkedList.make(:one, :two, :three) assert_equal "LL(one, two, three)", list.to_s assert_equal "LL()", LinkedList.make().to_s end def test_conversion_with_inspect list = LinkedList.make(:one, :two, :three) assert_equal "LL(:one, :two, :three)", list.inspect assert_equal "LL()", LinkedList.make().inspect end def test_lists_are_enumerable list = LinkedList.make(1, 2, 3) new_list = list.map { |item| item + 10 } expected = [11, 12, 13] assert_equal expected, new_list end def test_conjunction list = LinkedList.make.conj("C").conj("B").conj("A") assert_equal LinkedList.make("A", "B", "C"), list end end rake-12.3.1/test/test_rake_makefile_loader.rb000066400000000000000000000022141325463231200211700ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "rake/loaders/makefile" class TestRakeMakefileLoader < Rake::TestCase include Rake def test_parse Dir.chdir @tempdir open "sample.mf", "w" do |io| io << <<-'SAMPLE_MF' # Comments a: a1 a2 a3 a4 b: b1 b2 b3 \ b4 b5 b6\ # Mid: Comment b7 a : a5 a6 a7 c: c1 d: d1 d2 \ e f : e1 f1 g\ 0: g1 g\ 2 g\ 3 g4 SAMPLE_MF end Task.clear loader = Rake::MakefileLoader.new loader.load "sample.mf" %w(a b c d).each do |t| assert Task.task_defined?(t), "#{t} should be a defined task" end assert_equal %w(a1 a2 a3 a4 a5 a6 a7).sort, Task["a"].prerequisites.sort assert_equal %w(b1 b2 b3 b4 b5 b6 b7).sort, Task["b"].prerequisites.sort assert_equal %w(c1).sort, Task["c"].prerequisites.sort assert_equal %w(d1 d2).sort, Task["d"].prerequisites.sort assert_equal %w(e1 f1).sort, Task["e"].prerequisites.sort assert_equal %w(e1 f1).sort, Task["f"].prerequisites.sort assert_equal( ["g1", "g 2", "g 3", "g4"].sort, Task["g 0"].prerequisites.sort) assert_equal 7, Task.tasks.size end end rake-12.3.1/test/test_rake_multi_task.rb000066400000000000000000000051101325463231200202370ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "thread" class TestRakeMultiTask < Rake::TestCase include Rake def setup super Task.clear @runs = Array.new @mutex = Mutex.new end def teardown Rake.application.thread_pool.join super end def add_run(obj) @mutex.synchronize do @runs << obj end end def test_running_multitasks task :a do 3.times do |i| add_run("A#{i}"); sleep 0.01; end end task :b do 3.times do |i| add_run("B#{i}"); sleep 0.01; end end multitask both: [:a, :b] Task[:both].invoke assert_equal 6, @runs.size assert @runs.index("A0") < @runs.index("A1") assert @runs.index("A1") < @runs.index("A2") assert @runs.index("B0") < @runs.index("B1") assert @runs.index("B1") < @runs.index("B2") end def test_all_multitasks_wait_on_slow_prerequisites task :slow do 3.times do |i| add_run("S#{i}"); sleep 0.05 end end task a: [:slow] do 3.times do |i| add_run("A#{i}"); sleep 0.01 end end task b: [:slow] do 3.times do |i| add_run("B#{i}"); sleep 0.01 end end multitask both: [:a, :b] Task[:both].invoke assert_equal 9, @runs.size assert @runs.index("S0") < @runs.index("S1") assert @runs.index("S1") < @runs.index("S2") assert @runs.index("S2") < @runs.index("A0") assert @runs.index("S2") < @runs.index("B0") assert @runs.index("A0") < @runs.index("A1") assert @runs.index("A1") < @runs.index("A2") assert @runs.index("B0") < @runs.index("B1") assert @runs.index("B1") < @runs.index("B2") end def test_multitasks_with_parameters task :a, [:arg] do |t, args| add_run(args[:arg]) end multitask :b, [:arg] => [:a] do |t, args| add_run(args[:arg] + "mt") end Task[:b].invoke "b" assert @runs[0] == "b" assert @runs[1] == "bmt" end def test_cross_thread_prerequisite_failures failed = false multitask :fail_once do fail_now = !failed failed = true raise "failing once" if fail_now end task a: :fail_once task b: :fail_once assert_raises RuntimeError do Rake::Task[:a].invoke end assert_raises RuntimeError do Rake::Task[:b].invoke end end def test_task_not_executed_if_dependant_task_failed_concurrently multitask default: [:one, :two] task :one do raise end task_two_was_executed = false task two: :one do task_two_was_executed = true end begin Rake::Task[:default].invoke rescue RuntimeError ensure sleep 0.5 refute task_two_was_executed end end end rake-12.3.1/test/test_rake_name_space.rb000066400000000000000000000022271325463231200201640ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeNameSpace < Rake::TestCase class TM include Rake::TaskManager end def test_namespace_creation mgr = TM.new ns = Rake::NameSpace.new(mgr, []) refute_nil ns end def test_namespace_lookup mgr = TM.new ns = mgr.in_namespace("n") do mgr.define_task(Rake::Task, "t") end refute_nil ns["t"] assert_equal mgr["n:t"], ns["t"] end def test_namespace_reports_tasks_it_owns mgr = TM.new nns = nil ns = mgr.in_namespace("n") do mgr.define_task(Rake::Task, :x) mgr.define_task(Rake::Task, :y) nns = mgr.in_namespace("nn") do mgr.define_task(Rake::Task, :z) end end mgr.in_namespace("m") do mgr.define_task(Rake::Task, :x) end assert_equal ["n:nn:z", "n:x", "n:y"], ns.tasks.map(&:name) assert_equal ["n:nn:z"], nns.tasks.map(&:name) end def test_scope mgr = TM.new scope = Rake::LinkedList.new "b" scope = scope.conj "a" ns = Rake::NameSpace.new mgr, scope assert_equal scope, ns.scope refute_same scope, ns.scope end end rake-12.3.1/test/test_rake_package_task.rb000066400000000000000000000037601325463231200205110ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "rake/packagetask" class TestRakePackageTask < Rake::TestCase def test_initialize touch "install.rb" touch "a.c" touch "b.c" mkdir "CVS" touch "a.rb~" pkg = Rake::PackageTask.new("pkgr", "1.2.3") { |p| p.package_files << "install.rb" p.package_files.include "*.c" p.package_files.exclude(/\bCVS\b/) p.package_files.exclude(/~$/) p.package_dir = "pkg" p.need_tar = true p.need_tar_gz = true p.need_tar_bz2 = true p.need_tar_xz = true p.need_zip = true } assert_equal "pkg", pkg.package_dir assert_includes pkg.package_files, "a.c" assert_equal "pkgr", pkg.name assert_equal "1.2.3", pkg.version assert Rake::Task[:package] assert Rake::Task["pkg/pkgr-1.2.3.tgz"] assert Rake::Task["pkg/pkgr-1.2.3.tar.gz"] assert Rake::Task["pkg/pkgr-1.2.3.tar.bz2"] assert Rake::Task["pkg/pkgr-1.2.3.tar.xz"] assert Rake::Task["pkg/pkgr-1.2.3.zip"] assert Rake::Task["pkg/pkgr-1.2.3"] assert Rake::Task[:clobber_package] assert Rake::Task[:repackage] end def test_initialize_no_version e = assert_raises RuntimeError do Rake::PackageTask.new "pkgr" end assert_equal "Version required (or :noversion)", e.message end def test_initialize_noversion pkg = Rake::PackageTask.new "pkgr", :noversion assert_equal "pkg", pkg.package_dir assert_equal "pkgr", pkg.name assert_nil pkg.version end def test_clone pkg = Rake::PackageTask.new("x", :noversion) p2 = pkg.clone pkg.package_files << "y" p2.package_files << "x" assert_equal ["y"], pkg.package_files assert_equal ["x"], p2.package_files end def test_package_name pkg = Rake::PackageTask.new "a", "1" assert_equal "a-1", pkg.package_name end def test_package_name_noversion pkg = Rake::PackageTask.new "a", :noversion assert_equal "a", pkg.package_name end end rake-12.3.1/test/test_rake_path_map.rb000066400000000000000000000132311325463231200176570ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakePathMap < Rake::TestCase def test_returns_self_with_no_args assert_equal "abc.rb", "abc.rb".pathmap end def test_s_returns_file_separator sep = File::ALT_SEPARATOR || File::SEPARATOR assert_equal sep, "abc.rb".pathmap("%s") assert_equal sep, "".pathmap("%s") assert_equal "a#{sep}b", "a/b".pathmap("%d%s%f") end def test_f_returns_basename assert_equal "abc.rb", "abc.rb".pathmap("%f") assert_equal "abc.rb", "this/is/a/dir/abc.rb".pathmap("%f") assert_equal "abc.rb", "/this/is/a/dir/abc.rb".pathmap("%f") end def test_n_returns_basename_without_extension assert_equal "abc", "abc.rb".pathmap("%n") assert_equal "abc", "abc".pathmap("%n") assert_equal "abc", "this/is/a/dir/abc.rb".pathmap("%n") assert_equal "abc", "/this/is/a/dir/abc.rb".pathmap("%n") assert_equal "abc", "/this/is/a/dir/abc".pathmap("%n") end def test_d_returns_dirname assert_equal ".", "abc.rb".pathmap("%d") assert_equal "/", "/abc".pathmap("%d") assert_equal "this/is/a/dir", "this/is/a/dir/abc.rb".pathmap("%d") assert_equal "/this/is/a/dir", "/this/is/a/dir/abc.rb".pathmap("%d") end def test_9d_returns_partial_dirname assert_equal "this/is", "this/is/a/dir/abc.rb".pathmap("%2d") assert_equal "this", "this/is/a/dir/abc.rb".pathmap("%1d") assert_equal ".", "this/is/a/dir/abc.rb".pathmap("%0d") assert_equal "dir", "this/is/a/dir/abc.rb".pathmap("%-1d") assert_equal "a/dir", "this/is/a/dir/abc.rb".pathmap("%-2d") assert_equal "this/is/a/dir", "this/is/a/dir/abc.rb".pathmap("%100d") assert_equal "this/is/a/dir", "this/is/a/dir/abc.rb".pathmap("%-100d") end def test_x_returns_extension assert_equal "", "abc".pathmap("%x") assert_equal ".rb", "abc.rb".pathmap("%x") assert_equal ".rb", "abc.xyz.rb".pathmap("%x") assert_equal "", ".depends".pathmap("%x") assert_equal "", "dir/.depends".pathmap("%x") end def test_x_returns_everything_but_extension assert_equal "abc", "abc".pathmap("%X") assert_equal "abc", "abc.rb".pathmap("%X") assert_equal "abc.xyz", "abc.xyz.rb".pathmap("%X") assert_equal "ab.xyz", "ab.xyz.rb".pathmap("%X") assert_equal "a.xyz", "a.xyz.rb".pathmap("%X") assert_equal "abc", "abc.rb".pathmap("%X") assert_equal "ab", "ab.rb".pathmap("%X") assert_equal "a", "a.rb".pathmap("%X") assert_equal ".depends", ".depends".pathmap("%X") assert_equal "a/dir/.depends", "a/dir/.depends".pathmap("%X") assert_equal "/.depends", "/.depends".pathmap("%X") end def test_p_returns_entire_pathname assert_equal "abc.rb", "abc.rb".pathmap("%p") assert_equal "this/is/a/dir/abc.rb", "this/is/a/dir/abc.rb".pathmap("%p") assert_equal "/this/is/a/dir/abc.rb", "/this/is/a/dir/abc.rb".pathmap("%p") end def test_dash_returns_empty_string assert_equal "", "abc.rb".pathmap("%-") assert_equal "abc.rb", "abc.rb".pathmap("%X%-%x") end def test_percent_percent_returns_percent assert_equal "a%b", "".pathmap("a%%b") end def test_undefined_percent_causes_error assert_raises(ArgumentError) { "dir/abc.rb".pathmap("%z") } end def test_pattern_returns_substitutions assert_equal "bin/org/osb", "src/org/osb/Xyz.java".pathmap("%{src,bin}d") end def test_pattern_can_use_backreferences assert_equal "dir/hi/is", "dir/this/is".pathmap("%{t(hi)s,\\1}p") end def test_pattern_with_star_replacement_string_uses_block assert_equal "src/ORG/osb", "src/org/osb/Xyz.java".pathmap("%{/org,*}d") { |d| d.upcase } assert_equal "Xyz.java", "src/org/osb/Xyz.java".pathmap("%{.*,*}f") { |f| f.capitalize } end def test_pattern_with_no_replacement_nor_block_substitutes_empty_string assert_equal "bc.rb", "abc.rb".pathmap("%{a}f") end def test_pattern_works_with_certain_valid_operators assert_equal "dir/xbc.rb", "dir/abc.rb".pathmap("%{a,x}p") assert_equal "d1r", "dir/abc.rb".pathmap("%{i,1}d") assert_equal "xbc.rb", "dir/abc.rb".pathmap("%{a,x}f") assert_equal ".Rb", "dir/abc.rb".pathmap("%{r,R}x") assert_equal "xbc", "dir/abc.rb".pathmap("%{a,x}n") end def test_multiple_patterns assert_equal "this/is/b/directory/abc.rb", "this/is/a/dir/abc.rb".pathmap("%{a,b;dir,\\0ectory}p") end def test_partial_directory_selection_works_with_patterns assert_equal "this/is/a/long", "this/is/a/really/long/path/ok.rb".pathmap("%{/really/,/}5d") end def test_pattern_with_invalid_operator ex = assert_raises(ArgumentError) do "abc.xyz".pathmap("%{src,bin}z") end assert_match(/unknown.*pathmap.*spec.*z/i, ex.message) end def test_works_with_windows_separators if File::ALT_SEPARATOR assert_equal "abc", 'dir\abc.rb'.pathmap("%n") assert_equal 'this\is\a\dir', 'this\is\a\dir\abc.rb'.pathmap("%d") end end def test_complex_patterns sep = "".pathmap("%s") assert_equal( "dir/abc.rb", "dir/abc.rb".pathmap("%d/%n%x")) assert_equal( "./abc.rb", "abc.rb".pathmap("%d/%n%x")) assert_equal( "Your file extension is '.rb'", "dir/abc.rb".pathmap("Your file extension is '%x'")) assert_equal( "bin/org/onestepback/proj/A.class", "src/org/onestepback/proj/A.java".pathmap("%{src,bin}d/%n.class")) assert_equal( "src_work/bin/org/onestepback/proj/A.class", "src_work/src/org/onestepback/proj/A.java". pathmap('%{\bsrc\b,bin}X.class')) assert_equal( ".depends.bak", ".depends".pathmap("%X.bak")) assert_equal( "d#{sep}a/b/c#{sep}file.txt", "a/b/c/d/file.txt".pathmap("%-1d%s%3d%s%f")) end end rake-12.3.1/test/test_rake_path_map_explode.rb000066400000000000000000000020371325463231200214010ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakePathMapExplode < Rake::TestCase def setup super String.class_eval { public :pathmap_explode } end def teardown String.class_eval { protected :pathmap_explode } super end def test_explode assert_equal ["a"], "a".pathmap_explode assert_equal ["a", "b"], "a/b".pathmap_explode assert_equal ["a", "b", "c"], "a/b/c".pathmap_explode assert_equal ["/", "a"], "/a".pathmap_explode assert_equal ["/", "a", "b"], "/a/b".pathmap_explode assert_equal ["/", "a", "b", "c"], "/a/b/c".pathmap_explode if File::ALT_SEPARATOR assert_equal ["c:.", "a"], "c:a".pathmap_explode assert_equal ["c:.", "a", "b"], "c:a/b".pathmap_explode assert_equal ["c:.", "a", "b", "c"], "c:a/b/c".pathmap_explode assert_equal ["c:/", "a"], "c:/a".pathmap_explode assert_equal ["c:/", "a", "b"], "c:/a/b".pathmap_explode assert_equal ["c:/", "a", "b", "c"], "c:/a/b/c".pathmap_explode end end end rake-12.3.1/test/test_rake_path_map_partial.rb000066400000000000000000000010021325463231200213640ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakePathMapPartial < Rake::TestCase def test_pathmap_partial @path = "1/2/file".dup def @path.call(n) pathmap_partial(n) end assert_equal("1", @path.call(1)) assert_equal("1/2", @path.call(2)) assert_equal("1/2", @path.call(3)) assert_equal(".", @path.call(0)) assert_equal("2", @path.call(-1)) assert_equal("1/2", @path.call(-2)) assert_equal("1/2", @path.call(-3)) end end rake-12.3.1/test/test_rake_pseudo_status.rb000066400000000000000000000010301325463231200207620ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakePseudoStatus < Rake::TestCase def test_with_zero_exit_status s = Rake::PseudoStatus.new assert_equal 0, s.exitstatus assert_equal 0, s.to_i assert_equal 0, s >> 8 refute s.stopped? assert s.exited? end def test_with_99_exit_status s = Rake::PseudoStatus.new(99) assert_equal 99, s.exitstatus assert_equal 25344, s.to_i assert_equal 99, s >> 8 refute s.stopped? assert s.exited? end end rake-12.3.1/test/test_rake_rake_test_loader.rb000066400000000000000000000024141325463231200213760ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeRakeTestLoader < Rake::TestCase def setup super @loader = File.join @rake_lib, "rake/rake_test_loader.rb" end def test_pattern orig_loaded_features = $:.dup FileUtils.touch "foo.rb" FileUtils.touch "test_a.rb" FileUtils.touch "test_b.rb" ARGV.replace %w[foo.rb test_*.rb -v] load @loader assert_equal %w[-v], ARGV ensure $:.replace orig_loaded_features end def test_load_error_from_require out, err = capture_io do ARGV.replace %w[no_such_test_file.rb] assert_raises SystemExit do load @loader end end assert_empty out no_such_path = File.join @tempdir, "no_such_test_file" expected = /\A\n File\ does\ not\ exist:\ #{no_such_path}(\.rb)? # JRuby is different \n\n\Z/x assert_match expected, err end def test_load_error_raised_explicitly File.write("error_test.rb", "raise LoadError, 'explicitly raised'") out, err = capture_io do ARGV.replace %w[error_test.rb] exc = assert_raises(LoadError) do load @loader end assert_equal "explicitly raised", exc.message end assert_empty out assert_empty err end end rake-12.3.1/test/test_rake_reduce_compat.rb000066400000000000000000000010621325463231200206770ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "open3" class TestRakeReduceCompat < Rake::TestCase include RubyRunner def invoke_normal(task_name) rake task_name.to_s @out end def test_no_deprecated_dsl rakefile %q{ task :check_task do Module.new { p defined?(task) } end task :check_file do Module.new { p defined?(file) } end } assert_equal "nil", invoke_normal(:check_task).chomp assert_equal "nil", invoke_normal(:check_file).chomp end end rake-12.3.1/test/test_rake_require.rb000066400000000000000000000017231325463231200175450ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeRequire < Rake::TestCase def setup super $LOAD_PATH.unshift "." if jruby17? end def test_can_load_rake_library rakefile_rakelib app = Rake::Application.new assert app.instance_eval { rake_require("test2", ["rakelib"], []) } end def test_wont_reload_rake_library rakefile_rakelib app = Rake::Application.new paths = ["rakelib"] loaded_files = [] app.rake_require("test2", paths, loaded_files) assert ! app.instance_eval { rake_require("test2", paths, loaded_files) } end def test_throws_error_if_library_not_found rakefile_rakelib app = Rake::Application.new ex = assert_raises(LoadError) { assert app.instance_eval { rake_require("testx", ["rakelib"], []) } } assert_match(/(can *not|can't)\s+find/i, ex.message) assert_match(/testx/, ex.message) end end rake-12.3.1/test/test_rake_rules.rb000066400000000000000000000240541325463231200172250ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "fileutils" class TestRakeRules < Rake::TestCase include Rake SRCFILE = "abc.c" SRCFILE2 = "xyz.c" FTNFILE = "abc.f" OBJFILE = "abc.o" FOOFILE = "foo" DOTFOOFILE = ".foo" MINFILE = "abc.min.o" def setup super Task.clear @runs = [] end def test_multiple_rules1 create_file(FTNFILE) delete_file(SRCFILE) delete_file(OBJFILE) rule(/\.o$/ => [".c"]) do @runs << :C end rule(/\.o$/ => [".f"]) do @runs << :F end t = Task[OBJFILE] t.invoke Task[OBJFILE].invoke assert_equal [:F], @runs end def test_multiple_rules2 create_file(FTNFILE) delete_file(SRCFILE) delete_file(OBJFILE) rule(/\.o$/ => [".f"]) do @runs << :F end rule(/\.o$/ => [".c"]) do @runs << :C end Task[OBJFILE].invoke assert_equal [:F], @runs end def test_create_with_source create_file(SRCFILE) rule(/\.o$/ => [".c"]) do |t| @runs << t.name assert_equal OBJFILE, t.name assert_equal SRCFILE, t.source end Task[OBJFILE].invoke assert_equal [OBJFILE], @runs end def test_single_dependent create_file(SRCFILE) rule(/\.o$/ => ".c") do |t| @runs << t.name end Task[OBJFILE].invoke assert_equal [OBJFILE], @runs end def test_rule_can_be_created_by_string create_file(SRCFILE) rule ".o" => [".c"] do |t| @runs << t.name end Task[OBJFILE].invoke assert_equal [OBJFILE], @runs end def test_rule_prereqs_can_be_created_by_string create_file(SRCFILE) rule ".o" => ".c" do |t| @runs << t.name end Task[OBJFILE].invoke assert_equal [OBJFILE], @runs end def test_plain_strings_as_dependents_refer_to_files create_file(SRCFILE) rule ".o" => SRCFILE do |t| @runs << t.name end Task[OBJFILE].invoke assert_equal [OBJFILE], @runs end def test_file_names_beginning_with_dot_can_be_tricked_into_referring_to_file verbose(false) do create_file(".foo") rule ".o" => "./.foo" do |t| @runs << t.name end Task[OBJFILE].invoke assert_equal [OBJFILE], @runs end end def test_file_names_beginning_with_dot_can_be_wrapped_in_lambda verbose(false) do create_file(".foo") rule ".o" => lambda { ".foo" } do |t| @runs << "#{t.name} - #{t.source}" end Task[OBJFILE].invoke assert_equal ["#{OBJFILE} - .foo"], @runs end end def test_file_names_containing_percent_can_be_wrapped_in_lambda verbose(false) do create_file("foo%x") rule ".o" => lambda { "foo%x" } do |t| @runs << "#{t.name} - #{t.source}" end Task[OBJFILE].invoke assert_equal ["#{OBJFILE} - foo%x"], @runs end end def test_non_extension_rule_name_refers_to_file verbose(false) do create_file("abc.c") rule "abc" => ".c" do |t| @runs << t.name end Task["abc"].invoke assert_equal ["abc"], @runs end end def test_pathmap_automatically_applies_to_name verbose(false) do create_file("zzabc.c") rule ".o" => "zz%{x,a}n.c" do |t| @runs << "#{t.name} - #{t.source}" end Task["xbc.o"].invoke assert_equal ["xbc.o - zzabc.c"], @runs end end def test_plain_strings_are_just_filenames verbose(false) do create_file("plainname") rule ".o" => "plainname" do |t| @runs << "#{t.name} - #{t.source}" end Task["xbc.o"].invoke assert_equal ["xbc.o - plainname"], @runs end end def test_rule_runs_when_explicit_task_has_no_actions create_file(SRCFILE) create_file(SRCFILE2) delete_file(OBJFILE) rule ".o" => ".c" do |t| @runs << t.source end file OBJFILE => [SRCFILE2] Task[OBJFILE].invoke assert_equal [SRCFILE], @runs end def test_close_matches_on_name_do_not_trigger_rule create_file("x.c") rule ".o" => [".c"] do |t| @runs << t.name end assert_raises(RuntimeError) { Task["x.obj"].invoke } assert_raises(RuntimeError) { Task["x.xyo"].invoke } end def test_rule_rebuilds_obj_when_source_is_newer create_timed_files(OBJFILE, SRCFILE) rule(/\.o$/ => [".c"]) do @runs << :RULE end Task[OBJFILE].invoke assert_equal [:RULE], @runs end def test_rule_with_two_sources_runs_if_both_sources_are_present create_timed_files(OBJFILE, SRCFILE, SRCFILE2) rule OBJFILE => [lambda { SRCFILE }, lambda { SRCFILE2 }] do @runs << :RULE end Task[OBJFILE].invoke assert_equal [:RULE], @runs end def test_rule_with_two_sources_but_one_missing_does_not_run create_timed_files(OBJFILE, SRCFILE) delete_file(SRCFILE2) rule OBJFILE => [lambda { SRCFILE }, lambda { SRCFILE2 }] do @runs << :RULE end Task[OBJFILE].invoke assert_equal [], @runs end def test_rule_with_two_sources_builds_both_sources task "x.aa" task "x.bb" rule ".a" => ".aa" do @runs << "A" end rule ".b" => ".bb" do @runs << "B" end rule ".c" => [".a", ".b"] do @runs << "C" end Task["x.c"].invoke assert_equal ["A", "B", "C"], @runs.sort end def test_second_rule_runs_when_first_rule_doesnt create_timed_files(OBJFILE, SRCFILE) delete_file(SRCFILE2) rule OBJFILE => [lambda { SRCFILE }, lambda { SRCFILE2 }] do @runs << :RULE1 end rule OBJFILE => [lambda { SRCFILE }] do @runs << :RULE2 end Task[OBJFILE].invoke assert_equal [:RULE2], @runs end def test_second_rule_doest_run_if_first_triggers create_timed_files(OBJFILE, SRCFILE, SRCFILE2) rule OBJFILE => [lambda { SRCFILE }, lambda { SRCFILE2 }] do @runs << :RULE1 end rule OBJFILE => [lambda { SRCFILE }] do @runs << :RULE2 end Task[OBJFILE].invoke assert_equal [:RULE1], @runs end def test_second_rule_doest_run_if_first_triggers_with_reversed_rules create_timed_files(OBJFILE, SRCFILE, SRCFILE2) rule OBJFILE => [lambda { SRCFILE }] do @runs << :RULE1 end rule OBJFILE => [lambda { SRCFILE }, lambda { SRCFILE2 }] do @runs << :RULE2 end Task[OBJFILE].invoke assert_equal [:RULE1], @runs end def test_rule_with_proc_dependent_will_trigger mkdir_p("src/jw") create_file("src/jw/X.java") rule %r(classes/.*\.class) => [ proc { |fn| fn.pathmap("%{classes,src}d/%n.java") } ] do |task| assert_equal task.name, "classes/jw/X.class" assert_equal task.source, "src/jw/X.java" @runs << :RULE end Task["classes/jw/X.class"].invoke assert_equal [:RULE], @runs ensure rm_r("src", verbose: false) rescue nil end def test_proc_returning_lists_are_flattened_into_prereqs ran = false mkdir_p("flatten") create_file("flatten/a.txt") task "flatten/b.data" do |t| ran = true touch t.name, verbose: false end rule ".html" => proc { |fn| [ fn.ext("txt"), "flatten/b.data" ] } do |task| end Task["flatten/a.html"].invoke assert ran, "Should have triggered flattened dependency" ensure rm_r("flatten", verbose: false) rescue nil end def test_recursive_rules_will_work_as_long_as_they_terminate actions = [] create_file("abc.xml") rule ".y" => ".xml" do actions << "y" end rule ".c" => ".y" do actions << "c"end rule ".o" => ".c" do actions << "o"end rule ".exe" => ".o" do actions << "exe"end Task["abc.exe"].invoke assert_equal ["y", "c", "o", "exe"], actions end def test_recursive_rules_that_dont_terminate_will_overflow create_file("a.a") prev = "a" ("b".."z").each do |letter| rule ".#{letter}" => ".#{prev}" do |t| puts "#{t.name}" end prev = letter end ex = assert_raises(Rake::RuleRecursionOverflowError) { Task["a.z"].invoke } assert_match(/a\.z => a.y/, ex.message) end def test_rules_with_bad_dependents_will_fail rule "a" => [1] do |t| puts t.name end assert_raises(RuntimeError) do Task["a"].invoke end end def test_string_rule_with_args delete_file(OBJFILE) create_file(SRCFILE) rule ".o", [:a] => SRCFILE do |t, args| assert_equal "arg", args.a end Task[OBJFILE].invoke("arg") end def test_regex_rule_with_args delete_file(OBJFILE) create_file(SRCFILE) rule(/.o$/, [:a] => SRCFILE) do |t, args| assert_equal "arg", args.a end Task[OBJFILE].invoke("arg") end # for https://github.com/ruby/rake/pull/182 def test_single_dependent_with_nil_args create_file(SRCFILE) rule nil => ".cpp" do |t| p t.name end rule(/\.o$/ => ".c") do |t| @runs << t.name end Task[OBJFILE].invoke assert_equal [OBJFILE], @runs end def test_string_rule_with_args_and_lambda_prereq delete_file(OBJFILE) create_file(SRCFILE) rule ".o", [:a] => [lambda { SRCFILE }]do |t, args| assert_equal "arg", args.a end Task[OBJFILE].invoke("arg") end def test_regex_rule_with_args_and_lambda_prereq delete_file(OBJFILE) create_file(SRCFILE) rule(/.o$/, [:a] => [lambda { SRCFILE }]) do |t, args| assert_equal "arg", args.a end Task[OBJFILE].invoke("arg") end def test_rule_with_method_prereq create_file(".foo") obj = Object.new def obj.find_prereq ".foo" end rule ".o" => obj.method(:find_prereq) do |t| @runs << "#{t.name} - #{t.source}" end Task[OBJFILE].invoke assert_equal ["#{OBJFILE} - .foo"], @runs end def test_rule_with_one_arg_method_prereq create_file(SRCFILE) obj = Object.new def obj.find_prereq(task_name) task_name.ext(".c") end rule ".o" => obj.method(:find_prereq) do |t| @runs << "#{t.name} - #{t.source}" end Task[OBJFILE].invoke assert_equal ["#{OBJFILE} - abc.c"], @runs end def test_works_with_chained_extensions_in_rules create_file(OBJFILE) rule(".min.o" => [".o"]) do |t| @runs << t.name assert_equal OBJFILE, t.source assert_equal MINFILE, t.name end Task[MINFILE].invoke assert_equal [MINFILE], @runs end end rake-12.3.1/test/test_rake_scope.rb000066400000000000000000000022041325463231200171750ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeScope < Rake::TestCase include Rake def test_path_against_empty_scope scope = Scope.make assert_equal scope, Scope::EMPTY assert_equal scope.path, "" end def test_path_against_one_element scope = Scope.make(:one) assert_equal "one", scope.path end def test_path_against_two_elements scope = Scope.make(:inner, :outer) assert_equal "outer:inner", scope.path end def test_path_with_task_name scope = Scope.make(:inner, :outer) assert_equal "outer:inner:task", scope.path_with_task_name("task") end def test_path_with_task_name_against_empty_scope scope = Scope.make assert_equal "task", scope.path_with_task_name("task") end def test_conj_against_two_elements scope = Scope.make.conj("B").conj("A") assert_equal Scope.make("A", "B"), scope end def test_trim scope = Scope.make("A", "B") assert_equal scope, scope.trim(0) assert_equal scope.tail, scope.trim(1) assert_equal scope.tail.tail, scope.trim(2) assert_equal scope.tail.tail, scope.trim(3) end end rake-12.3.1/test/test_rake_task.rb000066400000000000000000000260141325463231200170330ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "fileutils" class TestRakeTask < Rake::TestCase include Rake def setup super Task.clear Rake::TaskManager.record_task_metadata = true end def teardown Rake::TaskManager.record_task_metadata = false Rake.application.thread_pool.join super end def test_create arg = nil t = task(:name) { |task| arg = task; 1234 } assert_equal "name", t.name assert_equal [], t.prerequisites assert t.needed? t.execute(0) assert_equal t, arg assert_nil t.source assert_equal [], t.sources assert_equal 1, t.locations.size assert_match(/#{Regexp.quote(__FILE__)}/, t.locations.first) end def test_inspect t = task(foo: [:bar, :baz]) assert_equal " [bar, baz]>", t.inspect end def test_invoke runlist = [] t1 = task(t1: [:t2, :t3]) { |t| runlist << t.name; 3321 } task(:t2) { |t| runlist << t.name } task(:t3) { |t| runlist << t.name } assert_equal ["t2", "t3"], t1.prerequisites t1.invoke assert_equal ["t2", "t3", "t1"], runlist end def test_invoke_with_circular_dependencies runlist = [] t1 = task(t1: [:t2]) { |t| runlist << t.name; 3321 } t2 = task(t2: [:t1]) { |t| runlist << t.name } assert_equal ["t2"], t1.prerequisites assert_equal ["t1"], t2.prerequisites ex = assert_raises RuntimeError do t1.invoke end assert_match(/circular dependency/i, ex.message) assert_match(/t1 => t2 => t1/, ex.message) end def test_dry_run_prevents_actions runlist = [] t1 = task(:t1) { |t| runlist << t.name; 3321 } _, err = capture_io { Rake.application.set_default_options # reset trace output IO Rake.application.options.dryrun = true t1.invoke } assert_match(/execute .*t1/i, err) assert_match(/dry run/i, err) refute_match(/invoke/i, err) assert_equal [], runlist ensure Rake.application.options.dryrun = false end def test_tasks_can_be_traced t1 = task(:t1) _, err = capture_io { Rake.application.set_default_options # reset trace output IO Rake.application.options.trace = true t1.invoke } assert_match(/invoke t1/i, err) assert_match(/execute t1/i, err) ensure Rake.application.options.trace = false end def test_no_double_invoke runlist = [] t1 = task(t1: [:t2, :t3]) { |t| runlist << t.name; 3321 } task(t2: [:t3]) { |t| runlist << t.name } task(:t3) { |t| runlist << t.name } t1.invoke assert_equal ["t3", "t2", "t1"], runlist end def test_already_invoked t1 = task(:t1) {} assert_equal false, t1.already_invoked t1.invoke assert_equal true, t1.already_invoked end def test_can_double_invoke_with_reenable runlist = [] t1 = task(:t1) { |t| runlist << t.name } t1.invoke t1.reenable t1.invoke assert_equal ["t1", "t1"], runlist end def test_clear desc "a task" t = task("t", ["b"] => "a") {} t.clear assert t.prerequisites.empty?, "prerequisites should be empty" assert t.actions.empty?, "actions should be empty" assert_nil t.comment, "comments should be empty" assert_empty t.arg_names, "arg names should be empty" end def test_clear_prerequisites t = task("t" => ["a", "b"]) assert_equal ["a", "b"], t.prerequisites t.clear_prerequisites assert_equal [], t.prerequisites end def test_clear_actions t = task("t") {} t.clear_actions assert t.actions.empty?, "actions should be empty" end def test_clear_comments desc "the original foo" task foo: [:x] do # Dummy action end task(:foo).clear_comments desc "a slightly different foo" task :foo assert_equal "a slightly different foo", task(:foo).comment assert_equal ["x"], task(:foo).prerequisites assert_equal 1, task(:foo).actions.size end def test_clear_args task :foo, [:x] do # Dummy action end task(:foo).clear_args task :foo assert_empty task(:foo).arg_names end def test_find task :tfind assert_equal "tfind", Task[:tfind].name ex = assert_raises(RuntimeError) { Task[:leaves] } assert_equal "Don't know how to build task 'leaves' (see --tasks)", ex.message end def test_defined assert ! Task.task_defined?(:a) task :a assert Task.task_defined?(:a) end def test_multi_invocations runs = [] p = proc do |t| runs << t.name end task({ t1: [:t2, :t3] }, &p) task({ t2: [:t3] }, &p) task(:t3, &p) Task[:t1].invoke assert_equal ["t1", "t2", "t3"], runs.sort end def test_task_list task :t2 task t1: [:t2] assert_equal ["t1", "t2"], Task.tasks.map(&:name) end def test_task_gives_name_on_to_s task :abc assert_equal "abc", Task[:abc].to_s end def test_symbols_can_be_prerequisites task a: :b assert_equal ["b"], Task[:a].prerequisites end def test_strings_can_be_prerequisites task a: "b" assert_equal ["b"], Task[:a].prerequisites end def test_arrays_can_be_prerequisites task a: ["b", "c"] assert_equal ["b", "c"], Task[:a].prerequisites end def test_filelists_can_be_prerequisites task a: FileList.new.include("b", "c") assert_equal ["b", "c"], Task[:a].prerequisites end def test_prerequisite_tasks_returns_tasks_not_strings a = task a: ["b", "c"] b = task :b c = task :c assert_equal [b, c], a.prerequisite_tasks end def test_prerequisite_tasks_fails_if_prerequisites_are_undefined a = task a: ["b", "c"] task :b assert_raises(RuntimeError) do a.prerequisite_tasks end end def test_prerequisite_tasks_honors_namespaces task :b a = b = nil namespace "X" do a = task a: ["b", "c"] b = task :b end c = task :c assert_equal [b, c], a.prerequisite_tasks end def test_prerequisite_tasks_finds_tasks_with_same_name_outside_namespace b1 = nil namespace "a" do b1 = task b: "b" end b2 = task :b assert_equal [b2], b1.prerequisite_tasks end def test_prerequisite_tasks_in_nested_namespaces m = task :m a_c_m = a_b_m = a_m = nil namespace "a" do a_m = task :m namespace "b" do a_b_m = task m: "m" end namespace "c" do a_c_m = task m: "a:m" end end assert_equal [m], a_b_m.prerequisite_tasks assert_equal [a_m], a_c_m.prerequisite_tasks end def test_all_prerequisite_tasks_includes_all_prerequisites a = task a: "b" b = task b: ["c", "d"] c = task c: "e" d = task :d e = task :e assert_equal [b, c, d, e], a.all_prerequisite_tasks.sort_by { |t| t.name } end def test_all_prerequisite_tasks_does_not_include_duplicates a = task a: ["b", "c"] b = task b: "c" c = task :c assert_equal [b, c], a.all_prerequisite_tasks.sort_by { |t| t.name } end def test_all_prerequisite_tasks_includes_self_on_cyclic_dependencies a = task a: "b" b = task b: "a" assert_equal [a, b], a.all_prerequisite_tasks.sort_by { |t| t.name } end def test_timestamp_returns_now_if_all_prereqs_have_no_times a = task a: ["b", "c"] task :b task :c assert_in_delta Time.now, a.timestamp, 0.1, "computer too slow?" end def test_timestamp_returns_latest_prereq_timestamp a = task a: ["b", "c"] b = task :b c = task :c now = Time.now def b.timestamp() Time.now + 10 end def c.timestamp() Time.now + 5 end assert_in_delta now, a.timestamp, 0.1, "computer too slow?" end def test_always_multitask mx = Mutex.new result = [] t_a = task(:a) do |t| sleep 0.2 mx.synchronize { result << t.name } end t_b = task(:b) do |t| mx.synchronize { result << t.name } end t_c = task(c: [:a, :b]) do |t| mx.synchronize { result << t.name } end t_c.invoke # task should always run in order assert_equal ["a", "b", "c"], result [t_a, t_b, t_c].each(&:reenable) result.clear Rake.application.options.always_multitask = true t_c.invoke # with multitask, task 'b' should grab the mutex first assert_equal ["b", "a", "c"], result end def test_investigation_output t1 = task(t1: [:t2, :t3]) { |t| runlist << t.name; 3321 } task(:t2) task(:t3) out = t1.investigation assert_match(/class:\s*Rake::Task/, out) assert_match(/needed:\s*true/, out) assert_match(/pre-requisites:\s*--t[23]/, out) end # NOTE: Rail-ties uses comment=. def test_comment_setting t = task(:t, :name, :rev) t.comment = "A Comment" assert_equal "A Comment", t.comment end def test_comments_with_sentences_period desc "Comment 1. Comment 2." t = task(:t, :name, :rev) assert_equal "Comment 1", t.comment end def test_comments_with_sentences_exclamation_mark desc "An exclamation mark! Comment." t = task(:t, :name, :rev) assert_equal "An exclamation mark", t.comment end def test_comments_with_many_periods desc "This is a test...I think ... testing. Comment." t = task(:t, :name, :rev) assert_equal "This is a test...I think ... testing", t.comment end def test_comments_with_tabbed_sentences desc "Comment 1.\tComment 2." t = task(:t, :name, :rev) assert_equal "Comment 1", t.comment end def test_comments_with_decimal_points desc "Revision 1.2.3." t = task(:t, :name, :rev) assert_equal "Revision 1.2.3", t.comment end def test_comments_do_not_set t = task(:t, :name, :rev) assert_nil t.comment end def test_comments_is_nil t = task(:t, :name, :rev) t.comment = nil assert_nil t.comment end def test_extended_comments desc %{ This is a comment. And this is the extended comment. name -- Name of task to execute. rev -- Software revision to use. } t = task(:t, :name, :rev) assert_equal "[name,rev]", t.arg_description assert_equal "This is a comment", t.comment assert_match(/^\s*name -- Name/, t.full_comment) assert_match(/^\s*rev -- Software/, t.full_comment) assert_match(/\A\s*This is a comment\.$/, t.full_comment) end def test_multiple_comments desc "line one" t = task(:t) desc "line two" task(:t) assert_equal "line one / line two", t.comment end def test_duplicate_comments desc "line one" t = task(:t) desc "line one" task(:t) assert_equal "line one", t.comment end def test_interspersed_duplicate_comments desc "line one" t = task(:t) desc "line two" task(:t) desc "line one" task(:t) assert_equal "line one / line two", t.comment end def test_source_is_first_prerequisite t = task t: ["preqA", "preqB"] assert_equal "preqA", t.source end def test_suggests_valid_rake_task_names task :test error = assert_raises(RuntimeError) { Task[:testt] } assert_match(/Don\'t know how to build task \'testt\'/, error.message) if defined?(::DidYouMean::SpellChecker) && defined?(::DidYouMean::Formatter) assert_match(/Did you mean\? test/, error.message) end end end rake-12.3.1/test/test_rake_task_argument_parsing.rb000066400000000000000000000060201325463231200224530ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeTaskArgumentParsing < Rake::TestCase def setup super @app = Rake::Application.new end def test_name_only name, args = @app.parse_task_string("name") assert_equal "name", name assert_equal [], args end def test_empty_args name, args = @app.parse_task_string("name[]") assert_equal "name", name assert_equal [], args end def test_one_argument name, args = @app.parse_task_string("name[one]") assert_equal "name", name assert_equal ["one"], args end def test_two_arguments name, args = @app.parse_task_string("name[one,two]") assert_equal "name", name assert_equal ["one", "two"], args end def test_can_handle_spaces_between_args name, args = @app.parse_task_string("name[one, two,\tthree , \tfour]") assert_equal "name", name assert_equal ["one", "two", "three", "four"], args end def test_can_handle_spaces_between_all_args name, args = @app.parse_task_string("name[ one , two ,\tthree , \tfour ]") assert_equal "name", name assert_equal ["one", "two", "three", "four"], args end def test_keeps_embedded_spaces name, args = @app.parse_task_string("name[a one ana, two]") assert_equal "name", name assert_equal ["a one ana", "two"], args end def test_can_handle_commas_in_args name, args = @app.parse_task_string("name[one, two, three_a\\, three_b, four]") assert_equal "name", name assert_equal ["one", "two", "three_a, three_b", "four"], args end def test_treat_blank_arg_as_empty_string name, args = @app.parse_task_string("name[one,]") assert_equal "name", name assert_equal ["one", ""], args name, args = @app.parse_task_string("name[one,,two]") assert_equal "name", name assert_equal ["one", "", "two"], args end def test_terminal_width_using_env app = Rake::Application.new app.terminal_columns = 1234 assert_equal 1234, app.terminal_width end def test_terminal_width_using_stty def @app.unix?() true end def @app.dynamic_width_stty() 1235 end def @app.dynamic_width_tput() 0 end assert_equal 1235, @app.terminal_width end def test_terminal_width_using_tput def @app.unix?() true end def @app.dynamic_width_stty() 0 end def @app.dynamic_width_tput() 1236 end assert_equal 1236, @app.terminal_width end def test_terminal_width_using_hardcoded_80 def @app.unix?() false end assert_equal 80, @app.terminal_width end def test_terminal_width_with_failure def @app.unix?() raise end assert_equal 80, @app.terminal_width end def test_no_rakeopt app = Rake::Application.new app.init %w[--trace] assert !app.options.silent end def test_rakeopt_with_blank_options app = Rake::Application.new app.init %w[--trace] assert !app.options.silent end def test_rakeopt_with_silent_options ENV["RAKEOPT"] = "-s" app = Rake::Application.new app.init assert app.options.silent end end rake-12.3.1/test/test_rake_task_arguments.rb000066400000000000000000000103701325463231200211160ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeTaskArguments < Rake::TestCase def teardown ENV.delete("rev") ENV.delete("VER") super end def test_empty_arg_list_is_empty ta = Rake::TaskArguments.new([], []) assert_equal({}, ta.to_hash) end def test_multiple_values_in_args ta = Rake::TaskArguments.new([:a, :b, :c], [:one, :two, :three]) assert_equal({ a: :one, b: :two, c: :three }, ta.to_hash) end def test_blank_values_in_args ta = Rake::TaskArguments.new([:a, :b, :c], ["", :two, ""]) assert_equal({ b: :two }, ta.to_hash) end def test_has_key ta = Rake::TaskArguments.new([:a], [:one]) assert(ta.has_key?(:a)) assert(ta.key?(:a)) refute(ta.has_key?(:b)) refute(ta.key?(:b)) end def test_fetch ta = Rake::TaskArguments.new([:one], [1]) assert_equal 1, ta.fetch(:one) assert_equal 2, ta.fetch(:two) { 2 } assert_raises(KeyError) { ta.fetch(:three) } end def test_to_s ta = Rake::TaskArguments.new([:a, :b, :c], [1, 2, 3]) expectation = "#" assert_equal expectation, ta.to_s assert_equal expectation, ta.inspect end def test_to_hash ta = Rake::TaskArguments.new([:one], [1]) h = ta.to_hash h[:one] = 0 assert_equal 1, ta.fetch(:one) assert_equal 0, h.fetch(:one) end def test_enumerable_behavior ta = Rake::TaskArguments.new([:a, :b, :c], [1, 2, 3]) assert_equal [10, 20, 30], ta.map { |k, v| v * 10 }.sort end def test_named_args ta = Rake::TaskArguments.new(["aa", "bb"], [1, 2]) assert_equal 1, ta.aa assert_equal 1, ta[:aa] assert_equal 1, ta["aa"] assert_equal 2, ta.bb assert_nil ta.cc end def test_args_knows_its_names ta = Rake::TaskArguments.new(["aa", "bb"], [1, 2]) assert_equal ["aa", "bb"], ta.names end def test_extra_names_are_nil ta = Rake::TaskArguments.new(["aa", "bb", "cc"], [1, 2]) assert_nil ta.cc end def test_args_do_not_reference_env_values ta = Rake::TaskArguments.new(["aa"], [1]) ENV["rev"] = "1.2" ENV["VER"] = "2.3" assert_nil ta.rev assert_nil ta.ver end def test_creating_new_argument_scopes parent = Rake::TaskArguments.new(["p"], [1]) child = parent.new_scope(["c", "p"]) assert_equal({ p: 1 }, child.to_hash) assert_equal 1, child.p assert_equal 1, child["p"] assert_equal 1, child[:p] assert_nil child.c end def test_child_hides_parent_arg_names parent = Rake::TaskArguments.new(["aa"], [1]) child = Rake::TaskArguments.new(["aa"], [2], parent) assert_equal 2, child.aa end def test_default_arguments_values_can_be_merged ta = Rake::TaskArguments.new(["aa", "bb"], [nil, "original_val"]) ta.with_defaults(aa: "default_val") assert_equal "default_val", ta[:aa] assert_equal "original_val", ta[:bb] end def test_default_arguments_that_dont_match_names_are_ignored ta = Rake::TaskArguments.new(["aa", "bb"], [nil, "original_val"]) ta.with_defaults("cc" => "default_val") assert_nil ta[:cc] end def test_all_and_extra_arguments_without_named_arguments app = Rake::Application.new _, args = app.parse_task_string("task[1,two,more]") ta = Rake::TaskArguments.new([], args) assert_equal [], ta.names assert_equal ["1", "two", "more"], ta.to_a assert_equal ["1", "two", "more"], ta.extras end def test_all_and_extra_arguments_with_named_arguments app = Rake::Application.new _, args = app.parse_task_string("task[1,two,more,still more]") ta = Rake::TaskArguments.new([:first, :second], args) assert_equal [:first, :second], ta.names assert_equal "1", ta[:first] assert_equal "two", ta[:second] assert_equal ["1", "two", "more", "still more"], ta.to_a assert_equal ["more", "still more"], ta.extras end def test_extra_args_with_less_than_named_arguments app = Rake::Application.new _, args = app.parse_task_string("task[1,two]") ta = Rake::TaskArguments.new([:first, :second, :third], args) assert_equal [:first, :second, :third], ta.names assert_equal "1", ta[:first] assert_equal "two", ta[:second] assert_nil ta[:third] assert_equal ["1", "two"], ta.to_a assert_equal [], ta.extras end end rake-12.3.1/test/test_rake_task_manager.rb000066400000000000000000000114321325463231200205230ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeTaskManager < Rake::TestCase def setup super @tm = Rake::TestCase::TaskManager.new end def test_create_task_manager refute_nil @tm assert_equal [], @tm.tasks end def test_define_task t = @tm.define_task(Rake::Task, :t) assert_equal "t", t.name assert_equal @tm, t.application end def test_index e = assert_raises RuntimeError do @tm["bad"] end assert_equal "Don't know how to build task 'bad' (see --tasks)", e.message end def test_name_lookup t = @tm.define_task(Rake::Task, :t) assert_equal t, @tm[:t] end def test_namespace_task_create @tm.in_namespace("x") do t = @tm.define_task(Rake::Task, :t) assert_equal "x:t", t.name end assert_equal ["x:t"], @tm.tasks.map(&:name) end def test_define_namespaced_task t = @tm.define_task(Rake::Task, "n:a:m:e:t") assert_equal Rake::Scope.make("e", "m", "a", "n"), t.scope assert_equal "n:a:m:e:t", t.name assert_equal @tm, t.application end def test_define_namespace_in_namespace t = nil @tm.in_namespace("n") do t = @tm.define_task(Rake::Task, "a:m:e:t") end assert_equal Rake::Scope.make("e", "m", "a", "n"), t.scope assert_equal "n:a:m:e:t", t.name assert_equal @tm, t.application end def test_anonymous_namespace anon_ns = @tm.in_namespace(nil) do t = @tm.define_task(Rake::Task, :t) assert_equal "_anon_1:t", t.name end task = anon_ns[:t] assert_equal "_anon_1:t", task.name end def test_create_filetask_in_namespace @tm.in_namespace("x") do t = @tm.define_task(Rake::FileTask, "fn") assert_equal "fn", t.name end assert_equal ["fn"], @tm.tasks.map(&:name) end def test_namespace_yields_same_namespace_as_returned yielded_namespace = nil returned_namespace = @tm.in_namespace("x") do |ns| yielded_namespace = ns end assert_equal returned_namespace, yielded_namespace end def test_name_lookup_with_implicit_file_tasks FileUtils.touch "README.rdoc" t = @tm["README.rdoc"] assert_equal "README.rdoc", t.name assert Rake::FileTask === t end def test_name_lookup_with_nonexistent_task assert_raises(RuntimeError) { @tm["DOES NOT EXIST"] } end def test_name_lookup_in_multiple_scopes aa = nil bb = nil xx = @tm.define_task(Rake::Task, :xx) top_z = @tm.define_task(Rake::Task, :z) @tm.in_namespace("a") do aa = @tm.define_task(Rake::Task, :aa) mid_z = @tm.define_task(Rake::Task, :z) ns_d = @tm.define_task(Rake::Task, "n:t") @tm.in_namespace("b") do bb = @tm.define_task(Rake::Task, :bb) bot_z = @tm.define_task(Rake::Task, :z) assert_equal Rake::Scope.make("b", "a"), @tm.current_scope assert_equal bb, @tm["a:b:bb"] assert_equal aa, @tm["a:aa"] assert_equal xx, @tm["xx"] assert_equal bot_z, @tm["z"] assert_equal mid_z, @tm["^z"] assert_equal top_z, @tm["^^z"] assert_equal top_z, @tm["^^^z"] # Over the top assert_equal top_z, @tm["rake:z"] end assert_equal Rake::Scope.make("a"), @tm.current_scope assert_equal bb, @tm["a:b:bb"] assert_equal aa, @tm["a:aa"] assert_equal xx, @tm["xx"] assert_equal bb, @tm["b:bb"] assert_equal aa, @tm["aa"] assert_equal mid_z, @tm["z"] assert_equal top_z, @tm["^z"] assert_equal top_z, @tm["^^z"] # Over the top assert_equal top_z, @tm["rake:z"] assert_equal ns_d, @tm["n:t"] assert_equal ns_d, @tm["a:n:t"] end assert_equal Rake::Scope.make, @tm.current_scope assert_equal Rake::Scope.make, xx.scope assert_equal Rake::Scope.make("a"), aa.scope assert_equal Rake::Scope.make("b", "a"), bb.scope end def test_lookup_with_explicit_scopes t1, t2, t3, s = (0...4).map { nil } t1 = @tm.define_task(Rake::Task, :t) @tm.in_namespace("a") do t2 = @tm.define_task(Rake::Task, :t) s = @tm.define_task(Rake::Task, :s) @tm.in_namespace("b") do t3 = @tm.define_task(Rake::Task, :t) end end assert_equal t1, @tm[:t, Rake::Scope.make] assert_equal t2, @tm[:t, Rake::Scope.make("a")] assert_equal t3, @tm[:t, Rake::Scope.make("b", "a")] assert_equal s, @tm[:s, Rake::Scope.make("b", "a")] assert_equal s, @tm[:s, Rake::Scope.make("a")] end def test_correctly_scoped_prerequisites_are_invoked values = [] @tm = Rake::Application.new @tm.define_task(Rake::Task, :z) do values << "top z" end @tm.in_namespace("a") do @tm.define_task(Rake::Task, :z) do values << "next z" end @tm.define_task(Rake::Task, x: :z) end @tm["a:x"].invoke assert_equal ["next z"], values end end rake-12.3.1/test/test_rake_task_manager_argument_resolution.rb000066400000000000000000000011631325463231200247100ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeTaskManagerArgumentResolution < Rake::TestCase def test_good_arg_patterns assert_equal [:t, [], []], task(:t) assert_equal [:t, [], [:x]], task(t: :x) assert_equal [:t, [], [:x, :y]], task(t: [:x, :y]) assert_equal [:t, [:a, :b], []], task(:t, [:a, :b]) assert_equal [:t, [:a, :b], [:x]], task(:t, [:a, :b] => :x) assert_equal [:t, [:a, :b], [:x, :y]], task(:t, [:a, :b] => [:x, :y]) end def task(*args) tm = Rake::TestCase::TaskManager.new tm.resolve_args(args) end end rake-12.3.1/test/test_rake_task_with_arguments.rb000066400000000000000000000122171325463231200221530ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeTaskWithArguments < Rake::TestCase include Rake def setup super Task.clear Rake::TaskManager.record_task_metadata = true end def teardown Rake::TaskManager.record_task_metadata = false Rake.application.thread_pool.join super end def test_no_args_given t = task :t assert_equal [], t.arg_names end def test_args_given t = task :t, :a, :b assert_equal [:a, :b], t.arg_names end def test_name_and_needs t = task(t: [:pre]) assert_equal "t", t.name assert_equal [], t.arg_names assert_equal ["pre"], t.prerequisites end def test_name_args_and_prereqs t = task(:t, [:x, :y] => [:pre]) assert_equal "t", t.name assert_equal [:x, :y], t.arg_names assert_equal ["pre"], t.prerequisites end def test_arg_list_is_empty_if_no_args_given t = task(:t) { |tt, args| assert_equal({}, args.to_hash) } t.invoke(1, 2, 3) end def test_tasks_can_access_arguments_as_hash t = task :t, :a, :b, :c do |tt, args| assert_equal({ a: 1, b: 2, c: 3 }, args.to_hash) assert_equal 1, args[:a] assert_equal 2, args[:b] assert_equal 3, args[:c] assert_equal 1, args.a assert_equal 2, args.b assert_equal 3, args.c end t.invoke(1, 2, 3) end def test_actions_of_various_arity_are_ok_with_args notes = [] t = task(:t, :x) do notes << :a end t.enhance do | | notes << :b end t.enhance do |task| notes << :c assert_kind_of Task, task end t.enhance do |t2, args| notes << :d assert_equal t, t2 assert_equal({ x: 1 }, args.to_hash) end t.invoke(1) assert_equal [:a, :b, :c, :d], notes end def test_actions_adore_keywords # A brutish trick to avoid parsing. Remove it once support for 1.9 and 2.0 is dropped # https://ci.appveyor.com/project/ruby/rake/build/1.0.301 skip "Keywords aren't a feature in this version" if RUBY_VERSION =~ /^1|^2\.0/ # https://github.com/ruby/rake/pull/174#issuecomment-263460761 skip if jruby9? eval <<-RUBY, binding, __FILE__, __LINE__+1 notes = [] t = task :t, [:reqr, :ovrd, :dflt] # required, overridden-optional, default-optional verify = lambda do |name, expecteds, actuals| notes << name assert_equal expecteds.length, actuals.length expecteds.zip(actuals) { |e, a| assert_equal e, a, "(TEST \#{name})" } end t.enhance { |dflt: 'd', **| verify.call :a, ['d'], [dflt] } t.enhance { |ovrd: '-', **| verify.call :b, ['o'], [ovrd] } t.enhance { |reqr: , **| verify.call :c, ['r'], [reqr] } t.enhance { |t2, dflt: 'd', **| verify.call :d, [t,'d'], [t2,dflt] } t.enhance { |t2, ovrd: 'd', **| verify.call :e, [t,'o'], [t2,ovrd] } t.enhance { |t2, reqr: , **| verify.call :f, [t,'r'], [t2,reqr] } t.enhance { |t2, dflt: 'd', reqr:, **| verify.call :g, [t,'d','r'], [t2,dflt,reqr] } t.enhance { |t2, ovrd: '-', reqr:, **| verify.call :h, [t,'o','r'], [t2,ovrd,reqr] } t.invoke('r', 'o') assert_equal [*:a..:h], notes RUBY end def test_arguments_are_passed_to_block t = task(:t, :a, :b) { |tt, args| assert_equal({ a: 1, b: 2 }, args.to_hash) } t.invoke(1, 2) end def test_extra_parameters_are_ignored t = task(:t, :a) { |tt, args| assert_equal 1, args.a assert_nil args.b } t.invoke(1, 2) end def test_arguments_are_passed_to_all_blocks counter = 0 t = task :t, :a task :t do |tt, args| assert_equal 1, args.a counter += 1 end task :t do |tt, args| assert_equal 1, args.a counter += 1 end t.invoke(1) assert_equal 2, counter end def test_block_with_no_parameters_is_ok t = task(:t) {} t.invoke(1, 2) end def test_name_with_args desc "T" t = task(:tt, :a, :b) assert_equal "tt", t.name assert_equal "T", t.comment assert_equal "[a,b]", t.arg_description assert_equal "tt[a,b]", t.name_with_args assert_equal [:a, :b], t.arg_names end def test_named_args_are_passed_to_prereqs value = nil task(:pre, :rev) { |t, args| value = args.rev } t = task(:t, [:name, :rev] => [:pre]) t.invoke("bill", "1.2") assert_equal "1.2", value end def test_args_not_passed_if_no_prereq_names_on_task task(:pre) { |t, args| assert_equal({}, args.to_hash) assert_equal "bill", args.name } t = task(:t, [:name, :rev] => [:pre]) t.invoke("bill", "1.2") end def test_args_not_passed_if_no_prereq_names_on_multitask task(:pre) { |t, args| assert_equal({}, args.to_hash) assert_equal "bill", args.name } t = multitask(:t, [:name, :rev] => [:pre]) t.invoke("bill", "1.2") end def test_args_not_passed_if_no_arg_names task(:pre, :rev) { |t, args| assert_equal({}, args.to_hash) } t = task(t: [:pre]) t.invoke("bill", "1.2") end def test_values_at t = task(:pre, [:a, :b, :c]) { |task, args| a, b, c = args.values_at(:a, :b, :c) assert_equal %w[1 2 3], [a, b, c] } t.invoke(*%w[1 2 3]) # HACK no assertions end end rake-12.3.1/test/test_rake_test_task.rb000066400000000000000000000105111325463231200200650ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "rake/testtask" class TestRakeTestTask < Rake::TestCase include Rake def test_initialize tt = Rake::TestTask.new do |t| end refute_nil tt assert_equal :test, tt.name assert_equal ["lib"], tt.libs assert_equal "test/test*.rb", tt.pattern assert_equal false, tt.verbose assert_equal true, tt.warning assert_equal [], tt.deps assert Task.task_defined?(:test) end def test_initialize_deps tt = Rake::TestTask.new(example: :bar) refute_nil tt assert_equal :bar, tt.deps assert Task.task_defined?(:example) end def test_initialize_multi_deps tt = Rake::TestTask.new(example: [:foo, :bar]) refute_nil tt assert_equal [:foo, :bar], tt.deps assert Task.task_defined?(:example) end def test_initialize_override tt = Rake::TestTask.new(example: :bar) do |t| t.description = "Run example tests" t.libs = ["src", "ext"] t.pattern = "test/tc_*.rb" t.warning = true t.verbose = true t.deps = [:env] end refute_nil tt assert_equal "Run example tests", tt.description assert_equal :example, tt.name assert_equal ["src", "ext"], tt.libs assert_equal "test/tc_*.rb", tt.pattern assert_equal true, tt.warning assert_equal true, tt.verbose assert_equal [:env], tt.deps assert_match(/-w/, tt.ruby_opts_string) assert Task.task_defined?(:example) end def test_file_list_env_test ENV["TEST"] = "testfile.rb" tt = Rake::TestTask.new do |t| t.pattern = "*" end assert_equal ["testfile.rb"], tt.file_list.to_a ensure ENV.delete "TEST" end def test_libs_equals test_task = Rake::TestTask.new do |t| t.libs << ["A", "B"] end path = %w[lib A B].join File::PATH_SEPARATOR assert_equal "-w -I\"#{path}\"", test_task.ruby_opts_string end def test_libs_equals_empty test_task = Rake::TestTask.new do |t| t.libs = [] t.warning = false end assert_equal "", test_task.ruby_opts_string end def test_pattern_equals ["gl.rb", "ob.rb"].each do |f| create_file(f) end tt = Rake::TestTask.new do |t| t.pattern = "*.rb" end assert_equal ["gl.rb", "ob.rb"], tt.file_list.to_a end def test_pattern_equals_test_files_equals ["gl.rb", "ob.rb"].each do |f| create_file(f) end tt = Rake::TestTask.new do |t| t.test_files = FileList["a.rb", "b.rb"] t.pattern = "*.rb" end assert_equal ["a.rb", "b.rb", "gl.rb", "ob.rb"], tt.file_list.to_a end def test_run_code_direct globbed = ["test_gl.rb", "test_ob.rb"].map { |f| File.join("test", f) } others = ["a.rb", "b.rb"].map { |f| File.join("test", f) } (globbed + others).each do |f| create_file(f) end test_task = Rake::TestTask.new do |t| t.loader = :direct # if t.pettern and t.test_files are nil, # t.pettern is "test/test*.rb" end assert_equal '-e "ARGV.each{|f| require f}"', test_task.run_code assert_equal globbed, test_task.file_list.to_a end def test_run_code_rake spec = Gem::Specification.new "rake", 0 spec.loaded_from = File.join Gem::Specification.dirs.last, "rake-0.gemspec" rake, Gem.loaded_specs["rake"] = Gem.loaded_specs["rake"], spec test_task = Rake::TestTask.new do |t| t.loader = :rake end assert_match(/\A-I".*?" ".*?"\Z/, test_task.run_code) ensure Gem.loaded_specs["rake"] = rake end def test_test_files_equals tt = Rake::TestTask.new do |t| t.test_files = FileList["a.rb", "b.rb"] end assert_equal ["a.rb", "b.rb"], tt.file_list.to_a end def test_task_prerequisites Rake::TestTask.new :parent Rake::TestTask.new child: :parent task = Rake::Task[:child] assert_includes task.prerequisites, "parent" end def test_task_prerequisites_multi Rake::TestTask.new :parent Rake::TestTask.new :parent2 Rake::TestTask.new child: [:parent, :parent2] task = Rake::Task[:child] assert_includes task.prerequisites, "parent" assert_includes task.prerequisites, "parent2" end def test_task_prerequisites_deps Rake::TestTask.new :parent Rake::TestTask.new :child do |t| t.deps = :parent end task = Rake::Task[:child] assert_includes task.prerequisites, "parent" end end rake-12.3.1/test/test_rake_thread_pool.rb000066400000000000000000000061621325463231200203730ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "rake/thread_pool" class TestRakeTestThreadPool < Rake::TestCase include Rake def test_pool_executes_in_current_thread_for_zero_threads pool = ThreadPool.new(0) f = pool.future { Thread.current } pool.join assert_equal Thread.current, f.value end def test_pool_executes_in_other_thread_for_pool_of_size_one pool = ThreadPool.new(1) f = pool.future { Thread.current } pool.join refute_equal Thread.current, f.value end def test_pool_executes_in_two_other_threads_for_pool_of_size_two pool = ThreadPool.new(2) threads = 2.times.map { pool.future { sleep 0.1 Thread.current } }.each(&:value) refute_equal threads[0], threads[1] refute_equal Thread.current, threads[0] refute_equal Thread.current, threads[1] ensure pool.join end def test_pool_creates_the_correct_number_of_threads pool = ThreadPool.new(2) threads = Set.new t_mutex = Mutex.new 10.times.each do pool.future do sleep 0.02 t_mutex.synchronize { threads << Thread.current } end end pool.join assert_equal 2, threads.count end def test_pool_future_does_not_duplicate_arguments pool = ThreadPool.new(2) obj = Object.new captured = nil pool.future(obj) { |var| captured = var } pool.join assert_equal obj, captured end def test_pool_join_empties_queue pool = ThreadPool.new(2) repeat = 25 repeat.times { pool.future do repeat.times { pool.future do repeat.times { pool.future do end } end } end } pool.join assert_equal( true, pool.__send__(:__queue__).empty?, "queue should be empty") end CustomError = Class.new(StandardError) # test that throwing an exception way down in the blocks propagates # to the top def test_exceptions pool = ThreadPool.new(10) deep_exception_block = lambda do |count| raise CustomError if count < 1 pool.future(count - 1, &deep_exception_block).value end assert_raises(CustomError) do pool.future(2, &deep_exception_block).value end ensure pool.join end def test_pool_prevents_deadlock pool = ThreadPool.new(5) common_dependency_a = pool.future { sleep 0.2 } futures_a = 10.times.map { pool.future { common_dependency_a.value sleep(rand() * 0.01) } } common_dependency_b = pool.future { futures_a.each(&:value) } futures_b = 10.times.map { pool.future { common_dependency_b.value sleep(rand() * 0.01) } } futures_b.each(&:value) pool.join end def test_pool_reports_correct_results pool = ThreadPool.new(7) a = 18 b = 5 c = 3 result = a.times.map do pool.future do b.times.map do pool.future { sleep rand * 0.001; c } end.reduce(0) { |m, f| m + f.value } end end.reduce(0) { |m, f| m + f.value } assert_equal a * b * c, result pool.join end end rake-12.3.1/test/test_rake_top_level_functions.rb000066400000000000000000000024311325463231200221470ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeTopLevelFunctions < Rake::TestCase def setup super @app = Object.new def @app.called @called end def @app.method_missing(*a, &b) @called ||= [] @called << [a, b] nil end Rake.application = @app end def test_namespace block = proc do end namespace("xyz", &block) expected = [ [[:in_namespace, "xyz"], block] ] assert_equal expected, @app.called end def test_import import("x", "y", "z") expected = [ [[:add_import, "x"], nil], [[:add_import, "y"], nil], [[:add_import, "z"], nil], ] assert_equal expected, @app.called end def test_when_writing out, = capture_io do when_writing("NOTWRITING") do puts "WRITING" end end assert_equal "WRITING\n", out end def test_when_not_writing Rake::FileUtilsExt.nowrite_flag = true _, err = capture_io do when_writing("NOTWRITING") do puts "WRITING" end end assert_equal "DRYRUN: NOTWRITING\n", err ensure Rake::FileUtilsExt.nowrite_flag = false end def test_missing_other_constant assert_raises(NameError) do Object.const_missing(:Xyz) end end end rake-12.3.1/test/test_rake_win32.rb000066400000000000000000000036161325463231200170360ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) class TestRakeWin32 < Rake::TestCase Win32 = Rake::Win32 def test_win32_system_dir_uses_home_if_defined ENV["HOME"] = 'C:\\HP' assert_equal "C:/HP/Rake", Win32.win32_system_dir end def test_win32_system_dir_uses_homedrive_homepath_when_no_home_defined ENV["HOME"] = nil ENV["HOMEDRIVE"] = "C:" ENV["HOMEPATH"] = '\\HP' assert_equal "C:/HP/Rake", Win32.win32_system_dir end def test_win32_system_dir_uses_appdata_when_no_home_or_home_combo ENV["APPDATA"] = "C:\\Documents and Settings\\HP\\Application Data" ENV["HOME"] = nil ENV["HOMEDRIVE"] = nil ENV["HOMEPATH"] = nil assert_equal "C:/Documents and Settings/HP/Application Data/Rake", Win32.win32_system_dir end def test_win32_system_dir_fallback_to_userprofile_otherwise ENV["HOME"] = nil ENV["HOMEDRIVE"] = nil ENV["HOMEPATH"] = nil ENV["APPDATA"] = nil ENV["USERPROFILE"] = "C:\\Documents and Settings\\HP" assert_equal "C:/Documents and Settings/HP/Rake", Win32.win32_system_dir end def test_win32_system_dir_nil_of_no_env_vars ENV["APPDATA"] = nil ENV["HOME"] = nil ENV["HOMEDRIVE"] = nil ENV["HOMEPATH"] = nil ENV["RAKE_SYSTEM"] = nil ENV["USERPROFILE"] = nil assert_raises(Rake::Win32::Win32HomeError) do Win32.win32_system_dir end end def test_win32_backtrace_with_different_case ex = nil begin raise "test exception" rescue => ex end ex.set_backtrace ["abc", "rakefile"] rake = Rake::Application.new rake.options.trace = true rake.instance_variable_set(:@rakefile, "Rakefile") _, err = capture_io { rake.set_default_options # reset trace output IO rake.display_error_message(ex) } assert_match(/rakefile/, err) end end rake-12.3.1/test/test_thread_history_display.rb000066400000000000000000000043571325463231200216520ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "rake/thread_history_display" class TestThreadHistoryDisplay < Rake::TestCase def setup super @time = 1_000_000 @stats = [] @display = Rake::ThreadHistoryDisplay.new(@stats) end def test_banner out, _ = capture_io do @display.show end assert_match(/Job History/i, out) end def test_item_queued @stats << event(:item_queued, item_id: 123) out, _ = capture_io do @display.show end assert_match(/^ *1000000 +A +item_queued +item_id:1$/, out) end def test_item_dequeued @stats << event(:item_dequeued, item_id: 123) out, _ = capture_io do @display.show end assert_match(/^ *1000000 +A +item_dequeued +item_id:1$/, out) end def test_multiple_items @stats << event(:item_queued, item_id: 123) @stats << event(:item_queued, item_id: 124) out, _ = capture_io do @display.show end assert_match(/^ *1000000 +A +item_queued +item_id:1$/, out) assert_match(/^ *1000001 +A +item_queued +item_id:2$/, out) end def test_waiting @stats << event(:waiting, item_id: 123) out, _ = capture_io do @display.show end assert_match(/^ *1000000 +A +waiting +item_id:1$/, out) end def test_continue @stats << event(:continue, item_id: 123) out, _ = capture_io do @display.show end assert_match(/^ *1000000 +A +continue +item_id:1$/, out) end def test_thread_deleted @stats << event( :thread_deleted, deleted_thread: 123_456, thread_count: 12) out, _ = capture_io do @display.show end assert_match( /^ *1000000 +A +thread_deleted( +deleted_thread:B| +thread_count:12){2}$/, out) end def test_thread_created @stats << event( :thread_created, new_thread: 123_456, thread_count: 13) out, _ = capture_io do @display.show end assert_match( /^ *1000000 +A +thread_created( +new_thread:B| +thread_count:13){2}$/, out) end private def event(type, data = {}) result = { event: type, time: @time / 1_000_000.0, data: data, thread: Thread.current.object_id } @time += 1 result end end rake-12.3.1/test/test_trace_output.rb000066400000000000000000000022221325463231200176000ustar00rootroot00000000000000# frozen_string_literal: true require File.expand_path("../helper", __FILE__) require "stringio" class TestTraceOutput < Rake::TestCase include Rake::TraceOutput class PrintSpy attr_reader :result, :calls def initialize @result = "".dup @calls = 0 end def print(string) @result << string @calls += 1 end end def test_trace_issues_single_io_for_args_with_empty_args spy = PrintSpy.new trace_on(spy) assert_equal "\n", spy.result assert_equal 1, spy.calls end def test_trace_issues_single_io_for_args_multiple_strings spy = PrintSpy.new trace_on(spy, "HI\n", "LO") assert_equal "HI\nLO\n", spy.result assert_equal 1, spy.calls end def test_trace_handles_nil_objects spy = PrintSpy.new trace_on(spy, "HI\n", nil, "LO") assert_equal "HI\nLO\n", spy.result assert_equal 1, spy.calls end def test_trace_issues_single_io_for_args_multiple_strings_and_alternate_sep old_sep = $\ $\ = "\r" spy = PrintSpy.new trace_on(spy, "HI\r", "LO") assert_equal "HI\rLO\r", spy.result assert_equal 1, spy.calls ensure $\ = old_sep end end