1 unstable release

Uses old Rust 2015

0.1.0 Jul 26, 2017

#686 in Text processing

Download history 2833/week @ 2024-05-17 3466/week @ 2024-05-24 3104/week @ 2024-05-31 2760/week @ 2024-06-07 3101/week @ 2024-06-14 2357/week @ 2024-06-21 2462/week @ 2024-06-28 2508/week @ 2024-07-05 2670/week @ 2024-07-12 2390/week @ 2024-07-19 2503/week @ 2024-07-26 2765/week @ 2024-08-02 2820/week @ 2024-08-09 2831/week @ 2024-08-16 2657/week @ 2024-08-23 2990/week @ 2024-08-30

11,653 downloads per month
Used in 44 crates (20 directly)

MIT license

14KB
209 lines

Slugify

Build Status Build status Crates.io docs.rs License: MIT

A utility macro for flexible slug genereation that handles unicode.

The slugify! macro implements a flexible slug generator, allowing for stop words, custom separator and maximum length options. The macro provides both a simple call format that has sane default parameters but also allows there default parameters to be overriden when needed.

Features:

  • Unicode strings support (phonetic conversion).
  • Support for custom slug separator.
  • Stop words filtering.
  • Slug maximum length support.

Usage

This crate is on crates.io and can be used by adding slugify to the dependencies in your project's Cargo.toml

[dependencies]
slugify = "0.1.0"

and this to your crate root:

#[macro_use] extern  crate  slugify;
use slugify::slugify;

Examples

Basic slug generation

assert_eq!(slugify!("hello world"), "hello-world");

Using a custom separator

assert_eq!(slugify!("hello world", separator = "."), "hello.world");
assert_eq!(slugify!("hello world", separator = " "), "hello world");

Stop words filtering

assert_eq!(slugify!("the quick brown fox jumps over the lazy dog", stop_words = "the,fox"), "quick-brown-jumps-over-lazy-dog");

Maximum slug length

assert_eq!(slugify!("the hello world", stop_words = "the", max_length = 5), "hello");

Phonetic Conversion and accented text

assert_eq!(slugify!("影師嗎"), "ying-shi-ma");
assert_eq!(slugify!("Æúű--cool?"), "aeuu-cool");
assert_eq!(slugify!("Nín hǎo. Wǒ shì zhōng guó rén"), "nin-hao-wo-shi-zhong-guo-ren");

Passing multiple optional parameters.

NOTE: the order of optional parameters matters: stop_words, separator and then max_length. All of them are optional, however when specifying more than one optional parameter, this order must be adhered.

assert_eq!(slugify!("the hello world", stop_words = "the", separator = "-"), "hello-world");
assert_eq!(slugify!("the hello world", separator = ".", max_length = 10), "the.hello");
assert_eq!(slugify!("the hello world", stop_words = "the", max_length = 5), "hello");
assert_eq!(slugify!("the hello world", stop_words = "the", separator = "-", max_length = 20), "hello-world");

Dependencies

~2MB
~66K SLoC