lws 7.0.0 → 7.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc635406b8325652b128c7214d332b1686fbd4ba0fee74bc4c8716d75d3a349a
-  data.tar.gz: 93953a65dec58a2a509866b4f0252d2c7e4a68227e09258f3376d946c5503ae6
+  metadata.gz: 71a8d517993d1edc2f3ee98d57c5e8d96722e8c30f3022e346eaeee1f548a8b8
+  data.tar.gz: ca21b87824d2470ebfde323df4e979be95ca943d79df42ab454d66626ab50532
 SHA512:
-  metadata.gz: 65fe4cc5990944a1512cbcd73868b76268f5fdc937ae5de344e57a7a4a5f05abe38256bc4d8d057a0e505871caa9f45dceb3fd859e9616a61afed5b3853c29fd
-  data.tar.gz: 60bba2e6c25ad035deb2193dc93cc9f3553364ea9bf7b0997e19f422ce5e8575118c143a7cf7862ce96b4dd47d515b0c46b17d2cb398a5f5d0328f26f119c96e
+  metadata.gz: 0bc0ba9e36161be2702592791d1c4baad190714b39fe5fe67e2e0b78c61cf80e5a53be2ce3d820497052b87e587f5efdfd0253fd4561f97debabfd961fb8b0d5
+  data.tar.gz: 6db01df5b9610858c985e4d1ab711cf29538a9bed8601437a7f476c3d633417ed910a93ed0b32b3ed9d88a7d993667f2ae8a03689c4afd4e4e959cbc417cdee2

data/bin/lwsconsole

@@ -134,7 +134,11 @@ end
 
 # Set up Pry
 FileUtils.mkdir_p("#{ENV['HOME']}/.local/share/LeftClick")
-Pry.config.history.file = "#{ENV['HOME']}/.local/share/LeftClick/lws_history"
+if Pry.config.history_file
+  Pry.config.history_file = "#{ENV['HOME']}/.local/share/LeftClick/lws_history"
+else
+  Pry.config.history.file = "#{ENV['HOME']}/.local/share/LeftClick/lws_history"
+end
 Pry.config.prompt_name = PROG_NAME
 
 # Print an LWS setup summary

data/lib/lws.rb

@@ -60,7 +60,7 @@ module LWS
   #     config.api_token_middleware = TokenAuthenticator
   #     config.caching_object = MyRedisCache.new
   #     config.environment = :development
-  #     config.endponts = { maps: "https://maps.leftclick.cloud" }
+  #     config.endpoints = { maps: "https://maps.leftclick.cloud" }
   #     config.http_debug = true
   #     config.json_debug = true
   #     config.logger = Rails.logger

data/lib/lws/apps/digital_signage.rb

@@ -78,6 +78,10 @@ module LWS::DigitalSignage
     #   @return [Array<Channel::Group>] the groups the channel is a member of
     has_many :groups, class_name: "LWS::DigitalSignage::Channel::Group"
 
+    # @!attribute marquee_config
+    #   @return [String] the marquee/ticker tape configuration (JSON) of the channel
+    attribute :marquee_config
+
     # @!attribute name
     #   @return [String] the name of the channel
     attribute :name
@@ -100,6 +104,10 @@ module LWS::DigitalSignage
     #   @return [Boolean] whether remote control is enabled for the channel
     attribute :remote_control
 
+    # @!attribute slides
+    #   @return [Array<Slide>] the slides schedules on the channel
+    has_many :slides, class_name: "LWS::DigitalSignage::Slide"
+
     # @!attribute tags
     #   @return [Array<Channel::Tag>] the tags of the channel
     has_many :tags, class_name: "LWS::DigitalSignage::Channel::Tag"
@@ -159,6 +167,10 @@ module LWS::DigitalSignage
     #   @return [Integer, nil] the ID of the parent group of the channel group
     attribute :parent_id
 
+    # @!attribute slides
+    #   @return [Array<Slide>] the slides schedules on the channel group
+    has_many :slides, class_name: "LWS::DigitalSignage::Slide"
+
     #@!attribute tags
     #   @return [Array<Channel::Group::Tag>] the tags of the channel group
     has_many :tags, class_name: "LWS::DigitalSignage::Channel::Group::Tag",
