DefStream 0.1.11__tar.gz → 0.1.13__tar.gz

defstream-0.1.13/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,61 @@
+name: 버그/오류 제보
+description: 예상과 다르게 동작하거나 오류가 발생하는 문제를 제보합니다.
+title: "[버그] "
+body:
+  - type: markdown
+    attributes:
+      value: >
+        재현 가능한 버그를 제보해 주세요. 로그나 설정을 첨부할 때 토큰, 비밀번호,
+        개인정보 등 민감한 정보는 반드시 삭제해 주세요.
+  - type: input
+    id: version
+    attributes:
+      label: 버전
+      description: 사용 중인 버전 또는 커밋을 입력해 주세요.
+      placeholder: 예) 0.1.12
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: 기대한 동작
+      description: 어떤 결과를 기대했는지 설명해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: 실제 동작
+      description: 실제로 발생한 결과를 설명해 주세요. 오류가 표시되면 메시지도 포함해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: 재현 방법
+      description: 문제를 재현하는 단계나 최소 코드 예제를 작성해 주세요.
+      placeholder: |
+        1. 다음 설정으로 Worker를 시작합니다.
+        2. 특정 메시지를 전달합니다.
+        3. 오류가 발생합니다.
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: 실행 환경
+      description: Python 버전, 운영체제, 브로커 및 관련 어댑터 버전을 입력해 주세요.
+      placeholder: |
+        - Python:
+        - 운영체제:
+        - 브로커:
+        - 어댑터:
+    validations:
+      required: true
+  - type: textarea
+    id: additional
+    attributes:
+      label: 추가 정보
+      description: 관련 로그나 스크린샷 등 문제 파악에 도움이 되는 정보를 적어 주세요.
+    validations:
+      required: false

defstream-0.1.13/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

defstream-0.1.13/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,36 @@
+name: 기능 제안
+description: DefStream에 추가하거나 개선할 기능을 제안합니다.
+title: "[기능 제안] "
+body:
+  - type: markdown
+    attributes:
+      value: >
+        해결하려는 문제와 제안하는 사용 경험을 중심으로 작성해 주세요.
+  - type: textarea
+    id: problem
+    attributes:
+      label: 해결하려는 문제
+      description: 현재 어떤 불편이나 제약이 있는지 설명해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: 제안하는 해결 방법
+      description: 원하는 기능과 기대하는 동작을 설명해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 고려한 대안
+      description: 고려한 다른 방법이나 우회 방법이 있다면 적어 주세요.
+    validations:
+      required: false
+  - type: textarea
+    id: additional
+    attributes:
+      label: 추가 정보
+      description: 예제, 참고 자료 등 제안의 맥락을 이해하는 데 도움이 되는 정보를 적어 주세요.
+    validations:
+      required: false

defstream-0.1.13/.github/PULL_REQUEST_TEMPLATE/hotfix.md

@@ -0,0 +1,34 @@
+## 핫픽스 요약
+
+<!-- 긴급 수정이 필요한 이유와 해결 내용을 요약해 주세요. -->
+
+## 관련 이슈와 영향 범위
+
+- 관련 이슈:
+- 영향을 받는 버전:
+- 영향받는 사용자·기능:
+- 심각도 및 긴급 배포가 필요한 이유:
+
+## 원인과 수정 내용
+
+<!-- 문제의 원인, 수정 방법, 변경 범위를 작성해 주세요. -->
+
+## 회귀 방지 및 검증
+
+<!-- 재현 테스트와 실행한 검증 결과를 작성해 주세요. 실행하지 못한 검증은 사유를 적어 주세요. -->
+
+- [ ] 문제를 재현하는 회귀 테스트를 추가하거나 기존 테스트로 수정 동작을 확인했습니다.
+- [ ] 관련 테스트를 실행했습니다.
+- [ ] 호환성 및 영향 범위를 확인했습니다.
+
+## 배포·복구 계획
+
+- 배포 시 주의사항:
+- 롤백 또는 복구 방법:
+- 후속 수정이 필요한 경우 관련 이슈:
+
+## 제출 전 확인
+
+- [ ] 수정 범위가 긴급 문제 해결에 필요한 변경으로 한정되어 있습니다.
+- [ ] 오류 로그와 변경 내용을 민감 정보 없이 확인했습니다.
+- [ ] 검증하지 않은 항목을 완료한 것으로 표시하지 않았습니다.

