Simulated realistic user workflows to identify friction points. Created helper functions that collapse common 10-15 line patterns into 3-5 line calls.

New API Surface

py3plex/ergonomics.py - Four helper functions:

• quick_network() - Network construction from Python lists
• quick_analysis() - Single-line centrality computation
• quick_communities() - One-call detection
• show_network_summary() - Human-readable stats

Code Impact

Before (15 lines):

from py3plex.core import multinet
net = multinet.multi_layer_network(directed=False)
for person in ['Alice', 'Bob', 'Carol']:
    for layer in ['work', 'social']:
        net.add_nodes([{'source': person, 'type': layer}])
for src, dst, layer in connections:
    net.add_edges([{'source': src, 'target': dst, 
                     'source_type': layer, 'target_type': layer}])

After (5 lines):

from py3plex.ergonomics import quick_network
net = quick_network(
    people=['Alice', 'Bob', 'Carol'],
    layers=['work', 'social'],
    connections=[('Alice', 'Bob', 'work')]
)

Validation

User journey simulations:

• examples/getting_started/user_journey_simulation.py - Three personas (first-time, intermediate, advanced)
• examples/getting_started/quick_start_ergonomics.py - Before/after demonstrations

Tests: 17 tests covering all helpers, edge cases, and full pipeline integration.

Bug Fixes

• Generator length handling in analysis helpers
• Edge format compatibility in summary display
• Layer counting edge cases

No breaking changes. All additions are opt-in.

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.