v0.7.0

Changes

💡 Feature

• Add support for customizing filename:
  • Edit KTOOLBOX_JOB__FILENAME_FORMAT in prod.env or environment variables to set this option (#116)
  • 📖More information: Configuration-Reference-JobConfiguration

    # Rename attachments in numerical order, e.g. `1.png`, `2.png`, ...
    KTOOLBOX_JOB__SEQUENTIAL_FILENAME=True
    
    # `{}`: Basic filename
    # Can be used with the configuration option above.
    # Rename attachments to `[2024-1-1]_1.png`, `[2024-1-1]_2.png`, ...
    KTOOLBOX_JOB__FILENAME_FORMAT="[{published}]_{}"

• Change default post text content filename index.html to content.txt

---

💡 新特性

• 支持自定义下载的文件名格式：
  • 在 prod.env 或环境变量中编辑 KTOOLBOX_JOB__FILENAME_FORMAT 以设置该选项 (#116)
  • 📖更多信息: 配置-参考-JobConfiguration

    # 按照数字顺序重命名附件, 例如 `1.png`, `2.png`, ...
    KTOOLBOX_JOB__SEQUENTIAL_FILENAME=True
    
    # `{}`：基本文件名
    # 可以和上面的配置选项搭配使用
    # 附件将被重命名为 `[2024-1-1]_1.png`, `[2024-1-1]_2.png`, ...
    KTOOLBOX_JOB__FILENAME_FORMAT="[{published}]_{}"

• 更改默认的作品文本内容文件名 index.html 为 content.txt

Full Changelog: v0.6.0...v0.7.0

v0.6.0

Changes

💡 Feature

• Add support for filename allow-list/block-list to filter downloaded files.
  • Use Unix shell-style wildcards
  • Edit KTOOLBOX_JOB__ALLOW_LIST, KTOOLBOX_JOB__BLOCK_LIST in prod.env or environment variables to set this option
  • 📖More information: Configuration-Reference-JobConfiguration

    # Only download files that match these patterns
    KTOOLBOX_JOB__ALLOW_LIST=["*.jpg","*.jpeg","*.png"]
    
    # Not to download files that match these patterns
    KTOOLBOX_JOB__BLOCK_LIST=["*.psd"]

• Default not to save creator-indices.ktoolbox (because it's useless now :(

🪲 Fix

• Fix missing Post.file.name may cause download file (Post.file) named to None

---

💡 新特性

• 增加文件名白名单/黑名单支持以进行下载文件的过滤
  • 使用 Unix 风格通配符
  • 在 prod.env 或环境变量中编辑 KTOOLBOX_JOB__POST_DIRNAME_FORMAT 以设置该选项
  • 📖更多信息: Configuration-Reference-JobConfiguration

    # 只下载匹配这些模式的文件
    KTOOLBOX_JOB__ALLOW_LIST=["*.jpg","*.jpeg","*.png"]
    
    # 不下载匹配这些模式的文件
    KTOOLBOX_JOB__BLOCK_LIST=["*.psd"]

• 默认不保存 creator-indices.ktoolbox （因为它现在已经没什么用了 :(

🪲 修复

• 修复缺失 Post.file.name 可能导致下载文件（Post.file）被命名为 None

Full Changelog: v0.5.2...v0.6.0

v0.5.2

Changes

🪲 Fix

• Fix FileNotFoundError occurred when filename contains special characters (#94)
• Fix TypeError occurred when using --start-time, --end-time options and posts had no published property (#93)
• Fixed incorrect argument order when using bucket storage (#89 - @Nacosia)
• Duplicate file check after HTTP connection started (#88)

---

🪲 修复

• 修复当文件名包含特殊字符时会出现 FileNotFoundError 错误的问题 (#94)
• 修复当使用 --start-time, --end-time 参数且作品 published 属性不存在的情况下会出现 TypeError 错误的问题 (#93)
• 修复当使用桶储存时参数顺序不正确的问题 (#89 - @Nacosia)
• 在建立 HTTP 连接后进行重复文件检查 (#88)

Full Changelog: v0.5.1...v0.5.2

v0.5.1

Changes

💡 Feature

• Added support for downloading posts within a specified range of quantity.

  • Added --offset, --length options in sync-creator command
  • --offset: Posts result offset (or start offset)
  • --length: The number of posts to fetch, defaults to fetching all posts

  # Download latest 10 posts of the creator/artist
  ktoolbox sync-creator https://kemono.su/fanbox/user/xxxx --length=10
  
  # Download latest No.11-No.15 posts of the creator/artist
  ktoolbox sync-creator https://kemono.su/fanbox/user/xxxx --offset=10 --length=5
  
  # Download all posts of the creator/artist
  ktoolbox sync-creator https://kemono.su/fanbox/user/xxxx

---

💡 新特性

• 增加下载指定数量范围作品的支持

  • 在 sync-creator 命令中增加了 --offset, --length 选项
  • --offset：作品结果偏移量（或起始偏移量）
  • --length：要获取的作品数量，默认获取所有作品

  # 下载作者/画师最新的 10 个作品
  ktoolbox sync-creator https://kemono.su/fanbox/user/xxxx --length=10
  
  # 下载作者/画师最新的第 11 至 15 个作品
  ktoolbox sync-creator https://kemono.su/fanbox/user/xxxx --offset=10 --length=5
  
  # 下载作者/画师的所有作品
  ktoolbox sync-creator https://kemono.su/fanbox/user/xxxx

Full Changelog: v0.5.0...v0.5.1

v0.5.0

Changes

🐍 Fix

• Fixed download failure when server returns an invalid filename (Attachment.name) (#73)

💡 Feature

• Add support for local storage bucket mode (#74) (@Nacosia)

  • Edit KTOOLBOX_DOWNLOADER__USE_BUCKET, KTOOLBOX_DOWNLOADER_BUCKET_PATH in prod.env or environment variables to set this option
  • 📖More information: Configuration-Reference-DownloaderConfiguration

• Add support for customizing the post directory name format (#45, #46)

  • Edit KTOOLBOX_JOB__POST_DIRNAME_FORMAT in prod.env or environment variables to set this option
  • 📖More information: Configuration-Reference-JobConfiguration

  # It will create directories like `[2024-1-1]HelloWorld`
  KTOOLBOX_JOB__POST_DIRNAME_FORMAT="[{published}]{title}"

  # It will create directories like `2024-1-1_12345_112233`
  KTOOLBOX_JOB__POST_DIRNAME_FORMAT="{published}_{user}_{id}"

  # Default value. It will create directories like `HelloWorld`
  KTOOLBOX_JOB__POST_DIRNAME_FORMAT="{title}"

• Marked JobConfiguration.post_id_as_path as deprecated, use JobConfiguration.post_dirname_format instead

---

🐍 修复

• 修复当服务器返回的文件名不合法时下载出错的问题 (Attachment.name) (#73)

💡 新特性

• 增加本地存储桶模式的存储支持 (#74) (@Nacosia)

  • 在 prod.env 或环境变量中编辑 KTOOLBOX_DOWNLOADER__USE_BUCKET, KTOOLBOX_DOWNLOADER_BUCKET_PATH 以设置该选项
  • 📖更多信息: Configuration-Reference-DownloaderConfiguration

• 增加支持自定义作品目录名格式 (#45, #46)

  • 在 prod.env 或环境变量中编辑 KTOOLBOX_JOB__POST_DIRNAME_FORMAT 以设置该选项
  • 📖更多信息: Configuration-Reference-JobConfiguration

  # 将会创建例如 `[2024-1-1]HelloWorld` 的目录名
  KTOOLBOX_JOB__POST_DIRNAME_FORMAT="[{published}]{title}"

  # 将会创建例如 `2024-1-1_12345_112233` 的目录名
  KTOOLBOX_JOB__POST_DIRNAME_FORMAT="{published}_{user}_{id}"

  # 默认值。 将会创建例如 `HelloWorld` 的目录名
  KTOOLBOX_JOB__POST_DIRNAME_FORMAT="{title}"

• 将 JobConfiguration.post_id_as_path 标记为已弃用, 请用 JobConfiguration.post_dirname_format 取代

Full Changelog: v0.4.0...v0.5.0

v0.5.0-beta.1

Changes

🐍 Fix

• Fixed download failure when server returns an invalid filename (Attachment.name) (#73)

💡 Feature

• Add support for local storage bucket mode (#74) (@Nacosia)

  • Edit KTOOLBOX_DOWNLOADER__USE_BUCKET, KTOOLBOX_DOWNLOADER_BUCKET_PATH to set this option
  • 📖More information: Configuration-Reference-DownloaderConfiguration

• Add support for customizing the post directory name format (#45, #46)

  • Edit KTOOLBOX_JOB__POST_DIRNAME_FORMAT to set this option
  • 📖More information: Configuration-Reference-JobConfiguration

  # It will create directories like `[2024-1-1]HelloWorld`
  KTOOLBOX_JOB__POST_DIRNAME_FORMAT="{published}{title}"

  # It will create directories like `[2024-1-1]_12345_112233`
  KTOOLBOX_JOB__POST_DIRNAME_FORMAT="{published}_{user}_{id}"

  # Default value. It will create directories like `HelloWorld`
  KTOOLBOX_JOB__POST_DIRNAME_FORMAT="{title}"

• Marked JobConfiguration.post_id_as_path as deprecated, use JobConfiguration.post_dirname_format instead

---

🐍 修复

• 修复当服务器返回的文件名不合法时下载出错的问题 (Attachment.name) (#73)

💡 新特性

• 增加本地存储桶模式的存储支持 (#74) (@Nacosia)

  • 编辑 KTOOLBOX_DOWNLOADER__USE_BUCKET, KTOOLBOX_DOWNLOADER_BUCKET_PATH 以设置该选项
  • 📖更多信息: Configuration-Reference-DownloaderConfiguration

• 增加支持自定义作品目录名格式 (#45, #46)

  • 编辑 KTOOLBOX_JOB__POST_DIRNAME_FORMAT 以设置该选项
  • 📖更多信息: Configuration-Reference-JobConfiguration

  # 将会创建例如 `[2024-1-1]HelloWorld` 的目录名
  KTOOLBOX_JOB__POST_DIRNAME_FORMAT="{published}{title}"

  # 将会创建例如 `[2024-1-1]_12345_112233` 的目录名
  KTOOLBOX_JOB__POST_DIRNAME_FORMAT="{published}_{user}_{id}"

  # 默认值。 将会创建例如 `HelloWorld` 的目录名
  KTOOLBOX_JOB__POST_DIRNAME_FORMAT="{title}"

• 将 JobConfiguration.post_id_as_path 标记为已弃用, 请用 JobConfiguration.post_dirname_format 取代

Full Changelog: v0.4.0...v0.5.0-beta.1

v0.4.0

Changes

• Removed --update-from flag
• Set LoggerConfiguration.path defaults to None (KToolBox will no longer output logs to files by default)
• Fixed the issue where downloading files with the same name but different suffix simultaneously would fail.
• Documents update (Coomer)

---

• 删除了 --update-from 标志
• 将 LoggerConfiguration.path 的默认值设置为 None（KToolBox 默认不再将日志输出到文件）
• 修复了同时下载具有相同名称但不同后缀的文件会失败的问题。
• 文档更新（Coomer）

Full Changelog: v0.3.6...v0.4.0

v0.3.6

Changes

• Use binary prefixes(1Ki=1024, KiB, MiB, GiB, ...) in download speed units

Full Changelog: v0.3.5...v0.3.6

v0.3.5

Changes

v0.3.5

• Update dependency httpx
  • httpx = {version=">=0.24.1,<0.26.0", extras=["socks"]}

v0.3.4

• Added the JobConfiguration.sequential_filename configuration option for renaming attachments in numerical order #33
  • Set KTOOLBOX_JOB__SEQUENTIAL_FILENAME=True to enable
  • 📖More information: Configuration-Reference-JobConfiguration

Full Changelog: v0.3.4...v0.3.5

v0.3.4

Changes

• Added the JobConfiguration.sequential_filename configuration option for renaming attachments in numerical order #33
  • Set KTOOLBOX_JOB__SEQUENTIAL_FILENAME=True to enable
  • 📖More information: Configuration-Reference-JobConfiguration

Full Changelog: v0.3.2...v0.3.4