portfoliomanager-rb 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1d08210a0f87d2a223f37ed3a7bc5d7d3c17b4a1be32d73e47bad8e4c3c146ef
+  data.tar.gz: 8e0e39dd94114e40d810712ff9b5f3cd127876ed40d034af39947f44dbca09b8
+SHA512:
+  metadata.gz: fa7b8f14d72e55d96d07ee0131864b2eeebc7b2f1c972b434ad5d8dc839a7af420107dbabffcd3b29f44d97d0f37c18f5d6a829c1c0220256a5b9d0be45ab737
+  data.tar.gz: b36abe0b406c7e5c4a05858ed780ee9f9449b156d9c33051e577bdb0504e99abec8093d99d4842e57fed917f6ae40ec9d35f3bbb3c9b3c07f4beabbd51504b54

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.7.5

data/.travis.yml

@@ -0,0 +1,6 @@
+---
+language: ruby
+cache: bundler
+rvm:
+  - 2.7.5
+before_install: gem install bundler -v 2.1.4

data/.yardopts

@@ -0,0 +1 @@
+--no-private --protected lib/**/*.rb - README.md CHANGELOG.md LICENSE.txt WARRANTY.txt

data/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.0.1] - 2022-02-23
+### Added
+- Initial commit.
+
+[Unreleased]: https://github.com/pnnl/portfoliomanager-rb/compare/v0.0.1...HEAD
+[0.0.1]: https://github.com/pnnl/portfoliomanager-rb/releases/tag/v0.0.1

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in portfoliomanager.gemspec
+gemspec
+
+gem "rake", "~> 12.0"
+gem "rspec", "~> 3.0"
+gem "yard", "~> 0.9"

data/Gemfile.lock

