wattsense-api-client 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e5cc59939bd0952db2322c7edb70d025890d9a4f609d1721ce7ced2c60ad259
-  data.tar.gz: c38e19e274bf617810a7d5f917dc88e46eeaeedef1a09c7217b9307fc73f62ff
+  metadata.gz: 4916afb23e887ae08589fdaaad78580ae15af7e5ac95979cb0aafbef169bd859
+  data.tar.gz: ab72b48cf7d8704d5ceae305106c66c16e64d3672e8b76c174675bcb76e8489e
 SHA512:
-  metadata.gz: 96fec947210d528404ade2a792dcf591e2ef37b98139329f878a15183ecde4849dc406267925d4e97f03c87e4e9584a769a698693fd75491b38902d42eeca82e
-  data.tar.gz: eb062bf4ab929d98f0a9d39c6b0c4e7fed3011e68270422b463dbce6f747cb2ce23d6ef1e7f0f6943519153cfa195d5312a9fba8632fe52f67b83d8806f9de7d
+  metadata.gz: 79bf2c3af476a9305a6eeb93a20bb24c17fe85925152990e41be38d82a6225c4f4d2103257b342855c55dfaf9090daa96b36bf70648456832ad26e466d01291f
+  data.tar.gz: eabff64a18caf34439921ff2017748cd5592337f37793b66ed2f08df38c9435051847fcf0c48247df421c5defcb35f4d7611c644299869c37da4f98c73624bf4

data/lib/http_requester.rb

@@ -21,8 +21,27 @@ class HttpRequester
   # HTTP GET method
   #
   # TODO: document
-  def get(path, &before_req_callback)
-    do_request(::Net::HTTP::Get.new(uri_from_path(path)), before_req_callback)
+  def get(path, query_parameters = nil, &before_req_callback)
+    uri = uri_from_path_and_query_parameters(path, query_parameters)
+    do_request(::Net::HTTP::Get.new(uri), before_req_callback)
+  end
+
+  # HTTP POST method
+  #
+  # TODO: document
+  def post(path, payload, &before_req_callback)
+    req = ::Net::HTTP::Post.new(uri_from_path_and_query_parameters(path))
+    req.body = payload
+    do_request(req, before_req_callback)
+  end
+
+  # HTTP POST method
+  #
+  # TODO: document
+  def put(path, payload, &before_req_callback)
+    req = ::Net::HTTP::Put.new(uri_from_path_and_query_parameters(path))
+    req.body = payload
+    do_request(req, before_req_callback)
   end
 
   private
@@ -37,7 +56,9 @@ class HttpRequester
     end
   end
 
-  def uri_from_path(path)
-    URI("#{@base_url}/#{path}")
+  def uri_from_path_and_query_parameters(path, query_parameters = nil)
+    uri = URI("#{@base_url}/#{path}")
+    uri.query = ::URI.encode_www_form(query_parameters) if query_parameters
+    uri
   end
 end

data/lib/watt_sense_api/v1/client.rb

@@ -11,6 +11,8 @@ require 'http_requester'
 require 'watt_sense_api/v1/authentication'
 require 'watt_sense_api/v1/organization'
 require 'watt_sense_api/v1/user_management'
+require 'watt_sense_api/v1/device_information'
+require 'watt_sense_api/v1/properties_measurements'
 
 module WattSenseApi
   module V1
@@ -20,6 +22,8 @@ module WattSenseApi
       include ::WattSenseApi::V1::Authentication
       include ::WattSenseApi::V1::Organization
       include ::WattSenseApi::V1::UserManagement
+      include ::WattSenseApi::V1::DeviceInformation
+      include ::WattSenseApi::V1::PropertiesMeasurements
 
       # You can create a client V1 with both user's credentials or api creddentials.
       #
@@ -44,7 +48,16 @@ module WattSenseApi
             'Please give one of either couples: (api_key, api_secret) or (username, password)'
           )
         end
-        super(::WattSenseApi::V1::BASE_URL, auth_callback: @auth_block)
+        super(::WattSenseApi::V1::BASE_URL, auth_callback: @auth_block, headers_callback: headers_callback)
+      end
+
+      private
+
+      def headers_callback
+        lambda do |req|
+          req['Accept'] = 'application/json'
+          req['Content-Type'] = 'application/json'
+        end
       end
     end
   end

data/lib/watt_sense_api/v1/device_information.rb

@@ -0,0 +1,61 @@
+#--
+# Copyright (C) 2021 - Octopus Lab SAS
+# All rights are described by the GPLv3 license present in the file /LICENSE available in the
+# original repository of this file or [here](https://www.gnu.org/licenses/gpl-3.0.fr.html).
+#++
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+
+module WattSenseApi
+  module V1
+    # This module gather all the methods to deal with [Device Information](https://api.wattsense.com/#tag/Device-Information).
+    #
+    # In WattSense Api, the Wattsense Box is designated as device in all this API.
+    module DeviceInformation
+      # List all your devices
+      #
+      # @note: filters not implemented yet.
+      #
+      # @return [Array<Hash>] The devices information as a Hash in an Array.
+      # @raise [::WattSenseApi::HTTPError] when server response is not as expected (HTTPSuccess with a body)
+      def devices
+        response = get('devices')
+        raise(::WattSenseApi::HTTPError, response) unless response.is_a?(::Net::HTTPSuccess)
+
+        return [] if response.is_a?(::Net::HTTPNoContent)
+
+        ::JSON.parse(response.body)
+      end
+
+      # Get the information of the specified one
+      #
+      # @param deviceId [String] The ID of the device which you seek the informations
+      #
+      # @return [Hash] The device information as a Hash when id is not nil.
+      # @raise [::WattSenseApi::HTTPError] when server response is not as expected (HTTPSuccess with a body)
+      def device(id)
+        response = get("devices/#{id}")
+        raise(::WattSenseApi::HTTPError, response) unless response.is_a?(::Net::HTTPSuccess) && !response.body&.empty?
+
+        ::JSON.parse(response.body)
+      end
+
+      # Activate a device
+      #
+      # @note No check implemented nor tests.
+      #
+      # @param params [Hash] Parameters as expected by WattSense documentation.
+      #
+      # @return [Hash] The device information as a Hash
+      # @raise [::WattSenseApi::HTTPError] when server response is not as expected (HTTPSuccess with a body)
+      def device_activate(params)
+        response = post('devices', params)
+        raise(::WattSenseApi::HTTPError, response) unless response.is_a?(::Net::HTTPSuccess) && !response.body&.empty?
+
+        ::JSON.parse(response.body)
+      end
+    end
+  end
+end

