deliver 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9cf9d0d6bc0c0d4cb2829822d1296f9722705925
-  data.tar.gz: eeab2bb2a145a70c4cf59396e8f99540778ab133
+  metadata.gz: 77e02a8f6feb80bae0a16fdabf54c64acd06a623
+  data.tar.gz: 9bb9aba97c0df9dbc335f5620a5c3750561e032a
 SHA512:
-  metadata.gz: 5f1896ded2fe952ad1f36ac6ba49e24c38d67c738ab5525dd69cd00d7a48db6529aa5dc1bf8b8e3d69fd1d5bc3ed89ff599cfa1ab075ba194229cda163fdcae1
-  data.tar.gz: cb890cb61ef86bce2374b887b76aa58167d8f59d2df6cb82e0c3e0bae97a66adba1f57dc527d8dd0f86461fdc224bce2a90a1011122237723f67dbe34678492c
+  metadata.gz: e41f03ced1bcc54b3492b60762e4c1c192e60d3542495abead4271b63cf9c4ace344852293a6aece1bdc510a6041d34c32491efad9ab2961c53f72e1a6eec1ce
+  data.tar.gz: 08fd2506399710df17ef6bedc00ea008ab0da394934ccb8d8d3d7b9e2c38015b5deb62540fa818d31b1df29cc3b6ea28c69c7810b93d01afde155ca808a01519

data/.gitignore

@@ -1,14 +1,41 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
+*.gem
+*.rbc
+/.config
 /coverage/
-/doc/
+/InstalledFiles
 /pkg/
 /spec/reports/
+/test/tmp/
+/test/version_tmp/
 /tmp/
-*.bundle
-*.so
-*.o
-*.a
-mkmf.log
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+
+# Added by Felix
+/*.itmsp
+.idea
+spec/fixtures/*.itmsp/*.png
+/integration

data/.rspec

@@ -0,0 +1 @@
+--color --require spec_helper --format d

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+before_install: gem update --system
+rvm:
+  - 2.0.0
+  - 2.1.0
+addons:
+    code_climate:
+        repo_token: 260bfcb1b7acf86c3a2424724879c02401d7fc9fc59ac7ca7dfa4b8c39bd1015

data/.yardopts

@@ -0,0 +1 @@
+yardoc --no-private lib/**/*.rb

data/Gemfile.lock

