Metadata-Version: 2.4
Name: philiprehberger-slug
Version: 0.1.1
Summary: URL slug generation with transliteration and uniqueness
Project-URL: Homepage, https://github.com/philiprehberger/py-slug#readme
Project-URL: Repository, https://github.com/philiprehberger/py-slug
Project-URL: Issues, https://github.com/philiprehberger/py-slug/issues
Project-URL: Changelog, https://github.com/philiprehberger/py-slug/blob/main/CHANGELOG.md
Author: Philip Rehberger
License-Expression: MIT
License-File: LICENSE
Keywords: seo,slug,text,transliteration,url
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# philiprehberger-slug

URL slug generation with transliteration and uniqueness.

## Installation

```bash
pip install philiprehberger-slug
```

## Usage

### Basic Slugification

```python
from philiprehberger_slug import slugify

slugify("Hello World!")        # "hello-world"
slugify("Ünïcödé Têxt")       # "unicode-text"
slugify("Straße nach München") # "strasse-nach-munchen"
```

### Options

```python
slugify("Hello World", separator="_")    # "hello_world"
slugify("Hello World", max_length=8)     # "hello"
slugify("Hello World", lowercase=False)  # "Hello-World"
```

### Unique Slugs

```python
from philiprehberger_slug import unique_slugify

existing = {"hello-world", "hello-world-2"}
unique_slugify("Hello World", existing)  # "hello-world-3"
```

### Strip HTML

```python
from philiprehberger_slug import strip_html

strip_html("<p>Hello <b>World</b></p>")  # "Hello World"
```

## API

- `slugify(text, separator="-", max_length=0, lowercase=True)` — Generate a URL-safe slug
- `unique_slugify(text, existing, separator="-", max_length=0)` — Generate a unique slug with numeric suffix
- `strip_html(text)` — Remove HTML tags from text

## License

MIT
