ztfy.file 0.3.11

ZTFY package used to handle files and images in Zope3

=================
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 to
automatically handle fields as external files
- automatically handle generation of images thumbnails for any image ; these
thumbnails are accessed via a custom namespace ("++display++w128.jpeg" for example to get
a 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 is
required 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.txt


Changelog
=========

0.3.11
------
- handle byte-range requests on files

0.3.10
------
- use all file content instead of 4Kb sample to extract MIME type to prevent
errors when checking MS-Office files

0.3.9
-----
- use IBaseSkinLayer from ztfy.baseskin package as base layer for fields widgets

0.3.8
-----
- added configuration directives to check for installed packages and remove static dependencies
- updated Buildout

0.3.7
-----
- use new "getMagicContentType()" function from ztfy.extfile package

0.3.6
-----
- corrected PIL thumbnail generator

0.3.5
-----
- added annotations check
- added IWatermarker interface and utility

0.3.4
-----
- corrected TAR extractor to correctly handle directories
- corrected GZip extractor to correctly implement IArchiveExtractor interface

0.3.3
-----
- added MIME types vocabulary (based on file extensions)
- added libmagic MIME types vocabulary

0.3.2
-----
- commit transaction before sending blob file and change opening mode to 'c'

0.3.1
-----
- updated locales
- updated style of files download links

0.3.0
-----
- use ZTFY.skin data API

0.2.14
------
- allow FileProperty value update from a FileUpload input
- syntax correction in HTML field input

0.2.13
------
- added display template for HTML input field

0.2.12
------
- force images in "RGBA" mode when reading images in "P" mode before resizing while
generating thumbnails

0.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 Pillow

0.2.10
------
- changed package source layout

0.2.9
-----
- include IObjectCopiedEvent subscriber moved from ztfy.extfile package
- remove default JPEG format when creating thumbnails (thumbnails are now created by default
using the same file format as the original image); JPEG is only used as default when source
image 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 templates

0.2.8
-----
- update imports for last ztfy.jqueryui and ztfy.skin packages

0.2.7
-----
- automatically add filename extension in name of FileField or ImageField attributes
values.
WARNING: since then, getting field data directly from request returns a tuple made of file
content and file name !!
- use mimetypes package to get content-type for text files
- updated doctests

0.2.6
-----
- modified ++file++ and ++display++ namespaces to accept an extension

0.2.5
-----
- added ImageFieldDataConverter to check that uploaded files are really images

0.2.4
-----
- changed position of file input fields
- changed handling of jQuery's "imgAreaSelect" plug-in

0.2.3
-----
- added check in image field widget thumbnail generation code

0.2.2
-----
- added extension in displays URLs
- changed square thumbnails management by using JQuery "imgAreaSelect" plug-in
- handle NOT_CHANGED value in square thumbnails converters

0.2.1
-----
- handle z3c.form NOT_CHANGED value in file field data converter
- migrated resources management from zc.resourcelibrary to Fanstatic

0.2
---
- Switched to ZTK-1.1.2

0.1.1
-----
- added a little sharpening on thumbnails generation
- added conversions while getting position and dimension of square thumbnails generation

0.1
---
- initial release