citric 0.10.0.post2

A client to the LimeSurvey Remote Control API 2, written in modern Python.

Citric

A client to the LimeSurvey Remote Control API 2, written in modern Python.

Features

• Supports the full RPC API via the Session class.
• Best effort to implement all the RPC methods in the Client class. See the API coverage page for details.
• Easily export survey data to CSV files, Pandas DataFrames and DuckDB databases.
• Easily download survey files (e.g. images, audio, etc.) to a local directory.
• Tested against LimeSurvey 6.0.0+ and 5.0.0+ versions.
• Experimental support for the new REST API.

Integration tests

Integration tests are run against a LimeSurvey instance, and both PostgreSQL and MySQL backends, using Docker Compose. The following versions of LimeSurvey were tested for this release:

• 6.3.8
• 6.3.7
• 6.3.6
• 5.6.48
• 5.6.47
• 5.6.46

Installation

$ pip install citric

Usage

from citric import Client

# Connect to your LimeSurvey instance
client =  Client(
    "https://mylimesite.limequery.com/admin/remotecontrol",
    "myusername",
    "mypassword",
)

# Print the LimeSurvey version
print(client.get_server_version())

# Print every survey's title
for survey in client.list_surveys():
    print(survey["surveyls_title"])

Documentation

Code samples and API documentation are available at citric.readthedocs.io.

Contributing

If you'd like to contribute to this project, please see the contributing guide.

Credits

• Markus Opolka for maintaining a very robust set of LimeSurvey Docker images.
• Claudio Jolowicz and his amazing blog post.