npm.io
1.1.4 • Published 1 month ago

paste.gg

Licence
MIT
Version
1.1.4
Deps
0
Size
60 kB
Vulns
0
Weekly
0
Stars
6

paste.gg

NPM version NPM downloads Build status GitHub code size

A library for interacting with the Paste.GG API. I have created this in a short amount of time and will expect more updates in the future. The main purpose of this is to help users from having to create API calls.

Installation

# Stable release
npm install paste.gg

# Next release (changes on GitHub that haven't been released yet)
npm install paste.gg@next

Getting Started

Create a new instance of the wrapper
// CommonJS (CJS)
const PasteGG = require("paste.gg");
// ES Modules (ESM)
import PasteGG from "paste.gg";

// If you want to be anonymous
const pasteGG = new PasteGG();

// If you want to use an api key
const pasteGG = new PasteGG("apiKeyHere");
Get information about a post
// if you would like to exclude file contents
await pasteGG.get("idHere");

// If you would like to include file contents
await pasteGG.get("idHere", true);
Post a new paste (Click here for more options)
await pasteGG.post({
    name: "Paste name", // Optional
    description: "Paste description", // Optional
    expires: "2020-12-21T02:25:56.428Z", // Optional (must be a UTC ISO 8601 string)
    files: [
        {
            name: "file.txt", // Optional
            content: {
                format: "text",
                value: "This is where the file content will go",
            },
        },
    ],
});
Delete a paste (auth/deletion key needed)
// Delete with deletion key
await pasteGG.delete("idHere", "deletionKeyHere");

// Delete with auth key if not set in constructor
await pasteGG.delete("idHere", "authKeyHere");

// Leave blank if auth key is in the class constructor
await pasteGG.delete("idHere");
Update the post
await pasteGG.update("idHere", {
    name: "new name", // Optional (if you want to remove the name)
    description: "new description",
});

Contributors

Contributions are more than welcome. If you would like to add to the API wrapper, free free to open a pull request. I've only added the endpoints that I thought would be most common.

Thank you to all the people who already contributed.

Keywords