defstream-0.1.13/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,24 @@
+## 변경 내용
+
+<!-- 무엇을 왜 변경했는지 간단히 요약해 주세요. -->
+
+## 변경 유형
+
+- [ ] 버그 수정
+- [ ] 기능 추가
+- [ ] 호환성에 영향을 주는 변경
+- [ ] 문서 또는 예제 변경
+- [ ] 기타
+
+## 검증
+
+<!-- 실행한 테스트와 결과를 작성해 주세요. 테스트를 실행하지 않았다면 사유를 적어 주세요. -->
+
+- [ ] 관련 테스트를 실행했습니다.
+- [ ] 문서와 예제를 확인했습니다.
+
+## 확인 사항
+
+- [ ] 변경 범위가 요청 사항에 한정되어 있습니다.
+- [ ] 공개 API나 기존 동작에 영향을 주는 경우 변경 내용과 마이그레이션 방법을 설명했습니다.
+- [ ] 민감 정보나 불필요한 디버깅 코드를 포함하지 않았습니다.

{defstream-0.1.11 → defstream-0.1.13}/.gitignore

@@ -53,10 +53,8 @@ tmp/
 .git/
 
 # GitHub specific files
-.github/
-!/.github/
-/.github/*
-!/.github/workflows/
+.github/instructions
+.github/instructions/
 
 # GitLab specific files
 .gitlab/

{defstream-0.1.11 → defstream-0.1.13}/DefStream.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.11
+Version: 0.1.13
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon

{defstream-0.1.11 → defstream-0.1.13}/DefStream.egg-info/SOURCES.txt

@@ -3,12 +3,21 @@ LICENSE
 README.en.md
 README.md
 setup.py
+.github/PULL_REQUEST_TEMPLATE.md
+.github/ISSUE_TEMPLATE/bug_report.yml
+.github/ISSUE_TEMPLATE/config.yml
+.github/ISSUE_TEMPLATE/feature_request.yml
+.github/PULL_REQUEST_TEMPLATE/hotfix.md
 .github/workflows/ci.yml
 DefStream.egg-info/PKG-INFO
 DefStream.egg-info/SOURCES.txt
 DefStream.egg-info/dependency_links.txt
 DefStream.egg-info/requires.txt
 DefStream.egg-info/top_level.txt
+issues/bug/16/IMPLEMENTS.md
+issues/bug/16/ISSUE.md
+issues/bug/16/README.md
+issues/bug/16/REQUIREMENTS.md
 issues/feature/1/IMPLEMENTS.md
 issues/feature/1/README.md
 issues/feature/1/REQUIREMENTS.md
@@ -21,6 +30,7 @@ issues/feature/8/ci.refs.json
 issues/fix/10/IMPLEMENTS.md
 issues/fix/10/README.md
 issues/fix/10/REQUIREMENTS.md
+issues/fix/13/README.md
 issues/fix/3/IMPLEMENTS.md
 issues/fix/3/README.md
 issues/fix/3/REQUIREMENTS.md

{defstream-0.1.11 → defstream-0.1.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.11
+Version: 0.1.13
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon

defstream-0.1.13/issues/bug/16/IMPLEMENTS.md

@@ -0,0 +1,32 @@
+# Inspector Console 사용자 지정 Task 이름 버그 수정 기록
+
+## 구현 개요
+
+[요구사항 명세서](./REQUIREMENTS.md)에 따라 Inspector Console이 작업 목록과
+동일한 작업 ID를 사용해 등록된 Task를 찾고, 잘못된 요청의 구체적인 원인을
+경고 로그에서 확인할 수 있도록 수정했다.
+
+## 주요 변경
+
+- `Console.execute()`의 Task 검색과 중복 검사를 모두 `task.__name__`에서
+  `task.name` 비교로 변경했다. 작업 이름을 사용자 지정한 경우에도
+  Specifications 문서와 Console UI가 전달하는 ID로 올바른 Task를 식별한다.
+- 잘못된 입력을 거부하는 경고 로그에 예외 종류와 예외 메시지를 함께 기록한다.
+- `test_inspector_console.py`에 사용자 지정 ID의 발행 성공, 중복 ID 거부,
+  미등록 ID의 오류 로그 내용을 확인하는 회귀 테스트를 추가했다.
+- RabbitMQ·Redis 실서버 테스트의 요청 ID도 실제 등록된 하위 Task의 `Live.name`을
+  사용하도록 했다. 클래스의 `__name__`(`Live`)와 Worker에 등록하는 유효 작업
+  이름은 같다고 가정할 수 없으며, 이전의 하드코딩은 요청을 400으로 거부하게 했다.
+
+## 검증
+
+DefStream 테스트 디렉터리에서 Python 3.12.10으로 다음 명령을 실행했다.
+
+```powershell
+$env:PYTHONIOENCODING = 'utf-8'
+..\..\.venv\Scripts\python.exe -m unittest test_inspector_console test_inspector_logging
+```
+
+Inspector Console 및 로깅 관련 테스트 28개가 통과했고, 선택 통합 테스트 2개는
+건너뛰었다. 변경된 두 Python 파일의 `compile()` 문법 검사와
+`git diff --check`도 통과했다. 브로커 실서버 통합 검증은 수행하지 않았다.

defstream-0.1.13/issues/bug/16/ISSUE.md

@@ -0,0 +1,19 @@
+# Inspector Console에서 사용자 지정 Task 이름으로 요청 시 큐 발행 전에 거부됨
+
+## 버전
+
+0.1.12
+
+## 내용
+
+Inspector Console이 Task 목록에 표시하는 이름과 실제 Task를 찾는 기준이 다릅니다.
+
+Specifications.document()은 task.name을 작업 ID로 사용합니다. Console UI는 이 ID를 선택해 요청을 보내지만, Console.execute()는 등록된 작업을 찾을 때 task.__name__과 요청의 task 값을 비교합니다.
+
+예를 들어 Orbis Split은 Split.name이 ETL.OBS.Split이고 Split.__name__은 Split입니다. 따라서 UI에서 선택한 작업 ID ETL.OBS.Split과 Console의 비교 값 Split이 일치하지 않아 Unknown registered task 오류가 발생합니다. 이 검사는 브로커에 연결하거나 메시지를 발행하기 전에 수행되므로 요청은 큐에 도달하지 않습니다.
+
+또한 Console 경고 로그에는 구체적인 오류 메시지 대신 예외 종류만 기록되어 원인을 파악하기 어렵습니다.
+
+기대 동작: Console이 Task 목록을 만들 때와 동일하게 task.name을 기준으로 작업을 찾아야 합니다. 중복 여부 검사도 같은 기준을 사용해야 합니다.
+
+실제 동작: Console이 task.__name__을 기준으로 작업을 찾아 사용자 지정 이름을 사용하는 Task를 거부합니다.

defstream-0.1.13/issues/bug/16/README.md

@@ -0,0 +1,12 @@
+# Inspector Console 사용자 지정 Task 이름 처리
+
+Inspector Console이 작업 목록에 표시한 ID로 Task를 찾도록 수정했습니다.
+따라서 `ETL.OBS.Split`처럼 클래스 이름과 다른 사용자 지정 Task 이름으로도
+요청을 보낼 수 있습니다. 동일한 작업 ID가 중복 등록된 경우에는 모호한 작업
+실행을 막기 위해 요청을 거부합니다.
+
+잘못된 요청은 기존처럼 거부되며, 경고 로그에 예외 종류와 구체적인 원인이 함께
+기록됩니다.
+
+세부 내용은 [요구사항 명세서](./REQUIREMENTS.md)와
+[구현 및 검증 기록](./IMPLEMENTS.md)을 참고하세요.

defstream-0.1.13/issues/bug/16/REQUIREMENTS.md

@@ -0,0 +1,25 @@
+# Inspector Console의 사용자 지정 Task 이름 처리 요구사항
+
+## 목적
+
+Inspector Console이 Task 목록에 표시한 작업 ID로 등록된 Task를 찾아 실행하도록 한다. Task에 사용자 지정 이름이 지정되어 있어도 요청이 잘못 거부되거나 큐 발행 전에 중단되지 않아야 한다.
+
+## 배경
+
+`Specifications.document()`은 `task.name`을 작업 ID로 사용하고, Console UI는 이 ID를 요청에 포함한다. 그러나 `Console.execute()`는 등록된 작업을 찾을 때 `task.__name__`과 요청의 작업 ID를 비교한다.
+
+예를 들어 `Split.name`이 `ETL.OBS.Split`이고 `Split.__name__`이 `Split`이면, 요청 ID `ETL.OBS.Split`과 비교 값이 달라 `Unknown registered task` 오류가 발생한다. 이 오류는 브로커 연결 및 메시지 발행 전에 발생하므로 요청이 큐에 도달하지 않는다.
+
+## 요구사항
+
+1. Console은 요청의 작업 ID와 등록된 Task의 `task.name`을 비교해 실행할 Task를 찾아야 한다.
+2. 중복 작업 ID 검사도 `task.name`을 기준으로 수행해야 한다. 같은 이름을 가진 등록 Task가 중복으로 허용되어서는 안 된다.
+3. 목록에 표시된 사용자 지정 작업 ID로 요청하면, 해당 Task를 찾지 못했다는 오류로 거부하지 않고 정상적인 실행 절차를 진행해야 한다.
+4. 요청 처리 중 오류가 발생하면 경고 로그에 예외 종류뿐 아니라 구체적인 오류 메시지도 기록해야 한다.
+
+## 완료 기준
+
+- `task.name`과 `task.__name__`이 다른 Task를 목록의 작업 ID로 요청해도 올바른 Task가 선택된다.
+- 중복 검사와 Task 검색이 모두 `task.name`을 기준으로 일관되게 동작한다.
+- 유효한 사용자 지정 작업 ID 요청은 큐 발행 단계까지 진행되며, 해당 요청이 `Unknown registered task` 오류로 중단되지 않는다.
+- 오류 로그에서 예외 종류와 구체적인 원인을 확인할 수 있다.

defstream-0.1.13/issues/fix/13/README.md

@@ -0,0 +1,31 @@
+# Worker 시작 배너와 샘플 로깅 순서
+
+## 변경 요약
+
+Worker 시작 배너를 로깅 설정 여부와 관계없이 먼저 확인할 수 있도록 Worker
+샘플의 로깅 설정 시점을 `WorkerSetup` 훅으로 옮겼습니다. 시작 배너는 터미널에서
+청록·파랑 계열로 강조하며, ASCII 아트의 모양과 문구는 유지합니다.
+
+## 변경 내용
+
+- [Worker 샘플](../../../sample/Worker/Sample.py)은 `configure_logging()`을
+  실행 진입점에서 호출하는 대신 `SetupLogger` setup 훅에서 수행합니다.
+  Worker 생성·작업 등록 시점의 로그는 아직 설정되지 않은 핸들러에 의해 출력되지
+  않으며, 시작 배너가 샘플의 첫 화면 출력이 됩니다.
+- [Startup](../../../src/Worker/Startup.py)은 stdout이 터미널이고 `NO_COLOR`
+  환경 변수가 설정되지 않은 경우에만 로고에 색을 적용합니다. `Starting Worker`
+  제목도 굵은 청록색으로 표시합니다. 파일·파이프 등으로 출력을 리다이렉트하거나
+  `NO_COLOR`를 설정하면 ANSI 색상 코드를 출력하지 않습니다.
+- `Worker.run()`의 로그와 배너 호출 순서는 변경하지 않았습니다. 따라서
+  로깅 핸들러가 미리 설정된 애플리케이션에서는 `Starting Worker` 로그가 배너보다
+  먼저 기록될 수 있습니다. 이 변경은 샘플의 로깅 설정 시점을 조정해 샘플 출력에서
+  배너를 먼저 보이게 합니다.
+
+## 호환성 및 검증 범위
+
+시작 배너의 ASCII 문자와 구성 출력은 유지됩니다. 색상은 터미널 조건에서만
+추가되며 `NO_COLOR`를 통해 끌 수 있습니다.
+
+로고 색상 적용 후 ANSI 코드를 제거한 결과가 원본과 동일한지, 수정한 Python 소스의
+문법이 유효한지 확인했습니다. Worker 시작 테스트는 환경에 `pika`가 없어 실행하지
+못했으며, 샘플의 로깅 순서 변경은 별도 실행으로 검증하지 않았습니다.

{defstream-0.1.11 → defstream-0.1.13}/sample/Worker/RabbitMQ/Client.py

@@ -3,7 +3,7 @@ from random import randint
 from Tasks import (
 	Add,
 	Divide,
-	LoggingSetup,
+	TaskLoggingSetup,
 	logger,
 )
 
@@ -16,7 +16,7 @@ from DefStream.Worker import request
 
 
 if __name__ == '__main__':
-	LoggingSetup()()
+	TaskLoggingSetup()()
 	broker = Connection(Configuration(
 		host='127.0.0.1',
 		port=5672,

{defstream-0.1.11 → defstream-0.1.13}/sample/Worker/RabbitMQ/Tasks.py

@@ -28,9 +28,11 @@ from DefStream.Validator.Patterns.Object import (
 	IsRequiredIn,
 )
 from DefStream.Worker import (
+	WorkerSetup,
 	PoolSetup,
 	Run,
 	Specification,
+	Worker,
 )
 
 __all__ = (
@@ -42,7 +44,27 @@ __all__ = (
 logger = getLogger('Sample')
 
 
-class LoggingSetup(PoolSetup):
+class SetupLogger(WorkerSetup):
+	"""부모와 spawn 자식 프로세스의 샘플 로그 출력을 설정한다."""
+
+	def __call__(
+		self,
+		worker: Worker,
+	) -> None:
+		handler = StreamHandler()
+		handler.setFormatter(Formatter('%(asctime)s %(processName)s %(name)s %(levelname)s %(message)s'))
+		sources = (
+			Filter('Sample'),
+			Filter('DefStream'),
+		)
+		handler.addFilter(lambda record: any(source.filter(record) for source in sources))
+		root = getLogger()
+		root.setLevel(DEBUG)
+		root.addHandler(handler)
+		return
+
+
+class TaskLoggingSetup(PoolSetup):
 	"""부모와 spawn 자식 프로세스의 샘플 로그 출력을 설정한다."""
 
 	def __call__(self) -> None:

{defstream-0.1.11 → defstream-0.1.13}/sample/Worker/RabbitMQ/Worker.py

@@ -7,7 +7,8 @@ from signal import (
 from Tasks import (
 	Add,
 	Divide,
-	LoggingSetup,
+	TaskLoggingSetup,
+	SetupLogger,
 	logger,
 )
 
@@ -76,7 +77,6 @@ class Cleanup(WorkerCleanup):
 
 
 if __name__ == '__main__':
-	LoggingSetup()()
 	worker = Worker(
 		Connection(Configuration(
 			host='127.0.0.1',
@@ -86,9 +86,12 @@ if __name__ == '__main__':
 		)),
 		ProcessPool(
 			10,
-			setups=LoggingSetup(),
+			setups=TaskLoggingSetup(),
+		),
+		setups=(
+			SetupLogger(),
+			Prepare(),
 		),
-		setups=Prepare(),
 		cleanups=Cleanup(),
 		inspector=Inspector(
 			host='127.0.0.1',

{defstream-0.1.11 → defstream-0.1.13}/sample/Worker/Redis/Sample.py

@@ -39,19 +39,6 @@ from DefStream.Worker import (
 logger = getLogger('Sample')
 
 
-def configure_logging() -> None:
-	handler = StreamHandler()
-	handler.setFormatter(Formatter('%(asctime)s %(name)s %(levelname)s %(message)s'))
-	sources = (
-		Filter('Sample'),
-		Filter('DefStream'),
-	)
-	handler.addFilter(lambda record: any(source.filter(record) for source in sources))
-	root = getLogger()
-	root.setLevel(DEBUG)
-	root.addHandler(handler)
-	return
-
 
 class Add(
 	Run,
@@ -96,6 +83,24 @@ class Divide(
 		return result
 
 
+class SetupLogger(WorkerSetup):
+	def __call__(
+		self,
+		worker: Worker,
+	) -> None:
+		handler = StreamHandler()
+		handler.setFormatter(Formatter('%(asctime)s %(name)s %(levelname)s %(message)s'))
+		sources = (
+			Filter('Sample'),
+			Filter('DefStream'),
+		)
+		handler.addFilter(lambda record: any(source.filter(record) for source in sources))
+		root = getLogger()
+		root.setLevel(DEBUG)
+		root.addHandler(handler)
+		return
+
+
 class Prepare(WorkerSetup):
 	def __call__(
 		self,
@@ -139,11 +144,13 @@ class Cleanup(WorkerCleanup):
 
 
 def main() -> None:
-	configure_logging()
 	worker = Worker(
 		Connection(Configuration()),
 		ThreadPool(10),
-		setups=Prepare(),
+		setups=(
+			SetupLogger(),
+			Prepare(),
+		),
 		cleanups=Cleanup(),
 		inspector=Inspector(
 			host='127.0.0.1',

{defstream-0.1.11 → defstream-0.1.13}/sample/Worker/Sample.py

@@ -35,19 +35,6 @@ from DefStream.Worker import (
 logger = getLogger('Sample')
 
 
-def configure_logging() -> None:
-	handler = StreamHandler()
-	handler.setFormatter(Formatter('%(asctime)s %(name)s %(levelname)s %(message)s'))
-	sources = (
-		Filter('Sample'),
-		Filter('DefStream'),
-	)
-	handler.addFilter(lambda record: any(source.filter(record) for source in sources))
-	root = getLogger()
-	root.setLevel(DEBUG)
-	root.addHandler(handler)
-	return
-
 
 class Queue(Sendable):
 	def __init__(self):
@@ -219,6 +206,24 @@ class Add(
 		)
 
 
+class SetupLogger(WorkerSetup):
+	def __call__(
+		self,
+		worker: Worker,
+	) -> None:
+		handler = StreamHandler()
+		handler.setFormatter(Formatter('%(asctime)s %(name)s %(levelname)s %(message)s'))
+		sources = (
+			Filter('Sample'),
+			Filter('DefStream'),
+		)
+		handler.addFilter(lambda record: any(source.filter(record) for source in sources))
+		root = getLogger()
+		root.setLevel(DEBUG)
+		root.addHandler(handler)
+		return
+
+
 class Prepare(WorkerSetup):
 	def __call__(
 		self,
@@ -252,12 +257,16 @@ class Cleanup(WorkerCleanup):
 
 
 if __name__ == '__main__':
-	configure_logging()
 	worker = Worker(
 		Broker(),
 		ThreadPool(1),
-		setups=Prepare(),
-		cleanups=Cleanup(),
+		setups=(
+			SetupLogger(),
+			Prepare(),
+		),
+		cleanups=(
+			Cleanup(),
+		),
 	)
 	worker.add(Add)
 	worker.run()

{defstream-0.1.11 → defstream-0.1.13}/src/Inspector/Extensions/Console.py

@@ -323,13 +323,13 @@ class Console(Extension):
 			)
 			task = next(
 				(
-					task for task in worker.tasks if task.__name__ == payload['task']
+					task for task in worker.tasks if task.name == payload['task']
 				),
 				None,
 			)
 			if task is None:
 				raise ValueError('Unknown registered task')
-			if sum(task.__name__ == payload['task'] for task in worker.tasks) != 1:
+			if sum(task.name == payload['task'] for task in worker.tasks) != 1:
 				raise ValueError('Ambiguous registered task name')
 		except (
 			ValueError,
@@ -337,8 +337,9 @@ class Console(Extension):
 			UnicodeDecodeError,
 		) as error:
 			self.logger.warning(
-				'Inspector Console rejected invalid input: error=%s',
+				'Inspector Console rejected invalid input: error=%s message=%s',
 				type(error).__name__,
+				error,
 			)
 			return json_response(
 				'400 Bad Request',

{defstream-0.1.11 → defstream-0.1.13}/src/Worker/Startup.py

@@ -1,5 +1,6 @@
 from collections.abc import Mapping
-from os import getpid
+from os import environ, getpid
+import sys
 from typing import (
 	Any,
 	TYPE_CHECKING,
@@ -19,9 +20,42 @@ LOGO = r"""
 ███  ███ ▄█▀█▄ ▀██▀  ▀████▄  ▀██▀▀ ████▄ ▄█▀█▄  ▀▀█▄ ███▄███▄ 
 ███  ███ ██▄█▀  ██     ▀████  ██   ██ ▀▀ ██▄█▀ ▄█▀██ ██ ██ ██ 
 ██████▀  ▀█▄▄▄  ██  ███████▀  ██   ██    ▀█▄▄▄ ▀█▄██ ██ ██ ██ 
+
+Just def. Let workers do the work. You don't need to await this.
 """
 
 
+def supports_color() -> bool:
+	return (
+		getattr(sys.stdout, 'isatty', lambda: False)()
+		and not environ.get('NO_COLOR')
+	)
+
+
+def colorize_logo(logo: str) -> str:
+	colors = (
+		'\033[38;5;39m',
+		'\033[38;5;45m',
+		'\033[38;5;51m',
+		'\033[38;5;45m',
+		'\033[38;5;39m',
+	)
+	reset = '\033[0m'
+	colorized_lines = []
+	art_line = 0
+	for line in logo.splitlines(keepends=True):
+		if line.strip() and art_line < len(colors):
+			newline = '\n' if line.endswith('\n') else ''
+			colorized_lines.append(
+				f'{colors[art_line]}{line[:-1] if newline else line}'
+				f'{reset}{newline}',
+			)
+			art_line += 1
+		else:
+			colorized_lines.append(line)
+	return ''.join(colorized_lines)
+
+
 def subscription_value(
 	parameters: Any,
 	name: str,
@@ -90,10 +124,15 @@ def startup(worker: 'Worker') -> None:
 			str,
 		) and vhost:
 			broker_name += '/' + vhost.lstrip('/')
+	logo = LOGO.rstrip()
+	starting_worker = 'Starting Worker'
+	if supports_color():
+		logo = colorize_logo(logo)
+		starting_worker = f'\033[1;38;5;51m{starting_worker}\033[0m'
 	lines = [
-		LOGO.rstrip(),
+		logo,
 		'',
-		'Starting Worker',
+		starting_worker,
 		f'  PID: {getpid()}',
 		f'  Broker: {broker_name}',
 	]

{defstream-0.1.11 → defstream-0.1.13}/test/test_inspector_console.py

@@ -57,6 +57,19 @@ class Task(
 		return a / b
 
 
+class NamedTask(
+	Run,
+	run_name='ETL.OBS.Split',
+	parameters={'queue': 'named-task'},
+):
+	def run(
+		self,
+		a,
+		b,
+	):
+		return a / b
+
+
 class Producer:
 	def __init__(self):
 		self.connected = 0
@@ -168,7 +181,7 @@ class ConsoleExtensionTests(TestCase):
 		mode='send',
 	):
 		return {
-			'task': 'Task',
+			'task': Task.name,
 			'mode': mode,
 			'body': {
 				'a': 6,
@@ -459,6 +472,47 @@ class ConsoleExtensionTests(TestCase):
 		self.worker.broker.connect.assert_not_called()
 		self.worker.broker.close.assert_not_called()
 
+	def test_custom_task_name_is_resolved_and_duplicate_names_are_rejected(self):
+		self.worker.add(NamedTask)
+		payload = self.payload()
+		payload['task'] = NamedTask.name
+		status, body, headers = self.fetch(
+			'POST',
+			payload,
+		)
+		self.assertEqual(status, 200)
+		self.assertEqual(loads(body)['result'], 'message-id')
+		self.assertEqual(self.producers[-1].sent[0][1], NamedTask.parameters)
+
+		self.worker.tasks.append(NamedTask)
+		with self.assertLogs(
+			'DefStream.Inspector.Extensions.Console',
+			level='WARNING',
+		) as logs:
+			status, body, headers = self.fetch(
+				'POST',
+				payload,
+			)
+		self.assertEqual(status, 400)
+		self.assertEqual(loads(body)['error'], 'Ambiguous registered task name')
+		self.assertIn('message=Ambiguous registered task name', logs.output[0])
+
+	def test_invalid_task_warning_includes_the_specific_error(self):
+		payload = self.payload()
+		payload['task'] = 'not-registered'
+		with self.assertLogs(
+			'DefStream.Inspector.Extensions.Console',
+			level='WARNING',
+		) as logs:
+			status, body, headers = self.fetch(
+				'POST',
+				payload,
+			)
+		self.assertEqual(status, 400)
+		self.assertIn('error=ValueError', logs.output[0])
+		self.assertIn('message=Unknown registered task', logs.output[0])
+		self.assertEqual(self.producers, [])
+
 	def test_unsupported_rpc_and_worker_not_running(self):
 		self.extension.broker = Producer
 		self.assertFalse(loads(self.fetch()[1])['rpc'])
@@ -768,7 +822,7 @@ class ConsoleExtensionTests(TestCase):
 					rpc,
 				)
 				payload = self.payload()
-				payload['task'] = 'Live'
+				payload['task'] = Live.name
 				self.assertEqual(
 					self.fetch(
 						'POST',

{defstream-0.1.11 → defstream-0.1.13}/test/test_logging.py

@@ -274,7 +274,7 @@ class LoggingTests(TestCase):
 		try:
 			spec.loader.exec_module(sample)
 			self.assertEqual(root.handlers, handlers)
-			sample.configure_logging()
+			sample.SetupLogger()(Mock())
 			handler = root.handlers[-1]
 			for name, expected in (
 				(