fptokens 0.1.1

A library for tokenisable filename paths

A library for tokenisable filename paths

Full Documentation

Installation

To install fptokens, type:

$ pip install fptokens

Getting Started

To get started with fptokens, type:

>>> import fptokens as fpt

To create a file name, type:

>>> filename = fpt.Filename(root='/Users/demo/Desktop',
                            folders=['assets', '$colors$'],
                            base=['asset', '$colors$', '1200px'])

This created a file name with default settings, _ as the separator, jpg as the extension and $ as the escape character for the tokens.

To parse and convert the tokens of the file name to actual tokens, type:

>>> filename.parse()

To get the results of the parsing, type:

>>> print filename.tokens
>>> [<Token: $color$>]

The list of tokens could now be used to create permutations of the tokenised file name for example for batch output of image assets.

Once tokens have been replaced with real-world data to create permutations, the relevant folders can be created by typing:

>>> filename.make()