Pytils 技术文档

1. 安装指南

安装环境要求

• Python 3.6 或更高版本
• 支持的操作系统：Windows, macOS, Linux

安装步骤

1. 打开终端或命令行工具。
2. 使用 pip 安装 Pytils：

   pip install pytils
   

3. 安装完成后，可以通过以下命令验证安装是否成功：

   python -c "import pytils; print(pytils.__version__)"
   

2. 项目的使用说明

概述

Pytils 是一个专门用于处理俄语字符串的工具库，提供了以下功能：

• 俄语字符串的音译（Transliteration）
• 将数字转换为俄语单词（Numeral to words）
• 处理俄语日期格式

示例代码

以下是一些基本的使用示例：

音译（Transliteration）

from pytils import translit

# 将俄语字符串转换为音译
transliterated_string = translit.translify("Привет, мир!")
print(transliterated_string)  # 输出: Privet, mir!

数字转换为俄语单词（Numeral to words）

from pytils import numeral

# 将数字转换为俄语单词
words = numeral.in_words(123)
print(words)  # 输出: сто двадцать три

处理俄语日期格式

from pytils import dt

# 获取当前日期的俄语格式
russian_date = dt.ru_strftime("%d %B %Y", inflected=True)
print(russian_date)  # 输出: 例如 "01 октября 2023"

3. 项目API使用文档

translit 模块

• translify(string): 将俄语字符串转换为音译。
• detranslify(string): 将音译字符串转换回俄语。

numeral 模块

• in_words(number): 将数字转换为俄语单词。
• choose_plural(number, variants): 根据数字选择正确的复数形式。

dt 模块

• ru_strftime(format, date=None, inflected=False): 格式化日期为俄语格式。

4. 项目安装方式

通过 pip 安装

pip install pytils

从源码安装

1. 克隆项目仓库：

   git clone https://github.com/your-repo/pytils.git
   

2. 进入项目目录：

   cd pytils
   

3. 安装依赖：

   pip install .
   

通过以上步骤，您可以成功安装并使用 Pytils 项目。