urbanairship 8.0.0 → 9.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c91f31ef623a57075fe0acde9fe467d17dc2b0bbb634070c8da11cad54b08f5
-  data.tar.gz: eefb6b294cd953148c27fa91bae207888cbb163c6ec620301aa41b243046b46a
+  metadata.gz: 4271dd0c7f5cc4da7c6438cfec017d10be9ddb8c28145f541cf026ec1c179258
+  data.tar.gz: 609aa096ad24c679a32ab69fca8487ebe7e939150505d9f91c506937ce8e8ac0
 SHA512:
-  metadata.gz: 1c19a821551da7ad1593c91ef7dd0c922dd2f4637ee74a2f29a1fcecce0db4185b09e0fa908fedcc6b124897c3bcd9a41c1070d841b6cef45436ac26a5ba3382
-  data.tar.gz: 15bd6f34bf76d038d359b79443f7c12464345ea1cf3cc959254a2350b597a5a91be89940713d3de4a5caba50495cd66ea3cb39cbb6e91ad067d511f8c69af4f8
+  metadata.gz: d743974f8312e3d42f890873a3bd78f44483be14a4593c169f6587be560358771667127b1dabc30286cf3577161f573f9f73a13a9b6eb25840a686bf7d917e4f
+  data.tar.gz: 1abaa92b5fa0fea9afd3274ffac2bcc44a91280c514e05e11aab3612d0b886bfa11d4a9c1fa42ea887dd3638cdf6d336c187f6e8518f2618175e6b59f46fd3c2

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -16,7 +16,7 @@ Please include link to open issue if applicable.
 * I've tested for Ruby versions:
 
 - [ ] 2.6.7
