fpc/packages/fcl-db/tests
marco 642a180809 Fix from Lacak2 for Mantis #21994 fixes
* when records are inserted into empty dataset and then all canceled by CancelUpdates AV is raised
* another fix for bug #18004, applied in rev.20531 (improved in rev.21197)
  (original approach is not good because when record is inserted and deleted and again inserted,
   then same memory block can be returned, which leads to confusion, because we get same BookmarkData for distinct records)
* +test 

git-svn-id: trunk@21280 -
2012-05-12 20:15:52 +00:00
..
bufdatasettoolsunit.pas * Mantis #21922, improve testsuite for bufdatasets. 2012-05-02 20:46:26 +00:00
database.ini.txt * Applied tests pach from bug #17303 2012-03-22 13:45:54 +00:00
dbfexporttest.lpi * Testcase for DBF export 2011-09-06 10:16:56 +00:00
dbfexporttest.lpr * Testcase for DBF export 2011-09-06 10:16:56 +00:00
dbfexporttestcase1.pas * patch from BigChimp, fixing dbf related testing of output, from 2011-09-25 19:52:10 +00:00
dbftoolsunit.pas * Patch from Luiz Americo to fix a double pathdelim in filename, bug #16737 2010-06-30 18:29:41 +00:00
dbtestframework_gui.lpi * Added Lazarus gui-frontend for db unit-tests. 2012-05-08 10:22:39 +00:00
dbtestframework_gui.lpr * Added Lazarus gui-frontend for db unit-tests. 2012-05-08 10:22:39 +00:00
dbtestframework.pas * add bufdataset to test framework, Mantis #20081, patch by bigchimp 2011-10-15 16:09:54 +00:00
Makefile + Regenerate all Makefiles's after adding x86_64 netbsd target 2012-04-24 23:15:18 +00:00
Makefile.fpc * SQL parser 2010-08-16 23:13:24 +00:00
memdstoolsunit.pas
README.txt * additions by Reinier, mantis #21895 2012-04-30 14:58:39 +00:00
sdfdstoolsunit.pas
sqldbtoolsunit.pas * handle milliseconds in IB timestamps, patch by Zipfelvo, improved by Lacak2. 2012-05-05 22:19:25 +00:00
tcgensql.pas * Added tests for Grant/Revoke, fixed some bugs on the way 2010-09-03 17:01:01 +00:00
tcparser.pas * Implemented AS for table aliases 2011-11-12 13:05:15 +00:00
tcsqlscanner.pas * Added tests for Grant/Revoke, fixed some bugs on the way 2010-09-03 17:01:01 +00:00
test.json * Example for JSON dataset 2011-12-16 16:31:13 +00:00
testbasics.pas * Patch and testcase from Luiz Americo to fix ExtractFieldName (bug 21777) 2012-04-15 11:52:15 +00:00
testbufdatasetstreams.pas Fix from Lacak2 for Mantis #21994 fixes 2012-05-12 20:15:52 +00:00
testdatasources.pas
testdbbasics.pas * Implemented TBufDataset.MergeChangelog 2012-05-08 14:16:28 +00:00
testdddiff.pp
testfieldtypes.pas * fcl-db test for opening non-select statements, which return data by Lacak2, Mantis #21850 2012-04-24 08:35:29 +00:00
testjsondataset.pp * Removed resource added by lazarus 2011-12-17 12:31:42 +00:00
testspecifictbufdataset.pas * Raise an exception when a TBufDataset is opened while there is no dataset created 2012-05-09 15:56:55 +00:00
testsqlfiles.lpi * SQL parser 2010-08-16 23:13:24 +00:00
testsqlfiles.lpr * SQL parser 2010-08-16 23:13:24 +00:00
testsqlscanner.lpi * Added tests for Grant/Revoke, fixed some bugs on the way 2010-09-03 17:01:01 +00:00
testsqlscanner.lpr * SQL parser 2010-08-16 23:13:24 +00:00
testsqlscript.pas
toolsunit.pas * Improved comments in toolsunit. Mantis #21910, patch by Reinier Olislagers 2012-05-02 20:42:39 +00:00
XMLXSDExportTest.lpi * Tester for XSD export 2011-07-27 18:35:16 +00:00
XMLXSDExportTest.lpr * Tester for XSD export 2011-07-27 18:35:16 +00:00
xmlxsdexporttestcase1.pas * Better test case from Reinier, Bug ID #19987 2011-08-15 10:29:06 +00:00

This directory contains a framework to test several TDataset descendents.
A lot of these tests are only applicable for SQL databases, but there are several tests that also apply to other objects, such as TBufDataset.

The framework is based on the fpcunit unit test system. The tests can be
executed using any fpcunit-testrunner. For example the console and graphical
fpcunit test runners from Lazarus.
Simply add the test* units in this directory to the uses statement of the
test runner and all tests will get registered and executed.

A simple test runner (dbtestframework.pas) which generates XML output is
included in this directory.

To test a TDataset descendent, a 'connector' is needed to test the database.
To add a new connector, create a new *toolsunit.pas file, then add it to 
the uses section in 'dbtestframework.pas'. Several connectors are available 
in the '*toolsunit.pas' files.

The connector must inherit from TDBConnector in toolsunit.pas.
The connector implements two different kinds of datasets: 
- a dataset with as many different kinds of fields as possible (see the *FieldDataSets subroutines).
- a dataset with only a few fields (ID and NAME), but a lot (well, MaxDataset) of different records (see the *NDataSets subroutines)

CreateNDatasets and CreateFieldDataset should be implemented to set up data stores (e.g. database tables) and fill these stores with test data for the respective datasets.
The corresponding Drop*Dataset procedures must drop the tables/delete the data.

GetNDataset and GetFieldsDataset should return the relevant dataset in closed state so the tests can open them and work with them.
They call InternalGetNDataset and InternalGetFieldDataset which should be implemented in all descendents and returns the relevant dataset, closed, with all data.

Toolsunit.pas defines some variables for use, e.g. testValuesCount is the number of records/test values in the FieldDataset dataset; MaxDataset is the same for NDataset.
See e.g. the SQLDBToolsUnit for the implementation for SQL Databases.

Which connector is currently used is dependent on the 'database.ini'
configuration file. Also some settings which are connector-dependent can be set
in that file. See 'database.ini.txt' for an example.

I hope this is enough information to get you started,

Joost van der Sluis (30-12-2006), 
amended by Reinier Olislagers (April 2012)