@@ -0,0 +1,106 @@
+PATH
+  remote: .
+  specs:
+    deliver (0.1.0)
+      capybara (~> 2.4.3)
+      colored
+      commander (~> 4.2.0)
+      fastimage (~> 1.6.3)
+      highline (~> 1.6.21)
+      nokogiri (~> 1.6.3.1)
+      plist (~> 3.1.0)
+      poltergeist (~> 1.5.1)
+      prawn
+      rubyzip (~> 1.1.6)
+      security (~> 0.1.3)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.6)
+    capybara (2.4.4)
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      xpath (~> 2.0)
+    cliver (0.3.2)
+    codeclimate-test-reporter (0.4.1)
+      simplecov (>= 0.7.1, < 1.0.0)
+    coderay (1.1.0)
+    colored (1.2)
+    commander (4.2.0)
+      highline (~> 1.6.11)
+    crack (0.4.2)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    fastimage (1.6.3)
+      addressable (~> 2.3, >= 2.3.5)
+    highline (1.6.21)
+    method_source (0.8.2)
+    mime-types (2.4.2)
+    mini_portile (0.6.0)
+    multi_json (1.10.1)
+    nokogiri (1.6.3.1)
+      mini_portile (= 0.6.0)
+    pdf-core (0.4.0)
+    plist (3.1.0)
+    poltergeist (1.5.1)
+      capybara (~> 2.1)
+      cliver (~> 0.3.1)
+      multi_json (~> 1.0)
+      websocket-driver (>= 0.2.0)
+    prawn (1.3.0)
+      pdf-core (~> 0.4.0)
+      ttfunk (~> 1.4.0)
+    pry (0.10.1)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rack (1.5.2)
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    rake (10.3.2)
+    rspec (3.1.0)
+      rspec-core (~> 3.1.0)
+      rspec-expectations (~> 3.1.0)
+      rspec-mocks (~> 3.1.0)
+    rspec-core (3.1.5)
+      rspec-support (~> 3.1.0)
+    rspec-expectations (3.1.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.1.0)
+    rspec-mocks (3.1.2)
+      rspec-support (~> 3.1.0)
+    rspec-support (3.1.1)
+    rubyzip (1.1.6)
+    safe_yaml (1.0.4)
+    security (0.1.3)
+    simplecov (0.9.1)
+      docile (~> 1.1.0)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    slop (3.6.0)
+    ttfunk (1.4.0)
+    webmock (1.19.0)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+    websocket-driver (0.3.5)
+    xpath (2.0.0)
+      nokogiri (~> 1.3)
+    yard (0.8.7.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  codeclimate-test-reporter
+  deliver!
+  pry
+  rake
+  rspec (~> 3.1.0)
+  webmock (~> 1.19.0)
+  yard (~> 0.8.7.4)

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Felix Krause
+
+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

@@ -1,31 +1,282 @@
-# Deliver
+<p align="center">
+    <img src="assets/deliver.png">
+</p>
 
-TODO: Write a gem description
+Deliver - Continuous Deployment for iOS
+============
 
-## Installation
+[![Twitter: @KauseFx](https://img.shields.io/badge/contact-@KrauseFx-blue.svg?style=flat)](https://twitter.com/KrauseFx)
+[![License](http://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/KrauseFx/deliver/blob/develop/LICENSE)
+[![Gem](https://img.shields.io/gem/v/deliver.svg?style=flat)](http://rubygems.org/gems/deliver)
+[![Build Status](https://img.shields.io/travis/KrauseFx/deliver/master.svg?style=flat)](https://travis-ci.org/KrauseFx/deliver)
 
-Add this line to your application's Gemfile:
 
+Updating your iOS app should not be painful and time consuming. Automate the 
+whole process to start with Continuous Deployment.
+
+```Deliver``` **can upload ipa files, app screenshots and more to the iTunesConnect backend**, which means, you can deploy new iPhone app updates just by using one command.
+
+Follow the developer on Twitter: [@KrauseFx](https://twitter.com/KrauseFx)
+
+
+-------
+[Features](#features) &bull;
+[Installation](#installation) &bull;
+[Quick Start](#quick-start) &bull;
+[Usage](#usage) &bull;
+[Credentials](#credentials) &bull;
+[Can I trust Deliver?](#can-i-trust-deliver) &bull;
+[Tips](#tips) &bull;
+[Need help?](#need-help)
+
+-------
+
+
+# Features
+- Upload hundreds of screenshots with different languages from different devices
+- Upload a new ipa file to iTunesConnect without Xcode from any computer
+- Update app metadata
+- Easily implement a real Continuous Deployment process
+- Store the configuration in git to easily deploy from **any** computer, including your Continuous Integration server (e.g. Jenkins)
+- Get a PDF preview of the fetched metadata before uploading the app metadata and screenshots to Apple: [Example Preview](https://github.com/krausefx/deliver/blob/master/assets/PDFExample.png?raw=1) (Yes, those are screenshots on taken for all screen sizes)
+
+# Installation
+
+Install the gem
+
+    sudo gem install deliver
+
+Make sure, you have the latest version of the Xcode command line tools installed:
+
+    xcode-select --install
+
+Install phantomjs (this is needed to control the iTunesConnect frontend)
+
+    brew update && brew install phantomjs
+
+If you don't have homebrew installed already, [install it here](http://brew.sh/).
+
+# Quick Start
+
+
+The guide will create all the necessary files for you, using the existing app metadata from iTunesConnect.
+
+- ```cd [your_project_folder]```
+- ```deliver init```
+- When your app is already in the AppStore: ```y```
+ - Enter your iTunesConnect credentials
+ - Enter your app identifier
+ - Enjoy a good drink, while the computer does all the work for you
+- When it's a new app: ```n```
+
+Copy your screenshots into the ```deliver/screenshots/[language]``` folders (see [Available language codes](#available-language-codes))
+
+From now on, you can run ```deliver``` to deploy a new update, or just upload new app metadata and screenshots.
+
+### Customize the ```Deliverfile```
+Open the ```Deliverfile``` using a text editor and customize it even further. Take a look at the following settings:
+
+- ```ipa```: You can either pass a static path to an ipa file, or add your custom build script.
+- ```unit_tests```: Uncomment the code to run tests. (e.g. using [xctool](https://github.com/facebook/xctool))
+
+# Usage
+
+Why should you have to remember complicated commands and parameters?
+
+Store your configuration in a text file to easily deploy from any computer.
+
+Run ```deliver init``` to create a new ```Deliverfile```. You can either let the wizard generate a file based on the metadata from iTunesConnect or create one from a template.
+
+Once you created your configuration, just run ```deliver```.
+
+Here are a few example files:
+#### Upload screenshots to iTunesConnect
 ```ruby
-gem 'deliver'
+app_identifier "net.sunapps.1"
+version "1.1"
+
+screenshots_path "./screenshots"
 ```
+The screenshots folder must include one subfolder per language (see [Available language codes](#available-language-codes))
 
-And then execute:
+#### Upload a new ipa file with a changelog to the AppStore
+This will submit a new update to Apple
+```ruby
+ipa "./latest.ipa"
+changelog({
+    "en-US" => "This update adds cool new features",
+    "de-DE" => "Dieses Update ist super"
+})
+```
 
-    $ bundle
 
-Or install it yourself as:
+#### Implement blocks to run unit tests
+```ruby
+unit_tests do
+    system("xctool test")
+end
+
+success do
+    notifier = Slack::Notifier.new("SlackTeam", "SlackToken")
+    notifier.ping "Successfully deployed new version"
+end
+
+error do |exception|
+    # custom exception handling here
+    raise "Something went wrong: #{exception}"    
+end
+```
+For this example I used [slack-notifier](https://github.com/stevenosloan/slack-notifier).
+
 
-    $ gem install deliver
+#### Set a default language if you are lucky enough to only maintain one language
+```ruby
+default_language "en-US"
+version "1.2"
+
+title "Only English Title"
+```
+If you do not pass an ipa file, you have to specify the app version you want to edit.
+
+#### Update the app's keywords
+```ruby
+default_language "de-DE"
+version "1.2"
+
+keywords ["keyword1", "something", "else"]
+```
+
+#### Read content from somewhere external (file, web service, ...)
+```ruby
+description({
+    "en-US" => File.read("changelog-en.txt")
+    "de-DE" => open("http://example.com/latest-changelog.txt").read
+})
+```
+
+#### Build and sign the app
+I'm using [Shenzhen](https://github.com/nomad/shenzhen), but you can use any build tool or custom scripts.
+```ruby
+ipa do
+    # Add any code you want, like incrementing the build 
+    # number or changing the app identifier
+  
+    system("ipa build") # build your project using Shenzhen
+    "./AppName.ipa" # Tell 'Deliver' where it can find the finished ipa file
+end
+```
+
+##### What is the ```Deliverfile```?
+As you can see, the ```Deliverfile``` is a normal Ruby file, which is executed when
+running a deployment. Therefore it's possible to fully customise the behaviour
+on a deployment. 
+
+All available commands with a short description can be found in the [wiki](https://github.com/KrauseFx/deliver/wiki/All-available-commands-of-the-Deliverfile).
+
+**Some examples:**
+
+- Run your own unit tests or integration tests before a deploy (recommended)
+- Ask the script user for a changelog
+- Deploy a new version just by starting a Jenkins job
+- Post the deployment status on Slack
+- Upload the latest screenshots on your server
+- Many more things, be creative and let me know :)
+    
+#### Use the exposed Ruby classes
+Some examples:
+```ruby
+require 'deliver'
+
+app = Deliver::App.new(app_identifier: 'at.felixkrause.app')
+
+app.get_app_status # => Waiting for Review
+app.create_new_version!("1.4")
+app.metadata.update_title({ "en-US" => "iPhone App Title" })
+app.metadata.set_all_screenshots_from_path("./screenshots")
+app.upload_metadata!
+app.itc.submit_for_review!(app)
+
+Deliver::ItunesSearchApi.fetch_by_identifier("net.sunapps.15") # => Fetches public metadata
+```
+This project is well documented, check it out on [Rubydoc](http://www.rubydoc.info/github/KrauseFx/deliver/frames).
+
+
+# Credentials
+
+## Use the Keychain
+The first time you use *Deliver* you have to enter your iTunesConnect 
+credentials. They will be stored in the Keychain. 
+
+If you decide to remove your
+credentials from the Keychain, just open the *Keychain Access*, select 
+*All Items* and search for 'itunesconnect.apple.com'.
+
+## Use environment variables
+You can use the following environment variables to use a specific account instead of the one stored in the keychain:
+
+    DELIVER_USER
+    DELIVER_PASSWORD
+    
+## Implement your custom solution
+Take a look at [Using the exposed Ruby classes](use-the-exposed-ruby-classes).
+
+# Can I trust *Deliver*? 
+###How does this thing even work? Is magic involved? 🎩###
+
+```Deliver``` is fully open source, you can take a look at it. It will only modify the content you want to modify using the ```Deliverfile```. Your password will be stored in the Mac OS X keychain, but can also be passed using environment variables.
+
+Before actually uploading anything to iTunes, ```Deliver``` will generate a [PDF summary](https://github.com/krausefx/deliver/blob/master/assets/PDFExample.png?raw=1) of the collected data. 
+
+```Deliver``` uses the following techniques under the hood:
+
+- The iTMSTransporter tool is used to fetch the latest app metadata from iTunesConnect and upload the updated app metadata back to Apple. It is also used to upload the ipa file. iTMSTransporter is a command line tool provided by Apple.
+- With the iTMSTransporter you cannot create new version on iTunesConnect or actually publish the newly uploaded ipa file. This is why there is some browser scripting involved, using [Capybara](https://github.com/jnicklas/capybara) and [Poltergeist](https://github.com/teampoltergeist/poltergeist).
+- The iTunes search API to find missing information about a certain app, like the *apple_id* when you only pass the *bundle_identifier*. 
+
+# Tips
+## Available language codes
+```ruby
+["da-DK", "de-DE", "el-GR", "en-AU", "en-CA", "en-GB", "en-US", "es-ES", "es-MX", "fi-FI", "fr-CA", "fr-FR", "id-ID", "it-IT", "ja-JP", "ko-KR", "ms-MY", "nl-NL", "no-NO", "pt-BR", "pt-PT", "ru-RU", "sv-SE", "th-TH", "tr-TR", "vi-VI", "cmn-Hans", "zh_CN", "cmn-Hant"]
+```
+
+## Use a clean status bar
+You can use [SimulatorStatusMagic](https://github.com/shinydevelopment/SimulatorStatusMagic) to clean up the status bar.
+
+## Automatically create screenshots
+There is no optimal solution out there (yet).
+
+Some open source tools I found helpful:
+
+- **[Subliminal](https://github.com/inkling/Subliminal)**: Write your app interaction (e.g. taps) in Objective C. Is based on UIAutomation and is well documented. Currently there are some issues with the latest release of Xcode, which are partly solved in the Xcode6 branch. Checkout my public [gist](https://gist.github.com/KrauseFx/fda87474855dfe0051e6) for running Subliminal on different devices and generating a HTML site viewing all screenshots.
+- **[ui-screen-shooter](https://github.com/jonathanpenn/ui-screen-shooter)**: Makes use of the normal UIAutomation code based on Javascript. The script basically helps you switching the device type and simulator language. It is based on AppleScript.
+- **[rScreenshooter](https://github.com/KrauseFx/rScreenshooter)**: Similar to ui-screen-shooter, but based on Ruby. 
+
+```Deliver``` automatically detects the device type of each screenshot based on its resolution. All you have to do is to group the screenshots by their language. Make sure you use the correct language codes.
+
+## Editing the ```Deliverfile```
+Change syntax highlighting to *Ruby*.
+
+## In progress
+These are features, which are implemented, but not yet fully tested and production ready. You can try it on your own risk.
+
+#### Distribute an ipa file to your TestFlight beta testers
+```ruby
+beta_ipa "./latest.ipa"
+```
+This will upload the ipa file to iTunesConnect and mark the uploaded build as Beta build.
 
-## Usage
+# Need help?
+- If there is a technical problem with ```Deliver```, submit an issue. Run ```deliver --trace``` to get the stacktrace.
+- I'm available for contract work - drop me an email: deliver@felixkrause.at
 
-TODO: Write usage instructions here
+# License
+This projected is licensed under the terms of the MIT license. See the LICENSE file.
 
-## Contributing
+# Contributing
 
-1. Fork it ( https://github.com/[my-github-username]/deliver/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
+1. Create an issue to discuss about your idea
+2. Fork it (https://github.com/KrauseFx/deliver/fork)
+3. Create your feature branch (`git checkout -b my-new-feature`)
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create a new Pull Request