@@ -512,6 +524,10 @@ module LWS::DigitalSignage
     #   @return [Boolean] whether the layout is a favorite for the current account
     attribute :favorite
 
+    # @!attribute kind
+    #   @return ["marquee", "slide"] the kind of the layout
+    attribute :kind
+
     # @!attribute name
     #   @return [String] the name of the layout
     attribute :name
@@ -575,6 +591,10 @@ module LWS::DigitalSignage
     # @!attribute name
     #   @return [String] the name of the layout category
     attribute :name
+
+    # @!attribute translated_name
+    #   @return [String] the translated name of the layout category
+    attribute :name
   end
 
   # = The layout element class
@@ -624,6 +644,10 @@ module LWS::DigitalSignage
     #    element
     has_many :properties, class_name: "LWS::DigitalSignage::Layout::Element::Property"
 
+    # @!attribute title
+    #   @return [String, nil] the title of the layout element
+    attribute :title
+
     # @!attribute version
     #   @return [Layout::Verion] the layout version that contains the element
     # FIXME: Missing endpoint in LWS
@@ -709,6 +733,10 @@ module LWS::DigitalSignage
     #     version
     has_many :elements, class_name: "LWS::DigitalSignage::Layout::Element"
 
+    # @!attribute height
+    #   @return [Integer] the intended height of the layout version
+    attribute :width
+
     # @!attribute layout
     #   @return [Layout] the layout the layout version is for
     belongs_to :layout
@@ -716,6 +744,28 @@ module LWS::DigitalSignage
     # @!attribute layout_id
     #   @return [Integer] the ID of the layout the layout version is for
     attribute :layout_id
+
+    # @!attribute rotation
+    #   @return ["landscape", "portrait"] the rotation (orientation) of the
+    #     layout version
+    attribute :rotation
+
+    # @!attribute rotation_angle
+    #   @return [0, 90] the rotation angle of the layout version
+    attribute :rotation_angle
+
+    # @!attribute status [r]
+    #   @return ["initializing", "creating_pack", "creating_thumbnail", "available", "archive"]
+    #     the status of the layout version
+    attribute :status
+
+    # @!attribute thumbnail_url
+    #   @return [String, nil] the URL of the thumbnail of the layout version
+    attribute :thumbnail_url
+
+    # @!attribute width
+    #   @return [Integer] the intended width of the layout version
+    attribute :width
   end
 
   # = The player class
@@ -752,8 +802,16 @@ module LWS::DigitalSignage
     attribute :configuration_id
 
     # @!attribute feedbacks
-    #   @return [Array<Player::Feedback>] the feedbacks for the player
-    has_many :feedbacks, class_name: "LWS::DigitalSignage::Player::Feedback"
+    #   @return [Hash{String=>String}] a mapping of player feedback key/values
+    attribute :feedbacks
+
+    # @!attribute [r] health_percentage
+    #   @return [Fixnum] the health of the player (percentage)
+    attribute :health_percentage
+
+    # @!attribute [r] hostname
+    #   @return [String] the hostname used by the player (for DHCP for example)
+    attribute :hostname
 
     # @!attribute logs
     #   @return [Array<Player::Log>] the logs of the player
@@ -770,7 +828,7 @@ module LWS::DigitalSignage
     # @!attribute model
     #   @return [Player::Model] the model of the player
     belongs_to :model, class_name: "LWS::DigitalSignage::Player::Model",
-                                   uri: "player/models/:id"
+                       uri: "player/models/:id"
 
     # @!attribute model_id
     #   @return [Integer] the ID of the model of the player
@@ -780,15 +838,27 @@ module LWS::DigitalSignage
     #   @return [Array<Player::Notification>] the notifications for the player
     has_many :notifications, class_name: "LWS::DigitalSignage::Player::Notification"
 
-    # @!attribute operational_since
+    # @!attribute operational_hours [r]
+    #   @return [String, nil] the number of hours the player has been operational
+    attribute :operational_hours
+
+    # @!attribute operational_since [r]
     #   @return [String, nil] the date/time when the player became operational
     #     for the first time
     attribute :operational_since
 
