andparcel 0.1.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,23 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC
+*.kpf
+TODO

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Mark Murphy
+
+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.rdoc

@@ -0,0 +1,7 @@
+= andparcel
+
+Description goes here.
+
+== Copyright
+
+Copyright (c) 2010 CommonsWare, LLC. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,60 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "andparcel"
+    gem.summary = %Q{Support for Android Parcel packaging system}
+    gem.description = %Q{Supplies the parcel command for packaging, installing, and removing parcels from an Android project}
+    gem.email = "mmurphy@commonsware.com"
+    gem.homepage = "http://github.com/commonsguy/andparcel"
+    gem.authors = ["Mark Murphy"]
+    gem.add_development_dependency "protest", ">= 0"
+    gem.files.include %w(lib/**/*.rb)
+    gem.add_dependency('rubyzip', '>= 0.9.4')
+    gem.add_dependency('json', '>= 1.2.3')
+    gem.add_dependency('nokogiri', '>= 1.4.1')
+    gem.add_dependency('rio', '>= 0.4.2')
+    gem.add_dependency('trollop', '>= 1.15')
+
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "andparcel #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/TODO

@@ -0,0 +1,92 @@
+Sunday
+------
+test on clean Linux, Windows, OS X
+	home directory OK?
+wrap AdvAndroid chapters, gen as PDFs w/ "excerpt" footer
+	need to get appendix generation going
+RDoc comments
+git repo & publish gem
+	VERSION NUMBER
+	.gitignore ignores TODO!
+get git.andparcel.org redir to github
+pour rest of this TODO into RTM and GitHub Issues
+
+May 10
+------
+parcelhelper
+	README
+	put CW logo/links on CWAC README's, add links to CWAC blog posts, other updates
+adapterwrapper
+	put CW logo/links on CWAC README's, add links to CWAC blog posts, other updates
+sackofviewsadapter
+	put CW logo/links on CWAC README's, add links to CWAC blog posts, other updates
+colormixer
+	put CW logo/links on CWAC README's, add links to CWAC blog posts, other updates
+commit all
+	parcel
+	CWAC mods (need .gitignore fixes)
+Web site w/ pointers to documentation, committed
+announce parcel system
+	CW newsletter
+	cw-android
+	twitter
+	my blog
+	AG blog -> Tuesday
+
+Over Next Few Weeks
+-------------------
+get other key cwac- components parcel'd up
+	task
+		sample code into separate project
+		Ant builds
+			main
+			sample -- do replace
+		parcel.json
+		parcel & add to catalog
+		put CW logo/links on CWAC README's, add links to CWAC blog posts, other updates
+	wakefulintentservice
+		sample code into separate project
+		Ant builds
+			main
+			sample -- do replace
+		parcel.json
+		parcel & add to catalog
+		put CW logo/links on CWAC README's, add links to CWAC blog posts, other updates
+	endlessadapter
+		Ant builds
+		parcel.json
+		parcel & add to catalog
+		put CW logo/links on CWAC README's, add links to CWAC blog posts, other updates
+	mergeadapter
+		Ant builds
+		parcel.json
+		parcel & add to catalog
+		put CW logo/links on CWAC README's, add links to CWAC blog posts, other updates
+
+
+Future
+------
+deal with upgrade (if newer available, do...something)
+support merging non-component manifest entries
+	deal with manifest collisions (e.g., sdk levels different)
+input validation
+	regex on name, etc.
+	SemVer.org validation
+support packaging assets/
+multiple version support (a la gem versions)
+mirror support
+	catalogs
+	parcels
+fail remove if listed as a dependency of something else
+catalog caching w/ If-Modified-Since/ETag support
+100% rcov coverage
+rfc5261 support for manifest merges?
+optional signed ZIPs?
+battle plan for new components (see list in sketchpad)
+smart --replace: doesn't download/replace if version same
+dependency tests
+dependency version checking
+version pinning (don't auto-upgrade)
+remove --full gets rid of dependencies
+lint tests
+100% comments

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/andparcel.gemspec

@@ -0,0 +1,103 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{andparcel}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Mark Murphy"]
+  s.date = %q{2010-05-09}
+  s.default_executable = %q{parcel}
+  s.description = %q{Supplies the parcel command for packaging, installing, and removing parcels from an Android project}
+  s.email = %q{mmurphy@commonsware.com}
+  s.executables = ["parcel"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc",
+     "TODO"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "andparcel.gemspec",
+     "bin/parcel",
+     "lib/andparcel.rb",
+     "lib/andparcel/base.rb",
+     "lib/andparcel/catalog.rb",
+     "lib/andparcel/fileref.rb",
+     "lib/andparcel/parcel.rb",
+     "test/ParcelReceiver/AndroidManifest.xml",
+     "test/ParcelReceiver/build.properties",
+     "test/ParcelReceiver/build.xml",
+     "test/ParcelReceiver/default.properties",
+     "test/ParcelReceiver/local.properties",
+     "test/ParcelReceiver/res/layout/main.xml",
+     "test/ParcelReceiver/res/values/strings.xml",
+     "test/ParcelReceiver/src/com/commonsware/android/pr/ParcelReceiver.java",
+     "test/ParcelToPackage/AndroidManifest.xml",
+     "test/ParcelToPackage/build.properties",
+     "test/ParcelToPackage/build.xml",
+     "test/ParcelToPackage/default.properties",
+     "test/ParcelToPackage/docs/README",
+     "test/ParcelToPackage/docs/SomeOtherFile",
+     "test/ParcelToPackage/libs/one.jar",
+     "test/ParcelToPackage/libs/two.jar",
+     "test/ParcelToPackage/local.properties",
+     "test/ParcelToPackage/parcel.json",
+     "test/ParcelToPackage/res/layout/andParcel_test_row.xml",
+     "test/ParcelToPackage/res/values/strings.xml",
+     "test/ParcelToPackage/src/com/commonsware/android/p2pkg/ParcelToPackage.java",
+     "test/ParcelToPackage/tmp/andParcel-test_0.1.0.zip",
+     "test/test_init.rb",
+     "test/test_install.rb",
+     "test/test_package.rb",
+     "test/test_remove.rb"
+  ]
+  s.homepage = %q{http://github.com/commonsguy/andparcel}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Support for Android Parcel packaging system}
+  s.test_files = [
+    "test/test_remove.rb",
+     "test/test_package.rb",
+     "test/test_init.rb",
+     "test/test_install.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<protest>, [">= 0"])
+      s.add_runtime_dependency(%q<rubyzip>, [">= 0.9.4"])
+      s.add_runtime_dependency(%q<json>, [">= 1.2.3"])
+      s.add_runtime_dependency(%q<nokogiri>, [">= 1.4.1"])
+      s.add_runtime_dependency(%q<rio>, [">= 0.4.2"])
+      s.add_runtime_dependency(%q<trollop>, [">= 1.15"])
+    else
+      s.add_dependency(%q<protest>, [">= 0"])
+      s.add_dependency(%q<rubyzip>, [">= 0.9.4"])
+      s.add_dependency(%q<json>, [">= 1.2.3"])
+      s.add_dependency(%q<nokogiri>, [">= 1.4.1"])
+      s.add_dependency(%q<rio>, [">= 0.4.2"])
+      s.add_dependency(%q<trollop>, [">= 1.15"])
+    end
+  else
+    s.add_dependency(%q<protest>, [">= 0"])
+    s.add_dependency(%q<rubyzip>, [">= 0.9.4"])
+    s.add_dependency(%q<json>, [">= 1.2.3"])
+    s.add_dependency(%q<nokogiri>, [">= 1.4.1"])
+    s.add_dependency(%q<rio>, [">= 0.4.2"])
+    s.add_dependency(%q<trollop>, [">= 1.15"])
+  end
+end
+

data/bin/parcel

@@ -0,0 +1,161 @@
+#!/usr/bin/ruby
+
+# +parcel+ is the command-line interface to the Android parcel
+# system -- a framework for creating reusable components
+# for Android application development.
+#
+# Author::    Mark Murphy
+# Copyright:: Copyright (c) 2010 CommonsWare, LLC
+# License::   Apache Software License 2.0
+
+require 'pathname'
+require 'set'
+require 'rubygems'
+require 'trollop'
+require 'andparcel'
+
+module AndParcel
+	def self.commands
+		@commands||={}
+	end
+	
+	class Command
+		def self.inherited(subclass)
+			if subclass.name.match(/AndParcel\:\:(.*)+Command/)
+				AndParcel.commands[$1.downcase]=subclass
+			end
+    end
+	end
+	
+	class ListCommand < Command
+		def run
+			catalogs=AndParcel.catalogs
+			puts catalogs.names.sort.join("\n")
+		end
+	end
+	
+	class PackageCommand < Command
+		def run
+			opts=Trollop::options do
+				banner "parcel package"
+				opt :project, "path to Android project (defaults to parcel JSON directory)", :short=>'p'
+				opt :dir, "directory for parcel output, relative to --project", :default=>'bin'
+				opt :jars, "paths to JARs to bundle (primary and libs)", :type=>:strings, :short=>'j', :required=>true
+				opt :docs, "files/directories of docs to package", :type=>:strings, :short=>'d'
+				opt :manifest, "manifest containing components to package (defaults to AndroidManifest.xml in project)", :type=>:string, :short=>'m'
+#				opt :dependencies, "names of parcels this parcel depends on", :type=>:strings
+				opt :res, "files/directories of resources to package (defaults to res/ in project)", :type=>:strings, :short=>'r'
+			end
+			
+			pkg_info=ARGV.shift || "package.json"
+			
+			Trollop::die "cannot find #{pkg_info}" if !File.exists?(pkg_info)
+			
+			if !opts[:project]
+				opts[:project]=File.dirname(pkg_info)
+				pkg_info=File.basename(pkg_info)
+			end
+			
+			if !opts[:res]
+				opts[:res]=['res']
+			end
+			
+			if !opts[:manifest]
+				opts[:manifest]='AndroidManifest.xml'
+			end
+			
+			AndParcel::Parcel.package(pkg_info, opts)
+		end
+	end
+	
+	class InstallCommand < Command
+		def run
+			opts=Trollop::options do
+				banner "parcel install"
+				opt :project, "path to Android project", :type=>:string, :short=>'p', :default=>'.'
+				opt :replace, "if set and parcel is installed already, remove first", :default=>false
+			end
+			
+			Trollop::die "parcel not provided" if ARGV.size==0
+			
+			parcel=ARGV.shift
+			
+			AndParcel::Parcel.install(parcel, opts)
+		end
+	end
+	
+	class RemoveCommand < Command
+		def run
+			opts=Trollop::options do
+				banner "parcel remove"
+				opt :project, "path to Android project", :type=>:string, :short=>'p', :default=>'.'
+			end
+			
+			Trollop::die "parcel name not provided" if ARGV.size==0
+			
+			name=ARGV.shift
+			
+			AndParcel::Parcel.remove(name, opts)
+		end
+	end
+	
+	class CatalogCommand < Command
+		def run
+			Trollop::die "add/remove not provided" if ARGV.size==0
+			
+			op=ARGV.shift.downcase
+			
+			Trollop::die "invalid operation: #{op}" if !["add", "remove"].include?(op)
+			Trollop::die "catalog nickname not provided" if ARGV.size==0
+			
+			nick=ARGV.shift
+
+			if (op=='add')
+				Trollop::die "catalog URL not provided" if ARGV.size==0
+				
+				AndParcel.catalogs.add(nick, ARGV.shift)
+			else
+				AndParcel.catalogs.remove(nick)
+			end
+		end
+	end
+	
+	class LintCommand < Command
+		def run
+			opts=Trollop::options do
+				banner "parcel lint"
+				opt :project, "path to Android project (defaults to parcel.json directory)", :short=>'p'
+				opt :repair, "tells parcel to repair problems", :short=>'r', :default=>false
+				opt :quiet, "whether it should print output on success", :short=>'q', :default=>false
+			end
+
+			Trollop::die "parcel not provided" if ARGV.size==0
+			
+			pkg_info=ARGV.shift
+
+			Trollop::die "cannot find #{pkg_info}" if !File.exists?(pkg_info)
+			
+			if !opts[:project]
+				opts[:project]=File.dirname(pkg_info)
+				pkg_info=File.basename(pkg_info)
+			end
+			
+			AndParcel::Parcel.lint(pkg_info, opts)
+		end
+	end
+end
+
+if ARGV.size>0
+	name=ARGV.shift
+	cls=AndParcel.commands[name]
+	
+	if cls
+		cmd=cls.new.run
+	else
+		$stderr.puts "Could not find subcommand #{name}"
+		exit(-1)
+	end
+else
+	$stderr.puts "Usage: parcel [#{AndParcel.commands.keys.sort.join(',')}] [opts]"
+	exit(-1)
+end

data/lib/andparcel/base.rb

@@ -0,0 +1,22 @@
+require "fileutils"
+
+module AndParcel
+	def self.version
+		"0.1"
+	end
+	
+	def self.home
+		File.join(Dir.chdir {Dir.pwd}, '.andparcel')
+	end
+	
+	def self.init
+		FileUtils.mkdir_p home
+		CatalogSet.new(home).add('andparcel.com', 'http://pub.andparcel.com/andparcel.json')
+	end
+	
+	def self.catalogs
+		init
+		
+		CatalogSet.new(home)
+	end
+end

data/lib/andparcel/catalog.rb

@@ -0,0 +1,75 @@
+require "fileutils"
+require 'uri'
+require "open-uri"
+require "rubygems"
+require "rio"
+
+module AndParcel
+	class Catalog
+		attr_reader :nick, :path
+		
+		def initialize(path)
+			@path=path
+			@nick=File.basename(path, '.json')
+		end
+	end
+	
+	class CatalogSet
+		def initialize(root)
+			@root=root
+		end
+		
+		def size
+			roster.size
+		end
+	
+		def roster_file
+			File.join(@root, 'catalogs.json')
+		end
+		
+		def roster
+			fn=roster_file
+			
+			if File.exists?(fn)
+				return(JSON.parse(open(fn) {|f| f.read}))
+			end
+			
+			{}
+		end
+		
+		def add(name, url)
+			roster_hash=roster
+
+			roster_hash[name]={'url'=>url}
+
+			open(roster_file, "w") {|f| f.puts(roster_hash.to_json)}
+		end
+		
+		def remove(name)
+			roster_hash=roster
+
+			roster_hash.delete(name)
+
+			open(roster_file, "w") {|f| f.puts(roster_hash.to_json)}
+		end
+		
+		def names
+			roster.keys
+		end
+		
+		def find(name)
+			roster.each_value do |cat|
+				packages=JSON.parse(open(cat['url']) {|f| f.read})
+				package=packages['parcels'][name]
+
+				if package
+					uri=URI.parse cat['url']
+					
+					return(uri+package['path'])
+				end
+			end
+			
+			nil
+		end
+	end
+end

data/lib/andparcel/fileref.rb

@@ -0,0 +1,21 @@
+module AndParcel
+	class FileRef
+		attr_reader :local, :relative, :dir
+		
+		def self.[](base)
+			files=[]
+			
+#			files += Dir[File.join(base, '*')].collect {|x| FileRef.new(x, base)}
+			files += Dir[File.join(base, '**', '*')].collect {|x| FileRef.new(x, base)}
+
+			files			
+		end
+		
+		def initialize(name, dir=nil)
+			@local=name
+			@dir=dir
+			@relative=@local[dir.size, 10000] if @local[0, dir.size]==dir
+			@relative=@local if !@relative
+		end
+	end
+end