swtstore (Sweet Store)

======================

----

Introduction

------------

This is the sweet store application.

The store for the decentralized, semantic, social web tweets a.k.a SWeeTs!

This README is about installing, configuring and running/deploying this

application. If you want to know more about SWeeTs, please go to

[wiki.janastu.org/Sweet_Web](http://janastu.org/technoscience/index.php/Sweet_Web) and

[trac.pantoto.org/sweet-web](http://trac.pantoto.org/sweet-web).

This application acts as the repository store for all the SWeeTs that are

generated from the clients registered with the sweet store. It provides

query APIs to query the SWeeTs.

It also provides user management to manage the users of the swtstore.

All the APIs of the swtstore are accessed by using an access token which is

generated by the swtstore when an user authorizes a third-party application

through OAuth.

Sweet store provides the following APIs:

    - [GET] /api/sweets/<id>: Get a specific SWeeT by its id.

    - [GET] /api/sweets/q?who=<username>&what=<contextname>&where=<URL> :

      This API is for querying sweet based on the who, what and where

      parameters.

      This API do not support querying based on parameters mentioned in how,

      but will be supported in future. Right now, the client can get sweets

      based on the above mentioned three parameters, and as the 'how' part is

      a JSON, it is trivial to do further filtering based on parameters of

      'how' by the client.

    - [POST] /api/sweets : Post a SWeeT to this swtstore with the data in the

    body of the request. The data or payload is a list of sweets. Even if you

    are sending one sweet, make sure that the sweet is in a list.

    - [GET] /api/users/me : Get a JSON details of the current user logged in.

Any third-party client side application can communicate with the swtstore

using these APIs, provided they have a valid access token.

Installing

----------

The swtstore application is written in Python and uses a relational database.

Hence, the dependencies of this application is Python and any relational database

supported by SQLAlchemy.

Most common RDBMS supported by SQLAlchemy are MySQL, Postgresql.

For more information on supported databases see

[here](http://docs.sqlalchemy.org/en/rel_0_9/dialects/index.html).

___ Once you are sure you have Python and a relational database (like

MySQL/Postgresql etc.) installed. You can go ahead and follow these steps:___

* Clone the repository from [https://git.pantoto.org/sweet-web/sweet-web-engine](https://git.pantoto.org/sweet-web/sweet-web-engine)

  OR you can download the

  code from the same link.

* It is strongly recommended to do the installation inside a virtual environment. 

  If you think, you know what you are doing and don't need the virtual

  environment, you can skip to the next step.  

  Initialize a python virtual environment using `virtualenv` in the same directory

  where you cloned the repository in the above step. Now, activate the

  environment

  > ``$ source <path/to/your/current-virtual-env>/bin/activate ``

  See [http://www.virtualenv.org/en/latest/virtualenv.html](http://www.virtualenv.org/en/latest/virtualenv.html) for more details about `virtualenv`.

* Run the setup.py script to install  `` python setup.py install ``

You're done installing swtstore. Now you need to configure it to run.

Configure swtstore

------------------

* Copy the contents of ``sample_config.py`` inside the ``swtstore`` directory

  into ``config.py`` inside ``swtstore`` directory itself.

  Assuming you are using a *-nix based system, and you are in the root directory

  of the codebase,

  `` $ cp swtstore/sample_config.py swtstore/config.py``

* Edit the config.py file, and change the values accordingly.

* Now, you have to setup the database for the swtstore application. But

  fortunately, the creation of database and tables have also been scripted, so

  all you need to do is run the ``dbsetup.py`` script.

  `` $ python dbsetup.py ``

**NOTE:** Please remember that all these configuration step is necessary and is

required wether you are running the application locally or deploying it on a

server.

Running the server locally

--------------------------

Run the runserver.py script to run the server locally,

> `` $ python runserver.py ``

This runs the application locally, on port 5001. So you can direct your browser

to http://localhost:5001

Deploying the application

-------------------------

SwtStore is deployed as a WSGI application server.

The wsgi script to deploy the application is provided (its called

`swtstore.wsgi`).

Point your webserver like Apache, or Nginx to point to the `swtstore.wsgi`

script.

See Apache WSGI configuration here:

[http://modwsgi.readthedocs.org/en/latest/configuration-directives/WSGIScriptAlias.html](http://modwsgi.readthedocs.org/en/latest/configuration-directives/WSGIScriptAlias.html)

TODO: [insert Nginx WSGI config link]

Help / Feedback

---------------

If you need any help, or have any questions, comments or feedback, you can contact at

rayanon or arvind or bhanu at servelots.com

You can also join channel #servelots on freenode network, using your favourite

IRC client. We usually hang out at #servelots.

License

-------

BSD Licensed.

See LICENSE for more details.