+    # @!attribute os_release_version
+    #   @return [String, nil] the OS version the player is using (if known)
+    attribute :os_release_version
+
     # @!attribute parts
     #   @return [Array<Player::Component::Part>] the parts of the player
     has_many :parts, class_name: "LWS::DigitalSignage::Player::Component::Part"
 
+    # @!attribute registration_locked
+    #   @return [Boolean] whether registarion is locked for the player
+    attribute :registration_locked
+
     # @!attribute release_channel
     #   @return [Player::Os::ReleaseChannel] the player OS release channel used
     #     by the player
@@ -801,7 +871,7 @@ module LWS::DigitalSignage
     attribute :release_channel_id
 
     # @!attribute requests
-    #   @return [Array<Player::Feedback>] the requests for the player
+    #   @return [Array<Player::Request>] the requests for the player
     has_many :requests, class_name: "LWS::DigitalSignage::Player::Request"
 
     # @!attribute screenshots
@@ -816,10 +886,14 @@ module LWS::DigitalSignage
     #   @return [Boolean] whether the player is being serviced/is in service
     attribute :service
 
-    # @!attribute status
+    # @!attribute status [r]
     #   @return ["unknown", "good", "warning", "bad"] the player status
     attribute :status
 
+    # @!attribute status_reason [r]
+    #   @return [String] the reason for the current player status
+    attribute :status_reason
+
     # @!attribute tags
     #   @return [Array<Player::Tag>] the tags of the player
     has_many :tags, class_name: "LWS::DigitalSignage::Player::Tag"
@@ -970,75 +1044,6 @@ module LWS::DigitalSignage
     attribute :value
   end
 
-  # = The player feedback class
-  #
-  # @note
-  #   This class is only used within the context of the {Player} class.
-  class Player::Feedback < LWS::Generic::Model
-    use_api LWS::DigitalSignage.api
-    uri "players/:player_id/feedbacks(/:id)"
-
-    # @!attribute player
-    #   @return [Player] the player the feedback is originating from
-    belongs_to :player, class_name: "LWS::DigitalSignage::Player"
-
-    # @!attribute player_id
-    #   @return [Integer] the ID of the player the feedback is originating from
-    attribute :player_id
-
-    # @!attribute release
-    #   @return [Player::Os::Branch::Release] the player OS branch release the
-    #      feedback is related to
-    # FIXME: Missing branch_id field in LWS
-    belongs_to :release, class_name: "LWS::DigitalSignage::Player::Os::Branch::Release",
-                         uri: "player/os/branches/:branch_id/releases/:id"
-
-    # @!attribute release_id
-    #   @return [Integer] the ID of the player OS branch release the feedback
-    #     is related to
-
-    # @!attribute results
-    #   @return [Array<Player::Feedback::Result>] the results of the player feedback
-    # FIXME: Chained associations don't work yet in Spyke (#89)
-    has_many :results, class_name: "LWS::DigitalSignage::Player::Feedback::Result",
-                       uri: "players/:player_id/feedbacks/:feedback_id/results(/:id)"
-  end
-
-  # = The player feedback result class
-  #
-  # @note
-  #   This class is only used within the context of the {Player::Feedback}
-  #   class.
-  class Player::Feedback::Result < LWS::Generic::Model
-    use_api LWS::DigitalSignage.api
-    uri "players/:player_id/feedbacks/:feedback_id/results(/:id)"
-
-    # @!attribute feedback
-    #   @return [Player::Feedback] the player feedback the result is a part of
-    belongs_to :feedback, class_name: "LWS::DigitalSignage::Player::Feedback",
-                          uri: "players/:player_id/feedbacks/:id"
-
-    # @!attribute feedback_id
-    #   @return [Player::Feedback] the ID of the player feedback the result is a part of
-    attribute :feedback_id
-
-    # @!attribute key
-    #   @return [String] the key of the player feedback result
-    attribute :key
-
-    # @!attribute player
-    #   @return [Player] the player the feedback result is for
-    belongs_to :player, class_name: "LWS::DigitalSignage::Player"
-
-    # @!attribute player_id
-    #   @return [Integer] the ID of the player the feedback result is for
-    attribute :player_id
-
-    # @!attribute value
-    #   @return [String] the value of the player feedback result
-    attribute :value
-  end
-
   # = The player log class
   #
   # @note
