
flanker
이메일 파싱을 위한 오픈 소스 Python 라이브러리
오픈 소스 무료 Python API를 통해 이메일 주소를 파싱하고, 주소를 검증하며, MIME 메시지를 파싱합니다.
flanker란 무엇인가요?
flanker는 Mailgun에서 개발한 오픈 소스 Python 라이브러리로, 이메일 주소와 MIME 메시지를 파싱합니다. 이 라이브러리는 이메일 주소 검증, 복잡한 주소 목록 파싱, MIME 메시지에서 구조화된 데이터를 추출하기 위한 강력한 도구를 제공합니다. 프로덕션 사용을 위해 설계된 flanker는 Python 2.7과 Python 3.6+를 모두 지원하여 메일 처리 파이프라인, CRM 통합, 알림 시스템 등 이메일 중심 애플리케이션을 구축하는 개발자에게 이상적입니다.
이 라이브러리는 두 개의 핵심 모듈로 구성됩니다: 이메일 주소 파싱 및 검증을 위한 `flanker.addresslib`와 MIME 메시지 파싱을 위한 `flanker.mime`. 엄격 및 관대 파싱 모드, DNS/MX 레코드 검증, 상세 오류 보고를 지원합니다. 깔끔한 API와 최소한의 의존성으로, flanker는 외부 바이너리나 복잡한 의존성에 의존하지 않고도 개발자가 이메일 데이터를 신뢰성 있게 처리할 수 있게 합니다. Mailgun 인프라에서 광범위하게 사용되어 고볼륨 환경에서도 안정성과 성능을 보장합니다.
flanker 시작하기
flanker를 시작하려면 먼저 Python 헤더를 설치해야 합니다. Ubuntu에서는 `sudo apt-get install python-dev`를 실행하고, Fedora에서는 `sudo yum install python-devel`를 사용합니다. 그런 다음 pip로 설치합니다: `pip install flanker`. 또는 [flanker GitHub](https://github.com/mailgun/flanker) 저장소를 클론하고 `pip install -e .`를 실행합니다. 이 라이브러리는 가볍고 의존성이 최소이며 프로덕션 사용에 준비되어 있습니다. 자세한 문서와 API 참조는 프로젝트의 GitHub 저장소에서 확인할 수 있습니다.
PIP 또는 GitHub를 통해 flanker 설치
# Ubuntu: install Python headers
sudo apt-get install python-dev
# Install via pip
pip install flanker
# Or clone and install from GitHub
git clone git@github.com:mailgun/flanker.git
cd flanker
pip install -e .
이메일 주소 파싱 및 검증
flanker는 이메일 주소를 파싱하고 검증하기 위한 강력한 도구를 제공합니다. 표시 이름이 포함된 단일 주소를 파싱하고, DNS/MX 레코드를 검증하며, ESP 문법 규칙을 확인할 수 있습니다. 라이브러리는 엄격 모드와 관대 모드를 지원하며, 잘못된 입력에 대해 파싱된 주소 또는 `None`을 반환할 수 있습니다. 또한 주소 목록을 처리하여 파싱된 주소와 파싱할 수 없는 조각을 별도로 반환합니다. 이는 사용자 입력을 정리하고, 대량 가져오기를 검증하며, 이메일 기반 워크플로우에서 데이터 무결성을 보장하는 데 이상적입니다.
Python으로 이메일 주소를 파싱하고 검증하는 방법?
from flanker.addresslib import address
# Parse single address with display name
addr = address.parse('John Doe <john@example.com>')
print(addr) # John Doe <john@example.com>
# Validate with DNS/MX checks
valid = address.validate_address('john@mailgun.com')
print(valid) # john@mailgun.com
# Parse list and separate valid/unparseable
parsed, failed = address.parse_list(['john@example.com, @invalid'], as_tuple=True)
print(parsed, failed) # [john@example.com], ['@invalid']
MIME 메시지 파싱
flanker의 MIME 파싱 모듈(`flanker.mime`)은 개발자가 원시 이메일 메시지를 구조화된 Python 객체로 파싱할 수 있게 합니다. 헤더를 추출하고, 본문을 디코딩하며, 콘텐츠 유형을 감지하고, 멀티파트 구조를 손쉽게 탐색할 수 있습니다. 이 라이브러리는 인코딩, 문자셋 변환 및 중첩된 MIME 파트를 자동으로 처리합니다. `is_multipart()` 및 `is_singlepart()`와 같은 프레디케이트를 사용하면 메시지 구조를 프로그래밍적으로 검사하고 각 파트를 적절히 처리할 수 있어, 이메일 클라이언트, 아카이빙 시스템, 자동 처리 파이프라인 구축에 이상적입니다.
MIME 메시지를 파싱하고 헤더 및 본문을 추출하는 방법?
from flanker import mime
# Parse raw MIME message
msg = mime.from_string(raw_message)
# Extract headers
headers = msg.headers.items()
# Check content type
is_multipart = msg.content_type.is_multipart()
# Decode body (handles multipart automatically)
for part in msg.parts:
print(f"Content-Type: {part.content_type}")
print(f"Body: {part.body}")
헤더 및 메타데이터 추출
flanker는 MIME 파싱 API를 통해 이메일 헤더와 메타데이터에 대한 풍부한 접근성을 제공합니다. 헤더는 Unicode 다중값 사전으로 반환되며, 대소문자 구분 없는 조회와 구조화된 값(예: `Content-Type`이 유형과 파라미터로 파싱됨)을 지원합니다. 발신자, 수신자, 제목, 날짜 및 사용자 정의 헤더를 손쉽게 가져올 수 있습니다. 이는 이메일 인덱싱, 스팸 필터링, 규정 준수 감사, 그리고 정확한 헤더 파싱이 중요한 검색 친화적인 이메일 아카이브 구축에 특히 유용합니다.
Python을 사용하여 이메일 헤더와 메타데이터를 추출하는 방법?
from flanker import mime
msg = mime.from_string(raw_message)
# Get all headers as list of tuples
for key, value in msg.headers.items():
print(f"{key}: {value}")
# Access structured content-type
ctype = msg.content_type
print(f"Type: {ctype.type}, Boundary: {ctype.boundary}")
# Get raw header value
raw_from = msg.headers.get('From')
print(raw_from) # Bob <bob@example.com>
멀티파트 메시지 및 첨부 파일 처리
flanker는 중첩된 파트와 첨부 파일을 포함한 복잡한 멀티파트 메시지를 다루는 작업을 단순화합니다. `msg.parts`를 반복하여 각 MIME 파트를 접근하고, 콘텐츠 타입을 검사하며, 본문을 디코딩할 수 있습니다. 이 라이브러리는 base64 및 quoted-printable 디코딩, 문자셋 변환, 경계 감지를 자동으로 처리합니다. 이를 통해 text/plain 및 text/html 버전을 쉽게 추출하고, 첨부 파일을 저장하거나, 전달 또는 보관을 위해 메시지를 재구성할 수 있어 이메일 클라이언트, 백업 도구, 컴플라이언스 시스템에 이상적입니다.
멀티파트 메시지를 처리하고 첨부 파일을 추출하는 방법?
from flanker import mime
msg = mime.from_string(raw_message)
# Iterate over parts
for part in msg.parts:
if part.content_type.is_text():
print(f"Text part: {part.body}")
elif part.content_type.is_attachment():
filename = part.content_type.filename
payload = part.body
print(f"Attachment: {filename}, size: {len(payload)}")
