# Copyright (C) 2015-2025 by the Free Software Foundation, Inc.
#
# This file is part of GNU Mailman.
#
# GNU Mailman is free software: you can redistribute it and/or modify it under
# the terms of the GNU General Public License as published by the Free
# Software Foundation, either version 3 of the License, or (at your option)
# any later version.
#
# GNU Mailman is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
# more details.
#
# You should have received a copy of the GNU General Public License along with
# GNU Mailman.  If not, see <https://www.gnu.org/licenses/>.

"""Test basic functionality of the REST API.

For example, test the integration between Mailman and Falcon.
"""

import unittest

from http.client import InvalidURL
from mailman.app.lifecycle import create_list
from mailman.database.transaction import transaction
from mailman.testing.helpers import call_api
from mailman.testing.layers import RESTLayer
from urllib.error import HTTPError
from urllib.request import urlopen


class TestBasicREST(unittest.TestCase):
    """Test basic REST integration and functionality."""

    layer = RESTLayer

    def setUp(self):
        with transaction():
            self._mlist = create_list('test@example.com')

    def test_comma_fields(self):
        json, response = call_api(
            'http://localhost:9001/3.0/lists/test@example.com/config',
            dict(description='A description with , to check stuff'),
            method='PATCH')
        # This fails with Falcon 0.2; passes with Falcon 0.3.
        self.assertEqual(self._mlist.description,
                         'A description with , to check stuff')

    def test_send_error(self):
        # GL#288 working around Python bug #28548.  The improperly encoded
        # space in the URL breaks error reporting due to default HTTP/0.9.
        # Use urllib.request since requests will encode the URL, defeating the
        # purpose of this test (i.e. we want the literal space, not %20).
        with self.assertRaises((HTTPError, InvalidURL)) as cm:
            urlopen('http://localhost:9001/3.0/lists/test @example.com')

        if isinstance(cm, HTTPError):
            self.assertEqual(cm.exception.code, 400)