opal 0.2.2 → 0.3.0

data/.gitignore

@@ -1,12 +1,7 @@
-announcement.txt
-coverage
-doc
-pkg
 .DS_Store
-cappuccino
-opal_spec
-opal_docs
+doc
+/pkg
+/tmp
+*.gem
 .yardoc
-tmp
-.gem
-extras
+

data/LICENSE

@@ -0,0 +1,75 @@
+Copyright (C) 2011 by Adam Beynon
+
+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.
+
+
+
+
+Opalspec based on RSPEC, original license:
+==========================================
+
+Copyright (c) 2005-2010 The RSpec Development Team
+
+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.
+
+
+Opalite contains Sizzle, original license:
+==========================================
+
+MIT License
+----
+
+Copyright (c) 2009 John Resig
+
+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/README.md

@@ -1,4 +1,56 @@
-Vienna: Build tools for opal
-============================
+Opal: Ruby runtime for javascript
+=================================
+
+**Homepage**:      [http://opalscript.org](http://opalscript.org)  
+**Github**:        [http://github.com/adambeynon/opal](http://github.com/adambeynon/opal)  
+
+Description
+-----------
+
+Opal is a ruby runtime and set of core libraries designed to run
+directly on top of javascript. It supports the gem packaging system for
+building ruby ready for the browser. It also uses therubyracer to
+provide a command line REPL and environment for running ruby server-side
+inside a javascript context.
+
+Installation
+------------
+
+Opal is distributed as a gem, so install with:
+
+    $ gem install opal
+
+Alternativley, you may just clone this git repo. No building is
+neccessary.
+
+Usage
+-----
+
+The opal build tools can be used in three ways. As a simple repl, the
+bundler tasks and the simple build tasks.
+
+**1. opal Command-line tool**
+
+In its current form, the `opal` executable is very simple - it provides
+a simple ruby repl that uses therubyracer to provide an embedable
+javascript context. If you have installed the gem, to run the REPL,
+simply type:
+
+    $ opal
+
+or if you have cloned this repository, type:
+
+    $ bin/opal
+
+The REPL can be used like any other repl, and internally each command is
+being compiled into javascript, and run in the context which opal is
+already loaded into.
+
+Changelog
+---------
+
+- **30 March 2011**: 0.3.0 Release
+    - Major redesign of build tools to use v8 for server side opal
+    - Split all opal packages into actual gems
+    - File and Dir classes for both browser and v8 gem runtimes
 
-Vienna is the code name for the build tools for opal. This is actually what the gem is, where as opal are the core libraries. See github.com/adambeynon/opal for the core libraries.

data/Rakefile

@@ -1,163 +1,86 @@
-require 'rubygems'
-require 'rake'
 require 'yard'
 
-begin
-  require 'jeweler'
-  Jeweler::Tasks.new do |gemspec|
-    gemspec.name = "opal"
-    gemspec.summary = "Ruby compiler and runtime for the browser"
-    gemspec.description = "Ruby compiler and runtime for the browser."
-    gemspec.email = "adam@adambeynon.com"
-    gemspec.homepage = "http://opalscript.org"
-    gemspec.authors = ["Adam Beynon"]
-    gemspec.files.include 'opals/opal/**/*'
-  end
-  Jeweler::GemcutterTasks.new
-rescue LoadError
-  puts "Jeweler not available. Install it with: sudo gem install jeweler"
+OPAL_DOC_ROOT = "doc"
+OPAL_DOC_GEMS = "doc/gems"
+OPAL_GIT_REPO = "git@github.com:adambeynon/opal.git"
+
+desc "Rebuild ruby_parser.rb for opal build tools"
+task :parser do
+  %x{racc -E -l lib/opal/ruby/ruby_parser.y -o lib/opal/ruby/ruby_parser.rb}
 end
 
+desc "Requires this development version of opal (not installed one)"
+task :opal do
+  $:.unshift File.join(__FILE__, '..', 'lib')
+  require 'opal'
+end
 
+desc "Builds standalone opal.js file (opal + core + rquery) for the browser"
+task :browser => :opal do
+  gem = Opal::Gem.new File.join(__FILE__, '..', 'gems', 'rquery')
 
-desc "Simple task to require opal gem. Uses local, not installed."
-task :opal_gem do
-  require File.join(File.dirname(__FILE__), 'lib', 'opal')
+  content = gem.bundle :to => 'tmp/opal.js'
 end
 
+desc "Builds spec runner for core lib"
+task :opal_spec => :opal do
+  gem = Opal::Gem.new File.join(__FILE__, '..', 'gems', 'opal')
+  content = gem.bundle
+  File.open('tmp/opal_spec.js', 'w+') { |out| out.write content }
+end
 
+desc "Building example for a simple builder"
+task :simple => :opal do
+  builder = Opal::Builder.new :project_dir => File.join(Dir.getwd, 'tmp'),
+                                :files       => 'testing.rb',
+                                :out         => 'testing.js'
 
-desc "Rebuild ruby parser (using racc)"
-task :ruby_parser do
-  %x{racc -E lib/vienna/builders/ruby/ruby_parser.rb.y -o lib/vienna/builders/ruby/ruby_parser.rb}
+  builder.build
 end
 
-
+desc "Rebuilds the documentation"
+task :doc => ['doc:clean', 'doc:opal', 'doc:gems']
 
 namespace :doc do
-  
-  # rebuild demos
-  desc "Rebuild demos"
-  task :demos => :opal_gem do
-    # every demo uses an index.html file inside of the demos folder
-    base = File.join(File.dirname(__FILE__), 'demos')
-    demos = File.join(base, '**', 'index.html')
-    # we build all demos to vienna/doc/demos
-    Dir.glob(demos).each do |demo|
-      puts "building demo: #{demo}"
-      # path will be (demos/)path(/index.html)
-      path = /^#{Regexp.escape base}\/(.*)\/index\.html$/.match(demo)[1]
-      
-      build_root = File.join(File.dirname(__FILE__), 'doc', 'demos', path)
-      
-      puts build_root
-      project = Vienna::Project.new File.dirname(demo),
-        :build_root => build_root
-      
-      # FIXME: maybe only set options if no Opalfile... some of the CherryKit
-      # apps may want to include some css etc etc, so dont overwrite them?
-      project.options :lib_directories    => [""],
-                      :javascripts_prefix => "",
-                      :copy_html          => true
-      project.build!
-      project.clean!
-      # puts project
-    end
-  end
-  
-  # opal/runtime docs
+  # Opal documentation
   YARD::Rake::YardocTask.new(:opal) do |t|
-    t.files   = ['opals/runtime/**/*.rb']
-    t.files += ['opals/opal/spec/core/**/*.rb']
-    t.files += ['-', 'opals/runtime/docs/**/*.md']
-    t.options = ['-o./doc/opal/']
-    t.options += ['-r./opals/runtime/README.md']
-    t.options += ['-mmarkdown']
-    t.options += ['--title', 'Opal Documentation']
+    t.files   = ['lib/**/*.rb']
+    t.options = ['--title', 'Documentation for Opal', '--markup', 'markdown']
   end
-  
-  # browser docs
-  YARD::Rake::YardocTask.new(:browser) do |t|
-    t.files   = ['opals/browser/**/*.rb']
-    t.options = ['-o./doc/browser/']
-    t.options += ['-r./opals/browser/README.md']
-    t.options += ['-mmarkdown']
-    t.options += ['--title', 'Browser Documentation']
+
+  desc "Clean doc dir ready for rebuilding"
+  task :clean do
+    rm_rf OPAL_DOC_ROOT
   end
-  
-  # all specs
-  namespace :spec do
-    
-    %w{opal browser}.each do |opal|
-      desc "rebuild spec for #{opal}"
-      task opal.to_sym => :opal_gem do
-        opal_root = File.join(File.dirname(__FILE__), 'opals', opal)
-        build_root = File.join(File.dirname(__FILE__), 'doc', opal, 'spec')
-        project = Vienna::Project.new opal_root, :build_root => build_root, :build_mode => :spec
-        
-        project.options :javascript_name    => "spec.js",
-                        :stylesheet_name    => "spec.css",
-                        :build_prefix       => ""
-        
-        project.build!
-        project.clean!
-        
-        # spec html file
-        from = File.join(File.dirname(__FILE__), 'opals', 'spec', 'resources', 'index.html')
-        
-        FileUtils.copy from, File.join(build_root, 'index.html')
+
+  desc "Generate documentation for opal and all gems"
+  task :gems do
+    Dir.mkdir OPAL_DOC_GEMS unless File.exists? OPAL_DOC_GEMS
+
+    %w[core].each do |gem|
+      gem_root = File.join Dir.getwd, 'gems', gem
+      doc_root = File.join gem_root, 'doc'
+      new_doc_root = File.join OPAL_DOC_GEMS, gem
+
+      puts " **#{gem}**"
+      Dir.chdir(gem_root) do
+        system "rake yard"
       end
+
+      mv doc_root, new_doc_root
     end
   end
-end
 
-desc "Rebuild opal.js for deployment"
-task :opal => :opal_gem do
-  opal_root = File.join(File.dirname(__FILE__), 'opals', 'opal', 'browser')
-  build_root = File.join(File.dirname(__FILE__), 'doc')
-  
-  # debug build
-  project = Vienna::Project.new opal_root, :build_mode => :debug, 
-                                           :build_root => build_root
-  
-  project.options :javascripts_prefix => '',
-                  :javascript_name    => 'opal.debug.js',
-                  :bin_file           => nil
-  project.build!
-  project.clean!
-  
-  # release build
-  project = Vienna::Project.new opal_root, :build_mode => :release, 
-                                           :build_root => build_root
-  
-  project.options :javascripts_prefix => '',
-                  :javascript_name    => 'opal.js',
-                  :bin_file           => nil
-  project.build!
-  project.clean!
-  
-  # minify!
-  %x{java -jar extras/compiler.jar --js=doc/opal.js --js_output_file=doc/opal.min.js}
-  
-  
-  # Also place all three into gen directory
-  %w{opal.min.js opal.debug.js}.each do |src|
-    FileUtils.copy "doc/#{src}", "gen/browser/__PROJECT_NAME__/javascripts/#{src}"
+  desc "Push changes to gh-pages branch"
+  task :pages do
+    Dir.chdir(OPAL_DOC_ROOT) do
+      system "git init"
+      system "git add ."
+      system "git commit -a -m 'Update docs for #{Time.now.asctime}'"
+      system "git remote add origin #{OPAL_GIT_REPO}"
+      system "git checkout -b gh-pages"
+      system "git push -f origin gh-pages"
+    end
   end
 end
 
-task :doc => ['doc:browser', 'doc:opal', 'doc:demos'] do
-  # go through each set of generated docs, and replace the style.css file
-  %w{browser opal}.each do |opal|
-    from = File.join(File.dirname(__FILE__), 'yard', 'style.css')
-    to = File.join(File.dirname(__FILE__), 'doc', opal, 'css', 'style.css')
-    FileUtils.copy from, to
-  end
-  
-  # copy our index.html and its necessary css files
-  %w{index.html style.css}.each do |resource|
-    from = File.join File.dirname(__FILE__), 'yard', resource
-    to = File.join(File.dirname(__FILE__), 'doc')
-    FileUtils.copy from, to
-  end
-end

data/bin/opal

@@ -1,13 +1,10 @@
-#!/usr/bin/env ruby -wKU
+#!/usr/bin/env ruby
 
-require File.expand_path(
-  File.join(File.dirname(__FILE__), %w[.. lib opal]))
+lib = File.expand_path(File.dirname(__FILE__) + '/../lib')
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
-Opal.run
+require 'opal'
+require 'opal/command'
+
+Opal::Command.ruby_repl
 
-# begin
-#   require 'rubygems'
-#   require 'v8'
-# rescue Exception
-#   abort "therubyracer not available. Install it with: sudo gem install therubyracer"
-# end

data/gems/core/README.md

@@ -0,0 +1,5 @@
+Core Library
+============
+
+Core ruby libraries for opal.
+

data/gems/core/Rakefile

@@ -0,0 +1,7 @@
+require 'yard'
+
+YARD::Rake::YardocTask.new do |t|
+  t.files   = ['lib/**/*.rb']
+  t.options = ['--title', 'Opal Core Library']
+end
+

data/gems/core/core.gemspec

@@ -0,0 +1,13 @@
+
+Gem::Specification.new do |s|
+  s.name         = "core"
+  s.version      = "0.0.1"
+  s.authors      = ["Adam Beynon"]
+  s.email        = ["adam@adambeynon.com"]
+  s.homepage     = "http://github.com/adambeynon/opal"
+  s.summary      = "Core libraries for opal"
+
+  s.files        = Dir.glob("{bin,lib}/**/*") + %w[README.md]
+  s.require_path = "lib"
+end
+

data/gems/core/lib/core.rb

@@ -0,0 +1,33 @@
+
+module Kernel
+  # Try to load the library or file named `path`. An error is thrown if the
+  # path cannot be resolved.
+  #
+  # @param [String] path The path to load
+  # @return [true, false]
+  def require(path)
+    `VM.require(path);`
+    true
+  end
+end
+
+require 'core/basic_object'
+require 'core/module'
+require 'core/class'
+require 'core/kernel'
+require 'core/top_self'
+require 'core/nil_class'
+require 'core/true_class'
+require 'core/false_class'
+require 'core/array'
+require 'core/numeric'
+require 'core/hash'
+require 'core/error'
+require 'core/string'
+require 'core/symbol'
+require 'core/proc'
+require 'core/range'
+require 'core/file'
+require 'core/dir'
+require 'core/vm'
+