Annotation of ExtFile/IExtFile.py, revision 1.1.1.1

1.1       dwinter     1: #
                      2: # IExtFile and IExtImage public interfaces
                      3: #
                      4: 
                      5: try: 
                      6:     from Interface import Interface
                      7: except ImportError:
                      8:     # Zope < 2.6
                      9:     from Interface import Base as Interface
                     10: 
                     11: 
                     12: class IExtFile(Interface):
                     13:     '''ExtFile public interface'''
                     14: 
                     15:     def index_html(icon=0, preview=0, width=None, height=None, REQUEST=None):
                     16:         '''The default view. Returns the file's contents.'''
                     17: 
                     18:     def view_image_or_file():
                     19:         '''Redirects to the default view of the file or image.'''
                     20:     
                     21:     def link(text='', **args):
                     22:         '''Returns an HTML link tag for the file or image.'''
                     23: 
                     24:     def is_broken():
                     25:         '''Returns true if the file does not exist in the repository, false otherwise.'''
                     26: 
                     27:     def get_size():
                     28:         '''Returns the size of the file or image.'''
                     29: 
                     30:     def size():
                     31:         '''Returns a formatted, stringified version of the file size.'''
                     32: 
                     33:     def get_filename():
                     34:         '''Returns the filesystem path of the file.'''
                     35: 
                     36:     def getContentType():
                     37:         '''Returns the file's content type (MIME type).'''
                     38: 
                     39:     def static_mode():
                     40:         '''Returns true if EXTFILE_STATIC_PATH is set, false otherwise.'''
                     41: 
                     42:     def static_url():
                     43:         '''Returns the Zope or static URL of a file, depending on static_mode().'''
                     44: 
                     45:     def icon_gif():
                     46:         '''Redirects to the icon for the file's MIME type.'''
                     47: 
                     48:     def icon_tag():
                     49:         '''Returns an HTML image tag for the icon.'''
                     50: 
                     51:     def getIconPath():
                     52:         '''Returns the filesystem path of the icon for the file's MIME type.'''
                     53: 
                     54:     def manage_editExtFile(title='', descr='', REQUEST=None):
                     55:         '''Changes the properties.'''
                     56: 
                     57:     def manage_upload(file='', content_type='', REQUEST=None):
                     58:         '''Uploads a file from a file handle or string buffer.'''
                     59: 
                     60:     def manage_file_upload(file='', content_type='', REQUEST=None):
                     61:         '''Uploads a file from a file handle or local directory.'''
                     62: 
                     63:     def manage_http_upload(url, REQUEST=None):
                     64:         '''Uploads a file from an HTTP server.'''
                     65: 
                     66:     def manage_afterUpdate(filename, content_type, size):
                     67:         '''Called whenever the file data has been updated.'''
                     68: 
                     69:     def PrincipiaSearchSource():
                     70:         '''Returns the contents of text/* files, empty string otherwise.'''
                     71: 
                     72: 
                     73: class IExtImage(IExtFile):
                     74:     '''ExtImage public interface'''
                     75: 
                     76:     def tag(preview=0, icon=0, height=None, width=None, alt=None,
                     77:             scale=0, xscale=0, yscale=0, border='0', REQUEST=None, **args):
                     78:         '''Returns an HTML image tag for this image.'''
                     79: 
                     80:     def width():
                     81:         '''Returns the pixel width of the main image.'''
                     82: 
                     83:     def height():
                     84:         '''Returns the pixle height of the main image.'''
                     85: 
                     86:     def format():
                     87:         '''Returns the PIL file format of the image.'''
                     88:     
                     89:     def is_webviewable():
                     90:         '''Returns true if the file format is GIF, JPEG, or PNG; false otherwise.'''
                     91: 
                     92:     def preview():
                     93:         '''Redirects to the preview image.'''
                     94: 
                     95:     def preview_tag():
                     96:         '''Returns an HTML image tag for the preview image.'''
                     97: 
                     98:     def get_prev_size():
                     99:         '''Returns the size of the preview image.'''
                    100: 
                    101:     def prev_size():
                    102:         '''Returns a formatted stringified version of the preview image size.'''
                    103: 
                    104:     def prev_width():
                    105:         '''Returns the pixel width of the preview image.'''
                    106: 
                    107:     def prev_height():
                    108:         '''Returns the pixel height of the preview image.'''
                    109: 
                    110:     def get_prev_filename():
                    111:         '''Returns the filesystem path of the preview image.'''
                    112: 
                    113:     def manage_create_prev(maxx=0, maxy=0, ratio=0, REQUEST=None):
                    114:         '''Create the preview from the main image.'''
                    115: 
                    116:     def manage_del_prev(REQUEST=None):
                    117:         '''Deletes the preview image.'''
                    118: 
                    119:     def manage_upload(file='', content_type='', is_preview=0, create_prev=0, 
                    120:                       maxx='', maxy='', ratio=0, REQUEST=None):
                    121:         '''Uploads an image or preview from a file handle or string buffer.'''
                    122: 
                    123:     def manage_file_upload(file='', content_type='', is_preview=0, create_prev=0,
                    124:                            maxx='', maxy='', ratio=0, REQUEST=None):
                    125:         '''Uploads an image or preview from a file handle or local directory.'''
                    126: 
                    127:     def manage_http_upload(url, is_preview=0, REQUEST=None):
                    128:         '''Uploads an image or preview from an HTTP server.'''
                    129: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>