Metadata-Version: 2.4
Name: lain-shorten
Version: 1.17
Summary: A simple CLI URL shortener using s.lain.la API, with optional clipboard copy.
Keywords: python,link-shorten,link-shortener,shortener,lain-shorten,lain,kuroneko
Author: NecRaul
Author-email: NecRaul <necraul@kuroneko.dev>
License-Expression: LGPL-2.1-only
License-File: LICENSE
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Dist: requests>=2.32.5
Requires-Dist: pyperclip>=1.11.0 ; extra == 'clipboard'
Requires-Python: >=3.10
Project-URL: Homepage, https://github.com/NecRaul/lain-shorten
Project-URL: Documentation, https://github.com/NecRaul/lain-shorten#readme
Project-URL: Repository, https://github.com/NecRaul/lain-shorten
Project-URL: Issues, https://github.com/NecRaul/lain-shorten/issues
Provides-Extra: clipboard
Description-Content-Type: text/markdown

# lain.la-link-shortener

A simple CLI URL shortener using `s.lain.la` API, with optional clipboard copy.

## Installation

### Via PyPI (Recommended)

You have the option to choose between the standard version (lain-shorten) or the desktop version (lain-shorten[clipboard]), which adds clipboard support for auto-copying links.

> [!NOTE]
> For brevity, the examples below use the desktop version.

#### With pip (Basic)

```sh
pip install "lain-shorten[clipboard]"
```

#### With pipx (Isolated)

```sh
pipx install "lain-shorten[clipboard]"
```

#### With uv (Best)

The most efficient way to install or run the shortener.

```sh
# Permanent isolated installation
uv tool install "lain-shorten[clipboard]"

# Run once without installing
uvx --with "lain-shorten[clipboard]" lain-shorten <url1> <url2> <url3>

# Run in scripts or ad-hoc environments
uv run --with "lain-shorten[clipboard]" lain-shorten <url1> <url2> <url3>
```

### From Source (Development)

```sh
# Clone the repository and navigate to it
git clone git@github.com:NecRaul/lain-shorten.git
cd lain-shorten

# Install environment and all development dependencies (mandatory and optional)
uv sync --dev

# Install pre-commit hook
uv run pre-commit install

# Optional: Run all linters and type checkers manually
uv run pre-commit run --all-files

# Run the local version
uv run lain-shorten <url1> <url2> <url3>

# Run tests
uv run pytest tests
```

## Usage

Simply provide a URL, and the tool will automatically handle protocol validation and formatting.

Use `--open` to open each generated short URL in your default browser right after shortening. This makes it easy to verify each format resolves as expected in a real browser session.

```sh
# Shorten a URL
lain-shorten https://kuroneko.dev

# Protocol-less (automatically prepends http://)
lain-shorten kuroneko.dev

# irc
lain-shorten irc://irc.libera.chat/#archlinux

# ssh
lain-shorten ssh://necraul@kuroneko.dev

# mailto
lain-shorten mailto:necraul@kuroneko.dev

# sms
lain-shorten sms:+15551234567

# magnet torrent
lain-shorten "magnet:?xt=urn:btih:0123456789abcdef0123456789abcdef01234567&dn=Example"

# Open shortened URLs using the default browser
lain-shorten --open \
http://kuroneko.dev \
ircs://irc.libera.chat:6697/#archlinux \
xmpp:necraul@kuroneko.dev \
tel:+15551234567

# Display help and version
lain-upload -h
lain-upload -v
```

## Supported Schemes

- `http://` and `https://` links
- protocol-less domains (automatically normalized to `http://`)
- `irc://` and `ircs://` links
- `ssh://` links
- `mailto://` and `xmpp://` links
- `sms://` and `tel://` links
- `magnet:` torrent links

## Dependencies

- [requests](https://github.com/psf/requests): send the API request for shortening.

### Optional

- [pyperclip](https://github.com/asweigart/pyperclip): copy the shortened URLs to the clipboard.

## How it works

The `s.lain.la` service allows shortening URLs via a `POST` request.

This tool automates the process to avoid typing long `curl` strings.

### The Manual Way

```sh
curl -d "url=https://kuroneko.dev" https://s.lain.la
```

### The lain-shorten way

- Batch Processing: Shorten multiple URLs in a single command execution, saving time over individual manual requests.
- Validation: Uses `urllib` to ensure the URL is formatted correctly.
- API Request: Sends the `POST` request via `requests`.
- Normalization: Automatically adds `http://` if missing.
- Clipboard (Optional): If `pyperclip` is installed, the result is instantly copied to your clipboard.

## Special thanks

- To **7666** of <https://lain.la/> for running the [shortener](https://s.lain.la/) service that inspired this project.
