lumberg 1.0.1 → 2.0.1

data/spec/cpanel/ftp_spec.rb

@@ -0,0 +1,71 @@
+require "spec_helper"
+
+module Lumberg
+  describe Cpanel::Ftp do
+    let(:server) { Whm::Server.new(host: @whm_host, hash: @whm_hash) }
+    let(:api_username) { "lumberg" }
+
+    let(:ftp) do
+      described_class.new(
+        server:       server,
+        api_username: api_username
+      )
+    end
+
+    describe "#list_ftp" do
+      use_vcr_cassette("cpanel/ftp/listftp")
+
+      it "lists ftp accounts associated to the account" do
+        ftp.list_ftp[:params][:data][0][:user].should eq("hello")
+      end
+    end
+
+    describe "#list_ftp_sessions" do
+      use_vcr_cassette("cpanel/ftp/listftpsessions")
+
+      it "lists ftp sessions associated to the account" do
+        ftp.list_ftp_sessions[:params][:data][0][:status].should eq("IDLE")
+      end
+    end
+
+    describe "#list_ftp_with_disk" do
+      use_vcr_cassette("cpanel/ftp/listftpwithdisk")
+
+      it "lists ftp accounts with disk information" do
+        ftp.list_ftp_with_disk[:params][:data][0][:_diskused].should eq("0")
+      end
+    end
+
+    describe "#add_ftp" do
+      use_vcr_cassette("cpanel/ftp/addftp")
+
+      it "creates the account" do
+        ftp.add_ftp(user: 'bob', pass: 'boo')[:params][:data][0][:reason].should eq("OK")
+      end
+    end
+
+    describe "#passwd" do
+      use_vcr_cassette("cpanel/ftp/passwd")
+
+      it "changes the password of the account" do
+        ftp.passwd(user: 'bob', pass: 'boo')[:params][:data][0][:reason].should eq("OK")
+      end
+    end
+
+    describe "#setquota" do
+      use_vcr_cassette("cpanel/ftp/setquota")
+
+      it "sets a quota for the account" do
+        ftp.set_quota(user: 'bob', quota: '100')[:params][:data][0][:reason].should eq("OK")
+      end
+    end
+
+    describe "#del_ftp" do
+      use_vcr_cassette("cpanel/ftp/delftp")
+
+      it "removes the account" do
+        ftp.del_ftp(user: 'bob', destroy: '1')[:params][:data][0][:reason].should eq("OK")
+      end
+    end
+  end
+end

data/spec/cpanel/gpg_spec.rb

@@ -0,0 +1,48 @@
+require "spec_helper"
+
+module Lumberg
+  describe Cpanel::Gpg do
+    let(:server) { Whm::Server.new(host: @whm_host, hash: @whm_hash) }
+    let(:api_username) { "lumberg" }
+    let(:gpg) do
+      described_class.new(
+        server:       server,
+        api_username: api_username
+      )
+    end
+
+    describe "#list" do
+      use_vcr_cassette "cpanel/gpg/list"
+
+      subject { gpg.list[:params][:data] }
+
+      it { should be_an(Array) }
+    end
+
+    describe "#count" do
+      use_vcr_cassette "cpanel/gpg/count"
+
+      subject { gpg.count[:params][:data][0][:count] }
+
+      it { should be_a(Integer) }
+    end
+
+    describe "#list_private" do
+      use_vcr_cassette "cpanel/gpg/list_private"
+
+      subject { gpg.list_private[:params][:data] }
+
+      it { should be_an(Array) }
+    end
+
+    describe "#count_private" do
+      use_vcr_cassette "cpanel/gpg/count_private"
+
+      subject { gpg.count_private[:params][:data][0][:count] }
+
+      it { should be_a(Integer) }
+    end
+
+  end
+end
+

data/spec/cpanel/locale_spec.rb

@@ -0,0 +1,23 @@
+require "spec_helper"
+
+module Lumberg
+  describe Cpanel::Locale do
+    let(:server) { Whm::Server.new(host: @whm_host, hash: @whm_hash) }
+    let(:api_username) { "lumberg" }
+    let(:locale) do
+      described_class.new(
+        server:       server,
+        api_username: api_username
+      )
+    end
+
+    describe "#show" do
+      use_vcr_cassette "cpanel/locale/show"
+
+      subject { locale.show[:params][:data][0][:encoding] }
+
+      it { should be_a(String) }
+    end
+  end
+end
+

