refactor: use 'native' as engine type for go

README.md

@@ -61,7 +61,7 @@ Run `imposter up` to start your mock.
 
 ## Install
 
-You'll need [Docker](https://docs.docker.com/get-docker/), or alternatively a JVM ([JVM engine](./docs/engine_jvm.md)) or no extra runtime at all ([Golang engine](./docs/engine_golang.md)).
+You'll need [Docker](https://docs.docker.com/get-docker/), or alternatively a JVM ([JVM engine](./docs/engine_jvm.md)) or no extra runtime at all ([Native engine](./docs/engine_native.md)).
 
 ### Homebrew
 
@@ -127,7 +127,7 @@ Other deeper guides:
 
 - [Docker engine](./docs/engine_docker.md) — the default
 - [JVM engine](./docs/engine_jvm.md)
-- [Golang engine](./docs/engine_golang.md)
+- [Native engine](./docs/engine_native.md)
 - [Run the CLI itself in Docker](./docs/docker.md)
 - [SDK — embed Imposter in your Go app](./docs/sdk.md)
 - [Upgrade](./docs/upgrade.md)

cmd/common.go

@@ -11,15 +11,15 @@ var localTypes = []engine.EngineType{
 	engine.EngineTypeDockerAll,
 	engine.EngineTypeDockerDistroless,
 	engine.EngineTypeJvmSingleJar,
-	engine.EngineTypeGolang,
+	engine.EngineTypeNative,
 }
 
 // allEngineTypes is the distinct set of engine types used by --all flags.
 // Only one docker variant is included to avoid duplicate results.
 var allEngineTypes = []engine.EngineType{
 	engine.EngineTypeDockerCore,
 	engine.EngineTypeJvmSingleJar,
-	engine.EngineTypeGolang,
+	engine.EngineTypeNative,
 }
 
 // runWithRecovery executes fn, recovering from logger.Fatal calls that

cmd/down.go

