xpcomcore-rubygem 0.3.2 → 0.5.0

data/README.rdoc

@@ -1,18 +0,0 @@
-= xpcomcore-rubygem
-
-Description goes here.
-
-== Note on Patches/Pull Requests
- 
-* Fork the project.
-* Make your feature addition or bug fix.
-* Add tests for it. This is important so I don't break it in a
-  future version unintentionally.
-* Commit, do not mess with rakefile, version, or history.
-  (if you want to have your own version, that is fine but
-   bump version in a commit by itself I can ignore when I pull)
-* Send me a pull request. Bonus points for topic branches.
-
-== Copyright
-
-Copyright (c) 2009 ggironda. See LICENSE for details.

data/bin/xpcomcore-firefox

@@ -1,4 +0,0 @@
-#!/usr/bin/env ruby
-require 'pathname'
-ENV['XPCOMCORE_BOOTSTRAP'] = (Pathname(__FILE__).parent.parent + "xpcomcore/bootstrapper.js").expand_path.to_s
-exec("firefox-bin", *ARGV)

data/bin/xpcomcore-rubygem-install

@@ -1,205 +0,0 @@
-#!/usr/bin/env ruby
-require 'rubygems'
-require 'sys/uname'
-require 'pathname'
-require 'optparse'
-require 'rexml/document'
-require 'fileutils'
-
-class XPCOMCoreRubyGemInstaller
-  attr_accessor :no_dry_run, :install_global, :install_local, :fix_path
-  
-  KnownAppIds = {'Firefox' => '{ec8030f7-c20a-464f-9b0e-13a3a9e97384}'}
-  KnownVendors = %w[Mozilla]
-  ScriptName = Pathname(__FILE__).basename
-  SysName = Sys::Uname.sysname.downcase.to_sym
-  InstallPathBuilders = {:linux => {}, :darwin => {}}
-  GeckoCommands = %w[firefox-bin firefox xulrunner-bin]
-  ProfilePath = Pathname("~/.profile").expand_path
-  
-  # Linux install path builders
-  InstallPathBuilders[:linux][:global] = [
-    lambda {|vendor,app,extension| Pathname("/usr/lib") + vendor + "extensions" + app + extension },
-    lambda {|vendor,app,extension| Pathname("/usr/lib64") + vendor + "extensions" + app + extension },
-    lambda {|vendor,app,extension| Pathname("/usr/share") + vendor + "extensions" + app + extension }
-  ]
-  InstallPathBuilders[:linux][:local] = [
-    lambda {|vendor,app,extension| Pathname("~/.#{vendor}") + "extensions" + app + extension }
-  ]
-  
-  # Mac OS X install path builders
-  InstallPathBuilders[:darwin][:global] = [
-    lambda {|vendor,app,extension| Pathname("/Library/Application Support") + vendor + "Extensions" + app + extension }
-  ]
-  InstallPathBuilders[:darwin][:local] = [
-    lambda {|vendor,app,extension| Pathname("~/Library/Application Support") + vendor + "Extensions" + app + extension }
-  ]
-
-  GeckoLocations = {:linux => [], :darwin => []}
-  GeckoLocations[:darwin] << Pathname("/Applications/Firefox.app/Contents/MacOS/firefox-bin")
-  GeckoLocations[:darwin] << Pathname("/Library/Frameworks/XUL.framework/xulrunner-bin")
-  
-  def initialize(args, options = {})
-    @args = args
-    @options = options
-    @option_parser = OptionParser.new do |opts|
-      opts.banner = "Usage: #{ScriptName} [options]"
-      opts.on("--install-global", "Install the XPCOMCore gem bootstrap code globally.", method(:install_global=))
-      opts.on("--install-local", "Install the XPCOMCore gem bootstrap code for the current user only.", method(:install_local=))
-      opts.on("--fix-path", "Checks the path for an executable Gecko installation and fixes it if necessary.", method(:fix_path=))
-      opts.on("--do-it", "By default, we do a dry run and show the user what would happen. This forces the actual install.", method(:no_dry_run=))
-    end
-  end
-
-  def dry_run?
-    !no_dry_run
-  end
-  
-  def go!
-    @option_parser.parse(@args)
-    install_opts = {:install_global => install_global, :install_local => install_local}
-    if !install_opts.values.any?
-      puts @option_parser
-      exit(1)
-    end
-    read_install_manifest
-    install_opts.each do |opt_name,value|
-      send(:"do_#{opt_name}") if value
-      log("All done!.")
-    end
-  rescue OptionParser::InvalidOption => e
-    invalid_option(e)
-  end
-
-private
-
-  def invalid_option(exception)
-    puts exception.message
-    puts @option_parser
-    exit(1)
-  end
-  
-  def do_install_global
-    do_install(:global) && rewrite_path
-  end
-  
-  def do_install_local
-    do_install(:local) && rewrite_path
-  end
-  
-  def do_install(scope)
-    each_vendor_and_app_name_and_app_id do |vendor, app_name, app_id|
-      if install_extension(scope, vendor, app_id)
-        next(true)
-      else
-        log("No app install location for application '#{app_name}' by vendor '#{vendor}' exists. Skipping.")
-        next(false)
-      end
-    end.any?
-  end
-  
-  def each_vendor_and_app_name_and_app_id
-    KnownVendors.each do |vendor_name|
-      KnownAppIds.each do |app_name, app_id|
-        yield(vendor_name, app_name, app_id)
-      end
-    end
-  end
-  
-  def install_extension(scope, vendor, app_id)
-    raise "Couldn't read extension id from install manifest" if extension_id.empty?
-    InstallPathBuilders[SysName][scope].select do |path_builder|
-      log("Performing a #{scope} install...")
-      install_path = path_builder[vendor, app_id, extension_id].expand_path
-      if !install_path.parent.exist?
-        log("Directory '#{install_path.parent}' doesn't exist - skipping installation to this location.")
-        next(false)
-      else
-        copy_extension_to(install_path)
-        next(true)
-      end
-    end.any?
-  end
-  
-  def read_install_manifest
-    manifest_contents = (@options[:extension_path] + "install.rdf").read
-    @install_manifest = REXML::Document.new(manifest_contents)
-  end
-  
-  def extension_path
-    @options[:extension_path]
-  end
-  
-  def extension_id
-    @extension_id ||= @install_manifest.root.elements["Description/em:id"].text
-  end
-  
-  def copy_extension_to(install_path)
-    if install_path.parent.writable?
-      log("Copying '#{extension_path}' to '#{install_path}'")
-      copy_dir(extension_path, install_path)
-    else
-      log("Path '#{install_path}' isn't writable. Maybe you need to run this as root and try again if installing globally?")
-    end
-  end
-  
-  def log(str)
-    puts("#{dry_run? ? "[DRY RUN]" : "[INSTALLER]"} #{str}")
-  end
-  
-  def copy_dir(src_path, install_path)
-    return false if dry_run?
-    FileUtils.cp_r(src_path.expand_path.to_s + "/.", install_path.to_s)
-  end
-  
-  def rewrite_path
-    return false unless fix_path
-    gecko_available = check_path
-    rewrite_profile unless gecko_available
-  end
-  
-  def check_path
-    GeckoCommands.collect do |cmd|
-      `#{cmd} -v 2>/dev/null`
-      $? == 0
-    end.any?
-  end
-  
-  def rewrite_profile
-    log("I couldn't find any of '#{GeckoCommands.join(", ")}'. Doing my best attempt to rectify this.")
-    send(:"rewrite_profile_for_#{SysName}")
-  end
-  
-  def rewrite_profile_for_linux
-    log("Sorry. You're on your own here. Check your distribution's documentation for details - for example, Firefox may be installed under a different name.")
-  end
-  
-  def rewrite_profile_for_darwin
-    loc = GeckoLocations[:darwin].detect {|p| p.exist?}
-    unless loc
-      log("I can't find Firefox installed on your system. Sorry.")
-      exit(1)
-    end
-    log("Awesome. I found a Gecko installation at '#{loc}'. Rewriting your .profile to include this in the $PATH.")
-    rewrite_path_with_location(loc.parent)
-  end
-  
-  def rewrite_path_with_location(path_entry)
-    profile_entry = %Q[PATH="#{path_entry}:$PATH"]
-    log("Adding .profile entry: #{profile_entry}")
-    if dry_run?
-      log("Not adding an entry due to running in dry run mode.")
-    else
-      ProfilePath.open("a") do |io|
-        io << "\n"
-        io.puts("# This and the following lines automatically added by xpcomcore-rubygem on #{Time.now}.")
-        io.puts(profile_entry)
-      end
-      log(".profile entry added. You may need to source your .profile again or log in and out for it to take effect.")
-    end
-  end
-  
-end
-
-installer = XPCOMCoreRubyGemInstaller.new(ARGV, :extension_path => (Pathname(__FILE__).parent.parent + "extension").expand_path)
-installer.go!

