danielfm/pybreaker

어떤 프로젝트인가요?

핵심 기능

• 01실패 임계값과 재설정 시간 설정
• 02타입 또는 callable을 기준으로 비즈니스 예외를 실패 횟수 집계에서 제외
• 03Circuit breaker마다 여러 이벤트 리스너 등록
• 04제너레이터 함수 보호
• 05선택적 Redis 기반 상태 저장
• 06비동기 Tornado 호출 선택적 지원

활용 사례

• 데이터베이스를 사용할 수 없을 때 연쇄 장애를 막도록 데이터베이스 호출 보호
• 불안정한 서드파티 HTTP API 호출을 빠르게 실패 처리
• 프로덕션 서비스에서 회로 상태 변경 기록 또는 알림

빠른 시작

1. 1

   PyPI에서 PyBreaker를 설치합니다

   pip install pybreaker
2. 2

   CircuitBreaker를 생성하고 함수에 적용합니다

사용 전 알아둘 점

• !Python 3.10 이상이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

pybreaker은(는) 무엇인가요?

실패하는 의존성에 대한 호출을 차단해 시스템의 나머지 부분을 보호하는 Circuit Breaker 패턴의 Python 구현입니다. PyBreaker는 데이터베이스, 큐, 외부 서비스 등 안정적이지 않은 연동 지점에 대한 호출을 감쌉니다. 연속 실패 횟수가 설정한 한도에 도달하면 회로가 열리고, 이후 호출은 고장 난 의존성의 응답을 기다리는 대신 즉시 실패합니다. 재설정 시간이 지나면 다음 호출을 통과시켜 의존성이 복구되었는지 확인합니다.

pybreaker은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

pybreaker은(는) BSD-3-Clause 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

pybreaker은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. pybreaker의 마지막 커밋은 2026년 9월 25일입니다.

pybreaker은(는) 어디에 사용할 수 있나요?

데이터베이스를 사용할 수 없을 때 연쇄 장애를 막도록 데이터베이스 호출 보호 불안정한 서드파티 HTTP API 호출을 빠르게 실패 처리 프로덕션 서비스에서 회로 상태 변경 기록 또는 알림

pybreaker는 어떻게 설치하나요?

PyPI에서 PyBreaker를 설치합니다: pip install pybreaker CircuitBreaker를 생성하고 함수에 적용합니다

pybreaker은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/danielfm/pybreaker