Module: Restforce

Defined in:
lib/restforce.rb,
lib/restforce/mash.rb,
lib/restforce/client.rb,
lib/restforce/config.rb,
lib/restforce/sobject.rb,
lib/restforce/version.rb,
lib/restforce/document.rb,
lib/restforce/upload_io.rb,
lib/restforce/attachment.rb,
lib/restforce/collection.rb,
lib/restforce/middleware.rb,
lib/restforce/data/client.rb,
lib/restforce/concerns/api.rb,
lib/restforce/concerns/base.rb,
lib/restforce/concerns/verbs.rb,
lib/restforce/signed_request.rb,
lib/restforce/tooling/client.rb,
lib/restforce/abstract_client.rb,
lib/restforce/concerns/canvas.rb,
lib/restforce/middleware/gzip.rb,
lib/restforce/concerns/caching.rb,
lib/restforce/middleware/logger.rb,
lib/restforce/concerns/picklists.rb,
lib/restforce/concerns/streaming.rb,
lib/restforce/middleware/caching.rb,
lib/restforce/middleware/mashify.rb,
lib/restforce/concerns/connection.rb,
lib/restforce/middleware/multipart.rb,
lib/restforce/middleware/raise_error.rb,
lib/restforce/concerns/authentication.rb,
lib/restforce/middleware/instance_url.rb,
lib/restforce/middleware/authorization.rb,
lib/restforce/middleware/authentication.rb,
lib/restforce/middleware/custom_headers.rb,
lib/restforce/middleware/authentication/token.rb,
lib/restforce/middleware/authentication/password.rb

Defined Under Namespace

Modules: Concerns, CoreExtensions, Data, Tooling Classes: AbstractClient, Attachment, Collection, Configuration, Document, Mash, Middleware, SObject, SignedRequest

Constant Summary collapse

Error =
Class.new(StandardError)
ServerError =
Class.new(Error)
AuthenticationError =
Class.new(Error)
UnauthorizedError =
Class.new(Error)
APIVersionError =
Class.new(Error)
Client =
Data::Client
VERSION =
'2.5.1'
UploadIO =
Faraday::UploadIO

Class Attribute Summary collapse

Class Method Summary collapse

Class Attribute Details

.log(message) ⇒ Object



33
34
35
36
# File 'lib/restforce/config.rb', line 33

def log(message)
  return unless Restforce.log?
  configuration.logger.send(configuration.log_level, message)
end

Class Method Details

.configurationObject

Returns the current Configuration

Example

Restforce.configuration.username = "username"
Restforce.configuration.password = "password"


13
14
15
# File 'lib/restforce/config.rb', line 13

def configuration
  @configuration ||= Configuration.new
end

.configure {|configuration| ... } ⇒ Object

Yields the Configuration

Example

Restforce.configure do |config|
  config.username = "username"
  config.password = "password"
end

Yields:



25
26
27
# File 'lib/restforce/config.rb', line 25

def configure
  yield configuration
end

.data(*args, &block) ⇒ Object



54
55
56
# File 'lib/restforce.rb', line 54

def data(*args, &block)
  Restforce::Data::Client.new(*args, &block)
end

.decode_signed_request(*args) ⇒ Object

Helper for decoding signed requests.



63
64
65
# File 'lib/restforce.rb', line 63

def decode_signed_request(*args)
  SignedRequest.decode(*args)
end

.log?Boolean

Returns:

  • (Boolean)


29
30
31
# File 'lib/restforce/config.rb', line 29

def log?
  @log ||= false
end

.new(*args, &block) ⇒ Object

Alias for Restforce::Data::Client.new

Shamelessly pulled from github.com/pengwynn/octokit/blob/master/lib/octokit.rb



50
51
52
# File 'lib/restforce.rb', line 50

def new(*args, &block)
  data(*args, &block)
end

.tooling(*args, &block) ⇒ Object



58
59
60
# File 'lib/restforce.rb', line 58

def tooling(*args, &block)
  Restforce::Tooling::Client.new(*args, &block)
end