neverbounce-cli 1.0.0

data/spec/lib/never_bounce/cli/script/jobs_create_spec.rb

@@ -0,0 +1,118 @@
+
+module NeverBounce; module CLI; module Script
+  describe JobsCreate do
+    include_dir_context __dir__
+
+    def margv(*args)
+      ["API_KEY=abc"] + args
+    end
+
+    it_behaves_like "instantiatable"
+    it_behaves_like "a script supporting `--help`", signatures: [/nb-jobs-create/, /AUTO_PARSE/, /AUTO_START/, /FILENAME/, /REMOTE_INPUT/, /RUN_SAMPLE/, /SUPPLIED_INPUT/]
+
+    describe "mode attributes" do
+      describe "#auto_parse" do
+        let(:m) { :auto_parse }
+        it "generally works" do
+          expect(newo(env: {}).send(m)).to be nil
+          expect(newo(env: {"AUTO_PARSE" => "y"}).send(m)).to be true
+          expect(newo(env: {"AUTO_PARSE" => "n"}).send(m)).to be false
+        end
+      end
+
+      describe "#auto_start" do
+        let(:m) { :auto_start }
+        it "generally works" do
+          expect(newo(env: {}).send(m)).to be nil
+          expect(newo(env: {"AUTO_START" => "y"}).send(m)).to be true
+          expect(newo(env: {"AUTO_START" => "n"}).send(m)).to be false
+        end
+      end
+
+      describe "#run_sample" do
+        it "generally works" do
+          expect(newo(env: {}).run_sample).to be nil
+          expect(newo(env: {"RUN_SAMPLE" => "y"}).run_sample).to be true
+          expect(newo(env: {"RUN_SAMPLE" => "n"}).run_sample).to be false
+        end
+      end
+    end # describe "mode attributes"
+
+    describe "#input_location" do
+      let(:m) { :input_location }
+      it "generally works" do
+        r = newo(env: {})
+        expect { r.send(m) }.to raise_error(UsageError, "Input not given, use `REMOTE_INPUT=` or `SUPPLIED_INPUT=`")
+        r = newo(env: {"REMOTE_INPUT" => "remote_input"})
+        expect(r.send(m)).to eq "remote_url"
+        r = newo(env: {"SUPPLIED_INPUT" => "supplied_input"})
+        expect(r.send(m)).to eq "supplied"
+        r = newo(env: {"REMOTE_INPUT" => "remote_input", "SUPPLIED_INPUT" => "supplied_input"})
+        expect { r.send(m) }.to raise_error(UsageError, "`REMOTE_INPUT` and `SUPPLIED_INPUT` can't both be given")
+      end
+    end
+
+    describe "attributes" do
+      describe "#filename" do
+        it "has a time-based default value" do
+          r = newo(now: Time.new(2017, 12, 18, 11, 22, 33))
+          expect(r.filename).to eq "20171218-112233.csv"
+        end
+
+        it "generally works" do
+          r = newo(env: {"FILENAME" => "abc"})
+          expect(r.filename).to eq "abc"
+        end
+      end
+
+      describe "#remote_input" do
+        it "generally works" do
+          expect(newo(env: {}).remote_input).to be nil
+          expect(newo(env: {"REMOTE_INPUT" => "remote_input"}).remote_input).to eq "remote_input"
+        end
+      end
+    end # describe "attributes"
+
+    describe "#request_curl" do
+      context "when remote input" do
+        it "generally works" do
+          r = goodo(argv: margv(
+            "AUTO_PARSE=y",
+            "AUTO_START=y",
+            "FILENAME=filename",
+            "REMOTE_INPUT=remote_input",
+            "RUN_SAMPLE=y",
+          ))
+          expect(r.request_curl).to eq ["--request", "POST", "--url", "https://api.neverbounce.com/v4/jobs/create", "--header", "Content-Type: application/json", "--data-binary", "{\"input\":\"remote_input\",\"input_location\":\"remote_url\",\"filename\":\"filename\",\"key\":\"abc\",\"auto_start\":true,\"auto_parse\":true,\"run_sample\":true}"]
+        end
+      end
+
+      context "when supplied input" do
+        it "generally works" do
+          r = goodo(argv: margv(
+            "AUTO_PARSE=y",
+            "AUTO_START=y",
+            "FILENAME=filename",
+            "RUN_SAMPLE=y",
+            "SUPPLIED_INPUT=alice@isp.com;bob.smith@gmail.com",
+          ))
+          expect(r.request_curl).to eq ["--request", "POST", "--url", "https://api.neverbounce.com/v4/jobs/create", "--header", "Content-Type: application/json", "--data-binary", "{\"input\":[[\"alice@isp.com\",\"\"],[\"bob.smith@gmail.com\",\"\"]],\"input_location\":\"supplied\",\"filename\":\"filename\",\"key\":\"abc\",\"auto_start\":true,\"auto_parse\":true,\"run_sample\":true}"]
+        end
+      end
+    end
+
+    describe "output" do
+      it "generally works" do
+        r = goodo(argv: margv("SUPPLIED_INPUT=alice@isp.com")).tap do |_|
+          _.session.server_content_type = "application/json"
+          _.session.server_raw = '{"status":"success","job_id":348530,"execution_time":602}'
+        end
+        expect { r.main }.not_to raise_error
+        lines = r.stdout.tap(&:rewind).to_a
+        expect(lines).to be_any { |s| s =~ /Response:/ }
+        expect(lines).to be_any { |s| s =~ cell("JobId") }
+        expect(lines).to be_any { |s| s =~ cell("ExecTime") }
+      end
+    end
+  end
+end; end; end