-- [ ] 2.7.2
+- [ ] 2.7.3
 
 ### Airship Contribution Agreement
 [Link here](https://docs.google.com/forms/d/e/1FAIpQLScErfiz-fXSPpVZ9r8Di2Tr2xDFxt5MgzUel0__9vqUgvko7Q/viewform)

data/.github/workflows/ci.yaml

@@ -0,0 +1,23 @@
+name: Ruby Build
+
+on: [ push ]
+
+jobs:
+  test:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        ruby-version: [2.7.3, 2.6.7]
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@477b21f02be01bcb8030d50f37cfec92bfa615b6
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+      - name: Install dependencies
+        run: bundle install
+      - name: Run tests
+        run: bundle exec rake

data/.github/workflows/release.yaml

@@ -0,0 +1,31 @@
+name: Ruby Release
+
+on:
+  release:
+    types: [released]
+
+jobs:
+  test:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        ruby-version: [2.7.3, 2.6.7]
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@477b21f02be01bcb8030d50f37cfec92bfa615b6
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+      - name: Install dependencies
+        run: bundle install
+      - name: Run tests
+        run: bundle exec rake
+      - name: Publish to RubyGems
+        uses: cadwallion/publish-rubygems-action@master
+        env:
+          RUBYGEMS_API_KEY: ${{secrets.RUBYGEMS_API_KEY}}
+          GUTHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
+          RELEASE_COMMAND: rake release

data/.gitignore

@@ -10,6 +10,7 @@
 /spec/reports/
 /tmp/
 /csv_file
+.vscode/
 
 # App
 urbanairship.log

data/CHANGELOG

@@ -1,3 +1,25 @@
+--------------------
+9.1.0
+--------------------
+- All requests will now automatically attempt to authenticate with bearer token auth if a
+token is included in the instantiation of the client. Previously, only custom events requests 
+could use bearer token auth in this library. You can find more information about how to use 
+bearer token auth in the README.
+- Also fixes an issue where a secret was required even when bearer token auth was being used 
+(it is no longer required).
+
+--------------------
+9.0.0
+--------------------
+- Adds Tag List API Support
+- Removes location lookup endpoints
+- Removes location-based audience selectors
+
+--------------------
+8.0.1
+--------------------
+- Adds app key to user agent string on request
+
 --------------------
 8.0.0
 --------------------

data/README.rst

@@ -1,6 +1,5 @@
-.. image:: https://travis-ci.org/urbanairship/ruby-library.svg?branch=master
-    :target: https://travis-ci.org/urbanairship/ruby-library
-
+.. image:: https://github.com/urbanairship/ruby-library/actions/workflows/ci.yaml/badge.svg
+    :target: https://github.com/urbanairship/ruby-library/
 About
 =====
 
@@ -120,7 +119,7 @@ Broadcast to All Devices
    p = airship.create_push
    p.audience = UA.all
    p.notification = UA.notification(alert: 'Hello')
-   p.device_types = UA.all
+   p.device_types = UA.device_types(['ios','android'])
    p.send_push
 
 Simple Tag Push
@@ -136,7 +135,7 @@ Simple Tag Push
    p = airship.create_push
    p.audience = UA.tag('some_tag')
    p.notification = UA.notification(alert: 'Hello')
-   p.device_types = UA.all
+   p.device_types = UA.device_types(['ios','android'])
    p.send_push
 
 Specify the Airship server used to make your requests
@@ -176,6 +175,22 @@ Finally, you can change the targeted server on a request basis:
    # The Urbanairship configuration is overridden by the client and the
    # request will be sent to the 'go.urbanairship.com' server
 
+Using Bearer Token Auth
+-----------------------
+
+.. code-block:: ruby
+
+   require 'urbanairship'
+
+   UA = Urbanairship
+   airship = UA::Client.new(key:'application_key', token:'token')
+   # Then continue as you would otherwise
+
+**Note**: If you include a token in your instantiation, the request
+will use bearer token auth. Bearer token auth is required for some
+endpoints, but not supported by others. Please check `the Airship
+docs site <https://docs.airship.com/>`_ to see where it is supported.
+
 Contributing
 ============
 

data/docs/examples.rst

@@ -18,7 +18,7 @@ Simple broadcast to all devices
     push = airship.create_push
     push.audience = UA.all
     push.notification = UA.notification(alert: "Hello, world!")
-    push.device_types = UA.all
+    push.device_types = UA.device_types(['ios','android'])
     push.send_push
 
 
@@ -92,7 +92,7 @@ Rich Push with extra and without notification
 
     push = airship.create_push
     push.audience = UA.all
-    push.device_types = UA.all
+    push.device_types = UA.device_types(['ios','android'])
     push.message = UA.message(
       title: "Your package is on its way!",
       body: "<h1>Would you please complete our customer survey?</h1>",

data/docs/index.rst

@@ -1,9 +1,8 @@
 Airship Ruby Library
-==========================
+====================
 
 ``urbanairship`` is a Ruby library for using the `Airship
-<http://airship.com/>`_ web service API for push notifications and
-rich app pages.
+<http://airship.com/>`_ web service API for messaging.
 
 
 Installation
@@ -27,10 +26,9 @@ Using the library
 
 The library is intended to be used with the small footprint of a single
 import. To get started, import the package, and create an
-:rb:class:`Airship` object representing a single UA application.
+:rb:class:`Airship` object representing a single Airship project.
 
-Note that channels are preferred over ``device_token`` and ``apid``. See:
-`documentation on channels <channels>`_.
+The library uses `rest-client <https://github.com/rest-client/rest-client>`_ for communication with the Airship API.
 
 .. code-block:: ruby
 
@@ -40,18 +38,23 @@ Note that channels are preferred over ``device_token`` and ``apid``. See:
     p = airship.create_push
     p.audience = UA.all
     p.notification = UA.notification(alert: 'Hello')
-    p.device_types = UA.all
+    p.device_types = UA.device_types(['ios','android'])
     p.send_push
 
-The library uses `unirest`_ for communication with the UA API.
+We in the process of migrating code examples away from these docs and into the
+regular `Airship API reference <https://docs.airship.com/api/ua/>`_ 
+(select "Ruby Library"), so please check there for more examples.
+
+Please also see `the README <https://github.com/urbanairship/ruby-library/blob/main/README.rst>`_
+for detailed instructions on how to use bearer token auth and alternative servers.
 
 
 Development
 -----------
 
-The library source code is `available on GitHub <github>`_.
+The library source code is `available on GitHub <https://github.com/urbanairship/ruby-library>`_.
 
-Tests can be run with rspec_:
+Tests can be run with `rspec <https://rspec.info/>`_.
 
 Contents:
 
@@ -66,7 +69,7 @@ Contents:
    named_user.rst
    reports.rst
    static_lists.rst
-   location.rst
+   tag_lists.rst
    exceptions.rst
    examples.rst
    create_and_send.rst
@@ -84,9 +87,3 @@ Indices and tables
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`
-
-
-.. _channels: http://docs.airship.com/topic-guides/channels.html
-.. _unirest: http://unirest.io/ruby.html
-.. _github: https://github.com/urbanairship/ruby-library
-.. _rspec: https://nose.readthedocs.org/en/latest/

data/docs/push.rst

@@ -22,7 +22,7 @@ and device types:
     push = airship.create_push
     push.audience = UA.all
     push.notification = UA.notification(alert: 'Hello')
-    push.device_types = UA.all
+    push.device_types = UA.device_types(['ios','android'])
     push.send_push
 
 
@@ -443,12 +443,6 @@ types you wish to target with a list of strings:
 
     push.device_types = UA.device_types(['ios', 'android', 'web', 'open::example'])
 
-or with the ``all`` shortcut.
-
-.. code-block:: ruby
-
-    push.device_types = UA.all
-
 
 Delivery
 --------

data/docs/tag_lists.rst

@@ -0,0 +1,76 @@
+Tag Lists
+=========
+
+Bulk add and/or remove tags by uploading a CSV file of Airship users. For more
+information about the use of this endpoint, incluiding CSV file formatting requirements
+please see `the Airship Tag Lists API documentation 
+<https://docs.airship.com/api/ua/#tag-tag-lists>`__
+
+
+Create List
+-----------
+
+Add tags to your contacts by creating a list and uploading CSV file with user identifiers. 
+The body of the request contains the name, description, and optional metadata for the 
+list. After you define a list, you populate it with a call to the Upload Tag List method.
+
+.. code-block:: ruby
+
+    require 'urbanairship'
+    UA = Urbanairship
+    airship = UA::Client.new(key: 'app_key', secret: 'master_secret')
+    tags = {'tag_group_name': ['tag1', 'tag2']}
+
+    tag_list = UA::TagList.new(client: airship)
+    tag_list.name = 'ua_tags_list_name'
+    tag_list.create(description: 'description', extra: {'key': 'value'}, add: tags)
+
+
+Upload List
+-----------
+
+Upload a CSV that will set tag values on the specified channels or named users. See `the
+Airship API documentation <https://docs.airship.com/api/ua/#operation-api-tag-lists-list_name-csv-put>`__ for CSV formatting requirements. Set 
+the optional `gzip` parameter to `true` if your file is gzip compressed.
+
+.. code-block:: ruby
+
+    require 'urbanairship'
+    UA = Urbanairship
+    airship = UA::Client.new(key: 'app_key', secret: 'master_secret')
+
+    tag_list = UA::TagList.new(client: airship)
+    tag_list.name = 'ua_tags_list_name'
+    tag_list.upload(csv_file: 'file_content', gzip: true)
+
+
+Dowload List Errors
+-------------------
+
+During processing, after a list is uploaded, errors can occur. Depending on the type 
+of list processing, an error file may be created, showing a user exactly what went wrong.
+
+.. code-block:: ruby
+
+    require 'urbanairship'
+    UA = Urbanairship
+    airship = UA::Client.new(key: 'app_key', secret: 'master_secret')
+
+    tag_list = UA::TagList.new(client: airship)
+    error_csv = tag_list.errors
+
+
+Retrieve All Tag Lists
+----------------------
+
+Retrieve information about all tag lists. This call returns a list of metadata that 
+will not contain the actual lists of users.
+
+.. code-block:: ruby
+
+    require 'urbanairship'
+    UA = Urbanairship
+    airship = UA::Client.new(key: 'app_key', secret: 'master_secret')
+
+    tag_list = UA::TagList.new(client: airship)
+    list_response = tag_list.list

data/example/pusher.rb

@@ -3,19 +3,15 @@ class Pusher
 	require 'urbanairship'
 	UA = Urbanairship
 
-	def send_message
+	def send_broadcast_message
 		airship = UA::Client.new(key:'app_key', secret:'master_secret')
 		p = airship.create_push
 		p.audience = UA.all
 		p.notification = UA.notification(alert: 'Hello')
-		p.device_types = UA.all
-		p.in_app = UA.in_app(
-				alert: 'This is a test message!',
-				display_type: 'banner'
-				)
+		p.device_types = UA.device_types(['ios','android'])
 		p.send_push
 	end
 
 end
 
-Pusher.new.send_message
+Pusher.new.send_broadcast_message

data/lib/urbanairship/client.rb

@@ -15,10 +15,9 @@ module Urbanairship
       # @param [Object] secret Application Secret
       # @param [String] server Airship server to use ("go.airship.eu" or "go.urbanairship.com").
       #                        Used only when the request is sent with a "path", not an "url".
-      # @param [String] token Application Auth Token (for custom events endpoint)
+      # @param [String] token Application Auth Token
       # @return [Object] Client
-      def initialize(key: required('key'), secret: required('secret'),
-                     server: Urbanairship.configuration.server, token: nil)
+      def initialize(key: required('key'), secret: nil, server: Urbanairship.configuration.server, token: nil)
         @key = key
         @secret = secret
         @server = server
@@ -52,11 +51,15 @@ module Urbanairship
 
         raise ArgumentError.new("path and url can't be both nil") if path.nil? && url.nil?
 
-        headers = {'User-Agent' => 'UARubyLib/' + Urbanairship::VERSION}
+        headers = {'User-Agent' => 'UARubyLib/' + Urbanairship::VERSION + ' ' + @key}
         headers['Accept'] = 'application/vnd.urbanairship+json; version=3'
         headers['Content-Type'] = content_type unless content_type.nil?
         headers['Content-Encoding'] = encoding unless encoding.nil?
 
+        if @token != nil
+          auth_type = :bearer
+        end
+
         if auth_type == :bearer
           raise ArgumentError.new('token must be provided as argument if auth_type=bearer') if @token.nil?
           headers['X-UA-Appkey'] = @key
@@ -82,6 +85,7 @@ module Urbanairship
         }
 
         if auth_type == :basic
+          raise ArgumentError.new('secret must be provided as argument if auth_type=basic') if @secret.nil?
           params[:user] = @key
           params[:password] = @secret
         end

data/lib/urbanairship/common.rb

@@ -34,10 +34,6 @@ module Urbanairship
       "/lists/#{path}"
     end
 
-    def location_path(path='')
-      "/location/#{path}"
-    end
-
     def named_users_path(path='')
       "/named_users/#{path}"
     end
@@ -66,6 +62,10 @@ module Urbanairship
       "/segments/#{path}"
     end
 
+    def tag_lists_path(path='')
+      "/tag-lists/#{path}"
+    end
+
     # Helper method for required keyword args in Ruby 2.0 that is compatible with 2.1+
     # @example
     #   def say(greeting: required('greeting'))

data/lib/urbanairship/devices/tag_lists.rb

@@ -0,0 +1,82 @@
+require 'urbanairship'
+require 'tempfile'
+
+module Urbanairship
+  module Devices
+    class TagList
+      include Urbanairship::Common
+      include Urbanairship::Loggable
+      attr_accessor :name
+
+      def initialize(client: required('client'))
+        fail ArgumentError, 'Client cannot be set to nil' if client.nil?
+        @client = client
+      end
+
+      def create(description: nil, extra: nil, add:nil, remove: nil, set: nil)
+        fail ArgumentError, 'Name must be set' if name.nil?
+        payload = {'name': name}
+        payload['description'] = description unless description.nil?
+        payload['extra'] = extra unless extra.nil?
+        payload['add'] = add unless add.nil?
+        payload['remove'] = remove unless remove.nil?
+        payload['set'] = set unless set.nil?
+
+        response = @client.send_request(
+          method: 'POST',
+          body: JSON.dump(payload),
+          path: tag_lists_path,
+          content_type: 'application/json'
+        )
+        logger.info("Created Tag List for #{@name}")
+        response
+      end
+
+      def upload(csv_file: required('csv_file'), gzip: false)
+        fail ArgumentError, 'Name must be set' if name.nil?
+
+        if gzip
+          response = @client.send_request(
+            method: 'PUT',
+            body: csv_file,
+            path: tag_lists_path(@name + '/csv/'),
+            content_type: 'text/csv',
+            encoding: gzip
+          )
+        else
+          response = @client.send_request(
+            method: 'PUT',
+            body: csv_file,
+            path: tag_lists_path(@name + '/csv/'),
+            content_type: 'text/csv'
+          )
+        end
+
+        logger.info("Uploaded a tag list for #{@name}")
+        response
+      end
+
+      def errors
+        fail ArgumentError, 'Name must be set' if name.nil?
+
+        response = @client.send_request(
+          method: 'GET',
+          path: tag_lists_path(@name + '/errors/')
+        )
+        logger.info("Got error CSV for tag list #{@name}")
+        response
+      end
+
+      def list
+        fail ArgumentError, 'Name must be set' if name.nil?
+
+        response = @client.send_request(
+          method: 'GET',
+          path: tag_lists_path
+        )
+        logger.info("Got tag lists listing")
+        response
+      end
+    end
+  end
+end

data/lib/urbanairship/push/audience.rb

@@ -78,67 +78,6 @@ module Urbanairship
         { not: child }
       end
 
-      # Select a recent date range for a location selector.
-      # Valid selectors are:
-      #   :minutes :hours :days :weeks :months :years
-      #
-      # @example
-      #   recent_date(months: 6)  # => { recent: { months: 6 }}
-      #   recent_date(weeks: 3)  # => { recent: { weeks: 3 }}
-      def recent_date(**params)
-        fail ArgumentError, 'Only one range allowed' if params.size != 1
-        k, v = params.first
-        unless DATE_TERMS.include?(k)
-          fail ArgumentError, "#{k} not in #{DATE_TERMS}"
-        end
-        { recent: { k => v } }
-      end
-
-      # Select an absolute date range for a location selector.
-      #
-      # @param resolution [Symbol] Time resolution specifier, one of
-      #                            :minutes :hours :days :weeks :months :years
-      # @param start [String] UTC start time in ISO 8601 format.
-      # @param the_end [String] UTC end time in ISO 8601 format.
-      #
-      # @example
-      #   absolute_date(resolution: :months, start: '2013-01', the_end: '2013-06')
-      #   #=> {months: {end: '2013-06', start: '2013-01'}}
-      #
-      #   absolute_date(resolution: :minutes, start: '2012-01-01 12:00',
-      #                 the_end: '2012-01-01 12:45')
-      #   #=> {minutes: {end: '2012-01-01 12:45', start: '2012-01-01 12:00'}}
-      def absolute_date(resolution: required('resolution'), start: required('start'), the_end: required('the_end'))
-        unless DATE_TERMS.include?(resolution)
-          fail ArgumentError, "#{resolution} not in #{DATE_TERMS}"
-        end
-        { resolution => { start: start, end: the_end } }
-      end
-
-      # Select a location expression.
-      #
-      # Location selectors are made up of either an id or an alias and a date
-      # period specifier. Use a date specification function to generate the time
-      # period specifier.
-      #
-      # @example ID location
-      #   location(id: '4oFkxX7RcUdirjtaenEQIV', date: recent_date(days: 4))
-      #   #=> {location: {date: {recent: {days: 4}},
-      #       id: '4oFkxX7RcUdirjtaenEQIV'}}
-      #
-      # @example Alias location
-      #   location(us_zip: '94103', date: absolute_date(
-      #            resolution: 'days', start: '2012-01-01', end: '2012-01-15'))
-      #   #=> {location: {date: {days: {end: '2012-01-15',
-      #       start: '2012-01-01'}}, us_zip: '94103'}}
-      def location(date: required('date'), **params)
-        unless params.size == 1
-          fail ArgumentError, 'One location specifier required'
-        end
-        params[:date] = date
-        { location: params }
-      end
-
       private
 
       # Clean up a UUID for use in the library

data/lib/urbanairship/version.rb

@@ -1,3 +1,3 @@
 module Urbanairship
-  VERSION = '8.0.0'
+  VERSION = '9.1.0'
 end

data/lib/urbanairship.rb

@@ -26,7 +26,7 @@ require 'urbanairship/devices/named_user'
 require 'urbanairship/devices/open_channel'
 require 'urbanairship/reports/response_statistics'
 require 'urbanairship/devices/static_lists'
-require 'urbanairship/push/location'
+require 'urbanairship/devices/tag_lists'
 require 'urbanairship/automations/pipeline'
 require 'urbanairship/automations/automation'
 require 'urbanairship/ab_tests/variant'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: urbanairship
 version: !ruby/object:Gem::Version
-  version: 8.0.0
+  version: 9.1.0
 platform: ruby
 authors:
 - Airship
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-07-02 00:00:00.000000000 Z
+date: 2022-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -140,9 +140,10 @@ files:
 - ".github/ISSUE_TEMPLATE.md"
 - ".github/PULL_REQUEST_TEMPLATE.md"
 - ".github/SUPPORT.md"
+- ".github/workflows/ci.yaml"
+- ".github/workflows/release.yaml"
 - ".gitignore"
 - ".rspec"
-- ".travis.yml"
 - CHANGELOG
 - Gemfile
 - Guardfile
@@ -163,7 +164,6 @@ files:
 - docs/examples.rst
 - docs/exceptions.rst
 - docs/index.rst
-- docs/location.rst
 - docs/named_user.rst
 - docs/open_channels.rst
 - docs/push.rst
@@ -171,6 +171,7 @@ files:
 - docs/segment.rst
 - docs/sms.rst
 - docs/static_lists.rst
+- docs/tag_lists.rst
 - docs/tags.rst
 - example/pusher.rb
 - lib/urbanairship.rb
@@ -199,9 +200,9 @@ files:
 - lib/urbanairship/devices/sms.rb
 - lib/urbanairship/devices/sms_notification.rb
 - lib/urbanairship/devices/static_lists.rb
+- lib/urbanairship/devices/tag_lists.rb
 - lib/urbanairship/loggable.rb
 - lib/urbanairship/push/audience.rb
-- lib/urbanairship/push/location.rb
 - lib/urbanairship/push/payload.rb
 - lib/urbanairship/push/push.rb
 - lib/urbanairship/push/schedule.rb
@@ -229,7 +230,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.0.3.1
 signing_key: 
 specification_version: 4
 summary: Ruby Gem for using the Airship API

data/.travis.yml

@@ -1,4 +0,0 @@
-language: ruby
-rvm:
-  - 2.6.7
-  - 2.7.2

data/docs/location.rst

@@ -1,127 +0,0 @@
-Locations
-=========
-
-This class allows you to search for location information in
-various ways.
-
-
-Name Lookup
------------
-
-Search for a location boundary by name. The search primarily
-uses the location names, but you can also filter the results
-by boundary type. See `the API documentation on location
-<http://docs.airship.com/api/ua.html#location>`_
-for more information.
-
-.. code-block:: ruby
-
-    require 'urbanairship'
-    UA = Urbanairship
-    airship = UA::Client.new(key:'application_key', secret:'master_secret')
-    location = UA::Location.new(client: airship)
-    location.name_lookup(name: 'name', type: 'type')
-
-.. note::
-
-    ``name`` is a required parameter, but ``type`` is optional
-
-
-Coordinates Lookup
-------------------
-
-Search for a location by latitude and longitude coordinates. Type is
-an optional parameter. See `the API documentation on coordinates lookup
-<http://docs.airship.com/api/ua.html#lat-long-lookup>`_
-for more information.
-
-.. code-block:: ruby
-
-    require 'urbanairship'
-    UA = Urbanairship
-    airship = UA::Client.new(key:'application_key', secret:'master_secret')
-    location = UA::Location.new(client: airship)
-    location.coordinates_lookup(latitude: 123.45, longitude: 123.45, type: 'type')
-
-.. note::
-
-    ``longitude`` and ``latitude`` are required parameters that must be numbers.
-    ``Type`` is an optional parameter.
-
-
-Bounding Box Lookup
--------------------
-
-Search for location using a bounding box. See `the documentation on
-bounding box lookup
-<http://docs.airship.com/api/ua.html#bounding-box-lookup>`_
-for more information.
-
-.. code-block:: ruby
-
-    require 'urbanairship'
-    UA = Urbanairship
-    airship = UA::Client.new(key:'application_key', secret:'master_secret')
-    location = UA::Location.new(client: airship)
-    location.bounding_box_lookup(lat1: 123.45, long1: 123.45,
-      lat2: 321.45, long2: 321.45, type: 'type')
-
-.. note::
-
-    ``lat1``, ``long1``, ``lat2``, and ``long2`` and are required parameters that must be numbers.
-    ``Type`` is an optional parameter.
-
-
-Alias Lookup
-------------
-
-Search for location by alias. See `the documentation on alias lookup
-<http://docs.airship.com/api/ua.html#alias-lookup>`_
-
-.. code-block:: ruby
-
-    require 'urbanairship'
-    UA = Urbanairship
-    airship = UA::Client.new(key:'application_key', secret:'master_secret')
-    location = UA::Location.new(client: airship)
-    location.alias_lookup(from_alias: 'us_state=CA')
-
-.. note::
-
-    ``from_alias`` can either be a single alias or an array of aliases.
-
-
-Polygon Lookup
---------------
-
-Search for location by polygon id. See `the documentation on polygon
-lookup <http://docs.airship.com/api/ua.html#polygon-lookup>`_
-for more information.
-
-.. code-block:: ruby
-
-    require 'urbanairship'
-    UA = Urbanairship
-    airship = UA::Client.new(key:'application_key', secret:'master_secret')
-    location = UA::Location.new(client: airship)
-    location.polygon_lookup(polygon_id: 'id', zoom: 1)
-
-.. note::
-
-    ``polygon_id`` needs to be a string. ``Zoom`` is a number ranging from 1-20.
-
-
-Location Date Ranges
---------------------
-
-Get the possible date ranges that can be used with location endpoints. See `the documentation
-on location date ranges <http://docs.airship.com/api/ua.html#location-date-ranges>`__
-for more information.
-
-.. code-block:: ruby
-
-    require 'urbanairship'
-    UA = Urbanairship
-    airship = UA::Client.new(key:'application_key', secret:'master_secret')
-    l = UA::Location.new(client: airship)
-    l.date_ranges

data/lib/urbanairship/push/location.rb

@@ -1,103 +0,0 @@
-require 'urbanairship'
-
-
-module Urbanairship
-  module Push
-    class Location
-      include Urbanairship::Common
-      include Urbanairship::Loggable
-
-      def initialize(client: required('client'))
-        @client = client
-      end
-
-      def name_lookup(name: required('name'), type: nil)
-        fail ArgumentError, 'name needs to be a string' unless name.is_a? String
-        fail ArgumentError, 'type needs to be a string' unless type.nil? or type.is_a? String
-        path = location_path('?q=' + name)
-        path += '&type=' + type unless type.nil?
-        resp = @client.send_request(
-          method: 'GET',
-          path: path
-        )
-        logger.info("Retrieved location information for #{name}")
-        resp
-      end
-
-      def coordinates_lookup(latitude: required('latitude'), longitude: required('longitude'), type: nil)
-        fail ArgumentError,
-          'latitude and longitude need to be numbers' unless latitude.is_a? Numeric and longitude.is_a? Numeric
-        fail ArgumentError, 'type needs to be a string' unless type.nil? or type.is_a? String
-        path = location_path(latitude.to_s + ',' + longitude.to_s)
-        path += '?type=' + type unless type.nil?
-        resp = @client.send_request(
-          method: 'GET',
-          path: path
-        )
-        logger.info("Retrieved location information for latitude #{latitude} and longitude #{longitude}")
-        resp
-      end
-
-      def bounding_box_lookup(lat1: required('lat1'), long1: required('long1'),
-                              lat2: required('lat2'), long2: required('long2'), type: nil)
-
-        fail ArgumentError,
-           'lat1, long1, lat2, and long2 need to be numbers' unless lat1.is_a? Numeric and long2.is_a? Numeric\
-           and lat2.is_a? Numeric and long2.is_a? Numeric
-        fail ArgumentError, 'type needs to be a string' unless type.nil? or type.is_a? String
-        path = location_path(lat1.to_s + ',' + long1.to_s + ',' + lat2.to_s + ',' + long2.to_s)
-        path += '?type=' + type unless type.nil?
-        resp = @client.send_request(
-          method: 'GET',
-          path: path
-        )
-        logger.info("Retrieved location information for bounding box with lat1 #{lat1}, long1 #{long1}," +
-          " lat2 #{lat2}, and long2 #{long2}")
-        resp
-      end
-
-      def alias_lookup(from_alias: required('from_alias'))
-        fail ArgumentError, 'from_alias needs to be a string or an array of strings' unless from_alias.is_a? String or from_alias.is_a? Array
-        path = location_path('from-alias?')
-        if from_alias.is_a? Array
-          from_alias.each do |a|
-            fail ArgumentError, 'from_alias needs to be a string or an array of strings' unless a.is_a? String
-            path += a + '&'
-          end
-          path = path.chop
-        else
-          path += from_alias
-        end
-
-        resp = @client.send_request(
-          method: 'GET',
-          path: path
-        )
-        logger.info("Retrieved location info from alias #{from_alias}")
-        resp
-      end
-
-      def polygon_lookup(polygon_id: required('polygon_id'), zoom: required('zoom'))
-        fail ArgumentError, 'polygon_id needs to be a string' unless polygon_id.is_a? String
-        fail ArgumentError, 'zoom needs to be an integer' unless zoom.is_a? Integer
-
-        path = location_path(polygon_id + '?zoom=' + zoom.to_s)
-        resp = @client.send_request(
-          method: 'GET',
-          path: path
-        )
-        logger.info("Retrieved location info for polygon #{polygon_id} and zoom level #{zoom}")
-        resp
-      end
-
-      def date_ranges
-        resp = @client.send_request(
-          method: 'GET',
-          path: segments_path('dates/')
-        )
-        logger.info('Retrieved location date ranges')
-        resp
-      end
-    end
-  end
-end