#!/opt/local/bin/python3.14

############################################################################
#
# MODULE:	v.db.univar (formerly called v.univar.sh)
# AUTHOR(S):	Michael Barton, Arizona State University
#               Converted to Python by Glynn Clements
#               Sync'ed to r.univar by Markus Metz
# PURPOSE:	Calculates univariate statistics from a GRASS vector map attribute column.
#               Based on r.univar.sh by Markus Neteler
# COPYRIGHT:	(C) 2005, 2007, 2008 by the GRASS Development Team
#
# 		This program is free software under the GNU General Public
# 		License (>=v2). Read the file COPYING that comes with GRASS
# 		for details.
#
#############################################################################

# %module
# % description: Calculates univariate statistics on selected table column for a GRASS vector map.
# % keyword: vector
# % keyword: statistics
# % keyword: attribute table
# %end
# %option G_OPT_V_MAP
# % required: yes
# %end
# %option G_OPT_V_FIELD
# %end
# %option G_OPT_DB_COLUMN
# % description: Name of attribute column on which to calculate statistics (must be numeric)
# % required: yes
# %end
# %option G_OPT_DB_WHERE
# %end
# %option
# % key: percentile
# % type: double
# % description: Percentile to calculate (requires extended statistics flag)
# % required : no
# % answer: 90
# % options: 0-100
# % multiple: yes
# %end
# %option G_OPT_F_FORMAT
# % options: plain,json,shell
# % descriptions: plain;Plain text output;json;JSON (JavaScript Object Notation);shell;Shell script style for Bash eval
# %end
# %flag
# % key: e
# % description: Extended statistics (quartiles and 90th percentile)
# %end
# %flag
# % key: g
# % label: Print stats in shell script style [deprecated]
# % description: This flag is deprecated and will be removed in a future release. Use format=shell instead.
# %end

import sys
import os
import grass.script as gs
from grass.exceptions import CalledModuleError


def main():
    global tmp
    tmp = gs.tempfile()

    vector = options["map"]
    layer = options["layer"]
    column = options["column"]
    where = options["where"]
    perc = options["percentile"]

    if not gs.find_file(vector, element="vector")["file"]:
        gs.fatal(_("Vector map <%s> not found") % vector)

    try:
        fi = gs.vector_db(vector, stderr=nuldev)[int(layer)]
    except KeyError:
        gs.fatal(_("No attribute table linked to layer <%s>") % layer)

    table = fi["table"]
    database = fi["database"]
    driver = fi["driver"]

    output_format = options["format"]
    if not output_format:
        output_format = "shell" if flags["g"] else "plain"
    if flags["g"]:
        # This can be a message or warning in future versions.
        # In version 9, -g may be removed.
        gs.verbose(
            _(
                "Flag 'g' is deprecated and will be removed in a future "
                "release. Please use format=shell instead."
            )
        )

    passflags = None
    if flags["e"]:
        passflags = "e"

    try:
        gs.run_command(
            "db.univar",
            table=table,
            column=column,
            database=database,
            driver=driver,
            perc=perc,
            where=where,
            format=output_format,
            flags=passflags,
        )
    except CalledModuleError:
        sys.exit(1)


if __name__ == "__main__":
    options, flags = gs.parser()
    nuldev = open(os.devnull, "w")
    main()
