rio 0.3.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (395) hide show
  1. data/COPYING +340 -0
  2. data/ChangeLog +755 -0
  3. data/README +65 -0
  4. data/RUNME.1st.rb +75 -0
  5. data/Rakefile +312 -0
  6. data/VERSION +1 -0
  7. data/doc/README_MSWIN32.txt +39 -0
  8. data/doc/RELEASE_NOTES +130 -0
  9. data/doc/generators/template/html/rio.rb +895 -0
  10. data/doc/rdoc/classes/Kernel.html +181 -0
  11. data/doc/rdoc/classes/Kernel.src/M000183.html +18 -0
  12. data/doc/rdoc/classes/RIO.html +508 -0
  13. data/doc/rdoc/classes/RIO.src/M000001.html +18 -0
  14. data/doc/rdoc/classes/RIO.src/M000002.html +18 -0
  15. data/doc/rdoc/classes/RIO.src/M000003.html +18 -0
  16. data/doc/rdoc/classes/RIO/Doc.html +138 -0
  17. data/doc/rdoc/classes/RIO/Doc/HOWTO.html +1031 -0
  18. data/doc/rdoc/classes/RIO/Doc/INTRO.html +1116 -0
  19. data/doc/rdoc/classes/RIO/Doc/MISC.html +443 -0
  20. data/doc/rdoc/classes/RIO/Doc/SYNOPSIS.html +325 -0
  21. data/doc/rdoc/classes/RIO/Rio.html +6333 -0
  22. data/doc/rdoc/classes/RIO/Rio.src/M000004.html +18 -0
  23. data/doc/rdoc/classes/RIO/Rio.src/M000005.html +20 -0
  24. data/doc/rdoc/classes/RIO/Rio.src/M000006.html +27 -0
  25. data/doc/rdoc/classes/RIO/Rio.src/M000007.html +27 -0
  26. data/doc/rdoc/classes/RIO/Rio.src/M000008.html +16 -0
  27. data/doc/rdoc/classes/RIO/Rio.src/M000009.html +18 -0
  28. data/doc/rdoc/classes/RIO/Rio.src/M000010.html +20 -0
  29. data/doc/rdoc/classes/RIO/Rio.src/M000011.html +16 -0
  30. data/doc/rdoc/classes/RIO/Rio.src/M000012.html +16 -0
  31. data/doc/rdoc/classes/RIO/Rio.src/M000013.html +16 -0
  32. data/doc/rdoc/classes/RIO/Rio.src/M000014.html +16 -0
  33. data/doc/rdoc/classes/RIO/Rio.src/M000015.html +16 -0
  34. data/doc/rdoc/classes/RIO/Rio.src/M000016.html +16 -0
  35. data/doc/rdoc/classes/RIO/Rio.src/M000017.html +16 -0
  36. data/doc/rdoc/classes/RIO/Rio.src/M000018.html +16 -0
  37. data/doc/rdoc/classes/RIO/Rio.src/M000019.html +16 -0
  38. data/doc/rdoc/classes/RIO/Rio.src/M000020.html +16 -0
  39. data/doc/rdoc/classes/RIO/Rio.src/M000021.html +16 -0
  40. data/doc/rdoc/classes/RIO/Rio.src/M000022.html +16 -0
  41. data/doc/rdoc/classes/RIO/Rio.src/M000023.html +16 -0
  42. data/doc/rdoc/classes/RIO/Rio.src/M000024.html +16 -0
  43. data/doc/rdoc/classes/RIO/Rio.src/M000025.html +16 -0
  44. data/doc/rdoc/classes/RIO/Rio.src/M000026.html +16 -0
  45. data/doc/rdoc/classes/RIO/Rio.src/M000027.html +16 -0
  46. data/doc/rdoc/classes/RIO/Rio.src/M000028.html +16 -0
  47. data/doc/rdoc/classes/RIO/Rio.src/M000029.html +16 -0
  48. data/doc/rdoc/classes/RIO/Rio.src/M000030.html +16 -0
  49. data/doc/rdoc/classes/RIO/Rio.src/M000031.html +16 -0
  50. data/doc/rdoc/classes/RIO/Rio.src/M000032.html +16 -0
  51. data/doc/rdoc/classes/RIO/Rio.src/M000033.html +16 -0
  52. data/doc/rdoc/classes/RIO/Rio.src/M000034.html +16 -0
  53. data/doc/rdoc/classes/RIO/Rio.src/M000035.html +16 -0
  54. data/doc/rdoc/classes/RIO/Rio.src/M000036.html +16 -0
  55. data/doc/rdoc/classes/RIO/Rio.src/M000037.html +16 -0
  56. data/doc/rdoc/classes/RIO/Rio.src/M000038.html +16 -0
  57. data/doc/rdoc/classes/RIO/Rio.src/M000039.html +16 -0
  58. data/doc/rdoc/classes/RIO/Rio.src/M000040.html +16 -0
  59. data/doc/rdoc/classes/RIO/Rio.src/M000041.html +16 -0
  60. data/doc/rdoc/classes/RIO/Rio.src/M000042.html +16 -0
  61. data/doc/rdoc/classes/RIO/Rio.src/M000043.html +16 -0
  62. data/doc/rdoc/classes/RIO/Rio.src/M000044.html +16 -0
  63. data/doc/rdoc/classes/RIO/Rio.src/M000045.html +16 -0
  64. data/doc/rdoc/classes/RIO/Rio.src/M000046.html +16 -0
  65. data/doc/rdoc/classes/RIO/Rio.src/M000047.html +16 -0
  66. data/doc/rdoc/classes/RIO/Rio.src/M000048.html +16 -0
  67. data/doc/rdoc/classes/RIO/Rio.src/M000049.html +16 -0
  68. data/doc/rdoc/classes/RIO/Rio.src/M000050.html +16 -0
  69. data/doc/rdoc/classes/RIO/Rio.src/M000051.html +16 -0
  70. data/doc/rdoc/classes/RIO/Rio.src/M000052.html +16 -0
  71. data/doc/rdoc/classes/RIO/Rio.src/M000053.html +16 -0
  72. data/doc/rdoc/classes/RIO/Rio.src/M000054.html +16 -0
  73. data/doc/rdoc/classes/RIO/Rio.src/M000055.html +16 -0
  74. data/doc/rdoc/classes/RIO/Rio.src/M000056.html +16 -0
  75. data/doc/rdoc/classes/RIO/Rio.src/M000057.html +16 -0
  76. data/doc/rdoc/classes/RIO/Rio.src/M000058.html +16 -0
  77. data/doc/rdoc/classes/RIO/Rio.src/M000059.html +16 -0
  78. data/doc/rdoc/classes/RIO/Rio.src/M000060.html +16 -0
  79. data/doc/rdoc/classes/RIO/Rio.src/M000061.html +16 -0
  80. data/doc/rdoc/classes/RIO/Rio.src/M000062.html +16 -0
  81. data/doc/rdoc/classes/RIO/Rio.src/M000063.html +16 -0
  82. data/doc/rdoc/classes/RIO/Rio.src/M000064.html +16 -0
  83. data/doc/rdoc/classes/RIO/Rio.src/M000065.html +16 -0
  84. data/doc/rdoc/classes/RIO/Rio.src/M000066.html +16 -0
  85. data/doc/rdoc/classes/RIO/Rio.src/M000067.html +16 -0
  86. data/doc/rdoc/classes/RIO/Rio.src/M000068.html +16 -0
  87. data/doc/rdoc/classes/RIO/Rio.src/M000069.html +16 -0
  88. data/doc/rdoc/classes/RIO/Rio.src/M000070.html +16 -0
  89. data/doc/rdoc/classes/RIO/Rio.src/M000071.html +16 -0
  90. data/doc/rdoc/classes/RIO/Rio.src/M000072.html +16 -0
  91. data/doc/rdoc/classes/RIO/Rio.src/M000073.html +16 -0
  92. data/doc/rdoc/classes/RIO/Rio.src/M000074.html +16 -0
  93. data/doc/rdoc/classes/RIO/Rio.src/M000075.html +16 -0
  94. data/doc/rdoc/classes/RIO/Rio.src/M000076.html +16 -0
  95. data/doc/rdoc/classes/RIO/Rio.src/M000077.html +16 -0
  96. data/doc/rdoc/classes/RIO/Rio.src/M000078.html +16 -0
  97. data/doc/rdoc/classes/RIO/Rio.src/M000079.html +16 -0
  98. data/doc/rdoc/classes/RIO/Rio.src/M000080.html +16 -0
  99. data/doc/rdoc/classes/RIO/Rio.src/M000081.html +16 -0
  100. data/doc/rdoc/classes/RIO/Rio.src/M000082.html +16 -0
  101. data/doc/rdoc/classes/RIO/Rio.src/M000083.html +16 -0
  102. data/doc/rdoc/classes/RIO/Rio.src/M000084.html +16 -0
  103. data/doc/rdoc/classes/RIO/Rio.src/M000085.html +16 -0
  104. data/doc/rdoc/classes/RIO/Rio.src/M000086.html +16 -0
  105. data/doc/rdoc/classes/RIO/Rio.src/M000087.html +16 -0
  106. data/doc/rdoc/classes/RIO/Rio.src/M000088.html +16 -0
  107. data/doc/rdoc/classes/RIO/Rio.src/M000089.html +16 -0
  108. data/doc/rdoc/classes/RIO/Rio.src/M000090.html +16 -0
  109. data/doc/rdoc/classes/RIO/Rio.src/M000091.html +16 -0
  110. data/doc/rdoc/classes/RIO/Rio.src/M000092.html +16 -0
  111. data/doc/rdoc/classes/RIO/Rio.src/M000093.html +16 -0
  112. data/doc/rdoc/classes/RIO/Rio.src/M000094.html +16 -0
  113. data/doc/rdoc/classes/RIO/Rio.src/M000095.html +16 -0
  114. data/doc/rdoc/classes/RIO/Rio.src/M000096.html +16 -0
  115. data/doc/rdoc/classes/RIO/Rio.src/M000097.html +16 -0
  116. data/doc/rdoc/classes/RIO/Rio.src/M000098.html +16 -0
  117. data/doc/rdoc/classes/RIO/Rio.src/M000099.html +16 -0
  118. data/doc/rdoc/classes/RIO/Rio.src/M000100.html +16 -0
  119. data/doc/rdoc/classes/RIO/Rio.src/M000101.html +16 -0
  120. data/doc/rdoc/classes/RIO/Rio.src/M000102.html +16 -0
  121. data/doc/rdoc/classes/RIO/Rio.src/M000103.html +16 -0
  122. data/doc/rdoc/classes/RIO/Rio.src/M000104.html +16 -0
  123. data/doc/rdoc/classes/RIO/Rio.src/M000105.html +16 -0
  124. data/doc/rdoc/classes/RIO/Rio.src/M000106.html +16 -0
  125. data/doc/rdoc/classes/RIO/Rio.src/M000107.html +16 -0
  126. data/doc/rdoc/classes/RIO/Rio.src/M000108.html +16 -0
  127. data/doc/rdoc/classes/RIO/Rio.src/M000109.html +16 -0
  128. data/doc/rdoc/classes/RIO/Rio.src/M000110.html +16 -0
  129. data/doc/rdoc/classes/RIO/Rio.src/M000111.html +16 -0
  130. data/doc/rdoc/classes/RIO/Rio.src/M000112.html +16 -0
  131. data/doc/rdoc/classes/RIO/Rio.src/M000113.html +16 -0
  132. data/doc/rdoc/classes/RIO/Rio.src/M000114.html +16 -0
  133. data/doc/rdoc/classes/RIO/Rio.src/M000115.html +16 -0
  134. data/doc/rdoc/classes/RIO/Rio.src/M000116.html +16 -0
  135. data/doc/rdoc/classes/RIO/Rio.src/M000117.html +16 -0
  136. data/doc/rdoc/classes/RIO/Rio.src/M000118.html +16 -0
  137. data/doc/rdoc/classes/RIO/Rio.src/M000119.html +16 -0
  138. data/doc/rdoc/classes/RIO/Rio.src/M000120.html +16 -0
  139. data/doc/rdoc/classes/RIO/Rio.src/M000121.html +16 -0
  140. data/doc/rdoc/classes/RIO/Rio.src/M000122.html +16 -0
  141. data/doc/rdoc/classes/RIO/Rio.src/M000123.html +16 -0
  142. data/doc/rdoc/classes/RIO/Rio.src/M000124.html +16 -0
  143. data/doc/rdoc/classes/RIO/Rio.src/M000125.html +16 -0
  144. data/doc/rdoc/classes/RIO/Rio.src/M000126.html +16 -0
  145. data/doc/rdoc/classes/RIO/Rio.src/M000127.html +16 -0
  146. data/doc/rdoc/classes/RIO/Rio.src/M000128.html +16 -0
  147. data/doc/rdoc/classes/RIO/Rio.src/M000129.html +16 -0
  148. data/doc/rdoc/classes/RIO/Rio.src/M000130.html +16 -0
  149. data/doc/rdoc/classes/RIO/Rio.src/M000131.html +16 -0
  150. data/doc/rdoc/classes/RIO/Rio.src/M000132.html +16 -0
  151. data/doc/rdoc/classes/RIO/Rio.src/M000133.html +16 -0
  152. data/doc/rdoc/classes/RIO/Rio.src/M000134.html +16 -0
  153. data/doc/rdoc/classes/RIO/Rio.src/M000135.html +16 -0
  154. data/doc/rdoc/classes/RIO/Rio.src/M000136.html +16 -0
  155. data/doc/rdoc/classes/RIO/Rio.src/M000137.html +16 -0
  156. data/doc/rdoc/classes/RIO/Rio.src/M000138.html +16 -0
  157. data/doc/rdoc/classes/RIO/Rio.src/M000139.html +16 -0
  158. data/doc/rdoc/classes/RIO/Rio.src/M000140.html +16 -0
  159. data/doc/rdoc/classes/RIO/Rio.src/M000141.html +16 -0
  160. data/doc/rdoc/classes/RIO/Rio.src/M000142.html +16 -0
  161. data/doc/rdoc/classes/RIO/Rio.src/M000143.html +16 -0
  162. data/doc/rdoc/classes/RIO/Rio.src/M000144.html +16 -0
  163. data/doc/rdoc/classes/RIO/Rio.src/M000145.html +16 -0
  164. data/doc/rdoc/classes/RIO/Rio.src/M000146.html +16 -0
  165. data/doc/rdoc/classes/RIO/Rio.src/M000147.html +16 -0
  166. data/doc/rdoc/classes/RIO/Rio.src/M000148.html +16 -0
  167. data/doc/rdoc/classes/RIO/Rio.src/M000149.html +16 -0
  168. data/doc/rdoc/classes/RIO/Rio.src/M000150.html +16 -0
  169. data/doc/rdoc/classes/RIO/Rio.src/M000151.html +16 -0
  170. data/doc/rdoc/classes/RIO/Rio.src/M000152.html +16 -0
  171. data/doc/rdoc/classes/RIO/Rio.src/M000153.html +16 -0
  172. data/doc/rdoc/classes/RIO/Rio.src/M000154.html +16 -0
  173. data/doc/rdoc/classes/RIO/Rio.src/M000155.html +16 -0
  174. data/doc/rdoc/classes/RIO/Rio.src/M000156.html +16 -0
  175. data/doc/rdoc/classes/RIO/Rio.src/M000157.html +16 -0
  176. data/doc/rdoc/classes/RIO/Rio.src/M000158.html +16 -0
  177. data/doc/rdoc/classes/RIO/Rio.src/M000159.html +16 -0
  178. data/doc/rdoc/classes/RIO/Rio.src/M000160.html +16 -0
  179. data/doc/rdoc/classes/RIO/Rio.src/M000161.html +16 -0
  180. data/doc/rdoc/classes/RIO/Rio.src/M000162.html +16 -0
  181. data/doc/rdoc/classes/RIO/Rio.src/M000163.html +16 -0
  182. data/doc/rdoc/classes/RIO/Rio.src/M000164.html +16 -0
  183. data/doc/rdoc/classes/RIO/Rio.src/M000165.html +16 -0
  184. data/doc/rdoc/classes/RIO/Rio.src/M000166.html +16 -0
  185. data/doc/rdoc/classes/RIO/Rio.src/M000167.html +16 -0
  186. data/doc/rdoc/classes/RIO/Rio.src/M000168.html +16 -0
  187. data/doc/rdoc/classes/RIO/Rio.src/M000169.html +16 -0
  188. data/doc/rdoc/classes/RIO/Rio.src/M000170.html +16 -0
  189. data/doc/rdoc/classes/RIO/Rio.src/M000171.html +16 -0
  190. data/doc/rdoc/classes/RIO/Rio.src/M000172.html +16 -0
  191. data/doc/rdoc/classes/RIO/Rio.src/M000173.html +16 -0
  192. data/doc/rdoc/classes/RIO/Rio.src/M000174.html +16 -0
  193. data/doc/rdoc/classes/RIO/Rio.src/M000175.html +16 -0
  194. data/doc/rdoc/classes/RIO/Rio.src/M000176.html +16 -0
  195. data/doc/rdoc/classes/RIO/Rio.src/M000177.html +16 -0
  196. data/doc/rdoc/classes/RIO/Rio.src/M000178.html +16 -0
  197. data/doc/rdoc/classes/RIO/Rio.src/M000179.html +16 -0
  198. data/doc/rdoc/classes/RIO/Rio.src/M000180.html +16 -0
  199. data/doc/rdoc/classes/RIO/Rio.src/M000181.html +16 -0
  200. data/doc/rdoc/classes/RIO/Rio.src/M000182.html +16 -0
  201. data/doc/rdoc/created.rid +1 -0
  202. data/doc/rdoc/files/README.html +215 -0
  203. data/doc/rdoc/files/lib/rio/constructor_rb.html +142 -0
  204. data/doc/rdoc/files/lib/rio/doc/HOWTO_rb.html +135 -0
  205. data/doc/rdoc/files/lib/rio/doc/INTRO_rb.html +135 -0
  206. data/doc/rdoc/files/lib/rio/doc/MISC_rb.html +135 -0
  207. data/doc/rdoc/files/lib/rio/doc/SYNOPSIS_rb.html +135 -0
  208. data/doc/rdoc/files/lib/rio/if/basic_rb.html +135 -0
  209. data/doc/rdoc/files/lib/rio/if/dir_rb.html +135 -0
  210. data/doc/rdoc/files/lib/rio/if/file_rb.html +135 -0
  211. data/doc/rdoc/files/lib/rio/if/fileordir_rb.html +135 -0
  212. data/doc/rdoc/files/lib/rio/if/grande_rb.html +135 -0
  213. data/doc/rdoc/files/lib/rio/if/internal_rb.html +135 -0
  214. data/doc/rdoc/files/lib/rio/if/methods_rb.html +135 -0
  215. data/doc/rdoc/files/lib/rio/if/path_rb.html +135 -0
  216. data/doc/rdoc/files/lib/rio/if/stream_rb.html +135 -0
  217. data/doc/rdoc/files/lib/rio/if/test_rb.html +135 -0
  218. data/doc/rdoc/files/lib/rio/kernel_rb.html +142 -0
  219. data/doc/rdoc/files/lib/rio_rb.html +153 -0
  220. data/doc/rdoc/fr_class_index.html +34 -0
  221. data/doc/rdoc/fr_file_index.html +44 -0
  222. data/doc/rdoc/fr_method_index.html +210 -0
  223. data/doc/rdoc/index.html +24 -0
  224. data/doc/rdoc/rdoc-style.css +384 -0
  225. data/doc/rfc1738.txt +1403 -0
  226. data/doc/rfc959.txt +3933 -0
  227. data/ex/colx.rb +6 -0
  228. data/ex/findinruby +19 -0
  229. data/ex/findruby +11 -0
  230. data/ex/prompt.rb +25 -0
  231. data/ex/rgb.txt.gz +0 -0
  232. data/ex/riocat +35 -0
  233. data/ex/riogunzip +31 -0
  234. data/ex/riogzip +24 -0
  235. data/ex/tolf +11 -0
  236. data/lib/rio.rb +163 -0
  237. data/lib/rio/abstract_method.rb +57 -0
  238. data/lib/rio/argv.rb +57 -0
  239. data/lib/rio/arrayio.rb +199 -0
  240. data/lib/rio/arycopy.rb +44 -0
  241. data/lib/rio/assert.rb +115 -0
  242. data/lib/rio/base.rb +59 -0
  243. data/lib/rio/constructor.rb +183 -0
  244. data/lib/rio/context.rb +117 -0
  245. data/lib/rio/context/chomp.rb +53 -0
  246. data/lib/rio/context/closeoneof.rb +50 -0
  247. data/lib/rio/context/cxx.rb +67 -0
  248. data/lib/rio/context/dir.rb +92 -0
  249. data/lib/rio/context/gzip.rb +51 -0
  250. data/lib/rio/context/methods.rb +196 -0
  251. data/lib/rio/context/stream.rb +170 -0
  252. data/lib/rio/cp.rb +305 -0
  253. data/lib/rio/cxdir.rb +79 -0
  254. data/lib/rio/dir.rb +145 -0
  255. data/lib/rio/doc.rb +45 -0
  256. data/lib/rio/doc/HOWTO.rb +691 -0
  257. data/lib/rio/doc/INTRO.rb +579 -0
  258. data/lib/rio/doc/MISC.rb +257 -0
  259. data/lib/rio/doc/SYNOPSIS.rb +170 -0
  260. data/lib/rio/entrysel.rb +162 -0
  261. data/lib/rio/exception.rb +42 -0
  262. data/lib/rio/exception/copy.rb +98 -0
  263. data/lib/rio/exception/open.rb +62 -0
  264. data/lib/rio/exception/state.rb +74 -0
  265. data/lib/rio/ext.rb +62 -0
  266. data/lib/rio/ext/csv.rb +261 -0
  267. data/lib/rio/factory.rb +236 -0
  268. data/lib/rio/file.rb +77 -0
  269. data/lib/rio/filter/chomp.rb +61 -0
  270. data/lib/rio/filter/closeoneof.rb +103 -0
  271. data/lib/rio/filter/gzip.rb +58 -0
  272. data/lib/rio/ftp.rb +275 -0
  273. data/lib/rio/ftp/conn.rb +167 -0
  274. data/lib/rio/ftp/ioh.rb +88 -0
  275. data/lib/rio/grande.rb +126 -0
  276. data/lib/rio/handle.rb +101 -0
  277. data/lib/rio/if.rb +53 -0
  278. data/lib/rio/if/basic.rb +64 -0
  279. data/lib/rio/if/dir.rb +362 -0
  280. data/lib/rio/if/file.rb +57 -0
  281. data/lib/rio/if/fileordir.rb +247 -0
  282. data/lib/rio/if/grande.rb +510 -0
  283. data/lib/rio/if/internal.rb +53 -0
  284. data/lib/rio/if/methods.rb +612 -0
  285. data/lib/rio/if/path.rb +413 -0
  286. data/lib/rio/if/stream.rb +599 -0
  287. data/lib/rio/if/test.rb +219 -0
  288. data/lib/rio/impl/path.rb +82 -0
  289. data/lib/rio/ioh.rb +137 -0
  290. data/lib/rio/iomode.rb +96 -0
  291. data/lib/rio/kernel.rb +47 -0
  292. data/lib/rio/local.rb +63 -0
  293. data/lib/rio/match.rb +51 -0
  294. data/lib/rio/matchrecord.rb +254 -0
  295. data/lib/rio/open3.rb +69 -0
  296. data/lib/rio/ops/create.rb +78 -0
  297. data/lib/rio/ops/dir.rb +302 -0
  298. data/lib/rio/ops/either.rb +117 -0
  299. data/lib/rio/ops/file.rb +94 -0
  300. data/lib/rio/ops/path.rb +292 -0
  301. data/lib/rio/ops/stream.rb +84 -0
  302. data/lib/rio/ops/stream/input.rb +237 -0
  303. data/lib/rio/ops/stream/output.rb +96 -0
  304. data/lib/rio/ops/stream/read.rb +84 -0
  305. data/lib/rio/ops/stream/write.rb +58 -0
  306. data/lib/rio/ops/symlink.rb +70 -0
  307. data/lib/rio/path.rb +117 -0
  308. data/lib/rio/path/reset.rb +70 -0
  309. data/lib/rio/record.rb +59 -0
  310. data/lib/rio/rectype.rb +86 -0
  311. data/lib/rio/rl/base.rb +147 -0
  312. data/lib/rio/rl/builder.rb +166 -0
  313. data/lib/rio/rl/ioi.rb +66 -0
  314. data/lib/rio/rl/path.rb +141 -0
  315. data/lib/rio/rl/uri.rb +118 -0
  316. data/lib/rio/scheme/aryio.rb +89 -0
  317. data/lib/rio/scheme/cmdio.rb +74 -0
  318. data/lib/rio/scheme/fd.rb +65 -0
  319. data/lib/rio/scheme/ftp.rb +73 -0
  320. data/lib/rio/scheme/http.rb +81 -0
  321. data/lib/rio/scheme/path.rb +100 -0
  322. data/lib/rio/scheme/stderr.rb +56 -0
  323. data/lib/rio/scheme/stdio.rb +71 -0
  324. data/lib/rio/scheme/strio.rb +82 -0
  325. data/lib/rio/scheme/sysio.rb +61 -0
  326. data/lib/rio/scheme/tcp.rb +74 -0
  327. data/lib/rio/scheme/tempfile.rb +104 -0
  328. data/lib/rio/state.rb +209 -0
  329. data/lib/rio/state/error.rb +73 -0
  330. data/lib/rio/stream.rb +181 -0
  331. data/lib/rio/stream/base.rb +50 -0
  332. data/lib/rio/stream/duplex.rb +76 -0
  333. data/lib/rio/stream/open.rb +203 -0
  334. data/lib/rio/symantics.rb +46 -0
  335. data/lib/rio/to_rio.rb +57 -0
  336. data/lib/rio/uri/file.rb +145 -0
  337. data/lib/rio/version.rb +52 -0
  338. data/setup.rb +1331 -0
  339. data/test/1.rb +14 -0
  340. data/test/mswin32.rb +28 -0
  341. data/test/once.rb +7 -0
  342. data/test/runtests.rb +12 -0
  343. data/test/runtests_gem.rb +15 -0
  344. data/test/tc/abs.rb +349 -0
  345. data/test/tc/all.rb +42 -0
  346. data/test/tc/cd1.rb +116 -0
  347. data/test/tc/clearsel.rb +69 -0
  348. data/test/tc/closeoncopy.rb +91 -0
  349. data/test/tc/closeoneof.rb +194 -0
  350. data/test/tc/copy-from.rb +183 -0
  351. data/test/tc/copy-to.rb +94 -0
  352. data/test/tc/copy.rb +72 -0
  353. data/test/tc/copyarray.rb +191 -0
  354. data/test/tc/copydest.rb +50 -0
  355. data/test/tc/copydir.rb +192 -0
  356. data/test/tc/copydirlines.rb +124 -0
  357. data/test/tc/copylines.rb +40 -0
  358. data/test/tc/copynonex.rb +121 -0
  359. data/test/tc/create.rb +104 -0
  360. data/test/tc/csv.rb +229 -0
  361. data/test/tc/dir.rb +79 -0
  362. data/test/tc/dirautoclose.rb +70 -0
  363. data/test/tc/dirent.rb +180 -0
  364. data/test/tc/dirss.rb +84 -0
  365. data/test/tc/each.rb +111 -0
  366. data/test/tc/each_break.rb +241 -0
  367. data/test/tc/edf.rb +82 -0
  368. data/test/tc/entary.rb +230 -0
  369. data/test/tc/eq.rb +101 -0
  370. data/test/tc/expand_path.rb +94 -0
  371. data/test/tc/ext.rb +115 -0
  372. data/test/tc/fileno.rb +95 -0
  373. data/test/tc/getrec.rb +140 -0
  374. data/test/tc/lineno.rb +197 -0
  375. data/test/tc/lines.rb +66 -0
  376. data/test/tc/methods.rb +185 -0
  377. data/test/tc/misc.rb +473 -0
  378. data/test/tc/nolines.rb +205 -0
  379. data/test/tc/noqae.rb +873 -0
  380. data/test/tc/once.rb +6 -0
  381. data/test/tc/overload.rb +137 -0
  382. data/test/tc/pa.rb +159 -0
  383. data/test/tc/pathop.rb +63 -0
  384. data/test/tc/paths.rb +147 -0
  385. data/test/tc/qae.rb +494 -0
  386. data/test/tc/qae_riovar.rb +500 -0
  387. data/test/tc/records.rb +69 -0
  388. data/test/tc/rename.rb +224 -0
  389. data/test/tc/rename_assign.rb +48 -0
  390. data/test/tc/sub.rb +49 -0
  391. data/test/tc/symlink.rb +177 -0
  392. data/test/tc/symlink0.rb +298 -0
  393. data/test/tc/symlink1.rb +115 -0
  394. data/test/tc/testcase.rb +152 -0
  395. metadata +461 -0
