lws 6.2.3 → 6.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19a64229c67667d2f4be7cc06ef40cdb06433cb71ccea6699dadc9c288ce0ab2
-  data.tar.gz: fe728933b84bd16634c2bff02b6633897708d28def2bd5c2d66e069bab0de5c1
+  metadata.gz: b78881916d363dc9fed830e0be6cecacc6b3928e699b047cb6004eab310f4ec8
+  data.tar.gz: 6de69f0e6437aeaf85cd1bdc1f6527a09cc0e9b33d200b377fb232ea932aa1b0
 SHA512:
-  metadata.gz: 83a4ae6fa730a5039dcd360276c3c94e85d34b884f8ce16343ce7a18ea65e3c583efc1574610cdd5152d8a1e0e4c8a6cc3e3818b0aa3811f55769478915d1833
-  data.tar.gz: 432272f9aae23ca1925a3ac1e2546146dcab56391808bcfd6fe625a6efb996b0449c72bf7fdce962b663e87007b26f97afc7cccdf346c413cc5fb0559f99f983
+  metadata.gz: 4f18155b4bf72c6572c9d2dac80d1bc2ad00b35bde4a4169806495fdd4deead5971d7da9c6b7954a7ec859d48a7ac067dfad71d1d8d92c79d557be760a90e2ce
+  data.tar.gz: a4935986105ecdf15dd71a6dc33b4b2d40ce5d14363eec241e87cef28904a3db94a542cbe37b9c1cd54955f6c5df60b49d83f11195fb733c414ea3c5ee084251

data/CHANGELOG.md

@@ -1,15 +1,30 @@
 # LeftClick Web Services Changelog
 
