duyi-utils-joker 0.1.3__tar.gz

duyi_utils_joker-0.1.3/Agents.md

@@ -0,0 +1,7 @@
+## 工程描述
+
+这是一个Python示例工程，旨在通过这个工程学习Python工程化的一些技术。我是一个Python小白，刚刚学习完Python的语言部分，对Python的工程化完全不懂，所以我希望通过这个工程来理解Python的整个工程化。
+
+## 沟通规范
+
+**非常重要：当用户提问时，不能修改任何东西，不能新增任何东西，不能删除任何东西，仅回答用户问题即可**

duyi_utils_joker-0.1.3/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: duyi-utils-joker
+Version: 0.1.3
+Summary: 一个用于学习 Python 公共库构建和发布的示例工程
+Requires-Python: >=3.14
+Requires-Dist: markdown>=3.5
+Requires-Dist: python-dateutil>=2.8
+Description-Content-Type: text/markdown
+
+# duyi-utils
+
+一个用于学习 Python 公共库构建和发布的示例工程。
+
+## 功能
+
+- **日期工具** — 日期格式化、日期差值计算（依赖 `python-dateutil`）
+- **Markdown 工具** — Markdown 转 HTML、去除 Markdown 标记（依赖 `Markdown`）
+- **问候工具** — 简单的个性化问候
+
+## 安装
+
+```bash
+pip install duyi-utils
+```
+
+## 使用
+
+```python
+from duyi_utils import format_date, days_until, to_html, strip_markdown
+from datetime import date
+
+# 日期工具
+format_date(date(2026, 6, 1))    # => "2026年06月01日"
+days_until("2026-10-01")          # => 剩余天数
+
+# Markdown 工具
+to_html("**Hello**")             # => "<p><strong>Hello</strong></p>"
+strip_markdown("**Hello**")      # => "<strong>Hello</strong>"
+
+# 问候工具
+from duyi_utils.greeter import greet
+greet("小明")                     # => "你好, 小明!"
+```

duyi_utils_joker-0.1.3/README.md

@@ -0,0 +1,34 @@
+# duyi-utils
+
+一个用于学习 Python 公共库构建和发布的示例工程。
+
+## 功能
+
+- **日期工具** — 日期格式化、日期差值计算（依赖 `python-dateutil`）
+- **Markdown 工具** — Markdown 转 HTML、去除 Markdown 标记（依赖 `Markdown`）
+- **问候工具** — 简单的个性化问候
+
+## 安装
+
+```bash
+pip install duyi-utils
+```
+
+## 使用
+
+```python
+from duyi_utils import format_date, days_until, to_html, strip_markdown
+from datetime import date
+
+# 日期工具
+format_date(date(2026, 6, 1))    # => "2026年06月01日"
+days_until("2026-10-01")          # => 剩余天数
+
+# Markdown 工具
+to_html("**Hello**")             # => "<p><strong>Hello</strong></p>"
+strip_markdown("**Hello**")      # => "<strong>Hello</strong>"
+
+# 问候工具
+from duyi_utils.greeter import greet
+greet("小明")                     # => "你好, 小明!"
+```

duyi_utils_joker-0.1.3/pyproject.toml

@@ -0,0 +1,22 @@
+# pyproject.toml
+
+[build-system] # 构建系统配置，指定构建工具和依赖
+requires = ["hatchling"]          # 依赖的后端构建工具
+build-backend = "hatchling.build" # 使用哪个工具的哪个模块来构建项目
+
+[project] # 工程描述
+name = "duyi-utils-joker" # 发行版名称
+version = "0.1.3" # 版本号，遵循语义化版本控制
+description = "一个用于学习 Python 公共库构建和发布的示例工程" # 项目简介
+requires-python = ">=3.14" # 指定支持的 Python 版本
+readme = "README.md" # 指定项目的 README 文件路径
+dependencies = [
+    "python-dateutil>=2.8", # 依赖的第三方库，指定版本要求
+    "Markdown>=3.5",        # 另一个依赖
+]
+
+[tool.hatch.build.targets.sdist] # 配置源代码分发包
+# 配置留空，表示它会默认包含所有项目文件
+
+[tool.hatch.build.targets.wheel] # 配置 wheel 包
+packages = ["src/duyi_utils"] # 配置 wheel 包的构建目标，指定包含的包路径

duyi_utils_joker-0.1.3/src/duyi_utils/__init__.py

@@ -0,0 +1,4 @@
+from duyi_utils.markdown import to_html, strip_markdown
+from duyi_utils.date import format_date, days_until
+
+__all__ = ["to_html", "strip_markdown", "format_date", "days_until"]

duyi_utils_joker-0.1.3/src/duyi_utils/date/__init__.py

@@ -0,0 +1,13 @@
+from datetime import date
+
+from dateutil.parser import parse
+
+
+def format_date(d: date) -> str:
+    return d.strftime("%Y年%m月%d日")
+
+
+def days_until(target: str) -> int:
+    target_date = parse(target).date()
+    delta = target_date - date.today()
+    return delta.days

duyi_utils_joker-0.1.3/src/duyi_utils/greeter.py

@@ -0,0 +1,3 @@
+def greet(name: str) -> str:
+    print("greet function called")
+    return f"你好, {name}!"

duyi_utils_joker-0.1.3/src/duyi_utils/markdown/__init__.py

@@ -0,0 +1,10 @@
+import markdown
+
+
+def to_html(text: str) -> str:
+    return markdown.markdown(text)
+
+
+def strip_markdown(text: str) -> str:
+    html = markdown.markdown(text)
+    return html.removeprefix("<p>").removesuffix("</p>\n")