fix(safaa): repair broken email regex via verbose flag

[Valyrian-Code]

Description

The email-replacement regex in _perform_text_substitutions was written as a multi-line triple-quoted raw string with indentation for readability. Because the pattern was not compiled in verbose mode, Python preserved the embedded whitespace as literal characters, causing the regex to expect newlines and spaces inside email addresses. As a result, valid emails never matched and were never replaced with the EMAIL token.

This PR prepends the inline verbose flag (?x) to the pattern so formatting whitespace is ignored while preserving whitespace inside character classes. This restores the original intended behavior without restructuring the regex.

Changes

• [Safaa.py#L213](https://github.com/fossology/safaa/blob/main/Safaa/src/safaa/Safaa.py?utm_source=chatgpt.com#L213)
  Add (?x) to the email regex and document why verbose mode is required

• tests/__init__.py, tests/test_safaa.py
  Add pytest coverage for:

  • simple emails
  • dotted local parts
  • plus tags
  • subdomains
  • hyphenated domains
  • multiple emails in one string
  • no-email inputs
  • stray @ symbols
  • documented edge cases

• [pyproject.toml](https://github.com/fossology/safaa/blob/main/pyproject.toml?utm_source=chatgpt.com)
  Add pytest to dev dependencies

Known limitation

The \d{4} year substitution currently runs before email normalization. Emails containing 4+ consecutive digits (for example author5565@example.com) therefore become partially transformed before the email regex executes and no longer match.

This behavior is documented in:

test_email_with_four_plus_digits_known_limitation

A follow-up PR can address this by reordering substitutions.

How to test

poetry install
poetry run pytest tests/test_safaa.py -v

Manual reproduction

from safaa.Safaa import SafaaAgent

agent = SafaaAgent()

print(agent._perform_text_substitutions(["contact john@example.com"]))

Before:

['contact john example com']

After:

['contact EMAIL']

This closes #49.

Note: this PR shares the tests/ scaffolding introduced in #48. Depending on merge order, a small rebase may be needed for tests/__init__.py and the test module header.

[Valyrian-Code]

Hi @GMishx & @Kaushl2208

Hi! I opened a small PR with bug fixe and regression tests. I’d appreciate a review whenever you have time thanks for maintaining the project!

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[GMishx]

@Valyrian-Code I'd really appreciate to not spam with tags at each step. You have just opened the PRs. Someone will come and have a look. Have some patience. Spamming @Valyrian-Code will not help.

[Valyrian-Code]

@GMishx
Understood, my bad. I didn’t mean to spam or rush anyone . I’ll wait patiently for the review. Thanks for pointing it out.