@@ -1562,20 +1567,6 @@ module LWS::DigitalSignage
     #   @return [String, nil] the optional argument for the player request
     attribute :argument
 
-    # @!attribute feedback
-    #   This field should be set once the action has been processed (see
-    #   {#processed}) and the action is +"send_feedback"+.
-    #
-    #   @return [Player::Feedback, nil] the player feedback as a response to the
-    #     action request +"send_status"+
-    belongs_to :feedback, class_name: "LWS::DigitalSignage::Player::Feedback",
-                          uri: "players/:player_id/feedbacks/:id"
-
-    # @!attribute feedback_id
-    #   @return [Integer, nil] the ID of the player feedback as a response to the
-    #     action request +"send_status"+
-    attribute :feedback_id
-
     # @!attribute log
     #   This field should be set once the action has been processed (see
     #   {#processed}) and the action is +"send_logs"+.
@@ -1685,6 +1676,15 @@ module LWS::DigitalSignage
     #   @return [Integer] the ID of the account used for creating the slide
     attribute :account_id
 
+    # @!attribute channels
+    #   @return [Array<Channel>] the channels the slide is scheduled on
+    has_many :channels, class_name: "LWS::DigitalSignage::Channel"
+
+    # @!attribute channel_groups
+    #   @return [Array<Channel::Group>] the channel group the slide is
+    #     scheduled on
+    has_many :channel_groups, class_name: "LWS::DigitalSignage::Channel::Group"
+
     # @!attribute company
     #   @return [LWS::Auth::Company] the company the slide belongs to
     belongs_to :company, class_name: "LWS::Auth::Company"
@@ -1713,6 +1713,11 @@ module LWS::DigitalSignage
     #   @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 status [r]
+    #   @return ["initializing", "waiting_content", "available", "error"]
+    #     the status of the slide
+    attribute :status
   end
 
   # = The slide schedule class

data/lib/lws/apps/generic.rb

@@ -150,8 +150,9 @@ module LWS::Generic
       result
     end
 
-    # Extracts a nested attribute vlaue specified by the sequence of attribute names
+    # Extracts a nested attribute value specified by the sequence of attribute names
     # by calling dig at each step, returning +nil+ if any intermediate step is +nil+.
+    # @return [Object, nil] the digged up value or +nil+
     def dig(*attrs)
       attr = attrs.shift
       value = send(attr)
@@ -161,6 +162,20 @@ module LWS::Generic
       value.dig(*attrs)
     end
 
+    # Returns a deep copy of the model.
+    # @return [Model] a deep copy of the model
+    def deep_dup
+      dup_obj = super
+      dup_obj.instance_eval do
+        @changed_attributes = @changed_attributes.deep_dup
+        @previously_changed = @previously_changed.deep_dup
+        @scope = @scope.deep_dup
+        @spyke_attributes = @spyke_attributes.deep_dup
+        @uri_template = @uri_template.deep_dup
+      end
+      dup_obj
+    end
+
   end
 
   # = The configuration class
@@ -180,9 +195,11 @@ module LWS::Generic
   class Storage
     # @!visibility private
     def self.use_api(api)
-      @connection = Faraday.new(url: api.url_prefix) do |c|
-        config = LWS.config
+      config = LWS.config
 
+      # A connection to Active Storage (with JSON request/response, but without
+      # token authentication and caching).
+      @as_connection = Faraday.new(url: api.url_prefix) do |c|
         # Request
         c.request :json
 
@@ -197,6 +214,36 @@ module LWS::Generic
           c.adapter Faraday.default_adapter
         end
       end
+
+      # A plain file connection to LWS (with token autnentication and caching but without
+      # JSON request/response).
+      @lws_connection = Faraday.new(url: api.url_prefix) do |c|
+        # Request
+        if config.caching_object
+          c.use FaradayMiddleware::Caching, config.caching_object
+        end
+        c.use LWS::Middleware::RequestHeaders, config.api_token
+        c.use config.api_token_middleware if config.api_token_middleware.present?
+
+        # Response
+        c.use FaradayMiddleware::FollowRedirects, limit: 3
+        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
+
+    # (see .upload)
+    # @deprecated
+    #   To have a consistent upload/download naming counterpart, this
+    #   method has been deprecated. Use {.upload} instead.
+    def self.create(file_or_io, filename, content_type = "application/octet-stream")
+      upload(file_or_io, filename, content_type)
     end
 
     # Uploads a file (or IO object) to the storage of the app module.
