Metadata-Version: 2.4
Name: netpulse
Version: 0.1.0.5
Summary: High-performance network discovery and subnet analysis suite with native Rust speed.
Project-URL: Homepage, https://github.com/bendeze/netpulse
Project-URL: Documentation, https://github.com/bendeze/netpulse/blob/main/README.md
Project-URL: Repository, https://github.com/bendeze/netpulse
Project-URL: Bug Tracker, https://github.com/bendeze/netpulse/issues
Author-email: Ndeze Bonheur Emmanuel <bonheurndezenc@gmail.com>
License: MIT License
        
        Copyright (c) 2026 Bonheur Ndeze
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: arp,calculator,discovery,icmp,network,rust,ssh,subnet,vlsm
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Rust
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.10
Requires-Dist: netpulse-core
Requires-Dist: netpulse-discovery
Requires-Dist: netpulse-ssh
Requires-Dist: netpulse-subnet
Description-Content-Type: text/markdown

<div align="center">
  <h1>NetPulse</h1>
  <p>High-performance network discovery and analysis suite combining Rust's raw-socket speed with a Python/FastAPI orchestration layer.</p>

  <p>
    <a href="https://pypi.org/project/netpulse/"><img src="https://img.shields.io/pypi/v/netpulse.svg?style=flat-square" alt="PyPI version" /></a>
    <a href="https://pypi.org/project/netpulse/"><img src="https://img.shields.io/pypi/pyversions/netpulse.svg?style=flat-square" alt="Python Versions" /></a>
    <a href="https://github.com/bendeze/netpulse/blob/main/LICENSE"><img src="https://img.shields.io/github/license/bendeze/netpulse?style=flat-square" alt="License" /></a>
  </p>
</div>

---

## Overview

**NetPulse** is an enterprise-grade network discovery and analysis platform designed to streamline infrastructure auditing and subnet management. It acts as both a premium CLI tool and a secure REST API.

By decoupling the systems execution layer into a compiled Rust extension (`pnet`, `socket2`), NetPulse achieves wire-speed performance for Layer 2 (ARP) and Layer 3 (ICMP) sweeps, while exposing a flexible, Pydantic-powered Python interface.

## Key Features

- **High-Speed Discovery**: Sub-second execution of wide-scale network sweeps.
- **Advanced Subnet Engine**: A robust calculator supporting bitwise alignment, FLSM partitioning, and Variable-Length Subnet Masking (VLSM) allocations.
- **Drift Detection**: Automated comparisons of current network states against historical baselines stored locally.
- **ProxyJump / Bastion Support**: Execute concurrent SSH commands across hundreds of targets by multiplexing through a single DMZ tunnel.
- **Zero-Privilege Mock Fallback**: A simulated engine allowing developers to test UI and API endpoints locally without requiring root Linux network capabilities.

---

## Installation

Install directly from PyPI:

```bash
pip install netpulse
```

*Note: For actual physical network discovery, the Python binary requires elevated raw socket capabilities (`cap_net_raw`) or superuser privileges.*

---

## Quick Start (CLI)

```bash
# Standard interactive table sweep (requires root or setcap permissions)
sudo netpulse discover 172.19.57.0/24

# Subnet bitwise alignment calculator
netpulse subnet info 192.168.1.50/24

# Perform VLSM allocation for varying departmental size requirements
netpulse subnet vlsm 192.168.1.0/24 --req "HR=120,Dev=50,Sales=20,Links=2"
```

## Documentation

For full instructions, architectural details, and REST API setup, please visit the [Official GitHub Repository](https://github.com/bendeze/netpulse).
