Skip to content

Building 70 Projects ranging from beginner to advanced so anyone can — learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company 👇

5.9 KB
Raw Blame
"""
©AngelaMos | 2026
test_detector.py

Tests for format detection accuracy and edge cases in detector.py

Verifies that detect_best() and detect_encoding() correctly identify
each supported format from realistic input strings, that multi-format
results are sorted by confidence, and that unrecognized or too-short
inputs return empty results or None.

Tests:
  TestDetectBase64 - standard padding, no padding, +/ characters
  TestDetectBase64Url - URL-safe -_ character detection
  TestDetectBase32 - uppercase inputs, standard padding
  TestDetectHex - alpha hex chars, colon-separated, pure digits (low confidence)
  TestDetectUrl - percent sequences, heavily encoded strings
  TestDetectMultiple - sort order, no-match plain text, short string
  TestDetectBest - highest confidence selection, None on no match

Connects to:
  detector.py - imports detect_best, detect_encoding
  constants.py - imports EncodingFormat
"""

from base64_tool.constants import EncodingFormat
from base64_tool.detector import detect_best, detect_encoding


class TestDetectBase64:
    def test_standard_base64(self) -> None:
        """
        Checks that a padded base64 string is detected as base64 with high confidence
        """
        result = detect_best("SGVsbG8gV29ybGQ=")
        assert result is not None
        assert result.format == EncodingFormat.BASE64
        assert result.confidence >= 0.7

    def test_base64_no_padding(self) -> None:
        """
        Checks that base64 without trailing = padding is still detected
        """
        result = detect_best("SGVsbG8gV29ybGQh")
        assert result is not None
        assert result.format == EncodingFormat.BASE64

    def test_base64_with_plus_slash(self) -> None:
        """
        Checks that base64 containing + and / characters is detected correctly
        """
        result = detect_best("dGVzdC9wYXRoK3F1ZXJ5")
        assert result is not None
        assert result.format == EncodingFormat.BASE64


class TestDetectBase64Url:
    def test_url_safe_chars(self) -> None:
        """
        Checks that a base64url string with - and _ is detected as base64url or base64
        """
        result = detect_best("dGVzdC1kYXRhX3ZhbHVl")
        assert result is not None
        assert result.format in (
            EncodingFormat.BASE64URL,
            EncodingFormat.BASE64,
        )


class TestDetectBase32:
    def test_standard_base32(self) -> None:
        """
        Checks that a padded uppercase base32 string is detected with sufficient confidence
        """
        result = detect_best("JBSWY3DPEBLW64TMMQ======")
        assert result is not None
        assert result.format == EncodingFormat.BASE32
        assert result.confidence >= 0.6

    def test_base32_uppercase(self) -> None:
        """
        Checks that a short uppercase base32 string is detected
        """
        result = detect_best("JBSWY3DP")
        assert result is not None
        assert result.format == EncodingFormat.BASE32


class TestDetectHex:
    def test_hex_with_letters(self) -> None:
        """
        Checks that a hex string containing alpha characters is detected as hex
        """
        result = detect_best("48656c6c6f20576f726c64")
        assert result is not None
        assert result.format == EncodingFormat.HEX
        assert result.confidence >= 0.6

    def test_hex_with_colons(self) -> None:
        """
        Checks that colon-separated hex bytes are detected as hex
        """
        result = detect_best("48:65:6c:6c:6f:20:57:6f:72:6c:64")
        assert result is not None
        assert result.format == EncodingFormat.HEX

    def test_pure_digits_not_detected(self) -> None:
        """
        Checks that a digit-only string is not confidently detected as hex
        """
        result = detect_best("1234567890")
        if result is not None and result.format == EncodingFormat.HEX:
            assert result.confidence < 0.7


class TestDetectUrl:
    def test_url_encoded(self) -> None:
        """
        Checks that a string with percent-encoded characters is detected as URL encoding
        """
        result = detect_best("hello%20world%21%40%23")
        assert result is not None
        assert result.format == EncodingFormat.URL

    def test_heavily_encoded(self) -> None:
        """
        Checks that a heavily percent-encoded string is detected with sufficient confidence
        """
        result = detect_best("%48%65%6C%6C%6F%20%57%6F%72%6C%64")
        assert result is not None
        assert result.format == EncodingFormat.URL
        assert result.confidence >= 0.6


class TestDetectMultiple:
    def test_returns_sorted_by_confidence(self) -> None:
        """
        Checks that multiple detection results come back sorted highest confidence first
        """
        results = detect_encoding("SGVsbG8gV29ybGQ=")
        if len(results) > 1:
            confidences = [r.confidence for r in results]
            assert confidences == sorted(confidences, reverse = True)

    def test_no_match_returns_empty(self) -> None:
        """
        Checks that plain unencoded text returns no detection results
        """
        results = detect_encoding("hello world")
        assert results == []

    def test_short_string_returns_empty(self) -> None:
        """
        Checks that strings below the minimum length return no results
        """
        results = detect_encoding("ab")
        assert results == []


class TestDetectBest:
    def test_returns_highest_confidence(self) -> None:
        """
        Checks that detect_best returns the same result as the first item from detect_encoding
        """
        result = detect_best("SGVsbG8gV29ybGQ=")
        assert result is not None
        all_results = detect_encoding("SGVsbG8gV29ybGQ=")
        if all_results:
            assert result.confidence == all_results[0].confidence

    def test_no_match_returns_none(self) -> None:
        """
        Checks that detect_best returns None when nothing is detected
        """
        assert detect_best("not encoded at all!") is None