@@ -208,7 +255,7 @@ module LWS::Generic
     # @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")
+    def self.upload(file_or_io, filename, content_type = "application/octet-stream")
       return nil if file_or_io.closed?
 
       data = file_or_io.read
@@ -217,7 +264,7 @@ module LWS::Generic
                        content_type: content_type,
                        byte_size: data.length,
                        checksum: checksum } }
-      res = @connection.post do |req|
+      res = @as_connection.post do |req|
         req.url "rails/active_storage/direct_uploads"
         req.headers["Accept"] = "application/json"
         req.headers["Content-Type"] = "application/json"
@@ -226,7 +273,7 @@ module LWS::Generic
 
       if res.success?
         result = JSON.parse(res.body)
-        res = @connection.put do |req|
+        res = @as_connection.put do |req|
           req.url result.dig("direct_upload", "url")
           result.dig("direct_upload", "headers").each do |hdr, val|
             req.headers[hdr] = val
@@ -240,6 +287,24 @@ module LWS::Generic
         nil
       end
     end
-  end
 
+    # Downloads a file at the provided URL from the storage using the
+    # appropriate API tokens.
+    #
+    # This method can be used to download images/assets/etc. from LWS using
+    # URLs provided by attributes that end with +_url+.
+    # @param url [String] the URL to download the file from
+    # @return [String] the contents of the file
+    def self.download(url)
+      return nil if url.nil?
+
+      unless url.start_with? @lws_connection.url_prefix.to_s
+        raise ArgumentError,
+          "URL does not belong to this LWS app (endpoint: #{@lws_connection.url_prefix})"
+      end
+
+      res = @lws_connection.get(url)
+      res.body
+    end
+  end
 end

data/lib/lws/apps/presence.rb

@@ -129,10 +129,18 @@ module LWS::Presence
     attribute :capacity_used_precentage_tree
 
     # @!attribute checkin_status
-    #   @return ["available", "busy", "away", "disabled", nil]
+    #   @return ["available", "busy", "away", nil]
     #     the presence status to set people to when checking in
     attribute :checkin_status
 
+    # @!attribute checkout_alter_status
+    #   @return ["available", "unavailable", "maintenance_cleaning",
+    #     "maintenance_technical", "permanent_available",
+    #     "permanent_unavailable", "permanent_maintenance_cleaning",
+    #     "permanent_maintenance_technical", nil] the status to set the
+    #     location to when someone checks out
+    attribute :checkout_alter_status
+
     # @!attribute checkout_location
     #   @return [Location, nil] the location to move people to when they
     #     are checked out
@@ -157,13 +165,24 @@ module LWS::Presence
     #   @return [Array<Integer>] the IDs of the underlying locations of the location
     attribute :descendant_ids
 
+    # @!attribute image_storage_id
+    #   @return [String, nil] the storage ID of the image of the location
+    attribute :image_storage_id
+
+    # @!attribute image_url
+    #   @note
+    #     To be able retrieve this, the token needs to be passed via +X-Token+
+    #     in the HTTP request headers!
+    #   @return [String, nil] the URL of the image of the location
+    attribute :image_url
+
     # @!attribute lat
     #   @return [Float] the latitude of the location
     attribute :lat
 
     # @!attribute logoff_time
-    # The format of the time is +HH:MM+ and should be interpreted in the time zone
-    # of the location (see also {#time_zone}).
+    #   The format of the time is +HH:MM+ and should be interpreted in the time zone
+    #   of the location (see also {#time_zone}).
     #   @return [String] the time everybody is automatically logged off
     attribute :logoff_time
 
@@ -221,6 +240,13 @@ module LWS::Presence
     #   @return [Array<Reader>] the (RFID/code/ID/...) readers linked to this location
     has_many :readers
 
