gazer 0.3.7 → 0.3.9

data/examples/add_project.sh

@@ -0,0 +1,151 @@
+#! /bin/bash
+
+# The MIT License (MIT)
+
+# Copyright (c) 2023 Mike DeAngelo Google, Inc.
+
+# 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.
+
+SECRET_GITHUB_TOKEN=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+DATABASE_HOST=XXXXXXXXXXXXX
+DATABASE_USERNAME=XXXXXXXXXXXXXX
+DATABASE_PASSWORD=XXXXXXXXXXXXXX
+
+echo '***************************************************************'
+echo Login persistently
+echo '***************************************************************'
+gzr session login
+
+echo '***************************************************************'
+echo create and test the connection
+echo '***************************************************************'
+cat > Connection_faa_mysql.json <<HERE
+{
+  "name": "faa",
+  "host": "$DATABASE_HOST",
+  "port": "3306",
+  "database": "flightstats",
+  "db_timezone": "UTC",
+  "query_timezone": "UTC",
+  "schema": null,
+  "max_connections": 30,
+  "ssl": false,
+  "verify_ssl": false,
+  "tmp_db_name": "tmp",
+  "pool_timeout": 120,
+  "sql_runner_precache_tables": true,
+  "sql_writing_with_info_schema": true,
+  "uses_tns": false,
+  "pdt_concurrency": 1,
+  "dialect_name": "mysql",
+  "username": "$DATABASE_USERNAME",
+  "password": "$DATABASE_PASSWORD"
+}
+HERE
+gzr connection import Connection_faa_mysql.json --token_file
+gzr connection test faa --token_file
+
+echo '***************************************************************'
+echo Change the session to dev mode
+echo '***************************************************************'
+gzr session get --token_file
+gzr session update dev --token_file
+
+echo '***************************************************************'
+echo Import the project
+echo '***************************************************************'
+cat > Project_faa.json <<HERE
+{
+  "name": "faa",
+  "uses_git": true
+}
+HERE
+gzr project import Project_faa.json --token-file
+
+echo '***************************************************************'
+echo Create a deploy key and set it on the github repo for the project
+echo '***************************************************************'
+DEPLOY_KEY=$(gzr project deploy_key faa --token_file)
+curl -L \
+  -X POST \
+  -H "Accept: application/vnd.github+json" \
+  -H "Authorization: Bearer $SECRET_GITHUB_TOKEN" \
+  -H "X-GitHub-Api-Version: 2022-11-28" \
+  https://api.github.com/repos/looker-open-source/faa/keys \
+  -d "{\"title\":\"test_key $(uuidgen)\",\"key\":\"$DEPLOY_KEY\",\"read_only\":false}"
+
+echo '***************************************************************'
+echo Set the project github connection
+echo '***************************************************************'
+cat > github_repo.json <<HERE
+{
+  "git_remote_url": "git@github.com:looker-open-source/faa.git",
+  "git_service_name": "github"
+}
+HERE
+gzr project update faa github_repo.json --token-file
+
+echo '***************************************************************'
+echo Check the project config
+echo '***************************************************************'
+gzr project cat faa --trim --token-file
+
+echo '***************************************************************'
+echo Checkout a shared branch
+echo '***************************************************************'
+gzr project checkout faa main --token_file
+
+echo '***************************************************************'
+echo Deploy to production
+echo '***************************************************************'
+gzr project deploy faa --token_file
+
+echo '***************************************************************'
+echo Configure lookml model
+echo '***************************************************************'
+cat > Model_faa.json <<HERE
+{
+  "name": "aviation",
+  "project_name": "faa",
+  "unlimited_db_connections": false,
+  "allowed_db_connection_names": [
+    "faa"
+  ]
+}
+HERE
+gzr model import Model_faa.json --token_file
+
+echo '***************************************************************'
+echo run a query against the model
+echo '***************************************************************'
+cat > query.json <<HERE
+{
+  "model": "aviation",
+  "view": "aircraft_types",
+  "fields": ["aircraft_types.description","aircraft_types.count"],
+  "pivots": null,
+  "fill_fields": null,
+  "filters": null,
+  "filter_expression": null,
+  "sorts": [
+    "aircraft_types.description"
+  ],
+  "limit": "500"
+}
+HERE
+gzr query runquery "$(cat query.json)"

data/lib/gzr/cli.rb

