1. 目的
在 C/C++ 开发中使用了第三方库,具体说是 .a
, .lib
, .dll
等文件,想通过 Python 查询出这些文件中的版本号信息。
有人可能好奇,这里简单消除可能得疑虑:
-
为什么不用源代码,而用库?
因为库文件提供了良好的隔离性,避免了繁杂的编译选项指定, 避免了潜在的不小心改了代码导致的不一致
-
为什么不用包管理工具来设定和查询库文件的版本?
因为 C/C++ 历史包袱较多,不像 Java 的 Mavan, 更不像 Rust 的 Cargo + Crates。虽然有 vcpkg, conan 和 xmake 等, 但是公司自研的库并不能很好的用这些工具管理起来
于是乎, 实际工作中不少人的工程里, 把若干个 .a
文件放在 lib
目录下,每个库文件名字中并没有包含版本号信息; 而项目的运行结果不符合预期、展开排查时, 或者递交版本时, 需要清晰的列出这些依赖库文件的版本信息。
使用 Python 的原因:跨平台, 开发速度快。
2. 原理
查询库文件的版本号,其实是另一个通用问题的特定版本。
通用的问题是:在一个二进制文件中, 查找所有的字符串, 找出符合预设规则的那些字符串。
查询版本号,无非是对于公司的版本号有自己的规定, 可以从所有的字符串结果中进行过滤。由于不同公司、不同项目可能有不同的版本号规则,我们重点关注两点:
- 怎样从二进制文件获取字符串
- 怎样从若干字符串中获取想要的那个
Linux: strings 命令
在 Linux 下可以使用自带的 strings 命令, 来列出一个二进制文件中的所有字符串。以常用的 ls 命令为例,我们进行查询:
zz@Legion-R7000P% which strings
/usr/bin/strings
zz@Legion-R7000P% strings /bin/ls | more
Windows: strings 命令
Windows 并不默认带有 strings 命令, 不过微软官方提供了一个版本:
https://docs.microsoft.com/zh-cn/sysinternals/downloads/strings
3. 基于 Python 实现 strings 命令
对于 Windows 用户, 如果安装有 Python, 则可以基于 Python 实现 strings 命令等同的函数;由于 strings 的结果是非常多的字符串,往往还需要按版本号字符串特点进行过滤(正则匹配),继续使用 Python 的正则模块进行匹配是比较容易的。
def strings(fname):
"""
Remake `strings` command in Python
This function behaves like `strings` command in linux/windows.
If no desired result returned, you may just tweak the regular expression pattern.
ref: https://gist.github.com/berdario/114b2daf9b43fe924676
Example:
import arczip
for word_bytes in arczip.strings(lib_pth):
word = word_bytes.decode()
if ('version' in word):
print(word)
"""
from mmap import mmap, ACCESS_READ
import re
pattern = '([\w/.\s(:)-]{10,200})'
with open(fname, 'rb') as f, mmap(f.fileno(), 0, access=ACCESS_READ) as m:
for match in re.finditer(pattern.encode(), m):
yield match.group(0)
代码短小精悍,简单解释下:文章来源:https://www.toymoban.com/news/detail-450252.html
- 我们认为“字符串”是可以用一个正则表达式表示的: 英文字母、空格、短横杠
-
、点.
、冒号:
([\w/.\s(:)-]{10,200})'
- 我们认为字符串的长度至少为10, 至多为 200. 这个限制的目的是, 如果允许的字符串长度太长, 搜索时间会变慢,太短则很多单个字符不符合预期结果
- 使用
yield
, 迭代方式返回结果 - 支持 Windows, 支持 Linux, 基于 Python3
4. 基于Python的版本号查找
调用刚刚实现的 strings()
函数, 对得到的结果进行正则匹配,例如需要以公司名字开头,并且版本号是4位数字、用.
分隔的,那么可以是这样的实现:文章来源地址https://www.toymoban.com/news/detail-450252.html
# 匹配版本号
def containVersion(word):
versionPattern = r"_\d{1,3}.\d{1,3}.\d{1,10}.\d{1,5}"
match = re.search(versionPattern, word)
if (match is not None):
return True
return False
# 给定库文件, 打印匹配到的版本号
def print_module_version(lib_pth):
for word_bytes in strings(lib_pth):
word = word_bytes.decode()
if (word.startswith('YourCompany') and containVersion(word)):
print(word)
elif (word.startswith('your_company') and containVersion(word)):
print(word)
5. 最终调用:一句话使用
if __name__ == '__main__':
print_module_version('D:/work/kaku-project/lib/windows-x64/libObjectDetection.lib')
print_module_version('D:/work/kaku-project/lib/windows-x64/libObjectDetection.dll')
print_module_version('D:/work/kaku-project/lib/linux-arm64/libObjectDetection.a')
到了这里,关于Python3: 扫描库文件并获取版本号信息的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!