authorgravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2025-07-20 17:21:33-07:00
committergravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2025-07-22 09:41:43-07:00
log2ac81c76e3d176d4ac0c568d195d5b979078a938
tree0790efae8f995fd977e40333700f7871be192629
parentaf0a02a2de8fad56029cccbfeb6254a2c2169b51

std.Io: add deprecation warnings

1 files changed, 25 insertions(+), 16 deletions(-)

lib/std/Io.zig+25-16
......@@ -435,25 +435,33 @@ pub fn GenericWriter(
435435pub const AnyReader = @import("Io/DeprecatedReader.zig");
436436/// Deprecated in favor of `Writer`.
437437pub const AnyWriter = @import("Io/DeprecatedWriter.zig");
438
438/// Deprecated in favor of `File.Reader` and `File.Writer`.
439439pub const SeekableStream = @import("Io/seekable_stream.zig").SeekableStream;
440
440/// Deprecated in favor of `Writer`.
441441pub const BufferedWriter = @import("Io/buffered_writer.zig").BufferedWriter;
442/// Deprecated in favor of `Writer`.
442443pub const bufferedWriter = @import("Io/buffered_writer.zig").bufferedWriter;
443
444/// Deprecated in favor of `Reader`.
444445pub const BufferedReader = @import("Io/buffered_reader.zig").BufferedReader;
446/// Deprecated in favor of `Reader`.
445447pub const bufferedReader = @import("Io/buffered_reader.zig").bufferedReader;
448/// Deprecated in favor of `Reader`.
446449pub const bufferedReaderSize = @import("Io/buffered_reader.zig").bufferedReaderSize;
447
450/// Deprecated in favor of `Reader`.
448451pub const FixedBufferStream = @import("Io/fixed_buffer_stream.zig").FixedBufferStream;
452/// Deprecated in favor of `Reader`.
449453pub const fixedBufferStream = @import("Io/fixed_buffer_stream.zig").fixedBufferStream;
450
454/// Deprecated in favor of `Reader.Limited`.
451455pub const LimitedReader = @import("Io/limited_reader.zig").LimitedReader;
456/// Deprecated in favor of `Reader.Limited`.
452457pub const limitedReader = @import("Io/limited_reader.zig").limitedReader;
453
458/// Deprecated with no replacement; inefficient pattern
454459pub const CountingWriter = @import("Io/counting_writer.zig").CountingWriter;
460/// Deprecated with no replacement; inefficient pattern
455461pub const countingWriter = @import("Io/counting_writer.zig").countingWriter;
462/// Deprecated with no replacement; inefficient pattern
456463pub const CountingReader = @import("Io/counting_reader.zig").CountingReader;
464/// Deprecated with no replacement; inefficient pattern
457465pub const countingReader = @import("Io/counting_reader.zig").countingReader;
458466
459467pub const BitReader = @import("Io/bit_reader.zig").BitReader;
......@@ -464,9 +472,9 @@ pub const bitWriter = @import("Io/bit_writer.zig").bitWriter;
464472
465473pub const tty = @import("Io/tty.zig");
466474
467/// A Writer that doesn't write to anything.
475/// Deprecated in favor of `Writer.Discarding`.
468476pub const null_writer: NullWriter = .{ .context = {} };
469
477/// Deprecated in favor of `Writer.Discarding`.
470478pub const NullWriter = GenericWriter(void, error{}, dummyWrite);
471479fn dummyWrite(context: void, data: []const u8) error{}!usize {
472480 _ = context;
......@@ -882,13 +890,14 @@ test {
882890 _ = Reader;
883891 _ = Reader.Limited;
884892 _ = Writer;
885 _ = @import("Io/bit_reader.zig");
886 _ = @import("Io/bit_writer.zig");
887 _ = @import("Io/buffered_reader.zig");
888 _ = @import("Io/buffered_writer.zig");
889 _ = @import("Io/counting_writer.zig");
890 _ = @import("Io/counting_reader.zig");
891 _ = @import("Io/fixed_buffer_stream.zig");
892 _ = @import("Io/seekable_stream.zig");
893 _ = BitReader;
894 _ = BitWriter;
895 _ = BufferedReader;
896 _ = BufferedWriter;
897 _ = CountingWriter;
898 _ = CountingReader;
899 _ = FixedBufferStream;
900 _ = SeekableStream;
901 _ = tty;
893902 _ = @import("Io/test.zig");
894903}