Module to build your own Pasty client.
More information at http://www.pastyapp.org/
Installing npm (node package manager)
curl http://npmjs.org/install.sh | sh
npm install pastyclient-node
Installing pastyclient-node globally
[sudo] npm install -g pastyclient-node
How to use
pastyclient-node is a small library that will handle the REST calls to the Pasty REST API server for you. Currently it does not offer any option to store user credentials within the client library, so you need to store these within your application and provide them upon each REST call.
While pastyclient-node will take care of the REST calls, you should still be familiar with Pasty's REST API.
You always need to create your pastyclient by requiring the module and calling the pastyclient factory
var client =;
The factory takes three arguments. The first argument is the REST servers
hostname, the second is the REST servers TCP
The third argument is an
options object, that currently takes any of the following values:
- "ssl": A boolean indicating whether or not the server will talk SSL/TLS.
- "apiKey": If you have an API key for the REST server (in order to create users) you can specify it here as a string.
After receiving your configured client from the factory, you can start using it. Keep your Pasty login data at hand.
Getting the user clipboard
var client =;var username = '<username>';var password = '<password>';// call the REST server for the users clipboardclient;
Adding an item to the user clipboard
var client =;var username = '<username>';var password = '<password>';var item = "what a pretty string this is";// call the REST server to add the itemclient;
Deleting an item from the user clipboard
var client =;var username = '<username>';var password = '<password>';var itemId = "4fc660923120c0790e000002";// call the REST server to delete the item with id <itemId>client;
Requesting a user token
Since the Pasty REST API does currently not support OAuth, there is a miserable work around to keep from sending the users credentials over the Internet all the time, and that is user tokens.
You can request a user token using the
requestToken() function, and then use this
token instead of username / password in future clipboard calls. To do that, you
simply replace the username and the password parameter with a single string parameter
containing the token.
Here is an example:
var client =;var username = '<username>';var password = '<password>';var item = "what a pretty string this is";// call the REST server to request a user tokenclient;
There is more that you can do with the library and Pasty. Please have a look into the source code, for the following function calls:
They are pretty straight forward and fairly documented.
Please direct your questions and suggestions to firstname.lastname@example.org
Copyright 2012-2013 Philipp Geschke Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.