PyInterceptor로 API 분석

PyInterceptor: 비침습적 분석을 위한 Python 함수 호출 인터셉터

PyInterceptor는 비침습적 가로채기와 함수 호출 분석을 위해 설계되어 현재 개발 중인 Python 라이브러리(GitHub에서 사용 가능)입니다. 기존 코드를 수정하지 않고 Python API와 상호 작용하는 Python 클라이언트에서 함수 이름, 매개변수, 반환 값, 실행 시간 등의 세부 정보가 필요하다고 상상해 보세요. PyInterceptor는 이러한 요구를 해결합니다.

이 dev.to 기사에서는 PyInterceptor의 핵심 개념, 사용 사례 및 애플리케이션을 소개합니다.

Python 호출 차단 및 처리

핵심 원칙

그림 1 — 통화 차단 개요: 차단 및 비차단 차단

함수 호출 가로채기는 차단과 비차단이라는 두 가지 범주로 나뉩니다(그림 1). 차단 차단은 통화 정보를 캡처하고 대상 기능을 실행하지 않고 없이 즉시 반환합니다. 이는 단위 테스트 중에 모의 또는 스텁을 만드는 데 유용합니다. 비차단 차단은 정보를 수집한 다음 그런 다음 대상 함수를 실행하고 진행하기 전에 반환 값을 캡처합니다. PyInterceptor는 두 모드를 모두 지원합니다.

사용 사례

Python API 호출 차단은 다양한 애플리케이션을 제공합니다.

• 자동 모의/스텁 생성: 차단 모드를 활용하여 단위 테스트를 위한 모의 및 스텁을 반자동으로 생성합니다. PyInterceptor는 시뮬레이션된 데이터를 반환하기 위한 사용자 정의 인터셉터 호출 가능을 허용합니다.
• 구조적 로깅: 가로채는 인수와 메타데이터를 로깅 시스템으로 전달합니다.
• 향상된 디버깅: 함수 호출과 해당 매개변수를 추적하여 버그를 더욱 효율적으로 찾아냅니다.
• 통화 통계 생성: 성능 지표를 수집합니다.
• 그 외…

세부 구현

그림 2 — 세부정보: handler() 함수 및 인터셉터() 호출 가능 포함

PyInterceptor는 API용 호출을 가로채는 핸들러 함수를 삽입하여 작동합니다. 이 핸들러는 메타데이터(인수, 타임스탬프 등)를 캡처하여 CallInfo 개체에 저장하고 착신 전환을 관리합니다.

차단 모드에서 핸들러는 CallInfo를 사용자 정의 인터셉터 호출 가능으로 전달합니다. 이 콜러블은 정보(로깅, 통계 등)를 처리합니다. 그런 다음 핸들러는 인터셉터의 결과를 반환합니다.

비차단 모드에서 핸들러는 대상 함수를 실행하고 그 반환 값을 CallInfo에 추가한 다음 인터셉터를 호출합니다. 블로킹 모드와 달리 실제 타겟 함수의 반환 값이 호출자에게 반환됩니다.

설명 코드 예시

이 예에서는 산술 API 및 프로세서 클래스와 함께 PyInterceptor를 사용하여 모든 메소드 호출을 JSON 파일에 기록하는 방법을 보여줍니다.

import json
from pathlib import Path
from typing import List

from interceptor import intercept, get_methods, CallInfo


class API:
    # ... (API methods remain unchanged) ...


class Processor:
    # ... (Processor methods remain unchanged) ...


class JSONLogger:
    # ... (JSONLogger class remains unchanged) ...


if __name__ == '__main__':
    # ... (Main method remains unchanged) ...

메인 메소드는 JSONLogger 인스턴스(인셉터 역할)를 생성하고, intercept()을 사용하여 API 및 프로세서 메소드를 가로채고, 프로세서 메소드를 실행하고, 로그를 "logs.json"에 저장합니다. JSON 출력에는 각 함수 호출에 대한 자세한 기록이 포함되어 있습니다.

향후 개선사항

PyInterceptor에 대한 개선 계획은 다음과 같습니다.

• 포괄적인 API 문서 및 CI/CD 파이프라인.
• 간소화된 클래스/메서드 가로채기를 위한 Python 데코레이터.
• 메모리 사용량 관리를 위한 구성 옵션(CallInfo 데이터 복사 및 참조).
• 일반적인 사용 사례를 위해 사전 구축된 인터셉터 구현

귀하의 의견을 환영합니다! 이 글이 도움이 되었거나 향후 개발을 위한 제안 사항이 있으면 댓글을 남겨주세요.

위 내용은 PyInterceptor로 API 분석의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!