Repository navigation
Releases
0.1.32
0.1.31
변경 사항
- Worker 관련 모듈을
JustStream.Worker하위 패키지에서JustStream루트로 옮겼습니다. - 공개 API는
from JustStream import Worker, Run, ThreadPool, ...로 가져옵니다.from JustStream.Worker import ...는 더 이상 동작하지 않습니다. JustStream.Worker.Message등 내부 모듈 경로는JustStream.Message등으로 바뀝니다.
마이그레이션
from JustStream.Worker import X를 from JustStream import X로 바꾸세요. 호환 별칭은 제공하지 않습니다.
0.1.30
변경 로그
새 버전 릴리스 노트가 changes/<커밋 SHA> 이름의 annotated tag 메시지로 작성됩니다. 푸시하거나 PR을 병합하기 전에 해당 태그를 출발 저장소에 올려 주세요. 자세한 절차는 패키징 문서를 참고하세요.
0.1.29
master 직접 push
- 테스트 실행 스크립트 수정 (e009e49)
0.1.28
개발 자동화 변경
DefStream의 런타임 동작, 공개 API와 설치 방법은 변경되지 않습니다. GitHub 에이전트가 저장소의 공통·프로젝트 지침을 확인하고 이슈별 변경 로그를 빠뜨리지 않도록 안내를 추가했습니다.
- 공통 에이전트 지침을
.instructions.assistant/에서 확인합니다. - 이슈 PR의 제목과 본문은
IR.md를 사용합니다. 기존 이슈 브랜치에도 이 문서가 필요합니다. copilot/**,codex/**의 열린 PR은 변경 파일에서 이슈IR.md하나를 찾아 갱신합니다.- PR 본문의 마지막
Changes:항목으로 이슈·비이슈 변경 로그를 지정할 수 있습니다. Changes:항목은 들여쓰지 않고 작성해야 합니다. 앞에 공백이 1~3칸 있으면 오류가 발생합니다.- PR 자동화는 변경 로그로 심볼릭 링크 대신 비어 있지 않은 일반 파일을 요구합니다.
에이전트의 기존 브랜치에는 변경된 워크플로가 포함되어야 합니다. 이슈 문서가 없거나 여러 개면 갱신이 실패하며, 에이전트의 이후 PR 본문 수정은 자동화 결과를 덮어쓸 수 있습니다.
마지막 줄이 네 칸 이상 또는 탭으로 들여쓰기된 경우 기존처럼 브랜치 경로를 사용합니다. 이때 중첩 목록과 코드 예시는 구분하지 않습니다.
0.1.27
변경 로그
고객 영향 없음. RabbitMQ Consumer의 기존 복구 지원 계약을 상속 선언에 명시했으며, 사용 방법과 복구 가능 오류 분류는 변경되지 않습니다. 별도의 설정 변경이나 전환 작업은 필요하지 않습니다.
0.1.26
연결 타이머 등록과 취소
추가된 기능
RabbitMQ 연결에서 set_timer(cb, seconds)로 일회성 콜백을 예약하고,
반환된 Timer의 remove()로 취소할 수 있습니다.
호출자는 Pika 연결이나 내부 타이머 ID를 직접 다루지 않아도 됩니다.
SetTimer는 연결의 선택적 기능이며, Timer, TimerCallback과 함께
DefStream.Broker 및 DefStream.Broker.Connection에서 import할 수 있습니다.
반복 실행은 콜백에서 다음 타이머를 등록하는 방식으로 구성합니다.
실행 가능한 타이머 샘플에서
취소와 재등록을 확인할 수 있습니다. 기존 Stream 샘플의 소비 중단도
외부 스레드 타이머 대신 연결 타이머를 사용합니다.
사용 조건
- 지연 시간은 등록 시점부터 정수 초 단위로 지정합니다.
- RabbitMQ 소비 루프 등 Pika의 이벤트 처리가 진행되어야 콜백이 실행됩니다.
- 등록·취소는 연결 소유 스레드에서 수행하며, 긴 이벤트 처리로 실행이 지연될 수 있습니다.
- Consumer 종료 시 예약을 자동 취소하지 않습니다. 취소 시점과 연결의 사용 순서는 호출자가 관리합니다.
- 중복 취소·종료된 연결·음수·0초 등의 동작과 오류는 기반 Pika API를 따릅니다.
- Redis 타이머 지원이나 기존 Consumer·Worker API 변경은 포함하지 않습니다.
자세한 사용법은 RabbitMQ 연결 타이머 안내를 참고하세요.
0.1.25
Worker 메시지 발행·요청 재시도
emit()과 request()에 retry와 interval 옵션을 추가했습니다. 기본 설정은 기존처럼 한 번만 호출하며, 재시도 횟수를 설정하면 실패한 브로커 호출을 지정 횟수까지 다시 시도합니다. request()의 timeout은 각 호출에 적용됩니다.
브로커 호출에서 발생한 RemoteError를 포함한 예외도 재시도 대상입니다. 원격 작업이 이미 실행된 뒤 오류 응답을 받은 요청도 다시 실행될 수 있으므로, 중복 요청이나 부작용에 안전한 작업에만 재시도를 설정하세요.
interval은 0 이상 threading.TIMEOUT_MAX초 이하로 제한합니다. 지나치게 큰 간격은 브로커 호출 전에 ValueError로 거부하여 대기 중 오버플로가 브로커 오류를 가리는 상황을 방지합니다.
0.1.24
고객 영향 없음
이번 변경은 DefStream의 공개 API나 고객 실행 동작을 변경하지 않습니다. RabbitMQ·Redis용 Docker Compose 구성과 테스트 연결 설정만 추가하여 개발 환경과 GitHub Actions의 브로커 통합 테스트를 지원합니다.
0.1.23
브로커 구현체 설치 격리
로컬 빌드 명령
배포 파일을 직접 만들 때는 python .github/scripts/build_distributions.py를, 빌드 결과를 확인할 때는 python .github/scripts/check_distributions.py를 사용하세요. 실행 위치는 저장소 루트이며 자세한 옵션은 설치 매뉴얼을 참고하세요. 일반 설치와 개발용 설치 명령은 변경되지 않습니다.
editable 갱신 안정성
개발용 설치에서 일부 파일 연결 교체 후 실패하면 재시도에 성공해도 이전 코드가 실행될 수 있던 문제를 수정했습니다. 연결 교체 전에 해당 실행 캐시를 정리하며, 실패 원인을 해결한 뒤 원하는 EXTRAS로 다시 실행하는 절차는 유지됩니다.
개발용 설치 도중 일부 파일 연결 후 실패했을 때, 코어만 선택해도 구현체 코드가 남던 문제를 수정했습니다. 원인을 해결하고 원하는 목록으로 재실행하면 남은 파일을 정리하거나 필요한 연결을 완성합니다.
소스 교체·선택 변경 시 변경 없는 코어 파일까지 일시적으로 사라지던 문제를 수정했습니다. 변경 파일만 원자적으로 교체하며 .DS_Store 같은 미관리 파일이 있어도 선택 해제를 완료하고 해당 파일은 보존합니다. 전체 트리의 일괄 전환이나 실행 중 모듈의 자동 재로딩을 보장하지는 않습니다.
설치 방식
기본 DefStream 설치에는 공통 코드만 포함됩니다. RabbitMQ/Redis 구현체는 선택한 extra에 해당하는 별도 배포물로 설치되며 기존 import 경로를 유지합니다.
python -m pip install "DefStream[RabbitMQ]"코어와 구현체는 동일 버전을 사용합니다. extra를 생략해 재설치해도 기존 구현체가 자동 제거되지는 않습니다.
개발 시 pip install -e . --config-settings EXTRAS=RabbitMQ,Redis 한 번으로 현재 로컬 소스의 코어와 선택 브로커를 갱신합니다. 환경변수나 코어 선행 설치는 필요하지 않습니다. 목록은 매번 교체되며 pip install -e .만 실행하면 기존 선택을 해제하고 코어만 남깁니다. 선택에서 빠진 외부 라이브러리는 자동 삭제하지 않습니다. 새 파일 추가·패키징 변경 후에는 원하는 목록으로 재실행하세요.
소스 코드를 수정하는 개발용 설치 절차와 sdist의 공통 소스 포함 범위는 설치 매뉴얼을 참고하세요.
개발용 설치는 가상환경별로 공통 코드와 선택 구현체만 연결하여 IDE에서도 코드를 찾을 수 있습니다. 직접 링크를 만들 필요가 없습니다. Windows의 하드 링크 사용 시 소스와 가상환경은 같은 드라이브에 있어야 합니다.