ziya 1.0.0

data/History.txt

@@ -0,0 +1,4 @@
+== 1.0.0 / 2008-03-01
+
+* 1 major enhancement
+  * Birthday!

data/Manifest.txt

@@ -0,0 +1,127 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/ziyafy
+charts/charts.swf
+charts/charts_library/arno.swf
+charts/charts_library/arst.swf
+charts/charts_library/brfl.swf
+charts/charts_library/brno.swf
+charts/charts_library/brst.swf
+charts/charts_library/cl3d.swf
+charts/charts_library/clfl.swf
+charts/charts_library/clno.swf
+charts/charts_library/clp3.swf
+charts/charts_library/cls3.swf
+charts/charts_library/clst.swf
+charts/charts_library/cnno.swf
+charts/charts_library/lnno.swf
+charts/charts_library/mxno.swf
+charts/charts_library/pi3d.swf
+charts/charts_library/pino.swf
+charts/charts_library/pono.swf
+charts/charts_library/scno.swf
+charts/themes/commando/bar_chart.yml
+charts/themes/commando/base_chart.yml
+charts/themes/commando/column_chart.yml
+charts/themes/commando/column_threed_chart.yml
+charts/themes/commando/parallel_threed_column_chart.yml
+charts/themes/commando/pie_chart.yml
+charts/themes/commando/pie_threed_chart.yml
+charts/themes/commando/polar_chart.yml
+charts/themes/commando/stacked_bar_chart.yml
+charts/themes/commando/stacked_column_chart.yml
+charts/themes/commando/stacked_threed_column_chart.yml
+charts/themes/default/bar_chart.yml
+charts/themes/default/base_chart.yml
+charts/themes/default/column_chart.yml
+charts/themes/default/column_threed_chart.yml
+charts/themes/default/parallel_threed_column_chart.yml
+charts/themes/default/pie_chart.yml
+charts/themes/default/pie_threed_chart.yml
+charts/themes/default/polar_chart.yml
+charts/themes/default/stacked_bar_chart.yml
+charts/themes/default/stacked_column_chart.yml
+charts/themes/default/stacked_threed_column_chart.yml
+charts/themes/default/test.yml
+lib/ziya.rb
+lib/ziya/charts/area.rb
+lib/ziya/charts/bar.rb
+lib/ziya/charts/base.rb
+lib/ziya/charts/candle_stick.rb
+lib/ziya/charts/column.rb
+lib/ziya/charts/column_threed.rb
+lib/ziya/charts/floating_bar.rb
+lib/ziya/charts/floating_column.rb
+lib/ziya/charts/line.rb
+lib/ziya/charts/mixed.rb
+lib/ziya/charts/parallel_threed_column.rb
+lib/ziya/charts/pie.rb
+lib/ziya/charts/pie_threed.rb
+lib/ziya/charts/polar.rb
+lib/ziya/charts/scatter.rb
+lib/ziya/charts/stacked_area.rb
+lib/ziya/charts/stacked_bar.rb
+lib/ziya/charts/stacked_column.rb
+lib/ziya/charts/stacked_threed_column.rb
+lib/ziya/components/area.rb
+lib/ziya/components/axis_category.rb
+lib/ziya/components/axis_ticks.rb
+lib/ziya/components/axis_value.rb
+lib/ziya/components/base.rb
+lib/ziya/components/chart_border.rb
+lib/ziya/components/chart_grid_h.rb
+lib/ziya/components/chart_grid_v.rb
+lib/ziya/components/chart_pref.rb
+lib/ziya/components/chart_rect.rb
+lib/ziya/components/chart_transition.rb
+lib/ziya/components/chart_value.rb
+lib/ziya/components/circle.rb
+lib/ziya/components/draw.rb
+lib/ziya/components/image.rb
+lib/ziya/components/legend_label.rb
+lib/ziya/components/legend_rect.rb
+lib/ziya/components/legend_transition.rb
+lib/ziya/components/line.rb
+lib/ziya/components/link.rb
+lib/ziya/components/link_data.rb
+lib/ziya/components/live_update.rb
+lib/ziya/components/rect.rb
+lib/ziya/components/series_color.rb
+lib/ziya/components/series_explode.rb
+lib/ziya/components/series_gap.rb
+lib/ziya/components/series_switch.rb
+lib/ziya/components/text.rb
+lib/ziya/helpers/base_helper.rb
+lib/ziya/utils/logger.rb
+lib/ziya/utils/text.rb
+lib/ziya/version.rb
+lib/ziya/ziya_helper.rb
+spec/charts/base_spec.rb
+spec/charts/chart_type_spec.rb
+spec/components/area_spec.rb
+spec/components/draw_spec.rb
+spec/components/link_spec.rb
+spec/components/series_color_spec.rb
+spec/components/series_explode_spec.rb
+spec/components/series_switch_spec.rb
+spec/helpers/base_helper_spec.rb
+spec/spec_helper.rb
+spec/themes/default/fred.yml
+spec/themes/default/line_chart.yml
+spec/utils/logger_spec.rb
+spec/utils/text_spec.rb
+spec/ziya_helper_spec.rb
+spec/ziya_spec.rb
+tasks/ann.rake
+tasks/annotations.rake
+tasks/doc.rake
+tasks/gem.rake
+tasks/manifest.rake
+tasks/post_load.rake
+tasks/rubyforge.rake
+tasks/setup.rb
+tasks/spec.rake
+tasks/svn.rake
+tasks/test.rake

