rio 0.3.1
Sign up to get free protection for your applications and to get access to all the features.
- data/COPYING +340 -0
- data/ChangeLog +755 -0
- data/README +65 -0
- data/RUNME.1st.rb +75 -0
- data/Rakefile +312 -0
- data/VERSION +1 -0
- data/doc/README_MSWIN32.txt +39 -0
- data/doc/RELEASE_NOTES +130 -0
- data/doc/generators/template/html/rio.rb +895 -0
- data/doc/rdoc/classes/Kernel.html +181 -0
- data/doc/rdoc/classes/Kernel.src/M000183.html +18 -0
- data/doc/rdoc/classes/RIO.html +508 -0
- data/doc/rdoc/classes/RIO.src/M000001.html +18 -0
- data/doc/rdoc/classes/RIO.src/M000002.html +18 -0
- data/doc/rdoc/classes/RIO.src/M000003.html +18 -0
- data/doc/rdoc/classes/RIO/Doc.html +138 -0
- data/doc/rdoc/classes/RIO/Doc/HOWTO.html +1031 -0
- data/doc/rdoc/classes/RIO/Doc/INTRO.html +1116 -0
- data/doc/rdoc/classes/RIO/Doc/MISC.html +443 -0
- data/doc/rdoc/classes/RIO/Doc/SYNOPSIS.html +325 -0
- data/doc/rdoc/classes/RIO/Rio.html +6333 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000004.html +18 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000005.html +20 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000006.html +27 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000007.html +27 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000008.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000009.html +18 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000010.html +20 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000011.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000012.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000013.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000014.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000015.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000016.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000017.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000018.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000019.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000020.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000021.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000022.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000023.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000024.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000025.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000026.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000027.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000028.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000029.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000030.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000031.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000032.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000033.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000034.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000035.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000036.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000037.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000038.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000039.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000040.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000041.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000042.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000043.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000044.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000045.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000046.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000047.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000048.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000049.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000050.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000051.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000052.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000053.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000054.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000055.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000056.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000057.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000058.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000059.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000060.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000061.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000062.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000063.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000064.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000065.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000066.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000067.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000068.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000069.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000070.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000071.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000072.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000073.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000074.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000075.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000076.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000077.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000078.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000079.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000080.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000081.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000082.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000083.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000084.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000085.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000086.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000087.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000088.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000089.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000090.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000091.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000092.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000093.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000094.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000095.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000096.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000097.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000098.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000099.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000100.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000101.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000102.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000103.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000104.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000105.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000106.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000107.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000108.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000109.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000110.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000111.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000112.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000113.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000114.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000115.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000116.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000117.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000118.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000119.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000120.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000121.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000122.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000123.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000124.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000125.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000126.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000127.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000128.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000129.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000130.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000131.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000132.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000133.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000134.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000135.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000136.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000137.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000138.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000139.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000140.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000141.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000142.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000143.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000144.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000145.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000146.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000147.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000148.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000149.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000150.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000151.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000152.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000153.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000154.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000155.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000156.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000157.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000158.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000159.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000160.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000161.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000162.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000163.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000164.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000165.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000166.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000167.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000168.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000169.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000170.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000171.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000172.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000173.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000174.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000175.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000176.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000177.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000178.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000179.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000180.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000181.html +16 -0
- data/doc/rdoc/classes/RIO/Rio.src/M000182.html +16 -0
- data/doc/rdoc/created.rid +1 -0
- data/doc/rdoc/files/README.html +215 -0
- data/doc/rdoc/files/lib/rio/constructor_rb.html +142 -0
- data/doc/rdoc/files/lib/rio/doc/HOWTO_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/doc/INTRO_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/doc/MISC_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/doc/SYNOPSIS_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/if/basic_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/if/dir_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/if/file_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/if/fileordir_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/if/grande_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/if/internal_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/if/methods_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/if/path_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/if/stream_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/if/test_rb.html +135 -0
- data/doc/rdoc/files/lib/rio/kernel_rb.html +142 -0
- data/doc/rdoc/files/lib/rio_rb.html +153 -0
- data/doc/rdoc/fr_class_index.html +34 -0
- data/doc/rdoc/fr_file_index.html +44 -0
- data/doc/rdoc/fr_method_index.html +210 -0
- data/doc/rdoc/index.html +24 -0
- data/doc/rdoc/rdoc-style.css +384 -0
- data/doc/rfc1738.txt +1403 -0
- data/doc/rfc959.txt +3933 -0
- data/ex/colx.rb +6 -0
- data/ex/findinruby +19 -0
- data/ex/findruby +11 -0
- data/ex/prompt.rb +25 -0
- data/ex/rgb.txt.gz +0 -0
- data/ex/riocat +35 -0
- data/ex/riogunzip +31 -0
- data/ex/riogzip +24 -0
- data/ex/tolf +11 -0
- data/lib/rio.rb +163 -0
- data/lib/rio/abstract_method.rb +57 -0
- data/lib/rio/argv.rb +57 -0
- data/lib/rio/arrayio.rb +199 -0
- data/lib/rio/arycopy.rb +44 -0
- data/lib/rio/assert.rb +115 -0
- data/lib/rio/base.rb +59 -0
- data/lib/rio/constructor.rb +183 -0
- data/lib/rio/context.rb +117 -0
- data/lib/rio/context/chomp.rb +53 -0
- data/lib/rio/context/closeoneof.rb +50 -0
- data/lib/rio/context/cxx.rb +67 -0
- data/lib/rio/context/dir.rb +92 -0
- data/lib/rio/context/gzip.rb +51 -0
- data/lib/rio/context/methods.rb +196 -0
- data/lib/rio/context/stream.rb +170 -0
- data/lib/rio/cp.rb +305 -0
- data/lib/rio/cxdir.rb +79 -0
- data/lib/rio/dir.rb +145 -0
- data/lib/rio/doc.rb +45 -0
- data/lib/rio/doc/HOWTO.rb +691 -0
- data/lib/rio/doc/INTRO.rb +579 -0
- data/lib/rio/doc/MISC.rb +257 -0
- data/lib/rio/doc/SYNOPSIS.rb +170 -0
- data/lib/rio/entrysel.rb +162 -0
- data/lib/rio/exception.rb +42 -0
- data/lib/rio/exception/copy.rb +98 -0
- data/lib/rio/exception/open.rb +62 -0
- data/lib/rio/exception/state.rb +74 -0
- data/lib/rio/ext.rb +62 -0
- data/lib/rio/ext/csv.rb +261 -0
- data/lib/rio/factory.rb +236 -0
- data/lib/rio/file.rb +77 -0
- data/lib/rio/filter/chomp.rb +61 -0
- data/lib/rio/filter/closeoneof.rb +103 -0
- data/lib/rio/filter/gzip.rb +58 -0
- data/lib/rio/ftp.rb +275 -0
- data/lib/rio/ftp/conn.rb +167 -0
- data/lib/rio/ftp/ioh.rb +88 -0
- data/lib/rio/grande.rb +126 -0
- data/lib/rio/handle.rb +101 -0
- data/lib/rio/if.rb +53 -0
- data/lib/rio/if/basic.rb +64 -0
- data/lib/rio/if/dir.rb +362 -0
- data/lib/rio/if/file.rb +57 -0
- data/lib/rio/if/fileordir.rb +247 -0
- data/lib/rio/if/grande.rb +510 -0
- data/lib/rio/if/internal.rb +53 -0
- data/lib/rio/if/methods.rb +612 -0
- data/lib/rio/if/path.rb +413 -0
- data/lib/rio/if/stream.rb +599 -0
- data/lib/rio/if/test.rb +219 -0
- data/lib/rio/impl/path.rb +82 -0
- data/lib/rio/ioh.rb +137 -0
- data/lib/rio/iomode.rb +96 -0
- data/lib/rio/kernel.rb +47 -0
- data/lib/rio/local.rb +63 -0
- data/lib/rio/match.rb +51 -0
- data/lib/rio/matchrecord.rb +254 -0
- data/lib/rio/open3.rb +69 -0
- data/lib/rio/ops/create.rb +78 -0
- data/lib/rio/ops/dir.rb +302 -0
- data/lib/rio/ops/either.rb +117 -0
- data/lib/rio/ops/file.rb +94 -0
- data/lib/rio/ops/path.rb +292 -0
- data/lib/rio/ops/stream.rb +84 -0
- data/lib/rio/ops/stream/input.rb +237 -0
- data/lib/rio/ops/stream/output.rb +96 -0
- data/lib/rio/ops/stream/read.rb +84 -0
- data/lib/rio/ops/stream/write.rb +58 -0
- data/lib/rio/ops/symlink.rb +70 -0
- data/lib/rio/path.rb +117 -0
- data/lib/rio/path/reset.rb +70 -0
- data/lib/rio/record.rb +59 -0
- data/lib/rio/rectype.rb +86 -0
- data/lib/rio/rl/base.rb +147 -0
- data/lib/rio/rl/builder.rb +166 -0
- data/lib/rio/rl/ioi.rb +66 -0
- data/lib/rio/rl/path.rb +141 -0
- data/lib/rio/rl/uri.rb +118 -0
- data/lib/rio/scheme/aryio.rb +89 -0
- data/lib/rio/scheme/cmdio.rb +74 -0
- data/lib/rio/scheme/fd.rb +65 -0
- data/lib/rio/scheme/ftp.rb +73 -0
- data/lib/rio/scheme/http.rb +81 -0
- data/lib/rio/scheme/path.rb +100 -0
- data/lib/rio/scheme/stderr.rb +56 -0
- data/lib/rio/scheme/stdio.rb +71 -0
- data/lib/rio/scheme/strio.rb +82 -0
- data/lib/rio/scheme/sysio.rb +61 -0
- data/lib/rio/scheme/tcp.rb +74 -0
- data/lib/rio/scheme/tempfile.rb +104 -0
- data/lib/rio/state.rb +209 -0
- data/lib/rio/state/error.rb +73 -0
- data/lib/rio/stream.rb +181 -0
- data/lib/rio/stream/base.rb +50 -0
- data/lib/rio/stream/duplex.rb +76 -0
- data/lib/rio/stream/open.rb +203 -0
- data/lib/rio/symantics.rb +46 -0
- data/lib/rio/to_rio.rb +57 -0
- data/lib/rio/uri/file.rb +145 -0
- data/lib/rio/version.rb +52 -0
- data/setup.rb +1331 -0
- data/test/1.rb +14 -0
- data/test/mswin32.rb +28 -0
- data/test/once.rb +7 -0
- data/test/runtests.rb +12 -0
- data/test/runtests_gem.rb +15 -0
- data/test/tc/abs.rb +349 -0
- data/test/tc/all.rb +42 -0
- data/test/tc/cd1.rb +116 -0
- data/test/tc/clearsel.rb +69 -0
- data/test/tc/closeoncopy.rb +91 -0
- data/test/tc/closeoneof.rb +194 -0
- data/test/tc/copy-from.rb +183 -0
- data/test/tc/copy-to.rb +94 -0
- data/test/tc/copy.rb +72 -0
- data/test/tc/copyarray.rb +191 -0
- data/test/tc/copydest.rb +50 -0
- data/test/tc/copydir.rb +192 -0
- data/test/tc/copydirlines.rb +124 -0
- data/test/tc/copylines.rb +40 -0
- data/test/tc/copynonex.rb +121 -0
- data/test/tc/create.rb +104 -0
- data/test/tc/csv.rb +229 -0
- data/test/tc/dir.rb +79 -0
- data/test/tc/dirautoclose.rb +70 -0
- data/test/tc/dirent.rb +180 -0
- data/test/tc/dirss.rb +84 -0
- data/test/tc/each.rb +111 -0
- data/test/tc/each_break.rb +241 -0
- data/test/tc/edf.rb +82 -0
- data/test/tc/entary.rb +230 -0
- data/test/tc/eq.rb +101 -0
- data/test/tc/expand_path.rb +94 -0
- data/test/tc/ext.rb +115 -0
- data/test/tc/fileno.rb +95 -0
- data/test/tc/getrec.rb +140 -0
- data/test/tc/lineno.rb +197 -0
- data/test/tc/lines.rb +66 -0
- data/test/tc/methods.rb +185 -0
- data/test/tc/misc.rb +473 -0
- data/test/tc/nolines.rb +205 -0
- data/test/tc/noqae.rb +873 -0
- data/test/tc/once.rb +6 -0
- data/test/tc/overload.rb +137 -0
- data/test/tc/pa.rb +159 -0
- data/test/tc/pathop.rb +63 -0
- data/test/tc/paths.rb +147 -0
- data/test/tc/qae.rb +494 -0
- data/test/tc/qae_riovar.rb +500 -0
- data/test/tc/records.rb +69 -0
- data/test/tc/rename.rb +224 -0
- data/test/tc/rename_assign.rb +48 -0
- data/test/tc/sub.rb +49 -0
- data/test/tc/symlink.rb +177 -0
- data/test/tc/symlink0.rb +298 -0
- data/test/tc/symlink1.rb +115 -0
- data/test/tc/testcase.rb +152 -0
- metadata +461 -0
data/lib/rio/if/file.rb
ADDED
@@ -0,0 +1,57 @@
|
|
1
|
+
#--
|
2
|
+
# ===============================================================================
|
3
|
+
# Copyright (c) 2005, Christopher Kleckner
|
4
|
+
# All rights reserved
|
5
|
+
#
|
6
|
+
# This file is part of the Rio library for ruby.
|
7
|
+
#
|
8
|
+
# Rio is free software; you can redistribute it and/or modify
|
9
|
+
# it under the terms of the GNU General Public License as published by
|
10
|
+
# the Free Software Foundation; either version 2 of the License, or
|
11
|
+
# (at your option) any later version.
|
12
|
+
#
|
13
|
+
# Rio is distributed in the hope that it will be useful,
|
14
|
+
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
15
|
+
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
16
|
+
# GNU General Public License for more details.
|
17
|
+
#
|
18
|
+
# You should have received a copy of the GNU General Public License
|
19
|
+
# along with Rio; if not, write to the Free Software
|
20
|
+
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
21
|
+
# ===============================================================================
|
22
|
+
#++
|
23
|
+
#
|
24
|
+
# To create the documentation for Rio run the command
|
25
|
+
# rake rdoc
|
26
|
+
# from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
|
27
|
+
#
|
28
|
+
# Suggested Reading
|
29
|
+
# * RIO::Doc::SYNOPSIS
|
30
|
+
# * RIO::Doc::INTRO
|
31
|
+
# * RIO::Doc::HOWTO
|
32
|
+
# * RIO::Rio
|
33
|
+
#
|
34
|
+
# <b>Rio is pre-alpha software.
|
35
|
+
# The documented interface and behavior is subject to change without notice.</b>
|
36
|
+
|
37
|
+
|
38
|
+
module RIO
|
39
|
+
class Rio
|
40
|
+
# Calls FileUtils#rm
|
41
|
+
#
|
42
|
+
# Deletes the referenced file, returning the Rio. Raises an exception on any error.
|
43
|
+
#
|
44
|
+
# See also Rio#delete, Rio#delete!, Rio#rmdir.
|
45
|
+
def rm() target.rm(); self end
|
46
|
+
|
47
|
+
|
48
|
+
# Calls FileUtils#touch
|
49
|
+
#
|
50
|
+
# Updates modification time (mtime) and access time (atime) of a Rio.
|
51
|
+
# A file is created if it doesn't exist.
|
52
|
+
#
|
53
|
+
def touch() target.touch(); self end
|
54
|
+
|
55
|
+
|
56
|
+
end
|
57
|
+
end
|
@@ -0,0 +1,247 @@
|
|
1
|
+
#--
|
2
|
+
# ===============================================================================
|
3
|
+
# Copyright (c) 2005, Christopher Kleckner
|
4
|
+
# All rights reserved
|
5
|
+
#
|
6
|
+
# This file is part of the Rio library for ruby.
|
7
|
+
#
|
8
|
+
# Rio is free software; you can redistribute it and/or modify
|
9
|
+
# it under the terms of the GNU General Public License as published by
|
10
|
+
# the Free Software Foundation; either version 2 of the License, or
|
11
|
+
# (at your option) any later version.
|
12
|
+
#
|
13
|
+
# Rio is distributed in the hope that it will be useful,
|
14
|
+
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
15
|
+
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
16
|
+
# GNU General Public License for more details.
|
17
|
+
#
|
18
|
+
# You should have received a copy of the GNU General Public License
|
19
|
+
# along with Rio; if not, write to the Free Software
|
20
|
+
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
21
|
+
# ===============================================================================
|
22
|
+
#++
|
23
|
+
#
|
24
|
+
# To create the documentation for Rio run the command
|
25
|
+
# rake rdoc
|
26
|
+
# from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
|
27
|
+
#
|
28
|
+
# Suggested Reading
|
29
|
+
# * RIO::Doc::SYNOPSIS
|
30
|
+
# * RIO::Doc::INTRO
|
31
|
+
# * RIO::Doc::HOWTO
|
32
|
+
# * RIO::Rio
|
33
|
+
#
|
34
|
+
# <b>Rio is pre-alpha software.
|
35
|
+
# The documented interface and behavior is subject to change without notice.</b>
|
36
|
+
|
37
|
+
|
38
|
+
module RIO
|
39
|
+
class Rio
|
40
|
+
|
41
|
+
# Creates a symbolic link _dest_ which points to the Rio's Rio#fspath.
|
42
|
+
# Raises a NotImplementedError exception on platforms that do not support symbolic links.
|
43
|
+
# _dest_ may be a Rio, a String, or anything that will create an appropriate Rio
|
44
|
+
# when passed to Rio#new
|
45
|
+
# If _dest_ already exists and is a directory, creates a symbolic link in the _dest_ directory,
|
46
|
+
# named with the name returned by Rio#filename
|
47
|
+
# If _dest_ already exists and it is not a directory, raises Errno::EEXIST.
|
48
|
+
#
|
49
|
+
# Returns the Rio (not the symlink)
|
50
|
+
#
|
51
|
+
# Rio#symlink differs from File#symlink when the Rio or the _dest_ path has directory information.
|
52
|
+
# In this case Rio#symlink creates a symlink that actually refers to the Rio's location
|
53
|
+
# from the perspective of the link's location.
|
54
|
+
#
|
55
|
+
# For example: Given an existing file 'adir/afile' and a _dest_ of 'adir/alink'
|
56
|
+
# ::File.symlink('adir/afile','adir/alink1') # creates 'adir/alink1 -> adir/afile'
|
57
|
+
# ::File.exist?('adir/alink1') # false
|
58
|
+
# rio('adir/afile').symlink('adir/alink2') # creates 'adir/alink2 -> afile'
|
59
|
+
# ::File.exist?('adir/alink2') # true
|
60
|
+
#
|
61
|
+
# To replace an existing symlink use the following Rio idiom
|
62
|
+
# rio('afile').symlink( rio('link_name').delete ) # delete 'link_name' and recreate linked to 'afile'
|
63
|
+
#
|
64
|
+
# Examples
|
65
|
+
# rio('afile').symlink('alink') # create the symbolic link 'alink' which references 'afile'
|
66
|
+
# rio('afile').symlink('adir/alink') # create a symlink 'adir/alink' -> '../afile'
|
67
|
+
# rio('adir/afile').symlink('alink') # create a symlink 'alink' -> 'adir/afile'
|
68
|
+
# rio('adir/afile').symlink('adir/alink') # create a symlink 'adir/alink' -> 'afile'
|
69
|
+
# rio('adir/afile').symlink('adir/alink') # create a symlink 'adir/alink' -> 'afile'
|
70
|
+
# rio('adir1/afile').symlink('adir2/alink') # create a symlink 'adir2/alink' -> '../adir1/afile'
|
71
|
+
# rio('/tmp/afile').symlink('alink') # create a symlink 'adir/alink' -> '/tmp/afile'
|
72
|
+
def symlink(dest) target.symlink(dest); self end
|
73
|
+
|
74
|
+
|
75
|
+
# Calls File#readlink
|
76
|
+
#
|
77
|
+
# Returns a Rio referencing the file referenced by the given link. Not available on all platforms.
|
78
|
+
#
|
79
|
+
def readlink(*args) target.readlink(*args) end
|
80
|
+
|
81
|
+
# If called with an argument calls FileUtils#rename
|
82
|
+
# If called without an argument puts the Rio in a rename mode in
|
83
|
+
# which changes to the Rio's path affect a rename of the file
|
84
|
+
# on the file system.
|
85
|
+
#
|
86
|
+
# Proxy for FileUtils#rename
|
87
|
+
# ario = rio('afile.cpp')
|
88
|
+
# ario.rename('afile.cxx') # renamed the file, but ario still references
|
89
|
+
# # the old path
|
90
|
+
# Rename Mode
|
91
|
+
#
|
92
|
+
# Change the extension of all'.cpp' files in 'adir' to '.cxx'
|
93
|
+
# rio('adir').rename.files('*.cpp') do |file|
|
94
|
+
# file.ext = '.cxx' # 'file' references the new path and the actual file is renamed
|
95
|
+
# end
|
96
|
+
#
|
97
|
+
# Recursively change all '.tar.gz' files to '.tgz' files
|
98
|
+
# rio('adir').rename.all.files('*.tar.gz') do |gzfile|
|
99
|
+
# gzfile.ext('.tar.gz').ext = '.tgz'
|
100
|
+
# end
|
101
|
+
#
|
102
|
+
# See Rio#dirname=, Rio#filename=, Rio#basename=, and Rio#extname=
|
103
|
+
#
|
104
|
+
def rename(*args,&block) target.rename(*args,&block); self end
|
105
|
+
|
106
|
+
# For directories proxies Dir#read, otherwise proxies IO#read
|
107
|
+
#
|
108
|
+
# Proxy for IO#read
|
109
|
+
# ario.read([integer [, buffer]]) => string, buffer, or nil
|
110
|
+
# Reads at most _integer_ bytes from the I/O stream, or to the end of
|
111
|
+
# file if _integer_ is omitted or is +nil+. If the optional _buffer_
|
112
|
+
# argument is present, it must reference a String, which will receive
|
113
|
+
# the data. Returns +nil+ if called at end of file.
|
114
|
+
#
|
115
|
+
# f = rio("testfile")
|
116
|
+
# f.read(16) #=> "This is line one"
|
117
|
+
#
|
118
|
+
# rio("testfile").read(16) #=> "This is line one"
|
119
|
+
#
|
120
|
+
# Proxy for Dir#read
|
121
|
+
# dir.read => ario or nil
|
122
|
+
#------------------------------------------------------------------------
|
123
|
+
# Reads the next entry from _dir_ and returns it as a Rio. Returns
|
124
|
+
# +nil+ at the end of the stream.
|
125
|
+
# d = rio("testdir")
|
126
|
+
# d.read #=> rio(".")
|
127
|
+
# d.read #=> rio("..")
|
128
|
+
# d.read #=> rio("config.h")
|
129
|
+
#
|
130
|
+
def read(*args) target.read(*args)end
|
131
|
+
|
132
|
+
# For directories proxies Dir#rewind, otherwise proxies IO#rewind
|
133
|
+
#
|
134
|
+
# Proxy for IO#rewind
|
135
|
+
# ario.rewind => ario
|
136
|
+
# Positions _ario_ to the beginning of input, resetting lineno to zero.
|
137
|
+
#
|
138
|
+
# Returns the Rio
|
139
|
+
#
|
140
|
+
# f = rio("testfile")
|
141
|
+
# f.readline #=> "This is line one\n"
|
142
|
+
# f.rewind #=> f
|
143
|
+
# f.lineno #=> 0
|
144
|
+
# f.readline #=> "This is line one\n"
|
145
|
+
#
|
146
|
+
# f.rewind.readline #=> "This is line one\n"
|
147
|
+
#
|
148
|
+
# Proxy for Dir#rewind
|
149
|
+
# ario.rewind => ario
|
150
|
+
#------------------------------------------------------------------------
|
151
|
+
# Repositions _ario_ to the first entry.
|
152
|
+
#
|
153
|
+
# d = rio("testdir")
|
154
|
+
# d.read #=> rio(".")
|
155
|
+
# d.rewind.read #=> rio(".")
|
156
|
+
def rewind(&block) target.rewind(&block); self end
|
157
|
+
|
158
|
+
# For directories proxies Dir#seek, otherwise proxies IO#seek
|
159
|
+
#
|
160
|
+
# Proxy for IO#seek
|
161
|
+
# ario.seek(amount, whence=SEEK_SET) -> ario
|
162
|
+
# Seeks to a given offset _amount_ in the stream according to the
|
163
|
+
# value of _whence_:
|
164
|
+
#
|
165
|
+
# IO::SEEK_CUR | Seeks to <em>amount</em> plus current position
|
166
|
+
# --------------+----------------------------------------------------
|
167
|
+
# IO::SEEK_END | Seeks to <em>amount</em> plus end of stream (you probably
|
168
|
+
# | want a negative value for <em>amount</em>)
|
169
|
+
# --------------+----------------------------------------------------
|
170
|
+
# IO::SEEK_SET | Seeks to the absolute location given by <em>amount</em>
|
171
|
+
#
|
172
|
+
# Example:
|
173
|
+
#
|
174
|
+
# f = rio("testfile")
|
175
|
+
# f.seek(-28, IO::SEEK_END).readline #=> "happily ever after. The End\n"
|
176
|
+
#
|
177
|
+
# Proxy for Dir#seek
|
178
|
+
# ario.seek( integer ) => ario
|
179
|
+
# Seeks to a particular location in _ario_. _integer_ must be a value
|
180
|
+
# returned by +Dir#tell+ or Rio#tell.
|
181
|
+
#
|
182
|
+
# d = rio("testdir") #=> #<RIO::Rio:0x401b3c40>
|
183
|
+
# d.read #=> rio(".")
|
184
|
+
# i = d.tell #=> 12
|
185
|
+
# d.read #=> rio("..")
|
186
|
+
# d.seek(i) #=> #<RIO::Rio:0x401b3c40>
|
187
|
+
# d.read #=> rio("..")
|
188
|
+
def seek(*args) target.seek(*args); self end
|
189
|
+
#def seek(amount,whence=IO::SEEK_SET) target.seek(amount,whence) end
|
190
|
+
|
191
|
+
|
192
|
+
|
193
|
+
# For directories proxies Dir#pos, otherwise proxies IO#pos
|
194
|
+
#
|
195
|
+
# Proxy for IO#pos
|
196
|
+
# ario.pos => integer
|
197
|
+
# ario.tell => integer
|
198
|
+
# Returns the current offset (in bytes) of _ario_.
|
199
|
+
#
|
200
|
+
# f = rio("testfile")
|
201
|
+
# f.pos #=> 0
|
202
|
+
# f.gets #=> "This is line one\n"
|
203
|
+
# f.pos #=> 17
|
204
|
+
#
|
205
|
+
#
|
206
|
+
# Proxy for Dir#pos
|
207
|
+
# ario.pos => integer
|
208
|
+
# ario.tell => integer
|
209
|
+
# Returns the current position in _dir_. See also +Rio#seek+.
|
210
|
+
#
|
211
|
+
# d = rio("testdir")
|
212
|
+
# d.pos #=> 0
|
213
|
+
# d.read #=> rio(".")
|
214
|
+
# d.pos #=> 12
|
215
|
+
#
|
216
|
+
def pos() target.pos end
|
217
|
+
|
218
|
+
# See Rio#pos
|
219
|
+
def tell() target.tell end
|
220
|
+
|
221
|
+
# For directories proxies Dir#pos=, otherwise proxies IO#pos=
|
222
|
+
#
|
223
|
+
# Proxy for IO#pos=
|
224
|
+
# ario.pos = integer => 0
|
225
|
+
# Seeks to the given position (in bytes) in _ario_.
|
226
|
+
#
|
227
|
+
# f = rio("testfile")
|
228
|
+
# f.pos = 17
|
229
|
+
# f.gets #=> "This is line two\n"
|
230
|
+
#
|
231
|
+
# Proxy for Dir#pos=
|
232
|
+
# ario.pos = integer => integer
|
233
|
+
#------------------------------------------------------------------------
|
234
|
+
# Synonym for +Rio#seek+, but returns the position parameter.
|
235
|
+
#
|
236
|
+
# d = rio("testdir") #=> d
|
237
|
+
# d.read #=> rio(".")
|
238
|
+
# i = d.pos #=> 12
|
239
|
+
# d.read #=> rio("..")
|
240
|
+
# d.pos = i #=> 12
|
241
|
+
# d.read #=> rio("..")
|
242
|
+
#
|
243
|
+
def pos=(integer) target.pos = integer end
|
244
|
+
end
|
245
|
+
end
|
246
|
+
|
247
|
+
|
@@ -0,0 +1,510 @@
|
|
1
|
+
#--
|
2
|
+
# ===============================================================================
|
3
|
+
# Copyright (c) 2005, Christopher Kleckner
|
4
|
+
# All rights reserved
|
5
|
+
#
|
6
|
+
# This file is part of the Rio library for ruby.
|
7
|
+
#
|
8
|
+
# Rio is free software; you can redistribute it and/or modify
|
9
|
+
# it under the terms of the GNU General Public License as published by
|
10
|
+
# the Free Software Foundation; either version 2 of the License, or
|
11
|
+
# (at your option) any later version.
|
12
|
+
#
|
13
|
+
# Rio is distributed in the hope that it will be useful,
|
14
|
+
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
15
|
+
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
16
|
+
# GNU General Public License for more details.
|
17
|
+
#
|
18
|
+
# You should have received a copy of the GNU General Public License
|
19
|
+
# along with Rio; if not, write to the Free Software
|
20
|
+
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
21
|
+
# ===============================================================================
|
22
|
+
#++
|
23
|
+
#
|
24
|
+
# To create the documentation for Rio run the command
|
25
|
+
# rake rdoc
|
26
|
+
# from the distribution directory. Then point your browser at the 'doc/rdoc' directory.
|
27
|
+
#
|
28
|
+
# Suggested Reading
|
29
|
+
# * RIO::Doc::SYNOPSIS
|
30
|
+
# * RIO::Doc::INTRO
|
31
|
+
# * RIO::Doc::HOWTO
|
32
|
+
# * RIO::Rio
|
33
|
+
#
|
34
|
+
# <b>Rio is pre-alpha software.
|
35
|
+
# The documented interface and behavior is subject to change without notice.</b>
|
36
|
+
|
37
|
+
|
38
|
+
module RIO
|
39
|
+
class Rio
|
40
|
+
# Returns the contents of the rio as an array.
|
41
|
+
# Rio#to_a is implemented in terms of Rio#each so the the following are roughly equivelent
|
42
|
+
#
|
43
|
+
# ary = ario.to_a
|
44
|
+
#
|
45
|
+
# ary = []
|
46
|
+
# ario.each do |rec|
|
47
|
+
# ary << ary
|
48
|
+
# end
|
49
|
+
#
|
50
|
+
# What constitutes an array element is determined by Rio#lines, Rio#bytes, or
|
51
|
+
# by an extension such as Rio#csv. Rio#lines is the default.
|
52
|
+
#
|
53
|
+
# rio('afile.txt').to_a # returns an array of the lines in afile.txt
|
54
|
+
#
|
55
|
+
# rio('afile.txt').lines(1...3).to_a # an array containing lines 1 and 2 of afile.txt
|
56
|
+
#
|
57
|
+
# rio('afile.dat').bytes(50).to_a # an array containing the contents of afile.dat broken
|
58
|
+
# # up into 50 byte chunks
|
59
|
+
#
|
60
|
+
# See also Rio#[] (subscript operator)
|
61
|
+
#
|
62
|
+
# def to_a() target.to_a() end
|
63
|
+
|
64
|
+
# Grande subscript operator.
|
65
|
+
#
|
66
|
+
# For files this returns all or part of a file as an array.
|
67
|
+
#
|
68
|
+
# For directories this returns all or some of the entries in a directory
|
69
|
+
#
|
70
|
+
# === Files
|
71
|
+
#
|
72
|
+
# This combines the record selection offered by Rio#records with
|
73
|
+
# the conversion to an array provided by Rio#to_a. The following two are equivelant:
|
74
|
+
# * ario[*args]
|
75
|
+
# * ario.records(*args).to_a
|
76
|
+
#
|
77
|
+
# What constitutes an array element is determined by Rio#lines, Rio#bytes,
|
78
|
+
# or by an extension such as Rio#csv. Rio#lines is the default.
|
79
|
+
#
|
80
|
+
# Arguments may consist of zero or more integers, ranges, regular expressions, symbols
|
81
|
+
# and procs.
|
82
|
+
# An empty argument list selects all records
|
83
|
+
#
|
84
|
+
# Records are selected as follows.
|
85
|
+
# range:: specifies a range of records to be selected (zero based)
|
86
|
+
# regexp:: matching records will be selected.
|
87
|
+
# integer:: treated like a one element range
|
88
|
+
# symbol:: the symbol is sent to the string. record is selected unless false is returned
|
89
|
+
# proc:: the proc is called with the string as an argument. record is selected unless false is returned
|
90
|
+
#
|
91
|
+
# A record matching *any* of the selectors will be included in the array. (acts like an _or_)
|
92
|
+
#
|
93
|
+
# Because this is implemented in terms of the Rio#each,
|
94
|
+
# When only record ranges are used to select records,
|
95
|
+
# iteration will stop when the recno exceeds the maximum of any range. That is to say
|
96
|
+
#
|
97
|
+
# This reads one record from a file and returns it
|
98
|
+
# rio('bigfile.mp3').bytes(1024)[0]
|
99
|
+
# While this reads *all* records from a file and returns the first one
|
100
|
+
# rio('bigfile.mp3').bytes(1024).to_a[0]
|
101
|
+
#
|
102
|
+
# === Directories
|
103
|
+
#
|
104
|
+
# This combines the entry selection offered by Rio#entries with
|
105
|
+
# the conversion to an array provided by Rio#to_a. The following two are equivelant:
|
106
|
+
# * ario[*args]
|
107
|
+
# * ario.entries(*args).to_a
|
108
|
+
#
|
109
|
+
# Arguments may consist of strings (treated as globs) or regular expressions.
|
110
|
+
# An empty argument list selects all entries
|
111
|
+
# See ::Dir#glob and ::File::fnmatch? for more in information on _globs_. Be warned that using the '**' glob
|
112
|
+
# recurses into directories independently of Rio#all and using both is unsupported.
|
113
|
+
#
|
114
|
+
# ario = rio('adir')
|
115
|
+
# ario[] # returns an array containg all entries in _adir_
|
116
|
+
# ario[/^zippy/] # all entries starting with 'zippy'
|
117
|
+
# ario['zippy*'] # same thing
|
118
|
+
#
|
119
|
+
# As with Rio#each:
|
120
|
+
# * Files and directories are returned as Rios
|
121
|
+
# * The types of entries is also affected by Rio#files and Rio#dirs.
|
122
|
+
# rio('adir').files['*.txt'] # array of all _.txt_ files
|
123
|
+
# rio('adir').dirs(/^\./) # array of all dot directories
|
124
|
+
# * Recursion is enabled using Rio#all
|
125
|
+
# rio('adir').all.files['*.[ch]'] # array of c source files in _adir_ and its subdirecories
|
126
|
+
# rio('adir').all.dirs[/^\.svn/] # array of subversion directories in _adir_ and subdirectories
|
127
|
+
# * Rio#files and Rio#dirs act independetly of each other. Specifying both will cause both to be returned.
|
128
|
+
# The argument list to Rio#[] will be applied to the closest.
|
129
|
+
# rio('adir').files('*.rb').dirs['ruby*'] # array of _.rb_ files and
|
130
|
+
# # directories starting with 'ruby'
|
131
|
+
# rio('adir').dirs('ruby*').files['*.rb'] # same thing
|
132
|
+
#
|
133
|
+
# === Lines
|
134
|
+
# This section applies similarly to Rio#lines, Rio#bytes, Rio#records, and Rio#rows
|
135
|
+
#
|
136
|
+
# Using Rio#lines and related methods with a Rio referencing a directory
|
137
|
+
# imples Rio#files and will cause an array of the lines or bytes in the files to be returned. As above,
|
138
|
+
# the arguments to the subscript operator will be applied to the closest.
|
139
|
+
# rio('adir').lines[] # array of all lines in the files in 'adir'
|
140
|
+
# rio('adir').files.lines[] # same thing
|
141
|
+
# rio('adir').lines(0..9).files['*.txt'] # array of the first ten lines of all .txt files
|
142
|
+
# rio('adir').files('*.txt').lines[0..9] # same thing
|
143
|
+
# rio('adir').all.files('*.rb').lines[/^\s*require/] # array of 'require' lines in .rb files in
|
144
|
+
# # 'adir and its subdirectories
|
145
|
+
#
|
146
|
+
# Note the difference between the following similar usages
|
147
|
+
# it1 = rio('adir').files('*.rb') # returns a Rio, prepared for selecting ruby files
|
148
|
+
# it2 = rio('adir').files['*.rb'] # returns an array of the ruby files
|
149
|
+
#
|
150
|
+
# The second example above could have been written
|
151
|
+
# it2 = it1.to_a
|
152
|
+
#
|
153
|
+
# Examples:
|
154
|
+
#
|
155
|
+
# rio('afile.txt').lines[1..2] # array containing the 2nd and 3rd line
|
156
|
+
#
|
157
|
+
# rio('afile.txt')[1,3..5] # array containing lines 1,3,4 and 5
|
158
|
+
#
|
159
|
+
# rio('afile.txt')[/Zippy/] # array of all lines containing 'Zippy'
|
160
|
+
#
|
161
|
+
# rio('afile.txt')[1,3..5,/Zippy/] # array with lines 1,3,4 and 5 and all lines containing 'Zippy'
|
162
|
+
#
|
163
|
+
# rio('afile.dat').bytes(50)[] # array containing the contents of afile.dat broken up into 50 byte chunks
|
164
|
+
#
|
165
|
+
# rio('afile.dat').bytes(50)[0,2] # array containing the first and third such chunk
|
166
|
+
#
|
167
|
+
# rio('afile.dat').bytes(50).records[0,2] # same thing
|
168
|
+
#
|
169
|
+
# rio('afile.dat').bytes(50).records(0,2).to_a # once again
|
170
|
+
#
|
171
|
+
# rio('afile.csv').csv[0..9] # array of the first 10 records of afile.csv parsed by the ::CSV module
|
172
|
+
#
|
173
|
+
# rio('afile.csv').csv.records[0..9] # same thing
|
174
|
+
#
|
175
|
+
# rio('afile.csv').csv(';').records[0..9] # same thing using semi-colon as the value separator
|
176
|
+
#
|
177
|
+
# rio('afile.csv').csv.records[0,/Zippy/] # record 0 and all records containing 'Zippy'
|
178
|
+
# # the regexp is matched against the line before parsing by ::CSV
|
179
|
+
#
|
180
|
+
# rio('adir')[] # array of entries in 'adir'
|
181
|
+
#
|
182
|
+
# rio('adir')['*.txt'] # array of all .txt entries
|
183
|
+
#
|
184
|
+
# rio('adir').all['*.txt'] # array of all .txt entries in 'adir and its subdirectories
|
185
|
+
#
|
186
|
+
# rio('adir').files['*.txt'] # array of all .txt files
|
187
|
+
#
|
188
|
+
# rio('adir').dirs['CSV'] # array of all CSV directories
|
189
|
+
# rio('adir').nodirs['CSV'] # array of all non-CSV directories
|
190
|
+
#
|
191
|
+
def [](*selectors) target[*selectors] end
|
192
|
+
|
193
|
+
|
194
|
+
|
195
|
+
# Iterate through a rio. Executes the block for each item selected for the Rio.
|
196
|
+
# See Rio#lines, Rio#records, Rio#bytes, Rio#files, Rio#dirs, Rio#[]
|
197
|
+
# and Rio#to_a for more information
|
198
|
+
# on how records are selected and what kind of record is passed to the block.
|
199
|
+
#
|
200
|
+
# Rio#each is the fundemental method for all the Rio grande operators.
|
201
|
+
# Rio#to_a and the Rio copy operators Rio#< Rio#<< Rio#>> Rio#> are all implemented
|
202
|
+
# in terms of Rio#each.
|
203
|
+
#
|
204
|
+
# While Rio#each is fundamental to a Rio, it rarely needs
|
205
|
+
# actually be called because all the grande configuration methods will also take a block
|
206
|
+
# and call Rio#each if one is given.
|
207
|
+
# So the existance of a block after many methods is taken as an implied
|
208
|
+
# Rio#each
|
209
|
+
#
|
210
|
+
# For Rios that refer to directories, the item passed to the block is a Rio refering to
|
211
|
+
# the directory entry.
|
212
|
+
#
|
213
|
+
# rio('adir').files.each do |file|
|
214
|
+
# file.kind_of?(RIO::Rio) # true
|
215
|
+
# end
|
216
|
+
#
|
217
|
+
# In addition, the Rio passed to the block inherits certain attributes from the directory Rio.
|
218
|
+
#
|
219
|
+
# rio('adir').files.chomp.each do |file| # chomp is ignored for directories,
|
220
|
+
# file.each do |line| # chomp attribute is inherited by the file rio
|
221
|
+
# # .. line is chomped
|
222
|
+
# end
|
223
|
+
# end
|
224
|
+
#
|
225
|
+
# Rio#each returns the Rio which called it.
|
226
|
+
#
|
227
|
+
# Here are a few illustrative examples
|
228
|
+
#
|
229
|
+
# * Processing lines in a file
|
230
|
+
#
|
231
|
+
# rio('f.txt').each { |line| ... } # execute block for every line in the file
|
232
|
+
# rio('f.txt').lines.each { |line| ... } # same thing
|
233
|
+
# rio('f.txt').lines { |line| ... } # same thing
|
234
|
+
#
|
235
|
+
# rio('f.txt').chomp.each { |line| ... } # same as above with lines chomped
|
236
|
+
# rio('f.txt').chomp { |line| ... } # ditto
|
237
|
+
# rio('f.txt').lines.chomp { |line| ... } # ditto
|
238
|
+
# rio('f.txt').chomp.lines { |line| ... } # ditto
|
239
|
+
#
|
240
|
+
# rio('f.txt.gz').gzip.each { |line| ... } # execute block for every line in a gzipped file
|
241
|
+
# rio('f.txt.gz').gzip { |line| ... } # same thing
|
242
|
+
# rio('f.txt.gz').lines.gzip { |line| ... } # same thing
|
243
|
+
#
|
244
|
+
# rio('f.txt.gz').gzip.chomp { |line| ... } # chomp lines from a gzipped file
|
245
|
+
# rio('f.txt.gz').gzip.chomp.each { |line| ... } # ditto
|
246
|
+
# rio('f.txt.gz').chomp.lines.gzip { |line| ... } # ditto
|
247
|
+
#
|
248
|
+
# rio('f.txt').lines(0..9) { |line| ... } # execute block for the first 10 lines in the file
|
249
|
+
# rio('f.txt').lines(0..9).each { |line| ... } # same thing
|
250
|
+
#
|
251
|
+
# rio('f.txt').lines(/^\s*#/) { |line| ... } # execute block for comment-only lines
|
252
|
+
# rio('f.txt').lines(/^\s*#/).each { |line| ... } # same thing
|
253
|
+
#
|
254
|
+
# rio('f.txt').lines(0,/Rio/) { |line| ... } # execute block for the first line and
|
255
|
+
# # all lines containing 'Rio'
|
256
|
+
#
|
257
|
+
# rio('f.txt.gz').gzip.chomp.lines(0..1) { |line| ... } # first 2 lines chomped from a gzip file
|
258
|
+
#
|
259
|
+
# * Processing a file a block at a time
|
260
|
+
#
|
261
|
+
# rio('f.dat').bytes(10).each { |data| ... } # process the file 10 bytes at a time
|
262
|
+
# rio('f.dat').bytes(10) { |data| ... } # same thing
|
263
|
+
# rio('f.dat').bytes(10).records(2,4) { |data| ... } # only 3rd and 5th ten-byte data-block
|
264
|
+
# rio('f.dat.gz').gzip.records(2,4).bytes(10) { |data| ... } # same from a gzipped file
|
265
|
+
#
|
266
|
+
# * Iterating over directories
|
267
|
+
# rio('adir').each { |ent| ... } # execute the block for each entry in the directory 'adir'
|
268
|
+
# rio('adir').files.each { |file| ...} # only files
|
269
|
+
# rio('adir').files { |file| ...} # ditto
|
270
|
+
# rio('adir').all.files { |file| ...} # files, recurse into subdirectories
|
271
|
+
# rio('adir').dirs { |dir| ...} # only directories
|
272
|
+
# rio('adir').files('*.rb') { |file| ...} # only .rb files using a glob
|
273
|
+
# rio('adir').files(/\.rb$/) { |file| ...} # only .rb files using a regular expression
|
274
|
+
# rio('adir').all.files('*.rb') { |file| ...} # .rb files, recursing into subdirectories
|
275
|
+
# rio('adir').dirs(/^\./) { |dir| ... } # only dot directories
|
276
|
+
# rio('adir').dirs('/home/*') { |dir| ... } # home directories
|
277
|
+
#
|
278
|
+
# See RIO::Doc::HOWTO and RIO::Doc::SYNOPSIS for more examples, and RIO::Doc::INTRO for further explanation.
|
279
|
+
#
|
280
|
+
def each(*args,&block) target.each(*args,&block); self end
|
281
|
+
|
282
|
+
|
283
|
+
# For a file Rio +delete+ calls FileUtils#rm.
|
284
|
+
# For a directory Rio +delete+ calls FileUtils#rmdir
|
285
|
+
# Returns the Rio. If the Rio does not exist, simply return the Rio.
|
286
|
+
#
|
287
|
+
# rio('afile,txt').delete # delete 'afile.txt'
|
288
|
+
# rio('adir').delete # delete adir
|
289
|
+
# rio('something').delete # delete something
|
290
|
+
#
|
291
|
+
def delete() target.delete(); self end
|
292
|
+
|
293
|
+
# For a file Rio#delete! calls FileUtils#rm.
|
294
|
+
# For a directory Rio#delete! calls FileUtils#rmtree
|
295
|
+
# Returns the Rio. If the rio does not exist, simply return itself.
|
296
|
+
#
|
297
|
+
# rio('afile,txt').delete! # delete f.txt
|
298
|
+
# rio('adir').delete! # delete adir
|
299
|
+
#
|
300
|
+
# # create a directory, after deleting anything that previously had its name
|
301
|
+
# rio('adir/asubdir').delete!.mkpath
|
302
|
+
#
|
303
|
+
# ==== Deleting Summary
|
304
|
+
# * To delete something only if it is not a directory use Rio#rm
|
305
|
+
# * To delete an empty directory use Rio#rmdir
|
306
|
+
# * To delete an entire directory tree use Rio#rmtree
|
307
|
+
# * To delete anything except a populated directory use Rio#delete
|
308
|
+
# * To delete anything use Rio#delete!
|
309
|
+
#
|
310
|
+
# In all cases, deleting something that does not exist is considered successful
|
311
|
+
#
|
312
|
+
def delete!() target.delete!(); self end
|
313
|
+
|
314
|
+
# Grande Copy-To Operator
|
315
|
+
#
|
316
|
+
# The copy grande-operator copies a Rio to a another Rio or another ruby object. The behaviour
|
317
|
+
# and the library used depend on the types of the of the source and destination. For
|
318
|
+
# simple file or directory copying ::FileUtils#cp or ::FileUtils#cp_r will be used. If
|
319
|
+
# any of the Rio grande methods are specified for the source or destination, the
|
320
|
+
# source Rio will be iterated through copying records to the destintion as specified. Roughly
|
321
|
+
# equivelant to
|
322
|
+
# dst = rio('dst_file')
|
323
|
+
# rio('src_file').each do |line|
|
324
|
+
# dst.print(line)
|
325
|
+
# end
|
326
|
+
# dst.close
|
327
|
+
#
|
328
|
+
# The destination of the copy operators may be a:
|
329
|
+
# IO:: Each record of the Rio is written to the IO using IO#print. The IO must be opened for writing.
|
330
|
+
# Array:: Each record or entry of the Rio becomes an element of the array
|
331
|
+
# String:: Puts the entire contents of the Rio into the string
|
332
|
+
# Rio:: Depends on the destination. See below.
|
333
|
+
#
|
334
|
+
# Copy a file to a file
|
335
|
+
# rio('src_file') > rio('dst_file')
|
336
|
+
#
|
337
|
+
# Copy a file to a directory
|
338
|
+
# rio('src_file') > rio('dst_dir')
|
339
|
+
#
|
340
|
+
# Copy a directory to another directory
|
341
|
+
# rio('src_dir') > rio('dst_dir')
|
342
|
+
#
|
343
|
+
# Make an ungizipped copy of a gzipped file
|
344
|
+
# rio('src.txt.gz').gzip > rio('dst.txt')
|
345
|
+
#
|
346
|
+
# Copying to an array
|
347
|
+
# rio('afile') > ary # each line of the file becomes and element of the ary
|
348
|
+
# rio('afile').chomp > ary # same thing with lines chomped
|
349
|
+
# rio('afile.gz').gzip.chomp > ary # same thing from a gzipped file
|
350
|
+
#
|
351
|
+
# rio('afile').lines(0..9) > ary # ary will contain only the first ten lines of the file
|
352
|
+
# rio('afile').chomp.lines(0..9) > ary # same thing with lines chomped
|
353
|
+
# rio('afile').gzip.chomp.lines(0..9) > ary # same thing from a gzipped file
|
354
|
+
#
|
355
|
+
# rio('afile').nolines(0..9) > ary # ary will contain all but the first ten lines of the file
|
356
|
+
#
|
357
|
+
# rio('adir') > ary # ary will contain a Rio for each entry in the directory
|
358
|
+
# rio('adir').files > ary # same, but only files
|
359
|
+
# rio('adir').files('*.rb') >ary # same, but only .rb files
|
360
|
+
#
|
361
|
+
# Copying to a string
|
362
|
+
# rio('afile') > astring # slurp the entire contents of the file into astring
|
363
|
+
# astring = rio('afile').slurp # same effect
|
364
|
+
#
|
365
|
+
# Copy the first line *and* every line containing the word Rio into a gzipped file
|
366
|
+
# rio('src').lines(1,/Rio/) > rio('dst.gz').gzip
|
367
|
+
#
|
368
|
+
# Copy lines of a web page into an array with each line chomped
|
369
|
+
# rio('http://ruby-doc.org/index.html').chomp > an_array
|
370
|
+
#
|
371
|
+
# Copy the first and 8th through 10th columns of the first ten rows of a gzipped csv
|
372
|
+
# file on a web site into a local gzipped csv file that uses semi-colons as separators
|
373
|
+
# rio('http://domain/file.csv.gz').columns(0,7..9).gzip.csv[0..9] > rio('localfile.csv.gz').csv(';').gzip
|
374
|
+
#
|
375
|
+
def >(destination) target > destination; self end
|
376
|
+
|
377
|
+
# Grande Append-To Operator
|
378
|
+
#
|
379
|
+
# The append-to grande-operator is the same as Rio#> (copy-to) except that it opens the destination
|
380
|
+
# for append.
|
381
|
+
# The destination can be a kind of:
|
382
|
+
# IO:: Each record of the Rio is written to the IO using IO#print. The IO must be opened for writing.
|
383
|
+
# Array:: Each record or entry of the Rio is appended to the destination array
|
384
|
+
# String:: Appends the entire contents of the Rio to destination
|
385
|
+
# Rio:: Just like Rio#> (copy-to) except the unopened object are
|
386
|
+
# opened for append. If the destination is already opened for writing or is a
|
387
|
+
# directory, this is identical to Rio#> (copy-to)
|
388
|
+
#
|
389
|
+
# See Rio#> (copy-to)
|
390
|
+
#
|
391
|
+
# rio('afile') >> rio('anotherfile') # append the contents of 'afile' to 'anotherfile'
|
392
|
+
# rio('afile') >> rio('adir') # copies 'afile' to the directory 'adir'
|
393
|
+
# rio('adir') >> rio('anotherdir') # copy directory 'adir' recursively to 'anotherdir'
|
394
|
+
# rio('adir') >> array # appendscopy directory 'adir' recursively to 'anotherdir'
|
395
|
+
# rio('adir') >> ary # a Rio for each entry in the directory will be appended to ary
|
396
|
+
def >>(destination) target >> destination; self end
|
397
|
+
|
398
|
+
|
399
|
+
# Grande Append-From Operator
|
400
|
+
#
|
401
|
+
# The append-from grande-operator copies a Rio from another Rio or another ruby object. This
|
402
|
+
# behaves like Rio#< (copy-from) except unopened Rios are opened for append.
|
403
|
+
#
|
404
|
+
# The following summarizes how objects are copied:
|
405
|
+
# IO:: IO#each is used to iterate through the source with each record appended to the Rio
|
406
|
+
# Array:: Each element of the Array is appended individually to the Rio.
|
407
|
+
# String:: The string is appended to the Rio using Rio#print
|
408
|
+
# Rio:: The source Rio is appended using its Rio#>> (append-to) operator
|
409
|
+
#
|
410
|
+
# See Rio#< (copy-from)
|
411
|
+
def <<(source) target << source; self end
|
412
|
+
|
413
|
+
# Grande Copy-From Operator
|
414
|
+
#
|
415
|
+
# The copy-from grande-operator copies a Rio from another Rio or another ruby object.
|
416
|
+
# Its operation is dependent on the the file system objects referenced, the rio
|
417
|
+
# options set, and the state of its source and destination. In the broadest of terms
|
418
|
+
# it could be described as doing the following:
|
419
|
+
# source.each do |entry|
|
420
|
+
# destination << entry
|
421
|
+
# end
|
422
|
+
# That is to say, it iterates through its argument, calling the copy-from operator
|
423
|
+
# again for each element. While it is not implemented like this, and the above code would
|
424
|
+
# not give the same results, This generalized description is convenient.
|
425
|
+
# For example the code:
|
426
|
+
# dst < src
|
427
|
+
# # is like
|
428
|
+
# src.each { |line| dst << line }
|
429
|
+
# for any of the following definitions of src and dst
|
430
|
+
# * copying files
|
431
|
+
# src = rio('afile')
|
432
|
+
# dst = rio('acopy')
|
433
|
+
# * copying parts of files
|
434
|
+
# src = rio('afile').lines(0..9)
|
435
|
+
# dst = rio('acopy')
|
436
|
+
# * copying directories
|
437
|
+
# src = rio('srcdir')
|
438
|
+
# dst = rio('dstdir')
|
439
|
+
# * copy directories selectively
|
440
|
+
# src = rio('srcdir').dirs(/^\./).files('*.tmp')
|
441
|
+
# dst = rio('dstdir')
|
442
|
+
# * copying to a file from an array
|
443
|
+
# src = ["line0\n","line1\n"]
|
444
|
+
# dst = rio('afile')
|
445
|
+
# * copying to a directory from an array
|
446
|
+
# array = [rio("file1"),rio("file2")]
|
447
|
+
# dst = rio('adir')
|
448
|
+
#
|
449
|
+
# Arrays are handled differently depending on whether the rio references a file or a directory.
|
450
|
+
# * If the destination is a file.
|
451
|
+
# dest = rio('afile')
|
452
|
+
# dest < array
|
453
|
+
# # is roughly equivelent to
|
454
|
+
# array.each do |el|
|
455
|
+
# case el
|
456
|
+
# when ::String then dest.print(el)
|
457
|
+
# when ::Rio then dest << el
|
458
|
+
# else dest << rio(el)
|
459
|
+
# end
|
460
|
+
# * If the destination is a directory
|
461
|
+
# dest = rio('adir')
|
462
|
+
# dest < array
|
463
|
+
# # is roughly equivelent to
|
464
|
+
# array.each do |el|
|
465
|
+
# case el
|
466
|
+
# when ::String then rio(el)
|
467
|
+
# when ::Rio then dest << el
|
468
|
+
# else dest << rio(el)
|
469
|
+
# end
|
470
|
+
#
|
471
|
+
# To improve run-time efficiency, Rio will choose from among several strategies when
|
472
|
+
# copying. For instance when no file or directory filtering is specified, FileUtils#cp_r is
|
473
|
+
# used to copy directories; and when no line filtering is specified, FileUtils#cp is used to copy
|
474
|
+
# files.
|
475
|
+
#
|
476
|
+
# rio('adir') < rio('anotherdir') # 'anotherdir' is copied to 'adir' using FileUtils#cp_r
|
477
|
+
# rio('adir') < rio('anotherdir').files('*.rb') # copy only .rb files
|
478
|
+
# rio('afile') < rio('anotherfile') # 'anotherfile' is copied to 'afile' using FileUtils#cp
|
479
|
+
# rio('afile') < ios # ios must be an IO object opened for reading
|
480
|
+
# rio('afile') < astring # basically the same as rio('afile').print(astring)
|
481
|
+
#
|
482
|
+
# anarray = [ astring, rio('anotherfile') ]
|
483
|
+
# rio('afile') < anarray # copies each element to 'afile' as if one had written
|
484
|
+
# ario = rio('afile')
|
485
|
+
# anarray.each do |el|
|
486
|
+
# ario << el
|
487
|
+
# end
|
488
|
+
# ario.close
|
489
|
+
# rio('skeldir') < rio('adir').dirs # copy only the directory structure
|
490
|
+
# rio('destdir') < rio('adir').dirs.files(/^\./) # copy the directory structure and all dot files
|
491
|
+
#
|
492
|
+
# See also Rio#> (copy-to), Rio#each, Rio#[]
|
493
|
+
#
|
494
|
+
def <(source) target < source; self end
|
495
|
+
|
496
|
+
# Reads and returns the next record from a Rio, honoring the grande selection methods.
|
497
|
+
#
|
498
|
+
# Returns nil on end of file.
|
499
|
+
#
|
500
|
+
# See also Rio#records, Rio#lines, Rio#each, Rio#[]
|
501
|
+
#
|
502
|
+
# ario = rio('afile').lines(10..12)
|
503
|
+
# line10 = ario.getrec
|
504
|
+
# line11 = ario.getrec
|
505
|
+
# line12 = ario.getrec
|
506
|
+
# a_nil = ario.getrec
|
507
|
+
def getrec() target.getrec() end
|
508
|
+
|
509
|
+
end
|
510
|
+
end
|