@@ -45,7 +45,6 @@ module Gzr
     class_option :force, type: :boolean, default: false, desc: 'Overwrite objects on server'
     class_option :su, type: :string, desc: 'After connecting, change to user_id given'
     class_option :width, type: :numeric, default: nil, desc: 'Width of rendering for tables'
-    class_option :persistent, type: :boolean, default: false, desc: 'Use persistent connection to communicate with host'
     class_option :token, type: :string, default: nil, desc: "Access token to use for authentication"
     class_option :token_file, type: :boolean, default: false, desc: "Use access token stored in file for authentication"
 
@@ -59,6 +58,8 @@ module Gzr
     end
     map %w(--version -v) => :version
     map space: :folder  # Alias space command to folder
+#    map permissions: :permission  # Alias permissions command to permission
+
 
     require_relative 'commands/alert'
     register Gzr::Commands::Alert, 'alert', 'alert [SUBCOMMAND]', 'Command description...'
@@ -66,8 +67,8 @@ module Gzr
     require_relative 'commands/attribute'
     register Gzr::Commands::Attribute, 'attribute', 'attribute [SUBCOMMAND]', 'Command description...'
 
-    require_relative 'commands/permissions'
-    register Gzr::Commands::Permissions, 'permissions', 'permissions [SUBCOMMAND]', 'Command to retrieve available permissions'
+    require_relative 'commands/permission'
+    register Gzr::Commands::Permission, 'permission', 'permission [SUBCOMMAND]', 'Command to retrieve available permission'
 
     require_relative 'commands/query'
     register Gzr::Commands::Query, 'query', 'query [SUBCOMMAND]', 'Commands to retrieve and run queries'

data/lib/gzr/commands/model/import.rb

@@ -42,12 +42,25 @@ module Gzr
           say_warning("options: #{@options.inspect}", output: output) if @options[:debug]
           with_session do
             read_file(@file) do |data|
-              data.select! do |k,v|
-                keys_to_keep('create_lookml_model').include? k
+              if !!cat_model(data[:name])
+                name = data[:name]
+                if !@options[:force]
+                  raise Gzr::CLI::Error, "Model #{name} already exists\nUse --force if you want to overwrite it"
+                end
+                data.select! do |k,v|
+                  keys_to_keep('update_lookml_model').include? k
+                end
+                model = update_model(data[:name],data)
+                output.puts "Updated model #{model[:name]}" unless @options[:plain]
+                output.puts model[:name] if @options[:plain]
+              else
+                data.select! do |k,v|
+                  keys_to_keep('create_lookml_model').include? k
+                end
+                model = create_model(data)
+                output.puts "Created model #{model[:name]}" unless @options[:plain]
+                output.puts model[:name] if @options[:plain]
               end
-              model = create_model(data)
-              output.puts "Created model #{model[:name]}" unless @options[:plain]
-              output.puts model[:name] if @options[:plain]
             end
           end
         end

data/lib/gzr/commands/model/set/cat.rb

@@ -0,0 +1,60 @@
+# The MIT License (MIT)
+
+# Copyright (c) 2023 Mike DeAngelo Google, Inc.
+
+# 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.
+
+# frozen_string_literal: true
+
+require_relative '../../../command'
+require_relative '../../../modules/model/set'
+require_relative '../../../modules/filehelper'
+
+module Gzr
+  module Commands
+    class Model
+      class Set
+        class Cat < Gzr::Command
+          include Gzr::Model::Set
+          include Gzr::FileHelper
+          def initialize(model_set_id,options)
+            super()
+            @model_set_id = model_set_id
+            @options = options
+          end
+
+          def execute(input: $stdin, output: $stdout)
+            say_warning(@options) if @options[:debug]
+            with_session do
+              data = cat_model_set(@model_set_id)
+              if data.nil?
+                say_warning "Model Set #{@model_set_id} not found"
+                return
+              end
+              data = trim_model_set(data) if @options[:trim]
+
+              write_file(@options[:dir] ? "Model_Set_#{data[:name]}.json" : nil, @options[:dir],nil, output) do |f|
+                f.puts JSON.pretty_generate(data)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/gzr/commands/model/set/import.rb

