Skip to content

codingjoe/django-dynamic-filenames

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

98 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Django Dynamic Filenames

Write advanced filename patterns using the Format String Syntax.

Getting Started

Installation

pip install django-dynamic-filenames

Samples

Basic example:

from django.db import models
from dynamic_filenames import FilePattern

upload_to_pattern = FilePattern(
    filename_pattern='{app_label:.25}/{model_name:.30}/{instance.created:%Y-%m-%d}/{uuid:base32}{ext}'
)

class FileModel(models.Model):
    my_file = models.FileField(upload_to=upload_to_pattern)
    created = models.DateTimeField(auto_now_add=True)

Auto slug example:

Features

Field names

ext

: File extension including the dot.

name

: Filename excluding the folders.

model_name

: Name of the Django model.

app_label

: App label of the Django model.

instance

: Instance of the model before it has been saved. You may not have a primary key at this point.

uuid

: UUID version 4 that supports multiple type specifiers. The UUID will be the same should you use it twice in the same string, but different on each invocation of the upload_to callable.

The type specifiers allow you to format the UUID in different ways,
e.g. `{uuid:x}` will give you a with a hexadecimal UUID.

The supported type specifiers are:

`s`

:   String representation of a UUID including dashes.

`i`

:   Integer representation of a UUID. Like to `UUID.int`.

`x`

:   Hexadecimal (Base16) representation of a UUID. Like to
    `UUID.hex`.

`X`

:   Upper case hexadecimal representation of a UUID. Like to
    `UUID.hex`.

`base32`

:   Base32 representation of a UUID without padding.

`base64`

:   Base64 representation of a UUID without padding.

    :::: warning
    ::: title
    Warning
    :::

    Not all file systems support Base64 file names.
    ::::

All type specifiers also support precisions to cut the string, e.g.
`{{uuid:.2base32}}` would only return the first 2 characters of a
Base32 encoded UUID.

Type specifiers

You can also use a special slug type specifier, that slugifies strings.

Example:

from django.db import models
from dynamic_filenames import FilePattern

upload_to_pattern = FilePattern(
    filename_pattern='{app_label:.25}/{model_name:.30}/{instance.title:.40slug}{ext}'
)

class FileModel(models.Model):
    title = models.CharField(max_length=100)
    my_file = models.FileField(upload_to=upload_to_pattern)

Slug type specifiers also support precisions to cut the string. In the example above the slug of the instance title will be cut at 40 characters.