text: ###############################################################################
  #
  # The MIT License (MIT)
  #
  # Copyright (c) Crossbar.io Technologies GmbH
  #
  # Permission is hereby granted, free of charge, to any person obtaining a copy
  # of this software and associated documentation files (the "Software"), to deal
  # in the Software without restriction, including without limitation the rights
  # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  # copies of the Software, and to permit persons to whom the Software is
  # furnished to do so, subject to the following conditions:
  #
  # The above copyright notice and this permission notice shall be included in
  # all copies or substantial portions of the Software.
  #
  # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  # THE SOFTWARE.
  #
  ###############################################################################
  
  # we need to select a txaio subsystem because we're importing the base
  # protocol classes here for testing purposes. "normally" yo'd import
  # from autobahn.twisted.wamp or autobahn.asyncio.wamp explicitly.
  from autobahn import wamp
  from autobahn.wamp import message
  from autobahn.wamp import exception
  from autobahn.wamp import protocol
  
  import unittest
  
  
  class TestPeerExceptions(unittest.TestCase):
  
      def test_exception_from_message(self):
          session = protocol.BaseSession()
  
          @wamp.error("com.myapp.error1")
          class AppError1(Exception):
              pass
  
          @wamp.error("com.myapp.error2")
          class AppError2(Exception):
              pass
  
          session.define(AppError1)
          session.define(AppError2)
  
          # map defined errors to user exceptions
          emsg = message.Error(message.Call.MESSAGE_TYPE, 123456, 'com.myapp.error1')
          exc = session._exception_from_message(emsg)
          self.assertIsInstance(exc, AppError1)
          self.assertEqual(exc.args, ())
  
          emsg = message.Error(message.Call.MESSAGE_TYPE, 123456, 'com.myapp.error2')
          exc = session._exception_from_message(emsg)
          self.assertIsInstance(exc, AppError2)
          self.assertEqual(exc.args, ())
  
          # map undefined error to (generic) exception
          emsg = message.Error(message.Call.MESSAGE_TYPE, 123456, 'com.myapp.error3')
          exc = session._exception_from_message(emsg)
          self.assertIsInstance(exc, exception.ApplicationError)
          self.assertEqual(exc.error, 'com.myapp.error3')
          self.assertEqual(exc.args, ())
          self.assertEqual(exc.kwargs, {})
  
          emsg = message.Error(message.Call.MESSAGE_TYPE, 123456, 'com.myapp.error3', args=[1, 2, 'hello'])
          exc = session._exception_from_message(emsg)
          self.assertIsInstance(exc, exception.ApplicationError)
          self.assertEqual(exc.error, 'com.myapp.error3')
          self.assertEqual(exc.args, (1, 2, 'hello'))
          self.assertEqual(exc.kwargs, {})
  
          emsg = message.Error(message.Call.MESSAGE_TYPE, 123456, 'com.myapp.error3', args=[1, 2, 'hello'], kwargs={'foo': 23, 'bar': 'baz'})
          exc = session._exception_from_message(emsg)
          self.assertIsInstance(exc, exception.ApplicationError)
          self.assertEqual(exc.error, 'com.myapp.error3')
          self.assertEqual(exc.args, (1, 2, 'hello'))
          self.assertEqual(exc.kwargs, {'foo': 23, 'bar': 'baz'})
  
      def test_message_from_exception(self):
          session = protocol.BaseSession()
  
          @wamp.error("com.myapp.error1")
          class AppError1(Exception):
              pass
  
          @wamp.error("com.myapp.error2")
          class AppError2(Exception):
              pass
  
          session.define(AppError1)
          session.define(AppError2)
  
          exc = AppError1()
          msg = session._message_from_exception(message.Call.MESSAGE_TYPE, 123456, exc)
  
          self.assertEqual(msg.marshal(), [message.Error.MESSAGE_TYPE, message.Call.MESSAGE_TYPE, 123456, {}, "com.myapp.error1"])
  