p-gw / CitrusAPI.jl

Connect to the LimeSurvey API from Julia

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

CitrusAPI

Build Status Coverage

This Julia package provides a wrapper for the LimeSurvey Remote Control 2 API.

Installation

CitrusAPI is registered in the Julia General package registry. Simply install it by calling

pkg> add CitrusAPI

Getting started

If your LimeSurvey server is set up correctly you can start by setting up a CitrusClient and connecting to the server.

client = CitrusClient("https://your-limesurvey-server.com/index.php/admin/remotecontrol")
connect!(client, "username", "password")

Once the connection is established you can execute your desired API methods, e.g. getting a list of all surveys,

surveys = list_surveys(client)

Close the session by disconnecting from the server.

disconnect!(client)

Available methods

Note that CitrusAPI uses a more "julian" syntax for API methods. Methods that mutate data by either adding, deleting or modifying data are implemented as bang functions. For example the API method add_survey is implemented as the add_survey!.

  • activate_survey!
  • activate_tokens!
  • add_group!
  • add_language!
  • add_participants!
  • add_response!
  • add_survey!
  • copy_survey!
  • cpd_import_participants!
  • delete_group!
  • delete_language!
  • delete_participants!
  • delete_question!
  • delete_response!
  • delete_survey!
  • export_responses_by_token
  • export_responses
  • export_statistics
  • export_timeline
  • get_group_properties
  • get_language_properties
  • get_participant_properties
  • get_question_properties
  • get_response_ids
  • get_session_key
  • get_site_settings
  • get_summary
  • get_survey_properties
  • get_uploaded_files
  • import_group!
  • import_question!
  • import_survey!
  • invite_participants
  • list_groups
  • list_participants
  • list_questions
  • list_survey_groups
  • list_surveys
  • list_users
  • mail_registered_participants
  • release_session_key
  • set_group_properties!
  • set_language_properties!
  • set_participant_properties!
  • set_question_properties!
  • set_quota_properties!
  • set_survey_properties!
  • updade_response!
  • upload_file!

Convenience functions

  • connect!
  • disconnect!
  • expire_survey!
  • is_active
  • start_survey!

About

Connect to the LimeSurvey API from Julia

License:MIT License


Languages

Language:Julia 100.0%