radb 0.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0ed515a06f15faa329ce1009f07ae9ab8e553693
+  data.tar.gz: 191a25e2435cfa6e05b6235990c841aa38d8e972
+SHA512:
+  metadata.gz: 44a49b4d5dd651ead0dde323811d3ad445b492cd3162f0fc9e1fa9e1ef1638625aa5647666d5b27262413ab575ab95e0d67fffa5e5039f8ee234c706ae0a08c7
+  data.tar.gz: f0f954e4c529b8e10d59b929c906f423d03037dc5435c3a7d1bdda977f784ed2fb55593f12d79469745f2b3c2c3acc76018d631682007c4d37fdc2588ffa9a34

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in radb.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 TODO: Write your name
+
+MIT 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/README.md

@@ -0,0 +1,55 @@
+# Radb
+
+Radb is a gem that provide cli for some adb tasks in android device. It required `adb` for adb command set and `logcat-color` for better logcat output.
+
+## Installation
+
+### On Mac OSX
+
+Install xcode command-line tool:
+
+    `$ xcode-select --install`
+
+Install `adb`:
+
+    `$ bash <(curl https://raw.github.com/corbindavenport/nexus-tools/master/install.sh)`
+
+Install `python, pip, ruby` through `homebrew`
+
+Install `logcat-color` through `pip`
+
+Install it yourself as:
+
+    `$ gem install radb`
+
+## Usage
+
+    At this version, `radb` provides 4 commands:
+
+    `$ radb pull <package>`: pull database and images data from app to PC
+    Example:
+        $ radb pull com.cloudjay.cjay -d cjay.db -i CJay
+        $ radb pull com.cloudjay.cjay -d cjay.db -i CJay -s <device serial>
+
+    `$ radb push <package>`: push database and images from PC to app
+    Example:
+        $ radb push com.cloudjay.cjay -d cjay.db -i CJay
+        $ radb push com.cloudjay.cjay -d cjay.db -i CJay -s <device serial>
+
+    `$ radb logcat <package>`: display logcat for specific app
+    Example:
+        $ radb logcat com.cloudjay.cjay
+        $ radb logcat com.cloudjay.cjay -s <device serial>
+
+    `$ radb otadebug`: enable ota debugging for android device.
+    Example:
+        $ radb otadebug
+        $ radb otadebug -s <device serial>
+
+## Contributing
+
+1. Fork it ( https://github.com/tieubao/radb/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/bin/radb

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+require 'radb'
+require 'fileutils'
+
+# CONFIG_FILE = File.expand_path("~/.badb_config.yaml")
+#
+# def read_settings
+#     Settings.use :config_file
+#     Settings({:device_history => [],:aliases => {}})
+#     FileUtils.touch(CONFIG_FILE)
+#     Settings.read(CONFIG_FILE)
+# end
+#
+# read_settings
+
+Radb::Application.start(ARGV)

data/lib/radb.rb

@@ -0,0 +1,124 @@
+require "radb/version"
+require "radb/helper"
+require "thor"
+include Radb
+
+module Radb
+    class Application < Thor
+
+        include Thor::Actions
+        class_option :verbose, :type => :boolean
+
+        #
+        desc 'pull <package_name>', 'Pull database and images from android device'
+        long_desc <<-LONGDESC
+        `pull <package name>` will pull database and images from android device to your computer.
+
+        Example:
+        \x5> $ radb pull com.cloudjay.com -db cjay.db -i CJay
+        \x5>
+        LONGDESC
+        option :database, :type => :string, :desc => 'Database filename', :required => true, :aliases => "-d"
+        option :image_dir, :type => :string, :desc => 'Images directory', :required => true, :aliases => "-i"
+        option :serial, :type => :string, :desc => 'Device serial', :required => false, :aliases => '-s'
+        def pull(package)
+
+            target = get_target(options[:serial])
+            database_path = "/data/data/#{package}/databases/" + options[:database]
+            images_path = "/sdcard/DCIM/" + options[:image_dir]
+
+            say " > Pull database from " + database_path
+            run "adb #{which_one(target)} shell \"run-as #{package} chmod 666 #{database_path}\"", :verbose => false
+            run "adb #{which_one(target)} pull #{database_path}", :verbose => false
+            run "adb #{which_one(target)} shell \"run-as #{package} chmod 600 #{database_path}\"", :verbose => false
+
+            say " > Pull images from " + images_path
+            run "adb #{which_one(target)} pull #{images_path} #{options[:image_dir]} ", :verbose => false
+        end
+
+        #
+        desc 'push <package_name>', 'Push database and images to android device'
+        long_desc <<-LONGDESC
+        `push <package name>` will push database and images from your computer to android device.
+
+        Example:
+        \x5> $ radb push com.cloudjay.com -d cjay.db -i CJay/
+        \x5>
+        LONGDESC
+        option :database, :type => :string, :desc => 'Database filepath', :required => true, :aliases => "-d"
+        option :image_dir, :type => :string, :desc => 'Images directory', :required => true, :aliases => "-i"
+        option :serial, :type => :string, :desc => 'Device serial', :required => false, :aliases => '-s'
+        def push(package)
+
+            target = get_target(options[:serial])
+            database_dir = "/data/data/#{package}/databases/"
+            database_path = options[:database]
+            images_path = "/sdcard/DCIM/" + options[:image_dir]
+
+            say " > Push database from " + database_path + " to " + database_dir
+            run "adb #{which_one(target)} shell \"run-as #{package} chmod 666  #{database_dir}#{database_path}\"", :verbose => false
+            run "adb #{which_one(target)} push '#{database_path}' '#{database_dir}' ", :verbose => false
+            run "adb #{which_one(target)} shell \"run-as #{package} chmod 600  #{database_dir}#{database_path}\"", :verbose => false
+            run "adb #{which_one(target)} push '#{options[:image_dir]}' '#{images_path}'", :verbose => false
+        end
+
+        # Connect devices to PC
+        # Run command:
+        # `radb debug`
+        # 1. Show list devices
+        # 2. Choose device if there are many devices
+        # 3. Get chosen ip address
+        # 4. Enable ota debug
+        #
+        # Run command:
+        # `radb debug -s <serial>`
+        # 1. Get choose ip address
+        # 2. Enable ota debug
+        long_desc <<-LONGDESC
+        `otadebug -s <serial>` will enable ota debug.
+
+        Example:
+        \x5> $ radb otadebug -s 81f42e1
+        \x5>
+        LONGDESC
+        desc 'otadebug', 'Debug android device over the air'
+        option :serial, :type => :string, :desc => 'Device serial', :required => false, :aliases => '-s'
+        def otadebug
+            target = get_target(options[:serial])
+            ip = get_ipv4(target)
+            say "Target ip: " + ip
+            run "adb #{which_one(target)} tcpip 5555", :verbose => false
+            run "adb #{which_one(target)} connect #{ip}", :verbose => false
+        end
+
+        long_desc <<-LONGDESC
+        `logcat -s <serial>` will display logcat for specific device.
+
+        Example:
+        \x5> $ radb logcat -s 81f42e1
+        \x5>
+        LONGDESC
+        desc 'logcat <package_name>', 'Display logcat for specific device'
+        option :serial, :type => :string, :desc => 'Device serial', :required => false, :aliases => '-s'
+        def logcat(package)
+            target = get_target(options[:serial])
+            process_id = %x(adb #{which_one(target)} shell ps | grep #{package} | cut -c10-15)
+
+            if command?("logcat-color")
+                s = "logcat-color #{which_one(target)} \"*:I\""
+            else
+                puts "You should install `logcat-color` for better output"
+                s = "adb #{which_one(target)} \"*:I\""
+            end
+
+            if process_id.empty?
+                say "Cannot found #{package}. It will print all logs."
+            else
+                s = s + " | grep #{process_id}"
+            end
+
+            run s, :verbose => false
+        rescue
+        end
+    end
+end

data/lib/radb/helper.rb

@@ -0,0 +1,133 @@
+require 'highline/import'
+require 'configliere'
+require 'fileutils'
+require 'childprocess'
+require 'tempfile'
+require 'date'
+
+module Radb
+
+    attr_reader :last_stdout, :last_stderr
+
+    CONFIG_FILE = File.expand_path("~/.badb_config.yaml")
+
+    def adb_path
+        return @adb_path if @adb_path
+        @adb_path = `which adb`.strip
+        if @adb_path.empty?
+            raise "Can't find your adb command. Is your path set\?"
+        end
+        @adb_path
+    end
+
+    def get_devices
+        devices = []
+        IO.popen("#{adb_path} devices").each_line do |line|
+            line = line.strip
+            if line =~ /^(.*)\tdevice$/
+                devices << $1
+            end
+        end
+        devices
+    end
+
+    def get_target(serial)
+
+        if serial
+            device = serial
+        else
+            device = choose_device
+        end
+
+        if device.nil?
+            raise "Device not found"
+        end
+
+        target = { :serial => device }
+        return target
+    end
+
+    def which_one(target)
+        direct = ''
+        direct = '-d' if target[:device]
+        direct = '-e' if target[:emulator]
+        direct = "-s #{target[:serial]}" if target[:serial]
+        direct
+    end
+
+    def get_ipv4(target={})
+
+        lines = %x(adb #{which_one(target)} shell ip -f inet addr show wlan0)
+        lines.each_line do |line|
+            line.strip
+            if line =~ /inet (.*)\/24/
+                return $1
+            end
+        end
+
+    end
+
+    def choose_device()
+        devices = get_devices
+
+        if devices.empty?
+            raise "No devices attached"
+
+        elsif devices.size == 1
+            # yield devices[0] if block_given?
+            return devices[0]
+        else
+            choose do |menu|
+                menu.prompt = "Choose your adb device: "
+                devices.each do |device|
+                    menu.choice device do
+                        # yield device if block_given?
+                        return device
+                    end
+                end
+            end
+        end
+    end
+
+    def current_device
+
+        devices = get_devices
+        return devices[0] if devices.size == 1
+        return nil
+    end
+
+    def list_devices
+        devices = get_devices
+
+        puts "List of devices: "
+        devices.each do |d|
+            puts d
+        end
+    end
+
+    def command?(name)
+        `which #{name}`
+        $?.success?
+    end
+
+    #
+    def execute_adb_with(timeout, arguments)
+        args = arguments.split
+        execute_adb_with_exactly timeout, *args
+    end
+
+    def execute_adb_with_exactly(timeout, *arguments)
+
+        process = ChildProcess.build('adb', *arguments)
+        process.io.stdout, process.io.stderr = std_out_err
+        process.start
+
+        kill_if_longer_than(process, timeout)
+        @last_stdout = output(process.io.stdout)
+        @last_stderr = output(process.io.stderr)
+    end
+
+    def wait_for_device(target={}, timeout=30)
+        execute_adb_with(timeout, "#{which_one(target)} wait-for-device")
+    end
+end

data/lib/radb/version.rb

@@ -0,0 +1,3 @@
+module Radb
+  VERSION = "0.0.3"
+end

data/radb.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'radb/version'
+
+Gem::Specification.new do |spec|
+    spec.name          = "radb"
+    spec.version       = Radb::VERSION
+    spec.authors       = ["tieubao"]
+    spec.email         = ["nntruonghan@gmail.com"]
+    spec.summary       = %q{A cli utilities which wrap Android Debug Bridge}
+    spec.description   = %q{radb provides some commands that helps non-geeks take advantage on android devices}
+    spec.homepage      = "https://github.com/tieubao/radb"
+    spec.license       = "MIT"
+
+    spec.files         = `git ls-files -z`.split("\x0")
+    spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+    spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+    spec.require_paths = ["lib"]
+
+    spec.add_development_dependency "bundler", "~> 1.6"
+    spec.add_development_dependency "rake"
+    spec.add_dependency 'thor', '>= 0.18'
+    spec.add_dependency 'highline', ">= 0"
+    spec.add_dependency 'configliere', ">= 0"
+    spec.add_dependency 'childprocess', '>= 0.3.5'
+
+end

metadata

@@ -0,0 +1,140 @@
+--- !ruby/object:Gem::Specification
+name: radb
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+platform: ruby
+authors:
+- tieubao
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.18'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.18'
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: configliere
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: childprocess
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.5
+description: radb provides some commands that helps non-geeks take advantage on android
+  devices
+email:
+- nntruonghan@gmail.com
+executables:
+- radb
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/radb
+- lib/radb.rb
+- lib/radb/helper.rb
+- lib/radb/version.rb
+- radb.gemspec
+homepage: https://github.com/tieubao/radb
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: A cli utilities which wrap Android Debug Bridge
+test_files: []