tools: add --link and --out parameters for raster and vector files by tangelll · Pull Request #7182 · OSGeo/grass

tangelll · 2026-03-14T18:47:40Z

This pr open for this issue :#7176

Description:

There is a project in Grass Gsoc ideas list which name is Subcommand CLI for GRASS. I am being able to finish Add --link-raster=some/file.tiff which links (r.external) a raster file (same for vector and similarly for r.external.out).

Before Start

Before starting the test, ensure that you have copied your updated cli.py to the GRASS installation directory.

For me (macOS m4):

    cp cli.py /usr/local/grass85/etc/python/grass/app

Test

Run test_r_external.py under /r.external/testsuite

Result

Test For v.external under testsuite

Reading band -1 of 1...
ERROR 5: elevation.nc: GDALDataset::GetRasterBand(-1) - Illegal band #

ERROR: Selected band (-1) does not exist

Reading band 1 of 1...
Link to raster map <test_external_map> created.

ERROR 4: /Users/tangel/Works/grass/raster/r.external/testsuite/non_existent_file.tif: No such file or directory

Reading band 1 of 1...
Link to raster map <map_1> created.
Default region for this project updated
Region for the current mapset updated

Reading band 1 of 1...
Link to raster map <map_2> created.
Default region for this project updated
Region for the current mapset updated

Reading band 1 of 1...
Link to raster map <test_external_map> created.
Default region for this project updated
Region for the current mapset updated

Reading band 1 of 1...
Link to raster map <second_map> created.
Default region for this project updated
Region for the current mapset updated

Reading band 1 of 1...
Link to raster map <test_external_map> created.
Default region for this project updated
Region for the current mapset updated

No projection information available
Over-riding projection check
WARNING: Imagery group <test_external_map> already exists and will be
overwritten.
Reading band 1 of 5...
Link to raster map <test_external_map.1> created.
Reading band 2 of 5...
Link to raster map <test_external_map.2> created.
Reading band 3 of 5...
Link to raster map <test_external_map.3> created.
Reading band 4 of 5...
Link to raster map <test_external_map.4> created.
Reading band 5 of 5...
Link to raster map <test_external_map.5> created.
Imagery group <test_external_map> created

No projection information available
Over-riding projection check
Reading band 2 of 5...
Link to raster map <test_external_map> created.
Ok

tangelll · 2026-03-17T15:24:25Z

Hi @wenzeslaus,
I've been working on the Subcommand CLI for GRASS and would love to know if I'm heading in the right direction.

I have successfully implemented a 'one-step' execution flow where a user can link external data, run a module, and save the output externally in a single command.

It currently handles:

r.external / v.external linking before execution.

r.external.out / v.external.out for direct external output.

Does this align with the vision for CLI, or should I adjust the approach before moving further into the --region and import/export tasks?

wenzeslaus

This needs more testing and a deeper analysis. What happens when you use the command twice in a same project (with --project)? How are multiple parameters and parameter interactions handled?

Also, this completely misses tests which are explicitly mentioned in the GSoC idea.

wenzeslaus · 2026-03-18T03:17:09Z

+    create_parser.add_argument(
+        "--link-raster",
+        action="append",
+        help="link a raster map to the project (can be used multiple times)",
+    )


What would be the use case for these in a workflow?

wenzeslaus · 2026-03-18T03:18:28Z

+    run_subparser.add_argument(
+        "--link-raster",
+        type=str,
+        nargs="+",


This eats the "named arguments" unless used with =. Needs more config.

tangelll · 2026-03-29T15:15:41Z

I would like to confirm if my testing methodology is on the right track. I noticed that there is currently no testsuite folder under v.external. Should I go ahead and create a new testsuite directory and add my test files there? Once I have your approval on this structure, I will proceed with the rest of the tests.

echoix · 2026-03-29T18:34:56Z

Yes, you can create a testsuite folder for a gunittest-based test, or test folder for pytest-based test

tangelll · 2026-04-19T17:39:28Z

Yes, you can create a testsuite folder for a gunittest-based test, or test folder for pytest-based test

After reading v.external.md, I decided not to add a testsuite because v.external is difficult to test reliably with existing GRASS testing mechanisms, and I chose to focus on revising my existing changes instead. Could you please start my Github workflow?

tangelll added 3 commits March 14, 2026 18:03

add subcommand for --link-raster

1e4fd40

add --link-raster

0efb366

add subcommand for link raster

310a46a

github-actions bot added Python Related code is in Python libraries labels Mar 14, 2026

tangelll changed the title ~~add subcommand for --link-raster~~ r.external: add subcommand for vector, raster file and r.external.out Mar 14, 2026

tangelll changed the title ~~r.external: add subcommand for vector, raster file and r.external.out~~ cli: add --link and --out parameters for raster and vector files to 'run' tool Mar 14, 2026

tangelll changed the title ~~cli: add --link and --out parameters for raster and vector files to 'run' tool~~ tools: add --link and --out parameters for raster and vector files Mar 15, 2026

vector and raster out implemented

8184e33

Merge branch 'main' into subcommand_cli

a66b9d8

wenzeslaus requested changes Mar 18, 2026

View reviewed changes

tangelll added 2 commits March 29, 2026 18:06

Code Tests are added.

3063be1

test are added.

8f0e47b

github-actions bot added raster Related to raster data processing module tests Related to Test Suite labels Mar 29, 2026

tangelll changed the title ~~tools: add --link and --out parameters for raster and vector files~~ CLI: add --link and --out parameters for raster and vector files Apr 19, 2026

Merge branch 'main' into subcommand_cli

01e64e5

tangelll changed the title ~~CLI: add --link and --out parameters for raster and vector files~~ tools: add --link and --out parameters for raster and vector files Apr 19, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

tools: add --link and --out parameters for raster and vector files#7182

tools: add --link and --out parameters for raster and vector files#7182
tangelll wants to merge 8 commits intoOSGeo:mainfrom
tangelll:subcommand_cli

tangelll commented Mar 14, 2026 •

edited

Loading

Uh oh!

tangelll commented Mar 17, 2026 •

edited

Loading

Uh oh!

wenzeslaus left a comment

Uh oh!

wenzeslaus Mar 18, 2026

Uh oh!

wenzeslaus Mar 18, 2026

Uh oh!

tangelll commented Mar 29, 2026 •

edited

Loading

Uh oh!

echoix commented Mar 29, 2026

Uh oh!

tangelll commented Apr 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

tangelll commented Mar 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description:

Before Start

Test

Result

Test For v.external under testsuite

Uh oh!

tangelll commented Mar 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

wenzeslaus left a comment

Choose a reason for hiding this comment

Uh oh!

wenzeslaus Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

wenzeslaus Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

tangelll commented Mar 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

echoix commented Mar 29, 2026

Uh oh!

tangelll commented Apr 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

tangelll commented Mar 14, 2026 •

edited

Loading

tangelll commented Mar 17, 2026 •

edited

Loading

tangelll commented Mar 29, 2026 •

edited

Loading