Metadata-Version: 1.1
Name: shiori
Version: 0.2.6
Summary: bookmarking tool based on Web UI and JSON REST API
Home-page: https://github.com/mkouhei/shiori
Author: Kouhei Maeda
Author-email: mkouhei@palmtb.net
License: GNU General Public License version 3
Description: ============================================================
        Shiori is bookmarking tool based on Web UI and JSON REST API
        ============================================================
        
        What's "Shiori"?
        ----------------
        
        This tool provides web UI and JSON REST API for bookmarking.
        The API depends on django REST framework,
        Web UI depends on it's API and Backbone.js.
        The user registeration and login of this tool uses OpenID.
        
        "Shiori" is means a bookmark in Japanese.
        It is written "栞" in Kanji, this caracter is 0x681E in Unicode.
        
        
        .. image:: https://secure.travis-ci.org/mkouhei/shiori.png?branch=devel
           :target: http://travis-ci.org/mkouhei/shiori
        .. image:: https://coveralls.io/repos/mkouhei/shiori/badge.png?branch=devel
           :target: https://coveralls.io/r/mkouhei/shiori?branch=devel
        .. image:: https://pypip.in/v/shiori/badge.png
           :target: https://crate.io/packages/shiori
        
        
        Requirements
        ------------
        
        * Python 2.7
        * Django (>= 1.6)
        * Django REST framework (>= 2.3.12)
        * django-shortuuidfield (>= 0.1.2)
        * python-openid (>= 2.2.5)
        * django_openid_auth (>= 0.5)
        * jQuery (>= 1.7.2)
        * underscore.js (>= 1.5.2)
        * backbone.js (>= 1.1.0)
        * JSON in JavaScript
        * Twitter bootstrap (>= 2.0.2)
        
        Recommends
        ----------
        
        * MySQL
        * python-mysqldb
        
        Setup
        -----
        
        Install Debian packages that Shiori depends on
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        Shiori depends on as following.::
        
          $ sudo apt-get install python-django python-djangorestframework \
          python-django-shortuuidfield python-django-auth-openid \
          python-django-notification \
          libjs-jquery libjs-underscore libjs-json libjs-twitter-bootstrap
        
        
        Update and rebuild libjs-backbone
        """""""""""""""""""""""""""""""""
        
        The version of libjs-backbone in Sid is 0.9.2-4 at 2014-02-08. (1)
        So you must rebuild from source package currently.::
        
          $ sudo apt-get build-dep libjs-backbone
          $ apt-get source libjs-backbone
          $ cd backbone-0.9.2
          $ uscan
          $ uupdate ../1.x.x.tar.gz 1.x.x
          $ cd ../backbone-1.x.x
          $ debuild -us -uc
          $ sudo dpkg -i ../libjs-backbone_1.x.x-1_all.deb
        
        (1) http://packages.qa.debian.org/b/backbone.html
        
        
        Install Shiori
        ^^^^^^^^^^^^^^
        
        from source
        """""""""""
        ::
        
           $ git clone https://github.com/mkouhei/shiori.git
           $ cd shiori
           $ sudo python setup.py install
        
        
        from PyPI
        """""""""
        ::
        
           $ pip install shiori
        
        Workaround django-auth-openid someproblems
        """"""""""""""""""""""""""""""""""""""""""
        
        django-auth-openid is not support django 1.5 over now,
        then you should use source debian package, and must apply some patches.::
        
          $ apt-get source python-django-auth-openid
          $ cd django-openid-auth-0.5
          $ python setup.py install
        
        
        Make symlinks of JavaScript Libraries
        """""""""""""""""""""""""""""""""""""
        
        Shiori has no depended on JavaScript libraries, so make symlinks.
        Executute miscs/setup.sh script.::
        
          $ cd /path/to/lib/python2.7/site-packages/shiori-0.x.x-py2.7.egg/shiori/static
          $ sh ../miscs/setup.sh
          $ ls -n
          total 8
          lrwxrwxrwx 1 1000 1000   30 Feb  9 09:26 backbone -> /usr/share/javascript/backbone
          drwxr-xr-x 2 1000 1000 4096 Feb  9 06:49 css
          lrwxrwxrwx 1 1000 1000   34 Feb  9 09:26 twbs -> /usr/share/twitter-bootstrap/files
          lrwxrwxrwx 1 1000 1000   28 Feb  9 09:26 jquery -> /usr/share/javascript/jquery
          drwxr-xr-x 2 1000 1000 4096 Feb  9 06:49 js
          lrwxrwxrwx 1 1000 1000   26 Feb  9 09:26 json -> /usr/share/javascript/json
          lrwxrwxrwx 1 1000 1000   32 Feb  9 09:26 underscore -> /usr/share/javascript/underscore
        
        Configuration
        -------------
        
        You must change some values in shiori/core/settings.py.
        
        * SECRET_KEY
        * DEBUG
        * ALLOWED_HOSTS
        * DATABASES
        
        Execute syncdb.::
        
          $ python /path/to/shiori/manage.py syncdb
        
        Run server.::
        
          $ python /path/to/shiori/manage.py runserver
        
        
        Development
        -----------
        
        You copy pre-commit hook scripts after git clone.::
        
          $ cp -f utils/pre-commit.txt .git/hooks/pre-commit
        
        Next install python 2.7 later and setuptools, pytest, pep8.
        Below way is for Debian GNU/Linux Sid system.::
        
          $ sudo apt-get install python python-setuptools python-pytest pep8
        
        Then checkout 'devel' branch for development, commit your changes.
        Before pull request, execute git rebase.
        
        See also
        --------
        
        * `django REST framework <http://www.django-rest-framework.org/>`_
        * `django-openid-auth README <http://bazaar.launchpad.net/~django-openid-auth/django-openid-auth/trunk/view/head:/README.txt>`_
        * `Backbone.js <http://backbonejs.org/>`_
        History
        -------
        
        0.2.6 (2014-03-08)
        ^^^^^^^^^^^^^^^^^^
        
        * Added toggle switch to display all bookmarks
        * Fixed #12 Tags and categories that do not have a bookmark is displayed
        * Fixed #13 bookmarks does not appear in the tag view
        * Fixed #10 It is impossible to view the bookmarks of other users
                    in the login state in the UI
        * Fixed #7 URL of bookmark should be unique by user
        
        0.2.5 (2014-03-05)
        ^^^^^^^^^^^^^^^^^^
        
        * Added test REST API for anonymous user and another user
        * Fixed #6 any authenticated users can change bookmarks
        * Fixed #8 invalid URL of login on logout page
        
        0.2.4 (2014-03-01)
        ^^^^^^^^^^^^^^^^^^
        
        * Redirect root to /shiori/
        * Add test code of routing, bookmark view, REST API
        * Use django test in setup.py test
        * Use tox
        * Use travis-ci
        * Use coverage and coverall.io
        
        0.2.3 (2014-02-26)
        ^^^^^^^^^^^^^^^^^^
        
        * Add pagination
        * Remove patches of django-openid-auth why fixed at python-django-auth-openid 0.5-2
        
        0.2.2 (2014-02-22)
        ^^^^^^^^^^^^^^^^^^
        
        * Fix importing modules
        
        0.2.1 (2014-02-16)
        ^^^^^^^^^^^^^^^^^^
        
        * Remove django-notification from dependency
        
        0.2.0 (2014-02-16)
        ^^^^^^^^^^^^^^^^^^
        
        * Added feed generator
        * Fixed some bugs related views
        
        0.1.0 (2014-02-08)
        ^^^^^^^^^^^^^^^^^^
        
        * First release
        
        TODO
        ----
        
        * Add appending signature to bookmark and validation signature with GnuPG.
        * Add linking social web services with OAuth.
        * Add Feed parser and adding new item to bookmark automatically.
        * Add job scedular for feed parser and push message to social web services.
        * Add applying reST style description.
        * Add unit test code.
        
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