data/spec/lib/never_bounce/cli/script/jobs_delete_spec.rb

@@ -0,0 +1,33 @@
+
+module NeverBounce; module CLI; module Script
+  describe JobsDelete do
+    include_dir_context __dir__
+
+    def margv(*args)
+      ["API_KEY=abc", "ID=12"] + args
+    end
+
+    it_behaves_like "instantiatable"
+    it_behaves_like "a script supporting `--help`", signatures: [/nb-jobs-delete/, /ID/]
+
+    describe "#request_curl" do
+      it "generally works" do
+        r = goodo(argv: margv)
+        expect(r.request_curl).to eq ["--request", "POST", "--url", "https://api.neverbounce.com/v4/jobs/delete", "--header", "Content-Type: application/json", "--data-binary", "{\"job_id\":\"12\",\"key\":\"abc\"}"]
+      end
+    end
+
+    describe "output" do
+      it "generally works" do
+        r = goodo(argv: margv).tap do |_|
+          _.session.server_content_type = "application/json"
+          _.session.server_raw = '{"status":"success","execution_time":66}'
+        end
+        expect { r.main }.not_to raise_error
+        lines = r.stdout.tap(&:rewind).to_a
+        expect(lines).to be_any { |s| s =~ /Response:/ }
+        expect(lines).to be_any { |s| s =~ cell("ExecTime") }
+      end
+    end
+  end
+end; end; end

data/spec/lib/never_bounce/cli/script/jobs_download_spec.rb

@@ -0,0 +1,37 @@
+
+module NeverBounce; module CLI; module Script
+  describe JobsDownload do
+    include_dir_context __dir__
+
+    def margv(*args)
+      ["API_KEY=abc", "ID=12"] + args
+    end
+
+    it_behaves_like "instantiatable"
+    it_behaves_like "a script supporting `--help`", signatures: [/nb-jobs-download/, /ID/]
+
+    describe "#request_curl" do
+      it "generally works" do
+        r = goodo(argv: margv)
+        expect(r.request_curl).to eq ["--request", "GET", "--url", "https://api.neverbounce.com/v4/jobs/download", "--header", "Content-Type: application/json", "--data-binary", "{\"job_id\":\"12\",\"key\":\"abc\"}"]
+      end
+    end
+
+    describe "output" do
+      it "generally works" do
+        r = goodo(argv: margv).tap do |_|
+          # NOTE: Raw content is actually multiline.
+          _.session.server_content_type = "application/octet-stream"
+          _.session.server_raw = 'id,email,name,email_status
+  "12345","support@neverbounce.com","Fred McValid",valid
+  "12346","invalid@neverbounce.com","Bob McInvalid",invalid'
+        end
+        expect { r.main }.not_to raise_error
+        lines = r.stdout.tap(&:rewind).to_a
+        expect(lines).to be_any { |s| s =~ /id,email,name,email_status/ }
+        expect(lines).to be_any { |s| s =~ /"Fred McValid"/ }
+        expect(lines).to be_any { |s| s =~ /"Bob McInvalid"/ }
+      end
+    end
+  end
+end; end; end

data/spec/lib/never_bounce/cli/script/jobs_parse_spec.rb

