g.version
Displays GRASS version info.
Optionally also prints build or copyright information.
g.version [-cxbreg] [format=name] [--verbose] [--quiet] [--qq] [--ui]
Example:
g.version
grass.script.parse_command("g.version", format="plain", flags=None, verbose=None, quiet=None, superquiet=None)
Example:
gs.parse_command("g.version", format="json")
grass.tools.Tools.g_version(format="plain", flags=None, verbose=None, quiet=None, superquiet=None)
Example:
tools = Tools()
tools.g_version(format="json")
This grass.tools API is experimental in version 8.5 and expected to be stable in version 8.6.
Parameters
format=name
Output format
Allowed values: plain, shell, json
Default: plain
plain: Human readable text output
shell: shell script style text output
json: JSON (JavaScript Object Notation)
-c
Print also the copyright message
-x
Print also the citation options
-b
Print also the build information
-r
Print also the GIS library revision number and date
-e
Print also extended info for additional libraries
GDAL/OGR, PROJ, GEOS
-g
Print info in shell script style (including Git reference commit) [deprecated]
This flag is deprecated and will be removed in a future release. Use format=shell instead.
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--qq
Very quiet module output
--ui
Force launching GUI dialog
format : str, optional
Output format
Used as: name
Allowed values: plain, shell, json
plain: Human readable text output
shell: shell script style text output
json: JSON (JavaScript Object Notation)
Default: plain
flags : str, optional
Allowed values: c, x, b, r, e, g
c
Print also the copyright message
x
Print also the citation options
b
Print also the build information
r
Print also the GIS library revision number and date
e
Print also extended info for additional libraries
GDAL/OGR, PROJ, GEOS
g
Print info in shell script style (including Git reference commit) [deprecated]
This flag is deprecated and will be removed in a future release. Use format=shell instead.
verbose: bool, optional
Verbose module output
Default: None
quiet: bool, optional
Quiet module output
Default: None
superquiet: bool, optional
Very quiet module output
Default: None
format : str, optional
Output format
Used as: name
Allowed values: plain, shell, json
plain: Human readable text output
shell: shell script style text output
json: JSON (JavaScript Object Notation)
Default: plain
flags : str, optional
Allowed values: c, x, b, r, e, g
c
Print also the copyright message
x
Print also the citation options
b
Print also the build information
r
Print also the GIS library revision number and date
e
Print also extended info for additional libraries
GDAL/OGR, PROJ, GEOS
g
Print info in shell script style (including Git reference commit) [deprecated]
This flag is deprecated and will be removed in a future release. Use format=shell instead.
verbose: bool, optional
Verbose module output
Default: None
quiet: bool, optional
Quiet module output
Default: None
superquiet: bool, optional
Very quiet module output
Default: None
DESCRIPTION
g.version prints to standard output the GRASS version number, date, the GRASS copyright (-c flag), and GRASS build information (-b flag).
NOTES
This program requires no command line arguments; the user simply types g.version on the command line to see the version number and date of the GRASS software currently being run by the user.
Information about GRASS core GIS Library can be printed by -r flag.
Version numbers of additional libraries like PROJ, GDAL/OGR or GEOS are printed by -e flag.
See also function version()
from Python Scripting
Library.
import grass.script as gs
print(gs.version())
EXAMPLES
Basic info
g.version
GRASS 8.4.0 (2024)
GIS Library info
g.version -r
GRASS 8.4.0 (2024)
libgis revision: c9e8576cf
libgis date: 2024-04-27T09:38:49+00:00
Full info
g.version -re format=shell
Possible output:
version=8.4.0
date=2024
revision=d57f40906
build_date=2024-05-23
build_platform=x86_64-pc-linux-gnu
build_off_t_size=8
libgis_revision=c9e8576cf
libgis_date=2024-04-27T09:38:49+00:00
proj=8.2.1
gdal=3.4.3
geos=3.9.2
sqlite=3.36.0
import grass.script as gs
# Run g.version with JSON output and the -re flags
data = gs.parse_command(
"g.version",
flags="re",
format="json",
)
print(data["version"])
Possible output:
8.4.0
The whole JSON may look like this:
{
"version": "8.4.0",
"date": "2024",
"revision": "d57f40906",
"build_date": "2024-05-23",
"build_platform": "x86_64-pc-linux-gnu",
"build_off_t_size": 8,
"libgis_revision": "c9e8576cf",
"libgis_date": "2024-04-27T09:38:49+00:00",
"proj": "8.2.1",
"gdal": "3.4.3",
"geos": "3.9.2",
"sqlite": "3.36.0"
}
Note: if revision=exported
is reported instead of the git hash then
the git
program was not available during compilation of GRASS and
the source code did not contain the .git/
subdirectory (requires e.g.
to git clone
the GRASS software
repository.)
Citing GRASS
The GRASS Development Team has invested significant time and effort in creating GRASS, please cite it when using it for data analysis. The GRASS Web site offers citations in different styles.
AUTHORS
Michael Shapiro, U.S. Army Construction Engineering Research
Laboratory
Extended info by Martin Landa, Czech Technical University in Prague,
Czech Republic
SOURCE CODE
Available at: g.version source code
(history)
Latest change: Friday Aug 08 09:39:19 2025 in commit ed72c71