+    # @!attribute status
+    #   @return ["available", "unavailable", "maintenance_cleaning",
+    #     "maintenance_technical", "permanent_available",
+    #     "permanent_unavailable", "permanent_maintenance_cleaning",
+    #     "permanent_maintenance_technical"] the status of the location
+    attribute :status
+
     # @!attribute time_zone
     #   @return [String] the time zone of the location
     attribute :time_zone
@@ -238,6 +264,17 @@ module LWS::Presence
     use_api LWS::Presence.api
     uri "locations/:location_id/maps(/:id)"
 
+    # @!attribute image_storage_id
+    #   @return [String, nil] the storage ID of the image of the map
+    attribute :image_storage_id
+
+    # @!attribute image_url
+    #   @note
+    #     To be able retrieve this, the token needs to be passed via +X-Token+
+    #     in the HTTP request headers!
+    #   @return [String, nil] the URL of the image of the map
+    attribute :image_url
+
     # @!attribute location
     #   @return [Location] the location the map belongs to
     belongs_to :location
@@ -251,6 +288,9 @@ module LWS::Presence
     attribute :name
 
     # @!attribute picture_url
+    #   @deprecated
+    #     Unauthenticated retrieval of the picture will not longer be supported
+    #     in upcoming releases of LWS. Use {#image_url} instead!
     #   @return [String, nil] the URL of the picture of the map
     attribute :picture_url
 
@@ -359,6 +399,17 @@ module LWS::Presence
     #   @return [Array<Appointment>] the appointments involving the person
     has_many :appointments
 
+    # @!attribute avatar_storage_id
+    #   @return [String, nil] the storage ID of the avatar of the person
+    attribute :avatar_storage_id
+
+    # @!attribute avatar_url
+    #   @note
+    #     To be able retrieve this, the token needs to be passed via +X-Token+
+    #     in the HTTP request headers!
+    #   @return [String, nil] the URL of the avatar of the person
+    attribute :avatar_url
+
     # @!attribute company
     #   @return [LWS::Auth::Company] the company the person belongs to
     belongs_to :company, class_name: "LWS::Auth::Company"
@@ -422,6 +473,14 @@ module LWS::Presence
     #   @return [Integer] the ID of the location the person is located at
     attribute :location_id
 
+    # @!attribute location_status_change_permissions
+    #   @return [Array<"available", "unavailable", "maintenance_cleaning",
+    #     "maintenance_technical", "permanent_available",
+    #     "permanent_unavailable", "permanent_maintenance_cleaning",
+    #     "permanent_maintenance_technical">] the location statuses the person
+    #     will clear to available on check-in
+    attribute :location_status_change_permissions
+
     # @!attribute long
     #   @return [Float, nil] the exact longitude of the person's location
     attribute :long
@@ -457,6 +516,9 @@ module LWS::Presence
     attribute :phone_mobile
 
     # @!attribute picture_url
+    #   @deprecated
+    #     Unauthenticated retrieval of the picture will not longer be supported
+    #     in upcoming releases of LWS. Use {#avatar_url} instead!
     #   @return [String, nil] the URL of the picture of the person
     attribute :picture_url
 
@@ -512,4 +574,9 @@ module LWS::Presence
     attribute :node
   end
 
+  # (see Generic::Storage)
+  class Storage < LWS::Generic::Storage
+    use_api LWS::Presence.api
+  end
+
 end

data/lib/lws/apps/resource.rb

@@ -108,6 +108,11 @@ module LWS::Resource
     #   @return [String] the URL of a preview of the collection
     attribute :preview_url
 
+    # @!attribute processing
+    #   @return [Boolean] whether the collection is being processed (i.e. it is
+    #     not ready for use)
+    attribute :processing
+
     # @!attribute uuid
     #   @return [String] the UUID used for unique file name generation
     attribute :uuid
@@ -537,6 +542,21 @@ module LWS::Resource
     # @!attribute parent_id
     #   @return [Integer, nil] the ID of the parent folder of the folder
     attribute :parent_id
+
+    # @!attribute permission
+    #   A UNIX-style permission that indicates whether the folder is shared and
+    #   who can read/write in it:
+    #   * 700: not shared (the default), only readable/writable by the
+    #     associated account
+    #   * 740: readable by anyone in the company
+    #   * 770: readable/writeable by anyone in the company
+    #   @return ["700", "740", "770"] the (share) permission of the folder
+    attribute :permission
+
+    # @!attribute temporary
+    #   @return [Boolean] whether the folder is temporary and thus will be
+    #     deleted after some time
+    attribute :temporary
   end
 
 end

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 = "7.0.0".freeze
+  VERSION = "7.1.1".freeze
 
 end

