ruby_hubspot_api 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6052dfd71294e988924beeab1b89662673ceaf93
-  data.tar.gz: 4b2e295931295d639e473a9b139df03ec7df1554
+  metadata.gz: 62b690c7e426369cd5979c4f6b5b0cec8b5a7620
+  data.tar.gz: 26047bb4aa34d3a91bf6c1aff80b6e3775220f4f
 SHA512:
-  metadata.gz: caee0d8350205b6bcf45bb4ed4b5421f3fdaacaff87acfcb52c4845858bbafb664f70acbca1a564a34a99a166fd1072a838702d4bf4044b076cfd0b77e87f6a7
-  data.tar.gz: 28cbb5b1ea5ebc076d7177e8f4ee35f450bbe7fbb33224a31c55f0801fc566b705cf9b65faf95453b91154675139fb33cfce557ea74e06afd001a09f710190bf
+  metadata.gz: a6512174b13fa2ef07740690864c79a6c3593c908c1fed37170ef35bf08ca7ae5ceb9a3e53fe12d53079eb4e4bb47a58801430103b96c9a7b78dfd67eaaabaa5
+  data.tar.gz: 6ea719cb62b217fdbbdb2009d64215369608ba8d3423b59245472fb64fcd957174c5cc28a0cbcbd1f5eaf904260d19e1989da528df913292c139b5f4d893110e

data/CHANGELOG.md

@@ -1,139 +1,139 @@
 
 ## v0.3.0
 
-- Clarify usage
-- More usage clarification
-- Create ruby.yml
-- fix the github workflow
-- fix the github workflow properly
-- add plaatforms to Gemfile.lock
-- add ruby 2.5 and reduce log output
-- try calling rspec directly
-- Use ERB in VCR tests so as to be independent of the env vars
-- ignore ruby version file
-- test on ruby 3.0 too
-- determine if a Hubspot property is read_only (or by negation updatable)
-- adding codecov
-- Using earlier bundler
-- Adding lcov format
-- Add read-only properties to resource class
-- Add property check to the contact spec
-- Only apply lcov formatter if running on github
-- try to upload the coverage results to codacy too
-- Adding Codacy badge
-- Ensure we always apply the right log_level
-- Tidy up documentation of resource
-- Yep. Back ported to 2.4
-- adjust some rubocop settings
-- Tidy up somer doc comments
-- Add some handling of required properties
-- Update user model to force specific properties to be retrieved
-- Improve logic of resource matching
-- Adds  :sparkle: attributes method to a resource
-- Tidy comments
-- Update the hierarchy to allow more flexibility
-- Fix find resources
-- Clear up processing results
-- Update batch spec
-- Bump the version
-- Adds validation for resource matcher
-- Dynamically add a method to batch to allow "resources" to be referred to as the resource_name
-- Ignore gem files
-- Drop cadacy for now
-- Update batch spec to check resource_matcher works
-- Ensure properties are passed as named argument
-- No cov for inspect
-- Allow ERB in json fixtures
-- Contact find_by_token spec
-- find_by_token method - uses v1 API
-- Tests the method missing setter for resource
-- Sanitize web mock output
-- Finish specs
-- check the env vars before sanitising
-- make erb explicitly determined by the file exension (.json.erb)
-- use safe navigation for extracting id
-- bump version
 - update gem version in lock file
+- bump version
+- use safe navigation for extracting id
+- make erb explicitly determined by the file exension (.json.erb)
+- check the env vars before sanitising
+- Finish specs
+- Sanitize web mock output
+- Tests the method missing setter for resource
+- find_by_token method - uses v1 API
+- Contact find_by_token spec
+- Allow ERB in json fixtures
+- No cov for inspect
+- Ensure properties are passed as named argument
+- Update batch spec to check resource_matcher works
+- Drop cadacy for now
+- Ignore gem files
+- Dynamically add a method to batch to allow "resources" to be referred to as the resource_name
+- Adds validation for resource matcher
+- Bump the version
+- Update batch spec
+- Clear up processing results
+- Fix find resources
+- Update the hierarchy to allow more flexibility
+- Tidy comments
+- Adds  :sparkle: attributes method to a resource
+- Improve logic of resource matching
+- Update user model to force specific properties to be retrieved
+- Add some handling of required properties
+- Tidy up somer doc comments
+- adjust some rubocop settings
+- Yep. Back ported to 2.4
+- Tidy up documentation of resource
+- Ensure we always apply the right log_level
+- Adding Codacy badge
+- try to upload the coverage results to codacy too
+- Only apply lcov formatter if running on github
+- Add property check to the contact spec
+- Add read-only properties to resource class
+- Adding lcov format
+- Using earlier bundler
+- adding codecov
+- determine if a Hubspot property is read_only (or by negation updatable)
+- test on ruby 3.0 too
+- ignore ruby version file
+- Use ERB in VCR tests so as to be independent of the env vars
+- try calling rspec directly
+- add ruby 2.5 and reduce log output
+- add plaatforms to Gemfile.lock
+- fix the github workflow properly
+- fix the github workflow
+- Create ruby.yml
+- More usage clarification
+- Clarify usage
 
 ## v0.2.0
 
