add python examples, prettierrrrr

docs/agent/cli.mdx

@@ -508,20 +508,20 @@ ngrok tcp --remote-addr=1.tcp.ngrok.io:27210 3389
 
 ### Flags
 
-| Flag                     | Description                                                                                               |
-| ------------------------ | --------------------------------------------------------------------------------------------------------- |
-| `--authtoken string`     | ngrok authtoken                                                                                           |
-| `--cidr-allow strings`   | reject connections that do not match the given CIDRs                                                      |
-| `--cidr-deny strings`    | reject connections that match the given CIDRs                                                             |
-| `--config strings`       | path to config files; they are merged if multiple                                                         |
-| `-h`, `--help`           | help for this command                                                                                     |
-| `--log string`           | path to log file, `stdout`, `stderr` or `false` (default `false`)                                         |
-| `--log-format string`    | log record format: `term`, `logfmt`, `json` (default `term`)                                              |
-| `--log-level string`     | `debug`, `info`, `warn`, `error`, `crit` (default `info`)                                                 |
-| `--policy-file string`   | path to traffic policy configuration YAML file (See [Traffic Policy](/tcp/traffic-policy/?cty=agent-cli)) |
-| `--proxy-proto string`   | version of proxy proto to use with this tunnel, empty if not using                                        |
-| `--region string`        | ngrok server region `us`, `us-cal-1`, `eu`, `au`, `ap`, `sa`, `jp`, `in` (default to closest)             |
-| `--remote-addr string`   | bind remote address (requires you reserve a TCP Address)                                                  |
+| Flag                   | Description                                                                                               |
+| ---------------------- | --------------------------------------------------------------------------------------------------------- |
+| `--authtoken string`   | ngrok authtoken                                                                                           |
+| `--cidr-allow strings` | reject connections that do not match the given CIDRs                                                      |
+| `--cidr-deny strings`  | reject connections that match the given CIDRs                                                             |
+| `--config strings`     | path to config files; they are merged if multiple                                                         |
+| `-h`, `--help`         | help for this command                                                                                     |
+| `--log string`         | path to log file, `stdout`, `stderr` or `false` (default `false`)                                         |
+| `--log-format string`  | log record format: `term`, `logfmt`, `json` (default `term`)                                              |
+| `--log-level string`   | `debug`, `info`, `warn`, `error`, `crit` (default `info`)                                                 |
+| `--policy-file string` | path to traffic policy configuration YAML file (See [Traffic Policy](/tcp/traffic-policy/?cty=agent-cli)) |
+| `--proxy-proto string` | version of proxy proto to use with this tunnel, empty if not using                                        |
+| `--region string`      | ngrok server region `us`, `us-cal-1`, `eu`, `au`, `ap`, `sa`, `jp`, `in` (default to closest)             |
+| `--remote-addr string` | bind remote address (requires you reserve a TCP Address)                                                  |
 
 ## ngrok tls
 

docs/http/traffic-policy/actions/deny.mdx

@@ -24,4 +24,4 @@ If this action is executed, no further actions or policy rules in the policy con
 
 | Parameter     |   | Description                                                            |
 | ------------- | ------ | ---------------------------------------------------------------------- |
-| `status_code` | int    | The status code of the response. If not specified, `999` will be used. |
+| `status_code` | int    | The status code of the response. If not specified, `999` will be used. |

docs/http/traffic-policy/actions/rate-limit.mdx

@@ -30,10 +30,10 @@ Currently, the `capacity` for each bucket is applied per ingress server.
 | ------------ |
 | `rate-limit` |
 
