Jump to >



Register a MimetypeHandler class.

This will register a Mimetype Handler used by Review Board to render thumbnails for the file attachements across different mimetypes.

Only MimetypeHandler subclasses are supported.


Unregister a MimetypeHandler class.

This will unregister a previously registered mimetype handler.

Only MimetypeHandler subclasses are supported. The class must ahve been registered beforehand or a ValueError will be thrown.

score_match(pattern, mimetype)[source]

Return a score for how well the pattern matches the mimetype.

This is an ordered list of precedence (_ indicates non-match):

Format Precedence
Type/Vendor+Subtype 2
Type/_     +Subtype 1.9
Type/* 1.8
*/Vendor+Subtype 1.7
*/_     +Subtype 1.6
Type/_ 1
*/_ 0.7
class MimetypeHandler(attachment, mimetype)[source]

Bases: object

Handles mimetype-specific properties.

This class also acts as a generic handler for mimetypes not matched explicitly by any handler. Note that this is not the same as ‘/’.

MIMETYPES_DIR = u’rb/images/mimetypes’[source]
supported_mimetypes = [][source]
use_hd_thumbnails = True[source]

Subclasses (especially in extensions) can use this to introspect what size thumbnails they should generate.

__init__(attachment, mimetype)[source]

Initialize the handler.

classmethod get_best_handler(mimetype)[source]

Return the handler and score that that best fit the mimetype.

classmethod for_type(attachment)[source]

Return the handler that is the best fit for provided mimetype.


Return the appropriate icon URL for this mimetype.


Return HTML that represents a preview of the attachment.

The outer-most object should have the class ‘file-thubmnail’.


Set the thumbnail data.

This should be implemented by subclasses if they need the thumbnail to be generated client-side.

class ImageMimetype(attachment, mimetype)[source]

Bases: reviewboard.attachments.mimetypes.MimetypeHandler

Handles image mimetypes.

supported_mimetypes = [u’image/*’][source]

Return a thumbnail of the image.

class TextMimetype(attachment, mimetype)[source]

Bases: reviewboard.attachments.mimetypes.MimetypeHandler

Handles text mimetypes.

supported_mimetypes = [u’text/*’][source]
FILE_CROP_CHAR_LIMIT = 1000[source]

Return the thumbnail of the text file as rendered as html.

class ReStructuredTextMimetype(attachment, mimetype)[source]

Bases: reviewboard.attachments.mimetypes.TextMimetype

Handles ReStructuredText (.rst) mimetypes.

supported_mimetypes = [u’text/x-rst’, u’text/rst’][source]
class MarkDownMimetype(attachment, mimetype)[source]

Bases: reviewboard.attachments.mimetypes.TextMimetype

Handle MarkDown (.md) mimetypes.

supported_mimetypes = [u’text/x-markdown’, u’text/markdown’][source]