Add CLI utilities to Kinto.py

[Natim]

The final aims is to let people easily create sync between a collection and a local data store (usually built from files)

[almet]

this option needs to be more explicit.

[almet]

record_fields then?

[Natim]

r? @leplatrem

[almet]

I like the idea of having an example, but I feel that this will get out of date as soon as we start updating the importer. We probably should move this into a test case, and point the users there in the documentation.

[leplatrem]

nit: importation is rarely used in the context of importing data

[almet]

The docstring should contain some more information about the arguments it expects, and what it does with the extra args/kwargfs.

[leplatrem]

nit: as BatchSession ?

[leplatrem]

I didn't review the tests thoroughly.

My general feeling would be a friendly warning: do not forget the simplest use-cases like this one https://gist.github.com/leplatrem/a2d95b660820686eea35

[Natim]

I think something like that should work:

#!/usr/bin/env python
# -*- coding: utf-8 -*-
import json
from kinto_client.importer import KintoImporter


class GuessSignImporter(KintoImporter):
    include_all_default_parameters = True

    default_remote_server = "https://kinto-leplatrem.herokuapp.com/v1"
    default_auth = 'admin:password'
    default_files = ["guessign/data/it.json"]

    collection_permissions = {'read': ["system.Everyone"]}
    record_fields = ('class', 'word', 'class:id', 'magnet',
                     'category', 'video', 'lang')

    delete = False

    def get_local_records(self):
        results = []
        with open(file) as f:
            results += json.load(f)
        return results


def main(args=None):
    importer = GuessSignImporter()
    importer.sync()


if __name__ == '__main__':  # pragma: nocover
    main()

[Natim]

create_missing_locally
update_missing_locally
delete_missing_locally

[almet]

I suppose we can close this then, since #59 is being worked out.