astartool

status

A.Star私房工具包

唉~ 写了辣么多代码，总觉得过于臃肿。我把简单的代码能重复利用的摘出来作为工具包，以后就引用他了

一、安装

pip install astartool

pip install -r requirements.txt

目前此代码包含以下几部分:

类/函数	说明
`KeyMap`	双向键值映射（通过key查value，也可通过value反向查key）
`DataNode` / `LinkedList` / `Pointer`	双向循环链表及其节点/指针
`LinkedQueue`	基于链表的线程安全队列
`LazyMap` / `MutableLazyMap`	惰性求值映射，值首次访问时才计算，线程安全
`MergeMap`	合并映射，同一key的多个value通过自定义函数合并
`Heap`	基于heapq的堆封装，支持自定义键函数
`UnionFind`	并查集（路径压缩+按秩合并）
`RelationMap`	关系映射，支持有序/无序、加权/非加权
`bisect_left` / `bisect_right` / `insort_left` / `insort_right`	带自定义键函数的二分查找与插入

类	说明
`MethodNotFoundError`	方法未找到错误
`ParameterError`	参数错误
`ParameterTypeError`	参数类型错误
`ParameterValueError`	参数值错误
`LazyDictionaryError`	惰性字典基类异常
`CircularReferenceError`	循环引用错误
`ConstantRedefinitionError`	常量重定义错误

类	说明
`AstarToolException`	astartool 基础异常类
`FileReleaseLockException`	文件释放锁异常

类/函数	说明
`CalcSha1` / `CalcMD5` / `CalcSM3` / `CalcHash`	文件哈希计算（SHA1/MD5/SM3/通用）
`file_extension` / `get_file_name`	文件路径工具
`rename`	通过哈希重命名文件
`is_file_using` / `release_lock` / `release_and_delete_file`	文件锁检测与释放
`CompressionType` / `extractall` / `namelist`	压缩解压（支持zip/rar/tar/tar.gz/tar.bz2/tar.xz）
`to_excel`	数据导出为Excel
`big_file_download`	大文件分块下载
`base64_to_image`	Base64转图片

函数	说明
`ishex`	判断是否为16进制字符串
`gcd` / `lcm` / `gcdlcm`	最大公约数 / 最小公倍数
`get_primes`	获取小于n的所有质数
`prime_factorization`	质因数分解
`is_prime`	Miller-Rabin快速素数判定
`rotate_left`	循环左移位运算
`equals_zero` / `equals_zero_all` / `equals_zero_any`	矩阵零元素判断

类/函数	说明
`std_logging` / `file_logging`	日志装饰器（标准输出/文件），支持 `on_enter`/`on_exit` 输出参数（可调用或字符串模板，模板可直接引用函数形参名如 `{x}`）
`cost_time`	函数耗时统计装饰器
`do_cprofile`	cProfile性能分析装饰器
`is_windows` / `is_linux` / `is_64bit` / `is_32bit`	平台检测
`project_to_lines` / `walk`	项目文件遍历导出（软著申请用）
`model_to_doc` / `model_to_dict`	Django模型文档生成
`url_to_interface_template`	Django接口模板生成
`auto_title`	文档头自动生成（支持md/rst）

函数	说明
`get_version` / `get_main_version` / `get_complete_version`	版本号处理
`get_git_changeset`	获取最新git提交时间戳
`setup`	包装setuptools.setup
`load_install_requires`	读取requirements.txt依赖

函数	说明
`is_email`	判断是否为邮箱
`is_ip`	判断是否为IPv4地址
`is_mobile`	判断是否为手机号
`is_url`	判断是否为URL
`is_valid_number`	判断是否为有效数字
`has_Chinese`	判断是否包含中文字符
`generate_number` / `check_number`	生成/校验带时间戳编号
`force_bytes` / `force_str`	str与bytes强制转换
`to_binary` / `to_text`	six兼容的编码转换
`check_password` / `check_length` / `check_contain_upper` 等	密码强度检查

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution for astartool 0.4.1
File	Size	Uploaded
astartool-0.4.1.tar.gz	58.7 kB	Sep 20, 2026	Details

Table of built distributions (wheels) for astartool 0.4.1
File	Interpreter	ABI	Platform	Reset
astartool-0.4.1-py3-none-any.whl 68.8 kB Sep 20, 2026	Python 3	none	any	Details

Total release size: 127.5 kB

Download URL	astartool-0.4.1.tar.gz
Size	58.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`cca967a4f8274b3ce3c4cf4f298b9cbb1356bdb74addd542f95429c067251096`
BLAKE2b-256 checksum How to use checksums	`73ce210b39f32040dd21512320c619355441fd1056727fa39be342d8d7903cd2`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`

Download URL	astartool-0.4.1-py3-none-any.whl
Size	68.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5362acf8662ede25cdc9f8f182f916a67b54c6d90e14b73bdf836f1e75a2c839`
BLAKE2b-256 checksum How to use checksums	`016c93aec1c291c3a4c5c0210b63db12b725c7b7201feca05471f1e3ea984f26`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`