data/extension/README.txt

@@ -1 +0,0 @@
-This extension was installed by xpcomcore-rubygem. See http://github.com/gabrielg/xpcomcore-rubygem or http://conflagrationjs.org for details.

data/extension/install.rdf

@@ -1,16 +0,0 @@
-<?xml version="1.0"?>
-
-<RDF xmlns="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:em="http://www.mozilla.org/2004/em-rdf#">
-  <Description about="urn:mozilla:install-manifest">
-    <em:id>xpcomcorebootstrapper@conflagrationjs.org</em:id>
-    <em:version>0.1.0</em:version>
-    <em:type>2</em:type>
-    <em:targetApplication>
-      <Description>
-        <em:id>toolkit@mozilla.org</em:id> 
-        <em:minVersion>1.9.0</em:minVersion>
-      </Description>
-    </em:targetApplication>
-    <em:name>XPCOMCore Bootstrapper Extension</em:name>
-  </Description>
-</RDF>

data/xpcomcore/etc/jsdoc-toolkit/README.txt

@@ -1,186 +0,0 @@
-======================================================================
-
-DESCRIPTION:
-
-This is the source code for JsDoc Toolkit, an automatic documentation
-generation tool for JavaScript. It is written in JavaScript and is run
-from a command line (or terminal) using the Java and Mozilla's Rhino
-JavaScript runtime engine.
-
-Using this tool you can automatically turn JavaDoc-like comments in
-your JavaScript source code into published output files, such as HTML
-or XML.
-
-For more information, to report a bug, or to browse the technical
-documentation for this tool please visit the official JsDoc Toolkit
-project homepage at http://code.google.com/p/jsdoc-toolkit/
-
-For the most up-to-date documentation on JsDoc Toolkit see the 
-official wiki at http://code.google.com/p/jsdoc-toolkit/w/list
-
-======================================================================
-
-REQUIREMENTS:
-
-JsDoc Toolkit is known to work with:
-java version "1.6.0_03"
-Java(TM) SE Runtime Environment (build 1.6.0_03-b05)
-on Windows XP,
-and java version "1.5.0_13"
-Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_13-b05-241)
-on Mac OS X 10.4.
-
-Other versions of java may or may not work with JsDoc Toolkit.
-
-======================================================================
-
-USAGE:
-
-Running JsDoc Toolkit requires you to have Java installed on your
-computer. For more information see http://www.java.com/getjava/
-
-Before running the JsDoc Toolkit app you should change your current
-working directory to the jsdoc-toolkit folder. Then follow the
-examples below, or as shown on the project wiki.
-
-On a computer running Windows a valid command line to run JsDoc
-Toolkit might look like this:
-
-> java -jar jsrun.jar app\run.js -a -t=templates\jsdoc mycode.js
-
-On Mac OS X or Linux the same command would look like this:
-
-$ java -jar jsrun.jar app/run.js -a -t=templates/jsdoc mycode.js
-
-The above assumes your current working directory contains jsrun.jar,
-the "app" and "templates" subdirectories from the standard JsDoc
-Toolkit distribution and that the relative path to the code you wish
-to document is "mycode.js".
-
-The output documentation files will be saved to a new directory named
-"out" (by default) in the current directory, or if you specify a
--d=somewhere_else option, to the somewhere_else directory.
-
-For help (usage notes) enter this on the command line:
-
-$ java -jar jsrun.jar app/run.js --help
-
-More information about the various command line options used by JsDoc
-Toolkit are available on the project wiki.
-
-======================================================================
-
-RUNNING VIA SHELL SCRIPT
-
-Avi Deitcher has contributed the file jsrun.sh with the following usage notes:
-
-A script to simplify running jsdoc from the command-line, especially when
-running from within a development or build environment such as ant.
-
-Normally, to run jsdoc, you need a command-line as the following:
-java -Djsdoc.dir=/some/long/dir/path/to/jsdoc -jar
-/some/long/dir/path/to/jsdoc/jsrun.jar /some/long/dir/path/to/jsdoc/app/run.js
--t=template -r=4 /some/long/dir/path/to/my/src/code
-
-This can get tedious to redo time and again, and difficult to use from within a
-build environment.
-
-To simplify the process, jsrun.sh will automatically run this path, as well as
-passing through any arguments.
-
-Usage: jsrun.sh <run.js arguments>
-
-All <run.js arguments> will be passed through.
-Additionally, jsrun.sh will take the following actions:
-1) If the environment variable JSDOCDIR is set, it will add
-"-Djsdoc.dir=$JSDOCDIR" to the command-line
-2) If the environment variable JSDOCTEMPLATEDIR is set, it will add
-"-Djsdoc.template.dir=$JSDOCTEMPLATEDIR" to the command-line
-3) java with the appropriate path to jsrun.jar and run.js will be instantiated
-
-If not variables are set, it is assumed that the path to jsrun.jar and app/ is
-in the current working directory.
-
-Example:
-# jsrun.sh ./src/
-Assuming JSDOCDIR=/some/path/to/my/jsdoc will cause the following command to
-execute:
-java -Djsdoc.dir=/some/path/to/my/jsdoc -jar /some/path/to/my/jsdoc/jsrun.jar
-/some/path/to/my/jsdoc/app/run.js ./src/
-
-======================================================================
-
-TESTING:
-
-To run the suite of unit tests included with JsDoc Toolkit enter this
-on the command line:
-
-$ java -jar jsrun.jar app/run.js -T
-
-To see a dump of the internal data structure that JsDoc Toolkit has
-built from your source files use this command:
-
-$ java -jar jsrun.jar app/run.js mycode.js -Z
-
-======================================================================
-
-LICENSE:
-
-JSDoc.pm
-
-This project is based on the JSDoc.pm tool, created by Michael
-Mathews and Gabriel Reid. More information on JsDoc.pm can
-be found on the JSDoc.pm homepage: http://jsdoc.sourceforge.net/
-
-Complete documentation on JsDoc Toolkit can be found on the project
-wiki at http://code.google.com/p/jsdoc-toolkit/w/list
-
-Rhino
-
-Rhino (JavaScript in Java) is open source and licensed by Mozilla
-under the MPL 1.1 or later/GPL 2.0 or later licenses, the text of
-which is available at http://www.mozilla.org/MPL/
-
-You can obtain the source code for Rhino from the Mozilla web site at
-http://www.mozilla.org/rhino/download.html
-
-JsDoc Toolkit is a larger work that uses the Rhino JavaScript engine
-but is not derived from it in any way. The Rhino library is used 
-without modification and without any claims whatsoever.
-
-The Rhino Debugger
-
-You can obtain more information about the Rhino Debugger from the 
-Mozilla web site at http://www.mozilla.org/rhino/debugger.html
-
-JsDoc Toolkit is a larger work that uses the Rhino Debugger but
-is not derived from it in any way. The Rhino Debugger is used
-without modification and without any claims whatsoever.
-
-JsDoc Toolkit
-
-All code specific to JsDoc Toolkit are free, open source and licensed
-for use under the X11/MIT License.
-
-JsDoc Toolkit is Copyright (c)2009 Michael Mathews <micmath@gmail.com>
-
-This program is free software; you can redistribute it and/or
-modify it under the terms below.
-
-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 must 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/xpcomcore/etc/jsdoc-toolkit/app/frame.js

@@ -1,33 +0,0 @@
-IO.include("frame/Opt.js");
-IO.include("frame/Chain.js");
-IO.include("frame/Link.js");
-IO.include("frame/String.js");
-IO.include("frame/Hash.js");
-IO.include("frame/Namespace.js");
-//IO.include("frame/Reflection.js");
-
-/** A few helper functions to make life a little easier. */
-
-function defined(o) {
-	return (o !== undefined);
-}
-
-function copy(o) { // todo check for circular refs
-	if (o == null || typeof(o) != 'object') return o;
-	var c = new o.constructor();
-	for(var p in o)	c[p] = copy(o[p]);
-	return c;
-}
-
-function isUnique(arr) {
-	var l = arr.length;
-	for(var i = 0; i < l; i++ ) {
-		if (arr.lastIndexOf(arr[i]) > i) return false;
-	}
-	return true;
-}
-
-/** Returns the given string with all regex meta characters backslashed. */
-RegExp.escapeMeta = function(str) {
-	return str.replace(/([$^\\\/()|?+*\[\]{}.-])/g, "\\$1");
-}