topolib 0.4.1__py3-none-any.whl → 0.4.2__py3-none-any.whl

topolib/analysis/metrics.py

@@ -2,7 +2,7 @@
 Metrics module for network topology analysis.
 """
 
-from typing import List, Any, Dict, Optional
+from typing import List, Dict, Optional
 
 
 from topolib.topology import Topology
@@ -12,16 +12,16 @@ class Metrics:
     """
     Provides static methods for computing metrics on network topologies.
 
-    Todos los métodos reciben una instancia de Topology.
+    All methods receive a Topology instance.
 
-    Métodos
+    Methods
     -------
     node_degree(topology)
-        Calcula el grado de cada nodo.
+        Calculates the degree of each node.
     link_length_stats(topology)
-        Calcula estadísticas (min, max, avg) de las longitudes de los enlaces.
+        Calculates statistics (min, max, avg) of link lengths.
     connection_matrix(topology)
-        Construye la matriz de adyacencia.
+        Builds the adjacency matrix.
     """
 
     @staticmethod

{topolib-0.4.1.dist-info → topolib-0.4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: topolib
-Version: 0.4.1
+Version: 0.4.2
 Summary: A compact Python library for modeling, analyzing, and visualizing optical network topologies.
 License: MIT
 License-File: LICENSE
@@ -31,7 +31,7 @@ Project-URL: Repository, https://gitlab.com/DaniloBorquez/topolib
 Description-Content-Type: text/markdown
 
 # Topolib 🚀
-
+# Topolib 🚀
 
 [![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/)
 [![License](https://img.shields.io/badge/license-MIT-lightgrey.svg)](LICENSE)
@@ -40,99 +40,80 @@ Description-Content-Type: text/markdown
 [![Release coverage](https://gitlab.com/DaniloBorquez/topolib/badges/release/coverage.svg)](https://gitlab.com/DaniloBorquez/topolib/-/pipelines?ref=release)
 [![Documentation Status](https://readthedocs.org/projects/topolib/badge/?version=latest)](https://topolib.readthedocs.io/en/latest/?badge=latest)
 
-A compact Python library for working with optical network topologies: nodes, links, metrics and visualization tools. 🌐
+> **Topolib** is a compact, modular Python library for modeling, analyzing, and visualizing optical network topologies.  
+> **Goal:** Provide researchers and engineers with a simple, extensible toolkit for working with nodes, links, metrics, and map-based visualizations.  
+>   
+> 🌐 **Model** | 📊 **Analyze** | 🗺️ **Visualize** | 🧩 **Extend**
+
+---
 
-## Overview
+## 📂 Examples
 
-Topolib models network topologies with three main modules:
+Explore ready-to-run usage examples in the [`examples/`](examples/) folder!  
+- [Show topology on a map](examples/show_topology_in_map.py) 🗺️  
+- More coming soon!
 
-- `topolib.elements` — Definitions of elementary building blocks
-  - `Node` — represents a network node with id, name and geographic coordinates
-  - `Link` — connects two `Node` objects and stores link length and id
+---
 
-- `topolib.topology` — High-level topology model
-  - `Topology` — holds nodes and links, provides methods to add/remove nodes and links, compute metrics, export JSON, and compute shortest/disjoint paths
-  - `Path` — represents a path through the topology
+## 🧭 Overview
 
-- `topolib.analysis` — Metrics and analysis helpers
-  - `Metrics` — functions to compute node degree, link length statistics, connection matrices, etc.
+Topolib is organized into four main modules:
 
-- `topolib.visualization` — Visualization helpers
-  - `MapView` — functions to display topology with OSM or paper-style maps
+- 🧱 **Elements:** `Node`, `Link` — basic building blocks
+- 🕸️ **Topology:** `Topology`, `Path` — manage nodes, links, paths, and adjacency
+- 📈 **Analysis:** `Metrics` — compute node degree, link stats, connection matrices
+- 🖼️ **Visualization:** `MapView` — plot topologies on real maps
 
-(These components are derived from the project's class diagram in `diagrams/class_diagram.puml`.)
+---
 
-## Features
-- Modular design: elements, topology, analysis, and visualization
+## ✨ Features
+
+- Modular, extensible design
 - Easy-to-use classes for nodes, links, and paths
 - Built-in metrics and analysis helpers
 - JSON import/export and interoperability
 - Ready for Sphinx, Read the Docs, and PyPI
 
-## Quickstart ⚡
+---
 
-Create and activate a virtual environment, install dev dependencies and run tests:
+## ⚡ Quickstart
 
 ```bash
 python -m venv .venv
 source .venv/bin/activate
-python -m pip install -U pip
-python -m pip install -r dev-requirements.txt
-python -m pytest -q
-```
-
-## Installation
-
-```bash
+pip install -U pip
 pip install topolib
 ```
 
-Or for development:
+---
 
-```bash
-git clone https://gitlab.com/DaniloBorquez/topolib.git
-cd topolib
-python -m venv .venv
-source .venv/bin/activate
-pip install -e .
-pip install -r dev-requirements.txt
-```
-
-## Documentation
+## 📚 Documentation
 
 Full documentation: [https://topolib.readthedocs.io/](https://topolib.readthedocs.io/)
 
-## Basic usage example
+---
 
-```py
+## 📝 Basic usage
+
+```python
 from topolib.elements.node import Node
 from topolib.topology.topology import Topology
 
-# Create nodes
 n1 = Node(1, 'A', 10.0, 20.0)
 n2 = Node(2, 'B', 11.0, 21.0)
-
-# Build topology
-topo = Topology()
-topo.add_node(n1)
-topo.add_node(n2)
-# add links, compute metrics, visualize
+topo = Topology(nodes=[n1, n2])
+# Add links, compute metrics, visualize, etc.
 ```
 
+---
 
-## Development 🛠️
-
-See `CONTRIBUTING.md` for development guidelines, commit message rules and pre-commit setup.
-
-
-
-## Class diagram
+## 🛠️ Development
 
-![](diagrams/class_diagram.puml)
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) for development guidelines, commit message rules, and pre-commit setup.
 
-(If you prefer a rendered image of the UML, render the PlantUML file locally or in your CI pipeline.)
+---
 
-## License
+## 📄 License
 
-See `LICENSE` in the project root.
+MIT — see [`LICENSE`](LICENSE) for details.
 

{topolib-0.4.1.dist-info → topolib-0.4.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
 topolib/__init__.py,sha256=iLmy2rOkHS_4KZWMD8BgT7R3tLMKeaTCDVf3B4FyYxM,91
 topolib/analysis/__init__.py,sha256=qvUC9wV_jQNQIlwJXk7LJ-dkTXhH1Ttn0lKWIdwBbrc,52
-topolib/analysis/metrics.py,sha256=Di4HGHlz9c2UTCYdfnmjtPjo7w3wwYuyDPeXI7bR0zA,2592
+topolib/analysis/metrics.py,sha256=2o5PlMVzepDWwSQjzamtKemggqkxh9JuzzCUaeahfok,2555
 topolib/assets/Abilene_IXP.json,sha256=5cnPMbjsNDjmpySdQDYQ2yd83zOFvCRjlAnbX1wyzgk,6010
 topolib/assets/China_pop.json,sha256=v-bs5qib8-CB81rvBNNM9ssoelrNGuFrPEyRCht9YpY,22262
 topolib/assets/DT-50_pop.json,sha256=hCv1MCvipgdrQ34VT-qXJ68BdATriQ8ZObh0fLPqar4,29719
@@ -12,7 +12,7 @@ topolib/topology/path.py,sha256=oUNwmpBcS6LMMAJIxokROm3MVqr7vRR44M3Fh5ADq_w,2057
 topolib/topology/topology.py,sha256=PzPx80TxWMcOwpOCh4fohcWT2YUra-4m04tBjqyMU40,5605
 topolib/visualization/__init__.py,sha256=wv065-KB5uDbTaQIASPVfMMW5sE76Bs-q0oai48vAzk,29
 topolib/visualization/mapview.py,sha256=4iKJMYsH6oFNj9tOcgSKLVRtoYfUuH3XLjShsGwUXcM,2799
-topolib-0.4.1.dist-info/METADATA,sha256=WSUvBwdpmS9NRSwm-r5lT2pzJyKFuQ-xUe9khXm_xAY,4671
-topolib-0.4.1.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
-topolib-0.4.1.dist-info/licenses/LICENSE,sha256=kbnIP0XU6f2ualiTjEawdlU81IGPBbwc-_GF3N-1e9E,1081
-topolib-0.4.1.dist-info/RECORD,,
+topolib-0.4.2.dist-info/METADATA,sha256=O2V7bL8xtAJOhNVmbLX0mHLj1ic5ZZu_3bbnFFbEzAw,3993
+topolib-0.4.2.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+topolib-0.4.2.dist-info/licenses/LICENSE,sha256=kbnIP0XU6f2ualiTjEawdlU81IGPBbwc-_GF3N-1e9E,1081
+topolib-0.4.2.dist-info/RECORD,,