@@ -43,7 +43,7 @@ var downCmd = &cobra.Command{
 }
 
 func init() {
-	downCmd.Flags().StringVarP(&downFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,golang,jvm - default \"docker\")")
+	downCmd.Flags().StringVarP(&downFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,native,jvm - default \"docker\")")
 	downCmd.Flags().BoolVarP(&downFlags.all, "all", "a", false, "Stop mocks for all engine types")
 	downCmd.MarkFlagsMutuallyExclusive("engine-type", "all")
 	registerEngineTypeCompletions(downCmd)

cmd/down_test.go

@@ -36,8 +36,8 @@ func Test_stopEngine(t *testing.T) {
 			engineType: engine.EngineTypeJvmSingleJar,
 		},
 		{
-			name:       "stop golang engine",
-			engineType: engine.EngineTypeGolang,
+			name:       "stop native engine",
+			engineType: engine.EngineTypeNative,
 		},
 	}
 	for _, tt := range tests {

cmd/engine_list.go

@@ -77,7 +77,7 @@ func renderEngines(rows [][]string) {
 }
 
 func init() {
-	engineListCmd.Flags().StringVarP(&engineListFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,golang,jvm - default is all")
+	engineListCmd.Flags().StringVarP(&engineListFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,native,jvm - default is all")
 	registerEngineTypeCompletions(engineListCmd)
 	engineCmd.AddCommand(engineListCmd)
 }

cmd/engine_pull.go

@@ -57,7 +57,7 @@ func pull(version string, engineType engine.EngineType, pullPolicy engine.PullPo
 }
 
 func init() {
-	enginePullCmd.Flags().StringVarP(&enginePullFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,golang,jvm - default \"docker\")")
+	enginePullCmd.Flags().StringVarP(&enginePullFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,native,jvm - default \"docker\")")
 	enginePullCmd.Flags().StringVarP(&enginePullFlags.engineVersion, "version", "v", "", "Imposter engine version (default \"latest\")")
 	enginePullCmd.Flags().BoolVarP(&enginePullFlags.forcePull, "force", "f", false, "Force engine pull")
 	registerEngineTypeCompletions(enginePullCmd)

cmd/list.go

@@ -49,7 +49,7 @@ and reports their health.`,
 }
 
 func init() {
-	listCmd.Flags().StringVarP(&listFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,golang,jvm - default \"docker\")")
+	listCmd.Flags().StringVarP(&listFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,native,jvm - default \"docker\")")
 	listCmd.Flags().BoolVarP(&listFlags.all, "all", "a", false, "List mocks for all engine types")
 	listCmd.Flags().BoolVarP(&listFlags.healthExitCode, "exit-code-health", "x", false, "Set exit code based on mock health")
 	listCmd.Flags().BoolVarP(&listFlags.quiet, "quiet", "q", false, "Quieten output; only print ID")

cmd/list_test.go

@@ -20,8 +20,8 @@ import (
 	"bytes"
 	"github.com/imposter-project/imposter-cli/internal/engine"
 	"github.com/imposter-project/imposter-cli/internal/engine/docker"
-	"github.com/imposter-project/imposter-cli/internal/engine/golang"
 	"github.com/imposter-project/imposter-cli/internal/engine/jvm"
+	"github.com/imposter-project/imposter-cli/internal/engine/native"
 	"github.com/stretchr/testify/require"
 	"os"
 	"testing"
@@ -30,7 +30,7 @@ import (
 func init() {
 	docker.EnableEngine()
 	jvm.EnableSingleJarEngine()
-	golang.EnableEngine()
+	native.EnableEngine()
 }
 
 func Test_renderMocks_without_engine(t *testing.T) {
@@ -124,8 +124,8 @@ func Test_listMocksForEngine(t *testing.T) {
 			showEngine: true,
 		},
 		{
-			name:       "list golang mocks",
-			engineType: engine.EngineTypeGolang,
+			name:       "list native mocks",
+			engineType: engine.EngineTypeNative,
 			showEngine: true,
 		},
 	}

cmd/plugin.go

@@ -31,6 +31,6 @@ var pluginCmd = &cobra.Command{
 }
 
 func init() {
-	pluginCmd.PersistentFlags().StringVarP(&pluginFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,golang,jvm)")
+	pluginCmd.PersistentFlags().StringVarP(&pluginFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,native,jvm)")
 	rootCmd.AddCommand(pluginCmd)
 }

cmd/plugin_uninstall_test.go

@@ -167,7 +167,7 @@ func Test_uninstallNonInstalledPluginFromDefaults(t *testing.T) {
 	})
 
 	// Test uninstalling a plugin that's in defaults but not installed
-	uninstallPlugins([]string{"swaggerui"}, engine.EngineTypeGolang, "1.2.4", true)
+	uninstallPlugins([]string{"swaggerui"}, engine.EngineTypeNative, "1.2.4", true)
 
 	// Verify plugin was removed from defaults
 	defaultPlugins, err := plugin.ListDefaultPlugins()
@@ -200,7 +200,7 @@ func Test_uninstallMultiplePluginsFromDefaults(t *testing.T) {
 	}
 
 	// Test uninstalling some plugins that are in defaults but not installed
-	uninstallPlugins([]string{"swaggerui", "store-redis"}, engine.EngineTypeGolang, "1.2.4", true)
+	uninstallPlugins([]string{"swaggerui", "store-redis"}, engine.EngineTypeNative, "1.2.4", true)
 
 	// Verify specified plugins were removed from defaults
 	defaultPlugins, err := plugin.ListDefaultPlugins()

cmd/up.go

@@ -116,7 +116,7 @@ If CONFIG_DIR is not specified, the current working directory is used.`,
 }
 
 func init() {
-	upCmd.Flags().StringVarP(&upFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,golang,jvm - default \"docker\")")
+	upCmd.Flags().StringVarP(&upFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,native,jvm - default \"docker\")")
 	upCmd.Flags().StringVarP(&upFlags.engineVersion, "version", "v", "", "Imposter engine version (default \"latest\")")
 	upCmd.Flags().IntVarP(&upFlags.port, "port", "p", 8080, "Port on which to listen")
 	upCmd.Flags().BoolVar(&upFlags.forcePull, "pull", false, "Force engine pull")

cmd/version.go

@@ -55,7 +55,7 @@ var versionCmd = &cobra.Command{
 }
 
 func init() {
-	versionCmd.Flags().StringVarP(&versionFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,golang,jvm - default \"docker\")")
+	versionCmd.Flags().StringVarP(&versionFlags.engineType, "engine-type", "t", "", "Imposter engine type (valid: docker,native,jvm - default \"docker\")")
 	versionCmd.Flags().StringVarP(&versionFlags.format, "output-format", "o", "", "Output format (valid: plain,json - default \"plain\")")
 	versionCmd.Flags().BoolVar(&versionFlags.full, "full", false, "Also print the engine version (if available)")
 	registerEngineTypeCompletions(versionCmd)

cmd/version_test.go

@@ -64,9 +64,9 @@ func Test_describeVersions(t *testing.T) {
 			},
 		},
 		{
-			name: "print latest version (golang)",
+			name: "print latest version (native)",
 			args: args{
-				engineType: engine.EngineTypeGolang,
+				engineType: engine.EngineTypeNative,
 				version:    "latest",
 				full:       true,
 				format:     outputFormatPlain,

docs/config.md

@@ -33,7 +33,8 @@ You can also use a configuration file to set CLI defaults. By default, Imposter
 The currently supported elements are as follows:
 
 ```yaml
-# the engine type - valid values are "docker", "jvm" or "golang"
+# the engine type - valid values are "docker", "jvm" or "native"
+# (the legacy value "golang" is still accepted as an alias for "native")
 engine: "docker"
 
 # the engine version - valid values are "latest", or a binary release such as "2.0.1"
@@ -105,8 +106,8 @@ Some configuration elements can be specified as environment variables:
 
 ### Engine types
 
-Imposter supports different mock engine types: Docker (default), JVM and Golang. For more information about configuring the engine type see:
+Imposter supports different mock engine types: Docker (default), JVM and native. For more information about configuring the engine type see:
 
 - [Docker engine](./engine_docker.md) (default)
 - [JVM engine](./engine_jvm.md)
-- [Golang engine](./engine_golang.md)
+- [Native engine](./engine_native.md)

docs/engine_docker.md

@@ -1,6 +1,6 @@
 # Using the Docker mock engine
 
-Imposter supports different mock engine types: Docker, [JVM](./engine_jvm.md) and [Golang](./engine_golang.md). This document describes how to use the **Docker** engine.
+Imposter supports different mock engine types: Docker, [JVM](./engine_jvm.md) and [Native](./engine_native.md). This document describes how to use the **Docker** engine.
 
 ## Prerequisites
 

docs/engine_jvm.md

@@ -1,6 +1,6 @@
 # Using the JVM mock engine
 
-Imposter supports different mock engine types: [Docker](./engine_docker.md), JVM and [Golang](./engine_golang.md). This document describes how to use the **JVM** engine.
+Imposter supports different mock engine types: [Docker](./engine_docker.md), JVM and [Native](./engine_native.md). This document describes how to use the **JVM** engine.
 
 ## Prerequisites
 

docs/engine_golang.md → docs/engine_native.md

@@ -1,16 +1,18 @@
-# Using the Golang mock engine
+# Using the native mock engine
 
-Imposter supports different mock engine types: [Docker](./engine_docker.md), [JVM](./engine_jvm.md) and Golang. This document describes how to use the **Golang** engine.
+Imposter supports different mock engine types: [Docker](./engine_docker.md), [JVM](./engine_jvm.md) and native. This document describes how to use the **native** engine.
 
-The Golang engine is a lightweight, single-binary implementation of Imposter. It supports REST, OpenAPI, SOAP and gRPC mocking with JavaScript scripting.
+The native engine is a lightweight, single-binary implementation of Imposter. It supports REST, OpenAPI, SOAP and gRPC mocking with JavaScript scripting.
+
+> The native engine was previously named `golang`. The `golang` value is still accepted as a deprecated alias wherever the engine type can be configured.
 
 ## Prerequisites
 
-No additional software is required. The Golang engine is downloaded automatically by the CLI.
+No additional software is required. The native engine is downloaded automatically by the CLI.
 
 ## Features
 
-The Golang engine supports:
+The native engine supports:
 
 - REST, OpenAPI (2.0 and 3.0+), SOAP (1.1 and 1.2) and gRPC plugins
 - JavaScript scripting (Groovy is **not** supported)
@@ -30,29 +32,29 @@ The easiest way to set the engine type is to edit your user default [configurati
 
     $HOME/.imposter/config.yaml
 
-Set the `engine` key to `golang`:
+Set the `engine` key to `native`:
 
 ```yaml
-engine: golang
+engine: native
 ```
 
 ### Environment variable
 
 If you don't want to set your user defaults you can set the following environment variable:
 
-    IMPOSTER_ENGINE=golang
+    IMPOSTER_ENGINE=native
 
 ### Command line argument
 
 You can also provide the `--engine-type` (or `-t`) command line argument to the `imposter up` command:
 
 Example:
 
-    imposter up --engine-type golang
+    imposter up --engine-type native
 
 Or:
 
-    imposter up -t golang
+    imposter up -t native
 
 ## Differences from the JVM engine
 

docs/engine_unpacked.md

@@ -2,7 +2,7 @@
 
 > **Important:** This method is primarily intended for use by tools, not end users. If you are unsure, and you really want to use the JVM directly, you probably want the [JVM engine](./engine_jvm.md).
 
-Imposter supports different mock engine types: [Docker](./engine_docker.md), [JVM](./engine_jvm.md) and [Golang](./engine_golang.md). This document describes how to use the **unpacked** engine.
+Imposter supports different mock engine types: [Docker](./engine_docker.md), [JVM](./engine_jvm.md) and [Native](./engine_native.md). This document describes how to use the **unpacked** engine.
 
 ## Prerequisites
 

docs/install.md

@@ -6,11 +6,11 @@ Imposter can be installed on Linux, macOS and Windows.
 
 ## Prerequisites
 
-Imposter supports different mock engine types: Docker (default), JVM and Golang. For more information about configuring the engine type see:
+Imposter supports different mock engine types: Docker (default), JVM and native. For more information about configuring the engine type see:
 
 - [Docker engine](./engine_docker.md) (default)
 - [JVM engine](./engine_jvm.md)
-- [Golang engine](./engine_golang.md)
+- [Native engine](./engine_native.md)
 
 **You must have at least one of the engine types configured to use Imposter.**
 

docs/sdk.md

@@ -14,7 +14,7 @@ The Imposter SDK allows you to embed Imposter directly into your own Go applicat
 There are a few key concepts to learn before using the SDK:
 
 - **configuration directory**: a directory containing a valid Imposter [configuration](https://docs.imposter.sh/configuration/)
-- **engine type**: this can be `docker`, `jvm` or `golang` - see [Docker Engine](./engine_docker.md), [JVM Engine](./engine_jvm.md) or [Golang Engine](./engine_golang.md)
+- **engine type**: this can be `docker`, `jvm` or `native` - see [Docker Engine](./engine_docker.md), [JVM Engine](./engine_jvm.md) or [Native Engine](./engine_native.md)
 - **engine version**: this is the version of Imposter - see [Releases](https://github.com/imposter-project/imposter-jvm-engine/releases)
 
 ## Getting started
@@ -43,7 +43,7 @@ func main() {
     configDir := "/path/to/imposter/config"
 
     // register the engine implementation you want to use.
-    // swap for jvm.EnableEngine() or golang.EnableEngine() as required.
+    // swap for jvm.EnableEngine() or native.EnableEngine() as required.
     docker.EnableEngine()
 
     startOptions := engine.StartOptions{
@@ -67,11 +67,11 @@ The matching engine type constants live on the `engine` package:
 
 - `engine.EngineTypeDockerCore` (paired with `docker.EnableEngine()`)
 - `engine.EngineTypeJvmSingleJar` (paired with `jvm.EnableEngine()`)
-- `engine.EngineTypeGolang` (paired with `golang.EnableEngine()`)
+- `engine.EngineTypeNative` (paired with `native.EnableEngine()`)
 
 ## Learn more
 
 - [Configuration reference](https://docs.imposter.sh/configuration/)
 - [Docker Engine](./engine_docker.md)
 - [JVM Engine](./engine_jvm.md)
-- [Golang Engine](./engine_golang.md)
+- [Native Engine](./engine_native.md)

internal/engine/builder.go

@@ -36,10 +36,24 @@ const (
 	EngineTypeDockerDistroless EngineType = "docker-distroless"
 	EngineTypeJvmSingleJar     EngineType = "jvm"
 	EngineTypeJvmUnpacked      EngineType = "unpacked"
-	EngineTypeGolang           EngineType = "golang"
+	EngineTypeNative           EngineType = "native"
 )
 const defaultEngineType = EngineTypeDockerCore
 
+// engineTypeAliases maps deprecated user-facing engine type names to their canonical form.
+// Aliases are accepted on user input (CLI flag, env var, config file) but not surfaced in
+// help text or shell completions.
+var engineTypeAliases = map[EngineType]EngineType{
+	"golang": EngineTypeNative,
+}
+
+func normaliseEngineType(t EngineType) EngineType {
+	if canon, ok := engineTypeAliases[t]; ok {
+		return canon
+	}
+	return t
+}
+
 var logger = logging.GetLogger()
 
 var (
@@ -103,7 +117,7 @@ func build(engineType EngineType, configDir string, startOptions StartOptions) M
 
 func validateEngineType(engineType EngineType) error {
 	switch engineType {
-	case EngineTypeAwsLambda, EngineTypeDockerCore, EngineTypeDockerAll, EngineTypeDockerDistroless, EngineTypeJvmSingleJar, EngineTypeJvmUnpacked, EngineTypeGolang:
+	case EngineTypeAwsLambda, EngineTypeDockerCore, EngineTypeDockerAll, EngineTypeDockerDistroless, EngineTypeJvmSingleJar, EngineTypeJvmUnpacked, EngineTypeNative:
 		return nil
 	}
 	return fmt.Errorf("unsupported engine type: %v", engineType)
@@ -114,11 +128,11 @@ func GetConfiguredType(override string) EngineType {
 }
 
 func GetConfiguredTypeWithDefault(override string, defaultType EngineType) EngineType {
-	return EngineType(stringutil.GetFirstNonEmpty(
+	return normaliseEngineType(EngineType(stringutil.GetFirstNonEmpty(
 		override,
 		viper.GetString("engine"),
 		string(defaultType),
-	))
+	)))
 }
 
 func GetConfiguredVersion(engineType EngineType, override string, allowCached bool) string {

internal/engine/builder_test.go

@@ -49,6 +49,8 @@ func TestGetConfiguredType(t *testing.T) {
 		{name: "return overridden engine type", args: args{override: "docker"}, want: "docker"},
 		{name: "return configured engine type", args: args{override: ""}, configureType: "jvm", want: "jvm"},
 		{name: "return default engine type", args: args{override: ""}, want: defaultEngineType},
+		{name: "normalise legacy golang override to native", args: args{override: "golang"}, want: EngineTypeNative},
+		{name: "normalise legacy golang config to native", args: args{override: ""}, configureType: "golang", want: EngineTypeNative},
 	}
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {