This is an automated email from the ASF dual-hosted git repository.
mattcasters pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/hop.git
The following commit(s) were added to refs/heads/main by this push:
new d934b70896 Issue #8292 : Rename in-memory short option from -im to
-ime (#8293)
d934b70896 is described below
commit d934b708968dd72f74f33248b1b514437ff83714
Author: Matt Casters <[email protected]>
AuthorDate: Tue Sep 8 23:25:39 2026 +0200
Issue #8292 : Rename in-memory short option from -im to -ime (#8293)
The projects plugin -im / --in-memory flag collided with hop doc
-im / --include-metadata, which made hop doc fail to start.
---
docs/hop-user-manual/modules/ROOT/pages/hop-run/index.adoc | 2 +-
docs/hop-user-manual/modules/ROOT/pages/hop-tools/hop-gui.adoc | 6 +++---
docs/hop-user-manual/modules/ROOT/pages/hop-tools/hop.adoc | 6 +++---
docs/hop-user-manual/modules/ROOT/pages/projects/advanced.adoc | 2 +-
docs/hop-user-manual/modules/ROOT/pages/variables.adoc | 2 +-
engine/src/main/java/org/apache/hop/hop/Hop.java | 2 +-
.../java/org/apache/hop/projects/config/ProjectsOptionPlugin.java | 2 +-
7 files changed, 11 insertions(+), 11 deletions(-)
diff --git a/docs/hop-user-manual/modules/ROOT/pages/hop-run/index.adoc
b/docs/hop-user-manual/modules/ROOT/pages/hop-run/index.adoc
index 04f7428277..b68acf41a5 100644
--- a/docs/hop-user-manual/modules/ROOT/pages/hop-run/index.adoc
+++ b/docs/hop-user-manual/modules/ROOT/pages/hop-run/index.adoc
@@ -146,7 +146,7 @@ Check the
xref:pipeline/pipeline-run-configurations/pipeline-run-configurations.
|```--system-properties```
|A comma separated list of KEY=VALUE pairs
-|```-im```
+|```-ime```
|```--in-memory```
|Keep Hop configuration in memory. Changes are not written to
`hop-config.json`. Implied by `--project-locations` and `--environments`.
diff --git a/docs/hop-user-manual/modules/ROOT/pages/hop-tools/hop-gui.adoc
b/docs/hop-user-manual/modules/ROOT/pages/hop-tools/hop-gui.adoc
index 7fd82a2b67..9f32002916 100644
--- a/docs/hop-user-manual/modules/ROOT/pages/hop-tools/hop-gui.adoc
+++ b/docs/hop-user-manual/modules/ROOT/pages/hop-tools/hop-gui.adoc
@@ -47,7 +47,7 @@ The same `-j`, `-e` and `-f` options work with `hop-gui.sh` /
`hop-gui.bat`.
.Output of help
[source,bash]
----
-Usage: hop gui [-hV] [-im] [-e=<environmentOption>] [-f=<filename>]
+Usage: hop gui [-hV] [-ime] [-e=<environmentOption>] [-f=<filename>]
[-j=<projectOption>]
[--environment-conf-files=<environmentConfigFiles>[,
<environmentConfigFiles>...]]...
[--environments=<environments>[,
@@ -58,7 +58,7 @@ The Hop GUI
The name of the lifecycle environment to use
-f, --file=<filename> The filename of the workflow or pipeline to open
-h, --help Show this help message and exit.
- -im, --in-memory Keep configuration in memory without persisting to
+ -ime, --in-memory Keep configuration in memory without persisting to
hop-config.json
-j, --project=<projectOption>
The name of the project to use
@@ -76,7 +76,7 @@ The available options are listed in more detail in the table
below:
|`-e`|`--environment`|The name of the lifecycle environment to enable. The
project name is taken from that environment, so you do not need `-j` as well.
See xref:projects/projects-environments.adoc[Projects and Environments].
|`-f`|`--file`|The filename of the workflow or pipeline to open. Relative
paths are resolved against the current directory, then
`{openvar}PROJECT_HOME{closevar}`.
|`-h`|`--help`|Displays this help message and quits.
-|`-im`|`--in-memory`|Keep Hop configuration in memory. Changes are not written
to `hop-config.json`.
+|`-ime`|`--in-memory`|Keep Hop configuration in memory. Changes are not
written to `hop-config.json`.
|`-j`|`--project`|The name of the project to enable. Not needed when `-e` is
set.
|`-pl`|`--project-locations`|Comma-separated project locations to register for
this process only (`name=/path` or a zip/jar). See
xref:projects/advanced.adoc#_use_a_project_without_hop_config_json[Use a
project without hop-config.json].
||`--environments`|Comma-separated environment definitions
(`name=[project:]file1;file2`) registered in memory for this process.
diff --git a/docs/hop-user-manual/modules/ROOT/pages/hop-tools/hop.adoc
b/docs/hop-user-manual/modules/ROOT/pages/hop-tools/hop.adoc
index 5ffba2f42c..d0db2c90fd 100644
--- a/docs/hop-user-manual/modules/ROOT/pages/hop-tools/hop.adoc
+++ b/docs/hop-user-manual/modules/ROOT/pages/hop-tools/hop.adoc
@@ -33,7 +33,7 @@ The command list depends on the plugins in your installation;
the sample below s
[source,bash]
----
$ ./hop help
-Usage: hop [-hV] [--dev-debug] [--dev-debug-wait] [-im]
+Usage: hop [-hV] [--dev-debug] [--dev-debug-wait] [-ime]
[-e=<environmentOption>] [-j=<projectOption>]
[--environment-conf-files=<environmentConfigFiles>[,
<environmentConfigFiles>...]]... [--environments=<environments>[,
@@ -43,7 +43,7 @@ Usage: hop [-hV] [--dev-debug] [--dev-debug-wait] [-im]
-e, --environment=<environmentOption>
The name of the lifecycle environment to use
-h, --help Show this help message and exit.
- -im, --in-memory Keep configuration in memory without persisting to
+ -ime, --in-memory Keep configuration in memory without persisting to
hop-config.json
-j, --project=<projectOption>
The name of the project to use
@@ -74,7 +74,7 @@ Commands:
|Short|Extended|Description
|`-e`|`--environment`|The name of the lifecycle environment to enable before
the subcommand runs.
|`-h`|`--help`|Displays this help message and quits.
-|`-im`|`--in-memory`|Keep Hop configuration in memory. Changes are not written
to `hop-config.json`. Implied by `--project-locations` and `--environments`.
+|`-ime`|`--in-memory`|Keep Hop configuration in memory. Changes are not
written to `hop-config.json`. Implied by `--project-locations` and
`--environments`.
|`-j`|`--project`|The name of the project to enable before the subcommand runs.
|`-pl`|`--project-locations`|Comma-separated project locations to register for
this process only (`name=/path`, a zip/jar, or a bare folder). See
xref:projects/advanced.adoc#_use_a_project_without_hop_config_json[Use a
project without hop-config.json].
||`--environments`|Comma-separated environment definitions
(`name=[project:]file1;file2`) registered in memory for this process.
diff --git a/docs/hop-user-manual/modules/ROOT/pages/projects/advanced.adoc
b/docs/hop-user-manual/modules/ROOT/pages/projects/advanced.adoc
index 6905eb93e2..51a53ae7a7 100644
--- a/docs/hop-user-manual/modules/ROOT/pages/projects/advanced.adoc
+++ b/docs/hop-user-manual/modules/ROOT/pages/projects/advanced.adoc
@@ -212,7 +212,7 @@ hop --project-locations edw=/data/edw --environments
edw-prod=/data/edw-prod.jso
If the project name is omitted, Hop infers it from the registered projects.
`--environment-conf-files` (also `--environment-config-files`) adds extra
variable files to the enabled project or environment.
-`-im` / `--in-memory` keeps Hop configuration in memory even when you are not
using `--project-locations`.
+`-ime` / `--in-memory` keeps Hop configuration in memory even when you are not
using `--project-locations`.
The same behaviour can be enabled with the
`{openvar}HOP_CONFIG_IN_MEMORY{closevar}` system variable set to `Y`.
These options are available on the `hop` root command (so they apply before
`run`, `gui`, `search`, and so on) and on the subcommands themselves (`hop run
-pl ...`, `hop gui -pl ...`).
diff --git a/docs/hop-user-manual/modules/ROOT/pages/variables.adoc
b/docs/hop-user-manual/modules/ROOT/pages/variables.adoc
index a7d63b35a0..de74e26ab9 100644
--- a/docs/hop-user-manual/modules/ROOT/pages/variables.adoc
+++ b/docs/hop-user-manual/modules/ROOT/pages/variables.adoc
@@ -332,7 +332,7 @@ Additionally, the following environment variables can help
you to add even more
|===
|Variable|Default|Description
|HOP_AUTO_CREATE_CONFIG|N|Set this variable to 'Y' to automatically create
config file when it's missing.
-|HOP_CONFIG_IN_MEMORY|N|Set this variable to 'Y' to keep the Hop configuration
in memory without persisting to disk. The
`{openvar}HOP_CONFIG_IN_MEMORY{closevar}` equivalent on the command line is
`-im` / `--in-memory`.
+|HOP_CONFIG_IN_MEMORY|N|Set this variable to 'Y' to keep the Hop configuration
in memory without persisting to disk. The
`{openvar}HOP_CONFIG_IN_MEMORY{closevar}` equivalent on the command line is
`-ime` / `--in-memory`.
|HOP_METADATA_FOLDER|-|The system environment variable pointing to the
alternative location for the Hop metadata folder
|HOP_REDIRECT_STDERR|N|Set this variable to Y to redirect stderr to Hop
logging.
|HOP_REDIRECT_STDOUT|N|Set this variable to Y to redirect stdout to Hop
logging.
diff --git a/engine/src/main/java/org/apache/hop/hop/Hop.java
b/engine/src/main/java/org/apache/hop/hop/Hop.java
index 4d2095412d..3e40715280 100644
--- a/engine/src/main/java/org/apache/hop/hop/Hop.java
+++ b/engine/src/main/java/org/apache/hop/hop/Hop.java
@@ -210,7 +210,7 @@ public class Hop {
if (arg == null) {
continue;
}
- if (arg.equals("-im")
+ if (arg.equals("-ime")
|| arg.equals("--in-memory")
|| arg.equals("-pl")
|| arg.startsWith("-pl=")
diff --git
a/plugins/misc/projects/src/main/java/org/apache/hop/projects/config/ProjectsOptionPlugin.java
b/plugins/misc/projects/src/main/java/org/apache/hop/projects/config/ProjectsOptionPlugin.java
index 6a8de46a1b..5937c13314 100644
---
a/plugins/misc/projects/src/main/java/org/apache/hop/projects/config/ProjectsOptionPlugin.java
+++
b/plugins/misc/projects/src/main/java/org/apache/hop/projects/config/ProjectsOptionPlugin.java
@@ -72,7 +72,7 @@ public class ProjectsOptionPlugin implements IConfigOptions {
protected String[] environmentConfigFiles = null;
@CommandLine.Option(
- names = {"-im", "--in-memory"},
+ names = {"-ime", "--in-memory"},
description = "Keep configuration in memory without persisting to
hop-config.json")
protected boolean inMemory = false;
