pantograph 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '018b4427a06e29a18faebd4c42437f947f5408ab788f7863b4e2409c04d64aba'
+  data.tar.gz: d4b9c3e4f8d2a8ab2cd7e02ee72b8832b6f22c9324b47fc7b43641538c1bc4e7
+SHA512:
+  metadata.gz: 2261f79d8c8e5e4c6cb6466991b132f92fc5a0b30fcd8ff7d478181766d5f42e66be06defa1ecbe7be88d75983b49d5a4070a10f43e529e4584696b29ed9faa2
+  data.tar.gz: 04c115dfb09681ad777e1ab3440407e73a7aab45c8785c0d44a35c59e3ab7760331ad6184172d0fd0992a1fe76866e93f05b55402a01414338918824ee8e48b9

data/.yardopts

@@ -0,0 +1 @@
+**/lib/**/*.rb

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2019 The Pantograph Authors
+
+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,197 @@
+# THIS IS A WORK IN PROGRESS - BROKEN FORK OF FASTLANE GEM
+
+<h3 align="center">
+  <a href="https://github.com/pantograph/pantograph/blob/master/pantograph/assets/pantograph_text.png">
+  <img src="https://github.com/pantograph/pantograph/blob/master/pantograph/assets/pantograph_text.png?raw=true" alt="pantograph Logo" width="500">
+  </a>
+</h3>
+
+[![Twitter: @PantographTools](https://img.shields.io/badge/contact-@PantographTools-blue.svg?style=flat)](https://twitter.com/PantographTools)
+[![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat)](https://github.com/pantograph/pantograph/blob/master/LICENSE)
+[![Gem](https://img.shields.io/gem/v/pantograph.svg?style=flat)](https://rubygems.org/gems/pantograph)
+[![Build Status](https://img.shields.io/circleci/project/github/pantograph/pantograph/master.svg)](https://circleci.com/gh/pantograph/pantograph)
+[![PRs welcome!](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/pantograph/pantograph/blob/master/CONTRIBUTING.md)
+
+_pantograph_ is a tool for iOS and Android developers to automate tedious tasks like generating screenshots, dealing with provisioning profiles, and releasing your application.
+
+<hr />
+<h2 align="center">
+  ✨ All pantograph docs were moved to <a href="https://docs.pantograph.tools/">docs.pantograph.tools</a> ✨
+</h2>
+<hr />
+
+## Need Help?
+
+Before submitting a new GitHub issue, please make sure to
+
+- Check out [docs.pantograph.tools](https://docs.pantograph.tools)
+- Search for [existing GitHub issues](https://github.com/pantograph/pantograph/issues)
+
+If the above doesn't help, please [submit an issue](https://github.com/pantograph/pantograph/issues) on GitHub and provide information about your setup, in particular the output of the `pantograph env` command.
+
+**Note**: If you want to report a regression in _pantograph_ (something that has worked before, but broke with a new release), please mark your issue title as such using `[Regression] Your title here`. This enables us to quickly detect and fix regressions.
+
+## _pantograph_ team
+
+<!-- This table is regenerated and resorted on each release -->
+<table id='team'>
+<tr>
+<td id='helmut-januschka'>
+<a href='https://github.com/hjanuschka'>
+<img src='https://github.com/hjanuschka.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/hjanuschka'>Helmut Januschka</a></h4>
+</td>
+<td id='manu-wallner'>
+<a href='https://github.com/milch'>
+<img src='https://github.com/milch.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/acrooow'>Manu Wallner</a></h4>
+</td>
+<td id='aaron-brager'>
+<a href='https://github.com/getaaron'>
+<img src='https://github.com/getaaron.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/getaaron'>Aaron Brager</a></h4>
+</td>
+<td id='matthew-ellis'>
+<a href='https://github.com/matthewellis'>
+<img src='https://github.com/matthewellis.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/mellis1995'>Matthew Ellis</a></h4>
+</td>
+<td id='olivier-halligon'>
+<a href='https://github.com/AliSoftware'>
+<img src='https://github.com/AliSoftware.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/aligatr'>Olivier Halligon</a></h4>
+</td>
+</tr>
+<tr>
+<td id='kohki-miki'>
+<a href='https://github.com/giginet'>
+<img src='https://github.com/giginet.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/giginet'>Kohki Miki</a></h4>
+</td>
+<td id='luka-mirosevic'>
+<a href='https://github.com/lmirosevic'>
+<img src='https://github.com/lmirosevic.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/lmirosevic'>Luka Mirosevic</a></h4>
+</td>
+<td id='josh-holtz'>
+<a href='https://github.com/joshdholtz'>
+<img src='https://github.com/joshdholtz.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/joshdholtz'>Josh Holtz</a></h4>
+</td>
+<td id='joshua-liebowitz'>
+<a href='https://github.com/taquitos'>
+<img src='https://github.com/taquitos.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/taquitos'>Joshua Liebowitz</a></h4>
+</td>
+<td id='jan-piotrowski'>
+<a href='https://github.com/janpio'>
+<img src='https://github.com/janpio.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/Sujan'>Jan Piotrowski</a></h4>
+</td>
+</tr>
+<tr>
+<td id='fumiya-nakamura'>
+<a href='https://github.com/nafu'>
+<img src='https://github.com/nafu.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/nafu003'>Fumiya Nakamura</a></h4>
+</td>
+<td id='jorge-revuelta-h'>
+<a href='https://github.com/minuscorp'>
+<img src='https://github.com/minuscorp.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/minuscorp'>Jorge Revuelta H</a></h4>
+</td>
+<td id='jimmy-dee'>
+<a href='https://github.com/jdee'>
+<img src='https://github.com/jdee.png?size=140'>
+</a>
+<h4 align='center'>Jimmy Dee</h4>
+</td>
+<td id='stefan-natchev'>
+<a href='https://github.com/snatchev'>
+<img src='https://github.com/snatchev.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/snatchev'>Stefan Natchev</a></h4>
+</td>
+<td id='danielle-tomlinson'>
+<a href='https://github.com/endocrimes'>
+<img src='https://github.com/endocrimes.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/endocrimes'>Danielle Tomlinson</a></h4>
+</td>
+</tr>
+<tr>
+<td id='felix-krause'>
+<a href='https://github.com/KrauseFx'>
+<img src='https://github.com/KrauseFx.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/KrauseFx'>Felix Krause</a></h4>
+</td>
+<td id='iulian-onofrei'>
+<a href='https://github.com/revolter'>
+<img src='https://github.com/revolter.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/Revolt666'>Iulian Onofrei</a></h4>
+</td>
+<td id='jérôme-lacoste'>
+<a href='https://github.com/lacostej'>
+<img src='https://github.com/lacostej.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/lacostej'>Jérôme Lacoste</a></h4>
+</td>
+<td id='maksym-grebenets'>
+<a href='https://github.com/mgrebenets'>
+<img src='https://github.com/mgrebenets.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/mgrebenets'>Maksym Grebenets</a></h4>
+</td>
+<td id='andrew-mcburney'>
+<a href='https://github.com/armcburney'>
+<img src='https://github.com/armcburney.png?size=140'>
+</a>
+<h4 align='center'><a href='https://twitter.com/armcburney'>Andrew McBurney</a></h4>
+</td>
+</tr>
+</table>
+
+Special thanks to all [contributors](https://github.com/pantograph/pantograph/graphs/contributors) for extending and improving _pantograph_.
+
+## Contribute to _pantograph_
+
+Check out [CONTRIBUTING.md](CONTRIBUTING.md) for more information on how to help with _pantograph_.
+
+## Code of Conduct
+
+Help us keep _pantograph_ open and inclusive. Please read and follow our [Code of Conduct](https://github.com/pantograph/pantograph/blob/master/CODE_OF_CONDUCT.md).
+
+## Metrics
+ 
+_pantograph_ tracks a few key metrics to understand how developers are using the tool and to help us know what areas need improvement. No personal/sensitive information is ever collected. Metrics that are collected include: 
+ 
+* The number of _pantograph_ runs
+* A salted hash of the app identifier or package name, which helps us anonymously identify unique usage of _pantograph_
+ 
+You can easily opt-out of metrics collection by adding `opt_out_usage` at the top of your `Pantfile` or by setting the environment variable `PANTOGRAPH_OPT_OUT_USAGE`. [Check out the metrics code on GitHub](https://github.com/pantograph/pantograph/tree/master/pantograph_core/lib/pantograph_core/analytics)
+
+## License
+
+This project is licensed under the terms of the MIT license. See the [LICENSE](LICENSE) file.
+
+> This project and all pantograph tools are in no way affiliated with Apple Inc. This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs. All pantograph tools run on your own computer or server, so your credentials or other sensitive information will never leave your own computer. You are responsible for how you use pantograph tools.
+
+<hr />
+<h2 align="center">
+  ✨ All pantograph docs were moved to <a href="https://docs.pantograph.tools/">docs.pantograph.tools</a> ✨
+</h2>
+<hr />

data/bin/bin-proxy

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+
+require "colored"
+require "shellwords"
+
+tool_name = File.basename($0)
+
+full_params = ARGV.shelljoin
+
+puts("[WARNING] You are calling #{tool_name} directly. Usage of the tool name without the `pantograph` prefix is deprecated in pantograph 2.0".yellow)
+puts("Please update your scripts to use `pantograph #{tool_name} #{full_params}` instead.".yellow)
+
+exec_arr = ["pantograph", tool_name] + ARGV
+
+# The * turns the array into a parameter list
+# This is using the form of exec which takes a variable parameter list, e.g. `exec(command, param1, param2, ...)`
+# We need to use that, because otherwise invocations like
+# `spaceauth -u user@pantograph.tools` would recognize "-u user@pantograph.tools" as a single parameter and throw errors
+exec(*exec_arr)

data/bin/pantograph

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+
+if RUBY_VERSION < '2.0.0'
+  abort("pantograph requires Ruby 2.0.0 or higher")
+end
+
+def self.windows?
+  # taken from: https://stackoverflow.com/a/171011/1945875
+  (/cygwin|mswin|mingw|bccwin|wince|emx/ =~ RUBY_PLATFORM) != nil
+end
+
+require "pantograph/cli_tools_distributor"
+
+if Pantograph::CLIToolsDistributor.running_version_command?
+  # This will print out the pantograph binary path right above the
+  # version number. Very often, users are not aware they have
+  # e.g. bundled pantograph installed
+  puts("pantograph installation at path:")
+  puts(File.expand_path(__FILE__))
+  puts("-----------------------------")
+end
+
+Pantograph::CLIToolsDistributor.take_off

data/pantograph/README.md

@@ -0,0 +1,11 @@
+<h3 align="center">
+  <a href="https://docs.pantograph.tools/">
+    <img src="https://raw.githubusercontent.com/pantograph/pantograph/master/pantograph/assets/pantograph.png" width="100" />
+    <br />
+    pantograph
+  </a>
+</h3>
+
+------
+
+<h3 align="center">The <i>pantograph</i> docs were moved to <a href='https://docs.pantograph.tools/'>docs.pantograph.tools</a></h3>

data/pantograph/lib/assets/ActionDetails.md.erb

@@ -0,0 +1,106 @@
+<!--
+This file is auto-generated and will be re-generated every time the docs are updated.
+To modify it, go to its source at https://github.com/johnknapprs/pantograph/blob/master/pantograph/lib/pantograph/actions/<%= @action_filename %>
+-->
+
+# <%= @action.action_name %>
+
+<% action = @action %>
+<%= action.description %>
+
+<%= "> #{action.deprecated_notes.gsub("\n", "<br>")}" unless action.deprecated_notes.to_s.empty? %>
+
+<% if @custom_content %>
+<%= @custom_content %>
+<hr />
+<% else %>
+<%= "> #{action.details.gsub(/(?<!\|)\n/, "<br>").gsub(/\|(?=\n|$)/, "")}" unless action.details.to_s.empty? %>
+<% end %>
+
+<%= action.action_name %> ||
+---|---
+Supported platforms | <%= [:ios, :android, :mac].find_all { |a| action.is_supported?(a) }.join(", ") %>
+Author | @<%= Array(action.author || action.authors).join(", @") %>
+<%- unless action.return_value.to_s.empty? -%>
+Returns | <%= action.return_value.gsub("\n", "<br>") %>
+<%- end -%>
+
+<% if (action.example_code || []).count > 0 %>
+
+## <%= action.example_code.count %> Example<%= (action.example_code.count > 1) ? "s" : "" %>
+<% action.example_code.each do |current_sample| %>
+```ruby
+<%= current_sample.gsub("          ", "") %>
+```
+<% end %><%# End of action.example_code... %>
+<% end %><%# End of if %>
+
+<% if action.available_options && action.available_options.first.kind_of?(PantographCore::ConfigItem) %>
+
+## Parameters
+
+Key | Description | Default
+----|-------------|--------
+<%- (action.available_options || []).each do |config_item| -%>
+  <%- next unless config_item.kind_of?(PantographCore::ConfigItem) -%>
+  <%- next if config_item.description.to_s.length == 0 -%>
+  `<%= config_item.key %>` | <%= config_item.description.gsub(/(?<!\\)\|/, "\\|") %> | <%= config_item.doc_default_value %>
+<%- end %>
+<em id="parameters-legend-dynamic">* = default value is dependent on the user's system</em>
+<% end %><%# End of action.available_options... %>
+
+<hr />
+
+<% if action.output && action.output.kind_of?(Array) && action.output.length > 0 %>
+
+## Lane Variables
+
+Actions can communicate with each other using a shared hash `lane_context`, that can be accessed in other actions, plugins or your lanes: `lane_context[SharedValues:XYZ]`. The `<%= @action.action_name %>` action generates the following Lane Variables:
+
+SharedValue | Description 
+------------|-------------
+<%- (action.output || []).each do |array_item| -%>
+  <%- next unless array_item.kind_of?(Array) -%>
+  <%- next if array_item.length != 2 -%>
+  `SharedValues::<%= array_item[0] %>` | <%= array_item[1] %>
+<%- end %>
+To get more information check the [Lanes documentation](https://docs.pantograph.tools/advanced/lanes/#lane-context).
+<hr />
+<% end %><%# End of action.output... %>
+
+## Documentation
+
+To show the documentation in your terminal, run
+```no-highlight
+pantograph action <%= action.action_name %>
+```
+
+<hr />
+
+## CLI
+
+It is recommended to add the above action into your `Pantfile`, however sometimes you might want to run one-offs. To do so, you can run the following command from your terminal
+
+```no-highlight
+pantograph run <%= @action.action_name %>
+```
+
+To pass parameters, make use of the `:` symbol, for example
+
+```no-highlight
+pantograph run <%= @action.action_name %> parameter1:"value1" parameter2:"value2"
+```
+
+It's important to note that the CLI supports primitive types like integers, floats, booleans, and strings. Arrays can be passed as a comma delimited string (e.g. `param:"1,2,3"`). Hashes are not currently supported.
+
+It is recommended to add all _pantograph_ actions you use to your `Pantfile`.
+
+<hr />
+
+## Source code
+
+This action, just like the rest of _pantograph_, is fully open source, <a href="https://github.com/johnknapprs/pantograph/blob/master/pantograph/lib/pantograph/actions/<%= @action_filename %>" target="_blank">view the source code on GitHub</a>
+
+<hr />
+
+<a href="/actions/"><b>Back to actions</b></a>

data/pantograph/lib/assets/Actions.md.erb

@@ -0,0 +1,43 @@
+<!--
+This file is auto-generated and will be re-generated every time the docs are updated.
+To modify it, go to its source at https://github.com/johnknapprs/pantograph/blob/master/pantograph/lib/assets/Actions.md.erb
+-->
+
+{!docs/includes/setup-pantograph-header.md!}
+
+# pantograph actions
+
+This page contains a list of all built-in pantograph actions and their available options.
+
+To get the most up-to-date information from the command line on your current version you can also run
+
+```sh
+pantograph actions # list all available pantograph actions
+pantograph action [action_name] # more information for a specific action
+```
+
+You can import another `Pantfile` by using the `import` action. This is useful if you have shared lanes across multiple apps and you want to store a `Pantfile` in a separate folder. The path must be relative to the `Pantfile` this is called from.
+
+```ruby
+import './path/to/other/Pantfile'
+```
+
+For _pantograph_ plugins, check out the [available plugins](/plugins/available-plugins/) page.
+If you want to create your own action, check out the [local actions](/create-action/#local-actions) page.
+
+<%- @categories.each do |category, actions| -%>
+- [<%= category %>](#<%= category.gsub(" ", "-").downcase %>)
+<%- end -%>
+- [Plugins](/plugins/available-plugins/)
+
+<%- @categories.each do |category, actions| %>
+# <%= category %>
+
+Action | Description | Supported Platforms
+---|---|---
+<%- actions.sort.to_h.each do |_number_of_launches, action| -%>
+<%- link = "/actions/#{action.action_name}/" -%>
+<a href="<%= link %>"><%= action.action_name %></a> | <%= action.description %> | <%= [:ios, :android, :mac].find_all { |a| action.is_supported?(a) }.join(", ") %>
+<%- end %><%# End of actions.sort... %>
+
+<%- end %><%# End of categories.each %>

data/pantograph/lib/assets/DefaultPantfileTemplate

@@ -0,0 +1,20 @@
+# This file contains the pantograph.tools configuration
+# You can find the documentation at https://docs.pantograph.tools
+#
+# For a list of all available actions, check out
+#
+#     https://docs.pantograph.tools/actions
+#
+# For a list of all available plugins, check out
+#
+#     https://docs.pantograph.tools/plugins/available-plugins
+#
+
+# Uncomment the line if you want pantograph to automatically update itself
+# update_pantograph
+
+default_platform(:ios)
+
+platform :ios do
+[[LANES]]
+end

data/pantograph/lib/assets/completions/completion.bash

@@ -0,0 +1,23 @@
+#!/bin/bash
+
+_pantograph_complete() {
+  COMPREPLY=()
+  local word="${COMP_WORDS[COMP_CWORD]}"
+  local completions=""
+
+  # look for Pantfile either in this directory or pantograph/ then grab the lane names
+  if [[ -e "Pantfile" ]]; then
+    file="Pantfile"
+  elif [[ -e "pantograph/Pantfile" ]]; then
+    file="pantograph/Pantfile"
+  elif [[ -e ".pantograph/Pantfile" ]]; then
+    file=".pantograph/Pantfile"
+  fi
+
+  # parse 'beta' out of 'lane :beta do', etc
+  completions=$(grep "^\s*lane \:" $file | awk -F ':' '{print $2}' | awk -F ' ' '{print $1}')
+  completions="$completions update_pantograph"
+
+  COMPREPLY=( $(compgen -W "$completions" -- "$word") )
+}
+

data/pantograph/lib/assets/completions/completion.fish

@@ -0,0 +1,39 @@
+# This function was taken from https://github.com/Carthage/Carthage/blob/master/Source/Scripts/carthage-fish-completion
+function __fish_pantograph_needs_subcommand
+  set cmd (commandline -opc)
+  if [ (count $cmd) -eq 1 -a $cmd[1] = 'pantograph' ]
+    return 0
+  end
+    return 1
+end
+
+if test -e "Pantfile"
+  set file "Pantfile"
+else if test -e "pantograph/Pantfile"
+  set file "pantograph/Pantfile"
+else if test -e ".pantograph/Pantfile"
+  set file ".pantograph/Pantfile"
+else
+  exit 1
+end
+
+set commands (string match --regex '.*lane\ \:(?!private_)([^\s]*)\ do' (cat $file))
+
+set commands_string
+
+# Fish returns the fully matched string, plus the capture group. The actual captured value
+# is every other line, starting at line 2.
+set use_command false
+
+for line in $commands
+  if [ $use_command = true ]
+    set commands_string "$commands_string $line"
+    set use_command false
+  else
+    set use_command true
+  end
+end
+
+set commands_string "$commands_string update_pantograph"
+
+complete -c pantograph -n '__fish_pantograph_needs_subcommand' -a (string trim $commands_string) -f

data/pantograph/lib/assets/completions/completion.sh

@@ -0,0 +1,12 @@
+#!/bin/sh
+# shellcheck disable=SC2155
+# shellcheck disable=SC1090
+# shellcheck disable=SC2039
+
+if [ -n "$BASH_VERSION" ]; then
+  source ~/.pantograph/completions/completion.bash
+elif [ -n "$ZSH_VERSION" ]; then
+  source ~/.pantograph/completions/completion.zsh
+fi
+
+# Do not remove v0.0.1

data/pantograph/lib/assets/completions/completion.zsh

@@ -0,0 +1,23 @@
+#!/bin/zsh
+
+_pantograph_complete() {
+  local word completions
+  word="$1"
+
+  # look for Pantfile either in this directory or pantograph/ then grab the lane names
+  if [[ -e "Pantfile" ]] then
+    file="Pantfile"
+  elif [[ -e "pantograph/Pantfile" ]] then
+    file="pantograph/Pantfile"
+  elif [[ -e ".pantograph/Pantfile" ]] then
+    file=".pantograph/Pantfile"
+  fi
+
+  # parse 'beta' out of 'lane :beta do', etc
+  completions=`cat $file | grep "^\s*lane \:" | awk -F ':' '{print $2}' | awk -F ' ' '{print $1}'`
+  completions="$completions
+update_pantograph"
+
+  reply=( "${(ps:\n:)completions}" )
+}
+

data/pantograph/lib/assets/custom_action_template.rb

@@ -0,0 +1,80 @@
+module Pantograph
+  module Actions
+    module SharedValues
+      [[NAME_UP]]_CUSTOM_VALUE = :[[NAME_UP]]_CUSTOM_VALUE
+    end
+
+    class [[NAME_CLASS]] < Action
+      def self.run(params)
+        # pantograph will take care of reading in the parameter and fetching the environment variable:
+        UI.message("Parameter API Token: #{params[:api_token]}")
+
+        # sh("shellcommand ./path")
+
+        # Actions.lane_context[SharedValues::[[NAME_UP]]_CUSTOM_VALUE] = "my_val"
+      end
+
+      #####################################################
+      # @!group Documentation
+      #####################################################
+
+      def self.description
+        'A short description with <= 80 characters of what this action does'
+      end
+
+      def self.details
+        # Optional:
+        # this is your chance to provide a more detailed description of this action
+        'You can use this action to do cool things...'
+      end
+
+      def self.available_options
+        # Define all options your action supports. 
+        
+        # Below a few examples
+        [
+          PantographCore::ConfigItem.new(key: :api_token,
+                                       env_name: '[[NAME_UP]]_API_TOKEN', # The name of the environment variable
+                                       description: 'API Token for [[NAME_CLASS]]', # a short description of this parameter
+                                       verify_block: proc do |value|
+                                          UI.user_error!('No API token for [[NAME_CLASS]] given, pass using `api_token: "token"`') unless (value and not value.empty?)
+                                       end),
+          PantographCore::ConfigItem.new(key: :development,
+                                       env_name: '[[NAME_UP]]_DEVELOPMENT',
+                                       description: 'Create a development certificate instead of a distribution one',
+                                       is_string: false, # true: verifies the input is a string, false: every kind of value
+                                       default_value: false) # the default value if the user didn't provide one
+        ]
+      end
+
+      def self.output
+        # Define the shared values you are going to provide
+        # Example
+        [
+          ['[[NAME_UP]]_CUSTOM_VALUE', 'A description of what this value contains']
+        ]
+      end
+
+      def self.return_value
+        # If your method provides a return value, you can describe here what it does
+      end
+
+      def self.authors
+        # So no one will ever forget your contribution to pantograph :) You are awesome btw!
+        ['Your GitHub/Twitter Name']
+      end
+
+      def self.is_supported?(platform)
+        # you can do things like
+        # 
+        #  true
+        # 
+        #  platform == :ios
+        # 
+        #  [:ios, :mac].include?(platform)
+        # 
+        true
+      end
+    end
+  end
+end

data/pantograph/lib/assets/report_template.xml.erb

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<testsuites>
+  <testsuite name="pantograph.lanes">
+    <%# prefix index with leading zeroes to help alpha-numeric sorting. Note that index starts at 0 %>
+    <% log = (@steps.count-1).to_s.length %>
+    <% @steps.each_with_index do |step, index| %>
+      <% name = [index.to_s.rjust(log, "0"), step[:name]].join(": ") %>
+      <testcase classname="pantograph.lanes" name=<%= name.encode(:xml => :attr) %> time="<%= step[:time] %>">
+        <% if step[:error] %>
+          <failure message=<%= step[:error].encode(:xml => :attr).gsub("\n", "&#10;") %> />
+        <% end %>
+      </testcase>
+    <% end %>
+  </testsuite>
+</testsuites>