-- Get the development dependencies right!
-- Bump the version again
-- describe find_by method
-- update lock
-- batch  :sparkle: upsert spec
-- Borrowing Object#blank? method cos it actually really helps...
-- batch implemntation
-- logger.debug the post body and response body
-- Adds a changes? Method on resource
-- Adds instance method resource_name on resource
-- Ensure keys are stringified
-- Add all end points to the batch spec
-- Adds create and archive methods to batches
-- Tidy up resource code
-- Cover the previously nocov'd code
-- Add api client logging spec
-- add configurable timeouts to requests
-- Move rate limit handling to the client
-- Simplify mocked responses in batch spec
-- Adds PagedBatch as pager for batch/read request
-- Update the Readme to add Batch operations
 - bump version
+- Update the Readme to add Batch operations
+- Adds PagedBatch as pager for batch/read request
+- Simplify mocked responses in batch spec
+- Move rate limit handling to the client
+- add configurable timeouts to requests
+- Add api client logging spec
+- Cover the previously nocov'd code
+- Tidy up resource code
+- Adds create and archive methods to batches
+- Add all end points to the batch spec
+- Ensure keys are stringified
+- Adds instance method resource_name on resource
+- Adds a changes? Method on resource
+- logger.debug the post body and response body
+- batch implemntation
+- Borrowing Object#blank? method cos it actually really helps...
+- batch  :sparkle: upsert spec
+- update lock
+- describe find_by method
+- Bump the version again
+- Get the development dependencies right!
 
 ## v0.1.2
 
-- Fix the Readme
-- Sure the search param is values where passing an array
-- update changelog and Gemfile.lock
 - bump version
+- update changelog and Gemfile.lock
+- Sure the search param is values where passing an array
+- Fix the Readme
 
 ## v0.1.1
 
-- adds the version numbers to the gemspec
-- Fix dependencies
 - bump version
+- Fix dependencies
+- adds the version numbers to the gemspec
 
 ## v0.1.0
 
-- Setup the configuration block
-- Adds spec for config
-- Set the auth headers when access_token configured
-- Version spec
-- don't test for client id
-- Load api client and add exception handler
-- Initial bases class Resource for api crud
-- Contact class with spec
-- Cassettes for contact spec
-- company model and spec with cassettes
-- Adds PagedCollection for paged results (list / search)
-- Adds Hubspot configuration to tests
-- Update required files
-- Adds list method to return PagedCollection
-- Add interface for search
-- VCR configuration
-- Contact/search cassette
-- Sample ENV file for developers
-- console with configuration if env vars set
-- Readme file
-- MIT license
-- allow connections if vcr_record_mode is on
-- Fix rubocop config
-- Update Readme
-- Log api requests and add interface to set logging
-- Update exception handing logic and add more exception classes
-- Test all parts of the config code
-- Adds user model (aliased to Owner) and specs
-- Add a configured? method to Hubspot module
-- Adds a dummy Hubspot::Property class
-- Update Paged request handling based on method
-- Adds a find_by mechanism for resources
-- Use the Hubspot::Property class to return properties for a given resource object
-- Update the specs for 100% coverage
-- Update the sample .env file
-- Reorder and clarify Readme
-- When we use limit(1) we should only return the object not an array
-- Test that we only get the properties we ask for or the defaults
-- Flatten the properties array into a comma separated list
-- Improve the intialiser
 - Update the changeling and link in gem spec
+- Improve the intialiser
+- Flatten the properties array into a comma separated list
+- Test that we only get the properties we ask for or the defaults
+- When we use limit(1) we should only return the object not an array
+- Reorder and clarify Readme
+- Update the sample .env file
+- Update the specs for 100% coverage
+- Use the Hubspot::Property class to return properties for a given resource object
+- Adds a find_by mechanism for resources
+- Update Paged request handling based on method
+- Adds a dummy Hubspot::Property class
+- Add a configured? method to Hubspot module
+- Adds user model (aliased to Owner) and specs
+- Test all parts of the config code
+- Update exception handing logic and add more exception classes
+- Log api requests and add interface to set logging
+- Update Readme
+- Fix rubocop config
+- allow connections if vcr_record_mode is on
+- MIT license
+- Readme file
+- console with configuration if env vars set
+- Sample ENV file for developers
+- Contact/search cassette
+- VCR configuration
+- Add interface for search
+- Adds list method to return PagedCollection
+- Update required files
+- Adds Hubspot configuration to tests
+- Adds PagedCollection for paged results (list / search)
+- company model and spec with cassettes
+- Cassettes for contact spec
+- Contact class with spec
+- Initial bases class Resource for api crud
+- Load api client and add exception handler
+- don't test for client id
+- Version spec
+- Set the auth headers when access_token configured
+- Adds spec for config
+- Setup the configuration block
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ruby_hubspot_api (0.3.0)
+    ruby_hubspot_api (0.3.1)
       httparty (>= 0.1, < 1.0)
 
 GEM

