JamfReports 0.1.1 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 77a38bd8791ce0cc7a828f3d99301e9bc3c263e2e94ddebd7396da49de534c43
-  data.tar.gz: 52e54858b28f7d94695007554123401e26c9ff3dd7fc83de20a06ba350f96adc
+  metadata.gz: 936b1cd3e821dc76f8187a62bb03c0e339fd0d678aa31a212472d774465276eb
+  data.tar.gz: 65406438b5d02ddf0d96c77f9eada5f1ed265e51ab2a292ce9677d10f2e4a904
 SHA512:
-  metadata.gz: 07e344536853fca76d8b07ae166cff9dccae9c5d3acca87045569b9244662d878f34d11cbfbde0ce87e363cc1be21a39ea58f73d7cb59507c92da08498f239e2
-  data.tar.gz: 6d1c9e64d051340b8702bd7e5fb1aae7106fda7f02c349929807a7e92e5c681a10b7540f06ecb30a7401ba7c65f7e1e0189ad1bfebd1396a9a3614ef48f16daf
+  metadata.gz: 68d279972dd6b10c469b6938bd4d40551f33ba09769c40125b658e8fe6a25b0b1bc61f199a49b53bdb2476d7668fc711393b185235a0584a8e272be168f08321
+  data.tar.gz: a0d2a54ac9b62b844666dbc9e9d9580d9bfeda7c3b2648e17d2a7ba753458d76027e27ff952c3bb32c6e9acf6e816832414f247558c8e752925e3e0d335fa55b

data/CHANGELOG.md

@@ -1,3 +1,5 @@
+## 0.2.0 (2023.06.29)
+- Add: export results to csv
 
 ## 0.1.1 (2023.06.28)
 - Update: update module syntax

data/README.md

@@ -1,9 +1,12 @@
 # JamfReports
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/JamfReports`. To experiment with that code, run `bin/console` for an interactive prompt.
+## Summary
 
-TODO: Delete this and the text above, and describe your gem
+JamfReports is a ruby gem that uses the Jamf Pro API for hosted instances. Currently, it only reports on Applications. Pulling from the `/api/v1/computers-inventory?section=APPLICATIONS` endpoint.
 
+Future reports may be added.
+
+---
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -20,20 +23,101 @@ Or install it yourself as:
 
     $ gem install JamfReports
 
+---
 ## Usage
 
-TODO: Write usage instructions here
+In order to run JamfReports, you are required to add these two lines to the top of your file, under the require `JamfReports` line
+
+```ruby
+#!/usr/bin/ruby
+require "JamfReports"
+
+## UPDATE THESE VARIABLES ------------------------------------------------------
+$jamfpro_url = "https://company.jamfcloud.com" 
+$api_pw = "Your API KEY HERE"
+```
+
+ If you don't have your api key for the `$api_pw` variable, run this command to create it and paste it into the variable.
+
+```bash
+printf "jamfUserName:JamfPassword" | iconv -t ISO-8859-1 | base64 -i -
+```
+
+
+
+And these 3 lines to generate the api token and pull the data from Jamf so you can run the report commands.
+
+```ruby
+JamfReports.getToken
+JamfReports.checkTokenExpiration
+JamfReports.getAllApplicationInventory
+```
+
+A full working file might look like this.
+
+```ruby
+#!/usr/bin/ruby
+require "JamfReports"
+
+## UPDATE THESE VARIABLES ------------------------------------------------------
+$jamfpro_url = "https://company.jamfcloud.com" 
+$api_pw = "Your API KEY HERE"
+
+## COMMANDS --------------------------------------------------------------------
+JamfReports.getToken
+JamfReports.checkTokenExpiration
+JamfReports.getAllApplicationInventory
+
+## REPORTS --------------------------------------------------------------------
+JamfReports.listAllInstalledApps
+# JamfReports.webBrowserReport
+# JamfReports.totalNumberOfOneInstalledApps
+# JamfReports.listofOneInstallApps
+
+## After reporting, revoke current token
+JamfReports.invalidateToken
+```
+
+
+---
+## Examples
+
+#### listAllInstalledApps
+
+![listAllInstalledApps](images/listAllInstalledApps.png)
+
+Returns a sorted list of all apps installed across your fleet of computers in Jamf. Sorted from most installed app, to least.
 
-## Development
+#### webBrowserReport
+![webBrowserReport](images/webBrowserReport.png)
+Returns a list of installed web browsers. Current browsers searched are:
+- Google Chrome.app
+- Google Chrome Canary.app
+- Firefox.app
+- Firefox Developer Edition.app
+- Safari.app
+- Safari Technology Preview.app
+- Microsoft Edge.app
+- Brave Browser.app
+- Arc.app
+- Opera.app
+- LinCastor Browser.app
+- LockDown Browser.app
+- Tor Browser.app
+- Vivaldi.app
+- DuckDuckGo.app
 
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+#### totalNumberOfOneInstalledApps
+![totalNumberOfOneInstalledApps](images/totalNumberOfOneInstalledApps.png)
+Returns a single metric to show the number of "One-off" or single installed apps across your fleet.
 
-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).
+#### listofOneInstallApps
+![listofOneInstallApps](images/listofOneInstallApps.png)
 
-## Contributing
+Returns a list of all the "One-off" or single installed apps across your fleet. This can be helpful in scoping in Jamf uninstall policies.
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/JamfReports.
 
+---
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/JamfReports/version.rb

@@ -1,3 +1,3 @@
 module JamfReports
-  VERSION = "0.1.1"
+  VERSION = "0.2.1"
 end

data/lib/JamfReports.rb

@@ -1,5 +1,6 @@
 require "JamfReports/version"
 require "uri"
+require 'etc'
 require "json"
 require "time"
 require "net/http"
@@ -149,5 +150,17 @@ module JamfReports
             end
         end
     end
+
+    def self.listAllInstalledApps_exporttocsv
+        $currentUser=Etc.getlogin
+        reportName="Installed Applications Report"
+        $reportPath="/Users/#{$currentUser}/Desktop/#{reportName}.csv"
+        File.write("#{$reportPath}", "name,count\n")
+        
+        $applicationHash.sort_by {|_key, value| value}.reverse.each do |k,v|
+            open("#{$reportPath}", "a") { |f| f << "#{k},#{v}\n" } 
+        end
+    end
+
     
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: JamfReports
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.1
 platform: ruby
 authors:
 - nic scott
@@ -53,6 +53,10 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- images/listAllInstalledApps.png
+- images/listofOneInstallApps.png
+- images/totalNumberOfOneInstalledApps.png
+- images/webBrowserReport.png
 - lib/JamfReports.rb
 - lib/JamfReports/version.rb
 homepage: https://github.com/nlscott/marshmallow