Package: ztfy.file
=================ztfy.file package=================.. contents::What is ztfy.file ?===================ztfy.file is a set of classes to be used with Zope3 application server.The purpose of this package is to handle :- custom schema fields with their associated properties and browser widgets toautomatically handle fields as external files- automatically handle generation of images thumbnails for any image ; thesethumbnails are accessed via a custom namespace ("++display++w128.jpeg" for example to geta thumbnail of 128 pixels width) and are stored via images annotations- allow selection of a square part of a thumbnail to be used as a "mini-square thumbnail".Square thumbnails selection is based on JQuery package extensions, so the ztfy.jqueryui isrequired to use all functions of ztfy.file package.How to use ztfy.file ?======================A set of ztfy.file usages are given as doctests in ztfy/file/doctests/README.txtChangelog=========0.3.13------- corrected Firefox byte-range0.3.12------- changed Firefox requests management using range to use file iterator instead of simple stringand avoid mod_wsgi errors on big files0.3.11------- handle byte-range requests on files0.3.10------- use all file content instead of 4Kb sample to extract MIME type to preventerrors when checking MS-Office files0.3.9------ use IBaseSkinLayer from ztfy.baseskin package as base layer for fields widgets0.3.8------ added configuration directives to check for installed packages and remove static dependencies- updated Buildout0.3.7------ use new "getMagicContentType()" function from ztfy.extfile package0.3.6------ corrected PIL thumbnail generator0.3.5------ added annotations check- added IWatermarker interface and utility0.3.4------ corrected TAR extractor to correctly handle directories- corrected GZip extractor to correctly implement IArchiveExtractor interface0.3.3------ added MIME types vocabulary (based on file extensions)- added libmagic MIME types vocabulary0.3.2------ commit transaction before sending blob file and change opening mode to 'c'0.3.1------ updated locales- updated style of files download links0.3.0------ use ZTFY.skin data API0.2.14------- allow FileProperty value update from a FileUpload input- syntax correction in HTML field input0.2.13------- added display template for HTML input field0.2.12------- force images in "RGBA" mode when reading images in "P" mode before resizing whilegenerating thumbnails0.2.11------- added new getMagicContentType function- added archives extraction interface and utilities- added "downloadable" attribute on file/image widgets- corrected display widgets- switch dependencies from PIL to Pillow0.2.10------- changed package source layout0.2.9------ include IObjectCopiedEvent subscriber moved from ztfy.extfile package- remove default JPEG format when creating thumbnails (thumbnails are now created by defaultusing the same file format as the original image); JPEG is only used as default when sourceimage is not in JPEG, PNG or GIF format- use PIL to get image size when not in JPEG, PNG or GIF format- added 'display:' TALES adapter to easily get display adapter from page templates0.2.8------ update imports for last ztfy.jqueryui and ztfy.skin packages0.2.7------ automatically add filename extension in name of FileField or ImageField attributesvalues.WARNING: since then, getting field data directly from request returns a tuple made of filecontent and file name !!- use mimetypes package to get content-type for text files- updated doctests0.2.6------ modified ++file++ and ++display++ namespaces to accept an extension0.2.5------ added ImageFieldDataConverter to check that uploaded files are really images0.2.4------ changed position of file input fields- changed handling of jQuery's "imgAreaSelect" plug-in0.2.3------ added check in image field widget thumbnail generation code0.2.2------ added extension in displays URLs- changed square thumbnails management by using JQuery "imgAreaSelect" plug-in- handle NOT_CHANGED value in square thumbnails converters0.2.1------ handle z3c.form NOT_CHANGED value in file field data converter- migrated resources management from zc.resourcelibrary to Fanstatic0.2---- Switched to ZTK-1.1.20.1.1------ added a little sharpening on thumbnails generation- added conversions while getting position and dimension of square thumbnails generation0.1---- initial release