@@ -0,0 +1,45 @@
+
+module NeverBounce; module CLI; module Script
+  describe JobsParse do
+    include_dir_context __dir__
+
+    def margv(*args)
+      ["API_KEY=abc", "ID=12"] + args
+    end
+
+    it_behaves_like "instantiatable"
+    it_behaves_like "a script supporting `--help`", signatures: [/nb-jobs-parse/, /ID/, /AUTO_START/]
+
+    describe "mode attributes" do
+      describe "#auto_start" do
+        let(:m) { :auto_start }
+        it "generally works" do
+          expect(newo(env: {}).send(m)).to be nil
+          expect(newo(env: {"AUTO_START" => "y"}).send(m)).to be true
+          expect(newo(env: {"AUTO_START" => "n"}).send(m)).to be false
+        end
+      end
+    end
+
+    describe "#request_curl" do
+      it "generally works" do
+        r = goodo(argv: margv("AUTO_START=y"))
+        expect(r.request_curl).to eq ["--request", "POST", "--url", "https://api.neverbounce.com/v4/jobs/parse", "--header", "Content-Type: application/json", "--data-binary", "{\"job_id\":\"12\",\"key\":\"abc\",\"auto_start\":true}"]
+      end
+    end
+
+    describe "output" do
+      it "generally works" do
+        r = goodo(argv: margv).tap do |_|
+          _.session.server_content_type = "application/json"
+          _.session.server_raw = '{"status":"success","queue_id":"NB-PQ-598B5ED572898","execution_time":25}'
+        end
+        expect { r.main }.not_to raise_error
+        lines = r.stdout.tap(&:rewind).to_a
+        expect(lines).to be_any { |s| s =~ /Response:/ }
+        expect(lines).to be_any { |s| s =~ cell("QueueId") }
+        expect(lines).to be_any { |s| s =~ cell("ExecTime") }
+      end
+    end
+  end
+end; end; end

data/spec/lib/never_bounce/cli/script/jobs_results_spec.rb

@@ -0,0 +1,40 @@
+
+module NeverBounce; module CLI; module Script
+  describe JobsResults do
+    include_dir_context __dir__
+
+    def margv(*args)
+      ["API_KEY=abc", "ID=12"] + args
+    end
+
+    it_behaves_like "instantiatable"
+    it_behaves_like "a script supporting `--help`", signatures: [/nb-jobs-results/, /PAGE/, /PER_PAGE/]
+
+    describe "#request_curl" do
+      it "generally works" do
+        r = goodo(argv: margv)
+        expect(r.request_curl).to eq ["--request", "GET", "--url", "https://api.neverbounce.com/v4/jobs/results", "--header", "Content-Type: application/json", "--data-binary", "{\"job_id\":\"12\",\"key\":\"abc\",\"items_per_page\":1000,\"page\":1}"]
+      end
+    end
+
+    describe "output" do
+      it "generally works" do
+        r = goodo(argv: margv).tap do |_|
+          _.session.server_content_type = "application/json"
+          _.session.server_raw = '{"status":"success","total_results":3,"total_pages":1,"query":{"job_id":274226,"valids":1,"invalids":1,"disposables":1,"catchalls":1,"unknowns":1,"page":1,"items_per_page":1000},"results":[{"data":{"email":"email","id":"id","name":"name"},"verification":{"result":"invalid","flags":[],"suggested_correction":"","address_info":{"original_email":"email","normalized_email":"","addr":"","alias":"","host":"","fqdn":"","domain":"","subdomain":"","tld":""}}},{"data":{"email":"support@neverbounce.com","id":"12345","name":"Fred McValid"},"verification":{"result":"valid","flags":["has_dns","has_dns_mx","role_account","smtp_connectable"],"suggested_correction":"","address_info":{"original_email":"support@neverbounce.com","normalized_email":"support@neverbounce.com","addr":"support","alias":"","host":"neverbounce.com","fqdn":"neverbounce.com","domain":"neverbounce","subdomain":"","tld":"com"}}},{"data":{"email":"invalid@neverbounce.com","id":"12346","name":"Bob McInvalid"},"verification":{"result":"invalid","flags":["has_dns","has_dns_mx","smtp_connectable"],"suggested_correction":"","address_info":{"original_email":"invalid@neverbounce.com","normalized_email":"invalid@neverbounce.com","addr":"invalid","alias":"","host":"neverbounce.com","fqdn":"neverbounce.com","domain":"neverbounce","subdomain":"","tld":"com"}}}],"execution_time":53}'
+        end
+        expect { r.main }.not_to raise_error
+        lines = r.stdout.tap(&:rewind).to_a
+        expect(lines).to be_any { |s| s =~ /Response:/ }
+        expect(lines).to be_any { |s| s =~ cell("nPages") }
+        expect(lines).to be_any { |s| s =~ cell("ExecTime") }
+        expect(lines).to be_any { |s| s =~ /Query:/ }
+        expect(lines).to be_any { |s| s =~ cell("JobId") }
+        expect(lines).to be_any { |s| s =~ cell("PerPage") }
+        expect(lines).to be_any { |s| s =~ /Results:/ }
+        expect(lines).to be_any { |s| s =~ cell("Email") }
+        expect(lines).to be_any { |s| s =~ cell("SuggCorr") }
+      end
+    end
+  end
+end; end; end

