Personal Information Storage and Syndication
Increasingly, our digital selves are spread out across a myriad of social networks and there is no central repository of the things that interest you. PISS aims to change that. This project borrows many ideas from IndieWebCamp and Tent, but tries not to hold them as dogma.
A public repository of this app can be found here: https://github.com/jenmontes/piss. The issue tracker is the preferred channel for bug reports, feature requests, and submitting pull requests.
Yes, really. I feel like using a non-PC name keeps me honest: this project is designed for my personal needs and shouldn't cater to anyone else.
- RESTful server that can display data in JSON, XML, and HTML format
- Hawk authentication in order to create/modify/delete posts and to retrieve private posts
- Definition of basic post types
- Reference CLI app
Check the issue tracker to get a sense for what I'm currently working on.
I really don't recommend trying to install this, but if you insist: all you need to start is a MongoDB database. You can get one up and running quickly via homebrew
.
Once your database is up and running:
- Clone the PISS repository and
cd
into it - Create a virtual environment with
virtualenv
and activate it - Install the requirements found in
requirements.txt
viapip
- Start a local PISS server with
python run.py
Your server should now be available at http://127.0.0.1:5000. Running a production instance is out of the scope of this doc, but check out the Flask documentation for more information.
This app owes its existence to the following projects:
- Flask by Armin Ronacher. A micro web development framework for Python.
- Eve by Nicola Iarocci. A REST API framework powered by Flask and MongoDB.
- Jen Montes (Twitter / GitHub)
To the extent possible under law, the author has waived all copyright and related or neighboring rights and dedicates this software to the public domain under CC0.