tar

Document public members

• Add documentation comments to all public members.

• Use extension type to represent MaybeTarFormat and TarFormat.
• Update to version 6.0.0 of package:lints.

• Use extension type to represent MaybeTarFormat and TarFormat.
• Update to version 6.0.0 of package:lints.

This avoids the questionable default of 0.
Closes #34.

• Require the mode parameter when creating TarHeaders. Previously the field had an implicit default value of 0, which made it easy to inadvertently create archives with entries that are hard to delete when extracted with other tar programs.

Migrate to recommended lints

• Migrate to recommended lints from package:lints.
• Add tags to pubspec.

• Migrate away from UnmodifiableUint8ListView which is deprecated in Dart 3.4.

• Migrate away from UnmodifiableUint8ListView which is deprecated in Dart 3.4.

1.0.3

• Fix the reader throwing a FormatException (instead of a TarException) when reading tar files with invalid UTF bytes in their PAX headers.
• Fix a range error for invalid zero-length PAX entries.

• Fix the reader throwing a FormatException (instead of a TarException) when reading tar files with invalid UTF bytes in their PAX headers.
• Fix a range error for invalid zero-length PAX entries.

• Fix a few typos in documentation comments.

• Fix a few typos in documentation comments.

• Fix an incompatibility with Dart 3.1+

• Fix an incompatibility with Dart 3.1.

• Breaking Add class modifiers where applicable.

• Breaking Add class modifiers where applicable.

0.5.6

• Allow cancelling a TarEntry.contents subscription before reading more files (#23).

• Allow cancelling a TarEntry.contents subscription before reading more files.

• Fix a crash when pausing a subscription to TarEntry.contents right before it ends.

• No user-visible changes.

• Fix generating corrupt tar files when adding lots of entries at very high speeds (#20).
• Allow tar files with invalid utf8 content in PAX header values if those values aren't used for anything important.

• Improve error messages when reading a tar entry after, or during, a call to moveNext().

• This package now supports being compiled to JavaScript.

• Improve performance when reading large archives

• Support sync encoding with tarConverter.

• Support generating tar files with GNU-style long link names
• Add format parameter to tarWritingSink and tarWriterWith

• Drop chunked_stream dependency in favor of package:async.

• Allow arbitrarily many zero bytes at the end of an archive when disallowTrailingData is enabled.

• Add disallowTrailingData parameter to TarReader. When the option is set, readNext will ensure that the input stream does not emit further data after the tar archive has been read fully.

• Remove outdated references in the documentation

• Remove TarReader.contents and TarReader.header. Use current.contents and current.header, respectively.
• Fix some minor implementation details

Most of the tar package has been rewritten, it's now based on the implementation written by Garett Tok Ern Liang in the GSoC 2020.

• Added tar prefix to exported symbols.
• Remove MemoryEntry. Use TarEntry.data to create a tar entry from bytes.
• Make WritingSink private. Use tarWritingSink to create a general StreamSink<tar.Entry>.
• TarReader is now a StreamIterator, the transformer had some design flaws.

• Support writing user and group names
• Better support for PAX-headers and large files

• Initial version