coalition.stakeholders.validators
=================================

.. py:module:: coalition.stakeholders.validators


Classes
-------

.. autoapisummary::

   coalition.stakeholders.validators.AddressValidator


Module Contents
---------------

.. py:class:: AddressValidator

   Utility class for validating and normalizing address components


   .. py:attribute:: US_STATES


   .. py:attribute:: ZIP_CODE_PATTERN


   .. py:method:: validate_state(state: str) -> str
      :classmethod:


      Validate and normalize US state abbreviation



   .. py:method:: validate_zip_code(zip_code: str) -> str
      :classmethod:


      Validate and normalize ZIP code format



   .. py:method:: validate_street_address(street_address: str) -> str
      :classmethod:


      Validate and normalize street address



   .. py:method:: validate_city(city: str) -> str
      :classmethod:


      Validate and normalize city name



   .. py:method:: validate_complete_address(street_address: str, city: str, state: str, zip_code: str) -> dict[str, str]
      :classmethod:


      Validate a complete address and return normalized components



   .. py:method:: format_address(street_address: str | None = None, city: str | None = None, state: str | None = None, zip_code: str | None = None) -> str
      :classmethod:


      Format address components into a standardized address string