-| Parameter    |               | Description                                                                                                                                                                                                                                                                                                          |
-| ------------ | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `name`       | string             | A name for this rate limit configuration.                                                                                                                                                                                                                                                                            |
-| `algorithm`  | string             | The rate limit algorithm to be used. Supported options: `"sliding_window"`                                                                                                                                                                                                                                           |
-| `capacity`   | uint               | The maximum number of requests allowed to reach your upstream server. The minimum capacity is `1` and the maximum capacity is `2,000,000,000`.                                                                                                                                                                                |
-| `rate`       | string             | The duration in which events may be limited based on the current capacity. This must be specified as a time duration that is a multiple of ten seconds (e.g. `"90s"`, `"10m"`). The minimum value is `"60s"` and the maximum value is `"24h"`.                                                                                                           |
-| `bucket_key` | Set<string> | The elements of this collection define the unique key of a request to collect and track the rate at which the capacity is being met. Possible values are `"domain"`, which is the Host, `"client_ip"`, and `"req.getHeader('X-example-header-name')"`, which is the value for the specified header key, if it exists. Up to ten bucket keys can be specified. |
+| Parameter    |              | Description                                                                                                                                                                                                                                                                                                                                                   |
+| ------------ | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `name`       | string            | A name for this rate limit configuration.                                                                                                                                                                                                                                                                                                                     |
+| `algorithm`  | string            | The rate limit algorithm to be used. Supported options: `"sliding_window"`                                                                                                                                                                                                                                                                                    |
+| `capacity`   | uint              | The maximum number of requests allowed to reach your upstream server. The minimum capacity is `1` and the maximum capacity is `2,000,000,000`.                                                                                                                                                                                                                |
+| `rate`       | string            | The duration in which events may be limited based on the current capacity. This must be specified as a time duration that is a multiple of ten seconds (e.g. `"90s"`, `"10m"`). The minimum value is `"60s"` and the maximum value is `"24h"`.                                                                                                                |
+| `bucket_key` | Set<string> | The elements of this collection define the unique key of a request to collect and track the rate at which the capacity is being met. Possible values are `"domain"`, which is the Host, `"client_ip"`, and `"req.getHeader('X-example-header-name')"`, which is the value for the specified header key, if it exists. Up to ten bucket keys can be specified. |

examples/actions/custom-response.mdx

@@ -1,16 +1,17 @@
-import ConfigExample from '../../src/components/ConfigExample.tsx';
+import ConfigExample from "../../src/components/ConfigExample.tsx";
 
-export const type = 'custom-response'
+export const type = "custom-response";
 export const config = {
-  status_code: 400,
-  content_type: "application/json",
-  content: JSON.stringify({
-    error: {
-      message: "Bad Request"
-    }
-  })
-}
+	status_code: 400,
+	content_type: "application/json",
+	content: JSON.stringify({
+		error: {
+			message: "Bad Request",
+		},
+	}),
+};
 
 export const ExampleHTTP = () => (
   <ConfigExample config={{ actions: [{ type, config }] }} />
-)
+
+)

examples/actions/deny.mdx

@@ -1,16 +1,16 @@
-import ConfigExample from '../../src/components/ConfigExample.tsx';
+import ConfigExample from "../../src/components/ConfigExample.tsx";
 
-export const type = 'deny'
+export const type = "deny";
 export const config = {
-  status_code: 404
-}
+	status_code: 404,
+};
 
 export const ExampleHTTP = () => (
-  <ConfigExample config={{ actions: [{ type, config }] }} />
-)
+	<ConfigExample config={{ actions: [{ type, config }] }} />
+);
 
 export const ExampleTLS = () => (
-  <ConfigExample config={{ actions: [{ type }] }} />
-)
+	<ConfigExample config={{ actions: [{ type }] }} />
+);
 
-export const ExampleTCP = ExampleTLS
+export const ExampleTCP = ExampleTLS;

examples/actions/log.mdx

@@ -1,17 +1,17 @@
-import ConfigExample from '../../src/components/ConfigExample.tsx';
+import ConfigExample from "../../src/components/ConfigExample.tsx";
 
-export const type = 'log'
+export const type = "log";
 export const config = {
-  metadata: {
-    message: "Invalid TLS Version",
-    edge_id: "edghts_2bhsN2VP8W4pTkaMSrhyj0SRf8J",
-    edge_route_id: "edghtsrt_2bhsN5u05QQ1MRrI3XbpDQMFSE7"
-  }
-}
+	metadata: {
+		message: "Invalid TLS Version",
+		edge_id: "edghts_2bhsN2VP8W4pTkaMSrhyj0SRf8J",
+		edge_route_id: "edghtsrt_2bhsN5u05QQ1MRrI3XbpDQMFSE7",
+	},
+};
 
 export const ExampleHTTP = () => (
-  <ConfigExample config={{ actions: [{ type, config }] }} />
-)
+	<ConfigExample config={{ actions: [{ type, config }] }} />
+);
 
-export const ExampleTLS = ExampleHTTP
-export const ExampleTCP = ExampleHTTP
+export const ExampleTLS = ExampleHTTP;
+export const ExampleTCP = ExampleHTTP;

examples/actions/rate-limit.mdx

