BSO — Binkley-Style Outbound Reporter
===================================

bso.py is a small utility to scan and report on a Fidonet-style
Binkley outbound (BSO) directory structure.

It is useful for sysops who want a quick overview of outbound
traffic waiting to be sent, broken down by zone, net/node,
and packet/file type.

------------------------------------------------------------
Features
------------------------------------------------------------

• Scans standard BSO outbound directories (e.g. out/, out.xxx/)
• Supports zone-based outbound folders
• Case-insensitive handling of .pkt extensions
• Groups traffic by destination address
• Counts files and total sizes
• Optional per-address summary mode
• Designed to work alongside other FTN tools and reports

------------------------------------------------------------
Requirements
------------------------------------------------------------

• Python 3.7 or newer
• Standard library only (no external dependencies)

------------------------------------------------------------
Usage
------------------------------------------------------------

Basic usage:

    python3 bso.py

Optional arguments:

    -p, --path PATH        Path to the BSO outbound directory
    -z, --zone ZONE        Default zone number for plain "out" directory
    -s, --summary          Show one summary line per address

Example:

    python3 bso.py -p /home/fmail/ftn/spool/out -z 618 --summary

------------------------------------------------------------
Directory Layout Assumptions
------------------------------------------------------------

The script expects a standard BSO layout such as:

    out/
    out.002/
    out.618/

Packet and mail files may include:

    *.pkt
    *.PKT
    *.cut
    *.flo
    *.tic
    *.req

------------------------------------------------------------
Licence
------------------------------------------------------------

MIT License

Copyright (c) 2026
Sean Rima and Murphy

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.

------------------------------------------------------------
Status
------------------------------------------------------------

Version: 1.0
Stable – actively used in production environments.

------------------------------------------------------------
Author
------------------------------------------------------------

(c) 2026 Sean Rima and Murphy