webutil.tests package

Submodules

webutil.tests.test_flask_util module

webutil.tests.test_logs module

Unit tests for logs.py. Woefully incomplete.

class LogsTest(methodName='runTest')

Bases: TestCase

setUp()

test_url()

test_maybe_link()

test_maybe_link_path()

test_maybe_link_future()

test_start_time_too_old()

test_start_time_too_far_future()

webutil.tests.test_models module

Unit tests for models.py.

class ReloaderTest(methodName='runTest')

Bases: TestCase

setUp()

test_loads_on_first_access(mock_now)

test_returns_none_if_missing()

test_caches_within_interval(mock_now)

test_reloads_after_interval(mock_now)

test_reload(mock_now)

class StringIdModelTest(methodName='runTest')

Bases: TestCase

setUp()

test_put()

class TestEnum(*values)

Bases: Enum

FOO = 1

BAR = 2

class EnumModel(**kwargs)

Bases: Model

field

Property for storing Python Enum values.

Stores the enum’s integer value in the datastore.

class EnumPropertyTest(methodName='runTest')

Bases: TestCase

test_init_non_enum()

test_validate()

test_round_trip()

class EncryptedModel(**kwargs)

Bases: Model

secret

Property that stores encrypted bytes.

Encrypts bytes values using AES-256-GCM before storing in the datastore, and decrypts them when reading back.

The AES-256-GCM key(s) should be in the encrypted_property_key file, base64 encoded, one per line. Encryption always uses the first key. For decryption, each key is tried in order until one succeeds.

Multiple keys are used during key rotation: add the new key as the first line and keep the old key as the second line. New writes will use the new key, and existing ciphertexts encrypted with the old key will still decrypt via fallback. Once all stored values have been re-encrypted with the new key, remove the old key.

Here’s example code to generate an AES-256-GCM key and base64 encode it:

import base64 from cryptography.hazmat.primitives.ciphers.aead import AESGCM

key_bytes = AESGCM.generate_key(bit_length=256) print(base64.b64encode(key_bytes))

class EncryptedPropertyTest(methodName='runTest')

Bases: TestCase

setUp()

tearDown()

test_validate()

test_round_trip()

test_encrypted_storage()

test_none_value()

test_no_key_error()

test_different_nonces()

test_decrypt_falls_back_to_later_key()

test_decrypt_fails_when_no_key_matches()

test_write_once()

webutil.tests.test_util module

webutil.tests.test_webmention module

Unit tests for webmention.py.

class DiscoverTest(methodName='runTest')

Bases: TestCase

test_bad_url()

test_no_endpoint()

test_html_link()

test_html_a()

test_html_refresh()

test_html_relative()

test_html_rel_url()

test_html_link_and_a()

test_html_link_a_and_refresh()

test_html_other_links()

test_html_empty()

test_html_unicode()

test_html_escaped()

test_html_content_type_html()

test_html_content_type_html_charset()

test_html_content_type_other()

test_header()

test_header_relative()

test_header_quoted()

test_header_rel_url()

test_other_headers()

test_multiple_link_headers()

test_header_empty()

test_header_query_params()

test_header_fragment()

test_header_unicode()

test_header_escaped()

test_http_500()

test_connection_error(_)

class SendTest(methodName='runTest')

Bases: TestCase

test_bad_url()

test_success()

test_requests_exception()

test_preserve_endpoint_query_params()

test_unicode_urls()

test_unicode_urls_escaped()

Module contents