@@ -1,14 +1,15 @@
-import ConfigExample from '../../src/components/ConfigExample.tsx';
+import ConfigExample from "../../src/components/ConfigExample.tsx";
 
-export const type = 'rate-limit'
+export const type = "rate-limit";
 export const config = {
-  name: "Only allow 30 requests per minute",
-  algorithm: "sliding_window",
-  capacity: 30,
-  rate: "60s",
-  bucket_key: ["req.getHeader('x-api-key')"]
-}
+	name: "Only allow 30 requests per minute",
+	algorithm: "sliding_window",
+	capacity: 30,
+	rate: "60s",
+	bucket_key: ["req.getHeader('x-api-key')"],
+};
 
 export const ExampleHTTP = () => (
   <ConfigExample config={{ actions: [{ type, config }] }} />
-)
+
+)

examples/actions/url-rewrite.mdx

@@ -1,11 +1,12 @@
-import ConfigExample from '../../src/components/ConfigExample.tsx';
+import ConfigExample from "../../src/components/ConfigExample.tsx";
 
-export const type = 'url-rewrite'
+export const type = "url-rewrite";
 export const config = {
-  from: 'v0/user/([0-9]+).*',
-  to: 'v1/user?id=$1&$args'
-}
+	from: "v0/user/([0-9]+).*",
+	to: "v1/user?id=$1&$args",
+};
 
 export const ExampleHTTP = () => (
   <ConfigExample config={{ actions: [{ type, config }] }} />
-)
+
+)

examples/agent-cli/http-traffic-policy.mdx

@@ -1,10 +1,8 @@
 ```bash
-ngrok http 80 --policy-file /path/to/policy-config.yml
+ngrok http 80 --policy-file /path/to/policy.yml
 ```
 
-```yaml
-# policy-config.yml
-
+```yaml title="policy.yml"
 inbound:
   - name: FooBarParamNotFound
     expressions:
@@ -26,7 +24,7 @@ inbound:
     actions:
       - type: deny
 outbound:
-  - name: "LogUnsuccesfulRequests"
+  - name: "LogUnsuccessfulRequests"
     actions:
       - type: log
         config:

examples/agent-cli/tcp-traffic-policy.mdx

@@ -1,10 +1,8 @@
 ```bash
-ngrok tcp 22 --policy-file /path/to/policy-config.yml
+ngrok tcp 22 --policy-file /path/to/policy.yml
 ```
 
-```yaml
-# policy-config.yml
-
+```yaml title="policy.yml"
 inbound:
   - name: "LimitToKnownIPs"
     expressions:

examples/agent-cli/tls-traffic-policy.mdx

@@ -1,10 +1,8 @@
 ```bash
-ngrok tls 80 --policy-file /path/to/policy-config.yml
+ngrok tls 80 --policy-file /path/to/policy.yml
 ```
 
-```yaml
-# policy-config.yml
-
+```yaml title="policy.yml"
 inbound:
   - name: "LimitToKnownIPs"
     expressions:

examples/go-sdk/http-traffic-policy.mdx

