#link-shortener #url #port #permanent

yanked sampras-test

A simple URL shortener

0.1.0 Jun 29, 2023

#33 in #link-shortener

GPL-2.0 license

21KB
107 lines

Shlonk - A simple, fast, URL shortener

Shlink is another self-hosted URL shortener. Though it does too much: it has a REST API, a web GUI, and many other features you are probably never going to use.

Shlonk tries to do only one thing, redirect clients to other sites, and does it well with its Yaml configuration file. Here's an example:

urls:
  home: # /home redirects to...
    url: https://git.renn.es/shlonk
  example: # /example redirects to...
    url: https://example.com/
    permanent: true
port: 8080

To launch Shlonk, write this config to a file, say config.yml, and then run:

shlonk -c ./config.yml

That's it. That's the documentation for Shlonk. And guess what: the code is less than 200 lines long.

Installation

Cargo:

cargo install shlonk

Why the name?

It is a variation on Shlink, and here is a definition from the urban dictionary:

V. To do anything.

Shlonking is a lifestyle choice, a way to express how much better you are than any person who doesn't shlonk the same way you do. Use it as a replacement for any verb in the hopes that more individuals realize the importance of gang shlonk.

I just had to choose that name.

Dependencies

~17–48MB
~826K SLoC