gem_velocity 0.0.7 → 0.0.8

data/README.md

@@ -1,26 +1,30 @@
 # GemVelocity
 
-A way to see gem velocity. Right now it's just aggregated totals.
+A way to see gem velocity. There are three ways you can view graphs. 
 
-So, not a number of downloads each day, but rather just the general timeline of total downloads.
+`AggregatedVelocitator`
+
+`SingleVelocitator`
+
+`MultipleVelocitator`
+
+Some examples are noted below.
 
 ## Note
 
-The data is currently somewhat incorrect, due to inconstancies outlined in:
+There may be some inconstancies. These are outlined in:
 
 [https://gist.github.com/shaiguitar/d2af997b7f58e24fd305](https://gist.github.com/shaiguitar/d2af997b7f58e24fd305)
 
-I'm investigating though with the help of the rubygems team as per [this](https://github.com/rubygems/rubygems.org/pull/606) and will hopefully have some progress soon.
+It seems it happens with older data. I'm investigating though with the help of the rubygems team as per [this](https://github.com/rubygems/rubygems.org/pull/606) and will hopefully have some progress soon.
 
 ## Requirements
 
-It draws graphs. So...you'll need imagemagick/rmagick. I'm sure you'll survive. Any problems with installation let me know and I'll try to help out.
+It draws graphs. So...you'll need imagemagick/rmagick. Any problems with installation let me know and I'll try to help out.
 
-# Example
-
-Here's one: [celluloid](https://gist.github.com/shaiguitar/7e6d95971c5254fa3665)
+There are plans to put it on the web somewhere, so if you wait long enough you may not even need to install it.
 
-Here's some more:
+# Example
 
 <pre>
   velocitator = MultipleVelocitator.new("rails", ["4.0.0","3.2.14","2.3.5"])
@@ -42,14 +46,37 @@ Produces:
 
 ![here](examples/rails-4.0.0-3.2.14-0.9.1.png)
 
+<pre>
+  velocitator = AggregatedVelocitator.new("rails", "4")
+  # matches any version /^4.\d/ etc
+  file = velocitator.graph("/tmp")
+</pre>
+
+Produces:
+
+![here](examples/rails-4.0.1.rc1-4.0.0-4.0.0.rc2-4.0.0.rc1-4.0.0.beta1.png)
+
+Another: [celluloid](https://gist.github.com/shaiguitar/7e6d95971c5254fa3665)
+
+You could do the same with a `SingleVelocitator` as well: 
+
+<pre>
+  velocitator = SingleVelocitator.new("rails", "4.0.0")
+  file = velocitator.graph("/tmp")
+</pre>
+
+That image is left as an excerise to the reader. Actually it's late. But try it and see.
+
 Also, you should be able to pass in max,min values which completes you being able to manipulate the boundries of the graph in question.
 
 ## Web UI
 
 Do you want to see this with ease (Hey, the api is easy. Whatever) on the web at `http://rubygems-velocity.org/gem/rails/4.0.0,3.2.14` or something similar? I could do it, but I need to know it's worth the hassle.
 
+Also, if you have any idea of how you'd like to use it, please leave a comment on the [issue](https://github.com/shaiguitar/gem_velocities/issues/3)
+
 Lemme know.
 
 ## Feedback
 
-Is appreciated! Any (other) ideas?
+Is appreciated! Also, contributions! Any (other) ideas?

data/TODO

@@ -12,3 +12,5 @@ in default_line_datas.
 if rubygems 606 isn't solved, why not just put a total on there and let the inconsistnecies just be with some notice?
 
 rename time_format_str_small alias
+
+swap out gruff_builder to some other composing object of a builder, that can mash up the various velocitators?

data/lib/gem_velocity/velocitators/aggregated_velocitator.rb

@@ -38,11 +38,7 @@ class AggregatedVelocitator < BaseVelocitator
   end
 
   def title
-    "#{@gem_name}: #{@top_level_ver}X"
-  end
-
-  def totals
-    super.map {|x| x[:version_downloads]}.sum
+    "#{@gem_name}: #{@top_level_ver}X\n(downloads: #{num_downloads})"
   end
 
 end

data/lib/gem_velocity/velocitators/base_velocitator.rb

@@ -41,6 +41,11 @@ class BaseVelocitator
     end
   end
 
+  def num_downloads
+    sum = totals.map {|t| t[:version_downloads]}.sum
+    ActiveSupport::NumberHelper.number_to_delimited(sum)
+  end
+
   private
 
   def initialize(gem_name, versions)

data/lib/gem_velocity/velocitators/multiple_velocitator.rb

@@ -18,7 +18,7 @@ class MultipleVelocitator < BaseVelocitator
       :labels => ({1 => time_format_str_small(effective_start_time), (line_datas.first.size-2) => time_format_str_small(effective_end_time) }),
       :max_value => effective_max_value,
       :min_value => effective_min_value,
-      :line_datas => line_datas
+      :line_datas => line_datas,
     }
   end
 

data/lib/gem_velocity/velocitators/single_velocitator.rb

@@ -36,11 +36,7 @@ class SingleVelocitator < BaseVelocitator
   end
 
   def title
-    "#{gem_name}-#{version}"
-  end
-
-  def totals
-    super.first
+    "#{gem_name}-#{version}\n(downloads: #{num_downloads})"
   end
 
 end

data/lib/gem_velocity/version.rb

@@ -1,3 +1,3 @@
 module GemVelocity
-  VERSION = "0.0.7"
+  VERSION = "0.0.8"
 end

data/spec/no_time_cop_spec.rb

@@ -25,11 +25,11 @@ describe 'with no time stubbing', :do_not_use_time_cop do
       # x = Gems.downloads(velocitator.gem_name, velocitator.versions.first, velocitator.effective_date_range.first, velocitator.effective_date_range.last)
       # x.to_a.index{|z| z.last.nonzero?}
       # => 1198
-      velocitator = SingleVelocitator.new("rails", "2.3.5")
       #x.to_a.index{|z| z.last.nonzero?}
+      # FIXME . got local dump of database
       #binding.pry
+     velocitator = SingleVelocitator.new("rails", "2.3.5")
       file = velocitator.graph("/tmp")
-      raise 'wtf'
     end
 
     it "has a shortcut graph method #2" do

data/spec/velocitator_spec.rb

@@ -15,7 +15,7 @@ describe "a Velocitator rendering graphs" do
     # should this be the specific date range values?? aggregated since when? not aggregated?
     velocitator.graph_options[:line_datas].should == [[303, 303, 303, 304, 304]]
 
-    velocitator.graph_options[:title].should == "haml-i18n-extractor-0.0.17"
+    velocitator.graph_options[:title].should == "haml-i18n-extractor-0.0.17\n(downloads: 377)"
     velocitator.graph_options[:labels].should == ({1=>"2013-09-13", (velocitator.line_datas.first.size-2) =>"2013-09-17"})
     velocitator.graph_options[:max_value].should == 306 # the max in the range (time.now)
     velocitator.graph_options[:min_value].should == 0
@@ -60,7 +60,7 @@ describe SingleVelocitator do
 
   it "holds the totals of the gem" do
     velocitator = SingleVelocitator.new("haml-i18n-extractor", "0.0.17")
-    velocitator.totals.should == {:total_downloads=>5355, :version_downloads=>377}
+    velocitator.totals.first[:version_downloads].should eq 377
     #binding.pry
   end
 
@@ -103,7 +103,7 @@ describe MultipleVelocitator do
 
   it "holds the totals of the gem" do
     velocitator = MultipleVelocitator.new("haml-i18n-extractor", ["0.0.17"])
-    velocitator.totals.should eq [{:total_downloads=>5355, :version_downloads=>377}]
+    velocitator.totals.first[:version_downloads].should eq 377
   end
 
   it "sets the earliest start range from to all of the versions info" do

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: gem_velocity
 version: !ruby/object:Gem::Version 
-  hash: 17
+  hash: 15
   prerelease: 
   segments: 
   - 0
   - 0
-  - 7
-  version: 0.0.7
+  - 8
+  version: 0.0.8
 platform: ruby
 authors: 
 - Shai Rosenfeld
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2013-10-19 00:00:00 Z
+date: 2013-10-20 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: gruff
@@ -205,6 +205,7 @@ files:
 - TODO
 - examples/rails-4.0.0-3.2.14-0.9.1.png
 - examples/rails-4.0.0-3.2.14-2.3.5.png
+- examples/rails-4.0.1.rc1-4.0.0-4.0.0.rc2-4.0.0.rc1-4.0.0.beta1.png
 - gem_velocity.gemspec
 - lib/gem_velocity.rb
 - lib/gem_velocity/errors.rb