upr-0.3.0/0000755000175000017500000000000012200416053011335 5ustar lunarlunarupr-0.3.0/GIT-VERSION-FILE0000644000175000017500000000002412200416053013537 0ustar lunarlunarGIT_VERSION = 0.3.0 upr-0.3.0/upr.gemspec0000644000175000017500000000214112200416053013506 0ustar lunarlunar# -*- encoding: binary -*- ENV["VERSION"] or abort "VERSION= must be specified" manifest = File.readlines('.manifest').map! { |x| x.chomp! } Gem::Specification.new do |s| s.name = %q{upr} s.version = ENV["VERSION"] s.authors = ["upr hackers"] s.date = Time.now.utc.strftime('%Y-%m-%d') s.description = File.read("README").split(/\n\n/)[1] s.email = %q{upr@librelist.com} s.executables = %w(upr-drb) s.extra_rdoc_files = File.readlines('.document').map! do |x| x.chomp! if File.directory?(x) manifest.grep(%r{\A#{x}/}) elsif File.file?(x) x else nil end end.flatten.compact s.files = manifest s.homepage = %q{http://upr.bogomips.org/} s.summary = %q{Upload Progress for Rack} s.rdoc_options = [ "-Na", "-t", "upr - #{s.summary}" ] s.require_paths = %w(lib) s.rubyforge_project = %q{rainbows} s.add_dependency(%q, '~>0.7') s.add_dependency(%q) # Folks on intranets sharing humongous files can use Unicorn, too # s.add_dependency(%q) # s.licenses = %w(GPLv2 Ruby) # accessor not compatible with older Rubygems end upr-0.3.0/ChangeLog0000644000175000017500000003665712200416053013130 0ustar lunarlunarChangeLog from git://git.bogomips.org/upr.git (0.1.0..0.3.0) commit eb6fa2c2f97794ad5953b6913be53cd2a5e6d17c Author: Eric Wong Date: Tue Jul 9 23:20:07 2013 +0000 upr 0.3.0 - update for Moneta ~> 0.7 * From: Jérémy Bobbio Update Upr::Monitor to use Moneta 0.7 API We need to deactivate the serialization in Moneta so that the assumption (currently used in the tests) that the status object will be the same across the calls to the monitor still hold. commit 3fa5a63b09b9600c1e2a1629fd7be3c5343cc465 Author: Jérémy Bobbio Date: Sun Jun 23 14:31:30 2013 +0200 Update Upr::Monitor to use Moneta 0.7 API We need to deactivate the serialization in Moneta so that the assumption (currently used in the tests) that the status object will be the same across the calls to the monitor still hold. commit 553f9e814f4ffbd021c33b70193c0fd41edb1d2e Author: Eric Wong Date: Mon Jun 21 00:38:08 2010 -0700 README: fix bashism in RDoc :P oops... commit a20beb209d3cca0e2c601dee8658496f26315f58 Author: Eric Wong Date: Mon Jun 21 00:36:22 2010 -0700 update README (remove link for the demo, it's currently down) commit 74c89746c35c5b44a350046ac88e8a6a8aae9cc5 Author: Eric Wong Date: Sun Nov 15 02:57:50 2009 -0800 Rakefile: add RAA update task Should be harder to forget to update this now. commit 1b0eabe60326f4470b1a6d646a84a5eed014f9b2 Author: Eric Wong Date: Sat Nov 14 13:33:26 2009 -0800 ry dahl prefers his name lowercased Update all documentation and comments to reflect that. commit 42d80bbba13655aec55d733df0fe2709b568d6b2 Author: Eric Wong Date: Fri Nov 13 17:45:09 2009 -0800 upr 0.2.0 - twice as good as the first! This release fixes several bugs and adds better compatibility with existing upload progress implementations from other web servers. 'config.gem "upr"' in Rails config/environment should work now that double loads are non-fatal (but still warn). Additionally, better error handling has been added and timeouts increased to reduce the probability of errors due to slow clients. The Rack backend can now generate JSON responses compatible[1] with upload progress modules for both lighttpd and nginx. Additionally, streaming JSON as demonstrated in mongrel_streaming_upload_progress is supported, too. This is a list of upload progress modules we are compatible with: 1. mongrel_upload_progress http://mongrel.rubyforge.org/wiki/UploadProgress 2. jquery-upload-progress http://github.com/drogus/jquery-upload-progress 3. mongrel_streaming_upload_progress http://rubyforge.org/pipermail/mongrel-users/2007-July/003747.html Eric Wong (32): README: fix grammar/speling mistakes README: fix grammar bug (excessive dash) monitor: fix class name in RDoc monitor: add "finish" method input_wrapper: use the new finish methods in backends example/rainbows_config: disable Nagle's algorithm examples/rails_app-2.3.4: fix session verifier 1.9 examples/rails_app-2.3.4: move middleware setup to config.ru examples/rails_app-2.3.4: smaller JavaScript footprint split upr/status out to its own file status: add error? method Clarify license of examples upr/status: add done? method Revert "examples/rails_app-2.3.4: move middleware setup to config.ru" Split out Params and StatusMethods input_wrapper: don't wrap if we don't have to set "encoding: binary" to workaround 1.9 insanity backends: internal API updates/cleanups gemspec: put a hard dependency on Rack add JSON generator input_wrapper: lower default frequency examples/rails: UprStatus reuses expiry in Upr::Monitor Upr::Monitor expiry is 60 seconds Add jQuery-compatible Rails example JSON compatible with Ry Dahl's Ajax.Pull + example Update README example/rails_app-2.3.4: limit compat 1.9 to only 1.9 example/rails_app-2.3.4: UprStatus unit tests tests: add Monitor tests (also reaches into Status) JSON: set no-transform in headers examples/rails_app-2.3.4: show links to different interfaces update README commit 2bec62ccdd65a3e4de7841f5ffa7138646929803 Author: Eric Wong Date: Fri Nov 13 17:43:48 2009 -0800 update README commit 9ad5760a68b07fcc0df79e9ae8e31c56873476ce Author: Eric Wong Date: Fri Nov 13 17:33:35 2009 -0800 examples/rails_app-2.3.4: show links to different interfaces commit 73ebdaf0445beb90a8397ca4a3ac05885b6b89fc Author: Eric Wong Date: Fri Nov 13 10:54:53 2009 -0800 JSON: set no-transform in headers We can't have Rack::Deflater compressing long-pulling JS commit 474f31b22bdc90a1baf0cc5cc5e5a0cf22f5710a Author: Eric Wong Date: Fri Nov 13 01:14:29 2009 -0800 tests: add Monitor tests (also reaches into Status) commit eead1a80dd5fdca57cc8aa0333d249415ba2d85a Author: Eric Wong Date: Fri Nov 13 01:01:58 2009 -0800 example/rails_app-2.3.4: UprStatus unit tests UprStatus.incr now returns the value incremented to be compatible with Upr::Monitor.incr commit f4b44763fa6802543f7d1590719e5aed21e120cd Author: Eric Wong Date: Thu Nov 12 23:13:01 2009 -0800 example/rails_app-2.3.4: limit compat 1.9 to only 1.9 Not 1.8.7, too, since 1.8.7 strings respond to :bytesize each_byte iterators and j.next seem to make 1.8.7 unhappy commit 504ab0d4a4c402a90824aaf3c84ef21707e08ad5 Author: Eric Wong Date: Thu Nov 12 20:01:35 2009 -0800 Update README commit b5419dc0e819550b5db0bc18579d8243477c53f2 Author: Eric Wong Date: Thu Nov 12 19:32:46 2009 -0800 JSON compatible with Ry Dahl's Ajax.Pull + example Ry posted about it here: http://rubyforge.org/pipermail/mongrel-users/2007-July/003747.html This is technically superior compared to all the existing interfaces since it only requires only one, long-running client-side HTTP request. I would imagine it's possible for a JavaScript programmer to be capable of even removing the need for an extra request entirely, I'm not that programmer... commit 701405d00364c63c0efbf11a39368dd2cbee0053 Author: Eric Wong Date: Thu Nov 12 18:49:21 2009 -0800 Add jQuery-compatible Rails example This uses the new Upr::JSON class to generate output. Apparently this is the same format used by Apache, nginx, and lighttpd. Hopefully this will help increase upr adoption. commit ca0493aa6b53a38b6254c29b44982c369ad9757f Author: Eric Wong Date: Thu Nov 12 18:47:50 2009 -0800 Upr::Monitor expiry is 60 seconds Some folks we know have terrible Internet connections commit a00f6fdb9b78a295307bada20f1e0dcaae59ac6d Author: Eric Wong Date: Thu Nov 12 18:43:51 2009 -0800 examples/rails: UprStatus reuses expiry in Upr::Monitor Thou Shalt Not Repeat Thyself. Thou Shalt Not Repeat Thyself. Thou Shalt Not Repeat Thyself. Thou Shalt Not Repeat Thyself. Thou Shalt Not Repeat Thyself. Thou Shalt Not Repeat Thyself. wait... commit 20c4841a76a6a01dd7f0ed761945cdc8e07785d0 Author: Eric Wong Date: Thu Nov 12 18:37:39 2009 -0800 input_wrapper: lower default frequency Backend updates should be pretty cheap, so don't skimp on them since they can help avoid timeouts when connections choke for a little while. commit 743dcad9f6eef3714b1ff63f06c7844c8d869a54 Author: Eric Wong Date: Thu Nov 12 18:36:12 2009 -0800 add JSON generator It currently only barely works with Rails, but the plan is to add full Rack long-polling/streaming support. commit 726d7214083631f384470ef4751328f70afdbd03 Author: Eric Wong Date: Thu Nov 12 17:45:58 2009 -0800 gemspec: put a hard dependency on Rack We use Rack for query string parsing. commit 680a3827db292bcf34ab0aeb773720562866bc3b Author: Eric Wong Date: Thu Nov 12 13:45:10 2009 -0800 backends: internal API updates/cleanups Return values for class methods for Upr::Monitor and UprStatus should synched. Class methods: * error!(upid) method added: sets seen = -1, updates time and returns Status(-like) object * read(upid) no longer updates time * incr(upid, nr) does up increment errored statuses * incr(upid, nr) returns nil on invalid upids * finish(upid) returns nil on invalid upids Additionally the AR example has been updated to include Upr::StatusMethods for instance methods. commit dd08acc53b0f17946b47a7a8f5e6b3f219c218fd Author: Eric Wong Date: Thu Nov 12 13:42:21 2009 -0800 set "encoding: binary" to workaround 1.9 insanity It probably doesn't matter for these modules/classes, but I'd much rather avoid potential surprises in the future. commit f5eae25bad81afcd0e0c11f671a7fa7e12461015 Author: Eric Wong Date: Thu Nov 12 13:38:09 2009 -0800 input_wrapper: don't wrap if we don't have to Clients _must_ will either specify the Content-Length header _or_ "Transfer-Encoding: chunked". This will work around clients that seem to send POST requests with no body at all in them. commit f301f399937f9ff62dc41a9cd8e1ea45b43baa6b Author: Eric Wong Date: Thu Nov 12 13:32:56 2009 -0800 Split out Params and StatusMethods StatusMethods will be reusable in subclasses like the UprStatus ActiveRecord class. Params parsing will be common to both InputWrapper and also to the upcoming Streaming class. commit e71a98deacd25bfaad5b80b0cd505e183933010c Author: Eric Wong Date: Thu Nov 12 12:03:39 2009 -0800 Revert "examples/rails_app-2.3.4: move middleware setup to config.ru" This reverts commit 4770ea6d7a6eaf00cc19bc4fb2afd59071e8cf66. commit a2c054810e035915d1e5ff27afd2b631de6ded0a Author: Eric Wong Date: Thu Nov 12 11:36:58 2009 -0800 upr/status: add done? method Makes it easier to tell if we're done or not commit 81c1f96c2c99d16b211f6b97c6f99ea46dfa9cd0 Author: Eric Wong Date: Thu Nov 12 11:17:26 2009 -0800 Clarify license of examples In short, example code retains their own copyrights commit 6369300ca4171acf6848e2f63b24aa5278c42c1b Author: Eric Wong Date: Thu Nov 12 00:43:36 2009 -0800 status: add error? method We'll define setting seen == -1 to be an error since it's impossible to see -1 bytes. commit a063217a2198769edcc287e662e5c4691c0ae4d0 Author: Eric Wong Date: Wed Nov 11 22:19:42 2009 -0800 split upr/status out to its own file This prevent double loads that seem to be caused by "config.gem" in Rails from messing up due to the Struct re-definition. Of course we'll still warn when the VERSION constant is redefined so people will hopefully see a reason to avoid idiotic double loads... commit 64033a89a8b409a3b71382d8b328aa239caad428 Author: Eric Wong Date: Wed Nov 11 19:51:33 2009 -0800 examples/rails_app-2.3.4: smaller JavaScript footprint We'll be pulling in other JS files, too, so avoid pulling in too much. commit 4770ea6d7a6eaf00cc19bc4fb2afd59071e8cf66 Author: Eric Wong Date: Wed Nov 11 19:29:57 2009 -0800 examples/rails_app-2.3.4: move middleware setup to config.ru config.ru is more obvious and easier to use with non-Rails applications. This is true especially if you want to share the Upr::Monitor object/connection with the upcoming Upr::Streaming JSON application. commit cb90269157aeda3655b1a12ea7be4666c98a5e2c Author: Eric Wong Date: Wed Nov 11 19:27:54 2009 -0800 examples/rails_app-2.3.4: fix session verifier 1.9 Rails 2.3.4 screwed up cookie sessions under Ruby 1.9 ref: https://rails.lighthouseapp.com/projects/8994/tickets/3144 commit 82190a59a79a39fe8ac66073532878506bdc7a35 Author: Eric Wong Date: Wed Nov 11 16:04:08 2009 -0800 example/rainbows_config: disable Nagle's algorithm Less delay gives better interactive response commit ec22a960d443ea846161fc16c78f5a6c4206f95b Author: Eric Wong Date: Wed Nov 11 15:44:03 2009 -0800 input_wrapper: use the new finish methods in backends This provides the ability to add notifications when we finish an upload commit a3977a51ae30fd2856c969e2e7897535715d19c6 Author: Eric Wong Date: Wed Nov 11 15:41:44 2009 -0800 monitor: add "finish" method This lets us finish up connections by setting seen == length when the client is finished uploading. commit 4e1763e8bacdec892b98844ff514d2e505bb6d54 Author: Eric Wong Date: Tue Nov 10 18:12:43 2009 -0800 monitor: fix class name in RDoc commit c0207ddf6c6a578bed27a00c7b0be60ae4a71c8e Author: Eric Wong Date: Tue Nov 10 17:38:57 2009 -0800 README: fix grammar bug (excessive dash) commit d6834bf37c6e334a105f04955d4bbf26ed470156 Author: Eric Wong Date: Tue Nov 10 17:28:08 2009 -0800 README: fix grammar/speling mistakes upr-0.3.0/.manifest0000644000175000017500000000522112200416053013144 0ustar lunarlunar.document .gitignore .manifest COPYING ChangeLog GIT-VERSION-FILE GIT-VERSION-GEN GNUmakefile LICENSE NEWS README Rakefile bin/upr-drb examples/rails_app-2.3.4/Rakefile examples/rails_app-2.3.4/app/controllers/application_controller.rb examples/rails_app-2.3.4/app/controllers/files_controller.rb examples/rails_app-2.3.4/app/controllers/progress_controller.rb examples/rails_app-2.3.4/app/helpers/application_helper.rb examples/rails_app-2.3.4/app/models/upr_status.rb examples/rails_app-2.3.4/app/views/files/index.html.erb examples/rails_app-2.3.4/app/views/files/new.html.erb examples/rails_app-2.3.4/app/views/files/pull.html.erb examples/rails_app-2.3.4/config.ru examples/rails_app-2.3.4/config/boot.rb examples/rails_app-2.3.4/config/database.yml examples/rails_app-2.3.4/config/environment.rb examples/rails_app-2.3.4/config/environments/development.rb examples/rails_app-2.3.4/config/environments/production.rb examples/rails_app-2.3.4/config/environments/test.rb examples/rails_app-2.3.4/config/initializers/new_rails_defaults.rb examples/rails_app-2.3.4/config/initializers/ruby_19_compat.rb examples/rails_app-2.3.4/config/routes.rb examples/rails_app-2.3.4/db/.gitignore examples/rails_app-2.3.4/db/migrate/19700000000000_add_upr_status.rb examples/rails_app-2.3.4/db/seeds.rb examples/rails_app-2.3.4/lib/tasks/upr_status.rake examples/rails_app-2.3.4/log/.gitignore examples/rails_app-2.3.4/public/404.html examples/rails_app-2.3.4/public/422.html examples/rails_app-2.3.4/public/500.html examples/rails_app-2.3.4/public/favicon.ico examples/rails_app-2.3.4/public/javascripts/ajax_pull/ajax_pull.js examples/rails_app-2.3.4/public/javascripts/ajax_pull/prototype-1_5_1.js examples/rails_app-2.3.4/public/javascripts/ajax_pull/upload_progress.js examples/rails_app-2.3.4/public/javascripts/application.js examples/rails_app-2.3.4/public/javascripts/controls.js examples/rails_app-2.3.4/public/javascripts/dragdrop.js examples/rails_app-2.3.4/public/javascripts/effects.js examples/rails_app-2.3.4/public/javascripts/jquery.js examples/rails_app-2.3.4/public/javascripts/jquery.uploadProgress.js examples/rails_app-2.3.4/public/javascripts/prototype.js examples/rails_app-2.3.4/public/javascripts/upr.js examples/rails_app-2.3.4/public/robots.txt examples/rails_app-2.3.4/public/stylesheets/site.css examples/rails_app-2.3.4/rainbows_config.rb examples/rails_app-2.3.4/test/fixtures/upr_statuses.yml examples/rails_app-2.3.4/test/test_helper.rb examples/rails_app-2.3.4/test/unit/upr_status_test.rb lib/upr.rb lib/upr/input_wrapper.rb lib/upr/json.rb lib/upr/monitor.rb lib/upr/params.rb lib/upr/status.rb lib/upr/status_methods.rb local.mk.sample setup.rb test/test_monitor.rb upr.gemspec upr-0.3.0/Rakefile0000644000175000017500000001063312200416053013005 0ustar lunarlunar# -*- encoding: binary -*- # most tasks are in the GNUmakefile which offers better parallelism def tags timefmt = '%Y-%m-%dT%H:%M:%SZ' @tags ||= `git tag -l`.split(/\n/).map do |tag| if %r{\Av[\d\.]+\z} =~ tag header, subject, body = `git cat-file tag #{tag}`.split(/\n\n/, 3) header = header.split(/\n/) tagger = header.grep(/\Atagger /).first body ||= "initial" { :time => Time.at(tagger.split(/ /)[-2].to_i).utc.strftime(timefmt), :tagger_name => %r{^tagger ([^<]+)}.match(tagger)[1].strip, :tagger_email => %r{<([^>]+)>}.match(tagger)[1].strip, :id => `git rev-parse refs/tags/#{tag}`.chomp!, :tag => tag, :subject => subject, :body => body, } end end.compact.sort { |a,b| b[:time] <=> a[:time] } end cgit_url = "http://git.bogomips.org/cgit/upr.git" git_url = ENV['GIT_URL'] || 'git://git.bogomips.org/upr.git' desc 'prints news as an Atom feed' task :news_atom do require 'nokogiri' new_tags = tags[0,10] puts(Nokogiri::XML::Builder.new do feed :xmlns => "http://www.w3.org/2005/Atom" do id! "http://upr.bogomips.org/NEWS.atom.xml" title "upr news" subtitle "Upload Progress for Rack" link! :rel => 'alternate', :type => 'text/html', :href => 'http://upr.bogomips.org/NEWS.html' updated(new_tags.empty? ? "1970-01-01T00:00:00Z" : new_tags.first[:time]) new_tags.each do |tag| entry do title tag[:subject] updated tag[:time] published tag[:time] author { name tag[:tagger_name] email tag[:tagger_email] } url = "#{cgit_url}/tag/?id=#{tag[:tag]}" link! :rel => "alternate", :type => "text/html", :href =>url id! url content({:type => 'text'}, tag[:body]) end end end end.to_xml) end desc 'prints RDoc-formatted news' task :news_rdoc do tags.each do |tag| time = tag[:time].tr!('T', ' ').gsub!(/:\d\dZ/, ' UTC') puts "=== #{tag[:tag].sub(/^v/, '')} / #{time}" puts "" body = tag[:body] puts tag[:body].gsub(/^/sm, " ").gsub(/[ \t]+$/sm, "") puts "" end end desc "print release changelog for Rubyforge" task :release_changes do version = ENV['VERSION'] or abort "VERSION= needed" version = "v#{version}" vtags = tags.map { |tag| tag[:tag] =~ /\Av/ and tag[:tag] }.sort prev = vtags[vtags.index(version) - 1] if prev system('git', 'diff', '--stat', prev, version) or abort $? puts "" system('git', 'log', "#{prev}..#{version}") or abort $? else system('git', 'log', version) or abort $? end end desc "print release notes for Rubyforge" task :release_notes do require 'rubygems' spec = Gem::Specification.load('upr.gemspec') puts spec.description.strip puts "" puts "* #{spec.homepage}" puts "* #{spec.email}" puts "* #{git_url}" _, _, body = `git cat-file tag v#{spec.version}`.split(/\n\n/, 3) print "\nChanges:\n\n" puts body end desc "read news article from STDIN and post to rubyforge" task :publish_news do require 'rubyforge' IO.select([STDIN], nil, nil, 1) or abort "E: news must be read from stdin" msg = STDIN.readlines subject = msg.shift blank = msg.shift blank == "\n" or abort "no newline after subject!" subject.strip! body = msg.join("").strip! rf = RubyForge.new.configure rf.login rf.post_news('rainbows', subject, body) end desc "post to RAA" task :raa_update do require 'rubygems' require 'net/http' require 'net/netrc' rc = Net::Netrc.locate('upr-raa') or abort "~/.netrc not found" password = rc.password p password s = Gem::Specification.load('upr.gemspec') desc = [ s.description.strip ] desc << "" desc << "* #{s.homepage}" desc << "* #{s.email}" desc << "* #{git_url}" desc << "* http://upr-demo.bogomips.org/" desc = desc.join("\n") uri = URI.parse('http://raa.ruby-lang.org/regist.rhtml') form = { :name => s.name, :short_description => s.summary, :version => s.version, :status => 'beta', :owner => s.authors.first, :email => 'upr@bogomips.org', :category_major => 'Library', :category_minor => 'Rack', :url => s.homepage, :download => "http://rubyforge.org/frs/?group_id=8977", :license => "Ruby's", :description_style => 'Plain', :description => desc, :pass => password, :submit => "Update", } res = Net::HTTP.post_form(uri, form) p res puts res.body end upr-0.3.0/local.mk.sample0000644000175000017500000000203612200416053014241 0ustar lunarlunar# this is the local.mk file used by Eric Wong on his dev boxes. # GNUmakefile will source local.mk in the top-level source tree # if it is present. # # This is depends on a bunch of GNU-isms from bash, sed, touch. latest: NEWS @awk 'BEGIN{RS="=== ";ORS=""}NR==2{sub(/\n$$/,"");print RS""$$0 }' $< # publishes docs to http://upr.bogomips.org publish_doc: -git set-file-times $(RM) -r doc $(MAKE) doc $(MAKE) -s latest > doc/LATEST find doc/images doc/js -type f | \ TZ=UTC xargs touch -d '1970-01-01 00:00:00' doc/rdoc.css $(MAKE) doc_gz chmod 644 $$(find doc -type f) rsync -av --delete doc/ dcvr:/srv/upr/ git ls-files | xargs touch # Create gzip variants of the same timestamp as the original so nginx # "gzip_static on" can serve the gzipped versions directly. doc_gz: suf := html js css doc_gz: docs = $(shell find doc -type f ! -regex '^.*\.\(gif\|jpg\|png\|gz\)$$') doc_gz: touch doc/NEWS.atom.xml -d "$$(awk 'NR==1{print $$4,$$5,$$6}' NEWS)" for i in $(docs); do \ gzip --rsyncable -9 < $$i > $$i.gz; touch -r $$i $$i.gz; done upr-0.3.0/.gitignore0000644000175000017500000000024112200416053013322 0ustar lunarlunar*.bundle *.log *.so *.rbc .DS_Store /.config /InstalledFiles /doc /local.mk /test/install-* log/ pkg/ /vendor /NEWS /ChangeLog /.manifest /GIT-VERSION-FILE /man upr-0.3.0/bin/0000755000175000017500000000000012200416053012105 5ustar lunarlunarupr-0.3.0/bin/upr-drb0000755000175000017500000000025712200416053013412 0ustar lunarlunar#!/usr/bin/env ruby require 'drb' require 'upr' url = ARGV.shift or abort "#$0 URL\n e.g.: #$0 druby://0.0.0.0:2999" DRb.start_service(url, Upr::Monitor.new) DRb.thread.join upr-0.3.0/examples/0000755000175000017500000000000012200416053013153 5ustar lunarlunarupr-0.3.0/COPYING0000644000175000017500000004310312200416053012371 0ustar lunarlunar GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Lesser General Public License instead.) You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things. To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. , 1 April 1989 Ty Coon, President of Vice This General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. upr-0.3.0/.document0000644000175000017500000000004212200416053013150 0ustar lunarlunarChangeLog lib LICENSE NEWS README upr-0.3.0/README0000644000175000017500000001122512200416053012216 0ustar lunarlunar= upr - Upload Progress for Rack upr is Rack middleware that allows browser-side upload progress monitoring. It is based on (and should be client-side compatible with) several upload progress modules including ones used by leading web servers. It allows any Moneta backing store in addition to DRb. There is also a packaged example for using an ActiveRecord model for Rails. == Web Server Compatibility While upr is completely Rack::Lint-compatible, upr is only compatible with Rack web servers that support a streaming "rack.input". Currently this is limited to {Rainbows!}[http://rainbows.rubyforge.org/] with a handful of concurrency models: * ThreadSpawn * ThreadPool * Revactor* * FiberSpawn * FiberPool * RevFiberSpawn * ActorSpawn (Rubinius) For use with Revactor, the use of network-based Moneta stores or DRb is only advised if those stores are using Revactor-aware sockets. Likewise, with the *FiberSpawn and FiberPool models, any network based stores should be using the wrapper class {Rainbows::Fiber::IO}[http://rainbows.rubyforge.org/Rainbows/Fiber/IO.html] == JavaScript/CSS/HTML Compatibility The current developer does not react well with GUIs. Thus all (R)HTML, JavaScript and CSS example code was stolen from one of the following: 1. mongrel_upload_progress http://mongrel.rubyforge.org/wiki/UploadProgress 2. jquery-upload-progress http://github.com/drogus/jquery-upload-progress 3. mongrel_streaming_upload_progress http://rubyforge.org/pipermail/mongrel-users/2007-July/003747.html This means our module should also be compatible with any of these interfaces. Contributions to enhance compatibility for more modern things like jQuery and HTML5 are very welcome. We would prefer as much as possible to NOT proliferate new AJAX sub-protocols and use existing ones whenever possible. Our current favorite is the Ajax.Pull JavaScript used in ry dahl's mongrel_streaming_upload_progress because it only requires a one extra HTTP request to pull all the status notifications. == Backend Compatibility We depend on {Moneta}[http://github.com/wycats/moneta], which allows the use of a multitude of key-value stores. We also provide a DRb+Moneta::Memory server to ease transitions from mongrel_upload_progress. Additionally, there is an example for using Rails ActiveRecord as a backend storage mechanism. Cookie-based upload tracking may eventually be used, too (contributions very welcome). == Proxy Compatibility No proxy is required when used with Rainbows! The only incompatible HTTP proxy we know of is nginx. nginx will buffer large requests to the filesystem before sending them to the backend. nginx has its own 3rd-party module for {upload progress}[http://wiki.nginx.org/NginxHttpUploadProgressModule] and may be used instead of upr. Most other HTTP-aware and all TCP-only proxies should be compatible. Disabling Nagle's algorithm in both the Rack web server and proxy is advised for lower latency, especially with stunnel. == Unicorn Compatibility While {Unicorn}[http://unicorn.bogomips.org/] provides the streaming "rack.input" for Rainbows!, using Unicorn with upr is generally NOT recommended. Unicorn only supports fast clients and progress reporting is unnecessary unless clients are uploading files that are hundreds of megabyte in size or larger. == Getting Started gem install upr For Rails, look at the Rails application {example}[http://git.bogomips.org/cgit/upr.git/tree/examples/rails_app-2.3.4] and RDoc. More documentation is on the way. == Disclaimer There is NO WARRANTY whatsoever if anything goes wrong, but let us know and we'll try our best to fix it. == License upr is copyright 2009 by all contributors (see logs in git). It is based on mongrel_upload_progress and carries the same license (Ruby + GPL2). Bundled examples may different Free Software licenses, see the included LICENSE file for details. upr is 100% Free Software. We will never support the proliferation of non-Free browsers or plugins. == Contact All feedback (bug reports, user/development dicussion, patches, pull requests) go to the mailing list/newsgroup. Patches must be sent inline (git format-patch -M + git send-email). No top posting. To subscribe or post to the mailing list, just send an email to upr@librelist.com and follow the instructions in the automated reply. * email: mailto:upr@librelist.com * git: git://git.bogomips.org/upr.git or git://repo.or.cz/upr.git * cgit: http://git.bogomips.org/cgit/upr.git We will adhere to mostly the same conventions for patch submissions as git itself. See the Documentation/SubmittingPatches document distributed with git on on patch submission guidelines to follow. Just don't email the git mailing list with upr patches :) upr-0.3.0/GIT-VERSION-GEN0000755000175000017500000000133412200416053013441 0ustar lunarlunar#!/bin/sh GVF=GIT-VERSION-FILE DEF_VER=v0.3.0 LF=' ' # First see if there is a version file (included in release tarballs), # then try git-describe, then default. if test -f version then VN=$(cat version) || VN="$DEF_VER" elif test -d .git -o -f .git && VN=$(git describe --abbrev=4 HEAD 2>/dev/null) && case "$VN" in *$LF*) (exit 1) ;; v[0-9]*) git update-index -q --refresh test -z "$(git diff-index --name-only HEAD --)" || VN="$VN-dirty" ;; esac then VN=$(echo "$VN" | sed -e 's/-/./g'); else VN="$DEF_VER" fi VN=$(expr "$VN" : v*'\(.*\)') if test -r $GVF then VC=$(sed -e 's/^GIT_VERSION = //' <$GVF) else VC=unset fi test "$VN" = "$VC" || { echo >&2 "GIT_VERSION = $VN" echo "GIT_VERSION = $VN" >$GVF } upr-0.3.0/GNUmakefile0000644000175000017500000000767712200416053013430 0ustar lunarlunar# use GNU Make to run tests in parallel, and without depending on Rubygems all:: RUBY = ruby rake = rake GIT_URL = git://git.bogomips.org/upr.git GIT-VERSION-FILE: .FORCE-GIT-VERSION-FILE @./GIT-VERSION-GEN -include GIT-VERSION-FILE -include local.mk ifdef ruby ifeq ($(RUBY),ruby) $(warning ruby variable is deprecated, use RUBY instead) RUBY = $(ruby) endif endif ifeq ($(RUBY_VERSION),) RUBY_VERSION := $(shell $(RUBY) -e 'puts RUBY_VERSION') endif base_bins := upr-drb bins := $(addprefix bin/, $(base_bins)) install: $(bins) $(prep_setup_rb) $(RM) -r .install-tmp mkdir .install-tmp cp -p bin/* .install-tmp $(RUBY) setup.rb all $(RM) $^ mv .install-tmp/* bin/ $(RM) -r .install-tmp $(prep_setup_rb) setup_rb_files := .config InstalledFiles prep_setup_rb := @-$(RM) $(setup_rb_files);$(MAKE) -C $(ext) clean clean: -$(MAKE) -C $(ext) clean $(RM) $(setup_rb_files) $(t_log) pkg_extra := GIT-VERSION-FILE NEWS ChangeLog manifest: $(pkg_extra) $(RM) .manifest $(MAKE) .manifest .manifest: (git ls-files && \ for i in $@ $(pkg_extra); \ do echo $$i; done) | LC_ALL=C sort > $@+ cmp $@+ $@ || mv $@+ $@ $(RM) $@+ NEWS: GIT-VERSION-FILE $(rake) -s news_rdoc > $@+ mv $@+ $@ SINCE = 0.1.0 ChangeLog: log_range = $(shell test -n "$(SINCE)" && echo v$(SINCE)..) ChangeLog: GIT-VERSION-FILE @echo "ChangeLog from $(GIT_URL) ($(SINCE)..$(GIT_VERSION))" > $@+ @echo >> $@+ git log $(log_range) | sed -e 's/^/ /' >> $@+ mv $@+ $@ news_atom := http://upr.bogomips.org/NEWS.atom.xml cgit_atom := http://git.bogomips.org/cgit/upr.git/atom/?h=master atom = # using rdoc 2.4.1+ doc: .document NEWS ChangeLog rdoc -Na -t "$(shell sed -ne '1s/^= //p' README)" install -m644 COPYING doc/COPYING install -m644 $(shell grep '^[A-Z]' .document) doc/ $(RUBY) -i -p -e \ '$$_.gsub!("",%q{\&$(call atom,$(cgit_atom))})' \ doc/ChangeLog.html $(RUBY) -i -p -e \ '$$_.gsub!("",%q{\&$(call atom,$(news_atom))})' \ doc/NEWS.html doc/README.html $(rake) -s news_atom > doc/NEWS.atom.xml cd doc && ln README.html tmp && mv tmp index.html ifneq ($(VERSION),) rfproject := rainbows rfpackage := upr pkggem := pkg/$(rfpackage)-$(VERSION).gem pkgtgz := pkg/$(rfpackage)-$(VERSION).tgz release_notes := release_notes-$(VERSION) release_changes := release_changes-$(VERSION) release-notes: $(release_notes) release-changes: $(release_changes) $(release_changes): $(rake) -s release_changes > $@+ $(VISUAL) $@+ && test -s $@+ && mv $@+ $@ $(release_notes): GIT_URL=$(GIT_URL) $(rake) -s release_notes > $@+ $(VISUAL) $@+ && test -s $@+ && mv $@+ $@ # ensures we're actually on the tagged $(VERSION), only used for release verify: test x"$(shell umask)" = x0022 git rev-parse --verify refs/tags/v$(VERSION)^{} git diff-index --quiet HEAD^0 test `git rev-parse --verify HEAD^0` = \ `git rev-parse --verify refs/tags/v$(VERSION)^{}` fix-perms: -git ls-tree -r HEAD | awk '/^100644 / {print $$NF}' | xargs chmod 644 -git ls-tree -r HEAD | awk '/^100755 / {print $$NF}' | xargs chmod 755 gem: $(pkggem) install-gem: $(pkggem) gem install $(CURDIR)/$< $(pkggem): manifest fix-perms gem build $(rfpackage).gemspec mkdir -p pkg mv $(@F) $@ $(pkgtgz): distdir = $(basename $@) $(pkgtgz): HEAD = v$(VERSION) $(pkgtgz): manifest fix-perms @test -n "$(distdir)" $(RM) -r $(distdir) mkdir -p $(distdir) tar c `cat .manifest` | (cd $(distdir) && tar x) cd pkg && tar c $(basename $(@F)) | gzip -9 > $(@F)+ mv $@+ $@ package: $(pkgtgz) $(pkggem) release: verify package $(release_notes) $(release_changes) rubyforge add_release -f -n $(release_notes) -a $(release_changes) \ $(rfproject) $(rfpackage) $(VERSION) $(pkggem) rubyforge add_file \ $(rfproject) $(rfpackage) $(VERSION) $(pkgtgz) else gem install-gem: GIT-VERSION-FILE $(MAKE) $@ VERSION=$(GIT_VERSION) endif all:: # no tests :< .PHONY: .FORCE-GIT-VERSION-FILE doc manifest test upr-0.3.0/setup.rb0000644000175000017500000010652612200416053013034 0ustar lunarlunar# -*- encoding: binary -*- # # setup.rb # # Copyright (c) 2000-2005 Minero Aoki # # This program is free software. # You can distribute/modify this program under the terms of # the GNU LGPL, Lesser General Public License version 2.1. # unless Enumerable.method_defined?(:map) # Ruby 1.4.6 module Enumerable alias map collect end end unless File.respond_to?(:read) # Ruby 1.6 def File.read(fname) open(fname) {|f| return f.read } end end unless Errno.const_defined?(:ENOTEMPTY) # Windows? module Errno class ENOTEMPTY # We do not raise this exception, implementation is not needed. end end end def File.binread(fname) open(fname, 'rb') {|f| return f.read } end # for corrupted Windows' stat(2) def File.dir?(path) File.directory?((path[-1,1] == '/') ? path : path + '/') end class ConfigTable include Enumerable def initialize(rbconfig) @rbconfig = rbconfig @items = [] @table = {} # options @install_prefix = nil @config_opt = nil @verbose = true @no_harm = false end attr_accessor :install_prefix attr_accessor :config_opt attr_writer :verbose def verbose? @verbose end attr_writer :no_harm def no_harm? @no_harm end def [](key) lookup(key).resolve(self) end def []=(key, val) lookup(key).set val end def names @items.map {|i| i.name } end def each(&block) @items.each(&block) end def key?(name) @table.key?(name) end def lookup(name) @table[name] or setup_rb_error "no such config item: #{name}" end def add(item) @items.push item @table[item.name] = item end def remove(name) item = lookup(name) @items.delete_if {|i| i.name == name } @table.delete_if {|name, i| i.name == name } item end def load_script(path, inst = nil) if File.file?(path) MetaConfigEnvironment.new(self, inst).instance_eval File.read(path), path end end def savefile '.config' end def load_savefile begin File.foreach(savefile()) do |line| k, v = *line.split(/=/, 2) self[k] = v.strip end rescue Errno::ENOENT setup_rb_error $!.message + "\n#{File.basename($0)} config first" end end def save @items.each {|i| i.value } File.open(savefile(), 'w') {|f| @items.each do |i| f.printf "%s=%s\n", i.name, i.value if i.value? and i.value end } end def load_standard_entries standard_entries(@rbconfig).each do |ent| add ent end end def standard_entries(rbconfig) c = rbconfig rubypath = File.join(c['bindir'], c['ruby_install_name'] + c['EXEEXT']) major = c['MAJOR'].to_i minor = c['MINOR'].to_i teeny = c['TEENY'].to_i version = "#{major}.#{minor}" # ruby ver. >= 1.4.4? newpath_p = ((major >= 2) or ((major == 1) and ((minor >= 5) or ((minor == 4) and (teeny >= 4))))) if c['rubylibdir'] # V > 1.6.3 libruby = "#{c['prefix']}/lib/ruby" librubyver = c['rubylibdir'] librubyverarch = c['archdir'] siteruby = c['sitedir'] siterubyver = c['sitelibdir'] siterubyverarch = c['sitearchdir'] elsif newpath_p # 1.4.4 <= V <= 1.6.3 libruby = "#{c['prefix']}/lib/ruby" librubyver = "#{c['prefix']}/lib/ruby/#{version}" librubyverarch = "#{c['prefix']}/lib/ruby/#{version}/#{c['arch']}" siteruby = c['sitedir'] siterubyver = "$siteruby/#{version}" siterubyverarch = "$siterubyver/#{c['arch']}" else # V < 1.4.4 libruby = "#{c['prefix']}/lib/ruby" librubyver = "#{c['prefix']}/lib/ruby/#{version}" librubyverarch = "#{c['prefix']}/lib/ruby/#{version}/#{c['arch']}" siteruby = "#{c['prefix']}/lib/ruby/#{version}/site_ruby" siterubyver = siteruby siterubyverarch = "$siterubyver/#{c['arch']}" end parameterize = lambda {|path| path.sub(/\A#{Regexp.quote(c['prefix'])}/, '$prefix') } if arg = c['configure_args'].split.detect {|arg| /--with-make-prog=/ =~ arg } makeprog = arg.sub(/'/, '').split(/=/, 2)[1] else makeprog = 'make' end [ ExecItem.new('installdirs', 'std/site/home', 'std: install under libruby; site: install under site_ruby; home: install under $HOME')\ {|val, table| case val when 'std' table['rbdir'] = '$librubyver' table['sodir'] = '$librubyverarch' when 'site' table['rbdir'] = '$siterubyver' table['sodir'] = '$siterubyverarch' when 'home' setup_rb_error '$HOME was not set' unless ENV['HOME'] table['prefix'] = ENV['HOME'] table['rbdir'] = '$libdir/ruby' table['sodir'] = '$libdir/ruby' end }, PathItem.new('prefix', 'path', c['prefix'], 'path prefix of target environment'), PathItem.new('bindir', 'path', parameterize.call(c['bindir']), 'the directory for commands'), PathItem.new('libdir', 'path', parameterize.call(c['libdir']), 'the directory for libraries'), PathItem.new('datadir', 'path', parameterize.call(c['datadir']), 'the directory for shared data'), PathItem.new('mandir', 'path', parameterize.call(c['mandir']), 'the directory for man pages'), PathItem.new('sysconfdir', 'path', parameterize.call(c['sysconfdir']), 'the directory for system configuration files'), PathItem.new('localstatedir', 'path', parameterize.call(c['localstatedir']), 'the directory for local state data'), PathItem.new('libruby', 'path', libruby, 'the directory for ruby libraries'), PathItem.new('librubyver', 'path', librubyver, 'the directory for standard ruby libraries'), PathItem.new('librubyverarch', 'path', librubyverarch, 'the directory for standard ruby extensions'), PathItem.new('siteruby', 'path', siteruby, 'the directory for version-independent aux ruby libraries'), PathItem.new('siterubyver', 'path', siterubyver, 'the directory for aux ruby libraries'), PathItem.new('siterubyverarch', 'path', siterubyverarch, 'the directory for aux ruby binaries'), PathItem.new('rbdir', 'path', '$siterubyver', 'the directory for ruby scripts'), PathItem.new('sodir', 'path', '$siterubyverarch', 'the directory for ruby extentions'), PathItem.new('rubypath', 'path', rubypath, 'the path to set to #! line'), ProgramItem.new('rubyprog', 'name', rubypath, 'the ruby program using for installation'), ProgramItem.new('makeprog', 'name', makeprog, 'the make program to compile ruby extentions'), SelectItem.new('shebang', 'all/ruby/never', 'ruby', 'shebang line (#!) editing mode'), BoolItem.new('without-ext', 'yes/no', 'no', 'does not compile/install ruby extentions') ] end private :standard_entries def load_multipackage_entries multipackage_entries().each do |ent| add ent end end def multipackage_entries [ PackageSelectionItem.new('with', 'name,name...', '', 'ALL', 'package names that you want to install'), PackageSelectionItem.new('without', 'name,name...', '', 'NONE', 'package names that you do not want to install') ] end private :multipackage_entries ALIASES = { 'std-ruby' => 'librubyver', 'stdruby' => 'librubyver', 'rubylibdir' => 'librubyver', 'archdir' => 'librubyverarch', 'site-ruby-common' => 'siteruby', # For backward compatibility 'site-ruby' => 'siterubyver', # For backward compatibility 'bin-dir' => 'bindir', 'bin-dir' => 'bindir', 'rb-dir' => 'rbdir', 'so-dir' => 'sodir', 'data-dir' => 'datadir', 'ruby-path' => 'rubypath', 'ruby-prog' => 'rubyprog', 'ruby' => 'rubyprog', 'make-prog' => 'makeprog', 'make' => 'makeprog' } def fixup ALIASES.each do |ali, name| @table[ali] = @table[name] end @items.freeze @table.freeze @options_re = /\A--(#{@table.keys.join('|')})(?:=(.*))?\z/ end def parse_opt(opt) m = @options_re.match(opt) or setup_rb_error "config: unknown option #{opt}" m.to_a[1,2] end def dllext @rbconfig['DLEXT'] end def value_config?(name) lookup(name).value? end class Item def initialize(name, template, default, desc) @name = name.freeze @template = template @value = default @default = default @description = desc end attr_reader :name attr_reader :description attr_accessor :default alias help_default default def help_opt "--#{@name}=#{@template}" end def value? true end def value @value end def resolve(table) @value.gsub(%r<\$([^/]+)>) { table[$1] } end def set(val) @value = check(val) end private def check(val) setup_rb_error "config: --#{name} requires argument" unless val val end end class BoolItem < Item def config_type 'bool' end def help_opt "--#{@name}" end private def check(val) return 'yes' unless val case val when /\Ay(es)?\z/i, /\At(rue)?\z/i then 'yes' when /\An(o)?\z/i, /\Af(alse)\z/i then 'no' else setup_rb_error "config: --#{@name} accepts only yes/no for argument" end end end class PathItem < Item def config_type 'path' end private def check(path) setup_rb_error "config: --#{@name} requires argument" unless path path[0,1] == '$' ? path : File.expand_path(path) end end class ProgramItem < Item def config_type 'program' end end class SelectItem < Item def initialize(name, selection, default, desc) super @ok = selection.split('/') end def config_type 'select' end private def check(val) unless @ok.include?(val.strip) setup_rb_error "config: use --#{@name}=#{@template} (#{val})" end val.strip end end class ExecItem < Item def initialize(name, selection, desc, &block) super name, selection, nil, desc @ok = selection.split('/') @action = block end def config_type 'exec' end def value? false end def resolve(table) setup_rb_error "$#{name()} wrongly used as option value" end undef set def evaluate(val, table) v = val.strip.downcase unless @ok.include?(v) setup_rb_error "invalid option --#{@name}=#{val} (use #{@template})" end @action.call v, table end end class PackageSelectionItem < Item def initialize(name, template, default, help_default, desc) super name, template, default, desc @help_default = help_default end attr_reader :help_default def config_type 'package' end private def check(val) unless File.dir?("packages/#{val}") setup_rb_error "config: no such package: #{val}" end val end end class MetaConfigEnvironment def initialize(config, installer) @config = config @installer = installer end def config_names @config.names end def config?(name) @config.key?(name) end def bool_config?(name) @config.lookup(name).config_type == 'bool' end def path_config?(name) @config.lookup(name).config_type == 'path' end def value_config?(name) @config.lookup(name).config_type != 'exec' end def add_config(item) @config.add item end def add_bool_config(name, default, desc) @config.add BoolItem.new(name, 'yes/no', default ? 'yes' : 'no', desc) end def add_path_config(name, default, desc) @config.add PathItem.new(name, 'path', default, desc) end def set_config_default(name, default) @config.lookup(name).default = default end def remove_config(name) @config.remove(name) end # For only multipackage def packages raise '[setup.rb fatal] multi-package metaconfig API packages() called for single-package; contact application package vendor' unless @installer @installer.packages end # For only multipackage def declare_packages(list) raise '[setup.rb fatal] multi-package metaconfig API declare_packages() called for single-package; contact application package vendor' unless @installer @installer.packages = list end end end # class ConfigTable # This module requires: #verbose?, #no_harm? module FileOperations def mkdir_p(dirname, prefix = nil) dirname = prefix + File.expand_path(dirname) if prefix $stderr.puts "mkdir -p #{dirname}" if verbose? return if no_harm? # Does not check '/', it's too abnormal. dirs = File.expand_path(dirname).split(%r<(?=/)>) if /\A[a-z]:\z/i =~ dirs[0] disk = dirs.shift dirs[0] = disk + dirs[0] end dirs.each_index do |idx| path = dirs[0..idx].join('') Dir.mkdir path unless File.dir?(path) end end def rm_f(path) $stderr.puts "rm -f #{path}" if verbose? return if no_harm? force_remove_file path end def rm_rf(path) $stderr.puts "rm -rf #{path}" if verbose? return if no_harm? remove_tree path end def remove_tree(path) if File.symlink?(path) remove_file path elsif File.dir?(path) remove_tree0 path else force_remove_file path end end def remove_tree0(path) Dir.foreach(path) do |ent| next if ent == '.' next if ent == '..' entpath = "#{path}/#{ent}" if File.symlink?(entpath) remove_file entpath elsif File.dir?(entpath) remove_tree0 entpath else force_remove_file entpath end end begin Dir.rmdir path rescue Errno::ENOTEMPTY # directory may not be empty end end def move_file(src, dest) force_remove_file dest begin File.rename src, dest rescue File.open(dest, 'wb') {|f| f.write File.binread(src) } File.chmod File.stat(src).mode, dest File.unlink src end end def force_remove_file(path) begin remove_file path rescue end end def remove_file(path) File.chmod 0777, path File.unlink path end def install(from, dest, mode, prefix = nil) $stderr.puts "install #{from} #{dest}" if verbose? return if no_harm? realdest = prefix ? prefix + File.expand_path(dest) : dest realdest = File.join(realdest, File.basename(from)) if File.dir?(realdest) str = File.binread(from) if diff?(str, realdest) verbose_off { rm_f realdest if File.exist?(realdest) } File.open(realdest, 'wb') {|f| f.write str } File.chmod mode, realdest File.open("#{objdir_root()}/InstalledFiles", 'a') {|f| if prefix f.puts realdest.sub(prefix, '') else f.puts realdest end } end end def diff?(new_content, path) return true unless File.exist?(path) new_content != File.binread(path) end def command(*args) $stderr.puts args.join(' ') if verbose? system(*args) or raise RuntimeError, "system(#{args.map{|a| a.inspect }.join(' ')}) failed" end def ruby(*args) command config('rubyprog'), *args end def make(task = nil) command(*[config('makeprog'), task].compact) end def extdir?(dir) File.exist?("#{dir}/MANIFEST") or File.exist?("#{dir}/extconf.rb") end def files_of(dir) Dir.open(dir) {|d| return d.select {|ent| File.file?("#{dir}/#{ent}") } } end DIR_REJECT = %w( . .. CVS SCCS RCS CVS.adm .svn ) def directories_of(dir) Dir.open(dir) {|d| return d.select {|ent| File.dir?("#{dir}/#{ent}") } - DIR_REJECT } end end # This module requires: #srcdir_root, #objdir_root, #relpath module HookScriptAPI def get_config(key) @config[key] end alias config get_config # obsolete: use metaconfig to change configuration def set_config(key, val) @config[key] = val end # # srcdir/objdir (works only in the package directory) # def curr_srcdir "#{srcdir_root()}/#{relpath()}" end def curr_objdir "#{objdir_root()}/#{relpath()}" end def srcfile(path) "#{curr_srcdir()}/#{path}" end def srcexist?(path) File.exist?(srcfile(path)) end def srcdirectory?(path) File.dir?(srcfile(path)) end def srcfile?(path) File.file?(srcfile(path)) end def srcentries(path = '.') Dir.open("#{curr_srcdir()}/#{path}") {|d| return d.to_a - %w(. ..) } end def srcfiles(path = '.') srcentries(path).select {|fname| File.file?(File.join(curr_srcdir(), path, fname)) } end def srcdirectories(path = '.') srcentries(path).select {|fname| File.dir?(File.join(curr_srcdir(), path, fname)) } end end class ToplevelInstaller Version = '3.4.1' Copyright = 'Copyright (c) 2000-2005 Minero Aoki' TASKS = [ [ 'all', 'do config, setup, then install' ], [ 'config', 'saves your configurations' ], [ 'show', 'shows current configuration' ], [ 'setup', 'compiles ruby extentions and others' ], [ 'install', 'installs files' ], [ 'test', 'run all tests in test/' ], [ 'clean', "does `make clean' for each extention" ], [ 'distclean',"does `make distclean' for each extention" ] ] def ToplevelInstaller.invoke config = ConfigTable.new(load_rbconfig()) config.load_standard_entries config.load_multipackage_entries if multipackage? config.fixup klass = (multipackage?() ? ToplevelInstallerMulti : ToplevelInstaller) klass.new(File.dirname($0), config).invoke end def ToplevelInstaller.multipackage? File.dir?(File.dirname($0) + '/packages') end def ToplevelInstaller.load_rbconfig if arg = ARGV.detect {|arg| /\A--rbconfig=/ =~ arg } ARGV.delete(arg) load File.expand_path(arg.split(/=/, 2)[1]) $".push 'rbconfig.rb' else require 'rbconfig' end ::Config::CONFIG end def initialize(ardir_root, config) @ardir = File.expand_path(ardir_root) @config = config # cache @valid_task_re = nil end def config(key) @config[key] end def inspect "#<#{self.class} #{__id__()}>" end def invoke run_metaconfigs case task = parsearg_global() when nil, 'all' parsearg_config init_installers exec_config exec_setup exec_install else case task when 'config', 'test' ; when 'clean', 'distclean' @config.load_savefile if File.exist?(@config.savefile) else @config.load_savefile end __send__ "parsearg_#{task}" init_installers __send__ "exec_#{task}" end end def run_metaconfigs @config.load_script "#{@ardir}/metaconfig" end def init_installers @installer = Installer.new(@config, @ardir, File.expand_path('.')) end # # Hook Script API bases # def srcdir_root @ardir end def objdir_root '.' end def relpath '.' end # # Option Parsing # def parsearg_global while arg = ARGV.shift case arg when /\A\w+\z/ setup_rb_error "invalid task: #{arg}" unless valid_task?(arg) return arg when '-q', '--quiet' @config.verbose = false when '--verbose' @config.verbose = true when '--help' print_usage $stdout exit 0 when '--version' puts "#{File.basename($0)} version #{Version}" exit 0 when '--copyright' puts Copyright exit 0 else setup_rb_error "unknown global option '#{arg}'" end end nil end def valid_task?(t) valid_task_re() =~ t end def valid_task_re @valid_task_re ||= /\A(?:#{TASKS.map {|task,desc| task }.join('|')})\z/ end def parsearg_no_options unless ARGV.empty? task = caller(0).first.slice(%r<`parsearg_(\w+)'>, 1) setup_rb_error "#{task}: unknown options: #{ARGV.join(' ')}" end end alias parsearg_show parsearg_no_options alias parsearg_setup parsearg_no_options alias parsearg_test parsearg_no_options alias parsearg_clean parsearg_no_options alias parsearg_distclean parsearg_no_options def parsearg_config evalopt = [] set = [] @config.config_opt = [] while i = ARGV.shift if /\A--?\z/ =~ i @config.config_opt = ARGV.dup break end name, value = *@config.parse_opt(i) if @config.value_config?(name) @config[name] = value else evalopt.push [name, value] end set.push name end evalopt.each do |name, value| @config.lookup(name).evaluate value, @config end # Check if configuration is valid set.each do |n| @config[n] if @config.value_config?(n) end end def parsearg_install @config.no_harm = false @config.install_prefix = '' while a = ARGV.shift case a when '--no-harm' @config.no_harm = true when /\A--prefix=/ path = a.split(/=/, 2)[1] path = File.expand_path(path) unless path[0,1] == '/' @config.install_prefix = path else setup_rb_error "install: unknown option #{a}" end end end def print_usage(out) out.puts 'Typical Installation Procedure:' out.puts " $ ruby #{File.basename $0} config" out.puts " $ ruby #{File.basename $0} setup" out.puts " # ruby #{File.basename $0} install (may require root privilege)" out.puts out.puts 'Detailed Usage:' out.puts " ruby #{File.basename $0} " out.puts " ruby #{File.basename $0} [] []" fmt = " %-24s %s\n" out.puts out.puts 'Global options:' out.printf fmt, '-q,--quiet', 'suppress message outputs' out.printf fmt, ' --verbose', 'output messages verbosely' out.printf fmt, ' --help', 'print this message' out.printf fmt, ' --version', 'print version and quit' out.printf fmt, ' --copyright', 'print copyright and quit' out.puts out.puts 'Tasks:' TASKS.each do |name, desc| out.printf fmt, name, desc end fmt = " %-24s %s [%s]\n" out.puts out.puts 'Options for CONFIG or ALL:' @config.each do |item| out.printf fmt, item.help_opt, item.description, item.help_default end out.printf fmt, '--rbconfig=path', 'rbconfig.rb to load',"running ruby's" out.puts out.puts 'Options for INSTALL:' out.printf fmt, '--no-harm', 'only display what to do if given', 'off' out.printf fmt, '--prefix=path', 'install path prefix', '' out.puts end # # Task Handlers # def exec_config @installer.exec_config @config.save # must be final end def exec_setup @installer.exec_setup end def exec_install @installer.exec_install end def exec_test @installer.exec_test end def exec_show @config.each do |i| printf "%-20s %s\n", i.name, i.value if i.value? end end def exec_clean @installer.exec_clean end def exec_distclean @installer.exec_distclean end end # class ToplevelInstaller class ToplevelInstallerMulti < ToplevelInstaller include FileOperations def initialize(ardir_root, config) super @packages = directories_of("#{@ardir}/packages") raise 'no package exists' if @packages.empty? @root_installer = Installer.new(@config, @ardir, File.expand_path('.')) end def run_metaconfigs @config.load_script "#{@ardir}/metaconfig", self @packages.each do |name| @config.load_script "#{@ardir}/packages/#{name}/metaconfig" end end attr_reader :packages def packages=(list) raise 'package list is empty' if list.empty? list.each do |name| raise "directory packages/#{name} does not exist"\ unless File.dir?("#{@ardir}/packages/#{name}") end @packages = list end def init_installers @installers = {} @packages.each do |pack| @installers[pack] = Installer.new(@config, "#{@ardir}/packages/#{pack}", "packages/#{pack}") end with = extract_selection(config('with')) without = extract_selection(config('without')) @selected = @installers.keys.select {|name| (with.empty? or with.include?(name)) \ and not without.include?(name) } end def extract_selection(list) a = list.split(/,/) a.each do |name| setup_rb_error "no such package: #{name}" unless @installers.key?(name) end a end def print_usage(f) super f.puts 'Inluded packages:' f.puts ' ' + @packages.sort.join(' ') f.puts end # # Task Handlers # def exec_config run_hook 'pre-config' each_selected_installers {|inst| inst.exec_config } run_hook 'post-config' @config.save # must be final end def exec_setup run_hook 'pre-setup' each_selected_installers {|inst| inst.exec_setup } run_hook 'post-setup' end def exec_install run_hook 'pre-install' each_selected_installers {|inst| inst.exec_install } run_hook 'post-install' end def exec_test run_hook 'pre-test' each_selected_installers {|inst| inst.exec_test } run_hook 'post-test' end def exec_clean rm_f @config.savefile run_hook 'pre-clean' each_selected_installers {|inst| inst.exec_clean } run_hook 'post-clean' end def exec_distclean rm_f @config.savefile run_hook 'pre-distclean' each_selected_installers {|inst| inst.exec_distclean } run_hook 'post-distclean' end # # lib # def each_selected_installers Dir.mkdir 'packages' unless File.dir?('packages') @selected.each do |pack| $stderr.puts "Processing the package `#{pack}' ..." if verbose? Dir.mkdir "packages/#{pack}" unless File.dir?("packages/#{pack}") Dir.chdir "packages/#{pack}" yield @installers[pack] Dir.chdir '../..' end end def run_hook(id) @root_installer.run_hook id end # module FileOperations requires this def verbose? @config.verbose? end # module FileOperations requires this def no_harm? @config.no_harm? end end # class ToplevelInstallerMulti class Installer FILETYPES = %w( bin lib ext data conf man ) include FileOperations include HookScriptAPI def initialize(config, srcroot, objroot) @config = config @srcdir = File.expand_path(srcroot) @objdir = File.expand_path(objroot) @currdir = '.' end def inspect "#<#{self.class} #{File.basename(@srcdir)}>" end def noop(rel) end # # Hook Script API base methods # def srcdir_root @srcdir end def objdir_root @objdir end def relpath @currdir end # # Config Access # # module FileOperations requires this def verbose? @config.verbose? end # module FileOperations requires this def no_harm? @config.no_harm? end def verbose_off begin save, @config.verbose = @config.verbose?, false yield ensure @config.verbose = save end end # # TASK config # def exec_config exec_task_traverse 'config' end alias config_dir_bin noop alias config_dir_lib noop def config_dir_ext(rel) extconf if extdir?(curr_srcdir()) end alias config_dir_data noop alias config_dir_conf noop alias config_dir_man noop def extconf ruby "#{curr_srcdir()}/extconf.rb", *@config.config_opt end # # TASK setup # def exec_setup exec_task_traverse 'setup' end def setup_dir_bin(rel) files_of(curr_srcdir()).each do |fname| update_shebang_line "#{curr_srcdir()}/#{fname}" end end alias setup_dir_lib noop def setup_dir_ext(rel) make if extdir?(curr_srcdir()) end alias setup_dir_data noop alias setup_dir_conf noop alias setup_dir_man noop def update_shebang_line(path) return if no_harm? return if config('shebang') == 'never' old = Shebang.load(path) if old $stderr.puts "warning: #{path}: Shebang line includes too many args. It is not portable and your program may not work." if old.args.size > 1 new = new_shebang(old) return if new.to_s == old.to_s else return unless config('shebang') == 'all' new = Shebang.new(config('rubypath')) end $stderr.puts "updating shebang: #{File.basename(path)}" if verbose? open_atomic_writer(path) {|output| File.open(path, 'rb') {|f| f.gets if old # discard output.puts new.to_s output.print f.read } } end def new_shebang(old) if /\Aruby/ =~ File.basename(old.cmd) Shebang.new(config('rubypath'), old.args) elsif File.basename(old.cmd) == 'env' and old.args.first == 'ruby' Shebang.new(config('rubypath'), old.args[1..-1]) else return old unless config('shebang') == 'all' Shebang.new(config('rubypath')) end end def open_atomic_writer(path, &block) tmpfile = File.basename(path) + '.tmp' begin File.open(tmpfile, 'wb', &block) File.rename tmpfile, File.basename(path) ensure File.unlink tmpfile if File.exist?(tmpfile) end end class Shebang def Shebang.load(path) line = nil File.open(path) {|f| line = f.gets } return nil unless /\A#!/ =~ line parse(line) end def Shebang.parse(line) cmd, *args = *line.strip.sub(/\A\#!/, '').split(' ') new(cmd, args) end def initialize(cmd, args = []) @cmd = cmd @args = args end attr_reader :cmd attr_reader :args def to_s "#! #{@cmd}" + (@args.empty? ? '' : " #{@args.join(' ')}") end end # # TASK install # def exec_install rm_f 'InstalledFiles' exec_task_traverse 'install' end def install_dir_bin(rel) install_files targetfiles(), "#{config('bindir')}/#{rel}", 0755 end def install_dir_lib(rel) install_files libfiles(), "#{config('rbdir')}/#{rel}", 0644 end def install_dir_ext(rel) return unless extdir?(curr_srcdir()) install_files rubyextentions('.'), "#{config('sodir')}/#{File.dirname(rel)}", 0555 end def install_dir_data(rel) install_files targetfiles(), "#{config('datadir')}/#{rel}", 0644 end def install_dir_conf(rel) # FIXME: should not remove current config files # (rename previous file to .old/.org) install_files targetfiles(), "#{config('sysconfdir')}/#{rel}", 0644 end def install_dir_man(rel) install_files targetfiles(), "#{config('mandir')}/#{rel}", 0644 end def install_files(list, dest, mode) mkdir_p dest, @config.install_prefix list.each do |fname| install fname, dest, mode, @config.install_prefix end end def libfiles glob_reject(%w(*.y *.output), targetfiles()) end def rubyextentions(dir) ents = glob_select("*.#{@config.dllext}", targetfiles()) if ents.empty? setup_rb_error "no ruby extention exists: 'ruby #{$0} setup' first" end ents end def targetfiles mapdir(existfiles() - hookfiles()) end def mapdir(ents) ents.map {|ent| if File.exist?(ent) then ent # objdir else "#{curr_srcdir()}/#{ent}" # srcdir end } end # picked up many entries from cvs-1.11.1/src/ignore.c JUNK_FILES = %w( core RCSLOG tags TAGS .make.state .nse_depinfo #* .#* cvslog.* ,* .del-* *.olb *~ *.old *.bak *.BAK *.orig *.rej _$* *$ *.org *.in .* ) def existfiles glob_reject(JUNK_FILES, (files_of(curr_srcdir()) | files_of('.'))) end def hookfiles %w( pre-%s post-%s pre-%s.rb post-%s.rb ).map {|fmt| %w( config setup install clean ).map {|t| sprintf(fmt, t) } }.flatten end def glob_select(pat, ents) re = globs2re([pat]) ents.select {|ent| re =~ ent } end def glob_reject(pats, ents) re = globs2re(pats) ents.reject {|ent| re =~ ent } end GLOB2REGEX = { '.' => '\.', '$' => '\$', '#' => '\#', '*' => '.*' } def globs2re(pats) /\A(?:#{ pats.map {|pat| pat.gsub(/[\.\$\#\*]/) {|ch| GLOB2REGEX[ch] } }.join('|') })\z/ end # # TASK test # TESTDIR = 'test' def exec_test unless File.directory?('test') $stderr.puts 'no test in this package' if verbose? return end $stderr.puts 'Running tests...' if verbose? begin require 'test/unit' rescue LoadError setup_rb_error 'test/unit cannot loaded. You need Ruby 1.8 or later to invoke this task.' end runner = Test::Unit::AutoRunner.new(true) runner.to_run << TESTDIR runner.run end # # TASK clean # def exec_clean exec_task_traverse 'clean' rm_f @config.savefile rm_f 'InstalledFiles' end alias clean_dir_bin noop alias clean_dir_lib noop alias clean_dir_data noop alias clean_dir_conf noop alias clean_dir_man noop def clean_dir_ext(rel) return unless extdir?(curr_srcdir()) make 'clean' if File.file?('Makefile') end # # TASK distclean # def exec_distclean exec_task_traverse 'distclean' rm_f @config.savefile rm_f 'InstalledFiles' end alias distclean_dir_bin noop alias distclean_dir_lib noop def distclean_dir_ext(rel) return unless extdir?(curr_srcdir()) make 'distclean' if File.file?('Makefile') end alias distclean_dir_data noop alias distclean_dir_conf noop alias distclean_dir_man noop # # Traversing # def exec_task_traverse(task) run_hook "pre-#{task}" FILETYPES.each do |type| if type == 'ext' and config('without-ext') == 'yes' $stderr.puts 'skipping ext/* by user option' if verbose? next end traverse task, type, "#{task}_dir_#{type}" end run_hook "post-#{task}" end def traverse(task, rel, mid) dive_into(rel) { run_hook "pre-#{task}" __send__ mid, rel.sub(%r[\A.*?(?:/|\z)], '') directories_of(curr_srcdir()).each do |d| traverse task, "#{rel}/#{d}", mid end run_hook "post-#{task}" } end def dive_into(rel) return unless File.dir?("#{@srcdir}/#{rel}") dir = File.basename(rel) Dir.mkdir dir unless File.dir?(dir) prevdir = Dir.pwd Dir.chdir dir $stderr.puts '---> ' + rel if verbose? @currdir = rel yield Dir.chdir prevdir $stderr.puts '<--- ' + rel if verbose? @currdir = File.dirname(rel) end def run_hook(id) path = [ "#{curr_srcdir()}/#{id}", "#{curr_srcdir()}/#{id}.rb" ].detect {|cand| File.file?(cand) } return unless path begin instance_eval File.read(path), path, 1 rescue raise if $DEBUG setup_rb_error "hook #{path} failed:\n" + $!.message end end end # class Installer class SetupError < StandardError; end def setup_rb_error(msg) raise SetupError, msg end if $0 == __FILE__ begin ToplevelInstaller.invoke rescue SetupError raise if $DEBUG $stderr.puts $!.message $stderr.puts "Try 'ruby #{$0} --help' for detailed usage." exit 1 end end upr-0.3.0/NEWS0000644000175000017500000000617012200416053012040 0ustar lunarlunar=== 0.3.0 / 2013-07-09 23:20 UTC * From: Jérémy Bobbio Update Upr::Monitor to use Moneta 0.7 API We need to deactivate the serialization in Moneta so that the assumption (currently used in the tests) that the status object will be the same across the calls to the monitor still hold. === 0.2.0 / 2009-11-14 01:54 UTC This release fixes several bugs and adds better compatibility with existing upload progress implementations from other web servers. 'config.gem "upr"' in Rails config/environment should work now that double loads are non-fatal (but still warn). Additionally, better error handling has been added and timeouts increased to reduce the probability of errors due to slow clients. The Rack backend can now generate JSON responses compatible[1] with upload progress modules for both lighttpd and nginx. Additionally, streaming JSON as demonstrated in mongrel_streaming_upload_progress is supported, too. This is a list of upload progress modules we are compatible with: 1. mongrel_upload_progress http://mongrel.rubyforge.org/wiki/UploadProgress 2. jquery-upload-progress http://github.com/drogus/jquery-upload-progress 3. mongrel_streaming_upload_progress http://rubyforge.org/pipermail/mongrel-users/2007-July/003747.html Eric Wong (32): README: fix grammar/speling mistakes README: fix grammar bug (excessive dash) monitor: fix class name in RDoc monitor: add "finish" method input_wrapper: use the new finish methods in backends example/rainbows_config: disable Nagle's algorithm examples/rails_app-2.3.4: fix session verifier 1.9 examples/rails_app-2.3.4: move middleware setup to config.ru examples/rails_app-2.3.4: smaller JavaScript footprint split upr/status out to its own file status: add error? method Clarify license of examples upr/status: add done? method Revert "examples/rails_app-2.3.4: move middleware setup to config.ru" Split out Params and StatusMethods input_wrapper: don't wrap if we don't have to set "encoding: binary" to workaround 1.9 insanity backends: internal API updates/cleanups gemspec: put a hard dependency on Rack add JSON generator input_wrapper: lower default frequency examples/rails: UprStatus reuses expiry in Upr::Monitor Upr::Monitor expiry is 60 seconds Add jQuery-compatible Rails example JSON compatible with Ry Dahl's Ajax.Pull + example Update README example/rails_app-2.3.4: limit compat 1.9 to only 1.9 example/rails_app-2.3.4: UprStatus unit tests tests: add Monitor tests (also reaches into Status) JSON: set no-transform in headers examples/rails_app-2.3.4: show links to different interfaces update README === 0.1.0 / 2009-11-11 01:18 UTC Eric Wong (5): initial commit examples/rails: cleanup files when we're done demo: links to and from the demo site, cleanup output demo: make frequency 1 for smoother output update README upr-0.3.0/LICENSE0000644000175000017500000000526612200416053012353 0ustar lunarlunarUpload Progress for Rack (upr) is copyrighted Free Software by all contributors, see the logs in revision control for all of them. Bundled examples in the examples/ directory retain their respective (Free Software) licenses. See copyright headers in individual files for more information. This distribution only includes Free Software. You can redistribute upr it and/or modify it under either the terms of the {GPL2}[http://www.gnu.org/licenses/gpl-2.0.txt] (see link:COPYING) or the conditions below: 1. You may make and give away verbatim copies of the source form of the software without restriction, provided that you duplicate all of the original copyright notices and associated disclaimers. 2. You may modify your copy of the software in any way, provided that you do at least ONE of the following: a) place your modifications in the Public Domain or otherwise make them Freely Available, such as by posting said modifications to Usenet or an equivalent medium, or by allowing the author to include your modifications in the software. b) use the modified software only within your corporation or organization. c) rename any non-standard executables so the names do not conflict with standard executables, which must also be provided. d) make other distribution arrangements with the author. 3. You may distribute the software in object code or executable form, provided that you do at least ONE of the following: a) distribute the executables and library files of the software, together with instructions (in the manual page or equivalent) on where to get the original distribution. b) accompany the distribution with the machine-readable source of the software. c) give non-standard executables non-standard names, with instructions on where to get the original software distribution. d) make other distribution arrangements with the author. 4. You may modify and include the part of the software into any other software (possibly commercial). But some files in the distribution are not written by the author, so that they are not under this terms. 5. The scripts and library files supplied as input to or produced as output from the software do not automatically fall under the copyright of the software, but belong to whomever generated them, and may be sold commercially, and may be aggregated with this software. 6. 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. upr-0.3.0/metadata.yml0000644000175000017500000001177312200416053013651 0ustar lunarlunar--- !ruby/object:Gem::Specification name: upr version: !ruby/object:Gem::Version hash: 19 prerelease: segments: - 0 - 3 - 0 version: 0.3.0 platform: ruby authors: - upr hackers autorequire: bindir: bin cert_chain: [] date: 2013-07-09 00:00:00 Z dependencies: - !ruby/object:Gem::Dependency name: moneta prerelease: false requirement: &id001 !ruby/object:Gem::Requirement none: false requirements: - - ~> - !ruby/object:Gem::Version hash: 5 segments: - 0 - 7 version: "0.7" type: :runtime version_requirements: *id001 - !ruby/object:Gem::Dependency name: rack prerelease: false requirement: &id002 !ruby/object:Gem::Requirement none: false requirements: - - ">=" - !ruby/object:Gem::Version hash: 3 segments: - 0 version: "0" type: :runtime version_requirements: *id002 description: |- upr is Rack middleware that allows browser-side upload progress monitoring. It is based on (and should be client-side compatible with) several upload progress modules including ones used by leading web servers. It allows any Moneta backing store in addition to DRb. There is also a packaged example for using an ActiveRecord model for Rails. email: upr@librelist.com executables: - upr-drb extensions: [] extra_rdoc_files: - ChangeLog - lib/upr.rb - lib/upr/input_wrapper.rb - lib/upr/json.rb - lib/upr/monitor.rb - lib/upr/params.rb - lib/upr/status.rb - lib/upr/status_methods.rb - LICENSE - NEWS - README files: - .document - .gitignore - .manifest - COPYING - ChangeLog - GIT-VERSION-FILE - GIT-VERSION-GEN - GNUmakefile - LICENSE - NEWS - README - Rakefile - bin/upr-drb - examples/rails_app-2.3.4/Rakefile - examples/rails_app-2.3.4/app/controllers/application_controller.rb - examples/rails_app-2.3.4/app/controllers/files_controller.rb - examples/rails_app-2.3.4/app/controllers/progress_controller.rb - examples/rails_app-2.3.4/app/helpers/application_helper.rb - examples/rails_app-2.3.4/app/models/upr_status.rb - examples/rails_app-2.3.4/app/views/files/index.html.erb - examples/rails_app-2.3.4/app/views/files/new.html.erb - examples/rails_app-2.3.4/app/views/files/pull.html.erb - examples/rails_app-2.3.4/config.ru - examples/rails_app-2.3.4/config/boot.rb - examples/rails_app-2.3.4/config/database.yml - examples/rails_app-2.3.4/config/environment.rb - examples/rails_app-2.3.4/config/environments/development.rb - examples/rails_app-2.3.4/config/environments/production.rb - examples/rails_app-2.3.4/config/environments/test.rb - examples/rails_app-2.3.4/config/initializers/new_rails_defaults.rb - examples/rails_app-2.3.4/config/initializers/ruby_19_compat.rb - examples/rails_app-2.3.4/config/routes.rb - examples/rails_app-2.3.4/db/.gitignore - examples/rails_app-2.3.4/db/migrate/19700000000000_add_upr_status.rb - examples/rails_app-2.3.4/db/seeds.rb - examples/rails_app-2.3.4/lib/tasks/upr_status.rake - examples/rails_app-2.3.4/log/.gitignore - examples/rails_app-2.3.4/public/404.html - examples/rails_app-2.3.4/public/422.html - examples/rails_app-2.3.4/public/500.html - examples/rails_app-2.3.4/public/favicon.ico - examples/rails_app-2.3.4/public/javascripts/ajax_pull/ajax_pull.js - examples/rails_app-2.3.4/public/javascripts/ajax_pull/prototype-1_5_1.js - examples/rails_app-2.3.4/public/javascripts/ajax_pull/upload_progress.js - examples/rails_app-2.3.4/public/javascripts/application.js - examples/rails_app-2.3.4/public/javascripts/controls.js - examples/rails_app-2.3.4/public/javascripts/dragdrop.js - examples/rails_app-2.3.4/public/javascripts/effects.js - examples/rails_app-2.3.4/public/javascripts/jquery.js - examples/rails_app-2.3.4/public/javascripts/jquery.uploadProgress.js - examples/rails_app-2.3.4/public/javascripts/prototype.js - examples/rails_app-2.3.4/public/javascripts/upr.js - examples/rails_app-2.3.4/public/robots.txt - examples/rails_app-2.3.4/public/stylesheets/site.css - examples/rails_app-2.3.4/rainbows_config.rb - examples/rails_app-2.3.4/test/fixtures/upr_statuses.yml - examples/rails_app-2.3.4/test/test_helper.rb - examples/rails_app-2.3.4/test/unit/upr_status_test.rb - lib/upr.rb - lib/upr/input_wrapper.rb - lib/upr/json.rb - lib/upr/monitor.rb - lib/upr/params.rb - lib/upr/status.rb - lib/upr/status_methods.rb - local.mk.sample - setup.rb - test/test_monitor.rb - upr.gemspec homepage: http://upr.bogomips.org/ licenses: [] post_install_message: rdoc_options: - -Na - -t - upr - Upload Progress for Rack 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: rainbows rubygems_version: 1.8.24 signing_key: specification_version: 3 summary: Upload Progress for Rack test_files: [] upr-0.3.0/lib/0000755000175000017500000000000012200416053012103 5ustar lunarlunarupr-0.3.0/lib/upr/0000755000175000017500000000000012200416053012711 5ustar lunarlunarupr-0.3.0/lib/upr/status.rb0000644000175000017500000000031312200416053014556 0ustar lunarlunar# -*- encoding: binary -*- require 'upr/status_methods' module Upr # this is what we store in the Moneta-backed monitor class Status < Struct.new(:seen, :length) include StatusMethods end end upr-0.3.0/lib/upr/monitor.rb0000644000175000017500000000242512200416053014730 0ustar lunarlunar# -*- encoding: binary -*- module Upr # Keeps track of the status of all currently processing uploads # This uses any {Moneta}[http://github.com/wycats/moneta] # store to monitor upload progress. # # Usage (in config.ru with Moneta Memory store): # require 'upr' # require 'moneta' # use Upr, :backend => Upr::Monitor.new(Moneta.new(:Memory, :serializer => nil)) # run YourApplication.new class Monitor < Struct.new(:moneta) # nuke anything not read/updated in 60 seconds OPT = { :expires_in => 60 } def initialize(moneta_store = nil) super if moneta_store.nil? self.moneta = Moneta.new(:Memory, :serializer => nil) end end def start(upid, length) moneta.store(upid, Status.new(0, length), OPT) end def read(upid) moneta[upid] end def incr(upid, nr) status = moneta[upid] or return status.seen += nr if status.seen >= 0 moneta.store(upid, status, OPT) end def finish(upid) status = moneta[upid] or return status.length ||= status.seen status.seen = status.length moneta.store(upid, status, OPT) end def error!(upid) status = moneta[upid] or return status.seen = -1 moneta.store(upid, status, OPT) end end end upr-0.3.0/lib/upr/json.rb0000644000175000017500000001023712200416053014212 0ustar lunarlunar# -*- encoding: binary -*- begin require 'json' rescue LoadError raise LoadError, "either json or json-pure is required" end require 'rack' module Upr # JSON protocol based on Lighttpd's mod_uploadprogress # http://trac.lighttpd.net/trac/wiki/Docs:ModUploadProgress class JSON < Struct.new(:frequency, :backend, :upload_id) include Params # We use this in case length is nil when clients send chunked uploads INT_MAX = 0x7fffffff SLEEP_CLASS = defined?(Actor) ? Actor : Kernel # our default response headers, we need to set no-transform to # prevent deflaters from compressing our already-small small input # and also to prevent buffering/corking of the response inside # deflater buffers. RESPONSE_HEADERS = { 'Content-Type' => 'application/json', 'Cache-Control' => 'no-cache, no-transform', } def initialize(options = {}) super(options[:frequency] || 1, options[:backend], options[:upload_id]) # support :drb for compatibility with mongrel_upload_progress if options[:drb] backend and raise ArgumentError, ":backend and :drb are incompatible" require 'drb' DRb.start_service self.backend = DRbObject.new(nil, options[:drb]) elsif String === backend # allow people to use strings in case their backend gets # lazy-loaded (like an ActiveRecord model) self.backend = eval(backend) elsif backend.nil? raise ArgumentError, "backend MUST be specified" end # only for use with rails_proc upload_id.nil? and self.upload_id = options[:env] end def rails_render_options env = upload_id self.upload_id = extract_upload_id(env) text = if Rack::Request.new(env).GET.include?("long") Proc.new { |response,output| each { |line| output.write(line) } } else _once end { :content_type => 'application/json', :text => text } end def _once if status = backend.read(upload_id) if status.done? _json_object(:state => 'done') elsif status.seen == 0 _json_object(:state => 'starting') elsif status.error? _error_msg("upload failed") else _update_msg(status) end else timeout = Time.now + 2 until status = backend.read(upload_id) SLEEP_CLASS.sleep(0.1) return _error_msg("couldn't get status") if Time.now > timeout end _json_object(:state => 'starting') end end # Rack interface reservced for future use with streaming AJAX def call(env) if uid = extract_upload_id(env) _wrap(env, uid) else [ 400, RESPONSE_HEADERS.dup, [ _error_msg("upload_id not given") ] ] end end # Rack interface reservced for future use with streaming AJAX def each(&block) sleeper = defined?(Actor) ? Actor : Kernel timeout = Time.now + 2 eol = ";\n" yield _json_object(:state => 'starting') << eol begin until status = backend.read(upload_id) sleeper.sleep(0.1) break if Time.now > timeout end if status begin yield _update_msg(status) << eol break if status.done? sleeper.sleep(frequency) end while status = backend.read(upload_id) yield _json_object(:state => 'done') << eol else yield _error_msg("couldn't get status") << eol end rescue => e yield _error_msg(e.message) << eol end end # Rack interface reservced for future use with streaming AJAX def _wrap(env, uid) _self = dup _self.upload_id = uid [ 200, RESPONSE_HEADERS.dup, _self ] end def _error_msg(msg) _json_object(:state => 'error', :status => 400, :message => msg) end def _json_object(options) # $stderr.syswrite "#{options.inspect} #{$upr.inspect}\n" options.to_json end def _update_msg(status) raise "client error" if status.error? received = status.seen size = status.length || INT_MAX _json_object(:state => 'uploading', :size => size, :received => received) end end end upr-0.3.0/lib/upr/params.rb0000644000175000017500000000137612200416053014530 0ustar lunarlunar# -*- encoding: binary -*- require 'rack' module Upr module Params # we'll add compatibility for existing upload progress modules # we find here, but under no circumstances will we help # proliferate new and subtly incompatible mechanisms. # X-Progress-ID is used in both lighttpd and nginx (3rd party module) # "upload_id" is used by mongrel_upload_progress def extract_upload_id(env) upid = env['HTTP_X_PROGRESS_ID'] and return upid # can't blindly parse params here since we don't want to read # the POST body if there is one, so only parse stuff in the # query string... params = Rack::Request.new(env).GET env["upr.upload_id"] = params["X-Progress-ID"] || params["upload_id"] end end end upr-0.3.0/lib/upr/input_wrapper.rb0000644000175000017500000000570412200416053016143 0ustar lunarlunar# -*- encoding: binary -*- module Upr # the underlying middlware for for wrapping env["rack.input"], # this should typically be installed before other middlewares # that may wrap env["rack.input"] in the middleware chain. class InputWrapper < Struct.new(:app, :path_info, :frequency, :backend, :input, :pos, :seen, :content_length, :upload_id, :mtime) include Params def initialize(app, options = {}) super(app, Array(options[:path_info] || nil), options[:frequency] || 1, options[:backend]) # support :drb for compatibility with mongrel_upload_progress if options[:drb] backend and raise ArgumentError, ":backend and :drb are incompatible" require 'drb' DRb.start_service self.backend = DRbObject.new(nil, options[:drb]) elsif String === backend # allow people to use strings in case their backend gets # lazy-loaded (like an ActiveRecord model) self.backend = eval(backend) else self.backend ||= Upr::Monitor.new end end def call(env) if path_info.empty? || path_info.include?(env["PATH_INFO"]) # benefit curl users... /\A100-continue\z/i =~ env['HTTP_EXPECT'] and return [ 100, {}, [] ] length = env["CONTENT_LENGTH"] and length = length.to_i chunked = env["TRANSFER_ENCODING"] =~ %r{\Achunked\z}i and length = nil if chunked || (length && length > 0) if uid = extract_upload_id(env) return dup._call(env, uid, length) end end end app.call(env) end def _call(env, uid, length) self.upload_id = uid self.mtime = self.pos = self.seen = 0 self.input = env["rack.input"] env["rack.input"] = self self.content_length = length backend.start(upload_id, length) app.call(env) end def _incr(nr) self.pos += nr _finish if content_length && pos >= content_length if (nr = pos - seen) > 0 && mtime <= (Time.now.to_i - frequency) backend.incr(upload_id, nr) self.seen = pos self.mtime = Time.now.to_i end end def _finish self.seen = backend.finish(upload_id).seen self.content_length ||= self.seen end def size rv = input.size # we had an unknown length and just had to read in everything to get it if content_length.nil? _incr(rv - seen) _finish end rv end def rewind self.pos = 0 input.rewind end def gets rv = input.gets rv.nil? ? _finish : _incr(rv.size) rv end def read(*args) rv = input.read(*args) rv.nil? || rv.size == 0 ? _finish : _incr(rv.size) rv end def each(&block) input.each do |chunk| # usually just a line _incr(chunk.size) yield chunk end _finish end end end upr-0.3.0/lib/upr/status_methods.rb0000644000175000017500000000035312200416053016305 0ustar lunarlunar# -*- encoding: binary -*- module Upr # mixin module for both Upr::Status and UprStatus (AR example module) module StatusMethods def error? seen < 0 end def done? length && seen >= length end end end upr-0.3.0/lib/upr.rb0000644000175000017500000000162612200416053013243 0ustar lunarlunar# -*- encoding: binary -*- require 'moneta' require 'upr/status' module Upr # Upr version number VERSION = '0.3.0' autoload :Monitor, 'upr/monitor' autoload :Params, 'upr/params' autoload :InputWrapper, 'upr/input_wrapper' autoload :JSON, 'upr/json' # Initializes a new instance of Upr::InputWrapper. Usage in config.ru: # # use Upr, :path_info => %w(/upload), # :drb => "druby://192.168.0.1:666", # :frequency => 1 # # This middleware MUST be be loaded before any parameter parsers # like ActionController::ParamsParser in Rails. # # For use in RAILS_ROOT/config/environment.rb, the following # works insdie the Rails::Initializer.run block: # # config.middleware.insert_before('ActionController::ParamsParser', # 'Upr', :path_info => '/', :drb => "druby://192.168.0.1:666") # def self.new(*args) InputWrapper.new(*args) end end upr-0.3.0/test/0000755000175000017500000000000012200416053012314 5ustar lunarlunarupr-0.3.0/test/test_monitor.rb0000644000175000017500000000273312200416053015374 0ustar lunarlunarrequire 'test/unit' require 'upr' class MonitorTest < Test::Unit::TestCase def setup @monitor = Upr::Monitor.new end def test_start_with_length assert_kind_of Upr::Status, @monitor.start('abcde', 5) status = @monitor.read('abcde') assert_equal 5, status.length assert_equal 0, status.seen assert ! status.error? assert ! status.done? end def test_start_without_length assert_kind_of Upr::Status, @monitor.start('abcde', nil) status = @monitor.read('abcde') assert_nil status.length assert_equal 0, status.seen assert ! status.error? assert ! status.done? end def test_to_incr assert_kind_of Upr::Status, @monitor.start('abcde', 5) status = @monitor.incr('abcde', 2) assert_kind_of Upr::Status, status assert_equal 2, status.seen assert ! status.error? assert ! status.done? @monitor.incr('abcde', 3) assert_equal 5, status.seen assert ! status.error? assert status.done? end def test_finish_with_length assert_kind_of Upr::Status, status = @monitor.start('abcde', 5) @monitor.finish('abcde') assert ! status.error? assert status.done? assert_equal 5, status.seen assert_equal 5, status.length end def test_finish_without_length assert_kind_of Upr::Status, status = @monitor.start('abcde', nil) @monitor.finish('abcde') assert ! status.error? assert status.done? assert_equal 0, status.seen assert_equal 0, status.length end end