<commit_before>Basic Commands
==============

Check the Bamboo version
------------------------

``curl http://bamboo.io/version``

Storing data in Bamboo
----------------------

upload data from a URL to Bamboo:
^^^^^^^^^^^^^^^^^^^^^^

``curl -X POST -d "url=http://formhub.org/mberg/forms/good_eats/data.csv" http://bamboo.io/datasets``

upload data from a file to Bamboo:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

given the file ``/home/modilabs/good_eats.csv`` exists locally on your
filesystem

``curl -X POST -F csv_file=@/home/modilabs/good_eats.csv http://bamboo.io/datasets``


Retrieve data
-------------

given the id is ``8a3d74711475d8a51c84484fe73f24bd151242ea``

by ID get information about a dataset:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

``curl http://bamboo.io/datasets/8a3d74711475d8a51c84484fe73f24bd151242ea?info=t``

returns::

    {
        "id": "8a3d74711475d8a51c84484fe73f24bd151242ea",
        "schema": {
            "rating": {
                "olap_type": "numeric",
                "simpletype": "integer"
            },
            "food_type": {
                "olap_type": "dimension",
                "simpletype": "string"
            },
            ...
        }
        "created_at": "2012-6-18 14:43:32",
        "updated_at": "2012-6-18 14:43:32"
    }


by ID:
^^^^^^^^^^^^^^^^^^^^^^

``curl http://bamboo.io/datasets/8a3d74711475d8a51c84484fe73f24bd151242ea``
<commit_msg>update docs to reflect dataset schema url change<commit_after>Basic Commands
==============

Check the Bamboo version
------------------------

``curl http://bamboo.io/version``

Storing data in Bamboo
----------------------

upload data from a URL to Bamboo:
^^^^^^^^^^^^^^^^^^^^^^

``curl -X POST -d "url=http://formhub.org/mberg/forms/good_eats/data.csv" http://bamboo.io/datasets``

upload data from a file to Bamboo:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

given the file ``/home/modilabs/good_eats.csv`` exists locally on your
filesystem

``curl -X POST -F csv_file=@/home/modilabs/good_eats.csv http://bamboo.io/datasets``


Retrieve data
-------------

given the id is ``8a3d74711475d8a51c84484fe73f24bd151242ea``

by ID get information about a dataset:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

``curl http://bamboo.io/datasets/8a3d74711475d8a51c84484fe73f24bd151242ea/info``

returns::

    {
        "id": "8a3d74711475d8a51c84484fe73f24bd151242ea",
        "schema": {
            "rating": {
                "olap_type": "numeric",
                "simpletype": "integer"
            },
            "food_type": {
                "olap_type": "dimension",
                "simpletype": "string"
            },
            ...
        }
        "created_at": "2012-6-18 14:43:32",
        "updated_at": "2012-6-18 14:43:32"
    }


by ID:
^^^^^^^^^^^^^^^^^^^^^^

``curl http://bamboo.io/datasets/8a3d74711475d8a51c84484fe73f24bd151242ea``

{'fraction_non_alphanumeric': 0.2420091324200913, 'fraction_numerical': 0.09694415173867228, 'mean_word_length': 2.5030750307503076, 'pattern_counts': {'":': 20, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1037144', 'n_tokens_mistral': 1191, 'n_tokens_neox': 1005, 'n_words': 181}