refactor: 重构下载模块并更新项目配置

- 升级版本号至1.1.21，更新项目元数据描述和分类
- 删除poetry.lock和uv.lock文件，统一使用pyproject.toml管理依赖
- 重构下载模块(base.py, book.py, rss.py)，添加类型注解和文档字符串
- 改进错误处理和代码健壮性，添加更详细的异常处理
- 统一工具函数到utils/core.py模块，提高代码复用性
- 添加RSS源格式化类(RSSSourceFormat)和导出功能
- 更新代码格式配置，遵循ruff和black规范
- 修复示例文件中的代码格式问题

这些改进提升了代码的可维护性和可读性，同时保持了向后兼容性。

Author: farfun

example/run3.py

@@ -12,9 +12,7 @@ def run1():
     task.snapshot_download()
     task.url_manage.delete_all()
     # task.add_book_source("https://bitbucket.org/xiu2/yuedu/raw/master/shuyuan")
-    task.add_rss_source(
-        "https://jt12.de/SYV2/2023/03/17/0/02/42/167898256264133da2869d4.json"
-    )
+    task.add_rss_source("https://jt12.de/SYV2/2023/03/17/0/02/42/167898256264133da2869d4.json")
     task.snapshot_upload()
 
 

poetry.lock

@@ -1,7 +1,60 @@
 [project]
 name = "funread"
-version = "1.1.20"
-description = "Add your description here"
+version = "1.1.21"
+description = "一个用于管理和处理阅读源（Legado 阅读 APP 的书源和 RSS 源）的 Python 工具库"
 readme = "README.md"
 requires-python = ">=3.8"
+keywords = [ "legado", "reading", "book-source", "rss", "ebook",]
+classifiers = [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: Apache Software License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Text Processing :: Markup",]
 dependencies = [ "dominate>=2.9.1", "funfile>=1.0.11", "funutil>=1.0.25",]
+[[project.authors]]
+name = "牛哥"
+email = "niuliangtao@qq.com"
+
+[[project.authors]]
+name = "farfarfun"
+email = "farfarfun@qq.com"
+
+[[project.maintainers]]
+name = "牛哥"
+email = "niuliangtao@qq.com"
+
+[[project.maintainers]]
+name = "farfarfun"
+email = "farfarfun@qq.com"
+
+[build-system]
+requires = [ "hatchling",]
+build-backend = "hatchling.build"
+
+[project.license]
+text = "Apache-2.0"
+
+[project.optional-dependencies]
+dev = [ "pytest>=7.0.0", "pytest-cov>=4.0.0", "ruff>=0.1.0", "mypy>=1.0.0", "black>=23.0.0",]
+
+[project.urls]
+Organization = "https://github.com/farfarfun"
+Repository = "https://github.com/farfarfun/funread"
+Releases = "https://github.com/farfarfun/funread/releases"
+
+[tool.ruff]
+line-length = 100
+target-version = "py38"
+
+[tool.black]
+line-length = 100
+target-version = [ "py38",]
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+
+[tool.setuptools]
+license-files = []
+
+[tool.ruff.lint]
+select = [ "E", "F", "I", "N", "W",]
+ignore = [ "E501",]

pyproject.toml

@@ -1,4 +1,15 @@
+"""源下载和管理模块"""
+
 from .base import DownloadSource
-from .book import BookSourceFormat, BookSourceDownload
+from .book import BookSourceDownload, BookSourceFormat
 from .generate import GenerateSourceTask
-from .rss import RSSSourceDownload
+from .rss import RSSSourceDownload, RSSSourceFormat
+
+__all__ = [
+    "DownloadSource",
+    "BookSourceFormat",
+    "BookSourceDownload",
+    "GenerateSourceTask",
+    "RSSSourceDownload",
+    "RSSSourceFormat",
+]