usd 0.1.7 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a40de31eb7297c78b71fb376ff889a28c3f0acfc05438ccd479aac0f34449bef
-  data.tar.gz: 67ab3c12bfa279a46585d038f5cddba79a89d7d621dfe690e44ba27c92ac3aeb
+  metadata.gz: dd923f3b1814841074968b4308bed67f1103d612445254ffad801f762ddbc6bf
+  data.tar.gz: 531ef12b97b305293082b3252c00625529c1f79a47f2bd06505f9b0e1f3f78b9
 SHA512:
-  metadata.gz: a7f9424391b67229c60961a7d2faa0ef1427092ff563009caca0e833b214f75e350c7ba35df172c96578f7467412cda136872d93d0f2b70056fbe8543b19f3f7
-  data.tar.gz: 7ebe4cb38d95badc3b619afc0df2094005d30f0f07cdd587425af0a3366099f3ab9c7572223428a32edb324b01d15f878bc58142f7ec32e3a7574dc53a71a384
+  metadata.gz: d2ffbea196cef1e974dd9f8bafb43b6076c807e24caa81a96a733bc2062aec830f6956de00bbda984fe7320e1fd756a829b63214cf9b32dfe11159d5b2f496fe
+  data.tar.gz: 77531ebb77a005a9dba2f9954faa8dafafc05c68df97c9e7824b2fe964fcc5526f2243e6407eda4544d9704370031b5decb1c774f65bfdc53157881a0c55d549

data/README.md

@@ -34,24 +34,26 @@ Place the `mlr`-binary in a path, which is in your PATH-Environment.
 ```
 rusdc
 Commands:
-  rusdc chg_add_nr              # <CO> <CI> - add a CI to a changeorder
-  rusdc chg_list_nr             # <CO> - list all CIs of one changeorder
-  rusdc create                  # pipe json-data to create object
-  rusdc field_names             # <object-type> list all fields of an object including its format
-  rusdc find                    # <object-type> <where-clause> [fields - Komma getrennt (id,name)] - finds each object which meets the wc-condition
-  rusdc get                     # <object-type> <common_name> shows one object
-  rusdc get_attachment_of_ci    # <ci_name> <filename>, download an attachment of a CI and print it out on stdout
-  rusdc get_attachment_of_co    # <co_name> <filename>, download an attachment of a changeorder and print it out on stdout
-  rusdc help [COMMAND]          # Describe available commands or one specific command
-  rusdc in_list_child_ins       # <in> - list all child-incidents of one incident
-  rusdc list_attachments_of_ci  # <ci_name>, list all attachments of a CI
-  rusdc list_attachments_of_co  # <co_name>, list all attachments of a changeorder
-  rusdc nr_add_child            # <nr-name> <child-name>, add one child CI to another CI
-  rusdc nr_changes              # <nr> [inactive-too] - list all open changeorders of one CI
-  rusdc nr_childs               # <ci-name> , lists all childs CIs of a specific CI
-  rusdc nr_incidents            # <nr> [inactive-too] - lists all incident of a specific CI
-  rusdc nr_parents              # nr_parents <ci-name> , lists all parent CIs of a specific CI
-  rusdc update                  # pipe json-data to update object
+  rusdc chg_add_nr <co> <ci>                                                   # add a CI to a changeorder
+  rusdc chg_list_nr <co>                                                       # list all CIs of one changeorder
+  rusdc create                                                                 # pipe json-data to create object
+  rusdc field_names <object-type>                                              # list all fields of an object including its format
+  rusdc find <object-type> [where-clause] [fields, comma separated] [options]  # finds each object which meets the wc-condition
+  rusdc get <object-type> <common_name>                                        # shows one object
+  rusdc get_attachment_of_ci <ci_name> <filename>                              # download an attachment of a CI and print it out on stdout
+  rusdc get_attachment_of_co <co_name> <filename>                              # download an attachment of a changeorder and print it out on stdout
+  rusdc help [COMMAND]                                                         # Describe available commands or one specific command
+  rusdc in_list_child_ins <in>                                                 # list all child-incidents of one incident
+  rusdc list_attachments_of_ci <ci_name>                                       # list all attachments of a CI
+  rusdc list_attachments_of_co <co_name>                                       # list all attachments of a changeorder
+  rusdc nr_add_child <nr-name> <child-name>                                    # add one child CI to another CI
+  rusdc nr_changes <nr> [inactive-too]                                         # list all open changeorders of one CI
+  rusdc nr_childs <ci-name>                                                    # lists all childs CIs of a specific CI
+  rusdc nr_incidents <nr> [inactive-too]                                       # lists all incident of a specific CI
+  rusdc nr_parents <ci-name>                                                   # lists all parent CIs of a specific CI
+  rusdc update                                                                 # pipe json-data to update object
+  rusdc update_attr <obj> <common_name> <key> <value>                          # updates a direct (not referenced) attribute of one object.
+  rusdc update_ref_attr <obj> <common_name> <key> <value>                      # updates a referenced attribute of one object.
 ```
 
 # environment-variables