data/lib/watt_sense_api/v1/properties_measurements.rb

@@ -0,0 +1,69 @@
+#--
+# Copyright (C) 2021 - Octopus Lab SAS
+# All rights are described by the GPLv3 license present in the file /LICENSE available in the
+# original repository of this file or [here](https://www.gnu.org/licenses/gpl-3.0.fr.html).
+#++
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+
+module WattSenseApi
+  module V1
+    # This module gather all the methods to deal with [Properties Measurements](https://api.wattsense.com/#tag/Properties-Measurements)
+    module PropertiesMeasurements
+      # Get the specified device's properties list with values.
+      #
+      # @see https://api.wattsense.com/#operation/listDevicePropertiesValues API documentation
+      #
+      # @param device_id [String] The device id
+      #
+      # @return [Array<Hash>|NilClass] Array of the properties' values or nil if your device is not configured
+      #   and/or has no properties.
+      # @raise [::WattSenseApi::HTTPError] when server response is not as expected (HTTPSuccess with a body)
+      def device_properties(device_id)
+        response = get("devices/#{device_id}/properties")
+        return ::JSON.parse(response.body) if response.is_a?(::Net::HTTPOK)
+
+        return if response.is_a?(::Net::HTTPNoContent)
+
+        raise(::WattSenseApi::HTTPError, response)
+      end
+
+      # Get a specified device's property to a given value.
+      #
+      # @see https://api.wattsense.com/#operation/getPropertyMeasurement API documentation
+      #
+      # @param device_id [String] The device id
+      # @param property_id [String] The property id or slug for which we ask the latest value
+      #
+      # @return [Hash|NilClass] Hash of the property's latest value (nil if property is unreachable)
+      # @raise [::WattSenseApi::HTTPError] when server response is not as expected (HTTPAccepted with a body)
+      def device_property(device_id, property_id)
+        response = get("devices/#{device_id}/properties/#{property_id}")
+        return ::JSON.parse(response.body) if response.is_a?(::Net::HTTPOK)
+
+        return if response.is_a?(::Net::HTTPNoContent)
+
+        raise(::WattSenseApi::HTTPError, response)
+      end
+
+      # Set a specified device's property to a given value.
+      #
+      # @see https://api.wattsense.com/#operation/setPropertyValue API documentation
+      #
+      # @param device_id [String] The device id
+      # @param property_id [String] The property id or slug for which we ask to set the value
+      # @param body [Hash] The body of the request. Hash that will be transformed to json.
+      #
+      # @return [Hash] Hash of the resulted action.
+      # @raise [::WattSenseApi::HTTPError] when server response is not as expected (HTTPAccepted with a body)
+      def device_property_set(device_id, property_id, body)
+        response = put("devices/#{device_id}/properties/#{property_id}", body.to_json)
+        return ::JSON.parse(response.body) if response.is_a?(::Net::HTTPAccepted)
+
+        raise(::WattSenseApi::HTTPError, response)
+      end
+    end
+  end
+end

data/lib/watt_sense_api/version.rb

@@ -6,6 +6,6 @@
 # frozen_string_literal: true
 
 module WattSenseApi
-  VERSION = '0.1.3'
+  VERSION = '0.2.0'
   public_constant :VERSION
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: wattsense-api-client
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Roland Laurès
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-17 00:00:00.000000000 Z
+date: 2021-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry
@@ -107,7 +107,9 @@ files:
 - lib/watt_sense_api/v1.rb
 - lib/watt_sense_api/v1/authentication.rb
 - lib/watt_sense_api/v1/client.rb
+- lib/watt_sense_api/v1/device_information.rb
 - lib/watt_sense_api/v1/organization.rb
+- lib/watt_sense_api/v1/properties_measurements.rb
 - lib/watt_sense_api/v1/user_management.rb
 - lib/watt_sense_api/version.rb
 - lib/wattsense-api-client.rb
@@ -117,7 +119,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://gitlab.com/octopuslab-public/wattsense-api-client/-/issues
   changelog_uri: https://gitlab.com/octopuslab-public/wattsense-api-client/-/blob/main/CHANGELOG.md
-  documentation_uri: https://octopuslab-public.gitlab.io/wattsense-api-client/0.1.3
+  documentation_uri: https://octopuslab-public.gitlab.io/wattsense-api-client/0.2.0
   homepage_uri: https://gitlab.com/octopuslab-public/wattsense-api-client
 post_install_message: 
 rdoc_options: []