data/spec/cpanel/mysql_db_spec.rb

@@ -0,0 +1,119 @@
+require 'spec_helper'
+
+module Lumberg
+  describe Cpanel::MysqlDb do
+    let(:server) { Whm::Server.new(host: @whm_host, hash: @whm_hash) }
+    let(:api_username) { "lumberg" }
+    let(:mysql_db) do
+      described_class.new(
+        server: server,
+        api_username: api_username
+      )
+    end
+
+    describe "#add_db" do
+      use_vcr_cassette("cpanel/mysql_db/add_db")
+
+      it "adds a db" do
+        mysql_db.add_db(dbname: 'cpanel')[:params][:result].should_not be_nil
+      end
+    end
+
+    describe "#add_user" do
+      use_vcr_cassette("cpanel/mysql_db/add_user")
+
+      it "adds a user" do
+        mysql_db.add_user(username: 'first', password: 'first_pass')[:params][:result].should_not be_nil
+      end
+    end
+
+    describe "#add_user_db" do
+      use_vcr_cassette("cpanel/mysql_db/add_user_db")
+
+      it "adds a user to a db" do
+        mysql_db.add_user_db(dbname: 'lumberg_cpanel', dbuser: 'lumberg_first',
+                             perms_list: 'all')[:params][:result].should_not be_nil
+      end
+    end
+
+    describe "#number_of_dbs" do
+      use_vcr_cassette("cpanel/mysql_db/number_of_dbs")
+
+      it "gets number of dbs" do
+        mysql_db.number_of_dbs[:params][:result].should eq("1")
+      end
+    end
+
+    describe "#check_db" do
+      use_vcr_cassette("cpanel/mysql_db/check_db")
+
+      it "checks db" do
+        mysql_db.check_db(dbname: 'lumberg_cpanel')[:params][:result].should_not be_nil
+      end
+    end
+
+    describe "#repair_db" do
+      use_vcr_cassette("cpanel/mysql_db/repair_db")
+
+      it "repairs the db" do
+        mysql_db.repair_db(dbname: 'lumberg_cpanel')[:params][:result].should_not be_nil
+      end
+    end
+
+    describe "#update_privs" do
+      use_vcr_cassette("cpanel/mysql_db/update_privs")
+
+      it "updates privileges" do
+        mysql_db.update_privs[:params][:result].should_not be_nil
+      end
+    end
+
+    describe "#init_cache" do
+      use_vcr_cassette("cpanel/mysql_db/init_cache")
+
+      it "refreshes the cache of MySQL information" do
+        mysql_db.init_cache[:params][:result].should_not be_nil
+      end
+    end
+
+    describe "#del_user_db" do
+      use_vcr_cassette("cpanel/mysql_db/del_user_db")
+
+      it "disallows a user from accessing a db" do
+        mysql_db.del_user_db(dbname: 'lumberg_cpanel', dbuser: 'lumberg_first')[:params][:result].should_not be_nil
+      end
+    end
+
+    describe "#del_user" do
+      use_vcr_cassette("cpanel/mysql_db/del_user")
+
+      it "deletes a user" do
+        mysql_db.del_user(dbuser: 'lumberg_first')[:params][:result].should_not be_nil
+      end
+    end
+
+    describe "#del_db" do
+      use_vcr_cassette("cpanel/mysql_db/del_db")
+
+      it "deletes a db" do
+        mysql_db.del_db(dbname: 'lumberg_cpanel')[:params][:result].should_not be_nil
+      end
+    end
+
+    describe "#add_host" do
+      use_vcr_cassette("cpanel/mysql_db/add_host")
+
+      it "adds a host" do
+        mysql_db.add_host(hostname: 'cpanel_test.com')[:params][:result].should_not be_nil
+      end
+    end
+
+    describe "#del_host" do
+      use_vcr_cassette("cpanel/mysql_db/del_host")
+
+      it "deletes a host" do
+        mysql_db.del_host(host: 'cpanel_test.com')[:params][:result].should_not be_nil
+      end
+    end
+  end
+end

