You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

todo.html 17 KiB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <!-- Content Stylesheet for Site -->
  3. <!-- start the processing -->
  4. <html>
  5. <head>
  6. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
  7. <meta name="author" value="Adam Murdoch">
  8. <meta name="email" value="adammurdoch@apache.org">
  9. <title>Apache Myrmidon - Get Involved</title>
  10. </head>
  11. <body bgcolor="#ffffff" text="#000000" link="#525D76">
  12. <table border="0" width="100%" cellspacing="0">
  13. <!-- TOP IMAGE -->
  14. <tr>
  15. <td> <td colspan="2">
  16. <a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left" border="0"/></a>
  17. </td>
  18. </td>
  19. <td valign="bottom"><div align="right"><b><font size="+3" color="#525D76">Apache Myrmidon</font></b></div></td>
  20. </tr>
  21. </table>
  22. <table border="0" width="100%" cellspacing="4">
  23. <tr><td colspan="2">
  24. <hr noshade="" size="1"/>
  25. </td></tr>
  26. <tr>
  27. <!-- LEFT SIDE NAVIGATION -->
  28. <td valign="top" nowrap="true">
  29. <p><strong>Myrmidon</strong></p>
  30. <ul>
  31. <li> <a href="./index.html">Introduction</a>
  32. </li>
  33. <li> <a href="./getinvolved.html">Get Involved</a>
  34. </li>
  35. <li> <a href="./user.html">Building Myrmidon</a>
  36. </li>
  37. <li> <a href="./todo.html">Todo List</a>
  38. </li>
  39. </ul>
  40. <p><strong>User Guide</strong></p>
  41. <ul>
  42. <li> <a href="./buildfile.html">Build file</a>
  43. </li>
  44. <li> <a href="./vfs.html">Virtual File System</a>
  45. </li>
  46. </ul>
  47. <p><strong>Extending Ant</strong></p>
  48. <ul>
  49. <li> <a href="./task.html">Task Writers HOWTO</a>
  50. </li>
  51. <li> <a href="./classloader.html">ClassLoader HOWTO</a>
  52. </li>
  53. <li> <a href="./librarys.html">Library HOWTO</a>
  54. </li>
  55. </ul>
  56. <p><strong>Container Design</strong></p>
  57. <ul>
  58. </ul>
  59. </td>
  60. <td align="left" valign="top">
  61. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  62. <tr><td bgcolor="#525D76">
  63. <font color="#ffffff" face="arial,helvetica,sanserif">
  64. <a name="Todo List"><strong>Todo List</strong></a>
  65. </font>
  66. </td></tr>
  67. <tr><td>
  68. <blockquote>
  69. <p>The broad goal is to grow Myrmidon from a prototype task engine into a fully
  70. fledged build system, that can serve as the basis for Ant 2. The following
  71. sections describe some of the many things which still need to be done to
  72. achieve that goal. This list is currently under construction.</p>
  73. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  74. <tr><td bgcolor="#828DA6">
  75. <font color="#ffffff" face="arial,helvetica,sanserif">
  76. <a name="Self Hosting"><strong>Self Hosting</strong></a>
  77. </font>
  78. </td></tr>
  79. <tr><td>
  80. <blockquote>
  81. <p>Myrmidon must be able to build itself. Currently, it is built using
  82. Ant 1.x. Ultimately, Myrmidon should be able to build itself from exactly the
  83. same build file. To start with, however, there is no need for Myrmidon to be
  84. able to do this. Myrmidon should also be able to be bootstrapped (that is, be
  85. able to be built from scratch, without using Ant 1.x at all).</p>
  86. </blockquote>
  87. </td></tr>
  88. </table>
  89. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  90. <tr><td bgcolor="#828DA6">
  91. <font color="#ffffff" face="arial,helvetica,sanserif">
  92. <a name="Ant 1.x Compatibility"><strong>Ant 1.x Compatibility</strong></a>
  93. </font>
  94. </td></tr>
  95. <tr><td>
  96. <blockquote>
  97. <p>There are 2 parts to this broad topic: Allow Ant 1.x build scripts to be
  98. executed by Myrmidon, and allow Ant 1.x tasks to be executed unmodified
  99. by Myrmidon.</p>
  100. </blockquote>
  101. </td></tr>
  102. </table>
  103. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  104. <tr><td bgcolor="#828DA6">
  105. <font color="#ffffff" face="arial,helvetica,sanserif">
  106. <a name="Virtual File System"><strong>Virtual File System</strong></a>
  107. </font>
  108. </td></tr>
  109. <tr><td>
  110. <blockquote>
  111. <p>The VFS needs plenty of work:</p>
  112. <ul>
  113. <li>Move and copy files/folders.</li>
  114. <li>Search through a file hierarchy, using Ant-style wildcards.</li>
  115. <li>Search through a file hierarchy, using a Selector interface.</li>
  116. <li>The in-memory caching mechanism is pretty rudimentary at this stage.
  117. It needs work to make it size capped. In addition, some mechanism needs
  118. to be provided to release and refresh cached info.
  119. </li>
  120. <li>Capabilities discovery.</li>
  121. <li>Attributes and attribute schema.</li>
  122. <li>File system layering. That is, the ability for a file system to
  123. sit on top of another file system, or a file from another file system
  124. (e.g. Zip/Jar/Tar file systems, gzip/encoding file systems, virtual file
  125. systems).
  126. </li>
  127. </ul>
  128. </blockquote>
  129. </td></tr>
  130. </table>
  131. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  132. <tr><td bgcolor="#828DA6">
  133. <font color="#ffffff" face="arial,helvetica,sanserif">
  134. <a name="File Data-Types and Tasks"><strong>File Data-Types and Tasks</strong></a>
  135. </font>
  136. </td></tr>
  137. <tr><td>
  138. <blockquote>
  139. <p>The file data-types, such as <code>&lt;fileset&gt;</code> and
  140. <code>&lt;path&gt;</code>, are some of the most widely used parts of Ant 1.x.
  141. Unfortunately, they aren't particularly extensible.</p>
  142. <ul>
  143. <li>Redesign the file data-types, replacing them with an interface-based
  144. API, plus a set of implementations. The API should use the VFS file
  145. <code>FileObject</code>, rather than <code>java.io.File</code>.
  146. This process has started, in the <code>antlib.vfile</code> package.
  147. </li>
  148. <li>File Selectors:
  149. <ul>
  150. <li>Change <code>AbstractNameFileSelector</code> to use Ant 1 style patterns
  151. matches, rather than Globs patterns.</li>
  152. <li>Add 'defaultexcludes' to <code>DefaultFileSet</code>. Also add a
  153. file selector implementation that matches everything except the default
  154. excludes.</li>
  155. <li>Add a name selector that loads patterns from a file.</li>
  156. <li>Add more selector implementations: size and last-modified comparisons,
  157. checksum comparison, byte-wise content comparison.</li>
  158. </ul></li>
  159. <li>File conditions:
  160. <ul>
  161. <li>Add more condition implementations that perform checks on files.
  162. One that searches a path for a file would be useful.</li>
  163. </ul></li>
  164. <li>File Name Mappers:
  165. <ul>
  166. <li>Change FileNameMapper.mapFileName() to take vfs.FileName objects.</li>
  167. <li>Move the current mapper implementations across to antlib.</li>
  168. </ul></li>
  169. <li>File Sets:
  170. <ul>
  171. <li>Add a file set implementation that provides the union of several
  172. nested file sets (that is, a file set that merges several file sets
  173. together).</li>
  174. <li>Add a file set implementation that filters files that are up-to-date
  175. WRT some other file. Alternatively, this might be better done as a
  176. file selector.</li>
  177. </ul></li>
  178. <li>Paths:
  179. <ul>
  180. <li>Add path implementations that evaluate to the system classpath,
  181. and the ant runtime classpath. Or, more generally, combine this with
  182. <code>ClassLoaderManager</code> to evaluate to the classpath of any
  183. 'library' (e.g. system classpath, ant runtime, tools.jar,
  184. an antlib, an installed extension, or the system classes of another JVM
  185. for cross-compiling).</li>
  186. </ul></li>
  187. <li>Port across the Ant 1 file filter proposal, once it is complete.</li>
  188. <li>Copy task:
  189. <ul>
  190. <li>Implement 'preservelastmodified', 'overwrite', and 'includeemptydirs'.</li>
  191. <li>Support a file name mapper.</li>
  192. <li>Support file filters.</li>
  193. <li>Detect and handle destination file name collisions.</li>
  194. </ul></li>
  195. <li>Implement the <code>&lt;move&gt;</code>, <code>&lt;delete&gt;</code>,
  196. <code>&lt;touch&gt;</code> and <code>&lt;mkdir&gt;</code> tasks on top
  197. of the VFS and the new file data-types. Might be some scope for generalising
  198. 'touch' and 'mkdir' into a single task.</li>
  199. </ul>
  200. </blockquote>
  201. </td></tr>
  202. </table>
  203. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  204. <tr><td bgcolor="#828DA6">
  205. <font color="#ffffff" face="arial,helvetica,sanserif">
  206. <a name="Command-line and Configuration Files"><strong>Command-line and Configuration Files</strong></a>
  207. </font>
  208. </td></tr>
  209. <tr><td>
  210. <blockquote>
  211. <p>One of the goals of Ant 2 is to allow the user to easily customise and
  212. extend Ant. The command-line and local configuration files, are two places
  213. where this would be done. Currently, Myrmidon some customisation from the
  214. command-line, but does not support configuration files.</p>
  215. <ul>
  216. <li>Load configuration from system (from $ANT_HOME) and user (from $HOME)
  217. configuration files.</li>
  218. <li>Allow the following via config files:
  219. <ul>
  220. <li>Add (or override) the <code>lib</code> and <code>ext</code> directories.</li>
  221. <li>Enable more than one listener, and configure the listeners from
  222. the conents of the config file.</li>
  223. <li>Import libraries, and set properties.</li>
  224. <li>Execute tasks.</li>
  225. <li>Install and configure runtime services.</li>
  226. </ul>
  227. </li>
  228. </ul>
  229. </blockquote>
  230. </td></tr>
  231. </table>
  232. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  233. <tr><td bgcolor="#828DA6">
  234. <font color="#ffffff" face="arial,helvetica,sanserif">
  235. <a name="Scripting"><strong>Scripting</strong></a>
  236. </font>
  237. </td></tr>
  238. <tr><td>
  239. <blockquote>
  240. <p>Add the ability to extend Ant using languages other than
  241. Java:</p>
  242. <ul>
  243. <li>Define a task using a scripting language such as Javascript.</li>
  244. <li>Use Rhino's ability to implement Java interfaces, to
  245. implement and define types, such as FileSelector, or
  246. Condition.</li>
  247. <li>Define a task using template.</li>
  248. <li>Add some lightweight scripting tasks.</li>
  249. </ul>
  250. </blockquote>
  251. </td></tr>
  252. </table>
  253. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  254. <tr><td bgcolor="#828DA6">
  255. <font color="#ffffff" face="arial,helvetica,sanserif">
  256. <a name="Documentation"><strong>Documentation</strong></a>
  257. </font>
  258. </td></tr>
  259. <tr><td>
  260. <blockquote>
  261. <p>Everyone loves writing documentation, and so a goal for Ant 2 is to
  262. generate a lot of reference documentation for tasks and other types directly
  263. from the source. Unfortunately, there's still plenty of tutorial material
  264. to write. In particular we need these:</p>
  265. <ul>
  266. <li>User documentation - describing things like the build file format,
  267. how properties work, how to use references, how sub-builds work, how to customise
  268. Myrmidon, and so on.</li>
  269. <li>Task writer documentation - describing things like an overview the task API,
  270. how configuration works, task lifecycle, how to assemble an antlib, a catalog
  271. of the runtime services, and so on.</li>
  272. <li>Myrmidon developer documentation - a broad outline of the architecture,
  273. how to build, how to test, and so on. Also, this todo list needs plenty
  274. of filling out.</li>
  275. </ul>
  276. </blockquote>
  277. </td></tr>
  278. </table>
  279. <table border="0" cellspacing="0" cellpadding="2" width="100%">
  280. <tr><td bgcolor="#828DA6">
  281. <font color="#ffffff" face="arial,helvetica,sanserif">
  282. <a name="Miscellaneous"><strong>Miscellaneous</strong></a>
  283. </font>
  284. </td></tr>
  285. <tr><td>
  286. <blockquote>
  287. <p>A completely unordered list of items, big and small:</p>
  288. <ul>
  289. <li>Search through the code for 'TODO' items and fix them.</li>
  290. <li>Tidy-up CLIMain so that it calls System.exit() with a non-zero exit code,
  291. if the build fails.</li>
  292. <li>Tidy-up the 'build failed' message, so that the stack trace is only
  293. printed out if the log level is verbose/debug.</li>
  294. <li>Allow service factories to be configured from the contents of the
  295. <code>ant-services.xml</code> descriptor.</li>
  296. <li>Route external process stdout and stderr through the logger.</li>
  297. <li>Add verbosity level to ProjectListener LogEvent</li>
  298. <li>Fire ProjectListener events taskFinished(), targetFinished() and
  299. projectFinished() events on build failure, adding indicator methods to
  300. ProjectEvent.</li>
  301. <li>Fire ProjectListener events projectStarted() and projectFinished()
  302. events on start and finish of referenced projects, adding indicator methods
  303. to ProjectEvent.</li>
  304. <li>Convert PropertyUtil to a non-static PropertyResolver service.</li>
  305. <li>Validate project and target names in DefaultProjectBuilder - reject dodgy
  306. names like "," or "", or " ". Probably want to exclude names that start or
  307. end with white-space (though internal whitespace is probably fine). We also
  308. want to reserve certain punctuation characters like . , : ? [ ] { }, etc for
  309. future use.</li>
  310. <li>Similarly, validate property names, using the same rules.</li>
  311. <li>Detect duplicate type names.</li>
  312. <li>Add fully qualified type names, based on antlib name and type shorthand name.
  313. Allow these to be used in build files in addition to the shorthand names.</li>
  314. <li>Move the <code>&lt;http&gt;</code> and <code>&lt;socket&gt;</code>
  315. conditions to an antlib. Need to resolve how these will be passed a logger.</li>
  316. <li>Make the <code>&lt;uptodate&gt;</code> task a condition, and move to
  317. an antlib.</li>
  318. <li>Split up <code>&lt;is-set&gt;</code> condition into is-set and is-true conditions.</li>
  319. <li>Allow the <code>&lt;if&gt;</code> task to take any condition implementation.</li>
  320. <li>Unit tests.</li>
  321. </ul>
  322. </blockquote>
  323. </td></tr>
  324. </table>
  325. </blockquote>
  326. </td></tr>
  327. </table>
  328. </td>
  329. </tr>
  330. <!-- FOOTER -->
  331. <tr><td colspan="2">
  332. <hr noshade="" size="1"/>
  333. </td></tr>
  334. <tr><td colspan="2">
  335. <div align="center"><font color="#525D76" size="-1"><em>
  336. Copyright &#169; 2000-2002, Apache Software Foundation
  337. </em></font></div>
  338. </td></tr>
  339. </table>
  340. </body>
  341. </html>
  342. <!-- end the processing -->