data/bin/rusdc

@@ -7,7 +7,7 @@ require "usd"
 
 class Rusdc < Thor
 
-  desc "chg_add_nr", "<CO> <CI> - add a CI to a changeorder"
+  desc "chg_add_nr <co> <ci>", "add a CI to a changeorder"
   def chg_add_nr(co, ci)
     template = ERB.new <<-EOF
       {
@@ -25,7 +25,7 @@ class Rusdc < Thor
     puts loadcon.create({:type => "json", :data => json})
   end
 
-  desc "chg_list_nr", "<CO> - list all CIs of one changeorder"
+  desc "chg_list_nr <co>", "list all CIs of one changeorder"
   def chg_list_nr(co)
     invoke 'find', ['lrel_asset_chgnr', %(chg.chg_ref_num = '#{co}'), "nr"], {:format => "mlr"}
   end
@@ -35,7 +35,7 @@ class Rusdc < Thor
     puts loadcon.create({:type => "json", :data => STDIN.read})
   end
 
-  desc "field_names","<object-type> list all fields of an object including its format"
+  desc "field_names <object-type>","list all fields of an object including its format"
   def field_names(object)
     e = loadcon.search(object,{'fields' => "*","start" => "1", "size" => "1"})[0]
     e.keys.sort.each do |k|
@@ -46,46 +46,49 @@ class Rusdc < Thor
     end
   end
 
-  desc "find", "<object-type> <where-clause> [fields - Komma getrennt (id,name)] - finds each object which meets the wc-condition"
+  desc "find <object-type> [where-clause] [fields, comma separated] [options]", "finds each object which meets the wc-condition"
   long_desc <<-LONGDESC
 
 
-    Mit --mlr_format kann man das output-Format von Miller (mlr) ändern auf csv, md (markdown), xtab (sehr übersichtlich), dkvp (Delimited key-value pairs) ..., siehe `mlr --help`
+    with --mlr_format you may change the output-format of Miller (mlr) to csv, md (markdown), xtab , dkvp (delimited key-value pairs) ..., refer `mlr --help`
 
-    Beispiele:
+    Examples:
 
-    - alle aktiven CIs die mit sygosrv beginnen und die Zahl 58 enthalten:
-    ./rusdc find nr "name like 'servername' and delete_flag.sym = 'Active' " "id,name" --format mlr
+    - all grc objects (! don't use this kind of query for objecttype like nr, in, chg etc., whose number of objects is too big)
+    rusdc find grc
 
-    - meine aktiven Incidents:
-    ./rusdc find --format mlr in "assignee.last_name = 'gaida' and status.sym in ('Service pending','Work in progress.','Customer Pending','Open','Hold','Resolved')" ref_num,z_project,summary,status,call_back_date,affected_resource,orig_user_organization
+    - all aktive ci which start with the string `servername`, only print the fields @id and name:
+    rusdc find nr "name like 'servername%' and delete_flag.sym = 'Active' " "@id,name" --format mlr
 
-    - Activity-Log eines Incidents:
-    ./rusdc find alg "call_req_id.ref_num = 'I00001'" "call_req_id,action_desc,analyst,description,time_stamp,type" --format mlr --mlr_format xtab
+    - my active incidents with most importent fields:
+    rusdc find --format mlr in "assignee.last_name = 'gaida' and status.sym in ('Service pending','Work in progress.','Customer Pending','Open','Hold','Resolved')" ref_num,z_project,summary,status,call_back_date,affected_resource,orig_user_organization
 
-    - nur die Beschreibungen Activity-Log eines Incidents:
-    ./rusdc find alg "call_req_id.ref_num = 'I00001'" "description" --format mlr --mlr_format csv
+    - activity-Log of an incident in xtab format:
+    rusdc find alg "call_req_id.ref_num = 'I00001'" "call_req_id,action_desc,analyst,description,time_stamp,type" --format mlr --mlr_format xtab
 
-    - Incidents einer Maschine
-    ./rusdc find in "affected_resource.name = 'servername'" "ref_num,summary" --format mlr
+    - the same but only the field description in csv-format:
+    rusdc find alg "call_req_id.ref_num = 'I00001'" "description" --format mlr --mlr_format csv
 
-    - Kombiniert, alle Activity-Log-Beschreibungen aller Incidents einer Maschine:
-    ./rusdc find alg "call_req_id.affected_resource.name = 'servername'" "description" --format mlr
+    - incidents of the ci with the name `servername`
+    rusdc find in "affected_resource.name = 'servername'" "ref_num,summary" --format mlr
 
-    - Changes einer Maschine:
+    - combination of all activity-log-description of all incidents of a specific ci in pprint-Miller-format:
+    rusdc find alg "call_req_id.affected_resource.name = 'servername'" "description" --format mlr
+
+    - changeorders of a secific ci:
     rusdc find chg "asset.nr.name = 'servername'" "@COMMON_NAME,summary,status" --format mlr
 
-    - Alle Maschinen finden die mit goes beginnen und deren childs auf Linux und Windows prüfen:
+    - find all active ci whose name start with dc and check if they have children like Windows or Linux server:
     for ci in $(rusdc find nr "name like 'dc%' and delete_flag.sym = 'active'" "name" --format mlr | sed '1 d'); do rusdc nr_childs $ci > help ; echo "$ci: $(grep -iP '^(Linux|.*MS windows).*server' help)" ; done
 
   LONGDESC
-  option :format, :type => :string, :default => "json"
-  option :mlr_format, :type => :string, :default => "pprint"
-  option :nice_time, :type => :boolean, :default => true
-  option :debug, :type => :boolean, :default => false
-  def find(object, wc, fields="*")
+  option :format, :type => :string, :default => "json", :banner => "[json|yaml|mlr]"
+  option :mlr_format, :type => :string, :default => "pprint",:banner => "[pprint|json|md|csv|xtab]"
+  option :nice_time, :type => :boolean, :default => true,:banner => "[true|false]"
+  option :debug, :type => :boolean, :default => false,:banner => "[true|false]"
+  def find(object, wc="", fields="@COMMON_NAME")
     unless (fields =~ /^[\w\_,@]+$/)
-      puts "fields-problem: there must be only letters, numbers, comma and underscore, nothing else!"
+      puts "fields-problem: there must be only letters, numbers, comma, the @-sign or underscore, nothing else!"
     else
       con = loadcon
       mlr_array = []
@@ -137,7 +140,7 @@ class Rusdc < Thor
     end # fields check
   end
 
-  desc "get", "<object-type> <common_name> shows one object"
+  desc "get <object-type> <common_name>", "shows one object"
   option :yaml, :type => :boolean, :default => false
   def get(object, cn)
     e = loadcon.request("/caisd-rest/#{object}/COMMON_NAME-#{cn}")
@@ -150,7 +153,7 @@ class Rusdc < Thor
     end
   end
 
-  desc "get_attachment_of_ci", "<ci_name> <filename>, download an attachment of a CI and print it out on stdout"
+  desc "get_attachment_of_ci <ci_name> <filename>", "download an attachment of a CI and print it out on stdout"
   def get_attachment_of_ci(ciname, filename)
     att_nr = loadcon.search("lrel_attachments_nr",{'fields' => "attmnt","wc" => "nr.name = '#{ciname}'"})
     att_nr.each do |att|
@@ -161,7 +164,7 @@ class Rusdc < Thor
     end
   end
 
-  desc "get_attachment_of_co", "<co_name> <filename>, download an attachment of a changeorder and print it out on stdout"
+  desc "get_attachment_of_co <co_name> <filename>", "download an attachment of a changeorder and print it out on stdout"
   def get_attachment_of_co(coname, filename)
     chg_id=loadcon.request("/caisd-rest/chg/COMMON_NAME-#{coname}")["chg"]["@id"]
     att_nr = loadcon.search("lrel_attachments_changes",{'fields' => "attmnt","wc" => "chg = #{chg_id}"})
@@ -173,12 +176,12 @@ class Rusdc < Thor
     end
   end
 
-  desc "in_list_child_ins", "<in> - list all child-incidents of one incident"
+  desc "in_list_child_ins <in>", "list all child-incidents of one incident"
   def in_list_child_ins(incident)
     invoke('find',['cr', "parent.ref_num = '#{incident}'", "ref_num"], {:format => "mlr"})
   end
 
-  desc "list_attachments_of_ci", "<ci_name>, list all attachments of a CI"
+  desc "list_attachments_of_ci <ci_name>", "list all attachments of a CI"
   def list_attachments_of_ci(ciname)
     att_nr = loadcon.search("lrel_attachments_nr",{'fields' => "attmnt","wc" => "nr.name = '#{ciname}'"})
     att_nr.each do |att|
@@ -186,7 +189,7 @@ class Rusdc < Thor
     end
   end
 
-  desc "list_attachments_of_co", "<co_name>, list all attachments of a changeorder"
+  desc "list_attachments_of_co <co_name>", "list all attachments of a changeorder"
   def list_attachments_of_co(coname)
     chg_id=loadcon.request("/caisd-rest/chg/COMMON_NAME-#{coname}")["chg"]["@id"]
     att_nr = loadcon.search("lrel_attachments_changes",{'fields' => "attmnt","wc" => "chg = #{chg_id}"})
@@ -195,7 +198,7 @@ class Rusdc < Thor
     end
   end
 
-  desc "nr_add_child", "<nr-name> <child-name>, add one child CI to another CI"
+  desc "nr_add_child <nr-name> <child-name>", "add one child CI to another CI"
   def nr_add_child(nr, child)
     template = ERB.new <<-EOF
       {
@@ -213,7 +216,7 @@ class Rusdc < Thor
     puts loadcon.create({:type => "json", :data => json})
   end
 
-  desc "nr_changes", "<nr> [inactive-too] - list all open changeorders of one CI"
+  desc "nr_changes <nr> [inactive-too]", "list all open changeorders of one CI"
   option :inactive_too, :type => :boolean, :default => false
   def nr_changes(nr)
     wc_add = (options[:inactive_too] ? "" : " and status.sym in ('Service pending','Work in progress','Customer Pending','Open','Hold')")
@@ -221,20 +224,20 @@ class Rusdc < Thor
     invoke 'find', ['chg', wc, 'chg_ref_num,summary,status'], {:format => "mlr"}
   end
 
-  desc "nr_childs", "<ci-name> , lists all childs CIs of a specific CI"
+  desc "nr_childs <ci-name>", "lists all childs CIs of a specific CI"
   def nr_childs(name)
     loadcon.search("hier",{'fields' => "*","wc" => "parent.name = '#{name}'"}).each do |c|
       puts c["child"]["@COMMON_NAME"]
     end
   end
 
-  desc "nr_incidents", "<nr> [inactive-too] -  lists all incident of a specific CI"
+  desc "nr_incidents <nr> [inactive-too]", "lists all incident of a specific CI"
   option :inactive_too, :type => :boolean, :default => false
   def nr_incidents(nr)
     invoke 'find', ['in', %(affected_resource.name = '#{nr}'#{options[:inactive_too] ? "" : " and not status.sym in ('Cancelled','Closed')"}), "ref_num,summary,status"], {:format => "mlr"}
   end
 
-  desc "nr_parents", "nr_parents <ci-name> , lists all parent CIs of a specific CI"
+  desc "nr_parents <ci-name>", "lists all parent CIs of a specific CI"
   def nr_parents(name)
     loadcon.search("hier",{'fields' => "*","wc" => "child.name = '#{name}'"}).each do |c|
       puts c["parent"]["@COMMON_NAME"]
@@ -254,6 +257,45 @@ class Rusdc < Thor
     puts loadcon.update({:type => "json", :data => STDIN.read})
   end
 
+  desc "update_attr <obj> <common_name> <key> <value>", "updates a direct (not referenced) attribute of one object."
+  def update_attr(obj, cn, k, v)
+    template = ERB.new <<-EOF
+      {
+        "<%= obj %>": {
+          "@COMMON_NAME": "<%= cn %>",
+          "<%= k %>": "<%= v %>"
+        }
+      }
+    EOF
+    json = template.result_with_hash({
+        :obj => obj,
+        :cn => cn,
+        :k => k,
+        :v => v
+      })
+    puts loadcon.update({:type => "json", :data => json})
+  end
+
+  desc "update_ref_attr <obj> <common_name> <key> <value>", "updates a referenced attribute of one object."
+  def update_ref_attr(obj, cn, k, v)
+    template = ERB.new <<-EOF
+      {
+        "<%= obj %>": {
+          "@COMMON_NAME": "<%= cn %>",
+          "<%= k %>": {
+            "@COMMON_NAME": "<%= v %>"
+          }
+        }
+      }
+    EOF
+    json = template.result_with_hash({
+        :obj => obj,
+        :cn => cn,
+        :k => k,
+        :v => v
+      })
+    puts loadcon.update({:type => "json", :data => json})
+  end
 
   private
 

data/change_log.md

@@ -0,0 +1,45 @@
+# changelog
+
+## 0.1.8
+
+- new function in rusdc `update_attr`
+
+Example for `update_attr`:
+
+```bash
+> rusdc help update_attr
+Usage:
+  rusdc update_attr <obj> <common_name> <key> <value>
+
+updates a direct (not referenced) attribute of one object.
+
+> rusdc get cnt 'gaida, oliver' | grep alt_phone
+  "alt_phone": "",
+> rusdc update_attr cnt 'gaida, oliver' alt_phone "+49123456789"
+> rusdc get cnt 'gaida, oliver' | grep alt_phone
+  "alt_phone": "+49123456789",
+```
+
+- new function in rusdc `update_ref_attr`
+
+Example for `update_ref_attr`:
+
+```bash
+> rusdc help update_ref_attr
+Usage:
+  rusdc update_ref_attr <obj> <common_name> <key> <value>
+
+updates a referenced attribute of one object.
+> rusdc find chg "chg_ref_num = 'CO000001'" status --format mlr
+status
+Work in progress
+> rusdc update_ref_attr chg CO000001 status "Service pending"
+> rusdc find chg "chg_ref_num = 'CO000001'" status --format mlr
+status
+Service pending
+```
+
+## 0.1.7
+
+- fix sorting the output of `rusdc find`
+- add new rusdc function `rusdc in_list_child_ins`

data/usd.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |spec|
   spec.name = 'usd'
-  spec.version = '0.1.7'
-  spec.date = '2019-11-01'
+  spec.version = '0.1.8'
+  spec.date = '2019-11-04'
   spec.summary = "SDM REST-API-Calls"
   spec.description = "a Ruby class and a commandlinetool for SDM REST-API-Calls"
   spec.authors = ["Oliver Gaida"]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: usd
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.8
 platform: ruby
 authors:
 - Oliver Gaida
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-11-01 00:00:00.000000000 Z
+date: 2019-11-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -80,6 +80,7 @@ files:
 - README.md
 - bin/rusdc
 - bin/set_env
+- change_log.md
 - lib/usd.rb
 - usd.gemspec
 homepage: https://github.com/ogaida/usd