-Up until v6.1.0, we used the standard Gem version numbering starting at v0.0.1.
-From v6.1.0 on the version will follow the API version of LWS in the major/minor
-part of te version.
+Up until version 6.1.0, we used the standard Gem version numbering starting at
+version 0.0.1.  From version 6.1.0 on the version will follow the API version
+of LWS in the major/minor part of te version.
+
+The changelog follows the [Keep a Changelog] format from version 6.3.0 on.
+
+## [6.3.0] - 2019-09-05
+### Added
+* Added slide, layout and related models to the DigitalSignage app (#12103)
+* Added the `Storage` class to the DigitalSignage and Resource apps
+
+### Changed
+* All non-persisted objects are always saved (even without changes)
+
+### Fixed
+* Fixed typos in documentation
+* Fixed some code style issues
+* Default to an empty object if the API provides no data
 
 ## v6.2.3
 
 * Move common attributes to the generic model and add `url`/`url_html` (#12004)
 * Add password expiration attributes to the `Company` and `User` model of
-  the Auth app
-* Add new attributes to the `Collection` model of the Resource app
+  the Auth app (#12012)
+* Add new attributes to the `Collection` model of the Resource app (#12012)
 
 ## v6.2.2.1
 
@@ -122,3 +137,6 @@ part of te version.
 ## v0.0.1
 
 Initial release
+
+[Keep a Changelog]: https://keepachangelog.com/en/1.0.0/
+[6.3.0]: https://gitlab.leftclick.eu/platform/ruby-lws/compare/v6.2.3...v6.3.0

data/README.md

@@ -97,7 +97,7 @@ arguments.  It uses the production environment per default using the token
 provided by a command-line argument.  These defaults can be overriden using
 the configuration.  For example, to rename a map:
 
-```
+```sh
 $ lwsconsole -t "my_token" -a maps
 [1] lwsconsole(LWS::Maps)> Map.all.map(&:name)
 => ["Gebouw 1",

data/lib/lws.rb

@@ -38,7 +38,7 @@ module LWS
   # The list of supported apps (web service libraries) loaded by
   # {.setup}.
   SUPPORTED_APPS = [:generic, :auth, :corporate_website, :digital_signage,
-                    :maps, :presence, :resource, :ticket]
+                    :maps, :presence, :resource, :ticket].freeze
 
   # @return [Config] the API configuration for the web services
   mattr_reader :config

data/lib/lws/apps/digital_signage.rb

@@ -33,6 +33,11 @@ module LWS::DigitalSignage
     use_api LWS::DigitalSignage.api
   end
 
+  # (see Generic::Storage)
+  class Storage < LWS::Generic::Storage
+    use_api LWS::DigitalSignage.api
+  end
+
   ### App specific classes
 
   # = The channel class
@@ -60,7 +65,7 @@ module LWS::DigitalSignage
     belongs_to :display, class_name: "LWS::DigitalSignage::Display"
     # :nocov:
     def display
-      # Create a dummy method so that the original #display method is not used 
+      # Create a dummy method so that the original #display method is not used
       association(:display).load
     end
     # :nocov:
@@ -147,7 +152,7 @@ module LWS::DigitalSignage
     # @!attribute parent
     #   @return [Channel::Group, nil] the parent group of the channel group
     belongs_to :parent, class_name: "LWS::DigitalSignage::Channel::Group",
-                        foreign_key: "parent_id",
+                        foreign_key: :parent_id,
                         uri: "channel/groups/:id"
 
     # @!attribute parent_id
@@ -417,7 +422,7 @@ module LWS::DigitalSignage
     belongs_to :display, class_name: "LWS::DigitalSignage::Display"
     # :nocov:
     def display
-      # Create a dummy method so that the original #display method is not used 
+      # Create a dummy method so that the original #display method is not used
       association(:display).load
     end
     # :nocov:
@@ -447,7 +452,7 @@ module LWS::DigitalSignage
     # @!attribute aspect_ratio [r]
     #   The aspect ratio is recalculated immediately when the width and/or
     #   height of the resolution changes.
-    # 
+    #
     #   @return [String] the aspect ratio of the resolution
     attribute :aspect_ratio
 
@@ -476,6 +481,317 @@ module LWS::DigitalSignage
     attribute :width
   end
 
+  # = The layout class
+  class Layout < LWS::Generic::Model
+    use_api LWS::DigitalSignage.api
+
+    # @!attribute id [r]
+    #   @return [Integer] the (unique) ID of the layout
+    attribute :id
+
+    # @!attribute categories
+    #   @return [Array<Layout::Category>] the categories associated with
+    #     the layout
+    # FIXME: Missing endpoint in LWS
+    has_many :categories, class_name: "LWS::DigitalSignage::Layout::Category",
+                          uri: "layout/:layout_id/categories(/:id)"
+
+    # @!attribute company
+    #   @return [LWS::Auth::Company] the company the layout belongs to
+    belongs_to :company, class_name: "LWS::Auth::Company"
+
+    # @!attribute company_id
+    #   @return [Integer] the ID of the company the layout belongs to
+    attribute :company_id
+
+    # @!attribute default_duration
+    #   @return [5..3600] the default duration of a slide created from the layout
+    attribute :default_duration
+
+    # @!attribute description
+    #   @return [String, nil] the description of the layout
+    attribute :description
+
+    # @!attribute favorite
+    #   @return [Boolean] whether the layout is a favorite for the current account
+    attribute :favorite
+
+    # @!attribute name
+    #   @return [String] the name of the layout
+    attribute :name
+
+    # @!attribute parent
+    #   @return [Layout, nil] the parent of the layout
+    # FIXME: Missing parent_id field in LWS
+    belongs_to :parent, class_name: "LWS::DigitalSignage::Layout",
+                        foreign_key: :parent_id,
+                        uri: "layouts/:id"
+
+    # @!attribute parent_id
+    #   @return [Integer, nil] the ID of the parent of the layout
+    attribute :parent_id
+
+    # @!attribute priority
+    #   @return [Boolean] whether the layout has priority over others
+    attribute :priority
+
+    # @!attribute slides
+    #   @return [Array<Slide>] the slides using the layout
+    has_many :slides, class_name: "LWS::DigitalSignage::Slide",
+                      uri: "layouts/:layout_id/slides(/:id)"
+
+    # @!attribute trans
+    #   @return ["cut", "fadein", "zoomin", "slidein"] the transition of the
+    #     entire layout
+    attribute :trans
+
+    # @!attribute trans_direction
+    #   @return ["left", "right", "up", "down"] the direction of the transition
+    #     of the entire layout
+    attribute :trans_direction
+
+    # @!attribute trans_duration
+    #   @return [Integer] the duration of the transition of the entire layout
+    attribute :trans_duration
+
+    # @!attribute versions
+    #   @return [Array<Version>] the versions of the layout
+    has_many :versions, class_name: "LWS::DigitalSignage::Layout::Version",
+                        uri: "layouts/:layout_id/versions(/:id)"
+
+    # @!attribute created_at [r]
+    #   @return [String] the timestamp of when the layout was created
+    attribute :created_at
+
+    # @!attribute updated_at [r]
+    #   @return [String] the timestamp of when the layout was last updated
+    attribute :updated_at
+  end
+
+  # = The layout category class
+  class Layout::Category < LWS::Generic::Model
+    use_api LWS::DigitalSignage.api
+    uri "layout/categories(/:id)"
+
+    # @!attribute id [r]
+    #   @return [Integer] the (unique) ID of the layout category
+    attribute :id
+
+    # @!attribute description
+    #   @return [String, nil] the description of the layout category
+    attribute :description
+
+    # @!attribute layouts
+    #   @return [Array<Layout>] the layouts that are associated with
+    #     the category
+    # FIXME: Missing endpoint in LWS
+    has_many :layouts, class_name: "LWS::DigitalSignage::Layout",
+                       uri: "layout/categories/:category_id/layouts(/:id)"
+
+    # @!attribute name
+    #   @return [String] the name of the layout category
+    attribute :name
+
+    # @!attribute created_at [r]
+    #   @return [String] the timestamp of when the layout category was created
+    attribute :created_at
+
+    # @!attribute updated_at [r]
+    #   @return [String] the timestamp of when the layout category was last updated
+    attribute :updated_at
+  end
+
+  # = The layout element class
+  #
+  # @note
+  #   This class is only used within the context of the {Layout::Version} class.
+  class Layout::Element < LWS::Generic::Model
+    use_api LWS::DigitalSignage.api
+
+    # @!attribute id [r]
+    #   @return [Integer] the (unique) ID of the layout element
+    attribute :id
+
+    # @!attribute asset_storage_ids
+    #   @return [Array<String>] the storage IDs of the assets of the layout element
+    attribute :asset_storage_ids
+
+    # @!attribute asset_urls
+    #   This is a list of mappings of the asset filename (key +"filename"+) to the
+    #   asset URL (key +"url"+).
+    #
+    #   @return [Array<Hash{String => String}>] the assets of the layout element
+    attribute :asset_urls
+
+    # @!attribute customizables
+    #  @return [Array<Layout::Element::Customizable>] the customizable properties
+    #    of the layout element
+    has_many :customizables, class_name: "LWS::DigitalSignage::Layout::Element::Customizable"
+
+    # @!attribute index
+    #   @return [Integer, nil] the index of the element within the list of
+    #     layout elements of the associated layout version
+    attribute :index
+
+    # @!attribute klass
+    #   @return [String] the class of the layout element
+    attribute :klass
+
+    # @!attribute parent
+    #   @return [Layout, nil] the parent of the layout element
+    # FIXME: Missing endpoint in LWS
+    belongs_to :parent, class_name: "LWS::DigitalSignage::Layout::Element",
+                        foreign_key: :parent_id
+
+    # @!attribute parent_id
+    #   @return [Integer, nil] the ID of the parent of the layout element
+    attribute :parent_id
+
+    # @!attribute properties
+    #  @return [Array<Layout::Element::Property>] the properties of the layout
+    #    element
+    has_many :properties, class_name: "LWS::DigitalSignage::Layout::Element::Property"
+
+    # @!attribute version
+    #   @return [Layout::Verion] the layout version that contains the element
+    # FIXME: Missing endpoint in LWS
+    belongs_to :version, class_name: "LWS::DigitalSignage::Layout::Version",
+                         foreign_key: :layout_version_id
+
+    # @!attribute created_at [r]
+    #   @return [String] the timestamp of when the layout element was created
+    attribute :created_at
+
+    # @!attribute updated_at [r]
+    #   @return [String] the timestamp of when the layout element was last
+    #     updated
+    attribute :updated_at
+  end
+
+  # = The layout element customizable class
+  #
+  # @note
+  #   This class is only used within the context of the {Layout::Element} class.
+  class Layout::Element::Customizable < LWS::Generic::Model
+    use_api LWS::DigitalSignage.api
+
+    # @!attribute id [r]
+    #   @return [Integer] the (unique) ID of the layout element customizable
+    #     property
+    attribute :id
+
+    # @!attribute attr
+    #   @return [String] the customizable attribute/property name
+    attribute :attr
+
+    # @!attribute element
+    #   @return [Layout::element] the layout element the customizable property
+    #     is for
+    belongs_to :element, class_name: "LWS::DigitalSignage::Layout::Element"
+
+    # @!attribute element_id
+    #   @return [Integer] the ID of the layout element the customizable is for
+    attribute :element_id
+
+    # @!attribute hint_message
+    #   @return [String] the customizable attribute/property value
+    attribute :hint_message
+
+    # @!attribute presets
+    #   @return [Array<Hash>] the presets for attribute values (label to value)
+    attribute :presets
+
+    # @!attribute uuid
+    #   @return [String] the UUID of the customizable attribute/property
+    attribute :uuid
+
+    # @!attribute created_at [r]
+    #   @return [String] the timestamp of when the layout element customizable
+    #     was created
+    attribute :created_at
+
+    # @!attribute updated_at [r]
+    #   @return [String] the timestamp of when the layout element customizable
+    #     was last updated
+    attribute :updated_at
+  end
+
+  # = The layout element property class
+  #
+  # @note
+  #   This class is only used within the context of the {Layout::Element} class.
+  class Layout::Element::Property < LWS::Generic::Model
+    use_api LWS::DigitalSignage.api
+
+    # @!attribute id [r]
+    #   @return [Integer] the (unique) ID of the layout element property
+    attribute :id
+
+    # @!attribute attr
+    #   @return [String] the attribute/property name
+    attribute :attr
+
+    # @!attribute element
+    #   @return [Layout::Element] the layout element the property
+    #     is for
+    belongs_to :element, class_name: "LWS::DigitalSignage::Layout::Element"
+
+    # @!attribute element_id
+    #   @return [Integer] the ID of the layout element the property is for
+    attribute :element_id
+
+    # @!attribute locked
+    #   @return [Boolean] whether the attribute/property value is locked
+    attribute :locked
+
+    # @!attribute value
+    #   @return [String] the attribute/property value
+    attribute :value
+
+    # @!attribute created_at [r]
+    #   @return [String] the timestamp of when the layout element was created
+    attribute :created_at
+
+    # @!attribute updated_at [r]
+    #   @return [String] the timestamp of when the layout element was last
+    #     updated
+    attribute :updated_at
+  end
+
+  # = The layout version class
+  #
+  # @note
+  #   This class is only used within the context of the {Layout} class.
+  class Layout::Version < LWS::Generic::Model
+    use_api LWS::DigitalSignage.api
+    uri "layout/Layout_id/versions(/:id)"
+
+    # @!attribute id [r]
+    #   @return [Integer] the (unique) ID of the layout version
+    attribute :id
+
+    # @!attribute elements
+    #   @return [Array<Layout::Element>] the elements contained in the layout
+    #     version
+    has_many :elements, class_name: "LWS::DigitalSignage::Layout::Element"
+
+    # @!attribute layout
+    #   @return [Layout] the layout the layout version is for
+    belongs_to :layout
+
+    # @!attribute layout_id
+    #   @return [Integer] the ID of the layout the layout version is for
+    attribute :layout_id
+
+    # @!attribute created_at [r]
+    #   @return [String] the timestamp of when the layout version was created
+    attribute :created_at
+
+    # @!attribute updated_at [r]
+    #   @return [String] the timestamp of when the layout version was last updated
+    attribute :updated_at
+  end
+
   # = The player class
   class Player < LWS::Generic::Model
     use_api LWS::DigitalSignage.api
@@ -556,7 +872,7 @@ module LWS::DigitalSignage
     # @!attribute release_channel_id
     #   @return [Integer] the ID of the player OS release channel used by the
     #     player
-    attribute :releasee_channel_id
+    attribute :release_channel_id
 
     # @!attribute requests
     #   @return [Array<Player::Feedback>] the requests for the player
@@ -613,7 +929,7 @@ module LWS::DigitalSignage
     # @!attribute supplier
     #   @return [LWS::Auth::Company] the supplier of the component part
     belongs_to :supplier, class_name: "LWS::Auth::Company",
-                          foreign_key: "supplier_id",
+                          foreign_key: :supplier_id,
                           uri: "companies/:id"
 
     # @!attribute supplier_id
@@ -1368,7 +1684,7 @@ module LWS::DigitalSignage
     # @!attribute screenshot
     #   This field should be set once the action has been processed (see
     #   {#processed}) and the action is +"send_screenshot"+.
-    #  
+    #
     #   @return [Player::Screenshot, nil] the player screenshot as a response to
     #     the action request +"send_screenshot"+
     belongs_to :screenshot, class_name: "LWS::DigitalSignage::Player::Screenshot",
@@ -1429,6 +1745,128 @@ module LWS::DigitalSignage
     # @!attribute value
     #   @return [String, nil] the value of the player tag
     attribute :value
+
+    # @!attribute created_at [r]
+    #   @return [String] the timestamp of when the player tag was created
+    attribute :created_at
+
+    # @!attribute updated_at [r]
+    #   @return [String] the timestamp of when the player tag was last updated
+    attribute :updated_at
+  end
+
+  # = The slide class
+  class Slide < LWS::Generic::Model
+    use_api LWS::DigitalSignage.api
+
+    # @!attribute id [r]
+    #   @return [Integer] the (unique) ID of the slide
+    attribute :id
+
+    # @!attribute account
+    #   @return [LWS::Auth::Account] the account used for creating the slide
+    belongs_to :account, class_name: "LWS::Auth::Account"
+
+    # @!attribute account_id
+    #   @return [Integer] the ID of the account used for creating the slide
+    attribute :account_id
+
+    # @!attribute company
+    #   @return [LWS::Auth::Company] the company the slide belongs to
+    belongs_to :company, class_name: "LWS::Auth::Company"
+
+    # @!attribute company_id
+    #   @return [Integer] the ID of the company the slide belongs to
+    attribute :company_id
+
+    # @!attribute layout
+    #   @return [LWS::Layout] the layout the slide uses
+    belongs_to :layout
+
+    # @!attribute layout_id
+    #   @return [Integer] the ID of the layout the slide uses
+    attribute :layout_id
+
+    # @!attribute name
+    #   @return [String] the name of the slide
+    attribute :name
+
+    # @!attribute order_priority
+    #   @return [Integer] the order priority within a playlist for a channel
+    attribute :order_priority
+
+    # @!attribute schedules
+    #   @return [Array<Schedule>] the slide schedules that apply for the slide
+    # FIXME: Missing endpoint in LWS
+    has_many :schedules, class_name: "LWS::DigitalSignage::Slide::Schedule"
+
+    # @!attribute created_at [r]
+    #   @return [string] the timestamp of when the slide was created
+    attribute :created_at
+
+    # @!attribute updated_at [r]
+    #   @return [string] the timestamp of when the slide was last updated
+    attribute :updated_at
+  end
+
+  # = The slide schedule class
+  class Slide::Schedule < LWS::Generic::Model
+    use_api LWS::DigitalSignage.api
+
+    # @!attribute id [r]
+    #   @return [Integer] the (unique) ID of the slide schedule
+    attribute :id
+
+    # @!attribute date_end
+    #   @return [Date] the date after which the slide schedule becomes inactive
+    attribute :date_end
+
+    # @!attribute date_start
+    #   @return [Date] the date on which the slide schedule becomes active
+    attribute :date_start
+
+    # @!attribute duration
+    #   @return [Integer] the duration of the slide within the slide schedule
+    attribute :duration
+
+    # @!attribute name
+    #   @return [String] the name of the slide schedule
+    attribute :name
+
+    # @!attribute priority
+    #   @return ["low", "normal", "high"] the priority of the slide schedule
+    #     with respect to other slide schedules
+    attribute :priority
+
+    # @!attribute skip_every
+    #   @return [Integer] how many times to skip the slide within the slide
+    #     schedule
+    attribute :skip_every
+
+    # @!attribute slides
+    #   @return [Array<Slide>] the slides that use the slide schedule
+    # FIXME: Missing endpoint in LWS
+    has_many :slides, class: "LWS::DigitalSignage::Slide"
+
+    # @!attribute time_end
+    #   @return [Time] the time after which the slide schedule becomes inactive
+    attribute :time_end
+
+    # @!attribute time_start
+    #   @return [Time] the time on which the slide schedule becomes active
+    attribute :time_start
+
+    # @!attribute visible
+    #   @return [Boolean] whether the slide is visible within the slide schedule
+    attribute :visible
+
+    # @!attribute created_at [r]
+    #   @return [string] the timestamp of when the slide schedule was created
+    attribute :created_at
+
+    # @!attribute updated_at [r]
+    #   @return [string] the timestamp of when the slide schedule was last updated
+    attribute :updated_at
   end
 
 end

data/lib/lws/apps/generic.rb

@@ -144,7 +144,7 @@ module LWS::Generic
     # @return [Hash, Trueclass] a mapping of attributes names to values,
     #   or +true+ if no save action was necessary.
     def save
-      return true unless changed?
+      return true unless changed? || !persisted?
       result = super
       changes_applied if result
       result
@@ -175,4 +175,72 @@ module LWS::Generic
     attribute :updated_at
   end
 
+  # = The storage class
+  #
+  # This class can be used to upload files for this app module.
+  class Storage
+    # @!visibility private
+    def self.use_api(api)
+      @connection = Faraday.new(url: api.url_prefix) do |c|
+        config = LWS.config
+
+        # Request
+        c.request :json
+
+        # Response
+        c.use LWS::JSONLogger, config.logger if config.json_debug
+        c.use LWS::HTTPLogger, config.logger, config.http_debug_headers if config.http_debug
+
+        # Adapter
+        if config.http_persistent
+          c.adapter :net_http_persistent
+        else
+          c.adapter Faraday.default_adapter
+        end
+      end
+    end
+
+    # Uploads a file (or IO object) to the storage of the app module.
+    #
+    # The resulting storage ID can be used in model attributes that refer to storage
+    # IDs (e.g. {DigitalSignage::Layout::Element#asset_storage_ids}).
+    #
+    # @param file_or_io [File, IO] the file (or IO object) to upload
+    # @param filename [String] the filename to use for the uploaded file/IO object
+    # @param content_type [String] the content type of the uploaded file/IO object
+    # @return [String, nil] the storage ID (if successful)
+    def self.create(file_or_io, filename, content_type = "application/octet-stream")
+      return nil if file_or_io.closed?
+
+      data = file_or_io.read
+      checksum = Digest::MD5.base64digest(data)
+      body = { blob: { filename: filename,
+                       content_type: content_type,
+                       byte_size: data.length,
+                       checksum: checksum } }
+      res = @connection.post do |req|
+        req.url "rails/active_storage/direct_uploads"
+        req.headers["Accept"] = "application/json"
+        req.headers["Content-Type"] = "application/json"
+        req.body = body.to_json
+      end
+
+      if res.success?
+        result = JSON.parse(res.body)
+        res = @connection.put do |req|
+          req.url result.dig("direct_upload", "url")
+          result.dig("direct_upload", "headers").each do |hdr, val|
+            req.headers[hdr] = val
+          end
+          req.body = data
+        end
+        if res.success?
+          result["signed_id"]
+        end
+      else
+        nil
+      end
+    end
+  end
+
 end

data/lib/lws/apps/resource.rb

@@ -33,6 +33,11 @@ module LWS::Resource
     use_api LWS::Resource.api
   end
 
+  # (see Generic::Storage)
+  class Storage < LWS::Generic::Storage
+    use_api LWS::Resource.api
+  end
+
   ### App specific classes
 
   # = The collection class
@@ -168,7 +173,7 @@ module LWS::Resource
   # = The collection post class
   class Collection::Post < Collection::Item
     use_api LWS::Resource.api
-    
+
     # @!attribute author
     #   @return [String] the author of the post
     attribute :author
@@ -176,11 +181,11 @@ module LWS::Resource
     # @!attribute avatar
     #   @return [Hash] the URL information of the avatar image of the post
     attribute :avatar
-    
+
     # @!attribute category
     #   @return [String] the category of the post
     attribute :category
-    
+
     # @!attribute comments
     #   @return [String] the comments of the post
     attribute :comments
@@ -188,7 +193,7 @@ module LWS::Resource
     # @!attribute description
     #   @return [String] the description of the post
     attribute :description
-    
+
     # @!attribute description
     #   @return [String] the description of the post
     attribute :enclosures
@@ -199,29 +204,29 @@ module LWS::Resource
 
     # @!attribute handle
     #   @return [String] the handle of the post
-    attribute :handle  
+    attribute :handle
 
     # @!attribute link
     #   @return [String] the link of the post
     attribute :link
-    
+
     # @!attribute link
     #   @return [String] the timestamp of the modification date of the post
     attribute :modification_date
-    
+
     # @!attribute order_priority
     #   @return [Integer] the order priority of the of the post (ascending;
     #     0 is lowers)
     attribute :order_priority
-    
+
     # @!attribute link
     #   @return [String] the timestamp of the publication date of the post
     attribute :publication_date
-    
+
     # @!attribute source_url
     #   @return [String] the source URL of the post
     attribute :source_url
-    
+
     # @!attribute summary
     #   @return [String] the summary of the post
     attribute :summary
@@ -376,7 +381,7 @@ module LWS::Resource
 
     # @!attribute observation
     #   @return [Boolean] whether the weather location forecast is a
-    #     current observation 
+    #     current observation
     attribute :observation
 
     # @!attribute temperature

data/lib/lws/middleware/http_logger.rb

@@ -50,7 +50,7 @@ module LWS
       end
 
     end
-   
+
   end
 
 end

data/lib/lws/middleware/json_parser.rb

@@ -18,7 +18,7 @@ module LWS
     class JSONParser < Faraday::Response::Middleware
 
       def parse(body)
-        data = MultiJson.load(body, symbolize_keys: true)
+        data = MultiJson.load(body, symbolize_keys: true) || {}
         metadata = data.delete(:metadata)
         errors = data.delete(:errors)
 

data/lib/lws/middleware/request_headers.rb

@@ -10,7 +10,7 @@
 
 
 module LWS
- 
+
   module Middleware
 
     # @private

data/lib/lws/version.rb

@@ -13,6 +13,6 @@ module LWS
 
   # The LWS library version.
   # @note The major and minor version parts match the LWS API version!
-  VERSION = '6.2.3'.freeze
+  VERSION = '6.3.0'.freeze
 
 end

data/test/digital_signage_test.rb

@@ -240,6 +240,163 @@ class TestDigitalSignageDisplayResolution < MiniTest::Test
 
 end
 
+class TestDigitalSignageLayout < MiniTest::Test
+
+  include LWS::DigitalSignage
+
+  def setup
+    @layout = Layout.find(1)
+  end
+
+  def test_valid
+    refute_nil(@layout)
+    assert_instance_of(Layout, @layout)
+    refute_nil(@layout.id)
+  end
+
+  def test_valid_associations
+    # FIXME: Missing endpoint in LWS
+    #assert_instance_of(Layout::Category, @layout.categories.first)
+    # FIXME: Missing parent_id field in LWS
+    #assert_instance_of(Layout, @layout.parent)
+    # FIXME: Missing endpoint in LWS
+    #assert_instance_of(Slide, @layout.slides.first)
+    assert_instance_of(Layout::Version, @layout.versions.find(1))
+  end
+
+end
+
+class TestDigitalSignageLayoutCategory < MiniTest::Test
+
+  include LWS::DigitalSignage
+
+  def setup
+    @layout_category = Layout::Category.find(1)
+  end
+
+  def test_valid
+    refute_nil(@layout_category)
+    assert_instance_of(Layout::Category, @layout_category)
+    refute_nil(@layout_category.id)
+  end
+
+  def test_valid_associations
+    # FIXME: Missing endpoint in LWS
+    #assert_instance_of(Layout, @layout_categories.layouts.first)
+  end
+
+end
+
+class TestDigitalSignageLayoutElement < MiniTest::Test
+
+  include LWS::DigitalSignage
+
+  def setup
+    @layout = Layout.find(1)
+    # Layout versions only exist as child objects of layouts
+    @layout_version = @layout.versions.find(1)
+    # Layout elements only exist as child objects of layout versions
+    @layout_element = @layout_version.elements.first
+  end
+
+  def test_valid
+    refute_nil(@layout_element)
+    assert_instance_of(Layout::Element, @layout_element)
+    refute_nil(@layout_element.id)
+  end
+
+  def test_valid_associations
+    assert_instance_of(Layout::Element::Customizable, @layout_element.customizables.first)
+    assert_instance_of(Layout::Element::Property, @layout_element.properties.first)
+    # FIXME: Missing endpoint in LWS
+    #assert_instance_of(Layout::Version, @layout_element.version)
+    #assert_equal(@layout_version, @layout_element.version)
+    # FIXME: Missing endpoint in LWS
+    #assert_instance_of(Layout::Element, @layout_element.parent)
+  end
+
+end
+
+class TestDigitalSignageLayoutElementCustomizable < MiniTest::Test
+
+  include LWS::DigitalSignage
+
+  def setup
+    @layout = Layout.find(1)
+    # Layout versions only exist as child objects of layouts
+    @layout_version = @layout.versions.find(1)
+    # Layout elements only exist as child objects of layout versions
+    @layout_element = @layout_version.elements.first
+    # Layout element customizables only exist as child objects of layout elements
+    @layout_element_customizable = @layout_element.customizables.first
+  end
+
+  def test_valid
+    refute_nil(@layout_element_customizable)
+    assert_instance_of(Layout::Element::Customizable, @layout_element_customizable)
+    refute_nil(@layout_element_customizable.id)
+  end
+
+  def test_valid_associations
+    # FIXME: Missing endpoint in LWS
+    #assert_instance_of(Layout::Element, @layout_element_customizable.element)
+    #assert_equal(@layout_element, @layout_element_customizable.element)
+  end
+
+end
+
+class TestDigitalSignageLayoutElementProperty < MiniTest::Test
+
+  include LWS::DigitalSignage
+
+  def setup
+    @layout = Layout.find(1)
+    # Layout versions only exist as child objects of layouts
+    @layout_version = @layout.versions.find(1)
+    # Layout elements only exist as child objects of layout versions
+    @layout_element = @layout_version.elements.first
+    # Layout element properties only exist as child objects of layout elements
+    @layout_element_property = @layout_element.properties.first
+  end
+
+  def test_valid
+    refute_nil(@layout_element_property)
+    assert_instance_of(Layout::Element::Property, @layout_element_property)
+    refute_nil(@layout_element_property.id)
+  end
+
+  def test_valid_associations
+    # FIXME: Missing endpoint in LWS
+    #assert_instance_of(Layout::Element, @layout_element_property.element)
+    #assert_equal(@layout_element, @layout_element_property.element)
+  end
+
+end
+
+class TestDigitalSignageLayoutVersion < MiniTest::Test
+
+  include LWS::DigitalSignage
+
+  def setup
+    @layout = Layout.find(1)
+    # Layout versions only exist as child objects of layouts
+    @layout_version = @layout.versions.find(1)
+  end
+
+  def test_valid
+    refute_nil(@layout_version)
+    assert_instance_of(Layout::Version, @layout_version)
+    refute_nil(@layout_version.id)
+  end
+
+  def test_valid_associations
+    assert_instance_of(Layout::Element, @layout_version.elements.first)
+    assert_instance_of(Layout, @layout_version.layout)
+    assert_equal(@layout, @layout_version.layout)
+  end
+
+end
+
 class TestDigitalSignagePlayer < MiniTest::Test
 
   include LWS::DigitalSignage
@@ -828,3 +985,50 @@ class TestDigitalSignagePlayerTag < MiniTest::Test
   end
 
 end
+
+class TestDigitalSignageSlide < MiniTest::Test
+
+  include LWS::DigitalSignage
+
+  def setup
+    @slide = Slide.find(1)
+  end
+
+  def test_valid
+    refute_nil(@slide)
+    assert_instance_of(Slide, @slide)
+    refute_nil(@slide.id)
+  end
+
+  def test_valid_associations
+    assert_instance_of(LWS::Auth::Account, @slide.account)
+    assert_instance_of(LWS::Auth::Company, @slide.company)
+    assert_instance_of(Layout, @slide.layout)
+  end
+
+end
+
+class TestDigitalSignageSlideSchedule < MiniTest::Test
+
+  include LWS::DigitalSignage
+
+  def setup
+    @slide = Slide.find(1)
+    # Slide schedules only exist as decendant objects of players
+    # FIXME: Endpoint is missing in LWS
+    @slide_schedule = @slide.schedules.first
+  end
+
+  # FIXME: Endpoint is missing in LWS
+  #def test_valid
+  #  refute_nil(@slide_schedule)
+  #  assert_instance_of(Slide::Schedule, @slide_schedule)
+  #  refute_nil(@slide_schedule.id)
+  #end
+
+  # FIXME: Endpoint is missing in LWS
+  #def test_valid_associations
+  #  assert_instance_of(Slide, @slide_schedules.slides.first)
+  #end
+
+end

data/test/generic_test.rb

@@ -53,6 +53,12 @@ class TestGenericModel < MiniTest::Test
   end
 
   def test_dirty
+    # Always save a non-persisted object (even without changes)
+    configuration = Configuration.new
+    assert_empty(configuration.changes)
+    configuration.save
+    refute_empty(configuration.errors.messages)
+
     # No changes for a just found instance
     configuration = Configuration.find(@configuration.id)
     refute(configuration.changed?)
@@ -100,3 +106,14 @@ class TestGenericConfiguration < MiniTest::Test
   end
 
 end
+
+class TestGenericStorage < MiniTest::Test
+
+  # Generic class needs to be accessed under some kind of app
+  include LWS::Resource
+
+  def test_upload
+    data = StringIO.new("some file contents\n")
+    refute_nil(Storage.create(data, "test.txt", "text/plain"))
+  end
+end

data/test/resource_test.rb

@@ -20,7 +20,7 @@ require "test_helper"
 # * Collection::WeatherLocation
 # * Collection::WeatherLocation::Forecast
 
-class TestCollection < MiniTest::Test
+class TestResourceCollection < MiniTest::Test
 
   include LWS::Resource
 
@@ -43,7 +43,7 @@ class TestCollection < MiniTest::Test
 
 end
 
-class TestCollectionItem < MiniTest::Test
+class TestResourceCollectionItem < MiniTest::Test
 
   include LWS::Resource
 
@@ -65,7 +65,7 @@ class TestCollectionItem < MiniTest::Test
 
 end
 
-class TestFolder < MiniTest::Test
+class TestResourceFolder < MiniTest::Test
 
   include LWS::Resource
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lws
 version: !ruby/object:Gem::Version
-  version: 6.2.3
+  version: 6.3.0
 platform: ruby
 authors:
 - LeftClick B.V.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-03-25 00:00:00.000000000 Z
+date: 2019-09-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday_middleware