xolo-admin 1.0.0 → 2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc16bfe452748613b4da96e31dab66119c8d3ff837a44f6baa9b2b6a187ffdf0
-  data.tar.gz: ec5718f47f8996497fa4076629fc9fb1d8f5f44beeb77fb6eb4ac7f04c9140e8
+  metadata.gz: 78c42e6fb9e17f593f77705e340642273e4f83d70234a809fdef98101555cbe0
+  data.tar.gz: 54286e2ebccf3dbb76e28d9916da8b593792ccd1691aaebc0ff31f5313d4a6b4
 SHA512:
-  metadata.gz: 5ea09e8594bfdfad550e5e1ad7ba0db2a9fe25bd5a06cfeaa46999485efa676353041bf671acd6e831224f6ba22cf810c4aa15b6717cff524d47672c7e5471e4
-  data.tar.gz: b3c676c62037ec95d69ac5ac411fdfd375163bfb980e003f09348af898bd08c57965853c0e94c1ac7acfa940ea82c81e608477173b7c19a325c4684affc45204
+  metadata.gz: e43eb8c13033590db47a1b3a8a51480956ee606f5f59a2f857ae38f9e382abb1a4b29f9213c8df4131ca53937553ad09ecea7262df7f3b1a5cbd96b16ab8d0b8
+  data.tar.gz: 9ad24a86d2248d8767aa9c088129071f6d3fdc2aebff88c544584eefa2e1f274e1488dffc601c463727d2131694f33ab8f7a87da12bfb998cea26a0069b93954

data/README.md

@@ -1,5 +1,42 @@
-# Xolo - CLI and Automated Package and Patch Management for Jamf Pro
+# Xolo Admin - CLI and Automated Package and Patch Management for Jamf Pro
 
-The xolo-admin gem packages the code needed to run `xadm`, the admin tool for Xolo [link to come], a command-line based system for automation and standardization around software deployment and management via Jamf Pro and the Jamf Title Editor.
+<img src="http://pixaranimationstudios.github.io/xolo-home/images/dante.png" alt="Dante the xolo dog from the film Coco" width="200" height="200">
 
-More documentation coming soon. 
+
+[Source Code](https://github.com/PixarAnimationStudios/xolo) &nbsp;&nbsp;&nbsp;&nbsp;[Documentation](https://github.com/PixarAnimationStudios/xolo/wiki)
+
+
+Xolo (sorta pronounced 'show-low') is an http server and set of command-line tools for macOS that provide automatable access to the package deployment and patch management aspects of [Jamf Pro](https://www.jamf.com/products/jamf-pro/) and the [Jamf Title Editor](https://learn.jamf.com/en-US/bundle/title-editor/page/About_Title_Editor.html). It enhances Jamf Pro's abilities in many ways:
+
+- Management of titles and versions/patches is scriptable and automatable, allowing developers and admins to integrate with CI/CD workflows.
+- Simplifies and standardizes the complex, multistep manual process of managing titles and patches using the Title Editor and Patch Management web interfaces.
+- Client installs can be performed by remotely via ssh and/or MDM
+- Automated pre-release piloting of new versions/patches
+- Titles can be expired (auto-uninstalled) after a period of disuse, reclaiming unused licenses.
+- And more!
+
+Xolo is the successor to depot3/d3, which allowed Patch Management via Jamf Pro before Jamf's own Patch Management system existed. Now that Jamf's Patch Management is stable and mature, d3 was rewritten from the ground up as xolo to take advantage of it, retaining a few unique enhancements that d3 provided. 
+
+Unlike d3, xolo is built around 'pure-Jamf' processes, and everything it does can be done manually in the Title Editor and Jamf Pro web interfaces. 
+
+"Xolo" is the short name for the Mexican hairless dog breed ['xoloitzcuintle'](https://en.wikipedia.org/wiki/Xoloitzcuintle) (show-low-itz-kwint-leh), as personified by Dante in the 2017 Pixar film _Coco_.
+
+Xolo is built with two of our other open-source projects:
+
+- [ruby-jss](http://github.com/PixarAnimationStudios/ruby-jss), 
+which provides a ruby SDK for interacting with the 
+[REST APIs of Jamf Pro](https://developer.jamf.com/jamf-pro/reference/classic-api)
+
+- [windoo](http://github.com/PixarAnimationStudios/windoo), providing a ruby SDK for interacting with the 
+[REST API of the Title Editor](https://developer.jamf.com/jamf-pro/reference/gettokenclaims).
+
+See the xolo-admin.gemspec and xolo-server.gemspec files for other open-source tools and libraries used by Xolo.
+
+For detailed documentation about Xolo:<br/>
+(yet to be written....)
+
+- xoloserver, the https server that makes it all go
+- xadm, the Xolo admin tool for managing titles and versions via option-based or interactive command-line
+- xolo, the Xolo client tool for manually working with titles and versions on managed Macs   
+
+The xolo-admin gem packages the code needed to run 'xadm', the command-line tool for system administrators to deploy and maintain software titles using Xolo.

data/bin/xadm

@@ -19,8 +19,11 @@ class XoloAdmin
   #####################################
 
   include Xolo::Admin
+
   include Xolo::Core::JSONWrappers
   include Xolo::Core::Output
+  include Xolo::Core::SecurityCmd
+
   include Xolo::Admin::CommandLine
   include Xolo::Admin::Connection
   include Xolo::Admin::Processing
@@ -105,7 +108,7 @@ begin
   app.run
   exit 0
 rescue => e
-  warn "Error: #{e.class.name.split('::').last}: #{e}"
+  warn "Error: #{e.class}: #{e}"
   if debug
     warn 'Backtrace:'
     e.backtrace.each { |l| warn "..#{l}" }