@@ -0,0 +1,73 @@
+# The MIT License (MIT)
+
+# Copyright (c) 2023 Mike DeAngelo Google, Inc.
+
+# 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.
+
+# frozen_string_literal: true
+
+require_relative '../../../../gzr'
+require_relative '../../../command'
+require_relative '../../../modules/model/set'
+require_relative '../../../modules/filehelper'
+
+module Gzr
+  module Commands
+    class Model
+      class Set
+        class Import < Gzr::Command
+          include Gzr::Model::Set
+          include Gzr::FileHelper
+          def initialize(file, options)
+            super()
+            @file = file
+            @options = options
+          end
+
+          def execute(input: $stdin, output: $stdout)
+            say_warning("options: #{@options.inspect}", output: output) if @options[:debug]
+            with_session do
+              model_set = nil
+
+              read_file(@file) do |data|
+                search_results = search_model_sets(name: data[:name])
+                if search_results && search_results.length == 1
+                  name = data[:name]
+                  if !@options[:force]
+                    raise Gzr::CLI::Error, "Model Set #{name} already exists\nUse --force if you want to overwrite it"
+                  end
+                  data.select! do |k,v|
+                    keys_to_keep('update_model_set').include? k
+                  end
+                  model_set = update_model_set(search_results.first[:id], data)
+                else
+                  data.select! do |k,v|
+                    keys_to_keep('create_model_set').include? k
+                  end
+                  model_set = create_model_set(data)
+                end
+                output.puts "Imported model set #{model_set[:id]}" unless @options[:plain]
+                output.puts model_set[:id] if @options[:name]
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/gzr/commands/model/set/ls.rb

@@ -0,0 +1,74 @@
+# The MIT License (MIT)
+
+# Copyright (c) 2023 Mike DeAngelo Google, Inc.
+
+# 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.
+
+# frozen_string_literal: true
+
+require_relative '../../../command'
+require_relative '../../../modules/model/set'
+require 'tty-table'
+
+module Gzr
+  module Commands
+    class Model
+      class Set
+        class Ls < Gzr::Command
+          include Gzr::Model::Set
+          def initialize(options)
+            super()
+            @options = options
+          end
+
+          def execute(input: $stdin, output: $stdout)
+            say_warning(@options) if @options[:debug]
+            with_session do
+              data = all_model_sets(@options[:fields])
+              begin
+                say_ok "No model sets found"
+                return nil
+              end unless data && data.length > 0
+
+              table_hash = Hash.new
+              fields = field_names(@options[:fields])
+              table_hash[:header] = fields unless @options[:plain]
+              expressions = fields.collect { |fn| field_expression(fn) }
+              table_hash[:rows] = data.map do |row|
+                expressions.collect do |e|
+                  eval "row.#{e}"
+                end
+              end
+              table = TTY::Table.new(table_hash)
+              alignments = fields.collect do |k|
+                (k =~ /id$/) ? :right : :left
+              end
+              begin
+                if @options[:csv] then
+                  output.puts render_csv(table)
+                else
+                  output.puts table.render(if @options[:plain] then :basic else :ascii end, alignments: alignments, width: @options[:width] || TTY::Screen.width)
+                end
+              end if table
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/gzr/commands/model/set/rm.rb

@@ -0,0 +1,49 @@
+# The MIT License (MIT)
+
+# Copyright (c) 2023 Mike DeAngelo Google, Inc.
+
+# 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.
+
+# frozen_string_literal: true
+
+require_relative '../../../command'
+require_relative '../../../modules/model/set'
+
+module Gzr
+  module Commands
+    class Model
+      class Set
+        class Delete < Gzr::Command
+          include Gzr::Model::Set
+          def initialize(model_set_id,options)
+            super()
+            @model_set_id = model_set_id
+            @options = options
+          end
+
+          def execute(input: $stdin, output: $stdout)
+            say_warning(@options) if @options[:debug]
+            with_session do
+             delete_model_set(@model_set_id)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/gzr/commands/model/set.rb

