backcompat TODO
[dbsrgits/DBIx-Class-Schema-Loader.git] / TODO-BACKCOMPAT
1 SL Backcompat Plan:
2
3 *** dynamic schemas
4
5 * should default to 0.04006 mode
6 * __PACKAGE__->naming('current') will turn on current mode
7
8 *** 0.04006 mode
9
10 * use the detector and compat relbuilder ilmari already wrote for static schemas
11 * make sure results are not singularized
12 * add a loud warning that says that we're running in backcompat mode, and refers
13   to the ::Manual::UpgradingFrom4006 POD.
14
15 *** 0.04006 tests
16
17 * are in t/backcompat/0.04006
18 * have their own lib/
19 * should only run with the SCHEMA_LOADER_TESTS_BACKCOMPAT=1 env var
20 * need tests_recursive (or whatever) in Makefile.PL
21 * need to run in 0.04006 mode (by seeding with a Schema.pm generated by
22   0.04006, activation of backcompat mode should be minimally invasive.)
23
24 *** common tests
25
26 * should be all based off a static schema, because dynamic schemas will be
27   in 0.04006 mode
28
29 *** Schema::Loader::Base
30
31 * 'naming' accessor should be a Class::Accessor::Grouped 'inherited' type
32   accessor, doc is written
33
34 *** Write ::Manual::UpgradingFrom4006 POD
35
36 *** Catalyst Helper
37
38 * Add 'upgrade=1' option that upgrades from both old S::L and old helper,
39   whichever or both.
40 * Warn when old helper output or 0.04000 S::L output is detected, that refers to
41   the upgrade option.
42
43 Release dev S::L, announce to catalyst, dbic lists and #catalyst that testing of
44 backcompat mode is needed, wait 2-3 weeks, then release 0.05000.