Skip to main content

ZTFY package used to handle files and images in Zope3

Project description

=================
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.9
-----
- use IBaseSkinLayer from ztfy.baseskin package as base layer for 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ztfy.file-0.3.9.tar.gz (151.3 kB view hashes)

Uploaded Source

Built Distribution

ztfy.file-0.3.9-py2.7.egg (201.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page