lws 7.0.1 → 7.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df2e6e2da0a65bfe4f58710cd8d2e126d84b11a7d69032f8770019e9818b3c81
-  data.tar.gz: 381ab842c1653517ccafeefe6923d62559816e0546362b90a3803dffac91bc0c
+  metadata.gz: a6ddf096778ba5030a935df95f904a65776bbd8b2dd30602e3c9d912124fb5cd
+  data.tar.gz: 739154dc2c9598eef580f9a562cff9ddccde3a0828e985c55429ceed74f03a5d
 SHA512:
-  metadata.gz: fcee2864386b9c6e6c8d0a0a205e284f30ef40be1063079158be5618a8fe8e6bbc5b3d676f2fd12e39857bb3763d604efebea3c8477d80f9af6220dc6dc53b15
-  data.tar.gz: fd4da59a819e77accca4ade09513c1e5b2f60005173cd9372fb6e6172ceae5a4a5d3d43d2e70579372e43833b85e3091ca46e8b2ae8eae209321f359f5e7e8b9
+  metadata.gz: c6f4e39e00a7277ed012c6d4a2a846dae249edf892db185d17c5a62efa012902bc388ed4e652a26e25eb30ea07e208fbe4ef08b19671c750a0e3f33aa719f8a5
+  data.tar.gz: 696ae43f1ed90d4674365f86d63d411fc21544cce16ba250079e0bcefef1143c9d908c6e01b18773b006fa9a704e45ebc85795ff044c28948bf16fb79f4da042

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",
@@ -579,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
@@ -628,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
@@ -713,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
@@ -720,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
@@ -756,8 +802,12 @@ 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)
@@ -788,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
@@ -809,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
@@ -824,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"
@@ -978,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
@@ -1570,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"+.
@@ -1693,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"
@@ -1721,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

@@ -88,6 +88,46 @@ module LWS::Presence
     attribute :uuid
   end
 
+  # = The journal (entry) class
+  #
+  # @note
+  #   This class is only used within the context of the {Location} class.
+  class Journal < LWS::Generic::Model
+    use_api LWS::Presence.api
+
+    # @!attribute check_in
+    #   @return [String] the timestamp of the check-in of this journal (entry)
+    attribute :check_in
+
+    # @!attribute check_out
+    #   @return [String, nil] the timestamp of the check out of this journal (entry)
+    attribute :check_out
+
+    # @!attribute company
+    #   @return [LWS::Auth::Company] the company the journal (entry) belongs to
+    belongs_to :company, class_name: "LWS::Auth::Company"
+
+    # @!attribute company_id
+    #   @return [Integer] the ID of the company the journal (entry) belongs to
+    attribute :company_id
+
+    # @!attribute location
+    #   @return [Location] the location the journal (entry) belongs to
+    belongs_to :location
+
+    # @!attribute location_id
+    #   @return [Integer] the ID of the location the journal (entry) belongs to
+    attribute :location_id
+
+    # @!attribute person
+    #   @return [Person] the person the journal (entry) belongs to
+    belongs_to :person
+
+    # @!attribute person_id
+    #   @return [Integer] the ID of the person the journal (entry) belongs to
+    attribute :person_id
+  end
+
   # = The location class
   class Location < LWS::Generic::Model
     use_api LWS::Presence.api
@@ -133,6 +173,14 @@ module LWS::Presence
     #     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 +205,28 @@ 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 journals
+    #   @return [Array<Journal>] the journal (entries) associated with the location
+    has_many :journals, class: "LWS::Presence::Journal"
+
     # @!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 +284,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 +308,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 +332,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 +443,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 +517,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 +560,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 +618,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.1".freeze
+  VERSION = "7.1.2".freeze
 
 end

data/test/corporate_website_test.rb

@@ -16,7 +16,7 @@ class TestCorporateWebsiteArticle < MiniTest::Test
   include LWS::CorporateWebsite
 
   def setup
-    @page = Page.all.first
+    @page = Page.find(1)
     @article = @page.articles.first
   end
 
@@ -38,7 +38,7 @@ class TestCorporateWebsiteOfficeTime < MiniTest::Test
   include LWS::CorporateWebsite
 
   def setup
-    @office_time = OfficeTime.all.first
+    @office_time = OfficeTime.find(1)
   end
 
   def test_valid
@@ -54,7 +54,7 @@ class TestCorporateWebsitePage < MiniTest::Test
   include LWS::CorporateWebsite
 
   def setup
-    @page = Page.all.first
+    @page = Page.find(1)
   end
 
   def test_valid
@@ -75,7 +75,7 @@ end
 #  include LWS::CorporateWebsite
 #
 #  def setup
-#    @social_page = SocialPage.all.first
+#    @social_page = SocialPage.find(1)
 #  end
 #
 #  def test_valid
@@ -96,7 +96,7 @@ class TestCorporateWebsiteSocialPost < MiniTest::Test
   include LWS::CorporateWebsite
 
   def setup
-    @social_post = SocialPost.all.first
+    @social_post = SocialPost.find(1)
   end
 
   def test_valid

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

@@ -17,7 +17,7 @@ class TestGenericModel < MiniTest::Test
   include LWS::Auth
 
   def setup