data/spec/lib/never_bounce/cli/script/jobs_search_spec.rb

@@ -0,0 +1,59 @@
+
+module NeverBounce; module CLI; module Script
+  describe JobsSearch do
+    include_dir_context __dir__
+
+    def margv(*args)
+      ["API_KEY=abc"] + args
+    end
+
+    it_behaves_like "instantiatable"
+    it_behaves_like "a script supporting `--help`", signatures: [/nb-jobs-search/, /PAGE/]
+
+    describe "mode attributes" do
+      describe "#job_id" do
+        let(:m) { :job_id }
+        it "generally works" do
+          expect(newo(env: {}).send(m)).to be nil
+          expect(newo(env: {"ID" => "abc"}).send(m)).to eq "abc"
+          expect(newo(env: {"ID" => "12"}).send(m)).to eq "12"
+        end
+      end
+    end
+
+    describe "#request_curl" do
+      it "generally works" do
+        r = goodo(argv: margv(
+          "ID=abc",
+          "PAGE=12",
+          "PER_PAGE=34",
+        ))
+        expect(r.job_id).to eq "abc"
+        expect(r.page).to eq 12
+        expect(r.per_page).to eq 34
+        expect(r.request_curl).to eq ["--request", "GET", "--url", "https://api.neverbounce.com/v4/jobs/search", "--header", "Content-Type: application/json", "--data-binary", "{\"key\":\"abc\",\"job_id\":\"abc\",\"page\":12,\"items_per_page\":34}"]
+      end
+    end
+
+    describe "output" do
+      it "generally works" do
+        r = goodo(argv: margv).tap do |_|
+          _.session.server_content_type = "application/json"
+          _.session.server_raw = '{"status":"success","total_results":5,"total_pages":1,"query":{"page":1,"items_per_page":1000},"results":[{"id":276816,"job_status":"failed","filename":"","created_at":"2017-07-25 09:04:10","started_at":null,"finished_at":null,"total":{"records":0,"billable":0,"processed":null,"valid":null,"invalid":0,"catchall":null,"disposable":null,"unknown":null,"duplicates":null,"bad_syntax":null},"bounce_estimate":-1,"percent_complete":0},{"id":276760,"job_status":"failed","filename":"","created_at":"2017-07-25 08:31:16","started_at":null,"finished_at":null,"total":{"records":0,"billable":0,"processed":null,"valid":null,"invalid":0,"catchall":null,"disposable":null,"unknown":null,"duplicates":null,"bad_syntax":null},"bounce_estimate":-1,"percent_complete":0},{"id":276743,"job_status":"queued","filename":"","created_at":"2017-07-25 08:06:38","started_at":null,"finished_at":null,"total":{"records":0,"billable":0,"processed":0,"valid":0,"invalid":0,"catchall":0,"disposable":0,"unknown":0,"duplicates":0,"bad_syntax":0},"bounce_estimate":-1,"percent_complete":0},{"id":276736,"job_status":"queued","filename":"","created_at":"2017-07-25 07:54:29","started_at":null,"finished_at":null,"total":{"records":0,"billable":0,"processed":0,"valid":0,"invalid":0,"catchall":0,"disposable":0,"unknown":0,"duplicates":0,"bad_syntax":0},"bounce_estimate":-1,"percent_complete":0},{"id":274226,"job_status":"complete","filename":"Created from Array.csv","created_at":"2017-07-21 17:33:45","started_at":"2017-07-21 17:33:46","finished_at":"2017-07-21 17:33:47","total":{"records":3,"billable":2,"processed":3,"valid":1,"invalid":2,"catchall":0,"disposable":0,"unknown":0,"duplicates":0,"bad_syntax":1},"bounce_estimate":0,"percent_complete":100}],"execution_time":402}'
+        end
+        expect { r.main }.not_to raise_error
+        lines = r.stdout.tap(&:rewind).to_a
+        expect(lines).to be_any { |s| s =~ /Response:/ }
+        expect(lines).to be_any { |s| s =~ cell("ExecTime") }
+        expect(lines).to be_any { |s| s =~ /Query:/ }
+        expect(lines).to be_any { |s| s =~ cell("Page") }
+        expect(lines).to be_any { |s| s =~ cell("PerPage") }
+        expect(lines).to be_any { |s| s =~ /Results:/ }
+        expect(lines).to be_any { |s| s =~ cell("ID") }
+        expect(lines).to be_any { |s| s =~ cell("JobStatus") }
+        expect(lines).to be_any { |s| s =~ cell("Filename") }
+        expect(lines).to be_any { |s| s =~ cell("Total") }
+      end
+    end
+  end
+end; end; end

data/spec/lib/never_bounce/cli/script/jobs_start_spec.rb

@@ -0,0 +1,45 @@
+
+module NeverBounce; module CLI; module Script
+  describe JobsStart do
+    include_dir_context __dir__
+
+    def margv(*args)
+      ["API_KEY=abc", "ID=12"] + args
+    end
+
+    it_behaves_like "instantiatable"
+    it_behaves_like "a script supporting `--help`", signatures: [/nb-jobs-start/, /ID/, /RUN_SAMPLE/]
+
+    describe "mode attributes" do
+      describe "#run_sample" do
+        let(:m) { :run_sample }
+        it "generally works" do
+          expect(newo(env: {}).send(m)).to be nil
+          expect(newo(env: {"RUN_SAMPLE" => "y"}).send(m)).to be true
+          expect(newo(env: {"RUN_SAMPLE" => "n"}).send(m)).to be false
+        end
+      end
+    end
+
+    describe "#request_curl" do
+      it "generally works" do
+        r = goodo(argv: margv("RUN_SAMPLE=y"))
+        expect(r.request_curl).to eq ["--request", "POST", "--url", "https://api.neverbounce.com/v4/jobs/start", "--header", "Content-Type: application/json", "--data-binary", "{\"job_id\":\"12\",\"key\":\"abc\",\"run_sample\":true}"]
+      end
+    end
+
+    describe "output" do
+      it "generally works" do
+        r = goodo(argv: margv).tap do |_|
+          _.session.server_content_type = "application/json"
+          _.session.server_raw = '{"status":"success","queue_id":"NB-PQ-598B5ED572898","execution_time":25}'
+        end
+        expect { r.main }.not_to raise_error
+        lines = r.stdout.tap(&:rewind).to_a
+        expect(lines).to be_any { |s| s =~ /Response:/ }
+        expect(lines).to be_any { |s| s =~ cell("QueueId") }
+        expect(lines).to be_any { |s| s =~ cell("ExecTime") }
+      end
+    end
+  end
+end; end; end

data/spec/lib/never_bounce/cli/script/jobs_status_spec.rb

@@ -0,0 +1,37 @@
+
+module NeverBounce; module CLI; module Script
+  describe JobsStatus do
+    include_dir_context __dir__
+
+    def margv(*args)
+      ["API_KEY=abc", "ID=12"] + args
+    end
+
+    it_behaves_like "instantiatable"
+    it_behaves_like "a script supporting `--help`", signatures: [/nb-jobs-status/]
+
+    describe "#request_curl" do
+      it "generally works" do
+        r = goodo(argv: margv)
+        expect(r.request_curl).to eq ["--request", "GET", "--url", "https://api.neverbounce.com/v4/jobs/status", "--header", "Content-Type: application/json", "--data-binary", "{\"job_id\":\"12\",\"key\":\"abc\"}"]
+      end
+    end
+
+    describe "output" do
+      it "generally works" do
+        r = goodo(argv: margv).tap do |_|
+          _.session.server_content_type = "application/json"
+          _.session.server_raw = '{"status":"success","id":274226,"job_status":"complete","filename":"Created from Array.csv","created_at":"2017-07-21 17:33:45","started_at":"2017-07-21 17:33:46","finished_at":"2017-07-21 17:33:47","total":{"records":3,"billable":2,"processed":3,"valid":1,"invalid":2,"catchall":0,"disposable":0,"unknown":0,"duplicates":0,"bad_syntax":1},"bounce_estimate":0,"percent_complete":100,"execution_time":7}'
+        end
+        expect { r.main }.not_to raise_error
+        lines = r.stdout.tap(&:rewind).to_a
+        expect(lines).to be_any { |s| s =~ /^Response:$/ }
+        expect(lines).to be_any { |s| s =~ cell("ID") }
+        expect(lines).to be_any { |s| s =~ cell("ExecTime") }
+        expect(lines).to be_any { |s| s =~ /^Total:$/ }
+        expect(lines).to be_any { |s| s =~ cell("BadSyntax") }
+        expect(lines).to be_any { |s| s =~ cell("Valid") }
+      end
+    end
+  end
+end; end; end

