CCIO
Simple utilities to deal with basic Input/Output tasks in a resource-safe way. For advanced IO tasks, the user is advised to use something like Lwt or Async, that are far more comprehensive.
Examples:
# let l = CCIO.(with_in "/tmp/some_file" read_lines_l);;
# CCIO.(
with_in "/tmp/input"
(fun ic ->
let chunks = read_chunks_gen ic in
with_out ~flags:[Open_binary; Open_creat] ~mode:0o644 "/tmp/output"
(fun oc ->
write_gen oc chunks
)
)
) ;;
chunks
must be used in the scope of ic
. This will raise an error:# CCIO.(
let chunks =
with_in "/tmp/input"
(fun ic -> read_chunks_gen ic)
in
with_out ~flags:[Open_binary;Open_creat] ~mode:0o644 "/tmp/output"
(fun oc ->
write_gen oc chunks
)
) ;;
See Gen
in the gen library.
val with_in : ?mode:int -> ?flags:Stdlib.open_flag list ->
string -> (Stdlib.in_channel -> 'a) -> 'a
Open an input file with the given optional flag list, calls the function on the input channel. When the function raises or returns, the channel is closed.
val read_chunks_gen : ?size:int -> Stdlib.in_channel -> string gen
Read the channel's content into chunks of size at most size
. NOTE the generator must be used within the lifetime of the channel, see warning at the top of the file.
Read the channel's content into chunks of size at most size
. NOTE the generator must be used within the lifetime of the channel, see warning at the top of the file.
val read_chunks_iter : ?size:int -> Stdlib.in_channel -> string iter
Read the channel's content into chunks of size at most size
Read a line from the channel. Returns None
if the input is terminated. The "\n" is removed from the line.
val read_lines_gen : Stdlib.in_channel -> string gen
Read all lines. The generator should be traversed only once. NOTE the generator must be used within the lifetime of the channel, see warning at the top of the file.
Read all lines. NOTE the seq must be used within the lifetime of the channel, see warning at the top of the file.
val read_lines_iter : Stdlib.in_channel -> string iter
Read all lines.
Read the whole channel into a buffer, then converted into a string.
Read the whole channel into a mutable byte array.
val with_out : ?mode:int -> ?flags:Stdlib.open_flag list ->
string -> (Stdlib.out_channel -> 'a) -> 'a
Like with_in
but for an output channel.
val with_out_a : ?mode:int -> ?flags:Stdlib.open_flag list ->
string -> (Stdlib.out_channel -> 'a) -> 'a
Like with_out
but with the [Open_append; Open_creat; Open_wronly]
flags activated, to append to the file.
Write the given string on the channel, followed by "\n".
val write_gen : ?sep:string -> Stdlib.out_channel -> string gen -> unit
Write the given strings on the output. If provided, add sep
between every two strings (but not at the end).
Write the given strings on the output. If provided, add sep
between every two strings (but not at the end).
val write_lines : Stdlib.out_channel -> string gen -> unit
Write every string on the output, followed by "\n".
val write_lines_iter : Stdlib.out_channel -> string iter -> unit
Write every string on the output, followed by "\n".
Write every string on the output, followed by "\n".
copy_into ic oc
writes the content of ic
into oc
. It is a blocking call.
tee funs gen
behaves like gen
, but each element is given to every function f
in funs
at the time the element is produced. The returned generator will raise any exception that f
raises
How to list recursively files in a directory:
# let files = CCIO.File.read_dir ~recurse:true (CCIO.File.make "/tmp");;
# CCIO.write_lines stdout files;;
See File.walk
if you also need to list directories:
# let content = CCIO.File.walk (CCIO.File.make "/tmp");;
# Gen.map CCIO.File.show_walk_item content |> CCIO.write_lines stdout;;
module File : sig ... end