jess 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3ba4716ea02efd8b3125dd57ede1c75fafc26de9
+  data.tar.gz: 03f2507e70f5ca75b2bfac60e61be5e8d12a1b68
+SHA512:
+  metadata.gz: 6a8519484aa74c44671a609ec1e9acab79eeba09d1094b4ed22c988f459c0671287c39eac8ff94ca999cf4708ef638c5f20e157de8c697dc268c3c0d726dabb0
+  data.tar.gz: 2e0a4267865b068782beb774541741cd636bc925a46bd31532f3f5d7351d0582b37c60978192eb2b74c77cbbdf394fb83725cd41c68836ca4f1913564fa03c83

data/.github/pull_request_template.md

@@ -0,0 +1,7 @@
+Describe what you changed and why you changed it, and then review the checklist below.
+
+---
+
+- [ ] All tests and RuboCop checks pass (`bundle exec rake`)
+- [ ] Test(s) included
+- [ ] CHANGELOG entry included

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rubocop.yml

@@ -0,0 +1,41 @@
+AllCops:
+  DisplayCopNames: true
+  DisplayStyleGuide: true
+  TargetRubyVersion: 2.1
+
+Metrics/AbcSize:
+  Exclude:
+    - "test/**/*"
+
+Metrics/ClassLength:
+  Exclude:
+    - "test/**/*"
+
+Metrics/MethodLength:
+  Exclude:
+    - "test/**/*"
+
+Style/BarePercentLiterals:
+  EnforcedStyle: percent_q
+
+Style/ClassAndModuleChildren:
+  Enabled: false
+
+Style/Documentation:
+  Exclude:
+    - 'test/**/*'
+
+Style/DoubleNegation:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/SpaceAroundEqualsInParameterDefault:
+  EnforcedStyle: no_space
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/TrivialAccessors:
+  AllowPredicates: true

data/.travis.yml

@@ -0,0 +1,7 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.1
+  - 2.2
+  - 2.3.1
+before_install: gem install bundler -v 1.13.1

data/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Jess Change Log
+
+All notable changes to this project will be documented in this file.
+
+Jess is in a pre-1.0 state. This means that its APIs and behavior are subject to breaking changes without deprecation notices. Until 1.0, version numbers will follow a [Semver][]-ish `0.y.z` format, where `y` is incremented when new features or breaking changes are introduced, and `z` is incremented for lesser changes or bug fixes.
+
+## [Unreleased][]
+
+* Your contribution here!
+
+## 0.1.0 (2016-10-03)
+
+* Initial release
+
+[Semver]: http://semver.org
+[Unreleased]: https://github.com/mattbrictson/chandler/compare/v0.1.0...HEAD

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 matt@mattbrictson.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/CONTRIBUTING.md

