Installation

Install the package with pip:

$ pip install django-filemetadata

Add the App in the INSTALLED_APPS

INSTALLED_APPS=(
    "django-filemetadata",
),

Execute makemigrations/migrate.

Configuration

Configure the directories to look for the files in the settings:

Utilization

Index the data with the management command

usage:  filemetadata_index [-f FOLDERS] [-c] [-d] [-s] [-x] [-n] [-a]

Update the the file-metadata found in the directories into the DB.

optional arguments:
  -f FOLDERS            Folder(s) to index (coma separated)
  -c                    Clear the data before reindex
  -d                    Delete only the data from these folders and exit
  -s                    Index the symlinks (Do not follow it)
  -x                    Extract the content of the file (text)
  -n                    Non-reentrant mode (Not recursive)
  -a                    Abort on errors

e.g.

Reindex the files configured in settings

or inform the directories

Or just delete the data from these folders (not recursive in this case):

Go to Admin and check the data in the FileMetadata model.

Customization

Support for .pdf files This app is compatible with the ‘PyPDF4’ library. If it is installed it can be used to extract the content from pdf files if necessary.

Custom extractor It is possible to override the function that extracts the contents of the files by a more specific one if necessary. To do this, overload the function ‘func_extract_text’ in the indexer.py module

from filemetadata import indexer

def my_extractor(posixpath_obj):
    ...
    return file_content

indexer.func_extract_text = my_extractor

or the extract_text method of the FileIndexer class

from filemetadata.indexer import FileIndexer

class MyFileIndexer(FileIndexer):
  def extract_text(self, file_obj):
    ...
    return file_content

Tests

To run the tests

python load_tests.py