xolo-admin 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bc16bfe452748613b4da96e31dab66119c8d3ff837a44f6baa9b2b6a187ffdf0
-  data.tar.gz: ec5718f47f8996497fa4076629fc9fb1d8f5f44beeb77fb6eb4ac7f04c9140e8
+  metadata.gz: cbba7b8d84c902f3a3683808708db421ec8a3a1759aaee8e349da02a54b3c45e
+  data.tar.gz: 741dcbf5fc8c4df15c2043ea28d467093e56dc56747956b109f994e177e2cce0
 SHA512:
-  metadata.gz: 5ea09e8594bfdfad550e5e1ad7ba0db2a9fe25bd5a06cfeaa46999485efa676353041bf671acd6e831224f6ba22cf810c4aa15b6717cff524d47672c7e5471e4
-  data.tar.gz: b3c676c62037ec95d69ac5ac411fdfd375163bfb980e003f09348af898bd08c57965853c0e94c1ac7acfa940ea82c81e608477173b7c19a325c4684affc45204
+  metadata.gz: e1617d119ebb27e0785a7ebe1201f2fc96244834c5145ae4a9a810a33a951a4f30c6dc2593d60283b489f6f4d2f2110c81454e383033e25f2001d24aeeb9a2a6
+  data.tar.gz: 381ac12e8bcee2955b22b1610b661b63764fc04f5b123a2ae85d468add291f2831b1c1a8cbc1282df0b81c8238a204849b909f2ac4fd2ed9bb54f7db1f439926

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

@@ -105,7 +105,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}" }