data/test/digital_signage_test.rb

@@ -30,6 +30,8 @@ class TestDigitalSignageChannel < MiniTest::Test
     assert_instance_of(Display, @channel.display)
     assert_instance_of(Channel::Group, @channel.groups.first)
     assert_instance_of(Player, @channel.players.first)
+    # FIXME: Missing endpoint in LWS
+    #assert_instance_of(Slide, @channel.slides.first)
     assert_instance_of(Channel::Tag, @channel.tags.first)
     assert_instance_of(Channel::TimeSchedule, @channel.time_schedule)
     assert_instance_of(Channel::TimeScheduleOverride, @channel.time_schedule_overrides.first)
@@ -55,6 +57,8 @@ class TestDigitalSignageChannelGroup < MiniTest::Test
     assert_instance_of(Channel, @channel_group.channels.first)
     assert_instance_of(LWS::Auth::Company, @channel_group.company)
     assert_instance_of(Channel::Group, @channel_group.parent)
+    # FIXME: Missing endpoint in LWS
+    #assert_instance_of(Slide, @channel_group.slides.first)
     assert_instance_of(Channel::Group::Tag, @channel_group.tags.first)
     assert_instance_of(Channel::TimeScheduleOverride, @channel_group.time_schedule_overrides.first)
   end
@@ -157,7 +161,7 @@ class TestDigitalSignageChannelTimeScheduleOverride < MiniTest::Test
   include LWS::DigitalSignage
 
   def setup
-    @channel_time_schedule_override = Channel::TimeScheduleOverride.all.first
+    @channel_time_schedule_override = Channel::TimeScheduleOverride.find(1)
   end
 
   def test_valid
@@ -526,64 +530,6 @@ class TestDigitalSignagePlayerConfigurationSetting < MiniTest::Test
 
 end
 
-class TestDigitalSignagePlayerFeedback < MiniTest::Test
-
-  include LWS::DigitalSignage
-
-  def setup
-    @player = Player.find(1)
-    # Player feedbacks only exist as child objects of players
-    @player_feedback = @player.feedbacks.first
-  end
-
-  def test_valid
-    refute_nil(@player_feedback)
-    assert_instance_of(Player::Feedback, @player_feedback)
-    refute_nil(@player_feedback.id)
-  end
-
-  def test_valid_associations
-    assert_instance_of(Player, @player_feedback.player)
-    assert_equal(@player, @player_feedback.player)
-    # FIXME: Missing branch_id field in LWS
-    #assert_instance_of(Player::Os::Branch::Release, @player_feedback.release)
-    # FIXME: Chained associations don't work yet in Spyke (#89)
-    #assert_instance_of(Player::Feedback::Result, @player_feedback.results.first)
-  end
-
-end
-
-class TestDigitalSignagePlayerFeedbackResult < MiniTest::Test
-
-  include LWS::DigitalSignage
-
-  def setup
-    @player = Player.find(1)
-    # Player feedbacks only exist as decendant objects of players
-    @player_feedback = @player.feedbacks.all.first
-    # Player feedback results only exist as decendant objects of player
-    # feedbacks
-    # FIXME: Chained associations don't work yet in Spyke (#89)
-    #@player_feedback_result = @player_feedback.results.first
-  end
-
-  # FIXME: Chained associations don't work yet in Spyke (#89)
-  #def test_valid
-  #  refute_nil(@player_feedback_result)
-  #  assert_instance_of(Player::Feedback::Result, @player_feedback_result)
-  #  refute_nil(@player_feedback_result.id)
-  #end
-
-  # FIXME: Chained associations don't work yet in Spyke (#89)
-  #def test_valid_associations
-  #  assert_instance_of(Player, @player_feedback_result.player)
-  #  assert_equal(@player, @player_feedback_result.player)
-  #  assert_instance_of(Player::Feedback, @player_feedback_result.feedback)
-  #  assert_equal(@player_feedback, @player_feedback_result.feedback)
-  #end
-
-end
-
 class TestDigitalSignagePlayerLog < MiniTest::Test
 
   include LWS::DigitalSignage
