Package: redturtle.sqlcontents
ContentsDisclaimerIntroductionDescriptionSQLFolderSQLQueryInstallationNotesCreditsAuthorsTODO?Changelog0.9.1 (2013-07-29)0.9.0 (2012/08/31)Disclaimerredturtle.sqlcontensis adangerouspackage.Read carefully the documentation before using it.
Even if this package is developed to execute “SELECT” queries, it accepts any
kind of query without validation. In the current development state you caneven DROPstuff from your DB,
and this isdangerousandevilish.SECURITY HINT: it is better, when possible to access the external DB with a
read only account. This cansave the world!Do not query large amount of data or blobs,
redturtle.sqlcontents is not designed for that task!Be aware that long queries or network problems canlock your instance threads!IntroductionThis package is developed to satisfy the demand to execute and present simple SQL
queries on Plone using SQLAlchemy.It introduces two archetypes to your Plone site:SQLFolderSQLQueryWith this contents you can display the data returned by the queries into Plone pages.DescriptionSQLFolderThe SQLFolder object is globally addable and can contain SQLQuery objects.
The SQLFolder has aconnection_urlfield where you can specify how to connect
to an external DB through SQLAlchemy.
Please take a look tothe SQLAlchemy documentation).SQLQueryInside a SQLFolder you can create SQLQueries, document like objects that
contain a fieldquery.
Inside this field you can specify any kind of query to your database,without
constraints, even if it supposed to be a SELECT.The default view for the SQLQuery objects takes the results from your query and
presents them in a paginated table.
The header of the tables is composed, by default, by the column names, but you
can define a replacement mapping filling properly the fieldcolumn_names.InstallationAdd redturtle.sqlcontents to the egg section of your instance:[instance]
eggs=
    ...
    redturtle.sqlcontents
    ...In order to make the connection to your database server of choice effective
you may  need to install (using systm tools or buildout) the proper libraries,
e.g:MySQL-pythoncx_Oraclepsycopg2python-sqliteIn older Plone (previous to version 3.3.2) you need to do the same with the
zcml section.Notesredturtle.sqlcontentshas been tested with Plone 3.3.4 and Plone 4.2.
I assume the compatibility with the intermediate releases.redturtle.sqlcontentsdepends on:SQLAlchemyProducts.DataGridFieldThose packages are automatically included byredturtle.sqlcontentsinside
your buildout, so you do not have to take care about them.InPlone 3installations you may want to pin the Products.DataGridField to
a version lower than 1.7 (1.6.2 is the proper one at the time of writing).CreditsDeveloped with the support ofARPA Veneto; ARPA Veneto supports thePloneGov initiative.AuthorsThis product was developed by RedTurtle Technology team.TODO?Validate the queries through registrable adapters;Present the data through adapters to handle blob, dates and so on;Add more connection parameters to the SQLFolder object;Optimize DB connections;Add some cache here and there;More aggressive caching;Caching;Changelog0.9.1 (2013-07-29)Fixed setup.py to correctly declare Products.DataGridField dependency
(thanks to Olav Peeters for pointing it out)
[ale-rt]0.9.0 (2012/08/31)Initial release