Metadata-Version: 2.5
Name: iizysl
Version: 0.0.4
Summary: IPv4 CIDR 计算：网段、掩码、广播地址与归属判断。
Project-URL: Homepage, https://pypi.org/project/iizysl/
Author-email: lqxnjk <lqxnjk@qq.com>
License: MIT
License-File: LICENSE
Keywords: cidr,ipaddress,ipv4,network,subnet
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# iizysl

[English](#english) | 中文

IPv4 CIDR 计算：网段、掩码、广播地址与归属判断。

## 安装

```console
pip install iizysl
```

## 用法

```python
from iizysl import contains, iter_hosts, network_info

network_info("10.0.0.0/24").as_dict()
# {'network': '10.0.0.0', 'prefix': 24, 'netmask': '255.255.255.0',
#  'broadcast': '10.0.0.255', 'first': '10.0.0.0', 'last': '10.0.0.255',
#  'hosts': 254}

contains("10.0.0.0/24", "10.0.0.7")   # True
iter_hosts("10.0.0.0/30")             # ['10.0.0.1', '10.0.0.2']
```

## 说明

主机位被设置时按 `strict=False` 归一化；`/31` 和 `/32` 不区分网络地址与广播地址，全部算可用；非法输入抛 `ValueError`，不会退回一个默认网段。

## 许可证

MIT

---

<a id="english"></a>
## English

IPv4 CIDR arithmetic: ranges, membership and host counts.

## Install

```console
pip install iizysl
```

## Usage

```python
from iizysl import contains, iter_hosts, network_info

network_info("10.0.0.0/24").as_dict()
# {'network': '10.0.0.0', 'prefix': 24, 'netmask': '255.255.255.0',
#  'broadcast': '10.0.0.255', 'first': '10.0.0.0', 'last': '10.0.0.255',
#  'hosts': 254}

contains("10.0.0.0/24", "10.0.0.7")   # True
iter_hosts("10.0.0.0/30")             # ['10.0.0.1', '10.0.0.2']
```

## Notes

Host bits are normalised with `strict=False`. `/31` and `/32` treat every address as usable. Invalid input raises `ValueError` rather than falling back to a default network.

## License

MIT
