# Hans

**Repository Path**: HL-Bo/hans

## Basic Information

- **Project Name**: Hans
- **Description**: Python 中文标识符及文档扩展包
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-07-12
- **Last Updated**: 2023-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python, Documentation

## README

Hans :: Python 中文标识符及文档扩展包
======

![PyPI - Downloads](https://img.shields.io/pypi/dd/hans_identifier)
![PyPI - License](https://img.shields.io/pypi/l/hans_identifier)
![PyPI - Status](https://img.shields.io/pypi/status/hans_identifier)
![PyPI - Implementation](https://img.shields.io/pypi/implementation/hans_identifier)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/hans_identifier)

本项目提供 Python 标准库和部分第三方包的中文标识符，同时也尝试提供部分第三方项目的文档翻译。


安装
------

使用 `pip` 进行安装：

```shell
pip install hans_identifier
```


使用
------

最为基础的：

```python
# 内置常量
from hans.stdlibs.builtins_.constants import *
# 内置函数
from hans.stdlibs.builtins_.functions import *
# 内置类型
from hans.stdlibs.builtins_.types import *
# 内置异常
from hans.stdlibs.builtins_.exceptions import *
```

或者，试试更简便的：

```python
from hans.stdlibs.builtins_ import *
```

通过类似 `from hans.stdlibs.<标准库名后接下划线>.<模块> import <对象>` 的语句导入标准库中的内容，而第三方库则可以尝试： `from hans.packages.<第三方包名>.<模块> import <对象>`


支持的库 / 包
------

<!-- 每个添加功能的 feature 分支自行修改 -->
- [标准库](https://docs.python.org/zh-cn/3/library/index.html)
    + [builtins](https://docs.python.org/zh-cn/3/library/builtins.html)
    + [json](https://docs.python.org/zh-cn/3/library/json.html)
    + [pickle](https://docs.python.org/zh-cn/3/library/pickle.html)
    + [platform](https://docs.python.org/zh-cn/3/library/platform.html)
- 第三方包

完整列表见 [supports.md](./docs/supports.md)

对以下库 / 包的支持已在计划或开发中：

<!-- release 分支统一增补，完成该功能的 feature 分支自行删除 -->
- [标准库](https://docs.python.org/zh-cn/3/library/index.html)
    + [sys](https://docs.python.org/zh-cn/3/library/sys.html)
    + [os](https://docs.python.org/zh-cn/3/library/os.html)
- 第三方包

完整列表见 [features.md](./docs/features.md)


更多内容
------

### 文档

点击 [这里](./docs/index.md) 跳转至文档

查找第三方包文档的中文译本点击 [这里](./docs/packages/index.md)

### 更新摘要

<!-- CHANGELOG 文件与本处更新摘要在 release 时更新 -->
- **v23.1.0** (2023-07-13)
    + 新增对标准库 `builtins`, `json`, `pickle`, `platform` 的支持
    + 更新文档

更多内容见 [CHANGELOG.md](./CHANGELOG.md)

### 捐助与贡献

- [捐款](./docs/donate.md)
    - [捐助者名单](./docs/donate.md#捐助者名单)❤️
    - [支持作者](./docs/donate.md#支持作者)😍
- [开发](./docs/contributing.md)
    - [贡献者名单](./docs/contributing.md#贡献者名单)
    - [如何参与本项目](./docs/contributing.md#如何参与本项目)
        - [提交功能](./docs/contributing.md#提交功能)
        - [漏洞修复](./docs/contributing.md#漏洞修复)
        - [仓库管理](./docs/contributing.md#仓库管理)
    - [项目开发规范](./docs/contributing.md#项目开发规范)
        - [分支与提交](./docs/contributing.md#分支与提交)
        - [测试与发布](./docs/contributing.md#测试与发布)
        - [源代码约定](./docs/contributing.md#源代码约定)
    - [工具](./docs/tools.md)

### 许可证

[Apache 2.0](./LICENSE) © [HL-Bo](mailto:hl-bo@outlook.com)