data/spec/cpanel/net_spec.rb

@@ -0,0 +1,30 @@
+require "spec_helper"
+
+module Lumberg
+  describe Cpanel::Net do
+    let(:server) { Whm::Server.new(host: @whm_host, hash: @whm_hash) }
+    let(:api_username) { "lumberg" }
+    let(:net) do
+      described_class.new(
+        server:       server,
+        api_username: api_username
+      )
+    end
+
+    describe "#traceroute" do
+      use_vcr_cassette "cpanel/net/traceroute"
+
+      subject { net.traceroute[:params][:data] }
+
+      it { should be_an(Array) }
+    end
+
+    describe "#query_hostname" do
+      use_vcr_cassette "cpanel/net/query_hostname"
+
+      subject { net.query_hostname({ host: 'google.com' })[:params][:data] }
+
+      it { should be_an(Array) }
+    end
+  end
+end

data/spec/cpanel/park_spec.rb

@@ -0,0 +1,94 @@
+require "spec_helper"
+
+module Lumberg
+  describe Cpanel::Park do
+    before(:each) do
+      @login    = { host: @whm_host, hash: @whm_hash }
+      @server   = Whm::Server.new(@login.dup)
+
+      @api_username = "lumberg"
+      @park = Cpanel::Park.new(
+        server:       @server.dup,
+        api_username: @api_username
+      )
+    end
+
+    describe "#add" do
+      use_vcr_cassette "cpanel/park/add"
+
+      it "creates a new parked domain" do
+        # Remove first
+        @park.remove(domain: "test-park.com")
+
+        result = @park.add(domain: "test-park.com")
+        result[:params][:data].first[:result].should == 1
+      end
+    end
+
+    describe "#remove" do
+      use_vcr_cassette "cpanel/park/remove"
+
+      it "removes a parked domain" do
+        # Add first
+        @park.add(domain: "test-park.com")
+
+        result = @park.remove(domain: "test-park.com")
+        result[:params][:data].first[:result].should == 1
+      end
+    end
+
+    describe "#list" do
+      use_vcr_cassette "cpanel/park/list"
+
+      context "parked domains exist on the account" do
+        let(:result) { @park.list }
+        subject { result[:params][:data] }
+
+        it "returns an array with info for each parked domain" do
+          subject.should be_an(Array)
+          subject.each {|info|
+            info.keys.should include(
+              :status, :reldir, :dir, :basedir, :domain
+            )
+          }
+        end
+      end
+
+      context "no parked domains exist on the account" do
+        before { @park.api_username = "minimal" }
+        after { @park.api_username = "lumberg" }
+
+        it "returns an empty array" do
+          @park.list[:params][:data].should be_empty
+        end
+      end
+    end
+
+    describe "#list_addon_domains" do
+      use_vcr_cassette "cpanel/park/list_addon_domains"
+
+      context "addon domains exist on the account" do
+        let(:result) { @park.list_addon_domains }
+        subject { result[:params][:data] }
+
+        it "returns an array with info for each addon domain" do
+          subject.should be_an(Array)
+          subject.each {|info|
+            info.keys.should include(
+              :status, :reldir, :dir, :basedir, :domain
+            )
+          }
+        end
+      end
+
+      context "no addon domains exist on the account" do
+        before { @park.api_username = "minimal" }
+        after { @park.api_username = "lumberg" }
+
+        it "returns an empty array" do
+          @park.list_addon_domains[:params][:data].should be_empty
+        end
+      end
+    end
+  end
+end

data/spec/cpanel/password_spec.rb