@@ -0,0 +1,97 @@
+# The MIT License (MIT)
+
+# Copyright (c) 2023 Mike DeAngelo Google, Inc.
+
+# 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.
+
+# frozen_string_literal: true
+
+require_relative '../subcommandbase'
+
+module Gzr
+  module Commands
+    class Model
+      class Set < SubCommandBase
+
+        namespace :'model set'
+
+        desc 'ls', 'List the model sets in this server.'
+        method_option :help, aliases: '-h', type: :boolean,
+                             desc: 'Display usage information'
+        method_option :fields, type: :string, default: 'id,name,models',
+                             desc: 'Fields to display'
+        method_option :plain, type: :boolean, default: false,
+                             desc: 'print without any extra formatting'
+        method_option :csv, type: :boolean, default: false,
+                             desc: 'output in csv format per RFC4180'
+        def ls(*)
+          if options[:help]
+            invoke :help, ['ls']
+          else
+            require_relative 'set/ls'
+            Gzr::Commands::Model::Set::Ls.new(options).execute
+          end
+        end
+
+        desc 'cat MODEL_SET_ID', 'Output json information about a model set to screen or file'
+        method_option :help, aliases: '-h', type: :boolean,
+                             desc: 'Display usage information'
+        method_option :dir,  type: :string,
+                             desc: 'Directory to store output file'
+        method_option :trim, type: :boolean,
+                             desc: 'Trim output to minimal set of fields for later import'
+        def cat(model_set_id)
+          if options[:help]
+            invoke :help, ['cat']
+          else
+            require_relative 'set/cat'
+            Gzr::Commands::Model::Set::Cat.new(model_set_id,options).execute
+          end
+        end
+
+        desc 'import FILE', 'Import a model set from a file'
+        method_option :help, aliases: '-h', type: :boolean,
+                             desc: 'Display usage information'
+        method_option :force, type: :boolean,
+                             desc: 'Overwrite an existing model set'
+        method_option :plain, type: :boolean, default: false,
+                             desc: 'print without any extra formatting'
+        def import(file)
+          if options[:help]
+            invoke :help, ['import']
+          else
+            require_relative 'set/import'
+            Gzr::Commands::Model::Set::Import.new(file, options).execute
+          end
+        end
+
+        desc 'rm MODEL_SET_ID', 'Delete the model_set given by MODEL_SET_ID'
+        method_option :help, aliases: '-h', type: :boolean,
+                             desc: 'Display usage information'
+        def rm(model_set_id)
+          if options[:help]
+            invoke :help, ['delete']
+          else
+            require_relative 'set/rm'
+            Gzr::Commands::Model::Set::Delete.new(model_set_id,options).execute
+          end
+        end
+      end
+    end
+  end
+end

data/lib/gzr/commands/model.rb

@@ -27,6 +27,9 @@ module Gzr
   module Commands
     class Model < SubCommandBase
 
+      require_relative 'model/set'
+      register Gzr::Commands::Model::Set, 'set', 'set [SUBCOMMAND]', 'Commands pertaining to model sets'
+
       namespace :model
 
       desc 'ls', 'List the models in this server.'
@@ -64,6 +67,8 @@ module Gzr
       end
 
       desc 'import MODEL_FILE', 'Import a model configuration from a file containing json information'
+      method_option :force, type: :boolean,
+                           desc: 'Overwrite an existing connection'
       method_option :help, aliases: '-h', type: :boolean,
                            desc: 'Display usage information'
       def import(model_file)

data/lib/gzr/commands/{permissions → permission}/ls.rb

@@ -22,16 +22,16 @@
 # frozen_string_literal: true
 
 require_relative '../../command'
-require_relative '../../modules/permissions'
+require_relative '../../modules/permission'
 require 'tty-table'
 
 require_relative '../../command'
 
 module Gzr
   module Commands
-    class Permissions
+    class Permission
       class Ls < Gzr::Command
-        include Gzr::Permissions
+        include Gzr::Permission
         def initialize(options)
           super()
           @options = options

data/lib/gzr/commands/permission/set/cat.rb

@@ -0,0 +1,60 @@
+# The MIT License (MIT)
+
+# Copyright (c) 2023 Mike DeAngelo Google, Inc.
+
+# 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.
+
+# frozen_string_literal: true
+
+require_relative '../../../command'
+require_relative '../../../modules/permission/set'
+require_relative '../../../modules/filehelper'
+
+module Gzr
+  module Commands
+    class Permission
+      class Set
+        class Cat < Gzr::Command
+          include Gzr::Permission::Set
+          include Gzr::FileHelper
+          def initialize(permission_set_id,options)
+            super()
+            @permission_set_id = permission_set_id
+            @options = options
+          end
+
+          def execute(input: $stdin, output: $stdout)
+            say_warning(@options) if @options[:debug]
+            with_session do
+              data = cat_permission_set(@permission_set_id)
+              if data.nil?
+                say_warning "Permission Set #{permission_set_id} not found"
+                return
+              end
+              data = trim_permission_set(data) if @options[:trim]
+
+              write_file(@options[:dir] ? "Permission_Set_#{data[:name]}.json" : nil, @options[:dir],nil, output) do |f|
+                f.puts JSON.pretty_generate(data)
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end