FileGroups

Common file extensions and MIME types, grouped by application and type. Useful when you need to process or restrict processing to certain types of files.

Usage

Methods on FileGroups return an object containing a set of MIME types and file extensions. These are accessible via the .mime_types and .extensions methods, which return an Array of Strings. By default only commonly used values are returned. To return all know values pass true to either method, e.g., object.mime_types(true)

In some cases additional methods can be called on the object to further restrict the set.

Let's look at some examples.

Images & Video

require "file_groups"

FileGroups.image.extensions  # ["bmp", "gif", "ico", "jpeg", ... ]
FileGroups.image.mime_types  # ["image/bmp", "image/x-ms-bmp", "image/gif", ... ]
FileGroups.video.extensions  # ["asf", "mov", "qt", "movie", ... ]
FileGroups.video.mime_types  # ["video/x-ms-asf", "video/quicktime", ... ]

Images can be filtered on by raster, vector, or web:

FileGroups.image.web.extensions     # ["gif", "jpeg", "jpg", "png", "svg", "webp"]
FileGroups.image.raster.extensions  # ["bmp", "gif", "ico", "jpeg", "jpg", "tif", "tiff", "webp"]
FileGroups.image.vector.extensions  # ["svg"]

For a complete list pass in true to any of these methods:

FileGroups.image.extensions(true)  # ["bmp", "dib", "gif", "ico", "jfif", "jpe", "jpeg", ... ]

Spreadsheets

Retrieve a list of file extensions or MIME types used by spreadsheets

require "file_groups"

FileGroups.spreadsheet.extensions   # ["csv", "xls", "xlsx", "xlt", ... ]
FileGroups.spreadsheet.mime_types   # ["text/csv", "application/vnd.ms-excel", ... ]

If you only want values specific to Microsoft Excel:

FileGroups.spreadsheet.excel.extensions   # ["xls", "xlsx", "xlt", "xltx", "xlw"]
FileGroups.spreadsheet.excel.mime_types   # ["application/vnd.ms-excel", ... ]

Or for OpenOffice:

FileGroups.spreadsheet.openoffice.extensions  # ["ods", "ots"]

By default these only return common extensions, to return all:

FileGroups.spreadsheet.excel.extensions(true) # ["xls", "xlsx", "xlt", "xltx", ... ]

Office Productivity Files

Retrieve a list of file extensions or MIME types used by common office software

require "file_groups"
FileGroups.document.extensions     # ["csv", "key", "key-tef", "xls", "xlsx", "xlt ... ]
FileGroups.document.mime_types     # ["text/csv", "application/vnd.ms-excel", ... ]

Other Filters

See the documentation for more.

Contributing

See https://github.com/sshaw/file_groups (or ../README.md)

Author

Skye Shaw (skye.shaw -AT- gmail)

License

The gem is available as open source under the terms of the MIT License.