Add cleanup flag to plugin install command

mostafa · mostafa · commit ae0971c3d127 · 2023-09-29T00:46:05.000+02:00
diff --git a/developing-plugins/grpc-api-reference.md b/developing-plugins/grpc-api-reference.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: gRPC API Reference
 description: GatewayD exposes a gRPC API that can be used to interact with the GatewayD plugin system. This API can be used by the GatewayD plugins and is available in the GatewayD SDK.
diff --git a/developing-plugins/index.md b/developing-plugins/index.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Developing Plugins
 nav_order: 4
diff --git a/developing-plugins/plugin-developers-guide.md b/developing-plugins/plugin-developers-guide.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Plugin Developers Guide
 description: Plugin developers' guide of GatewayD
diff --git a/developing-plugins/sdk-reference.md b/developing-plugins/sdk-reference.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: SDK Reference
 description: The GatewayD plugin SDK provides a number of interfaces, structs and methods to help you build your plugin.
diff --git a/developing-plugins/template-projects.md b/developing-plugins/template-projects.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Template Projects
 description: Template projects can be used to quickly get started with developing plugins.
diff --git a/getting-started/index.md b/getting-started/index.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Getting Started
 nav_order: 1
diff --git a/getting-started/installation.md b/getting-started/installation.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Installation
 description: How to install GatewayD and its plugins on different platforms and how to build it from source.
diff --git a/getting-started/running-gatewayd.md b/getting-started/running-gatewayd.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Running GatewayD
 description: How to run GatewayD and test it with psql