data/README.md

@@ -120,7 +120,7 @@ puts "Contact: #{contact.firstname} #{contact.lastname}"
 
 ### Updating an Existing Object
 
-To update an existing object, you can either modify the object and call `save`, or use the `update` method specifying the properties you want to update. You can test whether or not the object will need to upload changes to the api by using the changes? method
+To update an existing object, you can either modify the object and call `save`, or use the `update` method specifying the properties you want to update. You can test whether or not the object will need to upload changes to the api by using the changes? method. If you don't want to check for changes? you can use the method `save!` on the resource which will raise a Hubspot::NothingToDoError if there are no changes.
 
 Example using `save`:
 
@@ -136,6 +136,22 @@ contact.save # true
 contact.changes? # false
 ```
 
+Example using `save!`:
+
+```ruby
+contact = Hubspot::Contact.find(1)
+
+MyDecorator.new(contact).apply_changes!
+
+begin
+  contact.save!
+rescue Hubspot::NothingToDoError = _
+  puts "Nothing changed, cancelled api call"
+rescue Hubspot::RequestError => e
+  puts "API Error: #{e.message}"
+end
+```
+
 Example using `update`:
 
 ```ruby
@@ -274,6 +290,26 @@ end
 - **lte**: Less than or equal to.
 - **IN**: Matches any of the values in an array.
 
+#### Searching for empty values (NOT_HAS_PROPERTY)
+
+Any empty value in your search will be matched using the correect filter in Hubspot
+
+```ruby
+# Search for companies with no value for a given field
+companies = Hubspot::Company.search(query: { client_category: nil }, properties: %w[name number_of_employees])
+# Request body: {"filterGroups":[{"filters":[{"propertyName":"client_category","operator":"NOT_HAS_PROPERTY"}]}]
+
+puts "Searching for uncategorised customers"
+puts ""
+
+companies.each do |company|
+  category = company_category_by_size(company.number_of_employees)
+  company.update(client_category: category)
+
+  puts "  Found: #{company.name} (size #{company.number_of_employees}) - filed under #{category}"
+end
+```
+
 #### Specifying Properties in Search
 
 When performing a search, you can also specify which properties to return.

data/lib/hubspot/exceptions.rb

@@ -19,6 +19,7 @@ module Hubspot
   class RateLimitExceededError < RequestError; end
   class NotConfiguredError < StandardError; end
   class ArgumentError < StandardError; end
+  class NothingToDoError < StandardError; end
 
   class << self
     def error_from_response(response)

data/lib/hubspot/paged_collection.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'json'
 require_relative './api_client'
 require_relative './exceptions'
 

data/lib/hubspot/resource.rb

@@ -263,6 +263,8 @@ module Hubspot
       #
       # If no suffix is provided, the default comparison is equality (`EQ`).
       #
+      # If no value is provided, or is empty the NOT_HAS_PROPERTY operator will be used
+      #
       # query - [String, Hash] The query for searching. This can be either:
       #   - A String: for full-text search.
       #   - A Hash: where each key represents a property and may have suffixes for the comparison
@@ -356,9 +358,9 @@ module Hubspot
         filter_groups = [{ filters: [] }]
 
         filters.each do |key, value|
-          filter = extract_property_and_operator(key)
+          filter = extract_property_and_operator(key, value)
           value_key = value.is_a?(Array) ? :values : :value
-          filter[value_key] = value
+          filter[value_key] = value unless value.blank?
           filter_groups.first[:filters] << filter
         end
 
@@ -366,7 +368,9 @@ module Hubspot
       end
 
       # Extract property name and operator from the key
-      def extract_property_and_operator(key)
+      def extract_property_and_operator(key, value)
+        return { propertyName: key.to_s, operator: 'NOT_HAS_PROPERTY' } if value.blank?
+
         OPERATOR_MAP.each do |suffix, hubspot_operator|
           if key.to_s.end_with?(suffix)
             return {
@@ -454,6 +458,12 @@ module Hubspot
       end
     end
 
+    def save!
+      raise NothingToDoError, 'Nothing to save' unless changes?
+
+      save
+    end
+
     # If the resource exists in Hubspot
     #
     # Returns Boolean
@@ -622,6 +632,8 @@ module Hubspot
     def create_new
       created_resource = self.class.create(@changes)
       @id = created_resource.id
+      @properties.merge!(@changes)
+      @changes = {}
       @id ? true : false
     end
   end

data/lib/hubspot/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Hubspot
-  VERSION = '0.3.0'
+  VERSION = '0.3.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_hubspot_api
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Simon Brook
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-10-15 00:00:00.000000000 Z
+date: 2024-10-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake