From a10027da1c972056f6bdd6ae1347b18e374c2d4b Mon Sep 17 00:00:00 2001
From: Ludovic Fernandez <ldez@users.noreply.github.com>
Date: Sun, 12 Jan 2020 16:51:14 +0100
Subject: [PATCH] namecheap: add sandbox support. (#1041)

---
 cmd/zz_gen_cmd_dnshelp.go              |  1 +
 docs/content/dns/zz_gen_namecheap.md   | 11 ++++++++---
 providers/dns/namecheap/namecheap.go   |  8 +++++++-
 providers/dns/namecheap/namecheap.toml |  7 ++++++-
 4 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/cmd/zz_gen_cmd_dnshelp.go b/cmd/zz_gen_cmd_dnshelp.go
index 430ca0f1..ee2531b0 100644
--- a/cmd/zz_gen_cmd_dnshelp.go
+++ b/cmd/zz_gen_cmd_dnshelp.go
@@ -946,6 +946,7 @@ func displayDNSHelp(name string) error {
 		ew.writeln(`	- "NAMECHEAP_HTTP_TIMEOUT":	API request timeout`)
 		ew.writeln(`	- "NAMECHEAP_POLLING_INTERVAL":	Time between DNS propagation check`)
 		ew.writeln(`	- "NAMECHEAP_PROPAGATION_TIMEOUT":	Maximum waiting time for DNS propagation`)
+		ew.writeln(`	- "NAMECHEAP_SANDBOX":	Activate the sandbox (boolean)`)
 		ew.writeln(`	- "NAMECHEAP_TTL":	The TTL of the TXT record used for the DNS challenge`)
 
 		ew.writeln()
diff --git a/docs/content/dns/zz_gen_namecheap.md b/docs/content/dns/zz_gen_namecheap.md
index 67c076b8..0dff026f 100644
--- a/docs/content/dns/zz_gen_namecheap.md
+++ b/docs/content/dns/zz_gen_namecheap.md
@@ -18,9 +18,13 @@ Configuration for [Namecheap](https://www.namecheap.com).
 
 - Code: `namecheap`
 
-{{% notice note %}}
-_Please contribute by adding a CLI example._
-{{% /notice %}}
+Here is an example bash command using the Namecheap provider:
+
+```bash
+NAMECHEAP_API_USER=user \
+NAMECHEAP_API_KEY=key \
+lego --dns namecheap --email someaccount@email.com --domains "foo.email.com" run
+```
 
 
 
@@ -43,6 +47,7 @@ More information [here](/lego/dns/#configuration-and-credentials).
 | `NAMECHEAP_HTTP_TIMEOUT` | API request timeout |
 | `NAMECHEAP_POLLING_INTERVAL` | Time between DNS propagation check |
 | `NAMECHEAP_PROPAGATION_TIMEOUT` | Maximum waiting time for DNS propagation |
+| `NAMECHEAP_SANDBOX` | Activate the sandbox (boolean) |
 | `NAMECHEAP_TTL` | The TTL of the TXT record used for the DNS challenge |
 
 The environment variable names can be suffixed by `_FILE` to reference a file instead of a value.
diff --git a/providers/dns/namecheap/namecheap.go b/providers/dns/namecheap/namecheap.go
index 3fb71c2d..3a5a4ad6 100644
--- a/providers/dns/namecheap/namecheap.go
+++ b/providers/dns/namecheap/namecheap.go
@@ -30,6 +30,7 @@ import (
 
 const (
 	defaultBaseURL = "https://api.namecheap.com/xml.response"
+	sandboxBaseURL = "https://api.sandbox.namecheap.com/xml.response"
 	getIPURL       = "https://dynamicdns.park-your-domain.com/getip"
 )
 
@@ -60,8 +61,13 @@ type Config struct {
 
 // NewDefaultConfig returns a default configuration for the DNSProvider
 func NewDefaultConfig() *Config {
+	baseURL := defaultBaseURL
+	if env.GetOrDefaultBool("NAMECHEAP_SANDBOX", false) {
+		baseURL = sandboxBaseURL
+	}
+
 	return &Config{
-		BaseURL:            defaultBaseURL,
+		BaseURL:            baseURL,
 		Debug:              env.GetOrDefaultBool("NAMECHEAP_DEBUG", false),
 		TTL:                env.GetOrDefaultInt("NAMECHEAP_TTL", dns01.DefaultTTL),
 		PropagationTimeout: env.GetOrDefaultSecond("NAMECHEAP_PROPAGATION_TIMEOUT", 60*time.Minute),
diff --git a/providers/dns/namecheap/namecheap.toml b/providers/dns/namecheap/namecheap.toml
index bb4fa8b9..a5e7b00c 100644
--- a/providers/dns/namecheap/namecheap.toml
+++ b/providers/dns/namecheap/namecheap.toml
@@ -4,7 +4,11 @@ URL = "https://www.namecheap.com"
 Code = "namecheap"
 Since = "v0.3.0"
 
-Example = ''''''
+Example = '''
+NAMECHEAP_API_USER=user \
+NAMECHEAP_API_KEY=key \
+lego --dns namecheap --email someaccount@email.com --domains "foo.email.com" run
+'''
 
 [Configuration]
   [Configuration.Credentials]
@@ -15,6 +19,7 @@ Example = ''''''
     NAMECHEAP_PROPAGATION_TIMEOUT = "Maximum waiting time for DNS propagation"
     NAMECHEAP_TTL = "The TTL of the TXT record used for the DNS challenge"
     NAMECHEAP_HTTP_TIMEOUT = "API request timeout"
+    NAMECHEAP_SANDBOX = "Activate the sandbox (boolean)"
 
 [Links]
   API = "https://www.namecheap.com/support/api/methods.aspx"