@@ -101,7 +101,7 @@ Running GatewayD will produce this log output, which means that GatewayD is star
 ```
 
 {: .note }
-> The `run` command automatically lints the configuration files and exits if there is an error. You can skip the linting by using the `--lint false` flag.
+> The `run` command automatically lints the configuration files and exits if there is an error. You can skip the linting by using the `--lint=false` flag.
 
 ## 5. Test your setup with `psql`
 
diff --git a/getting-started/welcome.md b/getting-started/welcome.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Welcome
 description: Introduction to GatewayD and its key features
diff --git a/miscellaneous/glossary.md b/miscellaneous/glossary.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Glossary
 description: Glossary of GatewayD terms
diff --git a/miscellaneous/index.md b/miscellaneous/index.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Miscellaneous
 nav_order: 6
diff --git a/miscellaneous/telemetry-and-usage-report.md b/miscellaneous/telemetry-and-usage-report.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Telemetry and Usage Report
 description: Telemetry and usage report of GatewayD
diff --git a/plugins/gatewayd-plugin-cache.md b/plugins/gatewayd-plugin-cache.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: gatewayd-plugin-cache
 description: GatewayD plugin for caching query results in Redis.
diff --git a/plugins/index.md b/plugins/index.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Plugins
 nav_order: 5
diff --git a/using-gatewayd/API.md b/using-gatewayd/API.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: API
 description: GatewayD exposes a gRPC API with an HTTP gateway for querying and managing the `gatewayd` process and its plugins.
diff --git a/using-gatewayd/CLI.md b/using-gatewayd/CLI.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: CLI
 description: GatewayD is a CLI application that runs on Windows, Linux-based distributions and macOS.
@@ -20,7 +20,7 @@ GatewayD is a CLI application that runs on Windows, Linux-based distributions an
 | `help`           | shows help about any subcommand                                       | The `-h` or `--help` flag can be used to get more information about a specific subcommand.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `plugin`         | manages GatewayD plugins and their configurations                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | `plugin init`    | generates a plugins configuration file                                | - `-p`, `--plugin-config`: plugins config file (default "gatewayd_plugins.yaml")<br/>- `-f`, `--force`: overwrites the existing config file<br/>- `--sentry`: Enable Sentry for error reporting (default `true`)                                                                                                                                                                                                                                                                                                                                                                                        |
-| `plugin install` | installs a plugin from GitHub or a locally downloaded archive file    | - `-p`, `--plugin-config`: plugins config file (default "gatewayd_plugins.yaml")<br/>- `-o`, `--output-dir`: output directory of the plugin, where the plugin is extracted (default "./plugins")<br/>- `--pull-only`: only pull the plugin, don't install it<br/>- `--sentry`: Enable Sentry for error reporting (default `true`)                                                                                                                                                                                                                                                                       |
+| `plugin install` | installs a plugin from GitHub or a locally downloaded archive file    | - `-p`, `--plugin-config`: plugins config file (default "gatewayd_plugins.yaml")<br/>- `-o`, `--output-dir`: output directory of the plugin, where the plugin is extracted (default "./plugins")<br/>- `--pull-only`: only pull the plugin, don't install it<br/>- `--cleanup`: Clean up the downloaded and extracted files after installing the plugin (default `true`)<br/>- `--sentry`: Enable Sentry for error reporting (default `true`)                                                                                                                                                           |
 | `plugin lint`    | validates plugins configuration file                                  | - `-p`, `--plugin-config`: plugins config file (default "gatewayd_plugins.yaml")<br/>- `--sentry`: Enable Sentry for error reporting (default `true`)                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 | `plugin list`    | lists all installed plugins                                           | - `-p`, `--plugin-config`: plugins config file (default "gatewayd_plugins.yaml")<br/>- `-e`, `--only-enabled`: Only list enabled plugins<br/>- `--sentry`: Enable Sentry for error reporting (default `true`)                                                                                                                                                                                                                                                                                                                                                                                           |
 | `run`            | runs an instance of `gatewayd` with the specified configuration files | - `-c`, `--config`: global config file (default `"gatewayd.yaml"`)<br/>- `-p`, `--plugin-config`: plugin config file (default `"gatewayd_plugins.yaml"`)<br/>- `--tracing`: Enable tracing with OpenTelemetry via gRPC<br/>- `--collector-url string`: Collector URL of OpenTelemetry gRPC endpoint (default `"localhost:4317"`)<br/>- `--sentry`: Enable Sentry for error reporting (default `true`)<br/>- `--lint`: Enable linting of configuration files (default `true`)<br/>- `--dev`: Enable development mode for plugin development<br/>- `--usage-report`: Enable usage report (default `true`) |
diff --git a/using-gatewayd/clients.md b/using-gatewayd/clients.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Clients
 description: Client object is a client that can connect to the database servers over TCP, UDP and Unix Domain Socket.
diff --git a/using-gatewayd/configuration.md b/using-gatewayd/configuration.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Configuration
 description: GatewayD is fully configurable via various sources, including default values, YAML config files, environment variables, CLI flags and plugins.
diff --git a/using-gatewayd/connection-lifecycle.md b/using-gatewayd/connection-lifecycle.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Connection Lifecycle
 description: Connection Lifecycle of GatewayD
diff --git a/using-gatewayd/global-configuration/api.md b/using-gatewayd/global-configuration/api.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: API
 description: GatewayD gRPC API configuration
diff --git a/using-gatewayd/global-configuration/clients.md b/using-gatewayd/global-configuration/clients.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Clients
 description: GatewayD client configuration
diff --git a/using-gatewayd/global-configuration/index.md b/using-gatewayd/global-configuration/index.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Global Configuration
 nav_order: 2
diff --git a/using-gatewayd/global-configuration/loggers.md b/using-gatewayd/global-configuration/loggers.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Loggers
 description: GatewayD logger configuration
diff --git a/using-gatewayd/global-configuration/metrics.md b/using-gatewayd/global-configuration/metrics.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Metrics
 description: GatewayD metrics configuration
diff --git a/using-gatewayd/global-configuration/pools.md b/using-gatewayd/global-configuration/pools.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Pools
 description: GatewayD pool configuration
diff --git a/using-gatewayd/global-configuration/proxies.md b/using-gatewayd/global-configuration/proxies.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Proxies
 description: GatewayD proxy configuration
diff --git a/using-gatewayd/global-configuration/servers.md b/using-gatewayd/global-configuration/servers.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Servers
 description: GatewayD server configuration
diff --git a/using-gatewayd/index.md b/using-gatewayd/index.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Using GatewayD
 nav_order: 2
diff --git a/using-gatewayd/observability.md b/using-gatewayd/observability.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Observability
 description: Observability is a first-class citizen of GatewayD. It generates logs, metrics and traces to make it easier to see what is going on inside.
diff --git a/using-gatewayd/plugins-configuration/general-configurations.md b/using-gatewayd/plugins-configuration/general-configurations.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: General configurations
 description: General configurations for plugins
diff --git a/using-gatewayd/plugins-configuration/index.md b/using-gatewayd/plugins-configuration/index.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Plugins Configuration
 nav_order: 3
diff --git a/using-gatewayd/plugins-configuration/plugins-configuration.md b/using-gatewayd/plugins-configuration/plugins-configuration.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Plugins configuration
 description: GatewayD plugins configuration
diff --git a/using-gatewayd/pools.md b/using-gatewayd/pools.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Pools
 description: GatewayD has a generic internal pool object that is used to manage plugins and connections.
diff --git a/using-gatewayd/protocols.md b/using-gatewayd/protocols.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Protocols
 description: GatewayD is application layer protocol-agnostic. This means that GatewayD *can* practically support any protocol in the application layer, or L7.
diff --git a/using-gatewayd/proxies.md b/using-gatewayd/proxies.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Proxies
 description: Proxy object is used to create a binding between incoming connections from the database clients to the database servers.
diff --git a/using-gatewayd/servers.md b/using-gatewayd/servers.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Servers
 description: Server is an object that listens on an address:port pair and accepts connections from database clients.
diff --git a/using-plugins/hook-registry.md b/using-plugins/hook-registry.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Hook registry
 description: The hook registry is a central place where all hooks are registered and executed. It is used by the plugin registry to register and execute plugin hooks.
diff --git a/using-plugins/hooks.md b/using-plugins/hooks.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Hooks
 description: Plugins can be used to modify the connection lifecycle. Each step in the connection lifecycle is represented by one or more plugin hook(s). Plugins can register themselves to be called when a specific hook is triggered.
diff --git a/using-plugins/index.md b/using-plugins/index.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Using Plugins
 nav_order: 3
diff --git a/using-plugins/plugin-registry.md b/using-plugins/plugin-registry.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Plugin registry
 description: The plugin registry is a central place where all plugins are loaded, configured and executed, and also the main entry point for all plugins.
diff --git a/using-plugins/plugin-types.md b/using-plugins/plugin-types.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Plugin types
 description: >
diff --git a/using-plugins/plugins.md b/using-plugins/plugins.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Plugins
 description: Plugins play a very important role in GatewayD for adding support for different databases. They are the building blocks of GatewayD, and they are responsible for the majority of the functionality of GatewayD.
diff --git a/using-plugins/proposals.md b/using-plugins/proposals.md
@@ -1,5 +1,5 @@
 ---
-last_modified_date: 2023-09-26 23:58:54 +0200
+last_modified_date: 2023-09-28 16:14:41 +0200
 layout: default
 title: Proposals
 description: GatewayD proposals are used to propose new ideas and features for GatewayD.