@@ -926,9 +872,7 @@ class TestDigitalSignagePlayerRequest < MiniTest::Test
     assert_equal(@player, @player_request.player)
     # FIXME: Chained associations don't work yet in Spyke (#89)
     #if @player_request.processed
-    #  if @player_request.feedback.present?
-    #    assert_instance_of(Player::Feedback, @player_request.feedback)
-    #  elsif @player_request.log.present?
+    #  if @player_request.log.present?
     #    assert_instance_of(Player::Log, @player_request.log)
     #  elsif @player_request.screenshot.present?
     #    assert_instance_of(Player::Screenshot, @player_request.screenshot)
@@ -1002,6 +946,8 @@ class TestDigitalSignageSlide < MiniTest::Test
 
   def test_valid_associations
     assert_instance_of(LWS::Auth::Account, @slide.account)
+    assert_instance_of(Channel, @slide.channels.first)
+    assert_instance_of(Channel::Group, @slide.channel_groups.first)
     assert_instance_of(LWS::Auth::Company, @slide.company)
     assert_instance_of(Layout, @slide.layout)
   end

data/test/generic_test.rb

@@ -106,6 +106,20 @@ class TestGenericModel < MiniTest::Test
     end
   end
 
+  def test_deep_dup
+    company = LWS::Auth::Company.find(1)
+    company_dup = company.deep_dup
+
+    # The object itself
+    refute_equal(company.object_id, company_dup.object_id)
+    # An object as attribute value
+    refute_equal(company.address.object_id, company_dup.address.object_id)
+    # A related object
+    refute_equal(company.contact_person.object_id, company_dup.contact_person.object_id)
+    # An item in array of related objects
+    refute_equal(company.accounts.first.object_id, company_dup.accounts.first.object_id)
+  end
+
 end
 
 class TestGenericConfiguration < MiniTest::Test
@@ -128,15 +142,37 @@ end
 class TestGenericStorage < MiniTest::Test
 
   # Generic class needs to be accessed under some kind of app
-  include LWS::Resource
+  include LWS::Presence
 
   def test_upload
     data = StringIO.new("some file contents\n")
+    refute_nil(Storage.upload(data, "test.txt", "text/plain"))
+
+    # Test the deprecated method (for now)
     refute_nil(Storage.create(data, "test.txt", "text/plain"))
 
     # Also test using the default HTTP adapter.
     reconfigure(http_persistent: false)
     data = StringIO.new("some more file contents\n")
-    refute_nil(Storage.create(data, "test2.txt", "text/plain"))
+    refute_nil(Storage.upload(data, "test2.txt", "text/plain"))
+  end
+
+  def test_download
+    location = Location.find(1)
+    refute_nil(location.image_url)
+
+    data = Storage.download(location.image_url)
+    assert(data.size > 0)
+
+    assert_nil(Storage.download(nil))
+
+    assert_raises(ArgumentError) do
+      Storage.download("https://doesnot.exist.tld/some/file")
+    end
+
+    # Also test using the default HTTP adapter.
+    reconfigure(http_persistent: false)
+    data = Storage.download(location.image_url)
+    assert(data.size > 0)
   end
 end

data/test/test_helper.rb

@@ -23,7 +23,7 @@ SimpleCov.at_exit do
   result.format!
   simplecov_test_suites = ['minitest']
   parallel_offset = ENV['PARALLEL_TEST_GROUPS'] ? ENV['PARALLEL_TEST_GROUPS'].to_i - 1 : 0
-  minimum_coverage = 97
+  minimum_coverage = 95
   # Count the number of commas in the command name to figure out how many result groups were combined into this result
   if result.command_name.scan(/,/).size + 1 >= simplecov_test_suites.size + (parallel_offset * 2) # two parallel suites
     # We only want to enforce minimum coverage after all test suites finish

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lws
 version: !ruby/object:Gem::Version
-  version: 7.0.0
+  version: 7.1.1
 platform: ruby
 authors:
 - LeftClick B.V.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-02-03 00:00:00.000000000 Z
+date: 2020-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday_middleware