sfbulk

Development Status :: 2 - Pre-Alpha

sfbulk is a Python API wrapper for the Salesforce.com's Bulk API.

Salesforce.com Inc. is a global cloud computing company best known for its customer relationship management (CRM) product.

Salesforce.com provides different types of API. The Bulk API provides programmatic access that allow you to quickly load a big parties of your organization's data into the Salesforce.

Why sfbulk?

sfbulk attempts to alleviate many of the problems programmers might experience with Salesforce.com's' Bulk API by providing a cleaner, simpler and much more coherent API.

• You don't need to care of a creating XML for SOAP requests (if you're here, you're aware of how it is with SOAP in Python...)
• You can use the high limits of processing records (compared to Rest API)
• You can use it as an programming alternative to clicking Data Loader
• You can control sfbulk operations by Salesforce Bulk API monitor

sfbulk supports most all of the Salesforce.com's Bulk API functionality including:

• query
• insert
• update
• upsert
• delete

a large number of records asynchronously by submitting batches which are processed in the background by Salesforce.

Example

Here is a simple example of a basic insert operation for Campaign object processed with sfbulk.

from sfbulk import Bulk, logger
from time import sleep

# enable logging
logger.setLevel(logging.DEBUG)


# initialize bulk
bulk = Bulk()
bulk.login('username', 'password', 'security_token')

# create job
bulk.job_create('insert', 'Campaign')

# create batch
data = 'Name\none\ntwo\nthree'
bulk.batch_create(data)

# wait until job is completed
while (not bulk.job_is_completed()):
    sleep(10)

# close job
bulk.job_close()

Documentation

Learn more from documentation.

License

sfbulk is distributed under the GPL License.