makerakeworkwell 1.0.0

data.tar.gz.sig

@@ -0,0 +1 @@
+��n=f�OJ�>�&���݇5x��D$:��N/�1՛��9�a.}�dj��%g{n��]�����d�ix�q�����F=�
%"D�����.�?��

data/.autotest

@@ -0,0 +1,26 @@
+# -*- ruby -*-
+
+require "autotest/restart"
+
+Autotest.add_hook :initialize do |at|
+  at.testlib = "minitest/autorun"
+  at.add_exception "tmp"
+
+#   at.extra_files << "../some/external/dependency.rb"
+#
+#   at.libs << ":../some/external"
+#
+#   at.add_exception "vendor"
+#
+#   at.add_mapping(/dependency.rb/) do |f, _|
+#     at.files_matching(/test_.*rb$/)
+#   end
+#
+#   %w(TestA TestB).each do |klass|
+#     at.extra_class_map[klass] = "test/test_misc.rb"
+#   end
+end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/History.txt

@@ -0,0 +1,6 @@
+=== 1.0.0 / 2012-05-25
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,7 @@
+.autotest
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/make/rake/work/well.rb
+test/test_makerakeworkwell.rb

data/README.txt

@@ -0,0 +1,120 @@
+= make
+= rake
+= work
+= well
+
+home :: https://github.com/seattlerb/makerakeworkwell
+rdoc :: http://docs.seattlerb.org/makerakeworkwell
+
+== DESCRIPTION:
+
+make/rake/work/well provides two simple modifications to rake that
+make working with file tasks cleaner, easier, and faster.
+
+== Rationale:
+
+=== FileTask
+
+After extensive discussion with Jim, I believe we've agreed to
+disagree on what rake is and how it should work. To Jim, rake is a
+build tool (ie, a make replacement), plain and simple. I think it's
+grown past that. To me, rake is a task execution engine with built in
+dependency management and a whole lot of helpers to make writing said
+tasks clean and easy. Whether there are files involved or not is less
+of a concern in my mind, but when there are files involved, they often
+seem to be problematic.
+
+As such, make/rake/work/well patches rake to work with files in the
+way that works best for my brain. Specifically, I think that every
+file should map directly to their own dependencies and targets should
+follow the entire tree of dependencies to see if they should rebuild
+or not. For example:
+
+    target1 ---> source1 --+--> required1 ---> required2
+                           |
+    target2 ---> source2 --+
+
+If required2 changes, target1 and target2 should be rebuilt.
+
+Jim would rather see the dependencies modeled in the old-school make
+way:
+
+    target1 --+--> source1
+              |
+              +--> required1
+              |
+              +--> required2
+
+    target2 --+--> source2
+              |
+              +--> required1
+              |
+              +--> required2
+
+This requires a manual expansion of the transitive closure of the
+dependencies. This flattens everything, causes a lot of fan-out, and
+makes it harder to see how things interrelate.
+
+My patches to rake replace FileTask#needed? and FileTask#timestamp to
+cause the scenario described above to work correctly. It uses caching
+to prevent a lot of extra fstats from happening and winds up
+performing at least fast as rake.
+
+I've been using this for the last 6 months in zenweb for very large
+dependency graphs and it has been working great for me.
+
+=== Phony
+
+It also defines a :phony task that you can use as a dependency. Rake
+has very strange notions on how file and non-file based tasks should
+interact. Specifically, file tasks use the timestamp of their
+dependencies to determine whether they should build. Task defines its
+timestamp to be the max its dependencies or Time.now if there are
+none. That forces a file task depending on a non-file-task to always
+build. 
+
+Depending on phony reverses this. This allows file-based tasks
+to use non-file-based tasks as prerequisites without forcing them to
+rebuild. For example:
+
+    task :isolate => :phony
+
+    file "lib/ruby18_parser.rb" => :isolate
+    file "lib/ruby19_parser.rb" => :isolate
+
+I've been using this in ruby_parser for the last 6 months and it
+cleaned up a bunch of confusion as to why my files kept rebuilding
+over and over.
+
+== REQUIREMENTS:
+
+* rake
+
+== INSTALL:
+
+* sudo gem install makerakeworkwell
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) Ryan Davis, seattle.rb
+
+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.

data/Rakefile

@@ -0,0 +1,20 @@
+# -*- ruby -*-
+
+require "rubygems"
+require "hoe"
+
+Hoe.plugin :isolate
+Hoe.plugin :seattlerb
+
+Hoe.spec "makerakeworkwell" do
+  developer "Ryan Davis", "ryand-ruby@zenspider.com"
+
+  dependency "rake", "~> 0.9.2"
+end
+
+task :docs do
+  fonts = '"Courier New", Courier, monospace'
+  sh %(echo 'h1 { font-family: #{fonts}; }' >> doc/rdoc.css)
+end
+
+# vim: syntax=ruby

data/lib/make/rake/work/well.rb