@@ -0,0 +1,21 @@
+# Contributing to Jess
+
+Have a feature idea, bug fix, or refactoring suggestion? Contributions are welcome! Here are some general guidelines.
+
+## Discuss first!
+
+1. Check [Issues][] to see if your contribution has already been discussed and/or implemented.
+2. If not, open an issue to discuss your contribution. I won't accept all changes and do not want to waste your time.
+3. Once you have the :thumbsup:, fork the repo, make your changes, and open a PR.
+
+## Before you commit
+
+* Did you add tests? New features or changes in behavior should be tested.
+* Do all tests and RuboCop checks pass? Run `bundle exec rake` to be sure.
+* Did you add a CHANGELOG entry? All non-trivial PRs need one.
+
+## Questions?
+
+Need help writing an appropriate test? Not sure the best way to attack a problem? Please ask by [posting a GitHub issue][Issues]!
+
+[Issues]: https://github.com/mattbrictson/jess/issues

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Matt Brictson
+
+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,125 @@
+# Jess
+
+[![Gem Version](https://badge.fury.io/rb/jess.svg)](http://badge.fury.io/rb/jess)
+[![Build Status](https://travis-ci.org/mattbrictson/jess.svg?branch=master)](https://travis-ci.org/mattbrictson/jess)
+[![Code Climate](https://codeclimate.com/github/mattbrictson/jess/badges/gpa.svg)](https://codeclimate.com/github/mattbrictson/jess)
+[![Coverage Status](https://coveralls.io/repos/github/mattbrictson/jess/badge.svg?branch=master)](https://coveralls.io/github/mattbrictson/jess?branch=master)
+
+**Jess is an extremely lightweight, read-only client for the JAMF Software Server (JSS) API.**
+This is a young project and is experimental. Currently it only provides access to computer and mobile device records.
+
+Jess aims to be:
+
+* Fast
+* Easy to use
+* Small (zero dependencies)
+* Well-tested
+* Multi-tenant friendly (connect to many JSS endpoints)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "jess"
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install jess
+
+*Note that Jess requires Ruby 2.1.0 or newer.*
+
+## Usage
+
+First establish a connection.
+
+```ruby
+require "jess"
+
+# Simple
+conn = Jess.connect("https://jsshost", username: "user", password: "secret")
+
+# Advanced, with more options available
+http = Jess::HttpClient.new(
+  "https://jsshost",
+  username: "user",
+  password: "secret",
+  net_http_options: {
+    keep_alive_timeout: 5,
+    open_timeout: 5,
+    read_timeout: 10,
+    verify_mode: OpenSSL::SSL::VERIFY_NONE
+  },
+  logger: nil # disable default logging
+)
+conn = Jess::Connection.new(http)
+```
+
+Then retrieve a computer:
+
+```ruby
+computer = conn.computers.find(1234)
+computer.id                 # => 1234
+computer.name               # => "Matt's iMac"
+computer.general.ip_address # => "10.0.0.17"
+computer.hardware.model     # => "iMac Intel (Retina 5k, 27-Inch, Late 2015)"
+```
+
+Or a mobile device:
+
+```ruby
+phone = conn.mobile_devices.find(5678)
+phone.id                    # => 5678
+phone.general.serial_number # => "G15ER8WGSC61L"
+```
+
+In general, the objects provided by Jess mirror the structure of the JSON returned by the JSS API. The exception to this rule is `extension_attributes`, which for convenience are transformed into a Hash-like object for easy access:
+
+```ruby
+computer.extension_attributes.key?("My Ext Attr Name") # => true
+computer.extension_attributes["My Ext Attr Name"]      # => "value"
+```
+
+If you ever need access to the raw JSON data of any object, use the `_json` method:
+
+```ruby
+computer.extension_attributes._json # => [{ ... }]
+```
+
+Jess does not perform any type conversions. For example, timestamps are provided exactly as returned in the original JSON; they are not converted to Ruby DateTime objects.
+
+```ruby
+computer.purchasing.po_date_utc # => "2016-03-18T00:00:00.000-0500"
+```
+
+## Why not ruby-jss?
+
+The [ruby-jss](http://pixaranimationstudios.github.io/ruby-jss/) gem is the most popular Ruby library for accessing the JSS API. Compared to Jess, ruby-jss has many more features, and is probably the more suitable solution for most use cases. So when might you use Jess instead?
+
+* Jess offers a cleaner connection model that doesn't rely on global variables, which makes Jess easier to use if you need to connect to multiple JSS endpoints in the same Ruby process.
+* Jess internally uses Ruby standard library Net::HTTP and supports persistent HTTP/1.1 connections; this may be faster than ruby-jss in some scenarios.
+
+## Who uses Jess?
+
+Jess powers [Robot Cloud Dashboard](http://www.robotcloud.net/dashboard/).
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rake` to run the tests and RuboCop checks. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and other discussions are welcome on GitHub at <https://github.com/mattbrictson/jess>. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+Before opening a pull request, please read [CONTRIBUTING.md](CONTRIBUTING.md) for important coding guidelines and policies.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,15 @@
+require "bundler/gem_tasks"
+require "chandler/tasks"
+require "rake/testtask"
+require "rubocop/rake_task"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+RuboCop::RakeTask.new
+
+task "release:rubygem_push" => "chandler:push"
+task default: [:test, :rubocop]

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "jess"
+
+# 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/jess.gemspec

@@ -0,0 +1,35 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "jess/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "jess"
+  spec.version       = Jess::VERSION
+  spec.authors       = ["Matt Brictson"]
+  spec.email         = ["opensource@mattbrictson.com"]
+
+  spec.summary       = "Lightweight, unofficial client for the JAMF Software "\
+                       "Server (JSS) API"
+  spec.homepage      = "https://github.com/mattbrictson/jess"
+  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.required_ruby_version = ">= 2.1.0"
+
+  spec.add_development_dependency "awesome_print", "~> 1.7"
+  spec.add_development_dependency "bundler", "~> 1.13"
+  spec.add_development_dependency "chandler", "~> 0.3"
+  spec.add_development_dependency "coveralls", "~> 0.8.15"
+  spec.add_development_dependency "rake", "~> 11.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "minitest-reporters", "~>1.1"
+  spec.add_development_dependency "rubocop", "~> 0.43"
+  spec.add_development_dependency "webmock", "~> 2.1"
+end

data/lib/jess.rb

@@ -0,0 +1,32 @@
+require "jess/version"
+
+# Jess is a lightweight client for the JAMF Software Server (JSS) API.
+#
+# Example usage:
+#
+# conn = Jess.connect("https://jsshost", username: "user", password: "secret")
+# computer = conn.computers.find(1234)
+# computer.id             # => 1234
+# computer.name           # => "Matt's iMac"
+# computer.hardware.model # => "iMac Intel (Retina 5k, 27-Inch, Late 2015)"
+#
+module Jess
+  autoload "Computer", "jess/computer"
+  autoload "Computers", "jess/computers"
+  autoload "Connection", "jess/connection"
+  autoload "ExtensionAttributes", "jess/extension_attributes"
+  autoload "HttpClient", "jess/http_client"
+  autoload "MobileDevice", "jess/mobile_device"
+  autoload "MobileDevices", "jess/mobile_devices"
+  autoload "Resource", "jess/resource"
+
+  # Establish a connection with JSS and return a Jess::Connection object that
+  # can be used to interact with the JSS API. This is a convenience method. For
+  # more fine-grained control over the connection, create a Jess::HttpClient
+  # using the desired options, then pass it to Jess::Connection.new.
+  #
+  def self.connect(url, username:, password:)
+    client = HttpClient.new(url, username: username, password: password)
+    Connection.new(client)
+  end
+end

data/lib/jess/computer.rb

@@ -0,0 +1,19 @@
+require "forwardable"
+
+module Jess
+  # A Computer record returned from JSS. The data mirrors the structure of the
+  # JSS Computer JSON representation, with sections for general, hardware,
+  # extension attributes, etc.
+  class Computer < Resource
+    extend Forwardable
+    def_delegators :general, :id, :name
+
+    def extension_attributes
+      @ext_attrs ||= ExtensionAttributes.new(super)
+    end
+
+    def inspect
+      "Jess::Computer<##{id}, #{name}>"
+    end
+  end
+end

data/lib/jess/computers.rb

@@ -0,0 +1,18 @@
+require "json"
+
+module Jess
+  # Computer-related JSS API operations
+  class Computers
+    attr_reader :http_client
+
+    def initialize(http_client)
+      @http_client = http_client
+    end
+
+    # Retrieve a computer by ID.
+    def find(id)
+      json = JSON.parse(http_client.get("computers/id/#{id}"))
+      Computer.new(json.fetch("computer"))
+    end
+  end
+end

data/lib/jess/connection.rb

@@ -0,0 +1,23 @@
+module Jess
+  # Provides a high-level facade for operations of the JSS API. This is the
+  # primary interface for all operations provided by the Jess gem.
+  class Connection
+    attr_reader :http_client
+
+    def initialize(http_client)
+      @http_client = http_client
+    end
+
+    def computers
+      @computers ||= Computers.new(http_client)
+    end
+
+    def mobile_devices
+      @mobile_devices ||= MobileDevices.new(http_client)
+    end
+
+    def inspect
+      "Jess::Connection<#{http_client.inspect}>"
+    end
+  end
+end

data/lib/jess/extension_attributes.rb

@@ -0,0 +1,18 @@
+require "forwardable"
+
+module Jess
+  # A Hash-like wrapper around the extension attributes that facilitates easy
+  # key/value access.
+  class ExtensionAttributes < Resource
+    extend Forwardable
+    def_delegators :@values, :[], :fetch, :key?, :keys, :size, :length, :to_h
+
+    def initialize(json)
+      super
+      @values = json.each_with_object({}) do |attr, hash|
+        hash[attr.name] = attr.value
+      end
+      @values.freeze
+    end
+  end
+end

data/lib/jess/http_client.rb

@@ -0,0 +1,80 @@
+require "logger"
+require "net/http"
+
+module Jess
+  # Provides low-level access to making authenticated GET requests to the JSS
+  # API, with basic logging and error handling. You will normally not need to
+  # use this class directly, unless you need to make HTTP requests that haven't
+  # been wrapped by the higher level `Jess::Connection` API.
+  #
+  class HttpClient
+    autoload :Error,            "jess/http_client/error"
+    autoload :BadCredentials,   "jess/http_client/error"
+    autoload :ConnectionError,  "jess/http_client/error"
+    autoload :LoggingDecorator, "jess/http_client/logging_decorator"
+    autoload :NotFound,         "jess/http_client/error"
+    autoload :ServerError,      "jess/http_client/error"
+    autoload :ErrorDecorator,   "jess/http_client/error_decorator"
+
+    attr_reader :url, :username, :logger, :net_http_options
+
+    def initialize(url, username:, password:,
+                   logger: default_logger, net_http_options: nil)
+      @url = url
+      @username = username
+      @password = password
+      @net_http_options = net_http_options || {}
+      @logger = logger
+    end
+
+    # Makes a GET request for the given path. The result is the raw, unparsed
+    # body of the HTTP response. The path is resolved relative to the
+    # `resource_uri` and should not start with a slash.
+    def get(path, accept: "application/json")
+      req = Net::HTTP::Get.new(URI.join(resource_uri, path))
+      req.basic_auth(username, password)
+      req["Accept"] = accept
+      response = http.request(req)
+      response.body.to_s
+    end
+
+    # The canonical JSSResource URI used to issue requests.
+    def resource_uri
+      @resource_uri ||= begin
+        root_url = url.to_s.sub(%r{JSSResource/*$}, "")
+        root_url << "/" unless root_url.end_with?("/")
+        URI.join(root_url, "JSSResource/")
+      end
+    end
+
+    def inspect
+      url = resource_uri.to_s.sub(%r{://}, "://#{username}@")
+      "Jess::HttpClient<#{url}>"
+    end
+
+    private
+
+    attr_reader :password
+
+    def default_logger
+      defined?(Rails) ? Rails.logger : Logger.new($stderr)
+    end
+
+    def http
+      @http ||= begin
+        http = Net::HTTP.new(resource_uri.host, resource_uri.port)
+        http.read_timeout = 15
+        http.open_timeout = 15
+        http.use_ssl = true if resource_uri.scheme == "https"
+        apply_net_http_options(http)
+        LoggingDecorator.new(logger, ErrorDecorator.new(http))
+      end
+    end
+
+    def apply_net_http_options(http)
+      net_http_options.each do |attr, value|
+        http.public_send("#{attr}=", value)
+      end
+    end
+  end
+end

data/lib/jess/http_client/error.rb

@@ -0,0 +1,28 @@
+module Jess
+  class HttpClient
+    # Base class for exceptions raised by Jess::HttpClient. These exceptions
+    # hold a reference to the URI and HTTP method (e.g. "GET", "POST") that were
+    # being attempted when the error occurred.
+    #
+    class Error < StandardError
+      attr_accessor :uri, :http_method
+
+      def to_s
+        "#{super} (during #{http_method.to_s.upcase} #{uri})"
+      end
+    end
+
+    # Raised when Jess::HttpClient fails to open an HTTP connection.
+    ConnectionError = Class.new(Error)
+
+    # Raised when Jess::HttpClient receives a 500 error from the server.
+    ServerError = Class.new(Error)
+
+    # Raised when Jess::HttpClient receives a 404 error from the server.
+    NotFound = Class.new(Error)
+
+    # Raised when Jess::HttpClient receives a 401 error from the server, which
+    # happens when the username and/or password are incorrect.
+    BadCredentials = Class.new(Error)
+  end
+end

data/lib/jess/http_client/error_decorator.rb

@@ -0,0 +1,44 @@
+require "delegate"
+
+module Jess
+  class HttpClient
+    # Wraps a Net::HTTP object to provide exception handling around the
+    # `request` method, such that 400 and 500 error codes are translated into
+    # appropriate Jess::HttpClient::Error exceptions.
+    #
+    class ErrorDecorator < SimpleDelegator
+      def request(req)
+        super.tap do |response|
+          raise_if_error_code(response)
+        end
+      rescue StandardError => e
+        handle_exception(e, req)
+      end
+
+      private
+
+      def raise_if_error_code(res)
+        return if res.is_a?(Net::HTTPSuccess)
+        raise BadCredentials, res.message if res.code == "401"
+        raise NotFound, res.message if res.code == "404"
+        raise ServerError, res.message if res.is_a?(Net::HTTPServerError)
+        raise Error, res.message
+      end
+
+      def handle_exception(e, req)
+        case e
+        when IOError, Timeout::Error
+          e = ConnectionError.new(e.message)
+        when Error
+          # pass
+        else
+          e = Error.new(e.inspect)
+        end
+
+        e.uri = req.uri
+        e.http_method = req.method
+        raise e
+      end
+    end
+  end
+end

data/lib/jess/http_client/logging_decorator.rb

@@ -0,0 +1,51 @@
+require "delegate"
+
+module Jess
+  class HttpClient
+    # Wraps a Net::HTTP object to log all requests to a given Logger object.
+    class LoggingDecorator < SimpleDelegator
+      def initialize(logger, http)
+        super(http)
+        @logger = logger
+      end
+
+      def request(req)
+        return super if logger.nil?
+
+        log_request(req)
+        response = super
+        log_response(response, req.uri)
+        response
+      rescue Error => e
+        logger.error(e.to_s) if logger
+        raise
+      end
+
+      private
+
+      attr_reader :logger
+
+      def log_request(req)
+        logger.debug { "#{req.method} #{req.uri}" }
+      end
+
+      def log_response(response, uri)
+        logger.debug do
+          "Received #{response_desc(response)} from #{uri}"
+        end
+      end
+
+      def response_desc(response)
+        content_type = response.content_type
+        desc = ""
+        desc << if response.body && response.body.length
+                  "#{response.body.length} bytes"
+                else
+                  "response"
+                end
+        desc << " (#{content_type})" if content_type
+        desc
+      end
+    end
+  end
+end

data/lib/jess/mobile_device.rb

@@ -0,0 +1,19 @@
+require "forwardable"
+
+module Jess
+  # A Mobile Device record returned from JSS. The data mirrors the structure of
+  # the JSS Mobile Device JSON representation, with sections for general,
+  # security, extension attributes, etc.
+  class MobileDevice < Resource
+    extend Forwardable
+    def_delegators :general, :id, :name
+
+    def extension_attributes
+      @ext_attrs ||= ExtensionAttributes.new(super)
+    end
+
+    def inspect
+      "Jess::MobileDevice<##{id}, #{name}>"
+    end
+  end
+end

data/lib/jess/mobile_devices.rb

@@ -0,0 +1,18 @@
+require "json"
+
+module Jess
+  # Mobile device-related JSS API operations
+  class MobileDevices
+    attr_reader :http_client
+
+    def initialize(http_client)
+      @http_client = http_client
+    end
+
+    # Retrieve a mobile device by ID.
+    def find(id)
+      json = JSON.parse(http_client.get("mobiledevices/id/#{id}"))
+      MobileDevice.new(json.fetch("mobile_device"))
+    end
+  end
+end

data/lib/jess/resource.rb

@@ -0,0 +1,39 @@
+module Jess
+  # Wraps a JSON object that is returned from the JSS API. The underlying raw
+  # JSON is available via `_json`. Properties of the JSON can be accessed via
+  # `method_missing`, so that a Resource behaves like a typical Ruby object.
+  # Accessing a non-existent JSON property will raise `NoMethodError`.
+  #
+  class Resource
+    attr_reader :_json
+
+    def initialize(json)
+      @_json = json.freeze
+    end
+
+    private
+
+    def method_missing(symbol, *args)
+      if _json.key?(symbol.to_s)
+        _as_resource(_json.public_send(:[], symbol.to_s, *args))
+      else
+        super
+      end
+    end
+
+    def respond_to_missing?(symbol, include_all)
+      super || _json.key?(symbol.to_s)
+    end
+
+    def _as_resource(json)
+      case json
+      when Hash
+        Resource.new(json)
+      when Array
+        json.map(&method(:_as_resource))
+      else
+        json
+      end
+    end
+  end
+end

data/lib/jess/version.rb

@@ -0,0 +1,3 @@
+module Jess
+  VERSION = "0.1.0".freeze
+end

metadata

@@ -0,0 +1,197 @@
+--- !ruby/object:Gem::Specification
+name: jess
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Matt Brictson
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-10-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !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: chandler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.15
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.15
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.43'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.43'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+description: 
+email:
+- opensource@mattbrictson.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/pull_request_template.md"
+- ".gitignore"
+- ".rubocop.yml"
+- ".travis.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- jess.gemspec
+- lib/jess.rb
+- lib/jess/computer.rb
+- lib/jess/computers.rb
+- lib/jess/connection.rb
+- lib/jess/extension_attributes.rb
+- lib/jess/http_client.rb
+- lib/jess/http_client/error.rb
+- lib/jess/http_client/error_decorator.rb
+- lib/jess/http_client/logging_decorator.rb
+- lib/jess/mobile_device.rb
+- lib/jess/mobile_devices.rb
+- lib/jess/resource.rb
+- lib/jess/version.rb
+homepage: https://github.com/mattbrictson/jess
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.6
+signing_key: 
+specification_version: 4
+summary: Lightweight, unofficial client for the JAMF Software Server (JSS) API
+test_files: []