@@ -0,0 +1,35 @@
+require "spec_helper"
+
+module Lumberg
+  describe Cpanel::Password do
+    let(:server) { Whm::Server.new(host: @whm_host, hash: @whm_hash) }
+    let(:api_username) { "lumberg" }
+    let(:password) do
+      described_class.new(
+        server:       server,
+        api_username: api_username
+      )
+    end
+
+    let(:random_password) { "realtopsecretpassword" }
+
+    describe "#modify" do
+      use_vcr_cassette "cpanel/password/modify"
+
+      it "sets a new password for account" do
+        result = password.modify({ old: '12345', new: random_password })
+        result[:params][:data][0].should be_a(Hash)
+      end
+    end
+
+    describe "#digest_authentication" do
+      use_vcr_cassette "cpanel/password/digest_authentication"
+
+      it "enables digest authentication for account" do
+        result = password.digest_authentication({ password: random_password, enable: true })
+        result[:params][:data][0].should be_a(Hash)
+      end
+    end
+  end
+end
+

data/spec/cpanel/password_strength_spec.rb

@@ -0,0 +1,50 @@
+require "spec_helper"
+
+module Lumberg
+  describe Cpanel::PasswordStrength do
+    let(:server) { Whm::Server.new(host: @whm_host, hash: @whm_hash) }
+    let(:api_username) { "lumberg" }
+    let(:password_strength) do
+      described_class.new(
+        server:       server,
+        api_username: api_username
+      )
+    end
+
+    let(:weak_password) { "weakness" }
+    let(:strong_password) { "0zUIcv-0" }
+
+    describe "#strength" do
+      use_vcr_cassette "cpanel/password_strength/strength"
+
+      it "tests a weak password" do
+        result = password_strength.strength( password: weak_password )
+        result[:params][:data][0][:strength].to_s.should =~ /\A\d+\z/
+      end
+
+      it "tests a strong password" do
+        result = password_strength.strength( password: strong_password )
+        result[:params][:data][0][:strength].to_s.should =~ /\A\d+\z/
+      end
+    end
+
+    describe "#required_strength" do
+      use_vcr_cassette "cpanel/password_strength/required_strength"
+
+      it "gets required password strength for a specific app" do
+        result = password_strength.required_strength( app: 'htaccess' )
+        result[:params][:data][0][:strength].should be_an(Integer)
+      end
+    end
+
+    describe "#all_required_strengths" do
+      use_vcr_cassette "cpanel/password_strength/all_required_strengths"
+
+      it "gets required password strengths for all apps" do
+        result = password_strength.all_required_strengths
+        result[:params][:data][0].should be_a(Hash)
+      end
+    end
+  end
+end
+

data/spec/cpanel/random_data_spec.rb

@@ -0,0 +1,24 @@
+require "spec_helper"
+
+module Lumberg
+  describe Cpanel::RandomData do
+    let(:server) { Whm::Server.new(host: @whm_host, hash: @whm_hash) }
+    let(:api_username) { "lumberg" }
+    let(:random_data) do
+      described_class.new(
+        server:       server,
+        api_username: api_username
+      )
+    end
+
+    describe "#show" do
+      use_vcr_cassette "cpanel/random_data/show"
+
+      it "gets a random string" do
+        result = random_data.show({ length: 10 })[:params][:data]
+        result[0][:random].size.should === 10
+      end
+    end
+
+  end
+end

data/spec/cpanel/ssl_spec.rb

