Skip to main content

Show information about files in a tabular fashion.

Project description

Fileinfo helps you in identifying files with specific values for certain attributes in order to search and sort these files and present the results in an easily readable tabular fashion.

Using fileinfo you can access this information for many files at once without opening these files individually with a dedicated application, which can be very time consuming.

In order to determine such file attributes, fileinfo comes with some pre-built plug-ins, for file formats like PDF, MP3, TTF and PY (Python source code files). These plug-ins allow you to determine e.g. the number of pages or the creator of PDF documents, the artist and title of MP3 files, the number of glyphs in TTF font files, the number of classes or docstrings in Python files, etc.

Of course, you can also access file information on an operating system level, like the size and modification date/time of files. And, you can also write your own plug-ins to extend fileinfo’s capabilities.

A tool like fileinfo is different from other tools like Spotlight, since it does not use a huge global index and it presents not only a flat result list, but an overview of matching files together with the respective (possibly sorted) attribute values. And since fileinfo is written in pure Python it is not tied to a specific plattform.

Fileinfo is most useful when used on many files at once, because then you get an overview of the attribute values for the entire set of files.

This release fixes a few buglets and implements minor packaging refactorings.


  • extract file attributes

  • display attribute values in a tabular fashion

  • display output table as plain text, CSV, simple RestructuredText, HTML

  • display output table interactively (OS X Cocoa and Django, experimental)

  • sort output by one or more attribute values

  • filter files with attributes satisfying some expression

  • provide a plugin architecture

  • provide a plugin for filesystem attributes

  • provide plugins for XML and Python

  • provide plugins for Spotlight attributes and file bundles (OS X)

  • provide plugins for media formats PDF, MP3 and Quicktime (experimental)

  • install a Python package named fileinfo

  • install a Python command-line script named fileinfo

  • provide a Unittest test suite

  • install test suite inside the installed package

  • test samples include MP3, PDF, TTF and Python files


From the system command-line you use fileinfo e.g. like this:

$ python fileinfo -a npages *.pdf

Here is an example of some statistics for Python code (taken from the top-level of Docutils 0.5):

$ cd docutils-0.5/build/lib/docutils
$ fileinfo -a lc:nclasses:ndefs:ndocstrs *.py
  lc  nclasses  ndefs  ndocstrs  path
 205         5      2         3
 616         1     24        14
  97         0      3         4
 760         5     34        18
 413         9     22        14
1802       130    124        39
1491        19     91        60
 137         0      0         1
 594         9     32        25
6115       178    332       178  total

Here is another example for Mac OS X Widgets:

$ cd /Library/Widgets
$ fileinfo --format rest-simple -a bundlename:bundleversion *.wdgt
=================  =============  ======================
bundlename         bundleversion  path
=================  =============  ======================
Address Book       1.1.5          Address Book.wdgt
Calculator         1.2            Calculator.wdgt
Dictionary         2.0.1          Dictionary.wdgt
Flight Tracker     1.3            Flight Tracker.wdgt
Movies             0.4            Movies.wdgt
Stickies           2.0            Stickies.wdgt
Stocks             1.3            Stocks.wdgt
Tile Game          1.0.2          Tile Game.wdgt
Unit Converter     2.2            Unit Converter.wdgt
Weather            1.1            Weather.wdgt
WebClip            1.0            Web Clip.wdgt
World Clock        2.0            World Clock.wdgt
Calendar           3.1            iCal.wdgt
=================  =============  ======================

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fileinfo-0.3.3.tar.gz (182.1 kB view hashes)

Uploaded Source

Built Distributions

fileinfo-0.3.3-py2.6.egg (220.7 kB view hashes)

Uploaded Source

fileinfo-0.3.3-py2.5.egg (220.8 kB view hashes)

Uploaded Source

fileinfo-0.3.3-py2.4.egg (226.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page