No description
  • Shell 52.9%
  • Rust 35%
  • Makefile 12.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-14 05:08:51 +01:00
.crate-kit feat: update version to 0.2.7 and refine IP utility logic 2026-11-14 15:06:48 +11:00
.gitea/workflows
api feat: update version to 0.2.7 and refine IP utility logic 2026-11-14 15:06:48 +11:00
ReleaseNotes feat: update version to 0.2.7 and refine IP utility logic 2026-11-14 15:06:48 +11:00
src feat: update version to 0.2.7 and refine IP utility logic 2026-11-14 15:06:48 +11:00
tests feat: update version to 0.2.7 and refine IP utility logic 2026-11-14 15:06:48 +11:00
.gitignore feat: release v0.2.3 and refactor build system with jjfetch script 2026-11-08 11:46:43 +11:00
Cargo.lock feat: update version to 0.2.7 and refine IP utility logic 2026-11-14 15:06:48 +11:00
Cargo.toml feat: update version to 0.2.7 and refine IP utility logic 2026-11-14 15:06:48 +11:00
LICENSE
LICENSE.en feat: release v0.2.3 and refactor build system with jjfetch script 2026-11-08 11:46:43 +11:00
Makefile feat: release v0.2.3 and refactor build system with jjfetch script 2026-11-08 11:46:43 +11:00
README.md feat: bump version to 0.2.5 and migrate API snapshots to gzip 2026-11-12 11:27:20 +11:00
TODO.md
version.txt feat: update version to 0.2.7 and refine IP utility logic 2026-11-14 15:06:48 +11:00

pmoutils

Crates.io Docs.rs

Pmo Crates Docs.rs

Utilitaires système pour la gestion des adresses IP réseau et des processus.

Fonctionnalités

  • Gestion des adresses IP : Détection et listing des interfaces réseau
  • Surveillance des processus : Identification des processus utilisant un port spécifique
  • Informations système : Détection de l'OS et de sa version

Installation

Via Cargo (recommandé)

Ajoutez cette dépendance à votre Cargo.toml :

[dependencies]
pmoutils = "0.2"

Depuis la source

git clone https://github.com/coissac/pmo.git
cd pmo/pmoutils
cargo build --release

Documentation

La documentation complète est disponible sur docs.rs.

Gestion des adresses IP

use pmoutils::guess_local_ip;

// Devine l'adresse IPv4 locale utilisée pour les connexions sortantes
// (erreur s'il n'y a pas de route vers Internet : pas de repli sur 127.0.0.1)
let ip = guess_local_ip()?;
println!("Adresse IP locale: {}", ip);

// Liste les adresses IP non-loopback, dans la famille demandée (V4, V6 ou Both)
use pmoutils::ip_utils::{list_all_ips, IpFamily};

let ips = list_all_ips(IpFamily::V4)?;
for (interface, addresses) in &ips {
    println!("Interface {}: {:?}", interface, addresses);
}

Surveillance des processus

use pmoutils::{find_process_using_port, TransportProtocol};

// Trouve le processus qui écoute sur un port spécifique
let info = find_process_using_port(8080, TransportProtocol::Tcp);

if let Some(process_info) = info {
    println!("PID: {}", process_info.pid);
    println!("Nom: {}", process_info.process_name);
    println!("Propriétaire: {}", process_info.owner);
}

Informations système

use pmoutils::get_os_string;

// Obtient le nom et la version du système d'exploitation
let os_info = get_os_string();
println!("Système: {}", os_info); // Ex: "Linux/6.5.0" ou "macOS/15.1"

API

Modules

  • ip_utils : Utilitaires pour la gestion des adresses IP

    • guess_local_ip() → Devine l'IPv4 locale (io::Result<Ipv4Addr>)
    • list_all_ips(IpFamily) → Liste les IPs non-loopback par interface (io::Result)
    • IpFamily → Famille demandée : V4, V6 ou Both
  • process : Utilitaires pour la gestion des processus

    • find_process_using_port() → Trouve un processus par port
    • ProcessPortInfo → Structure contenant les informations du processus
    • TransportProtocol → Énumération TCP/UDP

Types : u32 pour les PID, u16 pour les ports, String pour les noms de processus et propriétaires (possédés). Une absence de résultat se rend par Option (find_process_using_port → Option<ProcessPortInfo>). Cibles : systèmes Unix (macOS, Linux) ; la lecture des sockets passe par netstat2, au support Windows limité ; la détection de l'OS est portable (os_info).

Fonctions publiques

  • get_os_string() → Retourne une chaîne décrivant l'OS et sa version

Exemples complets

Voir la documentation API pour plus d'exemples.

Platformes supportées

  • macOS (x86_64, ARM64)
  • Linux (x86_64, ARM64)
  • Windows (limité - certaines fonctionnalités peuvent ne pas être disponibles)

Développement

Prérequis

  • Rust 1.88+ (edition 2024 ; les if … && let … utilisés dans ip_utils.rs sont stables depuis la 1.88)
  • Cargo (inclus dans Rust)
  • Pour les cibles d'API et de release : cargo-public-api et cargo-semver-checks (cargo install cargo-public-api cargo-semver-checks --locked) ; pour make wiki : cargo-doc-md (cargo install cargo-doc-md --locked)

Compilation

cargo build --release

Tests

cargo test

Documentation locale

cargo doc --no-deps

Ouvrez target/doc/pmoutils/index.html dans votre navigateur.

Commandes du kit (make)

Les commandes de développement viennent du dépôt crate-kit (copie dans .crate-kit/, mise à jour par make kit-update ; ne pas modifier .crate-kit/ ici). make help les liste. Les principales :

Commande Effet
make ci fmt-check, clippy, tests, documentation
make api-level l'API publique a-t-elle changé depuis la dernière version ? (unchanged, additive, breaking)
make api-snapshot enregistre l'API de la version courante dans api/
make wiki publie la documentation de l'API dans le wiki Forgejo (DRY_RUN=1 : sans push)
make jjrelease version déduite de l'API, instantané, notes, push, tag, publication, wiki

Le numéro de version suit l'API publique : en 0.x une rupture passe à 0.y+1.0, sinon patch ; dès 1.0, une rupture passe à x+1.0.0, un ajout à x.y+1.0, sinon patch.

Dépendances

  • if-addrs : Détection des adresses d'interfaces réseau
  • os_info : Détection multiplateforme de l'OS
  • netstat2 : Mapping des sockets et processus
  • sysinfo : Informations système et processus
  • users : Résolution des utilisateurs par UID

License

Ce logiciel est régi par la licence CeCILL version 2.1.

Ce logiciel est un programme informatique servant à la gestion des adresses IP réseau et des processus système. Il est distribué sous la licence CeCILL telle que publiée par le CEA, le CNRS et l'INRIA.

Vous pouvez utiliser, modifier et/ou redistribuer ce programme sous les termes de la licence CeCILL telle que publiée par CEA, CNRS et INRIA à l'adresse suivante : https://cecill.info

See the LICENSE file for the full license text.