@@ -0,0 +1,158 @@
+require "spec_helper"
+
+
+module Lumberg
+  describe Cpanel::Ssl do
+    let(:domain) { "lumberg-test.com" }
+    let(:server) { Whm::Server.new(host: @whm_host, hash: @whm_hash) }
+    let(:api_username) { "lumberg" }
+
+    CP_CERT = File.read('./spec/sample_certs/cpanel.crt')
+    CP_KEY = File.read('./spec/sample_certs/cpanel.key')
+
+    let(:cert_params) do
+      {
+        user:             :api_username,
+        city:             "Chicago",
+        company:          "Initech",
+        company_division: "TPS",
+        country:          "US",
+        state:            "IL",
+        email:            "lumberg@initech.com",
+        host:             domain,
+        pass:             "Tru3St0ry",
+        key:              CP_KEY
+      }
+    end
+
+    let(:ssl) do
+      described_class.new(
+        server:       server,
+        api_username: api_username
+      )
+    end
+
+    describe "#installssl" do
+      use_vcr_cassette("cpanel/ssl/installssl")
+
+      it "installs a certificate for a cPanel account" do
+        ssl.installssl(user: :api_username, crt: CP_CERT,
+          domain: domain, key: CP_KEY)[:params][:data][0][:result].should eq(1)
+      end
+    end
+
+    describe "#listcsrs" do
+      use_vcr_cassette("cpanel/ssl/listcsrs")
+
+      it "prints the csrs for a cPanel account" do
+        ssl.listcsrs(user: :api_username
+          )[:params][:data][0][:host].should == domain
+      end
+    end
+
+    describe "#showcsr" do
+      use_vcr_cassette("cpanel/ssl/showcsr")
+
+      it "prints the current csr for a domain" do
+        ssl.showcsr(user: :api_username, domain: domain, textmode: 0
+          )[:params].to_s.should =~ /CERTIFICATE REQUEST/
+      end
+    end
+
+    describe "#showkey" do
+      use_vcr_cassette("cpanel/ssl/showkey")
+
+      it "prints the current key for a domain" do
+        ssl.showkey(user: :api_username, domain: domain, textmode: 0
+          )[:params].to_s.should =~ /PRIVATE KEY/
+      end
+    end
+
+    describe "#showcrt" do
+      use_vcr_cassette("cpanel/ssl/showcrt")
+
+      it "prints the current cert for a domain" do
+        ssl.showcrt(user: :api_username, domain: domain, textmode: 0
+          )[:params].to_s.should =~ /BEGIN CERTIFICATE/
+      end
+    end
+
+    describe "#listcrts" do
+      use_vcr_cassette("cpanel/ssl/listcrts")
+
+      it "lists the certs installed for an account " do
+        ssl.listcrts(user: :api_username)[:params][:data][0][:ssltxt].to_s.should \
+           =~ /Certificate/
+      end
+    end
+
+    describe "#listkeys" do
+      use_vcr_cassette("cpanel/ssl/listkeys")
+
+      it "lists the keys installed for an account" do
+        ssl.listkeys(user: :api_username)[:params][:data][0][:host].should == domain
+      end
+    end
+
+    describe "#fetchcabundle" do
+      use_vcr_cassette("cpanel/ssl/fetchcabundle")
+
+      it "fetches the CA bundle tied to the cert if any exist" do
+        ssl.listsslitems(crt: CP_CERT)[:params][:event][:result].should eq(1)
+      end
+    end
+
+    describe "#listsslitems" do
+      use_vcr_cassette("cpanel/ssl/listsslitems")
+
+      it "lists keys for a domain" do
+        ssl.listsslitems(domains: domain, items: 'key')[:params][:data][0][:host].should \
+          == domain
+      end
+    end
+
+    describe "#gencsr" do
+      use_vcr_cassette "cpanel/ssl/gencsr"
+
+      it "generates a certificate signing request" do
+        ssl.gencsr(cert_params)[:params][:data][0][:result].should eq(1)
+      end
+    end
+
+    describe "#gencrt" do
+      use_vcr_cassette "cpanel/ssl/gencrt"
+
+      it "generates a certificate" do
+        ssl.gencrt(cert_params.merge(key: CP_KEY))[:params][:data][0][:result].should eq(1)
+      end
+    end
+
+    describe "#genkey" do
+      use_vcr_cassette("cpanel/ssl/genkey")
+
+      it "generates a key" do
+        ssl.genkey(user: api_username, host: domain, keysize: 2048
+          )[:params][:data][0][:result].should eq(1)
+      end
+    end
+
+    describe "#uploadcrt" do
+      use_vcr_cassette("cpanel/ssl/uploadcrt")
+
+      it "uploads a certificate " do
+        ssl.uploadcrt(user: api_username, crt: CP_CERT,
+          host: domain)[:params][:data][0][:result].should eq(1)
+      end
+    end
+
+    describe "#remove" do
+      use_vcr_cassette "cpanel/ssl/remove"
+
+      subject { ssl.remove(domain: domain)[:params][:result] }
+
+      it "removes a certificate " do
+        subject.should include "The SSL host was successfully removed."
+      end
+    end
+  end
+end