1
0
Fork 0
mirror of https://github.com/SunRed/haste-server.git synced 2024-12-29 07:20:11 +01:00
open source pastebin written in node.js
Find a file
John Crepezzi b251978422 Merge pull request #15 from zaeleus/html_escape
Escape document when using the txt extension
2012-01-09 20:43:39 -08:00
lib Added support for phonetic key naming 2012-01-07 11:35:11 -05:00
spec Clean up redis test to exit properly 2011-11-28 20:56:41 -05:00
static Escape document when using the txt extension 2012-01-08 23:47:07 -06:00
.gitignore Update TODO 2011-11-22 16:51:35 -05:00
about.md Including dependencies for osx and linux for installation, these are a couple things I ran into while getting set up. 2011-12-15 08:45:28 -07:00
config.js Added support for phonetic key naming 2012-01-07 11:35:11 -05:00
package.json Auto-compress javascript assets 2011-11-27 15:49:17 -05:00
README.md Added support for phonetic key naming 2012-01-07 11:35:11 -05:00
server.js Added support for phonetic key naming 2012-01-07 11:35:11 -05:00
TODO.md Automatically add file extensions 2011-11-29 10:39:12 -05:00

Haste

Haste is an open-source pastebin software written in node.js, which is easily installable in any network. It can be backed by either redis or filesystem, and has a very easy adapter interface for other stores. A publicly available version can be found at hastebin.com

Major design objectives:

  • Be really pretty
  • Be really simple
  • Be easy to set up and use

Haste works really well with a little utility called haste-client, allowing you to do things like:

cat something | haste

which will output a URL to share containing the contents of cat something's STDOUT

Tested Browsers

  • Firefox 8
  • Chrome 17
  • Safari 5.3

Installation

  1. Download the package, and expand it
  2. Explore the settings inside of config.js, but the defaults should be good
  3. npm install
  4. npm start

Settings

  • host - the host the server runs on (default localhost)
  • port - the port the server runs on (default 7777)
  • keyLength - the length of the keys to user (default 10)
  • maxLength - maximum length of a paste (default none)
  • staticMaxAge - max age for static assets (86400)
  • recompressStatisAssets - whether or not to compile static js assets (true)
  • documents - static documents to serve (ex: http://hastebin.com/about.com) in addition to static assets. These will never expire.
  • storage - storage options (see below)
  • logging - logging preferences
  • keyGenerator - key generator options (see below)

Key Generation

Phonetic

Attempts to generate phonetic keys, similar to pwgen

{
	"type": "phonetic"
}

Random

Generates a random key

{
	"type": "random",
  "keyspace": "abcdef"
}

The optional keySpace argument is a string of acceptable characters for the key.

Storage

File

To use file storage (the default) change the storage section in config.js to something like:

{
	"path": "./data",
	"type": "file"
}

Where path represents where you want the files stored

Redis

To use redis storage you must install the redis package in npm globall using

npm install redis --global

Once you've done that, your config section should look like:

{
	"type": "redis",
	"host": "localhost",
	"port": 6379,
	"db": 2
}

You can also set an expire option to the number of seconds to expire keys in. This is off by default, but will constantly kick back expirations on each view or post.

All of which are optional except type with very logical default values.

Author

John Crepezzi john.crepezzi@gmail.com

License

(The MIT License)

Copyright © 2011 John Crepezzi

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the Software), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE

Other components:

  • jQuery: MIT/GPL license
  • highlight.js: Copyright © 2006, Ivan Sagalaev