@@ -1,50 +1,51 @@
 ```go
 import (
-	"context"
-	"net"
+  "context"
+  "net"
 
-	"golang.ngrok.com/ngrok"
-	"golang.ngrok.com/ngrok/config"
+  "golang.ngrok.com/ngrok"
+  "golang.ngrok.com/ngrok/config"
 )
 
 func ngrokListener(ctx context.Context) (net.Listener, error) {
-	return ngrok.Listen(ctx,
-		config.HTTPEndpoint(
-			config.WithPolicy(
-				config.WithInboundRules(
-					config.WithPolicyRule(
-						config.WithPolicyName("FooBarParamNotFound"),
-						config.WithPolicyExpression("'bar' in getQueryParam('foo)"),
-						config.WithPolicyAction(
-							config.WithPolicyActionType("custom-response"),
-							config.WithPolicyActionConfig(`{"status_code":404,"content_type":"text/plain","content":"not found"}`),
-						),
-					),
-					config.WithPolicyRule(
-						config.WithPolicyName("BazCookieForLargeRequests"),
-						config.WithPolicyExpression("!hasReqCookie('baz')"),
-						config.WithPolicyExpression("req.ContentLength > 5000"),
-						config.WithPolicyAction(
-							config.WithPolicyActionType("deny"),
-						),
-					),
-				),
-				config.WithOutboundRules(
-					config.WithPolicyRule(
-						config.WithPolicyName("LogUnsuccessfulRequests"),
-						config.WithPolicyExpression("res.StatusCode < '200' && res.StatusCode >= '300'"),
-						config.WithPolicyAction(
-							config.WithPolicyActionType("log"),
-							config.WithPolicyActionConfig(`{"metadata":{"hostport":"example.com:443","success":false}}`),
-						),
-					),
-				),
-			),
-		),
-		ngrok.WithAuthtokenFromEnv(),
-	)
+  return ngrok.Listen(ctx,
+    config.HTTPEndpoint(
+      config.WithPolicy(
+        config.WithInboundRules(
+          config.WithPolicyRule(
+            config.WithPolicyName("FooBarParamNotFound"),
+            config.WithPolicyExpression("'bar' in getQueryParam('foo)"),
+            config.WithPolicyAction(
+              config.WithPolicyActionType("custom-response"),
+              config.WithPolicyActionConfig(`{"status_code":404,"content_type":"text/plain","content":"not found"}`),
+            ),
+          ),
+          config.WithPolicyRule(
+            config.WithPolicyName("BazCookieForLargeRequests"),
+            config.WithPolicyExpression("!hasReqCookie('baz')"),
+            config.WithPolicyExpression("req.ContentLength > 5000"),
+            config.WithPolicyAction(
+              config.WithPolicyActionType("deny"),
+            ),
+          ),
+        ),
+        config.WithOutboundRules(
+          config.WithPolicyRule(
+            config.WithPolicyName("LogUnsuccessfulRequests"),
+            config.WithPolicyExpression("res.StatusCode < '200' && res.StatusCode >= '300'"),
+            config.WithPolicyAction(
+              config.WithPolicyActionType("log"),
+              config.WithPolicyActionConfig(`{"metadata":{"hostport":"example.com:443","success":false}}`),
+            ),
+          ),
+        ),
+      ),
+    ),
+    ngrok.WithAuthtokenFromEnv(),
+  )
 }
 ```
+
 Go Package Docs:
 
-- [https://pkg.go.dev/golang.ngrok.com/ngrok/config#WithPolicy](https://pkg.go.dev/golang.ngrok.com/ngrok/config#WithPolicy)
+- [https://pkg.go.dev/golang.ngrok.com/ngrok/config#WithPolicy](https://pkg.go.dev/golang.ngrok.com/ngrok/config#WithPolicy)

examples/go-sdk/tcp-traffic-policy.mdx

@@ -1,32 +1,33 @@
 ```go
 import (
-	"context"
-	"net"
+  "context"
+  "net"
 
-	"golang.ngrok.com/ngrok"
-	"golang.ngrok.com/ngrok/config"
+  "golang.ngrok.com/ngrok"
+  "golang.ngrok.com/ngrok/config"
 )
 
 func ngrokListener(ctx context.Context) (net.Listener, error) {
-	return ngrok.Listen(ctx,
-		config.TCPEndpoint(
-			config.WithPolicy(
-				config.WithInboundRules(
-					config.WithPolicyRule(
-						config.WithPolicyName("LimitToKnownIPs"),
-						config.WithPolicyExpression("conn.ClientIP != 8.8.8.8"),
-						config.WithPolicyExpression("conn.ClientIP != 9.9.9.9"),
-						config.WithPolicyAction(
-							config.WithPolicyActionType("deny"),
-						),
-					),
-				),
-			),
-		),
-		ngrok.WithAuthtokenFromEnv(),
-	)
+  return ngrok.Listen(ctx,
+    config.TCPEndpoint(
+      config.WithPolicy(
+        config.WithInboundRules(
+          config.WithPolicyRule(
+            config.WithPolicyName("LimitToKnownIPs"),
+            config.WithPolicyExpression("conn.ClientIP != 8.8.8.8"),
+            config.WithPolicyExpression("conn.ClientIP != 9.9.9.9"),
+            config.WithPolicyAction(
+              config.WithPolicyActionType("deny"),
+            ),
+          ),
+        ),
+      ),
+    ),
+    ngrok.WithAuthtokenFromEnv(),
+  )
 }
 ```
+
 Go Package Docs:
 
-- [https://pkg.go.dev/golang.ngrok.com/ngrok/config#WithPolicy](https://pkg.go.dev/golang.ngrok.com/ngrok/config#WithPolicy)
+- [https://pkg.go.dev/golang.ngrok.com/ngrok/config#WithPolicy](https://pkg.go.dev/golang.ngrok.com/ngrok/config#WithPolicy)