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}`）
`deprecated_version` / `require_optional_import`	版本过期提示 / 可选依赖惰性导入装饰器，同步与异步函数均支持
`singleton`	单例类装饰器（按 `__init__` 签名归一化缓存 key）
`cost_time`	函数耗时统计装饰器
`do_cprofile`	cProfile性能分析装饰器
`is_windows` / `is_linux` / `is_64bit` / `is_32bit`	平台检测
`project_to_lines` / `walk`	项目文件遍历导出（软著申请用，统一换行符并压缩连续空行，返回文件数/源码总行数统计）
`project_to_pdf`	软著用源代码 PDF 导出（完整版 + 超过 60 页时前后各 30 页提交版，需可选依赖 reportlab）
`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.2
File	Size	Uploaded
astartool-0.4.2.tar.gz	64.5 kB	Oct 13, 2026	Details

Table of built distributions (wheels) for astartool 0.4.2
File	Interpreter	ABI	Platform	Reset
astartool-0.4.2-py3-none-any.whl 74.4 kB Oct 13, 2026	Python 3	none	any	Details

Total release size: 139.0 kB

Download URL	astartool-0.4.2.tar.gz
Size	64.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`6d286ec231b742be16447730835ff3577e9413c8ecd2da8c23701a4f00e47b89`
BLAKE2b-256 checksum How to use checksums	`16d799f3b84b870b5c69f4c99bccd3214f5edbbfea84fad68d4ae64ab95d7ee3`
Upload date	Oct 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.8`

Download URL	astartool-0.4.2-py3-none-any.whl
Size	74.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cdf518cb0f524f840f22087f4710207758e0cccdbc50494fa377c378203f54a5`
BLAKE2b-256 checksum How to use checksums	`5afbd106ed3b59f0321d3f017ba21967143477908446d58658e62511321a35fe`
Upload date	Oct 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.8`