klimt 0.4.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cf88f548e7806cd204cdad0f709d4fcba34cf197
+  data.tar.gz: 462adaad08830d3752279b11790f99ddeaec983d
+SHA512:
+  metadata.gz: 52962eeb267cf8c8247ccd64ee2d8a9c218437eae74b1ae470a77555b85199031bfe2d849add0b656c3c98b3d2c8017834bb5e042e8387f185fef144f64dda3f
+  data.tar.gz: dd4f66ba0bb5dd9e345178927c6c266f71efe8cdef85d069d3d58809ed45c6616903431bd4b4187999bd6b4f7b3d117db0727daae4a1e46e33b3cc9c1506cb1b

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+
+.byebug_history
+*.gem

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop

@@ -0,0 +1 @@
+--display-cop-names

data/.rubocop.yml

@@ -0,0 +1,23 @@
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  Exclude:
+    - klimt.gemspec
+    - vendor/**/*
+
+Metrics/LineLength:
+  Max: 132 # good for desktop Github
+
+Metrics/BlockLength:
+  Exclude:
+    - spec/**/*
+
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/FormatString:
+  EnforcedStyle: percent

data/.rubocop_todo.yml

@@ -0,0 +1,29 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2017-02-10 10:19:12 -0500 using RuboCop version 0.47.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 2
+Metrics/AbcSize:
+  Max: 35
+
+# Offense count: 1
+# Configuration parameters: CountComments.
+Metrics/ClassLength:
+  Max: 110
+
+# Offense count: 1
+Metrics/CyclomaticComplexity:
+  Max: 10
+
+# Offense count: 2
+# Configuration parameters: CountComments.
+Metrics/MethodLength:
+  Max: 33
+
+# Offense count: 1
+Metrics/PerceivedComplexity:
+  Max: 13

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.0
+before_install: gem install bundler -v 1.14.3

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at anandaroop.roy+github@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Anandaroop Roy
+
+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,103 @@
+# Klimt
+[![CircleCI](https://circleci.com/gh/anandaroop/klimt.svg?style=svg)](https://circleci.com/gh/anandaroop/klimt) [![Build Status](https://travis-ci.org/anandaroop/klimt.svg?branch=master)](https://travis-ci.org/anandaroop/klimt)
+
+Klimt is a **C**ommand **L**ine **I**nterface **M**etadata **T**ool. That almost spells Klimt. So close.
+
+It makes it dead simple to view Artsy API json responses from the command line.
+
+## Usage
+
+Klimt has four basic subcommands which will work with most REST-ful endpoints in the API (see [caveat](#caveat-re-root-level-endpoints)).
+
+### View a resource
+
+Supply the model name as it appears in the v1 API endpoint, and an id:
+
+```sh
+$ klimt find partner gagosian-gallery
+$ klimt find artist damien-hirst
+```
+
+### List a collection of resources
+
+Supply the (usually plural) model name as it appears in the v1 API endpoint, and optionally some API parameters:
+
+```sh
+$ klimt list partners
+$ klimt list partners eligible_for_listing=true near=30,-90
+```
+
+### Find a resource via term search
+
+Supply the term to search for (enclosed in quotes if it contains whitespace), and optionally a list of space-delimited [indexes](https://github.com/artsy/gravity/blob/baf6bd35f4c5c1a6011d0608d641e8d6608124e7/app/api/v1/match_endpoint.rb#L150) to constrain the search.
+
+```sh
+$ klimt search "Gagosian Gallery"
+$ klimt search Gagosian --indexes=Article Artwork
+```
+
+### Count a resource
+
+Supply the (usually plural) model name as it appears in the v1 API endpoint, and optionally some API parameters:
+
+```sh
+$ klimt count cultures
+$ klimt count cultures nationalities=true
+```
+
+### Caveat re: root-level endpoints
+
+The find, list and count commands work great when the API endpoint in question is structured as a root-level endpoint rather than a nested one. So for now… `/api/v1/partner/<id>` :heavy_check_mark: but `/api/v1/partner/<id>/locations` :x:.
+
+See [the discussion](https://github.com/artsy/potential/blob/521d34796e2df87406cc0e780db1e44b1ac9884a/Playbook.md#out-with-the-old) under "Gravity's v1 API" in Potential.
+
+### Custom subcommands
+
+If a resource can't be retrieved because it's not a root-level endoint, or if some further custom behavior is desired, it's easy enough to create a new subcommand to encapsulate these  requirements, e.g. the [partner subcommand](https://github.com/anandaroop/klimt/blob/9ac2d3f341abe4d9f482d64b82a56e1248a8792b/lib/klimt/command.rb#L59-L60) or the [city subcommand](https://github.com/anandaroop/klimt/blob/9ac2d3f341abe4d9f482d64b82a56e1248a8792b/lib/klimt/command.rb#L64-L65).
+
+For example, this partner subcommand results in several fetches and a detailed report:
+
+```sh
+$ klimt partner check-locations gagosian-gallery -x=-90 -y=30
+```
+
+### Authentication
+
+Klimt — like the Heroku CLI client — uses [Netrc](https://github.com/heroku/netrc) to manage credentials. The first time you use it it will ask for a login, generate a token and save the token in `~/.netrc`.
+
+## Klimt :sparkling_heart: JQ
+
+[JQ](https://stedolan.github.io/jq/) is a command line JSON pretty-printing and transformation tool that works great with Klimt
+
+```sh
+$ klimt list partners | jq '.[] | { id, name }'
+$ klimt find partner moma-ps1 | jq '.name'
+```
+
+In fact Klimt will detect if JQ is installed, and if so will sometimes use it for nicer output, such as if you pass Klimt the `--color` flag:
+
+```sh
+$ klimt find artist andy-warhol --color
+```
+
+## Installation
+
+Since it's not distributed via RubyGems, you'll fetch and build it yourself which is as simple as: 
+
+```sh
+$ git clone https://github.com/anandaroop/klimt.git
+$ cd klimt
+# Set up your gravity keys
+$ gem build klimt.gemspec
+$ gem install klimt*.gem
+```
+
+Klimt uses a Gravity `ClientApplication`, whose id and secret you'll have to supply in your environment as `KLIMT_ID` and `KLIMT_SECRET`. (Available in 1Password)
+
+```sh
+$ KLIMT_ID=<replace> KLIMT_SECRET=<replace> klimt help
+```
+
+Or just add these env variables to your shell startup script.
+
+If you'd like auto-completion in zsh, add `eval "$(klimt zsh-completion)"` to the end of your `.zshrc`.

data/Rakefile

@@ -0,0 +1,11 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+RuboCop::RakeTask.new(:rubocop) do |t|
+  t.options = ['--display-cop-names']
+end
+
+task default: [:rubocop, :spec]

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'klimt'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/circle.yml

@@ -0,0 +1,4 @@
+test:
+  override:
+    - bundle exec rubocop
+    - bundle exec rspec

data/exe/klimt

@@ -0,0 +1,5 @@
+#! /usr/bin/env ruby
+
+require 'klimt'
+
+Klimt::Command.start

data/klimt.gemspec

@@ -0,0 +1,35 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'klimt/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'klimt'
+  spec.version       = Klimt::VERSION
+  spec.authors       = ['Anandaroop Roy']
+  spec.email         = ['anandaroop.roy+github@gmail.com']
+
+  spec.summary       = 'CLI for the Artsy API'
+  spec.homepage      = 'https://github.com/anandaroop/klimt'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.13'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'byebug', '~> 9.0'
+  spec.add_development_dependency 'webmock', '~> 2.3'
+  spec.add_development_dependency 'rubocop', '~> 0.47'
+
+  spec.add_runtime_dependency 'thor', '~> 0.19'
+  spec.add_runtime_dependency 'netrc', '~> 0.11'
+  spec.add_runtime_dependency 'highline', '~> 1.7'
+  spec.add_runtime_dependency 'typhoeus', '~> 1.1'
+  spec.add_runtime_dependency 'thor-zsh_completion', '~> 0.1'
+end

data/lib/klimt/client.rb

@@ -0,0 +1 @@
+require 'klimt/clients/gravity_client'

data/lib/klimt/clients/gravity_client.rb

@@ -0,0 +1,136 @@
+require 'netrc'
+require 'highline'
+require 'typhoeus'
+require 'json'
+
+module Klimt
+  class GravityClient
+    attr_reader :token
+
+    HOSTS = { production: 'api.artsy.net', staging: 'stagingapi.artsy.net' }.freeze
+    DEFAULT_PAGE_SIZE = 20
+
+    def initialize(env:)
+      @host = host_from_environment(env)
+      @token = find_or_create_token
+    end
+
+    def find(type:, id:)
+      uri = "https://#{@host}/api/v1/#{type}/#{id}"
+      response = Typhoeus.get(uri, headers: headers)
+      response.body
+    end
+
+    def list(type:, params: [])
+      params = parse_params(params)
+      uri = "https://#{@host}/api/v1/#{type}"
+      response = Typhoeus.get(uri, headers: headers, params: params)
+      response.body
+    end
+
+    def count(type:, params: [])
+      params = parse_params(params)
+      params[:size] = 0
+      params[:total_count] = true
+      uri = "https://#{@host}/api/v1/#{type}"
+      response = Typhoeus.get(uri, headers: headers, params: params)
+      response.headers['X-Total-Count']
+    end
+
+    def search(term:, params: [], indexes: nil)
+      params = parse_params(params)
+      params[:term] = term
+      params[:indexes] = indexes unless indexes.nil?
+      uri = "https://#{@host}/api/v1/match"
+      response = Typhoeus.get(uri, headers: headers, params: params, params_encoding: :rack) # encode arrays correctly
+      response.body
+    end
+
+    # partners
+
+    def partner_locations(id:, params: [])
+      params = parse_params(params)
+      uri = "https://#{@host}/api/v1/partner/#{id}/locations"
+      response = Typhoeus.get(uri, headers: headers, params: params)
+      response.body
+    end
+
+    def partner_locations_count(id:, params: [])
+      params = parse_params(params).merge(size: 0, total_count: true)
+      uri = "https://#{@host}/api/v1/partner/#{id}/locations"
+      response = Typhoeus.get(uri, headers: headers, params: params)
+      response.headers['X-Total-Count']
+    end
+
+    def partner_near(params: [])
+      params = parse_params(params)
+      raise ArgumentError, 'a "near=LNG,LAT" parameter is required' unless params.include? 'near'
+      uri = "https://#{@host}/api/v1/partners"
+      response = Typhoeus.get(uri, headers: headers, params: params)
+      response.body
+    end
+
+    private
+
+    # Turn this from the command line:
+    #   ["size=10", "page=2"]
+    # into this for Typhoeus:
+    #   {'size' => 10, 'page' => 2}
+    #
+    def parse_params(params)
+      Hash[params.map { |pair| pair.split('=') }]
+    end
+
+    def headers
+      {
+        'User-Agent' => "Klimt #{Klimt::VERSION}",
+        'Content-type' => 'application/json',
+        'Accept' => 'application/json',
+        'X-ACCESS-TOKEN' => @token
+      }
+    end
+
+    def host_from_environment(env)
+      HOSTS[env.to_sym]
+    end
+
+    def find_or_create_token
+      _user, token = Netrc.read[@host]
+      token || generate_token
+    end
+
+    def generate_token
+      email, pass = ask_for_credentials
+      params = {
+        client_id: ENV['KLIMT_ID'],
+        client_secret: ENV['KLIMT_SECRET'],
+        grant_type: 'credentials',
+        email: email,
+        password: pass
+      }
+      response = Typhoeus.get "https://#{@host}/oauth2/access_token", params: params
+      body = JSON.parse(response.body)
+      quit "Login failed: #{body['error_description']}" unless response.success?
+      body['access_token'].tap do |new_token|
+        netrc = Netrc.read
+        netrc[@host] = email, new_token
+        netrc.save
+      end
+    end
+
+    def quit(msg)
+      $stderr.puts msg
+      exit 1
+    end
+
+    def ask_for_credentials
+      cli = HighLine.new
+      cli.say 'No login credentials found in .netrc'
+      cli.say 'Please login now'
+      cli.say '-----'
+      email = cli.ask('Artsy email    : ') {}
+      pass  = cli.ask('Artsy password : ') { |q| q.echo = 'x' }
+      [email, pass]
+    end
+  end
+end

data/lib/klimt/command.rb

@@ -0,0 +1,69 @@
+require 'thor'
+require 'thor/zsh_completion'
+require 'klimt/commands/rendering'
+require 'klimt/commands/partner'
+require 'klimt/commands/city'
+
+module Klimt
+  class Command < Thor
+    include Klimt::Commands::Rendering
+    include ZshCompletion::Command
+
+    map %w(--version -v) => 'version'
+
+    class_option :env, desc: 'Choose environment', default: 'production', aliases: ['-e'], enum: %w(production staging)
+    class_option :color, desc: 'Colorize output (via jq)', default: false, aliases: ['-c'], type: :boolean
+
+    desc 'find TYPE ID', 'An instance of the given TYPE, identified by ID'
+    def find(type, id)
+      client = GravityClient.new(env: options[:env])
+      response = client.find(type: type, id: id)
+      render response
+    end
+
+    desc 'list TYPE [PARAMS]', 'A list of the given TYPE, optionally filtered by PARAMS'
+    def list(type, *params)
+      client = GravityClient.new(env: options[:env])
+      response = client.list(type: type, params: params)
+      render response
+    end
+
+    desc 'count TYPE [PARAMS]', 'A count of the given TYPE, optionally filtered by PARAMS'
+    def count(type, *params)
+      client = GravityClient.new(env: options[:env])
+      count = client.count(type: type, params: params)
+      puts count
+    end
+
+    desc 'search TERM', 'Search results for the given TERM, optionally filtered by PARAMS'
+    method_option :lucky, type: :boolean, desc: 'Feeling lucky? Just summarize the top hit', default: false
+    method_option :indexes, type: :array, desc: 'An array of indexes to search', banner: 'Profile Artist etc...',
+                            enum: %w(Article Artist Artist Artwork City Fair Feature Gene PartnerShow Profile Sale Tag)
+    def search(term, *params)
+      if options[:lucky]
+        params << 'size=1'
+        jq_filter = '.[0] | { model, id, display }'
+      end
+      indexes = options[:indexes] unless options[:indexes].nil?
+
+      client = GravityClient.new(env: options[:env])
+      response = client.search(term: term, params: params, indexes: indexes)
+      render response, jq_filter: jq_filter
+    end
+
+    desc 'version', 'print the version'
+    def version
+      puts Klimt::VERSION
+    end
+
+    # partner subcommands
+
+    desc 'partner', 'View subcommands that pertain to partners'
+    subcommand 'partner', Klimt::Commands::Partner
+
+    # city subcommands
+
+    desc 'city', 'View subcommands that pertain to cities'
+    subcommand 'city', Klimt::Commands::City
+  end
+end

data/lib/klimt/commands/city.rb

@@ -0,0 +1,19 @@
+module Klimt
+  module Commands
+    class City < Thor
+      include Rendering
+
+      desc 'list', 'List all currently geocoded cities from S3'
+      method_option :featured, desc: 'Restrict to just "featured" cities', type: :boolean
+      method_option :short, desc: 'Show compact output', type: :boolean
+      def list
+        file = options[:featured] ? 'featured-cities.json' : 'cities.json'
+        uri = "http://artsy-geodata.s3-website-us-east-1.amazonaws.com/partner-cities/#{file}"
+        response = Typhoeus.get(uri)
+        jq_filter = options[:short] ? '.[] | { full_name, coords }' : '.'
+        jq_options = options[:short] ? '-c' : ''
+        render response.body, jq_filter: jq_filter, jq_options: jq_options
+      end
+    end
+  end
+end

data/lib/klimt/commands/partner.rb

@@ -0,0 +1,135 @@
+require 'klimt/util/calculations'
+
+module Klimt
+  module Commands
+    class Partner < Thor
+      include Rendering
+
+      CHECK = "\u2705".freeze
+      CROSS = "\u274C".freeze
+      RADIUS = '75km'.freeze
+
+      desc 'locations PARTNER_ID [PARAMS]', 'Locations for a given partner, optionally filtered by PARAMS'
+      method_option :private, desc: 'Also include where publicly_viewable=false', type: :boolean
+      def locations(partner_id, *params)
+        params << 'private=true' if options[:private]
+        client = GravityClient.new(env: options[:env])
+        response = client.partner_locations(id: partner_id, params: params)
+        render response
+      end
+
+      desc 'near', 'Partners near a lat/lng point'
+      method_option :y, type: :numeric, required: true, desc: 'Latitude'
+      method_option :x, type: :numeric, required: true, desc: 'Longitude'
+      method_option :eligible, type: :boolean, desc: 'Only where eligible_for_listing=true'
+      method_option :type, desc: 'Filter only institutions or galleries', banner: 'PartnerInstitution | PartnerGallery'
+      def near(*params)
+        params << "near=#{options[:y]},#{options[:x]}"
+        params << 'eligible_for_listing=true' if options[:eligible]
+        client = GravityClient.new(env: options[:env])
+        response = client.partner_near(params: params)
+        render response
+      end
+
+      desc 'check-locations [PARTNER_ID]', "Check correctness of a partner's location settings"
+      method_option :y, type: :numeric, desc: 'Optionally, check only near given point'
+      method_option :x, type: :numeric, desc: 'Optionally, check only near given point'
+      def check_locations(partner_id)
+        coords = options.values_at :y, :x
+        if coords.any? && !coords.all?
+          $stderr.puts 'Must provide both X and Y'
+          exit 1
+        end
+        point = coords.all? ? coords.join(',') : nil
+        client = GravityClient.new(env: options[:env])
+        response = client.find(type: 'partner', id: partner_id)
+        partner = JSON.parse(response)
+
+        # subscriber or institution ?
+        if institution?(partner)
+          puts "#{CHECK}  Institution"
+        elsif gallery?(partner) && current_subscriber?(partner)
+          puts "#{CHECK}  Gallery with current subscription"
+        else
+          puts "#{CROSS}  Neither Institution nor current subscriber Gallery"
+          exit 1
+        end
+
+        # pubished locations?
+        public_count = published_locations_count(partner)
+        if public_count.zero?
+          puts "#{CROSS}  No publicly viewable locations"
+          exit 1
+        else
+          puts "#{CHECK}  #{public_count} publicly viewable locations"
+        end
+
+        return if point.nil?
+        # close enough to desired coords?
+        near_count = published_locations_count(partner, point: point)
+        if near_count.zero?
+          puts "#{CROSS}  No publicly viewable locations within #{RADIUS} of #{point}"
+          report_distances(partner, point: point)
+          exit 1
+        else
+          puts "#{CHECK}  #{near_count} publicly viewable locations within #{RADIUS} of #{point}"
+        end
+      end
+
+      private
+
+      def gallery?(partner)
+        partner['type'] == 'Gallery'
+      end
+
+      def institution?(partner)
+        partner['type'] == 'Institution'
+      end
+
+      def current_subscriber?(partner)
+        client = GravityClient.new(env: options[:env])
+        params = [
+          "partner_id=#{partner['id']}",
+          'current=true'
+        ]
+        response = client.count(type: 'partner_subscriptions', params: params)
+        count = response.to_i
+        count.positive?
+      end
+
+      def published_locations_count(partner, point: nil)
+        client = GravityClient.new(env: options[:env])
+        params = []
+        params << "near=#{point}" if point
+        response = client.partner_locations_count(id: partner['id'], params: params)
+        response.to_i
+      end
+
+      def unpublished_locations_count(partner, point: nil)
+        client = GravityClient.new(env: options[:env])
+        params = ['private=true']
+        params << "near=#{point}" if point
+        response = client.partner_locations_count(id: partner['id'], params: params)
+        total_count = response.to_i
+        published_count = published_locations_count(partner, point: point)
+        (total_count - published_count)
+      end
+
+      def report_distances(partner, point:)
+        params = ['private=true', 'size=100']
+        client = GravityClient.new(env: options[:env])
+        response = client.partner_locations(id: partner['id'], params: params)
+        locations = JSON.parse(response)
+        target_y, target_x = point.split(',').map(&:to_f)
+        puts "   Partner location distances from #{target_y}, #{target_x}"
+        puts '   ---------------------------------------------------------------------------'
+        locations.each do |location|
+          name, city, pub = location.values_at 'name', 'city', 'publicly_viewable'
+          loc_y, loc_x = location['coordinates'].values_at('lat', 'lng')
+          dist = Calculations.spherical_distance([loc_y, loc_x], [target_y, target_x])
+          puts '   %20.20s | %15.15s | %4s | %7.1f km | (%+.4f, %+.4f)' % [name, city, (pub ? 'pub' : 'priv'), dist, loc_y, loc_x]
+        end
+      end
+    end
+  end
+end

data/lib/klimt/commands/rendering.rb

@@ -0,0 +1,32 @@
+module Klimt
+  module Commands
+    module Rendering
+      def render(obj, jq_options: nil, jq_filter: nil)
+        if jq_installed?
+          render_with_jq(obj, opts: jq_options, filter: jq_filter)
+        else
+          render_pretty(obj)
+        end
+      end
+
+      def render_with_jq(obj, opts: nil, filter: nil)
+        opts ||= ''
+        opts << ' -C' if options[:color]
+        filter ||= '.'
+        IO.popen("jq #{opts} \"#{filter}\"", 'r+') do |p|
+          p.write obj
+          p.close_write
+          puts p.read
+        end
+      end
+
+      def render_pretty(obj)
+        puts JSON.pretty_generate JSON.parse(obj)
+      end
+
+      def jq_installed?
+        !`command -v jq`.empty?
+      end
+    end
+  end
+end

data/lib/klimt/util/calculations.rb

@@ -0,0 +1,17 @@
+include Math
+module Calculations
+  # Haversine formula for spherical distance
+  # See: https://rosettacode.org/wiki/Haversine_formula#Ruby
+
+  RADIUS = 6371 # rough radius of the Earth, in kilometers
+
+  def self.spherical_distance(start_latlng, end_latlng)
+    lat1, long1 = deg2rad(*start_latlng)
+    lat2, long2 = deg2rad(*end_latlng)
+    2 * RADIUS * asin(sqrt(sin((lat2 - lat1) / 2)**2 + cos(lat1) * cos(lat2) * sin((long2 - long1) / 2)**2))
+  end
+
+  def self.deg2rad(lat, long)
+    [lat * PI / 180, long * PI / 180]
+  end
+end

data/lib/klimt/version.rb

@@ -0,0 +1,3 @@
+module Klimt
+  VERSION = '0.4.0'.freeze
+end

data/lib/klimt.rb

@@ -0,0 +1,7 @@
+require 'klimt/version'
+require 'klimt/command'
+require 'klimt/client'
+
+module Klimt
+  # Your code goes here...
+end

metadata

@@ -0,0 +1,224 @@
+--- !ruby/object:Gem::Specification
+name: klimt
+version: !ruby/object:Gem::Version
+  version: 0.4.0
+platform: ruby
+authors:
+- Anandaroop Roy
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-02-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.47'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.47'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: netrc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: typhoeus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: thor-zsh_completion
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+description: 
+email:
+- anandaroop.roy+github@gmail.com
+executables:
+- klimt
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- circle.yml
+- exe/klimt
+- klimt.gemspec
+- lib/klimt.rb
+- lib/klimt/client.rb
+- lib/klimt/clients/gravity_client.rb
+- lib/klimt/command.rb
+- lib/klimt/commands/city.rb
+- lib/klimt/commands/partner.rb
+- lib/klimt/commands/rendering.rb
+- lib/klimt/util/calculations.rb
+- lib/klimt/version.rb
+homepage: https://github.com/anandaroop/klimt
+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 for the Artsy API
+test_files: []