跳转到主要内容

通过ARP和PTR查找发现主机

项目描述

异步主机发现

Build Status Documentation Code Coverage

通过ARP和PTR查找发现主机


特性

  • 通过ARP和PTR查找在网络中查找主机

快速开始

import asyncio
import pprint
from aiodiscover import DiscoverHosts

discover_hosts = DiscoverHosts()
hosts = asyncio.run(discover_hosts.async_discover())
pprint.pprint(hosts)

安装

稳定版本: pip install aiodiscover
开发头: pip install git+https://github.com/bdraco/aiodiscover.git

文档

有关完整包文档,请访问 bdraco.github.io/aiodiscover

开发

有关开发代码的信息,请参阅 CONTRIBUTING.md

你需要知道的四个命令

  1. pip install -e .[dev]

    这将以可编辑模式安装你的包,包括所有必需的开发依赖项(即 tox)。

  2. make build

    这将运行 tox,它将在Python 3.7和Python 3.8上运行所有测试,并检查你的代码。

  3. make clean

    这将清理各种Python和构建生成的文件,以便你可以确保你在干净的环境中工作。

  4. make docs

    这将生成并启动一个网页浏览器来查看你Python包的最新文档。

附加可选设置步骤

  • 将您的项目转换为GitHub仓库
    • github.com 上创建账号
    • 前往 创建新的仓库
    • 建议
      • 强烈建议将仓库名称与Python包名称相同
      • 以下许多可选步骤如果仓库是公开的则是免费的,开源也很酷
    • GitHub仓库创建完成后,运行以下命令:"...或从命令行推送现有的仓库"
  • 在Codecov上注册您的项目
    • codecov.io 上创建账号(建议使用GitHub登录)其他一切将自动为您处理。
  • 确保您已将GitHub Pages设置为构建 gh-pages 分支,请在仓库设置中的“GitHub Pages”部分选择下拉列表中的 gh-pages 分支。(仓库设置
  • 在PyPI上注册您的项目
    • pypi.org 上创建账号
    • 进入您的GitHub仓库设置,在 密钥标签页 下,添加一个名为 PYPI_TOKEN 的密钥,并使用您的PyPI账号密码。请放心,没有人会看到这个密码,因为它会被加密。
    • 下次您使用 bump2versionmain 分支上推送后,GitHub Actions将构建并部署您的Python包到PyPI。

建议的Git分支策略

  1. main 是用于最新开发,您很少应该直接向这个分支提交。GitHub Actions将在这个分支上的每次推送和CRON任务上运行,但仍建议您提交到您的开发分支,并将pull request发送到main。如果您使用bumpversion推送带有标签的提交,这将也会发布到PyPI。
  2. 您日常的工作应该在 main 分支之外的其他分支上。即使只有您一个人在仓库上工作,也应该从您的开发分支向 main 发送PR,以确保您的提交不会破坏开发头。GitHub Actions将在任何分支的每次推送以及任何分支到任何其他分支的任何PR上运行。
  3. 建议在提交PR时使用 "Squash and Merge" 提交。这使得对 main 的每次更改都是原子性的,并且作为副作用自然鼓励小的、定义良好的PR。

Apache软件许可证2.0

项目详情


下载文件

下载您平台上的文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源分发

aiodiscover-2.2.0.tar.gz (11.7 kB 查看散列)

上传于 源代码

构建版本

aiodiscover-2.2.0-py3-none-any.whl (11.1 kB 查看哈希)

上传于 Python 3

由以下支持