ryuslash/hypo
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
Quickly share stuff
4 commits 3 branches 0 tags 75 KiB
HTML 52.7%
Hy 47.3%
Find a file
Tom Willemse c5699ecfa7 Add *prefix* option 
`*prefix*' specifies which directory the application should run
under. This is useful when not running it on a domain or
sub-domain. This should contain a trailing `/' if used.
2013-08-07 23:23:30 +02:00
site Initial commit 2013-08-01 01:24:32 +02:00
templates Initial commit 2013-08-01 01:24:32 +02:00
.gitignore Initial commit 2013-08-01 01:24:32 +02:00
config.example.hy Add *prefix* option 2013-08-07 23:23:30 +02:00
COPYING Initial commit 2013-08-01 01:24:32 +02:00
hypo.hy Add *prefix* option 2013-08-07 23:23:30 +02:00
init.sql Initial commit 2013-08-01 01:24:32 +02:00
README.org Oops, how did that get in there 2013-08-01 01:29:00 +02:00

README.org

Quickly share bits of code, screenshots or whatnot with some friends. Easily delete them too.

Setup

Hypo is written in hy. Which is a Lisp and Python thrown together. This doesn't matter much, it should function as a regular python module.

Requirements

Hypo has the following requirements:

hy
The language.
web.py
The Python web framework.
Postgresql
The database.
psycopg2
The database connector.

Besides these it also requires everything needed to run web.py applications using your favorite webserver.

Usage

Once setup it will not show much of anything, first you'll have to upload something.

Uploading

Uploading is done with the PUT HTTP method. An example with curl:

# curl --upload-file README.org http://yourserver.example.com/ 2>/dev/null
http://yourserver.example.com/abcdef1

After uploading a file to the server it will respond with the url of your newly uploaded file. If you browse to this URL using your favorite browser you will find a page showing the file. For text files it will try to provide some syntax highlighting, for certain types of images (currently jpg, png and gif) it will show the image.

If Hypo doens't know what kind of file you're uploading it will default to treating it as a text file.

Deleting

After you have uploaded a file you can delete it again by using the DELETE HTTP method. An example with curl:

# curl -XDELETE http://yourserver.example.com/abcdef1
None

There is currently no way to authenticate yourself with the server, so anyone can delete (also post) files. Of course they would first have to know the URL to send the delete to.

License

Hypo is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Hypo is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with Hypo. If not, see http://www.gnu.org/licenses/.

See COPYING for more information.