1. kdbfeaturestest
-------------

This is a set of tests for the KDb features.
Every test is driver-independent.

Usage: run 'kdbfeaturestest --help' for usage details.


2. sqltest
----------

A script for easier executing 'parser' subtest within the kdbfeaturestest.
Usage: run './sqltest' without arguments for usage details.

There is also sqltest_int script accepting interactive mode.
Usage: run './sqltest_int' without arguments for usage details.


3. Important documents
----------------------
KDb Drivers section of the Development wiki pages:
https://community.kde.org/KDb/Drivers


4. Information for KDb drivers developers
-----------------------------------------
FIXME: update

While you're developing a new driver or plan to improve existing one, you may want to test
a number of aspects of the KDb framework to see if the behaviour is like expected.

Following tests should be passed (the order is from most simple test to more complicated):

-dbcreation
-schema
-tables
-cursors
-tableview (note: it is disabled as KDb is largely non-gui for now)
-parser
-dr_prop

If a given driver does not pass one of these tests, and you have found that:
- the problem is apparently on the KDb side (e.g. crash, or improper behaviour),
- the problem can be solved by extending the KDb API,
- the documentation is not correct or not clear enough, or
- whatever like that...

..please contact KDb maintainer Jaroslaw Staniek, staniek @ kde . org, irc://irc.libera.chat/kexi
