The dev toolbelt is a fast and flexible cli tool to handle common use cases of your daily work. Use cases you generally use some online tools.

• Example
• Installation
  • Install via go
  • Install via Homebrew
  • Install via Docker
  • Shell Completions
• Commands
  • URI
  • Base64
  • Hash
  • UUID
  • JWT
  • Random
  • Date
  • HTML
  • Server
  • Completion
• Configuration
• Contributing
• License

If you've go installed and your $GOPATH is set, you can easily install dt with:

go get github.com/chclaus/dt

brew tap chclaus/dt [email protected]:chclaus/dt.git
brew install dt

docker pull chclaus/dt:latest
docker run --rm chclaus/dt:latest version

If you installed the tool via homebrew and use either bash or zsh as shell, you don't need to worry about anything else.

If you used the native installation, you can easily create an autocompletion:

Write bash completion code to a file and source if from .bash_profile:

dt completion --shell bash > ~/.dt_completion.sh
printf "\n# dt bash completion\nsource '$HOME/.dt_completion.sh'" >> $HOME/.bash_profile
source $HOME/.bash_profile

Set the dt completion code for zsh to autoload on startup:

dt completion --shell zsh > "${fpath[1]}/_dt"

To build the project you can clone the repository with...

git clone [email protected]:chclaus/dt

... and build and install the binary with

cd dt && go install

To build the repository with docker, do the following:

git clone [email protected]:chclaus/dt
cd dt
docker build -t dt .
docker run --rm dt version

• Encodes an URI to a safe representation
• Decodes an already encoded URI

• Encodes a string to it's base64 representation
• Decodes a base64 string to it's plain representation

The base64 command can be used with different encodings:

• Standard, follows RFC 4648
• Standard Raw, follows RFC 4648 but with without padding
• URL, follows the alternative RFC 4648
• URL Raw, follows the alternative RFC 4648 but with without padding

Returns the hash representation of an input in different hash formats:

• md5
• sha1
• sha256
• sha3_256
• sha3_512
• sha512
• bcrypt

Returns a new random UUID. You can specify the generated UUID version:

• Version 1, based on timestamp and MAC address (RFC 4122)
• Version 2, based on timestamp, MAC address and POSIX UID/GID (DCE 1.1)
• Version 3, based on MD5 hashing of (namespace(UUID), value) (RFC 4122)
• Version 4, based on random numbers (RFC 4122)
• Version 5, based on SHA1 hashing of (namespace(UUID), value) (RFC 4122)

Decodes a jwt and pretty prints the resulting json. You can also pass a secret (base64 or plain) within a file or as program argument to verify the jwt signature.

Generates random strings and numbers. Currently supported functions are:

• Generates a random string, based on an alphabet with a specific length.
• Generates a random string with alphanumeric letters.
• Generates a random string with a alphanumeric and special characters.
• Generates random numbers with a specific length.

Date conversions:

• time millis to RFC 3339
• time nanos to RFC 3339
• RFC 3339 to time millis

Escapes and unescapes HTML

• transforms a string to an escaped html sequence
• reads a file and prints an escaped html sequence
• unescapes an escaped html sequence to it's raw representation

Starts a simple web server to serve static content. You can specify hostname and port and must set a folder to serve.

You can also pass an option -o to open your default system browser that points automatically to the served url.

You can configure a some default behaviors of dt to fit your needs. Just place a file .dt.yaml into your home directory, you can configure the following options:

server:
  port: 3001
  address: 127.0.0.1
  openBrowser: true
uuid:
  namespace: cacae610-c76a-4736-90ef-0271126b4346
  version: 4
base64:
  encoding: std
random:
  algorithm: complex
  length: 20
hash:
  algorithm: bcrypt
  cost: 12
jwt:
  secret: foobar
  secretFile: /path/to/your/secret/file
  base64Secret: false

For more informations, please take a look in the examples directory.

Everyone is welcome to create pull requests for this project. If you're new to github, take a look here to get an idea of it.

If you've got an idea of a function that should find it's way into this project, but you won't implement it by yourself, please create a new issue.

Please ensure, that all contributions match the MIT license.

dt (dev-toolbelt) is released under the MIT license. See LICENSE.txt