Python-User-Agents 开源项目教程

Python-User-Agents 开源项目教程

python-user-agentsA Python library that provides an easy way to identify devices like mobile phones, tablets and their capabilities by parsing (browser) user agent strings.项目地址:https://gitcode.com/gh_mirrors/py/python-user-agents

1. 项目的目录结构及介绍

Python-User-Agents 项目的目录结构相对简单，主要包含以下几个部分：

python-user-agents/
├── LICENSE
├── MANIFEST.in
├── README.rst
├── requirements.txt
├── setup.cfg
├── setup.py
├── tests/
│   ├── __init__.py
│   ├── test_user_agents.py
│   └── test_utils.py
└── user_agents/
    ├── __init__.py
    ├── errors.py
    ├── parsers.py
    └── user_agents.py

目录结构介绍

• LICENSE: 项目的许可证文件。
• MANIFEST.in: 用于指定在打包时需要包含的非Python文件。
• README.rst: 项目的说明文档。
• requirements.txt: 项目依赖的Python包列表。
• setup.cfg: 用于配置setuptools的配置文件。
• setup.py: 用于安装和分发项目的脚本。
• tests/: 包含项目的测试代码。
  • __init__.py: 使tests目录成为一个Python包。
  • test_user_agents.py: 用户代理解析器的测试代码。
  • test_utils.py: 工具函数的测试代码。
• user_agents/: 项目的主要代码目录。
  • __init__.py: 使user_agents目录成为一个Python包。
  • errors.py: 定义错误类。
  • parsers.py: 用户代理解析器的实现。
  • user_agents.py: 用户代理解析器的主要逻辑。

2. 项目的启动文件介绍

Python-User-Agents 项目没有传统意义上的“启动文件”，因为它是一个库，而不是一个独立的应用程序。用户通过导入 user_agents 模块来使用该库。

例如：

from user_agents import parse

user_agent = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36'
ua = parse(user_agent)

print(ua.browser)  # 输出: Browser(family='Chrome', version=(91, 0, 4472), version_string='91.0.4472.114')
print(ua.os)      # 输出: OperatingSystem(family='Mac OS X', version=(10, 15, 7), version_string='10.15.7')

3. 项目的配置文件介绍

Python-User-Agents 项目没有专门的配置文件，因为它不需要用户进行复杂的配置。项目的依赖通过 requirements.txt 文件管理，而安装和分发则通过 setup.py 和 setup.cfg 文件进行配置。

requirements.txt

该文件列出了项目运行所需的Python包及其版本要求。例如：

ua-parser>=0.10.0

setup.py

该文件用于安装和分发项目。它包含了项目的元数据和依赖信息。例如：

from setuptools import setup, find_packages

setup(
    name='user-agents',
    version='2.2.0',
    description='A library to identify devices (phones, tablets) and their capabilities by parsing (browser/HTTP) user agent strings',
    long_description=open('README.rst').read(),
    author='Selwin Ong',
    author_email='selwin.ong@gmail.com',
    url='https://github.com/selwin/python-user-agents',
    license='MIT',
    packages=find_packages(),
    include_package_data=True,
    zip_safe=False,
    install_requires=[
        'ua-parser>=0.10.0',
    ],
    classifiers=[
        'Development Status :: 5 - Production/Stable',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Operating System :: OS Independent',
        'Programming Language :: Python',
        'Programming Language :: Python :: 2',
        '

python-user-agentsA Python library that provides an easy way to identify devices like mobile phones, tablets and their capabilities by parsing (browser) user agent strings.项目地址:https://gitcode.com/gh_mirrors/py/python-user-agents