motion-steward 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: adbe9735dc7992626d91305de5fe4f802a3499cb
+  data.tar.gz: f340890903488d8d0234df95c232a8d62733e8df
+SHA512:
+  metadata.gz: ad68238fb4e2d9a3ef4374cfa5f732fc81404a832654080237298fa3c9e7e3451c0bf0c6cdbec24c94953c20d2e3b2f01865094d50ab7248fa8c09cd4cfc747e
+  data.tar.gz: b9b10c6d7190fd8264f81b500ba988bb4073bbd4f513e544def24be9ddb1650090b57cf2016832e80fae8d3edbbd09642c712dcef2484f4ab32f9c060c25f2f8

data/bin/motion-steward

@@ -0,0 +1,134 @@
+#!/usr/bin/env ruby
+
+require 'fastlane'
+require 'httparty'
+require 'motion-steward'
+
+def options
+  [:research]
+end
+
+def list_apps
+  Spaceship.app.all.map do |a|
+    puts "#{a.name}: #{a.bundle_id}"
+  end
+end
+
+def go_to_apps
+  puts 'opening https://developer.apple.com/account/ios/identifier/bundle/'
+  system 'open https://developer.apple.com/account/ios/identifier/bundle/'
+end
+
+def get_udid_of_connected_devices
+  script = <<~SCRIPT
+    i=0
+    for line in $(system_profiler SPUSBDataType | sed -n -e '/iPad/,/Serial/p' -e '/iPhone/,/Serial/p' | grep "Serial Number:" | awk -F ": " '{print $2}'); do
+        UDID=${line}
+        echo $UDID
+        udid_array[i]=${line}
+        i=$(($i+1))
+    done
+
+    cnt=${#udid_array[@]}
+    for ((i=0;i<cnt;i++)); do
+        echo ${udid_array[i]}
+    done
+ SCRIPT
+
+ system script
+end
+
+def gets
+  STDIN.gets.chomp
+end
+
+def prompt_for_response message
+  message += ' ' if message[-1] != ' '
+  print message
+  gets
+end
+
+def research
+  term = prompt_for_response "Enter a search term or app name, and I'll return a return what people will see when the search for that term (along with some fancy data):"
+  MotionSteward::AppStoreResearch.analyze(term)
+end
+
+def help_with_certificates
+  production = Spaceship.certificate.all.find_all { |c| c.is_a? Spaceship::Portal::Certificate::Production }.first
+
+  development = Spaceship.certificate.all.find_all { |c| c.is_a? Spaceship::Portal::Certificate::Development }.first
+
+  if production.nil? or development.nil?
+    puts "You need to create a Production and Development certificate. This script doesn't support that stuff yet."
+    system "open https://developer.apple.com/account/ios/certificate/"
+    exit(0)
+  end
+
+  [development, production]
+end
+
+def create_app
+  puts <<~INSTRUCTIONS
+  I need the name of your app. Here are some tips:
+
+  - If you haven't done so, you should really run the research command before committing to a name for your app.
+  - Using spaces is fine.
+  - Using a hypen after the main app name (eg: "Metal Gear - Tactical Espionage") is fine.
+  - Make the app name memorable because this is what people will use to find your app in the App Store.
+  - Here are examples of BAD app names:
+    - "Threes!" Why? Because it has an exclamation point (punctuation) in the main app name. Apps that use punctuation are hard to find.
+    - "T.L.D.R. Reddit" Why? Because it has periods (punctuation) in the main app name. Apps that use punctuation are hard to find.
+    - "Heroes Fighting" Why? Heroes is a saturated app keyword (there are many others). It'll make your app incredibly difficult to find.
+
+  INSTRUCTIONS
+
+  continue = false
+  while !continue
+    print "Pressure's on, what will you name your app?: "
+    app_name = gets
+    puts ""
+    print 'Given the results above, do you want to change the name of your app? y/n: '
+    continue = true if gets == 'n'
+  end
+  puts 'I need an app website/company website to generate an app ID. Examples: amirrajan.net, rubymotion.com'
+  website = gets
+  recommended_app_id = website.split('.').reverse.join '.'
+  recommended_app_id += '.' + app_name.downcase.delete(' ')
+  app_id = recommended_app_id
+  puts "Alright, here is the app that I'll create for you: "
+  puts app_name
+  puts app_id
+  puts 'Everything look good? y/n: '
+  if gets == 'n'
+    print 'What would you like the App ID to be? '
+    app_id = gets
+  end
+
+  Spaceship.app.create!(bundle_id: app_id, name: app_name)
+
+  puts "If all went well, [#{app_name}] has now been created. Select list_apps to continue."
+end
+
+continue = true
+
+while continue
+  puts ''
+  puts 'Options:'
+  puts ''
+  options.map { |o| puts "- #{o}" }
+  puts '- exit'
+  puts ''
+
+  print 'What would you like to do (choose from the list above): '
+
+  input = gets
+
+  if input == 'exit'
+    exit(0)
+  end
+
+  if options.include? input.to_sym
+    system 'clear'
+    send(input.to_sym)
+  end
+end

data/lib/motion-steward/app_store_research.rb

@@ -0,0 +1,94 @@
+require 'date'
+require 'motion-steward/app_store_search'
+
+class Integer
+  def commas
+    self            #=> 12345678
+      .to_s             #=> "12345678"
+      .reverse          #=> "87654321"
+      .scan(/\d{1,3}/)  #=> ["876","543","21"]
+      .join(",")        #=> "876,543,21"
+      .reverse          #=> "12,345,678"
+  end
+end
+
+class MotionSteward::AppStoreResearch
+  def self.analyze name
+    apps = MotionSteward::AppStoreSearch.search_for_app(name)
+
+    if apps.any? { |a| a[:track_name] == name }
+      puts "WARNING: You can't name your app \"#{name}\". Because there is already an app out there with that exact name."
+    end
+
+    apps.each do |a|
+      puts a[:track_name] + " (Category: #{a[:genres].join(', ')}, Price: #{(a[:price] || 0)})"
+
+      release_score = determine_release_score(a)
+      if release_score == :green
+        puts '  - App has had recent updates.'
+      elsif release_score == :yellow
+        puts "  - It's been a while since this app has released an update, but stable apps usually don't release more than once a year."
+      else
+        puts "  - It's been over #{months_between(a[:current_version_release_date], Date.today)} months since this app has released. Thats pretty bad, and may be an indicator of a dead app (number of ratings may say otherwise)."
+      end
+
+      user_rating_count = a[:user_rating_count] || 0
+
+      if user_rating_count < 99
+        puts '  - App has very few ratings, which usually means very few downloads.'
+      elsif user_rating_count < 300
+        puts '  - App has a moderate number of reviews. If the app has been recently updated, then this is probably a new app.'
+      elsif user_rating_count > 10_000
+        puts "  - App has an astronomical number of reviews (#{user_rating_count.commas}). If your app is similar to this one, you probably shouldn't build yours because you have little to no chance of \"beating them\"."
+      elsif user_rating_count > 5_000
+        puts "  - App has a very high number of reviews (#{user_rating_count.commas} with an average rating of #{a[:average_user_rating]}). If you're app is similar to this one, you've got some serious competition. Success is unlikely."
+      else
+        puts "  - App has a solid number of reviews (#{user_rating_count.commas} with an average rating of #{a[:average_user_rating]}). If you're app is similar to this one, you've got some competition, but you may be able to \"beat them\" if they have a low rating."
+      end
+
+      life_time_of_app = months_between(a[:release_date], Date.today)
+
+      if life_time_of_app.zero?
+        puts "  - This app has been released recently. I can't project any revenue numbers because of this (try again in a month)."
+      elsif user_rating_count.zero?
+        puts '  - This app has no ratings. It either has a very poor review conversion rate, or (more likely) has never been downloaded.'
+      else
+        if a[:price].zero?
+          money_per_download = (1.99 * 0.7)
+          life_time_revenue_top_end = (((user_rating_count * 0.05) * 100) * money_per_download).round.to_i
+          industry = (((user_rating_count * 0.02) * 50) * money_per_download).round.to_i
+          life_time_revenue_bottom_end = (((user_rating_count * 0.005) * 20) * money_per_download).round.to_i
+        else
+          money_per_download = a[:price] * 0.7
+          life_time_revenue_top_end = ((user_rating_count * 100) * money_per_download).round.to_i
+          industry = ((user_rating_count * 50) * money_per_download).round.to_i
+          life_time_revenue_bottom_end = ((user_rating_count * 20) * money_per_download).round.to_i
+        end
+
+        monthly_revenue_top = life_time_revenue_top_end.fdiv(life_time_of_app).round.to_i
+        monthly_revenue_industry = industry.fdiv(life_time_of_app).round.to_i
+        monthly_revenue_bottom = life_time_revenue_bottom_end.fdiv(life_time_of_app).round.to_i
+
+        puts "  - At best, this app has made $#{life_time_revenue_top_end.commas} over its lifetime (or $#{monthly_revenue_top.commas} a month)."
+        puts "  - Based on my own industry measurements, this app probably made $#{industry.commas} over its lifetime (or $#{monthly_revenue_industry.commas} a month)."
+        puts "  - Conservatively, this app has made $#{life_time_revenue_bottom_end.commas} over its lifetime (or $#{monthly_revenue_bottom.commas} a month)."
+        puts ''
+      end
+    end
+  end
+
+  def self.determine_release_score app
+    months_since_last_release = months_between(app[:current_version_release_date], Date.today)
+    if months_since_last_release.zero?
+      :green
+    elsif months_since_last_release < 16
+      :yellow
+    else
+      :red
+    end
+  end
+
+  def self.months_between start_date, end_date
+    (end_date.year * 12 + end_date.month) - (start_date.year * 12 + start_date.month)
+  end
+end

data/lib/motion-steward/app_store_search.rb

@@ -0,0 +1,80 @@
+require 'net/http'
+require 'json'
+require 'open-uri'
+require 'pp'
+require 'date'
+
+class String
+  def underscore
+    self.gsub(/::/, '/').
+      gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+      gsub(/([a-z\d])([A-Z])/,'\1_\2').
+      tr("-", "_").
+      downcase
+  end
+end
+
+class MotionSteward::AppStoreSearch
+  def self.search_for_app term
+    results = get 'search',
+                  media: 'software',
+                  term: URI.encode(term),
+                  country: 'us',
+                  limit: 15
+
+    pluck results['results'],
+          %w(genres price track_name track_id average_user_rating user_rating_count release_date current_version_release_date price)
+  end
+
+  def self.pluck json, values
+    if json.is_a? Array
+      json.map do |o|
+        to_hash(o).select { |k, _| values.include? k.to_s }
+      end
+    else
+      to_hash(json).select { |k, _| values.include? k }
+    end
+  end
+
+  def self.construct_uri(path)
+    URI.parse('https://itunes.apple.com/' + path)
+  end
+
+  def self.convert_to_date_maybe k, v
+    return v if k !~ /date/i
+
+    begin
+      Date.parse(v).to_date
+    rescue
+      v
+    end
+  end
+
+  def self.to_hash h
+    h.inject({}) do |memo, (k, v)|
+      new_v = convert_to_date_maybe(k, v)
+      memo[k.underscore.to_sym] = new_v
+      memo
+    end
+  end
+
+  def self.get path, querystring
+    first = true
+    querystring.each do |k, v|
+      if first
+        path += '?'
+        first = false
+      else
+        path += '&'
+      end
+      path += "#{k}=#{v}"
+    end
+
+    uri = construct_uri path
+    http = Net::HTTP.new(uri.host, uri.port)
+    http.use_ssl = true
+    req = Net::HTTP::Get.new(uri.request_uri)
+    response = http.request(req)
+    JSON.parse(response.body)
+  end
+end

data/lib/motion-steward.rb

@@ -0,0 +1,8 @@
+class MotionSteward
+  def self.hi
+    puts 'hello world'
+  end
+end
+
+require 'motion-steward/app_store_search'
+require 'motion-steward/app_store_research'

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification
+name: motion-steward
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Amir Rajan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-05-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fastlane
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.32.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.32.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: There is a lot that goes into making a successful mobile app. This cli
+  tool will help you research possible app ideas and then scaffold a starting point
+  for a RubyMotion app.
+email: ar@amirrajan.net
+executables:
+- motion-steward
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/motion-steward
+- lib/motion-steward.rb
+- lib/motion-steward/app_store_research.rb
+- lib/motion-steward/app_store_search.rb
+homepage: http://rubymotion.com
+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.5.1
+signing_key: 
+specification_version: 4
+summary: CLI app that helps steward one through RubyMotion.
+test_files: []