Debian Codegraph @

TODO

raw
1 Badger::Class
2 -------------
3
4 * Also think about different debug flags, e.g. DEBUG_THIS, DEBUG_THAT
5 UPDATE: Badger::Debug now does this - just need to hook class in
6
7 * make debug hook work better: allow import of other items, e.g.
8 debug => ':dump'. Also generate DEBUG constant using any existing
9 value of $DEBUG.
10
11 * AUTOLOAD method to delegate to real class if possible?
12
13 * add 'hook' subroutine attribute
14
15 * add a way for B::C subclasses to register hooks that automatically
16 get called on import, e.g. for B::Factory::Class to push base()
17
18 * Remove class($class, $target) second argument in export hooks
19 because UBER should now handle that - needs testing
20 UPDATE - no, I think it's still required to make The Right Thing happen.
21
22 * Make CLASS static.
23
24 * Change message() to snippet()
25 NOTE - already changed Badger::Base XXX_msg() method to explicitly
26 package-scope message() to Badger::Base so that problem is mitigated.
27 A subclass can now define a message() method and it will still Just Work[tm]
28
29
30 Badger::Codec
31 --------------
32
33 * encoded()/decoded() methods (e.g. for utf8)
34
35 * update docs to clarify the fact that utf8, etc., are available as named
36 codecs via Encode/Encoding modules.
37
38
39 Badger::Config
40 --------------
41
42 * Just a basic implementation at moment. Merge in TT3 config, AppConfig
43 and other stuff.
44
45
46 Badger::Class::Config
47 --------------
48
49 * Add 'constant' as alias for 'method'. e.g. 'FOO|class:FOO|constant:FOO'
50
51
52 Badger::Debug
53 -------------
54
55 * See if we can make this a low-level mixin that we can import into
56 Badger::Utils et al.
57
58 * make debug enabler export :debug and :dump into module
59
60
61 Badger::Docs
62 ------------
63
64 * Finish writing it / cleaning it up and release.
65
66
67 Badger::Exception
68 -----------------
69
70 * Do we still want to add a higher-level catch() method?
71
72
73 Badger::Factory
74 ---------------
75
76 * Subclass out into base class (returns loaded module name), object
77 creator, object creator + cache (e.g. for hub), or whatever.
78
79 * have it bind fetch methods to item/items if undefined, e.g
80 node => item, nodes => items.
81
82 * support multi-element names, e.g. node.foo.bar
83
84
85 Badger::Filesystem
86 ------------------
87
88 * directory files/directories/dirs as grep across children
89
90 * need to handle encoding better in read_file() and write_file() methods.
91
92 * read-only filesystem option
93
94 * write_file() should have an option for writing to a temporary file and
95 renaming into place to avoid race conditions.
96
97 * I'm considering refactoring this. I'd like to unify the different
98 filesystem-specific formats to an underlying URI-based one. It would
99 require a lens (combined parser + presenter) for each O/S. Unix (inc
100 Mac OSX) are simple, Win32 isn't hard. Delegate to File::Spec for
101 everything else.
102
103 Some info about Win32 path <-> uri translation, snarfed from
104 http://blogs.msdn.com/ie/archive/2006/12/06/file-uris-in-windows.aspx
105
106 For the UNC Windows file path
107 \\laptop\My Documents\FileSchemeURIs.doc
108
109 The corresponding valid file URI in Windows is the following:
110 file://laptop/My%20Documents/FileSchemeURIs.doc
111
112 For the local Windows file path
113 C:\Documents and Settings\davris\FileSchemeURIs.doc
114
115 The corresponding valid file URI in Windows is:
116 file:///C:/Documents%20and%20Settings/davris/FileSchemeURIs.doc
117
118 Functions currently used from File::Spec are: catpath, catdir,
119 canonpath, splitpath, splitdir, filename_is_absolute, abs2rel,
120 no_upwards. Most of those can be moved out to lenses. Path
121 manipulation becomes much easier internally when the path can be
122 stored as a list of path nodes.
123
124
125 Badger::Log
126 -----------
127
128 * Add code to detect Log::Dispatch objects and forward messages.
129
130
131 Badger::Storage
132 ---------------
133
134 * This is available in the git repository but not yet included in the released
135 distribution.
136
137 * unify parameter parsing and identity definition between filesystem and
138 database storage modules.
139
140 * get/put which take data / return id
141
142 * fetch/store which returns
143
144 * create/destroy connect/disconnect open/close
145
146
147 Badger::Test
148 ------------
149
150 * Could do with some proper testing. Although all the other test scripts
151 do tend to thrash it quite well...
152
153 * Change if_env to use Badger::Logic so we can specify things like:
154 if_env => 'RELEASE_TESTING or AUTOMATED_TESTING'
155
156
157
158 Badger::Utils
159 -------------
160
161 * hashlike, listlike, numlike
162
163
164 BadgerX
165 -------
166
167 * add path to any bases missing it
168
169 * document
170
171
172
173 Longer Terms Goals / Larger Projects
174 ------------------------------------
175
176 * incorporate re-write of AppConfig into Badger::Config
177
178 * consider doing the same with Pod::POM into Badger::Pod and combining
179 with Badger::Docs. (update: doing now)
180
181 * Finish cleaning Badger-Web and release
182
183 * Finish refactoring Badger-Database and release
184