@@ -0,0 +1,45 @@
+
+gem "rake", "~> 0.9.2"
+
+require 'rake'
+
+module MakeRakeWorkWell
+  VERSION = "1.0.0"
+end
+
+module Rake
+  class FileTask
+    alias old_needed? needed?
+    alias old_timestamp timestamp
+
+    def needed?
+      ! File.exist?(name) || timestamp > real_timestamp
+    end
+
+    def real_timestamp
+      File.exist?(name) && File.mtime(name.to_s) || Rake::EARLY
+    end
+
+    def timestamp
+      @timestamp ||=
+        if File.exist?(name)
+          a = File.mtime(name.to_s)
+          b = super unless prerequisites.empty?
+          [a, b].compact.max
+        else
+          Rake::EARLY
+        end
+    end
+  end
+end
+
+##
+# 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.
+
+def (Rake::Task.define_task(:phony)).timestamp
+  Time.at 0
+end

data/test/test_makerakeworkwell.rb

@@ -0,0 +1,8 @@
+require "minitest/autorun"
+require "make/rake/work/well"
+
+class TestMakerakeworkwell < MiniTest::Unit::TestCase
+  def test_sanity
+    flunk "write tests or I will kneecap you"
+  end
+end

metadata

@@ -0,0 +1,159 @@
+--- !ruby/object:Gem::Specification 
+name: makerakeworkwell
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Ryan Davis
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDPjCCAiagAwIBAgIBADANBgkqhkiG9w0BAQUFADBFMRMwEQYDVQQDDApyeWFu
+  ZC1ydWJ5MRkwFwYKCZImiZPyLGQBGRYJemVuc3BpZGVyMRMwEQYKCZImiZPyLGQB
+  GRYDY29tMB4XDTA5MDMwNjE4NTMxNVoXDTEwMDMwNjE4NTMxNVowRTETMBEGA1UE
+  AwwKcnlhbmQtcnVieTEZMBcGCgmSJomT8ixkARkWCXplbnNwaWRlcjETMBEGCgmS
+  JomT8ixkARkWA2NvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALda
+  b9DCgK+627gPJkB6XfjZ1itoOQvpqH1EXScSaba9/S2VF22VYQbXU1xQXL/WzCkx
+  taCPaLmfYIaFcHHCSY4hYDJijRQkLxPeB3xbOfzfLoBDbjvx5JxgJxUjmGa7xhcT
+  oOvjtt5P8+GSK9zLzxQP0gVLS/D0FmoE44XuDr3iQkVS2ujU5zZL84mMNqNB1znh
+  GiadM9GHRaDiaxuX0cIUBj19T01mVE2iymf9I6bEsiayK/n6QujtyCbTWsAS9Rqt
+  qhtV7HJxNKuPj/JFH0D2cswvzznE/a5FOYO68g+YCuFi5L8wZuuM8zzdwjrWHqSV
+  gBEfoTEGr7Zii72cx+sCAwEAAaM5MDcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAw
+  HQYDVR0OBBYEFEfFe9md/r/tj/Wmwpy+MI8d9k/hMA0GCSqGSIb3DQEBBQUAA4IB
+  AQAY59gYvDxqSqgC92nAP9P8dnGgfZgLxP237xS6XxFGJSghdz/nI6pusfCWKM8m
+  vzjjH2wUMSSf3tNudQ3rCGLf2epkcU13/rguI88wO6MrE0wi4ZqLQX+eZQFskJb/
+  w6x9W1ur8eR01s397LSMexySDBrJOh34cm2AlfKr/jokKCTwcM0OvVZnAutaovC0
+  l1SVZ0ecg88bsWHA0Yhh7NFxK1utWoIhtB6AFC/+trM0FQEB/jZkIS8SaNzn96Rl
+  n0sZEf77FLf5peR8TP/PtmIg7Cyqz23sLM4mCOoTGIy5OcZ8TdyiyINUHtb5ej/T
+  FBHgymkyj/AOSqKRIpXPhjC6
+  -----END CERTIFICATE-----
+
+date: 2012-05-25 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 63
+        segments: 
+        - 0
+        - 9
+        - 2
+        version: 0.9.2
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: minitest
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 3
+        - 0
+        version: "3.0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rdoc
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 3
+        - 10
+        version: "3.10"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 3
+        - 0
+        version: "3.0"
+  type: :development
+  version_requirements: *id004
+description: |-
+  make/rake/work/well provides two simple modifications to rake that
+  make working with file tasks cleaner, easier, and faster.
+email: 
+- ryand-ruby@zenspider.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- .autotest
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/make/rake/work/well.rb
+- test/test_makerakeworkwell.rb
+- .gemtest
+homepage: 
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: makerakeworkwell
+rubygems_version: 1.8.17
+signing_key: 
+specification_version: 3
+summary: make/rake/work/well provides two simple modifications to rake that make working with file tasks cleaner, easier, and faster.
+test_files: 
+- test/test_makerakeworkwell.rb

metadata.gz.sig

@@ -0,0 +1 @@
+>�ᤱ�Y��,��JR���,5
o�B!%��J<��X �N��Xf�-Fc�����c