README.md

• Gist API
• Docs
• Examples
• Status codes

Gist API

npm i @tsukiroku/gist

---

Docs

Initialize

Note: Account token required. See Docs

import Gist from '@tsukiroku/gist';

const gist = new Gist('token');

Create Gist

Parameter	Type
files	GistFile
description	string
options?	GistOptions

GistFile

{ 'file name': { content: 'content' }, ... },

GistOptions

{ secret: boolean, ... }

Note: secret default: true

return: Promise<ReqRet<GistResponse>>

await gist
    .create(
        {
            file_name: { content: 'File Content' },
            file_name_2: { content: 'File Content 2' },
        },
        'test file'
        // { secret: true }
    )
    .then((res) => {
        console.log(`Gist created: ${res.data!.id}`);
    })
    .catch((err) => console.log(err));

Get Gist

Parameter	Type
id	number

return: Promise<ReqRet<GistResponse>>

await gist
    .get('gist id')
    .then((res) => console.log(`gist description: ${res.data!.description}`))
    .catch((err) => console.log(err));

Delete Gist

Parameter	Type
id	number

return: Promise<ReqRet<{}>>

Note: res.data is undefined.

await gist
    .delete(gist_id)
    .then((res) => console.log(`Gist deleted, status: ${res.status.code}`))
    .catch(errHandler);

---

Example

import Gist from '@tsukiroku/gist';

const errHandler = (err: any) => console.log(err);

(async () => {
    const gist = new Gist('token');

    let gist_id: string = '';

    await gist
        .create(
            { 'hello.ts': { content: 'dd' }, 'hello.rs': { content: 'ddd' } },
            'a test file',
            { secret: true }
        )
        .then((res) => {
            gist_id = res.data!.id;
            console.log(`Gist created: ${gist_id}`);
        })
        .catch(errHandler);

    await gist
        .get(gist_id)
        .then((res) =>
            console.log(`Gist description: ${res.data!.description}`)
        )
        .catch(errHandler);

    await gist
        .delete(gist_id)
        .then((res) => console.log(`Gist deleted, status: ${res.status.code}`))
        .catch(errHandler);
})();

Status codes

ref: http_status.ts

Status code	Name
200	OK
201	CREATED
204	NO_CONTENT
304	NOT_MODIFIED
400	BAD_REQUEST
401	UNAUTHORIZED
403	FORBIDDEN
404	NOT_FOUND
409	CONFLICT
422	VAILDATION_FAILED
500	INTERNAL_SERVER_ERROR
502	BAD_GATEWAY
503	SERVICE_UNAVAILABLE
504	GATEWAY_TIMEOUT
-1	UNKNOWN

---

LICENSE: MIT

Click here for more information on the github gists rest API.