Metadata-Version: 2.1
Name: ssaw
Version: 0.0.4
Summary: Wrapper for Survey Solutions API
Home-page: https://github.com/vavalomi/ssaw
Author: Zurab Sajaia
Author-email: vavalomi@hotmail.com
License: UNKNOWN
Keywords: Survey Solutions
Platform: UNKNOWN
Description-Content-Type: text/markdown
Requires-Dist: requests

# SSAW: Python wrapper for the Survey Solutions HTTP API

[![Build Status](https://travis-ci.org/vavalomi/ssaw.svg?branch=master)](https://travis-ci.org/vavalomi/ssaw)
[![codecov](https://codecov.io/gh/vavalomi/ssaw/branch/master/graph/badge.svg)](https://codecov.io/gh/vavalomi/ssaw)
[![PyPI version](https://badge.fury.io/py/ssaw.svg)](https://badge.fury.io/py/ssaw)

Read more about Survey Solutions at <https://mysurvey.solutions>

Details on API at <https://demo.mysurvey.solutions/apidocs/index>

## Quickstart

Install SSAW:

```shell
pip install ssaw
```

Initialize connection with the server:
```python
import ssaw

client = ssaw.Client('https://demo.mysurvey.solutions', 'api_user', 'api_password')
```

Get list of questionnaires:
```python
for q in ssaw.QuestionnaireApi(client).get_list():
    print(q.title)
```

Download latest export file in SPSS format:
```python
from ssaw import ExportApi

# without export_path parameter file will be saved in the current working directory
filename = ExportApi(client).get(export_type="SPSS", questionnaire_identity="64136490cbc24a71a1df10f4b7115599$1")

```

Create new assignment:
```python
from ssaw.models import Assignment
from ssaw import AssignmentsApi

identifying_data = [
    {"Variable": "address", "Answer": "123 Main Street"},
    {"Variable": "name", "Answer": "Jane Doe"}
]
newobj = Assignment(
    responsible="inter1", 
    questionnaire_id="", 
    quantity=5, 
    identifying_data=identifying_data)

res = AssignmentsApi(client).create(newobj)
print(res.id)
```

