Traffic Statistics

class StatsFactory:
    """V2ray statistics API management"""
    
    def __init__(self, group_list):
        """
        Initialize statistics factory with group configuration.
        
        Parameters:
        - group_list (list): List of configured port groups
        """
    
    def get_stats(self, group_list):
        """
        Retrieve comprehensive traffic statistics for all groups.
        
        Parameters:
        - group_list (list): Groups to collect stats for
        
        Returns:
        dict: Traffic statistics including uplink/downlink bytes
              for each user and group
        """
    
    def get_inbound_stats(self, group_list):
        """
        Get inbound traffic statistics specifically.
        
        Parameters:
        - group_list (list): Target groups
        
        Returns:
        dict: Inbound traffic data per user/group
        """

def manage(stat_type=''):
    """
    Interactive traffic statistics management.
    
    Parameters:
    - stat_type (str, optional): Specific statistics type to display
                                'user' - Per-user statistics
                                'group' - Per-group statistics
                                'total' - Overall statistics
    
    Provides interactive menu for viewing and managing traffic statistics,
    including options to reset counters and export data.
    """

def manage(iptables_type=''):
    """
    Manage iptables-based traffic statistics.
    
    Parameters:
    - iptables_type (str, optional): Statistics type
                                    'port' - Per-port statistics
                                    'user' - Per-user via port mapping
                                    'total' - System-wide proxy traffic
    
    Provides iptables rule management and traffic data collection
    independent of V2ray's API statistics.
    """

def calcul_iptables_traffic(port, ipv6=False):
    """
    Calculate traffic statistics for specific port using iptables.
    
    Parameters:
    - port (int): Port number to analyze
    - ipv6 (bool): Include IPv6 traffic statistics
    
    Returns:
    tuple: (upload_bytes, download_bytes) for the specified port
    """

def clean_iptables(port):
    """
    Clean iptables rules and reset statistics for specific port.
    
    Parameters:
    - port (int): Port to clean rules for
    
    Removes monitoring rules and resets byte counters.
    """

class Stats:
    """Traffic statistics data management"""
    
    def __init__(self):
        """Initialize statistics manager"""
    
    def reset_stats(self):
        """Reset all traffic statistics counters"""
    
    def export_stats(self, format='json'):
        """
        Export statistics data.
        
        Parameters:
        - format (str): Export format ('json', 'csv', 'txt')
        
        Returns:
        str: Formatted statistics data
        """

from v2ray_util.global_setting.stats_ctr import manage, StatsFactory
from v2ray_util.util_core.profile import Profile

# Interactive statistics management
manage()

# Programmatic statistics collection
profile = Profile()
groups = profile.load()
stats = StatsFactory(groups)

# Get all traffic statistics
all_stats = stats.get_stats(groups)
print(f"Total traffic: {all_stats}")

# Get inbound statistics only
inbound_stats = stats.get_inbound_stats(groups)

from v2ray_util.global_setting.iptables_ctr import manage
from v2ray_util.util_core.utils import calcul_iptables_traffic, clean_iptables

# Interactive iptables management
manage()

# Get traffic for specific port
upload, download = calcul_iptables_traffic(8080)
print(f"Port 8080 - Upload: {upload}, Download: {download}")

# Include IPv6 traffic
upload, download = calcul_iptables_traffic(8080, ipv6=True)

# Clean statistics for port
clean_iptables(8080)

# V2ray API statistics
v2ray-util stats           # Interactive statistics menu
v2ray-util stats user      # Per-user statistics
v2ray-util stats total     # Total statistics

# Iptables statistics  
v2ray-util iptables        # Interactive iptables menu
v2ray-util iptables port   # Per-port statistics

StatsData = {
    "groups": [
        {
            "port": int,
            "protocol": str,
            "users": [
                {
                    "email": str,
                    "uplink": int,      # Bytes sent
                    "downlink": int,    # Bytes received
                    "total": int        # Total bytes
                }
            ],
            "group_total": {
                "uplink": int,
                "downlink": int,
                "total": int
            }
        }
    ],
    "system_total": {
        "uplink": int,
        "downlink": int,
        "total": int,
        "active_users": int,
        "active_groups": int
    }
}

IptablesData = {
    "ports": {
        "8080": {
            "input_bytes": int,
            "output_bytes": int,
            "input_packets": int,
            "output_packets": int
        }
    },
    "total": {
        "input_bytes": int,
        "output_bytes": int,
        "input_packets": int,
        "output_packets": int
    }
}

def bytes_2_human_readable(number_of_bytes, precision=1):
    """
    Convert bytes to human-readable format.
    
    Parameters:
    - number_of_bytes (int): Raw byte count
    - precision (int): Decimal precision for display
    
    Returns:
    str: Formatted string (e.g., "1.5 GB", "256.7 MB")
    """

def all_port():
    """
    Get list of all configured ports with statistics.
    
    Returns:
    list: Port numbers with associated traffic data
    """