焦油

读取、写入和操作“.tar”存档文件。

LTS哈斯克尔22.20:0.5.1.1@转速:10
2024-05-05夜间堆垛:0.6.2.0
Hackage的最新消息：0.6.2.0

查看所有快照焦油出现在中

BSD-3许可条款通过邓肯·库茨<[电子邮件保护]>比约恩·布林格特
维护人Bodigrim公司
此版本可以与以下内容一起固定在堆栈中：焦油-0.6.2.0@sha256：619828cae098a7b6deeb0316e12f5501101d88f756787ed02ceedb81cf1eba，4576

0.6.2.0的模块文档

此软件包没有文档化的模块。

取决于1个软件包(包含版本的完整列表):
焦油

焦油哈卡奇

此库用于.tar文件归档文件。它可以读取和写入一系列常见的存档格式变体，包括V7、POSIX USTAR和GNU格式。它支持打包和解压缩便携式存档，并提供了使用索引随机访问存档内容的功能。

有关API的快速入门，请参阅htar/htar.hs，它实现了一个非常基本的焦油命令行工具。

运行基准测试下载01-索引.tar到程序包文件夹中：

wget公司https://hackage.haskell.org/01-索引.tar阴谋家的长凳

变化

0.6.2.0尸体[电子邮件保护]2024年3月

  • 修复文件名中Unicode支持的问题。

0.6.1.0尸体[电子邮件保护]2024年1月

  • 支持文件名中的Unicode（编码为UTF-8）。
  • 在解压缩大文件时减少峰值内存消耗。

0.6.0.0尸体[电子邮件保护]2023年12月

此版本支持长文件路径和符号链接（感谢朱利安·奥斯帕德）以及各种变化和改进在整个包中，修复了静默数据损坏的多个原因。

中断更改：

  • 泛化条目，条目和条目内容到GenEntries（基因条目），GenEntry（发电机条目）和GenEntryContent公司.
    • 处理条目的函数已被推广到更多多态类型，如果可能的话。
    • 用于导入编解码器。档案文件。焦油（入口（..））现在应该导入编解码器。存档。焦油（入口，模式入口）其他类似消息-类型。另一个选项是导入合格的整个模块。
  • 重新设计编解码器。档案文件。焦油。检查.
    • 更改的类型检查安全性，检查Tarbomb，检查便携性.
    • 将有问题的路径作为新字段添加到TarBomb错误构造函数。
    • 延伸文件名错误具有不安全链接目标构造函数。
  • 删除不推荐的空索引和最终索引.

迁移示例：

错误修复：

  • 通过GNU扩展添加对超长文件路径的支持。
    • 现在条目路径对应于内部、低级路径、受限路径到255个字符。要正确列出文件名，请使用解码长名称，然后entryTarPath（条目目标路径）.
  • 修复硬链接和符号链接的处理。
  • 处理大于8 GB的文件，避免无提示损坏。
  • 禁止非ASCII文件名，而不是静默式损坏。
  • 设置解压缩文件的权限。
  • 设置修改时间时忽略FAT32错误。
  • 仅在完整的块之后切换到尾部解析模式NUL（无）.

新API：

  • 添加可遍历条目实例。
  • 添加目标路径'，目标路径结果，longLinkEntry（长链接条目），长SymLinkEntry.
  • 添加数据包SymlinkEntry和符号链接权限.
  • 添加打包和检查和拆包并检查.
  • 添加checkEntrySecurity（检查条目安全性），选中EntryTarbomb和选中条目便携性.
  • 添加编码长名称，解码长名称，解码长名称错误.

改进：

  • 加快来自TarPath，从TarPath到PosixPath和从目标路径到Windows路径.
  • 减轻中文件句柄的泄漏包文件条目.
  • 修复32位体系结构上的测试。

0.5.1.1赫伯特·瓦莱里奥·里德尔[电子邮件保护]2019年8月

  • 添加对GHC 8.8.1/base-4.13的支持

0.5.1.0赫伯特·瓦莱里奥·里德尔[电子邮件保护]2018年3月

  • 添加对GHC 8.4.1/base-4.11的支持
  • 添加半群的实例条目

0.5.0.3邓肯·库茨[电子邮件保护]2016年5月

0.5.0.2邓肯-库茨[电子邮件保护]2016年4月

  • 修复使用ghc-7.4.x和目录>=1.2.3时的兼容性

0.5.0.1邓肯·库茨[电子邮件保护]2016年1月

  • 修复与目录的兼容性1.2.3+

0.5.0.0邓肯·库茨[电子邮件保护]2016年1月

  • 使用旧版本的bytestring（使用bytestring-builder包）。
  • 使用GHC 6.10–8.0构建。
  • 将Index.serialise的类型更改为简单的strict bytesting。
  • 在解压缩时保留文件时间戳（使用目录-1.2.3+）

0.4.5.0邓肯·库茨[电子邮件保护]2016年1月

  • 恢复0.4.x系列中意外的轻微API更改（所有者和组名称字符串）。0.4.3.0和0.4.4.0版本包含API意外更改。
  • 添加一个方便的foldlEntries函数

0.4.4.0邓肯·库茨[电子邮件保护]2016年1月

  • GHC 7.10和8.0的构建和警告修复
  • 新建索引模块功能到列表获取所有索引项

0.4.3.0邓肯·库茨[电子邮件保护]2016年1月

  • 新建Index函数未完成扩展现有索引
  • 读取速度提高9倍
  • 索引构建速度提高9倍
  • 索引扩展速度提高24倍
  • 更紧凑的条目类型，使用ByteString
  • 更多Eq和Show实例
  • 更大的QC测试覆盖范围
  • 修复读取非标准v7格式条目时的小错误

0.4.2.2埃德斯科·德弗里斯[电子邮件保护]2015年10月

  • 修复索引中的错误

0.4.2.1邓肯·库茨[电子邮件保护]2015年7月

  • 修复Index模块的测试（代码正确）

0.4.2.0邓肯·库茨[电子邮件保护]2015年7月

  • 用于随机访问tar文件内容的新索引模块
  • 新的较低级别tar文件I/O操作
  • 新建tarball文件“append”操作

0.4.1.0邓肯·库茨[电子邮件保护]2015年1月

  • 与GHC 7.10一起构建
  • 从旧的时间包切换到时间包
  • 为条目类型添加了更多实例

0.4.0.1邓肯·库茨[电子邮件保护]2012年10月

  • 修复了与目录1.2一起使用的问题
  • 更多Eq/Ord实例

0.4.0.0邓肯·库茨[电子邮件保护]2012年2月

  • 更明确的错误类型和错误处理
  • 支持星形-256数字格式
  • 改进的API文档