@@ -0,0 +1,42 @@
+PATH
+  remote: .
+  specs:
+    portfoliomanager-rb (0.0.1)
+      logger-application (~> 0.0.2)
+      soap4r-ng (~> 2.0.4)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.5.0)
+    logger-application (0.0.2)
+    rake (12.3.3)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
+    soap4r-ng (2.0.4)
+    webrick (1.7.0)
+    yard (0.9.27)
+      webrick (~> 1.7.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  portfoliomanager-rb!
+  rake (~> 12.0)
+  rspec (~> 3.0)
+  yard (~> 0.9)
+
+BUNDLED WITH
+   2.1.4

data/LICENSE.txt

@@ -0,0 +1,30 @@
+Copyright (c) 2022, Battelle Memorial Institute
+All rights reserved.
+
+1. Battelle Memorial Institute (hereinafter Battelle) hereby grants permission
+   to any person or entity lawfully obtaining a copy of this software and
+   associated documentation files (hereinafter "the Software") to redistribute
+   and use the Software in source and binary forms, with or without
+   modification.  Such person or entity may use, copy, modify, merge, publish,
+   distribute, sublicense, and/or sell copies of the Software, and may permit
+   others to do so, subject to the following conditions:
+
+   * Redistributions of source code must retain the above copyright notice, this
+     list of conditions and the following disclaimers.
+   * Redistributions in binary form must reproduce the above copyright notice,
+     this list of conditions and the following disclaimer in the documentation
+     and/or other materials provided with the distribution.
+   * Other than as used herein, neither the name Battelle Memorial Institute or
+     Battelle may be used in any form whatsoever without the express written
+     consent of Battelle.
+
+2. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL BATTELLE OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,92 @@
+# ENERGY STAR Portfolio Manager - Web Services Clients in Ruby
+
+`portfoliomanager-rb` provides clients for [ENERGY STAR Portfolio Manager Web Services](https://portfoliomanager.energystar.gov/webservices/home) for the Ruby programming language.
+
+A short rundown of some of the major features:
+* 100% API coverage (version 18.0).
+  ```ruby
+  test_client = PortfolioManager::Client::Test.new("SampleJohnDoeAccount", "Sample123")
+
+  test_client.methods
+  #  => [:accept_reject_pending_connection_requests, :accept_reject_pending_meter_share_requests, :accept_reject_pending_property_share_requests, :add_building, :add_energy_performance_project, :add_individual_meter_to_aggregated_meter, :add_meter, :add_meter_consumption_data, :add_meter_identifier_value, :add_meter_waste_data, :add_property, :add_property_identifier_value, :add_property_use, :add_property_verification_information, :add_property_verification_professional_designation_information, :associate_building_to_a_property, :associate_meter_to_a_property, :associate_meter_to_a_property_use, :associate_meters_to_a_property, :associate_meters_to_a_property_use, :create_customer, :delete_all_individual_meters_of_an_aggregate_meter, :delete_building, :delete_consumption_data, :delete_custom_field, :delete_energy_performance_project, :delete_individual_meter_of_an_aggregated_meter, :delete_meter, :delete_meter_consumption_data, :delete_meter_identifier_value, :delete_meter_waste_data, :delete_property, :delete_property_identifier_value, :delete_property_pgp, :delete_property_use, :delete_property_verification_information, :delete_property_verification_professional_designation_information, :delete_specific_professional_designation_license_from_property_verification_information, :delete_specific_professional_designation_type_from_property_verification_information, :delete_waste_data, :disassociate_meter_from_a_property, :disassociate_meter_from_a_property_use, :disconnect_from_customer, :edit_account, :edit_billboard_setting_at_property_level_for_account, :edit_billboard_setting_at_property_level_for_customer, :edit_building, :edit_consumption_data, :edit_custom_field, :edit_customer, :edit_data_exchange_settings, :edit_design, :edit_energy_performance_project, :edit_meter, :edit_meter_identifier_value, :edit_property, :edit_property_baseline_and_target, :edit_property_edu, :edit_property_identifier_value, :edit_property_international_weather_station, :edit_property_pgp, :edit_property_use, :edit_use_details, :edit_use_details_correction, :edit_waste_data, :get_account, :get_all_meter_identifier_list, :get_associated_property_meters, :get_associated_property_use_meters, :get_billboard_metric_list, :get_billboard_setting_at_property_level_for_account, :get_billboard_setting_at_property_level_for_customer, :get_building, :get_building_list, :get_custom_field, :get_custom_field_list, :get_customer, :get_customer_custom_field_values, :get_customer_list, :get_data_exchange_settings, :get_design, :get_design_metrics, :get_egrid_subregion_list, :get_energy_performance_project, :get_energy_performance_project_list, :get_federal_agency_list, :get_id_hierarchy_for_consumption_data, :get_id_hierarchy_for_meter, :get_id_hierarchy_for_property, :get_id_hierarchy_for_property_use, :get_id_hierarchy_for_use_detail, :get_id_hierarchy_for_waste_data, :get_individual_meter_of_an_aggregated_meter, :get_international_weather_station_list, :get_meter, :get_meter_aggregation_indicator, :get_meter_aggregation_list, :get_meter_consumption_data, :get_meter_custom_field_values, :get_meter_identifier_list, :get_meter_identifier_value, :get_meter_identifier_value_list, :get_meter_list, :get_meter_waste_data, :get_notifications, :get_parent_property_list, :get_pending_connection_requests, :get_pending_meter_share_requests, :get_pending_property_share_requests, :get_professional_designation_types_list, :get_property, :get_property_baseline_and_target, :get_property_custom_field_values, :get_property_edu_list, :get_property_identifier_list, :get_property_identifier_value, :get_property_identifier_value_list, :get_property_list, :get_property_metrics, :get_property_monthly_metrics, :get_property_pgp_list, :get_property_use, :get_property_use_list, :get_property_use_metrics, :get_property_verification_information, :get_property_verification_professional_designation_information, :get_reasons_for_no_energy_score, :get_reasons_for_no_water_score, :get_use_details, :get_use_details_revision_history, :get_what_changed_consumption_data_meter_list, :get_what_changed_meter_list, :get_what_changed_meter_list_for_a_specific_property, :get_what_changed_property_list, :get_what_changed_property_use_list, :get_what_changed_property_use_list_from_use_detail_changes_only, :get_what_changed_waste_data_meter_list, :remove_building_association, :remove_instance_variable, :send_connection_request_from_test_environment, :send_meter_share_request_from_test_environment, :submit_customer_level_custom_field_values, :submit_meter_level_custom_field_values, :submit_property_level_custom_field_values, :target_finder, :unshare_meter, :unshare_property, :update_individual_meter_of_aggregated_meter, :update_property_verification_information, :update_property_verification_professional_designation_information, :update_specific_professional_designation_license_of_property_verification_information, ...]
+  ```
+* Automated mapping between XML schemas and Ruby objects.
+  ```ruby
+  property = PortfolioManager::Xml::PropertyType.new
+  property.name = "My Property"
+
+  xml = PortfolioManager::Mapper.instance.obj2xml(property)
+  #  => "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><property><name>My Property</name></property>"
+
+  obj = PortfolioManager::Mapper.instance.xml2obj(xml)
+  obj.name
+  #  => "My Property"
+  ```
+* Clients for [Live](https://portfoliomanager.energystar.gov/webservices/home/api) and [Test](https://portfoliomanager.energystar.gov/webservices/home/test/api) environments.
+  ```ruby
+  # Live Environment
+  live_client = PortfolioManager::Client::Live.new("SampleJohnDoeAccount", "Sample123")
+
+  # Test Environment
+  test_client = PortfolioManager::Client::Test.new("SampleJohnDoeAccount", "Sample123")
+  ```
+* Debug mode with HTTP request/response logging.
+  ```ruby
+  # Test Environment with Debugging
+  test_client = PortfolioManager::Client::Test.new("SampleJohnDoeAccount", "Sample123", true)
+
+  account = test_client.get_account
+  # I, [2022-02-18T11:48:19.422074 #91494]  INFO -- PortfolioManager: Request:
+  # 	Protocol: HTTP/1.2
+  # 	Method: GET
+  # 	Scheme: https
+  # 	Host: portfoliomanager.energystar.gov
+  # 	Path: /wstest/account
+  # 	QueryString:
+  # 	Body:
+  # 	Accept: application/xml, text/xml
+  # 	Authorization: Basic U2FtcGxlSm9obkRvZUFjY291bnQxMjM0NTY3OTAzOlNhbXBsZTEyMw==
+  #
+  # I, [2022-02-18T11:48:19.581841 #91494]  INFO -- PortfolioManager: Response:
+  # 	Protocol: HTTP/1.1
+  # 	URI: https://portfoliomanager.energystar.gov/wstest/account
+  # 	Code: 200
+  # 	Message:
+  # 	Body: <?xml version="1.0" encoding="UTF-8" standalone="yes"?><account><id>379547</id><username>SampleJohnDoeAccount1234567903</username><password>********</password><webserviceUser>true</webserviceUser><searchable>false</searchable><includeTestPropertiesInGraphics>true</includeTestPropertiesInGraphics><emailPreferenceCanadianAccount>true</emailPreferenceCanadianAccount><contact><address address1="123 South St" city="Edmonton" state="AB" postalCode="T5G 2S7" country="CA"/><email>jack_brown@acme.com</email><firstName>Jack</firstName><phone>703-555-2121</phone><lastName>Brown</lastName><jobTitle>Building Administrator Data Exchange User</jobTitle></contact><organization name="ACME Corporation"><primaryBusiness>Other</primaryBusiness><otherBusinessDescription>other</otherBusinessDescription><energyStarPartner>true</energyStarPartner><energyStarPartnerType>Service and Product Providers</energyStarPartnerType></organization><billboardMetric>No Selection Made</billboardMetric><languagePreference>en_US</languagePreference></account>
+  #
+  #  => #<PortfolioManager::Xml::AccountType:0x00007fdaedbfbfb0 @id=379547, @username="SampleJohnDoeAccount1234567903", @password="********", @webserviceUser=true, @searchable=false, @includeTestPropertiesInGraphics=true, @emailPreferenceCanadianAccount=true, @contact=#<PortfolioManager::Xml::ContactType:0x00007fdaedbfa868 @address=#<PortfolioManager::Xml::AddressType:0x00007fdaedbfa7f0 @__xmlattr={#<XSD::QName:0x1d74 {}address1>=>"123 South St", #<XSD::QName:0x1d88 {}city>=>"Edmonton", #<XSD::QName:0x1d9c {}postalCode>=>"T5G 2S7", #<XSD::QName:0x1db0 {}state>=>"AB", #<XSD::QName:0x1dc4 {}country>=>"CA"}>, @email="jack_brown@acme.com", @firstName="Jack", @phone="703-555-2121", @lastName="Brown", @jobTitle="Building Administrator Data Exchange User">, @organization=#<PortfolioManager::Xml::OrganizationType:0x00007fdaedbebdb8 @primaryBusiness="Other", @otherBusinessDescription="other", @energyStarPartner=true, @energyStarPartnerType="Service and Product Providers", @__xmlattr={#<XSD::QName:0x1dd8 {}name>=>"ACME Corporation"}>, @billboardMetric="No Selection Made", @languagePreference="en_US">
+  ```
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'portfoliomanager-rb'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install portfoliomanager-rb
+
+## Usage
+
+See YARD documentation for source code for usage instructions.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/pnnl/portfoliomanager-rb.
+
+## License
+
+The gem is available as open source under the terms of [The 2-Clause BSD License](https://opensource.org/licenses/BSD-2-Clause).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/WARRANTY.txt

@@ -0,0 +1,22 @@
+This material was prepared as an account of work sponsored by an agency of the
+United States Government.  Neither the United States Government nor the United
+States Department of Energy, nor Battelle, nor any of their employees, nor any
+jurisdiction or organization that has cooperated in the development of these
+materials, makes any warranty, express or implied, or assumes any legal
+liability or responsibility for the accuracy, completeness, or usefulness or any
+information, apparatus, product, software, or process disclosed, or represents
+that its use would not infringe privately owned rights.
+
+Reference herein to any specific commercial product, process, or service by
+trade name, trademark, manufacturer, or otherwise does not necessarily
+constitute or imply its endorsement, recommendation, or favoring by the United
+States Government or any agency thereof, or Battelle Memorial Institute. The
+views and opinions of authors expressed herein do not necessarily state or
+reflect those of the United States Government or any agency thereof.
+
+                      PACIFIC NORTHWEST NATIONAL LABORATORY
+                                   operated by
+                                    BATTELLE
+                                     for the
+                       UNITED STATES DEPARTMENT OF ENERGY
+                        under Contract DE-AC05-76RL01830

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "portfolio_manager"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/portfolio_manager/client.rb

@@ -0,0 +1,199 @@
+require "erb"
+require "logger/application"
+require "net/http"
+require "uri"
+
+module PortfolioManager
+  # HTTP Request Error
+  class HTTPRequestError < PortfolioManager::Error
+    attr_reader :request
+
+    # Default constructor.
+    #
+    # @param request [Net::HTTPRequest]
+    # @param args [Array<Object>]
+    def initialize(request, *args)
+      super(*args)
+
+      @request = request
+    end
+  end
+
+  # HTTP Response Error
+  #
+  # @!attribute [r] response
+  #   @return [Net::HTTPResponse]
+  class HTTPResponseError < PortfolioManager::Error
+    attr_reader :response
+
+    # Default constructor.
+    #
+    # @param response [Net::HTTPResponse]
+    # @param args [Array<Object>]
+    def initialize(response, *args)
+      super(*args)
+
+      @response = response
+    end
+  end
+
+  # HTTP Basic Credentials Not Found Error
+  class HTTPBasicCredentialsNotFoundError < HTTPRequestError; end
+
+  module Client
+    # Base Client
+    #
+    # @!attribute [r] user
+    #   @return [String]
+    # @!attribute [r] pass
+    #   @return [String]
+    # @!attribute [r] base_uri
+    #   @return [URI]
+    # @!attribute [r] debug
+    #   @return [Boolean]
+    class Base < Logger::Application
+      attr_reader :base_uri
+      attr_reader :user, :pass
+      attr_reader :debug
+
+      # Default constructor.
+      #
+      # @param base_uri [URI]
+      # @param user [nil, String]
+      # @param pass [nil, String]
+      # @param debug [Boolean]
+      # @return [PortfolioManager::Client::Base]
+      def initialize(base_uri, user = nil, pass = nil, debug = false)
+        super("PortfolioManager")
+
+        @base_uri, @user, @pass, @debug = base_uri, user, pass, debug
+      end
+
+      protected
+
+      # Send HTTP request.
+      #
+      # @param verb [Class]
+      # @param path [String]
+      # @param params [Hash<String, Object>]
+      # @param initheader [Hash<String, String>]
+      # @param obj [nil, Object]
+      # @param elename [nil, String]
+      # @param klass [nil, Class]
+      # @param options [Hash<Symbol, Object>]
+      # @option options [Boolean] :basic_auth
+      # @return [Object]
+      # @raise [PortfolioManager::HTTPBasicCredentialsNotFoundError]
+      # @raise [PortfolioManager::HTTPResponseError]
+      def request(verb = Net::HTTP::Get, path = "/", params = {}, initheader = {}, obj = nil, elename = nil, klass = nil, **options)
+        uri = url_for(path, params)
+
+        request = verb.new(uri, initheader)
+
+        request["Accept"] = "application/xml, text/xml"
+
+        unless obj.nil?
+          request["Content-Type"] = "application/xml; charset=UTF-8"
+
+          request.body = PortfolioManager::Mapper.instance.obj2xml(obj, elename)
+        end
+
+        if options[:basic_auth]
+          if @user.nil? || @pass.nil?
+            raise PortfolioManager::HTTPBasicCredentialsNotFoundError.new(request)
+          else
+            request.basic_auth(@user, @pass)
+          end
+        end
+
+        Net::HTTP.start(uri.host, uri.port, use_ssl: uri.is_a?(URI::HTTPS)) do |http|
+          log(INFO, "Request:\n" + ([
+            "Protocol: HTTP/#{Net::HTTP.version_1_2? ? "1.2" : "1.1"}",
+            "Method: #{verb.name.split("::")[-1].upcase}",
+            "Scheme: #{uri.scheme}",
+            "Host: #{uri.host}",
+            "Path: #{uri.path}",
+            "QueryString: #{uri.query}",
+            "Body: #{request.body}",
+          ] + (["Accept", "Authorization", "Content-Type"] + initheader.keys).sort.uniq.collect { |key|
+            request.key?(key) ? "#{key}: #{request[key]}" : nil
+          }.compact).collect { |s|
+            "\t#{s}"
+          }.join("\n"))
+
+          response = http.request(request)
+
+          log(INFO, "Response:\n" + ([
+            "Protocol: HTTP/#{response.http_version}",
+            "URI: #{response.uri}",
+            "Code: #{response.code}",
+            "Message: #{response.message}",
+            "Body: #{response.body}",
+          ]).compact.collect { |s|
+            "\t#{s}"
+          }.join("\n"))
+
+          if response.body.start_with?("<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>")
+            PortfolioManager::Mapper.instance.xml2obj(response.body, klass)
+          else
+            raise PortfolioManager::HTTPResponseError.new(response)
+          end
+        end
+      end
+
+      # Build path for the given arguments.
+      #
+      # @param args [Array<#to_s>]
+      # @return [String]
+      def path_for(*args)
+        "/#{args.collect { |arg| ERB::Util.url_encode(arg.to_s) }.join("/")}"
+      end
+
+      # Build URL for given path and query parameters.
+      #
+      # @param path [String]
+      # @param params [Hash<String, Object>]
+      # @return [URI]
+      def url_for(path, params = {})
+        query_string = params.each_pair.collect { |pair|
+          key, value = *pair
+
+          value.nil? ? nil : "#{ERB::Util.url_encode(key)}=#{ERB::Util.url_encode(value.to_s)}"
+        }.compact.join("&")
+
+        URI("#{@base_uri}#{path}#{query_string.empty? ? nil : "?#{query_string}"}")
+      end
+    end
+
+    # Live Environment Client
+    class Live < Base
+      # Default constructor.
+      #
+      # @param user [nil, String]
+      # @param pass [nil, String]
+      # @param debug [Boolean]
+      # @return [PortfolioManager::Client::Live]
+      def initialize(user = nil, pass = nil, debug = false)
+        super(URI("https://portfoliomanager.energystar.gov/ws"), user, pass, debug)
+      end
+
+      include PortfolioManager::Services::All::Live
+    end
+
+    # Test Environment Client
+    class Test < Base
+      # Default constructor.
+      #
+      # @param user [nil, String]
+      # @param pass [nil, String]
+      # @param debug [Boolean]
+      # @return [PortfolioManager::Client::Test]
+      def initialize(user = nil, pass = nil, debug = false)
+        super(URI("https://portfoliomanager.energystar.gov/wstest"), user, pass, debug)
+      end
+
+      include PortfolioManager::Services::All::Live
+      include PortfolioManager::Services::All::Test
+    end
+  end
+end

data/lib/portfolio_manager/mapper.rb

@@ -0,0 +1,14 @@
+require "singleton"
+require "xsd/mapping"
+
+module PortfolioManager
+  # Mapper
+  class Mapper < XSD::Mapping::Mapper
+    include Singleton
+
+    # Singleton constructor.
+    def initialize
+      super(PortfolioManager::MappingRegistry::Registry)
+    end
+  end
+end