data/doc/rdoc/classes/Kernel.html ADDED
@@ -0,0 +1,181 @@
1
+ <?xml version="1.0" encoding="iso-8859-1"?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
+
6
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
+ <head>
8
+ <title>Module: Kernel</title>
9
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
+ <meta http-equiv="Content-Script-Type" content="text/javascript" />
11
+ <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
12
+ <script type="text/javascript">
13
+ // <![CDATA[
14
+
15
+ function popupCode( url ) {
16
+ window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
17
+ }
18
+
19
+ function toggleCode( id ) {
20
+ if ( document.getElementById )
21
+ elem = document.getElementById( id );
22
+ else if ( document.all )
23
+ elem = eval( "document.all." + id );
24
+ else
25
+ return false;
26
+
27
+ elemStyle = elem.style;
28
+
29
+ if ( elemStyle.display != "block" ) {
30
+ elemStyle.display = "block"
31
+ } else {
32
+ elemStyle.display = "none"
33
+ }
34
+
35
+ return true;
36
+ }
37
+
38
+ // Make codeblocks hidden by default
39
+ document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
40
+
41
+ // ]]>
42
+ </script>
43
+
44
+ </head>
45
+ <body>
46
+
47
+
48
+
49
+ <div id="classHeader">
50
+ <table class="header-table">
51
+ <tr class="top-aligned-row">
52
+ <td class="class-mod"><strong>Module</strong></td>
53
+ <td class="class-name-in-header">Kernel</td>
54
+ <td rowspan="2" class="class-header-space-col"></td>
55
+ <td rowspan="2">
56
+ <a class="in-url" href="../files/lib/rio/kernel_rb.html">
57
+ lib/rio/kernel.rb
58
+ </a>
59
+ &nbsp;&nbsp;
60
+ </td>
61
+ </tr>
62
+
63
+ </table>
64
+ </div>
65
+ <!-- banner header -->
66
+
67
+ <div id="bodyContent">
68
+
69
+
70
+
71
+ <div id="contextContent">
72
+
73
+ <div id="description">
74
+ <p>
75
+ To create the documentation for Rio run the command
76
+ </p>
77
+ <pre>
78
+ rake rdoc
79
+ </pre>
80
+ <p>
81
+ from the distribution directory. Then point your browser at the
82
+ &#8216;doc/rdoc&#8217; directory.
83
+ </p>
84
+ <p>
85
+ Suggested Reading
86
+ </p>
87
+ <ul>
88
+ <li><a href="RIO/Doc/SYNOPSIS.html">RIO::Doc::SYNOPSIS</a>
89
+
90
+ </li>
91
+ <li><a href="RIO/Doc/INTRO.html">RIO::Doc::INTRO</a>
92
+
93
+ </li>
94
+ <li><a href="RIO/Doc/HOWTO.html">RIO::Doc::HOWTO</a>
95
+
96
+ </li>
97
+ <li><a href="RIO/Rio.html">RIO::Rio</a>
98
+
99
+ </li>
100
+ </ul>
101
+ <p>
102
+ <b>Rio is pre-alpha software. The documented interface and behavior is
103
+ subject to change without notice.</b>
104
+ </p>
105
+
106
+ </div>
107
+
108
+
109
+ </div>
110
+
111
+ <div id="method-list">
112
+ <h3 class="section-bar">Methods</h3>
113
+
114
+ <div class="name-list">
115
+ <a href="#M000184">io</a>&nbsp;&nbsp;
116
+ <a href="#M000183">rio</a>&nbsp;&nbsp;
117
+ </div>
118
+ </div>
119
+
120
+ </div>
121
+
122
+
123
+ <!-- if includes -->
124
+
125
+ <div id="section">
126
+
127
+
128
+
129
+
130
+
131
+
132
+
133
+
134
+ <!-- if method_list -->
135
+ <div id="methods">
136
+ <h3 class="section-bar">Public Instance methods</h3>
137
+
138
+ <div id="method-M000184" class="method-detail">
139
+ <a name="M000184"></a>
140
+
141
+ <div class="method-heading">
142
+ <span class="method-name">io</span><span class="method-args">(*args)</span>
143
+ </div>
144
+
145
+ <div class="method-description">
146
+ <p>
147
+ Alias for <a href="Kernel.html#M000183">rio</a>
148
+ </p>
149
+ </div>
150
+ </div>
151
+
152
+ <div id="method-M000183" class="method-detail">
153
+ <a name="M000183"></a>
154
+
155
+ <div class="method-heading">
156
+ <a href="Kernel.src/M000183.html" target="Code" class="method-signature"
157
+ onclick="popupCode('Kernel.src/M000183.html');return false;">
158
+ <span class="method-name">rio</span><span class="method-args">(*args) {|self| ...}</span>
159
+ </a>
160
+ </div>
161
+
162
+ <div class="method-description">
163
+ <p>
164
+ Shortcut for <a href="RIO.html#M000001">RIO.rio</a>
165
+ </p>
166
+ </div>
167
+ </div>
168
+
169
+
170
+ </div>
171
+
172
+
173
+ </div>
174
+
175
+
176
+ <div id="validator-badges">
177
+ <p><small>Copyright &copy; 2005 Christopher Kleckner. <a href="http://www.gnu.org/licenses/gpl.html">All rights reserved</a>.</small></p>
178
+ </div>
179
+
180
+ </body>
181
+ </html>
data/doc/rdoc/classes/Kernel.src/M000183.html ADDED
@@ -0,0 +1,18 @@
1
+ <?xml version="1.0" encoding="iso-8859-1"?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
+
6
+ <html>
7
+ <head>
8
+ <title>rio (Kernel)</title>
9
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
+ <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
11
+ </head>
12
+ <body class="standalone-code">
13
+ <pre> <span class="ruby-comment cmt"># File lib/rio/kernel.rb, line 42</span>
14
+ 42: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rio</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>,<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>) <span class="ruby-comment cmt"># :yields: self</span>
15
+ 43: <span class="ruby-constant">RIO</span><span class="ruby-operator">::</span><span class="ruby-constant">Rio</span>.<span class="ruby-identifier">rio</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>,<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
16
+ 44: <span class="ruby-keyword kw">end</span></pre>
17
+ </body>
18
+ </html>
data/doc/rdoc/classes/RIO.html ADDED
@@ -0,0 +1,508 @@
1
+ <?xml version="1.0" encoding="iso-8859-1"?>
2
+ <!DOCTYPE html
3
+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
+
6
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
+ <head>
8
+ <title>Module: RIO</title>
9
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
10
+ <meta http-equiv="Content-Script-Type" content="text/javascript" />
11
+ <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
12
+ <script type="text/javascript">
13
+ // <![CDATA[
14
+
15
+ function popupCode( url ) {
16
+ window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
17
+ }
18
+
19
+ function toggleCode( id ) {
20
+ if ( document.getElementById )
21
+ elem = document.getElementById( id );
22
+ else if ( document.all )
23
+ elem = eval( "document.all." + id );
24
+ else
25
+ return false;
26
+
27
+ elemStyle = elem.style;
28
+
29
+ if ( elemStyle.display != "block" ) {
30
+ elemStyle.display = "block"
31
+ } else {
32
+ elemStyle.display = "none"
33
+ }
34
+
35
+ return true;
36
+ }
37
+
38
+ // Make codeblocks hidden by default
39
+ document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
40
+
41
+ // ]]>
42
+ </script>
43
+
44
+ </head>
45
+ <body>
46
+
47
+
48
+
49
+ <div id="classHeader">
50
+ <table class="header-table">
51
+ <tr class="top-aligned-row">
52
+ <td class="class-mod"><strong>Module</strong></td>
53
+ <td class="class-name-in-header">RIO</td>
54
+ <td rowspan="2" class="class-header-space-col"></td>
55
+ <td rowspan="2">
56
+ <a class="in-url" href="../files/lib/rio_rb.html">
57
+ lib/rio.rb
58
+ </a>
59
+ &nbsp;&nbsp;
60
+ <a class="in-url" href="../files/lib/rio/doc/HOWTO_rb.html">
61
+ lib/rio/doc/HOWTO.rb
62
+ </a>
63
+ &nbsp;&nbsp;
64
+ <a class="in-url" href="../files/lib/rio/doc/INTRO_rb.html">
65
+ lib/rio/doc/INTRO.rb
66
+ </a>
67
+ &nbsp;&nbsp;
68
+ <a class="in-url" href="../files/lib/rio/doc/MISC_rb.html">
69
+ lib/rio/doc/MISC.rb
70
+ </a>
71
+ &nbsp;&nbsp;
72
+ <a class="in-url" href="../files/lib/rio/doc/SYNOPSIS_rb.html">
73
+ lib/rio/doc/SYNOPSIS.rb
74
+ </a>
75
+ &nbsp;&nbsp;
76
+ <a class="in-url" href="../files/lib/rio/if/basic_rb.html">
77
+ lib/rio/if/basic.rb
78
+ </a>
79
+ &nbsp;&nbsp;
80
+ <a class="in-url" href="../files/lib/rio/if/dir_rb.html">
81
+ lib/rio/if/dir.rb
82
+ </a>
83
+ &nbsp;&nbsp;
84
+ <a class="in-url" href="../files/lib/rio/if/file_rb.html">
85
+ lib/rio/if/file.rb
86
+ </a>
87
+ &nbsp;&nbsp;
88
+ <a class="in-url" href="../files/lib/rio/if/fileordir_rb.html">
89
+ lib/rio/if/fileordir.rb
90
+ </a>
91
+ &nbsp;&nbsp;
92
+ <a class="in-url" href="../files/lib/rio/if/grande_rb.html">
93
+ lib/rio/if/grande.rb
94
+ </a>
95
+ &nbsp;&nbsp;
96
+ <a class="in-url" href="../files/lib/rio/if/internal_rb.html">
97
+ lib/rio/if/internal.rb
98
+ </a>
99
+ &nbsp;&nbsp;
100
+ <a class="in-url" href="../files/lib/rio/if/methods_rb.html">
101
+ lib/rio/if/methods.rb
102
+ </a>
103
+ &nbsp;&nbsp;
104
+ <a class="in-url" href="../files/lib/rio/if/path_rb.html">
105
+ lib/rio/if/path.rb
106
+ </a>
107
+ &nbsp;&nbsp;
108
+ <a class="in-url" href="../files/lib/rio/if/stream_rb.html">
109
+ lib/rio/if/stream.rb
110
+ </a>
111
+ &nbsp;&nbsp;
112
+ <a class="in-url" href="../files/lib/rio/if/test_rb.html">
113
+ lib/rio/if/test.rb
114
+ </a>
115
+ &nbsp;&nbsp;
116
+ <a class="in-url" href="../files/lib/rio/constructor_rb.html">
117
+ lib/rio/constructor.rb
118
+ </a>
119
+ &nbsp;&nbsp;
120
+ </td>
121
+ </tr>
122
+
123
+ </table>
124
+ </div>
125
+ <!-- banner header -->
126
+
127
+ <div id="bodyContent">
128
+
129
+
130
+
131
+ <div id="contextContent">
132
+
133
+ <div id="description">
134
+ <p>
135
+ To create the documentation for <a href="RIO/Rio.html">Rio</a> run the
136
+ command
137
+ </p>
138
+ <pre>
139
+ rake rdoc
140
+ </pre>
141
+ <p>
142
+ from the distribution directory. Then point your browser at the
143
+ &#8216;doc/rdoc&#8217; directory.
144
+ </p>
145
+ <p>
146
+ Suggested Reading
147
+ </p>
148
+ <ul>
149
+ <li><a href="RIO/Doc/SYNOPSIS.html">RIO::Doc::SYNOPSIS</a>
150
+
151
+ </li>
152
+ <li><a href="RIO/Doc/INTRO.html">RIO::Doc::INTRO</a>
153
+
154
+ </li>
155
+ <li><a href="RIO/Doc/HOWTO.html">RIO::Doc::HOWTO</a>
156
+
157
+ </li>
158
+ <li><a href="RIO/Rio.html">RIO::Rio</a>
159
+
160
+ </li>
161
+ </ul>
162
+ <p>
163
+ <b><a href="RIO/Rio.html">Rio</a> is pre-alpha software. The documented
164
+ interface and behavior is subject to change without notice.</b>
165
+ </p>
166
+
167
+ </div>
168
+
169
+
170
+ </div>
171
+
172
+ <div id="method-list">
173
+ <h3 class="section-bar">Methods</h3>
174
+
175
+ <div class="name-list">
176
+ <a href="#M000002">cwd</a>&nbsp;&nbsp;
177
+ <a href="#M000001">rio</a>&nbsp;&nbsp;
178
+ <a href="#M000003">root</a>&nbsp;&nbsp;
179
+ </div>
180
+ </div>
181
+
182
+ </div>
183
+
184
+
185
+ <!-- if includes -->
186
+
187
+ <div id="section">
188
+
189
+ <div id="class-list">
190
+ <h3 class="section-bar">Classes and Modules</h3>
191
+
192
+ Module <a href="RIO/Doc.html" class="link">RIO::Doc</a><br />
193
+ Class <a href="RIO/Rio.html" class="link">RIO::Rio</a><br />
194
+
195
+ </div>
196
+
197
+ <div id="constants-list">
198
+ <h3 class="section-bar">Constants</h3>
199
+
200
+ <div class="name-list">
201
+ <table summary="Constants">
202
+ <tr class="top-aligned-row context-row">
203
+ <td class="context-item-name">SEEK_SET</td>
204
+ <td>=</td>
205
+ <td class="context-item-value">IO::SEEK_SET</td>
206
+ </tr>
207
+ <tr class="top-aligned-row context-row">
208
+ <td class="context-item-name">SEEK_END</td>
209
+ <td>=</td>
210
+ <td class="context-item-value">IO::SEEK_END</td>
211
+ </tr>
212
+ <tr class="top-aligned-row context-row">
213
+ <td class="context-item-name">SEEK_CUR</td>
214
+ <td>=</td>
215
+ <td class="context-item-value">IO::SEEK_CUR</td>
216
+ </tr>
217
+ </table>
218
+ </div>
219
+ </div>
220
+
221
+
222
+
223
+
224
+
225
+
226
+ <!-- if method_list -->
227
+ <div id="methods">
228
+ <h3 class="section-bar">Public Instance methods</h3>
229
+
230
+ <div id="method-M000002" class="method-detail">
231
+ <a name="M000002"></a>
232
+
233
+ <div class="method-heading">
234
+ <a href="RIO.src/M000002.html" target="Code" class="method-signature"
235
+ onclick="popupCode('RIO.src/M000002.html');return false;">
236
+ <span class="method-name">cwd</span><span class="method-args">(*args) {|self| ...}</span>
237
+ </a>
238
+ </div>
239
+
240
+ <div class="method-description">
241
+ <p>
242
+ Create a <a href="RIO/Rio.html">Rio</a> as with <a
243
+ href="RIO.html#M000001">RIO#rio</a> which refers to the current working
244
+ directory
245
+ </p>
246
+ <pre>
247
+ wd = RIO.cwd
248
+ </pre>
249
+ </div>
250
+ </div>
251
+
252
+ <div id="method-M000001" class="method-detail">
253
+ <a name="M000001"></a>
254
+
255
+ <div class="method-heading">
256
+ <a href="RIO.src/M000001.html" target="Code" class="method-signature"
257
+ onclick="popupCode('RIO.src/M000001.html');return false;">
258
+ <span class="method-name">rio</span><span class="method-args">(*args) {|self| ...}</span>
259
+ </a>
260
+ </div>
261
+
262
+ <div class="method-description">
263
+ <p>
264
+ <a href="RIO/Rio.html">Rio</a> Constructor
265
+ </p>
266
+ <p>
267
+ For purposes of discussion, we divide Rios into two catagories, those that
268
+ have a path and those that don&#8217;t.
269
+ </p>
270
+ <h4>Creating a <a href="RIO/Rio.html">Rio</a> that has a path</h4>
271
+ <p>
272
+ To create a <a href="RIO/Rio.html">Rio</a> that has a path the arguments to
273
+ <tt>rio</tt> may be:
274
+ </p>
275
+ <ul>
276
+ <li>a string representing the entire path. The separator used for Rios is as
277
+ specified in RFC1738 (&#8217;/&#8217;).
278
+
279
+ <pre>
280
+ rio('adir/afile')
281
+ </pre>
282
+ </li>
283
+ <li>a string representing a fully qualified <tt>file</tt> URL as per RFC1738
284
+
285
+ <pre>
286
+ rio('file:///atopleveldir/adir/afile')
287
+ </pre>
288
+ </li>
289
+ <li>a <tt>URI</tt> object representing a <tt>file</tt> or generic <tt>URL</tt>
290
+
291
+ <pre>
292
+ rio(URI('adir/afile'))
293
+ </pre>
294
+ </li>
295
+ <li>the components of a path as separate arguments
296
+
297
+ <pre>
298
+ rio('adir','afile')
299
+ </pre>
300
+ </li>
301
+ <li>the components of a path as an array of separate arguments
302
+
303
+ <pre>
304
+ rio(%w/adir afile/)
305
+ </pre>
306
+ </li>
307
+ <li>another <a href="RIO/Rio.html">Rio</a>
308
+
309
+ <pre>
310
+ another_rio = rio('adir/afile')
311
+ rio(another_rio)
312
+ </pre>
313
+ </li>
314
+ <li>any object whose <tt>to_s</tt> method returns one of the above
315
+
316
+ <pre>
317
+ rio(Pathname.new('apath'))
318
+ </pre>
319
+ </li>
320
+ <li>any combination of the above either as separate arguments or as elements of
321
+ an array,
322
+
323
+ <pre>
324
+ another_rio = rio('dir1/dir2')
325
+ auri = URI('dir4/dir5)
326
+ rio(another_rio,'dir3',auri,'dir6/dir7')
327
+ </pre>
328
+ </li>
329
+ </ul>
330
+ <h5>Creating a <a href="RIO/Rio.html">Rio</a> that refers to a web page</h5>
331
+ <p>
332
+ To create a <a href="RIO/Rio.html">Rio</a> that refers to a web page the
333
+ arguments to <tt>rio</tt> may be:
334
+ </p>
335
+ <ul>
336
+ <li>a string representing a fully qualified <tt>http</tt> URL
337
+
338
+ <pre>
339
+ rio('http://ruby-doc.org/index.html')
340
+ </pre>
341
+ </li>
342
+ <li>a <tt>URI</tt> object representing a <tt>http</tt> <tt>URL</tt>
343
+
344
+ <pre>
345
+ rio(URI('http://ruby-doc.org/index.html'))
346
+ </pre>
347
+ </li>
348
+ <li>either of the above with additional path elements
349
+
350
+ <pre>
351
+ rio('http://www.ruby-doc.org/','core','classes/Object.html')
352
+ </pre>
353
+ </li>
354
+ </ul>
355
+ <h5>Creating a <a href="RIO/Rio.html">Rio</a> that refers to a file or directory on a FTP server</h5>
356
+ <p>
357
+ To create a <a href="RIO/Rio.html">Rio</a> that refers to a file on a FTP
358
+ server the arguments to <tt>rio</tt> may be:
359
+ </p>
360
+ <ul>
361
+ <li>a string representing a fully qualified <tt>ftp</tt> URL
362
+
363
+ <pre>
364
+ rio('ftp://user:password@ftp.example.com/afile.tar.gz')
365
+ </pre>
366
+ </li>
367
+ <li>a <tt>URI</tt> object representing a <tt>ftp</tt> <tt>URL</tt>
368
+
369
+ <pre>
370
+ rio(URI('ftp://ftp.example.com/afile.tar.gz'))
371
+ </pre>
372
+ </li>
373
+ <li>either of the above with additional path elements
374
+
375
+ <pre>
376
+ rio('ftp://ftp.gnu.org/pub/gnu','emacs','windows','README')
377
+ </pre>
378
+ </li>
379
+ </ul>
380
+ <h4>Creating Rios that do not have a path</h4>
381
+ <p>
382
+ To create a <a href="RIO/Rio.html">Rio</a> without a path, the first
383
+ argument to <tt>rio</tt> is usually a single character.
384
+ </p>
385
+ <h5>Creating a <a href="RIO/Rio.html">Rio</a> that refers to a clone of your programs stdin or stdout.</h5>
386
+ <p>
387
+ <tt>rio(?-)</tt> (mnemonic: &#8217;-&#8217; is used by some Unix programs
388
+ to specify stdin or stdout in place of a file)
389
+ </p>
390
+ <p>
391
+ Just as a <a href="RIO/Rio.html">Rio</a> that refers to a file, does not
392
+ know whether that file will be opened for reading or writing until an I/O
393
+ operation is specified, a <tt>stdio:</tt> <a href="RIO/Rio.html">Rio</a>
394
+ does not know whether it will connect to stdin or stdout until an I/O
395
+ operation is specified.
396
+ </p>
397
+ <h5>Creating a <a href="RIO/Rio.html">Rio</a> that refers to a clone of your programs stderr.</h5>
398
+ <p>
399
+ <tt>rio(?=)</tt> (mnemonic: &#8217;-&#8217; refers to fileno 1, so
400
+ &#8217;=&#8217; refers to fileno 2)
401
+ </p>
402
+ <h5>Creating a <a href="RIO/Rio.html">Rio</a> that refers to an arbitrary IO object.</h5>
403
+ <pre>
404
+ an_io = ::File.new('afile')
405
+ rio(an_io)
406
+ </pre>
407
+ <h5>Creating a <a href="RIO/Rio.html">Rio</a> that refers to a file descriptor</h5>
408
+ <p>
409
+ <tt>rio(?#,fd)</tt> (mnemonic: a file descriptor is a number
410
+ &#8217;#&#8217;)
411
+ </p>
412
+ <pre>
413
+ an_io = ::File.new('afile')
414
+ fnum = an_io.fileno
415
+ rio(?#,fnum)
416
+ </pre>
417
+ <h5>Creating a <a href="RIO/Rio.html">Rio</a> that refers to a StringIO object</h5>
418
+ <p>
419
+ <tt>rio(?&quot;)</tt> (mnemonic: &#8217;&quot;&#8217; surrounds strings)
420
+ </p>
421
+ <ul>
422
+ <li>create a <a href="RIO/Rio.html">Rio</a> that refers to a string that it
423
+ creates
424
+
425
+ <pre>
426
+ rio(?&quot;)
427
+ </pre>
428
+ </li>
429
+ <li>create a <a href="RIO/Rio.html">Rio</a> that refers to a string of your
430
+ choosing
431
+
432
+ <pre>
433
+ astring = &quot;&quot;
434
+ rio(?&quot;,astring)
435
+ </pre>
436
+ </li>
437
+ </ul>
438
+ <h5>Creating a <a href="RIO/Rio.html">Rio</a> that refers to a Tempfile object</h5>
439
+ <p>
440
+ <tt>rio(??)</tt> (mnemonic: &#8217;?&#8217; you don&#8217;t know its name)
441
+ </p>
442
+ <pre>
443
+ rio(??)
444
+ rio(??,basename='rio',tmpdir=Dir::tmpdir)
445
+ </pre>
446
+ <h5>Creating a <a href="RIO/Rio.html">Rio</a> that refers to an arbitrary TCPSocket</h5>
447
+ <pre>
448
+ rio('tcp:',hostname,port)
449
+ </pre>
450
+ <p>
451
+ or
452
+ </p>
453
+ <pre>
454
+ rio('tcp://hostname:port')
455
+ </pre>
456
+ <h5>Creating a <a href="RIO/Rio.html">Rio</a> that runs an external program and connects to its stdin and stdout</h5>
457
+ <p>
458
+ <tt>rio(?-,cmd)</tt> (mnemonic: &#8217;-&#8217; is used by some Unix
459
+ programs to specify stdin or stdout in place of a file)
460
+ </p>
461
+ <p>
462
+ or
463
+ </p>
464
+ <p>
465
+ <tt>rio(?`,cmd)</tt> (mnemonic: &#8217;`&#8217; (backtick) runs an external
466
+ program in ruby)
467
+ </p>
468
+ <p>
469
+ This is <a href="RIO/Rio.html">Rio</a>&#8217;s interface to IO#popen
470
+ </p>
471
+ </div>
472
+ </div>
473
+
474
+ <div id="method-M000003" class="method-detail">
475
+ <a name="M000003"></a>
476
+
477
+ <div class="method-heading">
478
+ <a href="RIO.src/M000003.html" target="Code" class="method-signature"
479
+ onclick="popupCode('RIO.src/M000003.html');return false;">
480
+ <span class="method-name">root</span><span class="method-args">(*args) {|self| ...}</span>
481
+ </a>
482
+ </div>
483
+
484
+ <div class="method-description">
485
+ <p>
486
+ Create a <a href="RIO/Rio.html">Rio</a> as with <a
487
+ href="RIO.html#M000001">RIO#rio</a> which refers to a directory at the root
488
+ of the file system
489
+ </p>
490
+ <pre>
491
+ tmpdir = RIO.root('tmp') #=&gt; rio('/tmp')
492
+ </pre>
493
+ </div>
494
+ </div>
495
+
496
+
497
+ </div>
498
+
499
+
500
+ </div>
501
+
502
+
503
+ <div id="validator-badges">
504
+ <p><small>Copyright &copy; 2005 Christopher Kleckner. <a href="http://www.gnu.org/licenses/gpl.html">All rights reserved</a>.</small></p>
505
+ </div>
506
+
507
+ </body>
508
+ </html>