-    @configuration = Configuration.all.first
+    @configuration = Configuration.find(1)
   end
 
   def test_her_compatibility
@@ -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
@@ -114,7 +128,7 @@ class TestGenericConfiguration < MiniTest::Test
   include LWS::Auth
 
   def setup
-    @configuration = Configuration.all.first
+    @configuration = Configuration.find(1)
   end
 
   def test_valid
@@ -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/maps_test.rb

@@ -16,7 +16,7 @@ class TestMapsMap < MiniTest::Test
   include LWS::Maps
 
   def setup
-    @map = Map.all.first
+    @map = Map.find(1)
   end
 
   def test_valid_map
@@ -37,7 +37,7 @@ class TestMapsMarker < MiniTest::Test
   include LWS::Maps
 
   def setup
-    @map = Map.all.first
+    @map = Map.find(1)
     # Markers only exist as child objects of maps
     @marker = @map.markers.first
   end
@@ -60,7 +60,7 @@ class TestMapsSource < MiniTest::Test
   include LWS::Maps
 
   def setup
-    @source = Source.all.first
+    @source = Source.find(1)
   end
 
   def test_valid_source

data/test/presence_test.rb

@@ -35,6 +35,29 @@ class TestPresenceAppointment < MiniTest::Test
 
 end
 
+class TestPresenceJournal < MiniTest::Test
+  include LWS::Presence
+
+  def setup
+    @location = Location.find(1)
+    # Journals only exist as child objects of a location
+    @journal = @location.journals.first
+  end
+
+  def test_valid
+    refute_nil(@journal)
+    assert_instance_of(Journal, @journal)
+    refute_nil(@journal.id)
+  end
+
+  def test_valid_associations
+    assert_instance_of(LWS::Auth::Company, @journal.company)
+    assert_instance_of(Location, @journal.location)
+    assert_equal(@location, @journal.location)
+    assert_instance_of(Person, @journal.person)
+  end
+end
+
 class TestPresenceLocation < MiniTest::Test
 
   include LWS::Presence
@@ -165,7 +188,7 @@ class TestPresenceReader < MiniTest::Test
   include LWS::Presence
 
   def setup
-    @reader = Reader.all.first
+    @reader = Reader.find(1)
   end
 
   def test_valid

data/test/resource_test.rb

@@ -25,7 +25,7 @@ class TestResourceCollection < MiniTest::Test
   include LWS::Resource
 
   def setup
-    @collection = Collection.all.first # FIXME
+    @collection = Collection.find(1)
   end
 
   def test_valid
@@ -48,7 +48,7 @@ class TestResourceCollectionItem < MiniTest::Test
   include LWS::Resource
 
   def setup
-    @collection = Collection.where(includes: "items").first # FIXME
+    @collection = Collection.where(includes: "items").find(1)
     @collection_item = @collection.items.first
   end
 
@@ -70,7 +70,7 @@ class TestResourceFolder < MiniTest::Test
   include LWS::Resource
 
   def setup
-    @folder = Folder.all.first
+    @folder = Folder.find(1)
   end
 
   def test_valid

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

data/test/ticket_test.rb

@@ -40,7 +40,7 @@ class TestTicketGroup < MiniTest::Test
   include LWS::Ticket
 
   def setup
-    @group = Group.all.first
+    @group = Group.find(1)
   end
 
   def test_valid
@@ -88,7 +88,7 @@ class TestTicketTag < MiniTest::Test
   include LWS::Ticket
 
   def setup
-    @tag = Tag.all.first
+    @tag = Tag.find(1)
   end
 
   def test_valid_tag

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lws
 version: !ruby/object:Gem::Version
-  version: 7.0.1
+  version: 7.1.2
 platform: ruby
 authors:
 - LeftClick B.V.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-02-10 00:00:00.000000000 Z
+date: 2020-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday_middleware
@@ -296,27 +296,27 @@ signing_key:
 specification_version: 4
 summary: LeftClick web services library for Ruby
 test_files:
+- test/presence_test.rb
+- test/fixtures/permissions.yml
+- test/fixtures/auth.yml
+- test/corporate_website_test.rb
+- test/logger_test.rb
 - test/support/with_env.rb
-- test/json_parser_test.rb
-- test/test_helper.rb
-- test/setup_test.rb
-- test/ticket_test.rb
-- test/api_token_middleware_test.rb
 - test/stubbing_test.rb
-- test/presence_test.rb
+- test/ticket_test.rb
 - test/digital_signage_test.rb
-- test/generic_test.rb
-- test/logger_test.rb
+- test/caching_test.rb
 - test/auth_test.rb
-- test/resource_test.rb
 - test/maps_test.rb
-- test/corporate_website_test.rb
-- test/config/tokens.yml
-- test/config/empty.yml
+- test/json_parser_test.rb
+- test/resource_test.rb
 - test/config/endpoints.yml
-- test/config/invalid.yml
 - test/config/switch_env.yml
+- test/config/invalid.yml
+- test/config/empty.yml
+- test/config/tokens.yml
 - test/config/full.yml
-- test/caching_test.rb
-- test/fixtures/auth.yml
-- test/fixtures/permissions.yml
+- test/setup_test.rb
+- test/api_token_middleware_test.rb
+- test/generic_test.rb
+- test/test_helper.rb