Skip to content
Newer
Older
100644 63 lines (48 sloc) 2.44 KB
def84f8 Kick off project with a manifesto in README
Martin Berends authored
1 =begin pod
2
3 =head1 NAME
1fa4314 @cxreg remove remaining references to FakeDBI and FakeDBD
cxreg authored
4 MiniDBI - a simple database interface for Rakudo Perl 6
def84f8 Kick off project with a manifesto in README
Martin Berends authored
5
6 =head1 DESCRIPTION
bd0881f @timbunce Removed references to old roadmaps etc. Clarified scope and roadmap r…
timbunce authored
7 The MiniDBI project provides a simple database interface for Perl 6.
8
9 It's not a port of the Perl 5 DBI and does not intend to become one.
10 It is, however, a simple and useful database interface for Perl 6 that works
11 now. It looks like a DBI, and it talks like a DBI (although it only offers
12 a subset of the functionality).
720e789 passing the first 20 mysql tests for create, drop, insert, delete (NO…
Martin Berends authored
13
14 =head1 DBD CLASSES
1fa4314 @cxreg remove remaining references to FakeDBI and FakeDBD
cxreg authored
15 Until there is a benefit in doing it otherwise, the MiniDBD drivers stay
16 and install together with the main MiniDBI.pm6 in a single project. The
a88469c the first half of 40bindparam.t brings the pass count up to 86
Martin Berends authored
17 first DBD is for MySQL, there will probably soon be SQLite, Postgres and
18 FreeTDS. An AnyData driver for memory or file formats such as YAML or
19 XML is also planned.
f65d766 The first fetch*() methods seem to work, about 10% of the test suite …
Martin Berends authored
20
21 =head1 TESTING
a88469c the first half of 40bindparam.t brings the pass count up to 86
Martin Berends authored
22 The initial test script is merely a concatenation of all the scripts in
23 the Perl 5 DBD::mysql test suite, translated to Perl 6. It's not
24 efficient but indispensable to assess coverage of the existing DBI
25 feature set. Only about 15% of the suite has been converted so far,
26 with 86 tests passing, 0 todo and 0 skipped.
27
28 The test suite will change to eliminate the current slowness and
29 redundancy. It will contain general tests as well as tests for
30 particular databases. The aim is to make the suite demonstrate portable
31 and non portable operations.
32
33 =head1 ROADMAP
34 Add some DBDs. Improve the test suite. Attract more contributors.
f65d766 The first fetch*() methods seem to work, about 10% of the test suite …
Martin Berends authored
35
bd0881f @timbunce Removed references to old roadmaps etc. Clarified scope and roadmap r…
timbunce authored
36 We'll add a driver for the DBDI project (L<http://github.com/timbunce/DBDI>)
37 once it has sufficient functionality. Then the existing drivers would be
38 migrated to become DBDI drivers. Once DBDI and driver functionality has reached
39 a suitable level a full port of DBI can be built over DBDI.
40
a88469c the first half of 40bindparam.t brings the pass count up to 86
Martin Berends authored
41 =head1 STATUS
42 The MySQL driver performs CRUD operations. Testing with production data
43 is urgently needed. Testers, please volunteer!
f65d766 The first fetch*() methods seem to work, about 10% of the test suite …
Martin Berends authored
44
80215c0 increase to 44 tests, 35 pass, 7 todo, 2 skip
Martin Berends authored
45 =head1 BUGS
a88469c the first half of 40bindparam.t brings the pass count up to 86
Martin Berends authored
46 Numbers with decimal points are passed to the database server as quoted
47 strings, because of far-too-simple checking in execute().
80215c0 increase to 44 tests, 35 pass, 7 todo, 2 skip
Martin Berends authored
48
382ea5c README refers to Tim Bunce DBI v2 - The Plan and How You Can Help
Martin Berends authored
49 =head1 SEE ALSO
1fa4314 @cxreg remove remaining references to FakeDBI and FakeDBD
cxreg authored
50 The Perl 6 Pod in the L<doc:MiniDBI> module.
e9ee1a6 very incomplete initial work with zavolaj and mysql client
Martin Berends authored
51 The Perl 5 L<doc:DBI> and L<doc:DBI::DBD>.
52
1fa4314 @cxreg remove remaining references to FakeDBI and FakeDBD
cxreg authored
53 This README and the documention of the MiniDBI and the MiniDBD modules
a88469c the first half of 40bindparam.t brings the pass count up to 86
Martin Berends authored
54 are in the proposed Pod6 format. The reasons are that Perl 6 does not
55 allow any other kind of Pod, and that Pod6 needs more examples. View it
56 with an appropriate formatter if your system has one.
382ea5c README refers to Tim Bunce DBI v2 - The Plan and How You Can Help
Martin Berends authored
57
58 =head1 LICENSE and COPYRIGHT
e9ee1a6 very incomplete initial work with zavolaj and mysql client
Martin Berends authored
59 Use these files at your risk and without warranty. Give due credit if
60 you do. Written by Martin Berends.
def84f8 Kick off project with a manifesto in README
Martin Berends authored
61
62 =end pod
Something went wrong with that request. Please try again.