# 一个方便安全测试人员书写poc的工具库集合
## 描述
避免重复造轮子以及代码的简洁，将常用的方法集成化封装到一起，提高代码的整洁和便携。
## 安装
```shell
pip install poc-tool
```
## 使用
### 工具类tools使用
```shell
from poc_tool import tools
# 获取请求和响应数据包，传入response
tools.get_all_requests()
# 获取请求头，传入response
tools.get_req_header()
# 获取请求数据包，传入response
tools.get_req()
# 获取响应头，传入response
tools.get_res_header()
# 获取响应数据包，传入response
tools.get_res()
# 获取http请求版本，传入response
tools.get_http_version()
# 获取随机ua头
tools.get_random_ua()
# 获取随机ip地址
tools.get_random_ip()
# 获取随机数据，传入number类型长度
tools.get_random_num()
# 获取随机字符串，传入number类型长度
tools.get_random_str()
# base64加密，传入字符串
tools.base64_encode()
# base64解密，传入加密字符串
tools.base64_decode()
# url编码，传入字符串
tools.url_encode()
# url解码，传入url编码字符串
tools.url_decode()
# url全编码，传入字符串
tools.url_encode_all()
# url地址格式化，传入url或者IP地址，例如：'127.0.0.1:8988'，‘https://127.0.0.1:8899/api/v1’
tools.get_url_format()
# 验证是否是ip
tools.tools.verify_ip()
# 验证是否是ipv4 ip
tools.tools.verify_ipv4()
# 验证是否是ipv6 ip
tools.tools.verify_ipv6()
```
### 日志输出类logger使用
默认日志输出是INFO模式，如果需要所有信息都输出请设置成DEBUG模式
```shell
from poc_tool.log import log, LoggingLevel, LOGGER
# 设置日志等级，可以设置info，error，debug，warning，success
LOGGER.setLevel(LoggingLevel.INFO)
# 使用
log.info("zhizhuo")
log.success("zhizhuo")
log.error("zhizhuo")
log.warning("zhizhuo")
log.debug("zhizhuo")
```
### 文件hex编码查看，类似于Linux中的xxd命令
```python
from poc_tool import hex_dump
# 或者使用 from poc_tool.tools import hex_dump引入
# 参数说明，file_path文件路径，bytes_per_line每行的字节大小，默认是16
# lines获取多少行数据，默认是全部，可以自己定义传入
def hex_test():
hex_data = hex_dump(file_path="../poc编写规则.zip", lines=10)
print(hex_data)
```
Raw data
{
"_id": null,
"home_page": "https://github.com/zhizhuoshuma/poc_tool",
"name": "poc-tool",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "zhizhuo",
"author_email": "zhizhuoshuma@163.com",
"download_url": "https://files.pythonhosted.org/packages/cf/73/a8bcdf5dcfaeae343790d29656df2a9700fe9240de37dac13034e7406954/poc_tool-1.2.3.tar.gz",
"platform": null,
"description": "# \u4e00\u4e2a\u65b9\u4fbf\u5b89\u5168\u6d4b\u8bd5\u4eba\u5458\u4e66\u5199poc\u7684\u5de5\u5177\u5e93\u96c6\u5408\n\n## \u63cf\u8ff0\n\n\u907f\u514d\u91cd\u590d\u9020\u8f6e\u5b50\u4ee5\u53ca\u4ee3\u7801\u7684\u7b80\u6d01\uff0c\u5c06\u5e38\u7528\u7684\u65b9\u6cd5\u96c6\u6210\u5316\u5c01\u88c5\u5230\u4e00\u8d77\uff0c\u63d0\u9ad8\u4ee3\u7801\u7684\u6574\u6d01\u548c\u4fbf\u643a\u3002\n\n## \u5b89\u88c5\n\n```shell\npip install poc-tool\n```\n\n## \u4f7f\u7528\n\n### \u5de5\u5177\u7c7btools\u4f7f\u7528\n\n```shell\nfrom poc_tool import tools\n\n# \u83b7\u53d6\u8bf7\u6c42\u548c\u54cd\u5e94\u6570\u636e\u5305\uff0c\u4f20\u5165response\ntools.get_all_requests()\n\n# \u83b7\u53d6\u8bf7\u6c42\u5934\uff0c\u4f20\u5165response\ntools.get_req_header()\n\n# \u83b7\u53d6\u8bf7\u6c42\u6570\u636e\u5305\uff0c\u4f20\u5165response\ntools.get_req()\n\n# \u83b7\u53d6\u54cd\u5e94\u5934\uff0c\u4f20\u5165response\ntools.get_res_header()\n\n# \u83b7\u53d6\u54cd\u5e94\u6570\u636e\u5305\uff0c\u4f20\u5165response\ntools.get_res()\n\n# \u83b7\u53d6http\u8bf7\u6c42\u7248\u672c\uff0c\u4f20\u5165response\ntools.get_http_version()\n\n# \u83b7\u53d6\u968f\u673aua\u5934\ntools.get_random_ua()\n\n# \u83b7\u53d6\u968f\u673aip\u5730\u5740\ntools.get_random_ip()\n\n# \u83b7\u53d6\u968f\u673a\u6570\u636e\uff0c\u4f20\u5165number\u7c7b\u578b\u957f\u5ea6\ntools.get_random_num()\n\n# \u83b7\u53d6\u968f\u673a\u5b57\u7b26\u4e32\uff0c\u4f20\u5165number\u7c7b\u578b\u957f\u5ea6\ntools.get_random_str()\n\n# base64\u52a0\u5bc6\uff0c\u4f20\u5165\u5b57\u7b26\u4e32\ntools.base64_encode()\n\n# base64\u89e3\u5bc6\uff0c\u4f20\u5165\u52a0\u5bc6\u5b57\u7b26\u4e32\ntools.base64_decode()\n\n# url\u7f16\u7801\uff0c\u4f20\u5165\u5b57\u7b26\u4e32\ntools.url_encode()\n\n# url\u89e3\u7801\uff0c\u4f20\u5165url\u7f16\u7801\u5b57\u7b26\u4e32\ntools.url_decode()\n\n# url\u5168\u7f16\u7801\uff0c\u4f20\u5165\u5b57\u7b26\u4e32\ntools.url_encode_all()\n\n# url\u5730\u5740\u683c\u5f0f\u5316\uff0c\u4f20\u5165url\u6216\u8005IP\u5730\u5740\uff0c\u4f8b\u5982\uff1a'127.0.0.1:8988'\uff0c\u2018https://127.0.0.1:8899/api/v1\u2019\ntools.get_url_format()\n\n# \u9a8c\u8bc1\u662f\u5426\u662fip\ntools.tools.verify_ip()\n\n# \u9a8c\u8bc1\u662f\u5426\u662fipv4 ip\ntools.tools.verify_ipv4()\n\n# \u9a8c\u8bc1\u662f\u5426\u662fipv6 ip\ntools.tools.verify_ipv6()\n```\n\n### \u65e5\u5fd7\u8f93\u51fa\u7c7blogger\u4f7f\u7528\n\n\u9ed8\u8ba4\u65e5\u5fd7\u8f93\u51fa\u662fINFO\u6a21\u5f0f\uff0c\u5982\u679c\u9700\u8981\u6240\u6709\u4fe1\u606f\u90fd\u8f93\u51fa\u8bf7\u8bbe\u7f6e\u6210DEBUG\u6a21\u5f0f\n\n```shell\nfrom poc_tool.log import log, LoggingLevel, LOGGER\n\n# \u8bbe\u7f6e\u65e5\u5fd7\u7b49\u7ea7\uff0c\u53ef\u4ee5\u8bbe\u7f6einfo\uff0cerror\uff0cdebug\uff0cwarning\uff0csuccess\nLOGGER.setLevel(LoggingLevel.INFO)\n\n# \u4f7f\u7528\nlog.info(\"zhizhuo\")\nlog.success(\"zhizhuo\")\nlog.error(\"zhizhuo\")\nlog.warning(\"zhizhuo\")\nlog.debug(\"zhizhuo\")\n```\n\n### \u6587\u4ef6hex\u7f16\u7801\u67e5\u770b\uff0c\u7c7b\u4f3c\u4e8eLinux\u4e2d\u7684xxd\u547d\u4ee4\n\n```python\nfrom poc_tool import hex_dump\n\n\n# \u6216\u8005\u4f7f\u7528 from poc_tool.tools import hex_dump\u5f15\u5165\n# \u53c2\u6570\u8bf4\u660e\uff0cfile_path\u6587\u4ef6\u8def\u5f84\uff0cbytes_per_line\u6bcf\u884c\u7684\u5b57\u8282\u5927\u5c0f\uff0c\u9ed8\u8ba4\u662f16\n# lines\u83b7\u53d6\u591a\u5c11\u884c\u6570\u636e\uff0c\u9ed8\u8ba4\u662f\u5168\u90e8\uff0c\u53ef\u4ee5\u81ea\u5df1\u5b9a\u4e49\u4f20\u5165\n\ndef hex_test():\n hex_data = hex_dump(file_path=\"../poc\u7f16\u5199\u89c4\u5219.zip\", lines=10)\n print(hex_data)\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python Poc \u8fd8\u539f\u539f\u59cbhttp\u8bf7\u6c42\u6570\u636e\u5305\u4ee5\u53ca\u5e38\u7528\u5de5\u5177\u96c6\u6210\u5316\u5c01\u88c5\u7c7b\uff0c\u53ef\u4ee5\u66f4\u5feb\u5e2e\u52a9\u60a8\u5b8c\u6210POC\u7684\u4e66\u5199\u53ca\u8c03\u8bd5",
"version": "1.2.3",
"project_urls": {
"Homepage": "https://github.com/zhizhuoshuma/poc_tool"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cf73a8bcdf5dcfaeae343790d29656df2a9700fe9240de37dac13034e7406954",
"md5": "00e448bdca5478f7577a99d178cdbcbd",
"sha256": "a6fe2b69a58ed106cc9b6314ccc64e50d9434be3593989845371dd88adc34d15"
},
"downloads": -1,
"filename": "poc_tool-1.2.3.tar.gz",
"has_sig": false,
"md5_digest": "00e448bdca5478f7577a99d178cdbcbd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 7964,
"upload_time": "2024-10-15T11:32:01",
"upload_time_iso_8601": "2024-10-15T11:32:01.483204Z",
"url": "https://files.pythonhosted.org/packages/cf/73/a8bcdf5dcfaeae343790d29656df2a9700fe9240de37dac13034e7406954/poc_tool-1.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-15 11:32:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zhizhuoshuma",
"github_project": "poc_tool",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "poc-tool"
}
JSON
