Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

github.com/thetannerryan/gist

Package Overview
Dependencies
Alerts
File Explorer
Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

github.com/thetannerryan/gist

  • v1.0.2
  • Source
  • Go
  • Socket score

Version published
Created
Source

Gist - simplified code sharing

Build
Status Go Report
Card GoDoc GitHub
license

Gist is an unofficial toolkit for file uploads to GitHub gist. The purpose of gist is to provide a simple command-line tool for sharing content on GitHub's gist platform.

Table of Contents

Installation

macOS (via Homebrew)

brew update
brew install TheTannerRyan/bin/gist

Manual

Download the latest release for your platform (Darwin/macOS, Linux, Windows). Unpack the tar, and copy the binary to a directory that is in the PATH. Here is an example on macOS (Darwin):

wget https://github.com/TheTannerRyan/gist/releases/download/v1.0.2/gist-darwin_amd64.tar.gz
tar -xzf gist-darwin_amd64.tar.gz
mv gist /usr/local/bin

The /usr/local/bin directory will work with most variants of UNIX. For Windows, you will have to add the parent directory to the system path.

Configuration

To use gist, you need to create a Github personal access token. To create a token, go to the token settings. Click the "generate new token" button and enter any description. For the scope, just select "gist". Then click generate token.

Once you have a token, you should set the GIST_KEY environment variable to the token value. If you do not want to use an environment variable, you will have to copy and paste the token each time you would like to upload content.

Usage

Global usage

$ gist --help
NAME:
gist - unofficial toolkit for file uploads to GitHub gist

USAGE:
gist [global options] command [command options] [arguments...]

VERSION:
1.0.2

AUTHOR:
Tanner Ryan (https://github.com/TheTannerRyan/gist)

COMMANDS:
    public, p   upload one or more public files
    secret, s   upload one or more secret files (shh! it's a secret)
    license, l  show licensing information
    help, h     Shows a list of commands or help for one command

GLOBAL OPTIONS:
--help, -h     show help
--version, -v  print the version

Upload usage (same for secret)

$ gist p --help
NAME:
gist public - upload one or more public files

USAGE:
gist public [command options] [arguments...]

OPTIONS:
--token value, -t value        required GitHub Gist access token [$GIST_KEY]
--clipboard, -c                read from clipboard
--name value, -n value         comma separated file name override for Gist
--description value, -d value  gist description

Aliases

All of the commands have short and long versions:

p / public
s / secret
h / help

The flags also have aliases:

-t / --token
-c / --clipboard
-n / --name
-d / --description

Examples

The interface behaves the way it looks:

# single file (secret)
gist s hello.txt

# multiple files (public)
gist p hello1.txt hello2.txt

# all text files
gist p *.txt

# rename single
gist p old.txt -n=new.txt

# rename multiple
gist p bad1.txt bad2.txt good3.txt -n=good1.txt,good2.txt

# upload with gist description
gist p story.log -d="this is my daily log"

# upload without GIST_KEY environment variable
gist p file.txt -t="abc123..."

# upload from stdin
cat network.log | gist p
gist p < network.log

# upload from clipboard
gist p -c

Note: If single or multiple files are being provided, and there are no file name overrides, the original file names will be used. For stdin and the clipboard, if no name is provided, the file will be uploaded as gistfile1.txt.

License

Copyright (c) 2019 Tanner Ryan. All rights reserved. Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.

Ato Araki's Go clipboard library is under a BSD 3-clause license. Jeremy Saenz's Go command line library is under a MIT license. Once again, all rights reserved.

FAQs

Package last updated on 06 Jan 2019

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc