pindah 0.1.0.alpha

data/History.txt

@@ -0,0 +1,6 @@
+=== 0.1.0 / ??
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,11 @@
+History.txt
+Manifest.txt
+README.md
+Rakefile
+bin/pindah
+lib/pindah.rb
+lib/pindah_cli.rb
+templates/initial_activity.mirah
+templates/build.xml
+test/fixtures/HelloWorld.mirah
+test/pindah_cli_test.rb

data/README.md

@@ -0,0 +1,61 @@
+# pindah
+
+A tool for writing Android applications in [Mirah](http://mirah.org).
+
+## Requirements
+
+You must have the [Android SDK](http://d.android.com/sdk/) installed
+with the <tt>tools/</tt> directory placed on your $PATH. Inside
+<tt>tools/</tt>, the <tt>android</tt> program will allow you to
+download "platform" packages corresponding with Android versions you
+wish to develop against. You'll need to install "Android SDK Platform
+tools" and at least one platform revision to get started. At the time
+of this writing, Android 2.1 (revision 7)
+[covers most of the market](http://developer.android.com/resources/dashboard/platform-versions.html)
+and is a reasonable target for new applications. Once the platform
+tools are installed, place the SDK's <tt>platform-tools/</tt>
+directory on your $PATH as well.
+
+You'll also need [JRuby](http://jruby.org) installed with bin/ on your
+$PATH. If your gem and rake are not from from JRuby, prefix the gem
+and rake commands with jruby -S:
+
+    $ gem install pindah
+
+## Usage
+
+See [Garrett](http://github.com/technomancy/Garrett) for an example of
+basic usage.
+
+TODO: project template creation is not complete
+
+    $ pindah hello.world hello_world [HelloActivity]
+
+    $ cd hello_world && tree
+
+    [TODO: project skeleton listing]
+
+    $ rake -T
+    
+    rake clean      # Removes output files created by other targets.
+    rake compile    # Compiles project's .mirah files into .class files
+    rake debug      # Builds the application and signs it with a debug key.
+    rake install    # Installs/reinstalls the debug package onto a running     ...
+    rake javac      # Compiles R.java and other gen/ files.
+    rake logcat     # Tail logs from a device or a device or emulator
+    rake release    # Builds the application.
+    rake spec       # Print the project spec
+    rake uninstall  # Uninstalls the application from a running emulator or dev...
+
+## See Also
+
+If Mirah is just too low-level and you need something more dynamic,
+you can try [Ruboto](https://github.com/ruboto/ruboto-core/), though
+be warned there is a very significant overhead it brings with it from
+JRuby's runtime.
+
+## License
+
+Released under the Apache 2.0 license.
+
+Copyright (c) 2011 Phil Hagelberg, Nick Plante, J.D. Huntington

data/Rakefile

@@ -0,0 +1,20 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+
+Hoe.spec 'pindah' do |h|
+  developer('Phil Hagelberg', 'technomancy@gmail.com')
+  h.url = "http://github.com/mirah/pindah"
+  h.readme_file = "README.md"
+  h.summary = "A tool for writing Android applications in Mirah"
+  extra_deps << ["mirah", ">= 0.0.5"]
+end
+
+# vim: syntax=ruby
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/**/*.rb']
+  t.verbose = true
+end

data/bin/pindah

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'pindah_cli'))
+begin
+  PindahCLI.create *ARGV
+rescue ArgumentError
+  puts "Usage: #{File.basename(__FILE__)} org.mirah.HelloWorld ~/hello_world [HelloActivity]"
+end
+
+abort "TODO: create project skeleton: rakefile, manifest, resources"

data/lib/pindah.rb

@@ -0,0 +1,90 @@
+require "rake"
+require "fileutils"
+require "pp"
+require "erb"
+
+begin
+  require 'ant'
+rescue LoadError
+  abort 'This Rakefile requires JRuby. Please use jruby -S rake.'
+end
+
+require "mirah"
+
+module Pindah
+  VERSION = '0.1.0.alpha'
+
+  def self.infer_sdk_location(path)
+    tools = path.split(":").detect {|p| File.exists? "#{p}/android" }
+    File.expand_path("#{tools}/..")
+  end
+
+  DEFAULTS = { :output => File.expand_path("bin"),
+    :src => File.expand_path("src"),
+    :classpath => Dir["jars/*jar"],
+    :sdk => Pindah.infer_sdk_location(ENV["PATH"])
+  }
+
+  ANT_TASKS = ["clean", "javac", "compile", "debug", "release",
+               "install", "uninstall"]
+
+  task :generate_manifest # TODO: generate from yaml?
+
+  desc "Tail logs from a device or a device or emulator"
+  task :logcat do
+    system "adb -d logcat #{@spec[:log_filter]}"
+  end
+
+  desc "Print the project spec"
+  task :spec do
+    pp @spec
+  end
+
+  task :default => [:install]
+
+  def self.spec=(spec)
+    abort "Must provide :target version in Pindah.spec!" if !spec[:target]
+    abort "Must provide :name in Pindah.spec!" if !spec[:name]
+
+    @spec = DEFAULTS.merge(spec)
+
+    @spec[:root] = File.expand_path "."
+    @spec[:classes] ||= "#{@spec[:output]}/classes"
+    @spec[:classpath] << @spec[:classes]
+    @spec[:classpath] << "#{@spec[:sdk]}/platforms/#{@spec[:target]}/android.jar"
+    @spec[:log_spec] ||= "ActivityManager:I #{@spec[:name]}:D " +
+      "AndroidRuntime:E *:S"
+
+    ant_setup
+  end
+
+  def self.ant_setup
+    @ant = Ant.new
+
+    # TODO: this is lame, but ant interpolation doesn't work for project name
+    build_template = ERB.new(File.read(File.join(File.dirname(__FILE__), '..',
+                                                 'templates', 'build.xml')))
+    build = "/tmp/pindah-#{Process.pid}-build.xml"
+    File.open(build, "w") { |f| f.puts build_template.result(binding) }
+    at_exit { File.delete build }
+
+    { "target" => @spec[:target],
+      "target-version" => @spec[:target],
+      "sdk.dir" => @spec[:sdk],
+      "classes" => @spec[:classes],
+      "classpath" => @spec[:classpath].join(Java::JavaLang::System::
+                                            getProperty("path.separator"))
+    }.each do |key, value|
+      @ant.project.set_user_property(key, value)
+    end
+
+    # TODO: compile task execs mirahc instead of running inside current JVM
+    Ant::ProjectHelper.configure_project(@ant.project, java.io.File.new(build))
+
+    # Turn ant tasks into rake tasks
+    ANT_TASKS.each do |name, description|
+      desc @ant.project.targets[name].description
+      task(name) { @ant.project.execute_target(name) }
+    end
+  end
+end

data/lib/pindah_cli.rb

@@ -0,0 +1,42 @@
+require 'fileutils'
+
+module PindahCLI
+  DEFAULT_TARGET = 'android-7'
+  DEFAULT_VERSION = 'android-2.1'
+
+  def self.log(msg)
+    STDERR.puts msg
+  end
+  
+  def self.create(namespace, location, activity_name=nil)
+    segments = namespace.split('.')
+    src_dir  = File.join(location, 'src', *segments)
+    FileUtils.mkdir_p src_dir
+    log "Created '#{src_dir}'."
+
+    spec_location = File.join(location, 'Pindah.spec')
+    spec_template = File.read(File.join(File.dirname(__FILE__), 
+                                        '..', 'templates', 
+                                        'Pindah.spec'))
+
+    File.open(spec_location, 'w') do |f|
+      f.puts spec_template.gsub(/PROJECT_NAME/, segments[-1]).
+        gsub(/API_TARGET/, DEFAULT_TARGET).
+        gsub(/API_VERSION/, DEFAULT_VERSION)
+    end
+    log "Created Pindah spec file in '#{spec_location}'."
+
+
+    if activity_name
+      activity_location = File.join(src_dir, "#{activity_name}.mirah")
+      activity_template = File.read(File.join(File.dirname(__FILE__),
+                                              '..', 'templates',
+                                              'initial_activity.mirah'))
+
+      File.open(activity_location, 'w') do |f|
+        f.puts activity_template.gsub(/INITIAL_ACTIVITY/, activity_name)
+      end
+      log "Created Activity '#{activity_name}' in '#{activity_location}'."
+    end
+  end
+end

data/templates/build.xml

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project name="<%= @spec[:name] %>">
+    <path id="android.antlibs">
+        <pathelement path="${sdk.dir}/tools/lib/anttasks.jar" />
+        <pathelement path="${sdk.dir}/tools/lib/sdklib.jar" />
+        <pathelement path="${sdk.dir}/tools/lib/androidprefs.jar" />
+    </path>
+
+    <taskdef name="setup"
+        classname="com.android.ant.SetupTask"
+        classpathref="android.antlibs" />
+
+    <target name="javac" description="Compiles R.java and other gen/ files.">
+      <javac srcdir="gen" destdir="${classes}" includeantruntime="false" />
+    </target>
+
+    <target name="compile" depends="-resource-src, -aidl, javac"
+            description="Compiles project's .mirah files into .class files">
+      <exec executable="mirahc" dir="src">
+        <arg line="-c ${classpath}" />
+        <arg line="-d ${classes}" />
+        <arg value="." />
+      </exec>
+    </target>
+
+    <setup />
+</project>

data/templates/initial_activity.mirah

@@ -0,0 +1,7 @@
+import android.app.Activity
+
+class INITIAL_ACTIVITY < Activity
+  def onCreate(state)
+    super state
+  end
+end

data/test/fixtures/HelloWorld.mirah

@@ -0,0 +1,7 @@
+import android.app.Activity
+
+class HelloWorld < Activity
+  def onCreate(state)
+    super state
+  end
+end

data/test/pindah_cli_test.rb

@@ -0,0 +1,50 @@
+require 'test/unit'
+require 'tempfile'
+require 'fileutils'
+require 'rubygems'
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib', 'pindah_cli'))
+
+class PindahCLITest < Test::Unit::TestCase
+  def setup
+    $local_pwd ||= File.expand_path(File.dirname(__FILE__))
+    @project_path = File.expand_path(Tempfile.new('pindah').path + ".d")
+    FileUtils.mkdir_p @project_path
+    Dir.chdir @project_path
+  end
+
+  def teardown
+    FileUtils.rm_rf @project_path
+  end
+
+  def test_create_should_create_basic_project_structure
+    PindahCLI.create('tld.pindah.testapp', '.')
+    assert File.directory?(File.join(@project_path, 'src', 'tld', 'pindah', 'testapp'))
+  end
+
+  def test_create_should_create_pindah_spec_file
+    PindahCLI.create('tld.pindah.testapp', '.')
+    assert File.exists?(File.join(@project_path, 'Pindah.spec'))
+
+    expected = File.read(File.join($local_pwd,
+                                  'fixtures',
+                                  'Pindah.spec'))
+    actual   = File.read(File.join(@project_path,
+                                  'Pindah.spec'))
+    assert_equal expected, actual
+  end
+
+  def test_create_should_create_an_activity_if_desired
+    PindahCLI.create('tld.pindah.testapp', '.', 'HelloWorld')
+
+    expected = File.read(File.join($local_pwd,
+                                   'fixtures',
+                                   'HelloWorld.mirah'))
+    actual   = File.read(File.join(@project_path,
+                                   'src',
+                                   'tld',
+                                   'pindah',
+                                   'testapp',
+                                   'HelloWorld.mirah'))
+    assert_equal expected, actual
+  end
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification 
+name: pindah
+version: !ruby/object:Gem::Version 
+  prerelease: 6
+  version: 0.1.0.alpha
+platform: ruby
+authors: 
+  - Phil Hagelberg
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-02 00:00:00 -08:00
+default_executable: 
+dependencies: 
+  - !ruby/object:Gem::Dependency 
+    name: mirah
+    prerelease: false
+    requirement: &id001 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: 0.0.5
+    type: :runtime
+    version_requirements: *id001
+  - !ruby/object:Gem::Dependency 
+    name: hoe
+    prerelease: false
+    requirement: &id002 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: 2.8.0
+    type: :development
+    version_requirements: *id002
+description: ""
+email: 
+  - technomancy@gmail.com
+executables: 
+  - pindah
+extensions: []
+
+extra_rdoc_files: 
+  - History.txt
+  - Manifest.txt
+files: 
+  - History.txt
+  - Manifest.txt
+  - README.md
+  - Rakefile
+  - bin/pindah
+  - lib/pindah.rb
+  - lib/pindah_cli.rb
+  - templates/initial_activity.mirah
+  - templates/build.xml
+  - test/fixtures/HelloWorld.mirah
+  - test/pindah_cli_test.rb
+has_rdoc: true
+homepage: http://github.com/mirah/pindah
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+  - --main
+  - README.md
+require_paths: 
+  - lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+    - - ">"
+      - !ruby/object:Gem::Version 
+        version: 1.3.1
+requirements: []
+
+rubyforge_project: pindah
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: A tool for writing Android applications in Mirah
+test_files: []
+