Class: Smplkit::ManagementClient::FlagsNamespace

Inherits:
Object
  • Object
show all
Defined in:
lib/smplkit/management/client.rb

Instance Method Summary collapse

Constructor Details

#initialize(api_client) ⇒ FlagsNamespace

Returns a new instance of FlagsNamespace.



665
666
667
668
 
# File 'lib/smplkit/management/client.rb', line 665

def initialize(api_client)
  @api = SmplkitGeneratedClient::Flags::FlagsApi.new(api_client)
  @buffer = Management::FlagRegistrationBuffer.new
end

Instance Method Details

#_create_flag(flag) ⇒ Object 



753
754
755
756
 
# File 'lib/smplkit/management/client.rb', line 753

def _create_flag(flag)
  response = ErrorMapping.call { @api.create_flag(flag_body(flag)) }
  flag_from_resource(ResourceShim.from_model(response.data))
end

#_update_flag(flag) ⇒ Object 



758
759
760
761
 
# File 'lib/smplkit/management/client.rb', line 758

def _update_flag(flag)
  response = ErrorMapping.call { @api.update_flag(flag.id, flag_body(flag)) }
  flag_from_resource(ResourceShim.from_model(response.data))
end

#delete(id) ⇒ Object 



720
721
722
723
 
# File 'lib/smplkit/management/client.rb', line 720

def delete(id)
  ErrorMapping.call { @api.delete_flag(id) }
  true
end

#fetch_flag(id) ⇒ Object 



763
764
765
766
 
# File 'lib/smplkit/management/client.rb', line 763

def fetch_flag(id)
  response = ErrorMapping.call { @api.get_flag(id) }
  Smplkit::Flags::Helpers.flag_dict_from_json(ResourceShim.from_model(response.data))
end

#flush ⇒ Object

POST pending declarations to the bulk endpoint.

Items remain in the buffer until the request succeeds, so a flush against an unhealthy service is automatically retried by the next flush call (lazy start retry, periodic background flush, or final flush on close). Raises on failure — callers decide whether to retry.



688
689
690
691
692
693
694
695
696
697
698
699
700
701
 
# File 'lib/smplkit/management/client.rb', line 688

def flush
  batch = @buffer.peek
  return if batch.empty?

  flag_items = batch.map do |entry|
    SmplkitGeneratedClient::Flags::FlagBulkItem.new(
      id: entry["id"], type: entry["type"], default: entry["default"],
      service: entry["service"], environment: entry["environment"]
    )
  end
  body = SmplkitGeneratedClient::Flags::FlagBulkRequest.new(flags: flag_items)
  ErrorMapping.call { @api.bulk_register_flags(body) }
  @buffer.commit(batch.map { |b| b["id"] })
end

#get(id) ⇒ Object 



715
716
717
718
 
# File 'lib/smplkit/management/client.rb', line 715

def get(id)
  response = ErrorMapping.call { @api.get_flag(id) }
  flag_from_resource(ResourceShim.from_model(response.data))
end

#list(page_number: nil, page_size: nil) ⇒ Object 



707
708
709
710
711
712
713
 
# File 'lib/smplkit/management/client.rb', line 707

def list(page_number: nil, page_size: nil)
  opts = {}
  opts[:page_number] = page_number unless page_number.nil?
  opts[:page_size] = page_size unless page_size.nil?
  response = ErrorMapping.call { @api.list_flags(opts) }
  (response.data || []).map { |r| flag_from_resource(ResourceShim.from_model(r)) }
end

#list_flags ⇒ Object

Runtime entry — walks every page so an account holding more than RUNTIME_PAGE_SIZE flags still gets a complete in-memory store.



770
771
772
773
 
# File 'lib/smplkit/management/client.rb', line 770

def list_flags
  rows = PaginatedFetch.collect { |opts| @api.list_flags(opts) }
  rows.map { |r| Smplkit::Flags::Helpers.flag_dict_from_json(ResourceShim.from_model(r)) }
end

#new_boolean_flag(id, default:, name: nil, description: nil, values: nil) ⇒ Object 



725
726
727
728
729
730
 
# File 'lib/smplkit/management/client.rb', line 725

def new_boolean_flag(id, default:, name: nil, description: nil, values: nil)
  Smplkit::Flags::BooleanFlag.new(
    self, id: id, name: name || id, type: "BOOLEAN", default: default,
          description: description, values: values
  )
end

#new_json_flag(id, default:, name: nil, description: nil, values: nil) ⇒ Object 



746
747
748
749
750
751
 
# File 'lib/smplkit/management/client.rb', line 746

def new_json_flag(id, default:, name: nil, description: nil, values: nil)
  Smplkit::Flags::JsonFlag.new(
    self, id: id, name: name || id, type: "JSON", default: default,
          description: description, values: values
  )
end

#new_number_flag(id, default:, name: nil, description: nil, values: nil) ⇒ Object 



739
740
741
742
743
744
 
# File 'lib/smplkit/management/client.rb', line 739

def new_number_flag(id, default:, name: nil, description: nil, values: nil)
  Smplkit::Flags::NumberFlag.new(
    self, id: id, name: name || id, type: "NUMERIC", default: default,
          description: description, values: values
  )
end

#new_string_flag(id, default:, name: nil, description: nil, values: nil) ⇒ Object 



732
733
734
735
736
737
 
# File 'lib/smplkit/management/client.rb', line 732

def new_string_flag(id, default:, name: nil, description: nil, values: nil)
  Smplkit::Flags::StringFlag.new(
    self, id: id, name: name || id, type: "STRING", default: default,
          description: description, values: values
  )
end

#pending_count ⇒ Object 



703
704
705
 
# File 'lib/smplkit/management/client.rb', line 703

def pending_count
  @buffer.pending_count
end

#register(declaration) ⇒ Object 



670
671
672
673
674
675
676
677
678
679
 
# File 'lib/smplkit/management/client.rb', line 670

def register(declaration)
  @buffer.add(declaration)
  return unless @buffer.pending_count >= Management::FLAG_BATCH_FLUSH_SIZE

  begin
    flush
  rescue StandardError => e
    Smplkit.debug("registration", "threshold flag flush failed: #{e.class}: #{e.message}")
  end
end