data/README.txt

@@ -0,0 +1,137 @@
+ziya
+    by Fernand Galiana
+    ziya.rubyforge.org
+
+== DESCRIPTION:
+
+ZiYa allows you to easily display graphs in your ruby based applications by leveraging
+SWF Charts (http://www.maani.us/xml_charts/index.php). This plugin bundles version 4.7
+of the flash library. Incorporating flash graphs in your app relieves the server by
+allowing for delegating graph rendering to the client side. Using this plugin, you will
+be able to easily create great looking charts for your application. You will also be able
+to use the charts has a navigation scheme by embedding various link in the chart components
+thus bring to the table an ideal scheme for reporting and dashboard like applications. Your
+managers will love you for it !!
+
+	Checkout the demo: http://ziya.liquidrail.com
+	Video            : http://www.youtube.com/watch?v=axIMmMHdXzo ( Out of date but you'll get the basics... )
+	Documentation    : http://ziya.liquidrail.com/rdoc ( New docs coming soon... )
+	Forum            : http://groups.google.com/group/ziya-plugin
+
+
+== FEATURES:
+
+*  Allows you to style your charts just like you would an html page using css styles
+   philosophy. Each chart can be associated with a YAML file that allows you to specify
+   preferences based on SWF Charts properties. Chart style sheet reside under 
+   public/charts/themes. By default all styling resides under the 'default' directory.
+   Each chart type may have an associated YAML file. You can either inherit the default
+   styles or define your own by specifying an id when you create your graph. The styles 
+   will cascade thru your graph class hierarchy and override default preferences as you
+   would in a style sheet.
+
+   NOTE: XML/SWF charts are free of charge unless you need to use special features such
+   as embedded links and printing. 
+   The package cost $45 per domain and is well worth the investment.
+
+*  We are leveraging ERB within the YAML file to provide access to the chart state. State
+   can be passed in via the options hash when the graph is generated.
+   You can also define your own methods in helpers/ZiyaHelpers. You can access these
+   helper methods in your style file just like you would in a rails template.
+
+*  Theme support. You can change the appearance and behavior of any charts by introducing
+   new themes under the public/charts/themes directory.
+      
+== SYNOPSIS:
+  
+  When using within a rails application you will need to create a ziya.rb file in your
+  config/initializers directory ( Rails 2.0 )
+  
+  ziya.rb:
+  
+    # Pull in the ZiYa gem framework
+    gem "ziya", "~> 1.0.0"
+    require 'ziya'
+
+    # Initializes the ZiYa Framework
+    Ziya.initialize( :logger      => RAILS_DEFAULT_LOGGER,
+                     :helpers_dir => File.join( File.dirname(__FILE__), %w[.. .. app helpers ziya] ),
+                     :themes_dir  => File.join( File.dirname(__FILE__), %w[.. .. public charts themes]) )  
+  
+   This will initialize the gem. You can log the output to stdout as well using the ZiYa bundled logger
+   or specify a file ie File.join( File.dirname(__FILE__), %w[.. log ziya.log]. If you choose to user the 
+   ZiYa logger, you can specify the :log_level option to either :warn :info :debug or :error.
+   You will need to indicate your themes directory typically located under public/charts/themes or any location
+   you'll choose. Otherwise ZiYa will used the default themes from the gem ie default or commando.
+   Lastly you can specify a custom helper directory :helpers_dir, so you can use helper methods within your 
+   ZiYa stylesheets.
+   
+*  Creating a chart
+   
+   blee_controller.rb
+   
+     class BleeController < ApplicationController
+       helper Ziya::Helper
+       
+       # Callback from the flash movie to get the chart's data
+       def load_chart
+         chart = Ziya::Charts::Bar.new
+         chart.add( :axis_category_text, %w[2006 2007 2008] )
+         chart.add( :series, "Dogs", [10,20,30] )
+         chart.add( :series, "Cats", [5,15,25] )
+         
+         respond_to do |fmt|
+          fmt.xml => { render :xml => chart.to_xml }
+       end
+     end
+     
+   blee/index.html.erb
+   
+   <!-- Setups up flash in the html template -->
+   <%= ziya_chart load_chart_url, :size => "300x200" -%>
+   
+   config/route.rb
+   
+   # Creates a named route for the chart.
+   map.load_chart '/blee/load_chart', :controller => 'blee', :action => 'load_chart'
+   
+== REQUIREMENTS:
+
+  ZiYa depends on the logging gem version > 0.7.1  
+
+== INSTALL:
+
+  sudo gem install ziya
+  
+  cd to your application directory and issue the following command
+  
+  > ziyafy
+  
+  This will copy the necessary themes and flash files to run ziya in your application 
+  public/charts directory.
+
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 FIXME (different license?)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,45 @@
+# Look in the tasks/setup.rb file for the various options that can be
+# configured in this Rakefile. The .rake files in the tasks directory
+# are where the options are used.
+
+load 'tasks/setup.rb'
+
+ensure_in_path 'lib'
+require 'ziya'      
+require 'ziya/version'
+                   
+task :default => 'spec:run'
+
+PROJ.name           = 'ziya'
+PROJ.authors        = 'Fernand Galiana'
+PROJ.email          = 'fernand@liquidrail.com'
+PROJ.url            = 'http://ziya.rubyforge.org'
+PROJ.rubyforge_name = 'ziya'            
+PROJ.description    = "Easily add charting to your rails/merb applications"
+PROJ.spec_opts      << '--color'
+PROJ.rcov_dir       = ENV['CC_BUILD_ARTIFACTS']  ? "#{ENV['CC_BUILD_ARTIFACTS']}/test_coverage" : 'coverage'  
+PROJ.rdoc_dir       = ENV['CC_BUILD_ARTIFACTS']  ? "#{ENV['CC_BUILD_ARTIFACTS']}/api_docs" : 'docs'  
+PROJ.ruby_opts      = %w[-W0]
+PROJ.version        = ::Ziya::Version.version
+PROJ.svn            = 'ziya'
+PROJ.rcov_threshold = 90.0
+PROJ.executables    = ['ziyafy']
+
+PROJ.exclude        << %w[.DS_Store$ .swo$ .swp$]
+PROJ.tests          = FileList['test/**/test_*.rb']   
+PROJ.annotation_tags << 'BOZO'
+
+desc "Clean up artifact directories"
+task :clean do    
+  rcov_artifacts = File.join( File.dirname( __FILE__ ), "coverage" )
+  FileUtils.rm_rf rcov_artifacts if File.exists? rcov_artifacts
+  rdoc_artifacts = File.join( File.dirname( __FILE__ ), "docs" )
+  FileUtils.rm_rf rdoc_artifacts if File.exists? rdoc_artifacts  
+  gem_artifacts = File.join( File.dirname( __FILE__ ), "pkg" )
+  FileUtils.rm_rf gem_artifacts if File.exists? gem_artifacts    
+end  
+
+task 'gem:package' => 'manifest:assert'
+
+                
+depend_on "logging", "= 0.7.1"

data/bin/ziyafy

@@ -0,0 +1,51 @@
+#!/usr/bin/env ruby            
+require 'optparse'
+require 'ostruct'
+
+require File.expand_path( File.join(File.dirname(__FILE__), '..', 'lib', 'ziya') )
+    
+module Ziya
+  class Ziyafy  
+    # Copy necessary ZiYa components to a ruby web application
+    def initialize( argv=ARGV ) 
+      option_parser = default_option_parser 
+      option_parser.parse!(argv)
+      puts "Installing ZiYa artifacts in `#{options.public_dir}"        
+      copy_artifacts
+    end                  
+          
+    # copies ziya artifacts to public app directory
+    def copy_artifacts
+      source_dir = File.expand_path( File.join( File.dirname(__FILE__), %w[.. charts]) )
+      FileUtils.cp_r( source_dir, options.public_dir )
+    end
+    
+    # access the options
+    def options  #:nodoc:
+      if not @options then      
+        @options = OpenStruct.new 
+        # Unless specified copy artifacts to the public directory
+        @options.public_dir = File.join( Dir.pwd, %w[public] )
+      end
+      return @options
+    end
+
+    # sets up cmd line args
+    def default_option_parser #:nodoc:
+      OptionParser.new do |op|
+        op.separator ""
+        op.separator "Ziyafy options"
+
+        op.on( "-p", "--public_dir FILE", "The location of the public app directory." ) do |dir|
+          options.public_dir = dir
+        end
+        op.separator ""
+      end
+    end   
+  end
+end  
+
+Ziya::Ziyafy.new(ARGV)
+
+
+    

data/charts/themes/commando/bar_chart.yml

@@ -0,0 +1,9 @@
+<%= chart :bar %>
+  <%=component :chart_border %>
+    left_thickness:   2
+    
+  <%=component :chart_grid_h %>
+    thickness: 1
+  
+  <%=component :chart_grid_v %>
+    thickness: 5    

data/charts/themes/commando/base_chart.yml

@@ -0,0 +1,65 @@
+<%= chart :base %> 
+  <%=component :axis_category %>
+    size:   10
+    color:  61332b
+    bold:   true
+    alpha:  100
+  
+  <%=component :axis_value %>
+    color:       a79d91
+    skip:        0
+    alpha:       100
+    size:        10
+        
+  <%=component :chart_rect %>
+    positive_color: f8af68      
+    positive_alpha: 40
+    negative_color: f88868
+    negative_alpha: 40
+
+  <%=component :legend_rect %>
+    fill_color: f8af68
+    fill_alpha: 40
+          
+  <%=component :axis_ticks %>
+    major_color: 54544c
+    minor_color: a19d91
+    value_ticks: true
+    
+  <%=component :chart_border %>
+    left_thickness:   2
+    bottom_thickness: 1
+    top_thickness:    1
+    right_thickness:  1 
+  
+  <%=component :chart_grid_h %>
+    thickness: 1
+    color:     000000
+    alpha:     7
+  
+  <%=component :chart_grid_v %>
+    thickness: 3
+    color:     000000
+    alpha:     7
+  
+  <%=component :chart_transition %>
+    type:     none
+    order:    category  
+    duration: 0.2
+  
+  <%=component :chart_value %>
+    position: right
+    color:    F5F0BE
+    size:     9
+    alpha:    100
+  
+  <%=component :legend_label %>
+    color:    000000
+    size:     10
+    
+  <%=component :legend_transition %>
+    color: 00ff00  
+    type:  none  
+      
+  <%=component :series_color %>
+    colors: 5f5a38,f8af68,4e6b49,e99e57