Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/benlinton/slugify

Bash command that converts filenames and directories to a web friendly format.
https://github.com/benlinton/slugify

Last synced: 15 days ago
JSON representation

Bash command that converts filenames and directories to a web friendly format.

Awesome Lists containing this project

README 

        
# Bash Command: Slugify



Slugify is a bash command that converts filenames and directories to a web friendly format.



## Usage Help



Simply enter the slugify command without any arguments or with the -h option to view the usage help.



    $ slugify

    usage: slugify [-acdhintuv] source_file ...

       -a: remove spaces immediately adjacent to dashes

       -c: consolidate consecutive spaces into single space

       -d: replace spaces with dashes (instead of default underscores)

       -h: help

       -i: ignore case

       -n: dry run

       -t: treat existing dashes as spaces

       -u: treat existing underscores as spaces (useful with -a, -c, or -d)

       -v: verbose



## Usage Examples



Note, most examples below are run in verbose mode (-v) to help illustrate the results.



Verbose mode is unnecessary in real world scenarios.



#### Provide escaped filenames:



    $ slugify -v My\ \ file.txt

    rename: My  file.txt -> my__file.txt



#### Alternatively provide unescaped filenames inside quotes:



    $ slugify -v "My  file.txt"

    rename: My  file.txt -> my__file.txt



#### Globs (like * and ?) work as well:



    $ slugify -v *.txt

    rename: My file.txt -> my_file.txt

    ignore: my_web_friendly_filename.txt



#### Provide an unlimited number of arguments:



    $ slugify -v "My first file.txt" "My second file.txt"

    rename: My first file.txt -> my_first_file.txt

    rename: My second file.txt -> my_second_file.txt



#### Directories are also supported:



    $ slugify -v "My Directory"

    rename: My Directory -> my_directory



#### Consolidate consecutive spaces into single spaces:



    $ slugify -vc "My    consolidated    file.txt"

    rename: My    consolidated    file.txt -> my_consolidated_file.txt



#### Replace spaces with dashes:



    $ slugify -vd "My dashed file.txt"

    rename: My dashed file.txt -> my-dashed-file.txt



The -d option replaces each space with a dash.



    $ slugify -vd "My  dashed  file.txt"

    rename: My  dashed  file.txt -> my--dashed--file.txt



Combine -d with -c (consolidate spaces) for a single dash between each word.



    $ slugify -vdc "My  dashed  file.txt"

    rename: My  dashed  file.txt -> my-dashed-file.txt



#### Ignore case:



    $ slugify -vi "UPPER CASE FILE.txt"

    rename: UPPER CASE FILE.txt -> UPPER_CASE_FILE.txt



#### Play it safe with a dry run:



Dry run mode does not alter the filesystem in any way.



    $ slugify -n *

    --- Begin dry run mode.

    rename: My file.txt -> my_file.txt

    ignore: web_friendly_filename.txt

    --- End dry run mode.



Dry run mode also allows you to test filenames that don't exist. Great for testing!



    $ slugify -n "Ghost File.txt"

    --- Begin dry run mode.

    not found: Ghost File.txt

    rename: Ghost File.txt -> ghost_file.txt

    --- End dry run mode.



Dry run mode automatically enables verbose mode so there is no need to include the -v option with -n.



#### Handle spaces adjacent to dashes:



In this example, without -a the dashes end up surrounded by underscores.



    $ slugify -v "The Beatles - Yellow Submarine.mp3"

    rename: The Beatles - Yellow Submarine.mp3 -> the_beatles_-_yellow_submarine.mp3



But with -a the adjacent spaces are removed.



    $ slugify -va "The Beatles - Yellow Submarine.mp3"

    rename: The Beatles - Yellow Submarine.mp3 -> the_beatles-yellow_submarine.mp3



The -a only removes spaces immediately adjacent to a dash, which may not be the desired effect (below three spaces on either side of the dash get converted into two underscores because of -a).



    $ slugify -va "The Beatles   -   Yellow Submarine.mp3"

    rename: The Beatles   -   Yellow Submarine.mp3 -> the_beatles__-__yellow_submarine.mp3



But -c consolidates spaces into a single space and then -a will remove the left over adjacent single spaces.



    $ slugify -vac "The Beatles   -   Yellow Submarine.mp3"

    rename: The Beatles - Yellow Submarine.mp3 -> the_beatles-yellow_submarine.mp3



#### Convert existing underscores into dashes



The -u treats underscores as spaces and -d converts spaces into dashes.



    $ slugify -vud "Spaces Dashes-And_Underscores.txt"

    rename: Spaces Dashes-And_Underscores.txt -> spaces-dashes-and-underscores.txt



#### Convert existing dashes into underscores



    $ slugify -vt "Spaces Dashes-And_Underscores.txt"

    rename: Spaces Dashes-And_Underscores.txt -> spaces_dashes_and_underscores.txt