data/spec/lib/never_bounce/cli/script/manifest_spec.rb

@@ -0,0 +1,6 @@
+
+describe NeverBounce::CLI::Script::Manifest do
+  include_dir_context __dir__
+
+  it_behaves_like "instantiatable"
+end

data/spec/lib/never_bounce/cli/script/meaningful_spec.rb

@@ -0,0 +1,93 @@
+
+describe NeverBounce::CLI::Script::Meaningful do
+  include_dir_context __dir__
+
+  it_behaves_like "instantiatable"
+
+  describe "command-line options" do
+    it "generally works" do
+      r = goodo(
+        argv: ["A=1", "B=2  3", "C== hey\nthere ="],
+        env: {},
+      )
+      expect { r.options }.not_to raise_error
+      expect(r.env).to eq({"A" => "1", "B" => "2  3", "C" => "= hey\nthere ="})
+    end
+  end
+
+  describe "successor class" do
+    # Generic successor class.
+    # Hack: We define it in both scopes to be able to use shared examples.
+    the_klass = Class.new(described_class) do
+      envar "AA", "No examples"
+      envar "AB", "Some examples", ["a", "b"]
+      envar "AC", "Examples with a default", ["a", {default: "B"}, "c"]
+      envar "AD", "Numeric examples with a default", [1, default: 10]
+      envar "BA*", "Mandatory. No examples"
+      envar "BB*", "Mandatory. Some examples", ["a", "b"]
+      envar "CAaaaaaa", "Longer name"
+
+      def manifest
+        @manifest ||= Class.new do
+          def cmdline
+            "[some_options]"
+          end
+
+          def function
+            "some function"
+          end
+
+          def name
+            "some-name"
+          end
+        end.new
+      end
+
+      def slim_main
+        stdout.puts "I'm slim_main"
+        12
+      end
+    end
+
+    let(:klass) do
+      # Copy local scope variable to example scope.
+      the_klass
+    end
+
+    def newo(attrs = {})
+      klass.new(attrs)
+    end
+
+    it_behaves_like "a script supporting `--help`", klass: the_klass, signatures: [/some-name/, /some_options/]
+
+    describe "usage text" do
+      describe "#banner_text" do
+        it "generally works" do
+          expect(newo.banner_text).to eq "some-name - some function"
+        end
+      end
+
+      describe "#envar_text" do
+        it "generally works" do
+          expect(newo.envar_text).to eq "* BA       - Mandatory. No examples\n* BB       - Mandatory. Some examples (\"a\", \"b\")\n- AA       - No examples\n- AB       - Some examples (\"a\", \"b\")\n- AC       - Examples with a default (\"a\", [\"B\"], \"c\")\n- AD       - Numeric examples with a default (1, [10])\n- CAaaaaaa - Longer name"
+        end
+      end
+
+      describe "#help_text" do
+        it "generally works" do
+          r = newo
+          expect(r.help_text).to match /\bsome-name\b/
+          expect(r.help_text).to match /\bUSAGE:\s/
+          expect(r.help_text).to match /\bEnvironment variables:\s/
+        end
+      end
+    end # describe "usage text"
+
+    it "generally works" do
+      r = newo(argv: [], env: {}, stdout: StringIO.new)
+      expect(r.main).to eq 12
+      lines = r.stdout.tap(&:rewind).to_a
+      expect(lines).to eq ["I'm slim_main\n"]
+    end
+  end # successor class
+end