DefStream 0.1.10__tar.gz → 0.1.11__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.10
+Version: 0.1.11
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon
@@ -571,6 +571,8 @@ class Add(
 - `format`의 기본값은 `application/json`입니다. 문서의 미디어 타입만 바꾸며 브로커 코덱은 별도 설정입니다.
 - Run의 `name`은 AsyncAPI Operation 키와 Metrics 작업 키에 함께 사용합니다.
   생략하면 `모듈명.__qualname__`을 사용하며, Run의 `description`은 AsyncAPI Operation에 표시됩니다.
+  명시적 이름은 `[A-Za-z0-9_.-]+` 형식이며 공백·한국어는 허용하지 않습니다.
+  대소문자와 입력값을 그대로 보존합니다.
 - 실행 순서는 초기화 훅 → 요청 검증 → `run()` → 응답 검증 → 완료 훅 → 응답 발행·ACK입니다.
 
 검증 예외는 작업 실패로 처리되어 오류 훅과 `on_error` 정책을 따릅니다.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.10
+Version: 0.1.11
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon
@@ -571,6 +571,8 @@ class Add(
 - `format`의 기본값은 `application/json`입니다. 문서의 미디어 타입만 바꾸며 브로커 코덱은 별도 설정입니다.
 - Run의 `name`은 AsyncAPI Operation 키와 Metrics 작업 키에 함께 사용합니다.
   생략하면 `모듈명.__qualname__`을 사용하며, Run의 `description`은 AsyncAPI Operation에 표시됩니다.
+  명시적 이름은 `[A-Za-z0-9_.-]+` 형식이며 공백·한국어는 허용하지 않습니다.
+  대소문자와 입력값을 그대로 보존합니다.
 - 실행 순서는 초기화 훅 → 요청 검증 → `run()` → 응답 검증 → 완료 훅 → 응답 발행·ACK입니다.
 
 검증 예외는 작업 실패로 처리되어 오류 훅과 `on_error` 정책을 따릅니다.

{defstream-0.1.10 → defstream-0.1.11}/README.en.md

@@ -507,6 +507,8 @@ class Add(
 - `format` defaults to `application/json`. It changes documented media types, not broker codecs.
 - Run's `name` is used as both the AsyncAPI Operation key and the Metrics task key.
   When omitted, `module.__qualname__` is used; Run's `description` appears on the AsyncAPI Operation.
+  Explicit names must match `[A-Za-z0-9_.-]+`; whitespace and Korean characters are not allowed.
+  Names are case-sensitive and preserved exactly as provided.
 - Execution order: setup hooks → request validation → `run()` → response validation → completion hooks → reply/ACK.
 
 Validation exceptions are task failures and follow error hooks and the `on_error`

{defstream-0.1.10 → defstream-0.1.11}/README.md

@@ -538,6 +538,8 @@ class Add(
 - `format`의 기본값은 `application/json`입니다. 문서의 미디어 타입만 바꾸며 브로커 코덱은 별도 설정입니다.
 - Run의 `name`은 AsyncAPI Operation 키와 Metrics 작업 키에 함께 사용합니다.
   생략하면 `모듈명.__qualname__`을 사용하며, Run의 `description`은 AsyncAPI Operation에 표시됩니다.
+  명시적 이름은 `[A-Za-z0-9_.-]+` 형식이며 공백·한국어는 허용하지 않습니다.
+  대소문자와 입력값을 그대로 보존합니다.
 - 실행 순서는 초기화 훅 → 요청 검증 → `run()` → 응답 검증 → 완료 훅 → 응답 발행·ACK입니다.
 
 검증 예외는 작업 실패로 처리되어 오류 훅과 `on_error` 정책을 따릅니다.

{defstream-0.1.10 → defstream-0.1.11}/issues/fix/10/IMPLEMENTS.md

@@ -13,8 +13,8 @@
 
 - [Run](../../../src/Worker/Run.py) 클래스 정의에서 `name`과 `description`
   키워드를 받는다. `RunMeta`가 이름을 내부 키워드 `run_name`으로 중계하고,
-  `__init_subclass__`가 이름과 설명을 처리한다. 이름은 Python 식별자이며
-  예약어가 아닌지 검사하고, 설명은 문자열 또는 `None`으로 검증한다.
+  `__init_subclass__`가 이름과 설명을 처리한다. 명시적 이름은
+  `[A-Za-z0-9_.-]+` 전체 일치로 검사하고, 설명은 문자열 또는 `None`으로 검증한다.
 - 클래스 생성 시 이름이 생략되면 해당 클래스의 `__module__`과 `__qualname__`으로
   기본 이름을 만든다. 하위 Run에는 상위 Run의 이름과 설명을 상속하지 않는다.
 - [Worker](../../../src/Worker/Worker.py)는 Run 등록 시 동일한 이름이 이미
@@ -133,3 +133,18 @@ Python 3.9.13과 3.10.11에서 클래스 정의의 `name=` 키워드가
 Python 3.9의 첫 전체 실행에서는 무관한 Console HTTP 테스트에 Windows
 `ConnectionAbortedError`가 발생했으나, 해당 테스트의 단독 실행과 전체 재실행은
 통과했다. 변경한 Run 소스의 Pylance 진단에도 오류가 없다.
+
+## 7. 명시적 이름의 허용 문자 변경
+
+Python 식별자 제한을 제거하고 영문 대소문자·숫자·`_`·`.`·`-`를 하나 이상
+허용하도록 변경했다. 위치 제한은 없으며 Python 예약어도 허용한다.
+빈 문자열, 공백·개행, 한국어 등 다른 문자는 거부한다.
+대소문자 변환이나 공백 제거 없이 지정한 이름을 그대로 사용한다.
+미지정 이름의 `모듈명.__qualname__` 생성 규칙과 중복 검사는 유지한다.
+
+허용·거부 문자 조합과 입력값 보존, AsyncAPI Operation 키 및 Metrics
+스냅샷·Prometheus 레이블의 동일 이름 사용을 회귀 테스트로 검증한다.
+
+- Python 3.12.10: 전체 201개 실행, 193개 통과, 선택적 테스트 8개 건너뜀.
+- Python 3.9.13·3.10.11: 각 관련 테스트 43개 실행, 40개 통과, 3개 건너뜀.
+- 변경한 Run 소스의 Pylance 진단 및 변경 파일 공백 검사 통과.

{defstream-0.1.10 → defstream-0.1.11}/issues/fix/10/README.md

@@ -28,8 +28,10 @@ class Add(
 ```
 
 Run 등록 후 AsyncAPI Operation 키와 Metrics 작업 식별자는 `add`입니다.
-이름은 Python 식별자여야 하며, Worker에 같은 이름을 가진 Run을 함께 등록할 수
-없습니다.
+명시적 이름은 영문 대소문자·숫자·`_`·`.`·`-`로만 구성된 한 글자 이상의 문자열입니다
+(`Orders.create-v2_Job` 등). 위치 제한은 없고 Python 예약어도 허용합니다.
+공백·한국어·그 외 문자는 허용하지 않으며, 입력을 변환하지 않고 대소문자를
+구분합니다. Worker에 같은 이름을 가진 Run을 함께 등록할 수 없습니다.
 
 ## 기존 코드에 미치는 영향
 

{defstream-0.1.10 → defstream-0.1.11}/issues/fix/10/REQUIREMENTS.md

@@ -46,7 +46,7 @@ Run을 정의할 때 이름과 설명을 선택적으로 지정할 수 있도록
 |---|---|
 | SPECNAME-01 | Run 정의 시 선택적 `name`을 지정할 수 있어야 한다. 지정하지 않은 경우의 기본값은 미지정 상태여야 한다. |
 | SPECNAME-02 | Run 정의 시 선택적 `description`을 지정할 수 있어야 한다. 지정하지 않은 경우 설명은 없어야 한다. |
-| SPECNAME-03 | `name`은 Python 문법상 유효한 식별자여야 하며 예약어는 허용하지 않는다. 이름을 자동 정규화하거나 변경하지 않는다. 잘못된 타입은 `TypeError`, 유효하지 않은 식별자나 예약어는 `ValueError`로 거부한다. |
+| SPECNAME-03 | 명시적 `name`은 `[A-Za-z0-9_.-]+` 전체 일치 문자열이어야 한다. 영문 대소문자·숫자·`_`·`.`·`-`를 위치 제한 없이 허용하고 Python 예약어도 허용한다. 빈 문자열, 공백, 한국어 및 그 외 문자는 `ValueError`, 문자열과 `None` 이외의 타입은 `TypeError`로 거부한다. 입력을 정규화하지 않고 대소문자를 구분하여 보존한다. |
 | SPECNAME-04 | `description`은 문자열 또는 `None`이어야 한다. 다른 타입은 `TypeError`로 명확히 거부한다. 빈 설명 문자열은 그대로 보존한다. |
 | SPECNAME-05 | 이름이 지정되지 않은 Run의 유효 이름은 `Run.__module__ + '.' + Run.__qualname__`이어야 한다. 중첩 클래스도 `__qualname__`을 포함해야 한다. |
 | SPECNAME-06 | AsyncAPI 문서의 `operations` 객체에서 각 Run의 키로 유효 Run 이름을 사용해야 한다. 이 요구사항은 Operation 객체의 별도 필드가 아니라 `operations` 맵의 키에 적용한다. |
@@ -79,7 +79,7 @@ Run을 정의할 때 이름과 설명을 선택적으로 지정할 수 있도록
 | WAT-01 | `Run` 정의에 `name='orders'`를 지정하면 AsyncAPI `operations`와 Metrics에서 `orders` 키로 식별된다. |
 | WAT-02 | 이름을 지정하지 않은 모듈 최상위 Run의 AsyncAPI 키와 Metrics 키가 모두 `모듈명.클래스명`이다. |
 | WAT-03 | 이름을 지정하지 않은 중첩 Run의 기본 이름에 모듈명과 중첩 경로를 포함한 `__qualname__`이 반영된다. |
-| WAT-04 | `name`이 Python 문법상 식별자가 아니거나 예약어이거나 문자열이 아니면 각각 `ValueError` 또는 `TypeError`가 발생한다. |
+| WAT-04 | `Orders.create-v2_Job`, 숫자만 있는 이름, Python 예약어 및 구분자로 시작·끝나는 이름을 그대로 허용한다. 빈 문자열, 한국어, 공백·개행 및 허용 범위 밖 문자는 `ValueError`, 문자열과 `None` 이외의 타입은 `TypeError`로 거부한다. |
 | WAT-05 | `description`이 문자열이면 AsyncAPI Operation 설명에 반영되고, `None`이면 Operation에 설명 필드가 없다. |
 | WAT-06 | `description`에 문자열 또는 `None` 이외의 값을 전달하면 `TypeError`가 발생한다. |
 | WAT-07 | 두 Run에 같은 사용자 지정 이름을 지정하면 Run 등록 시 충돌을 감지하고, 문서 생성에서도 충돌을 검증한다. 기존 항목을 덮어쓰거나 통계를 합치지 않는다. |

{defstream-0.1.10 → defstream-0.1.11}/src/Worker/Run.py

@@ -4,8 +4,8 @@ from abc import (
 	abstractmethod,
 )
 from collections.abc import Mapping
-from keyword import iskeyword
 from logging import getLogger
+from re import fullmatch
 from time import monotonic
 from typing import (
 	Any,
@@ -138,8 +138,11 @@ class Run(ABC, metaclass=RunMeta):
 			str,
 		):
 			raise TypeError('Run name must be a string or None')
-		if run_name is not None and (not run_name.isidentifier() or iskeyword(run_name)):
-			raise ValueError('Run name must be a valid Python identifier')
+		if run_name is not None and fullmatch(
+			r'[A-Za-z0-9_.-]+',
+			run_name,
+		) is None:
+			raise ValueError('Run name must contain only ASCII letters, digits, underscores, dots or hyphens')
 		if description is not None and not isinstance(
 			description,
 			str,

{defstream-0.1.10 → defstream-0.1.11}/test/test_inspector.py

@@ -498,7 +498,7 @@ class InspectorTests(TestCase):
 		class NamedAdd(
 			Add,
 			parameters={'queue': 'named-add'},
-			name='named_add',
+			name='Orders.create-v2_Job',
 		):
 			pass
 
@@ -514,7 +514,21 @@ class InspectorTests(TestCase):
 		self.addCleanup(worker.pool.stop)
 		self.assertEqual(
 			set(metrics.tasks),
-			{'named_add'},
+			{'Orders.create-v2_Job'},
+		)
+		started = metrics.begin(NamedAdd.name)
+		metrics.end(
+			NamedAdd.name,
+			started,
+			True,
+		)
+		self.assertEqual(
+			metrics.snapshot(inspector)['tasks'][NamedAdd.name]['success'],
+			1,
+		)
+		self.assertIn(
+			'defstream_tasks_total{task="Orders.create-v2_Job",outcome="success"} 1',
+			metrics.render(inspector),
 		)
 
 	def test_metrics_reject_duplicate_run_names_without_overwriting(self):

{defstream-0.1.10 → defstream-0.1.11}/test/test_specifications.py

@@ -426,7 +426,7 @@ class DocumentTests(TestCase):
 		class Described(
 			Add,
 			parameters={'queue': 'described'},
-			name='described',
+			name='Orders.create-v2_Job',
 			description='Add request description',
 		):
 			"""Not the operation description."""
@@ -444,7 +444,7 @@ class DocumentTests(TestCase):
 		inspector.worker.add(Empty)
 		operations = Specifications('/spec').document(inspector)['operations']
 		self.assertEqual(
-			operations['described']['description'],
+			operations['Orders.create-v2_Job']['description'],
 			'Add request description',
 		)
 		self.assertEqual(
@@ -469,12 +469,42 @@ class DocumentTests(TestCase):
 			Local.__module__ + '.' + Local.__qualname__,
 		)
 
-	def test_run_name_must_be_a_python_identifier(self):
+	def test_run_names_preserve_allowed_characters(self):
+		for name in (
+			'Orders.create-v2_Job',
+			'123',
+			'class',
+			'.-_',
+			'-Job.',
+		):
+			with self.subTest(name=name):
+				class Named(
+					Run,
+					name=name,
+				):
+					def run(self):
+						pass
+
+				self.assertEqual(
+					Named.name,
+					name,
+				)
+
+	def test_run_names_reject_empty_strings_and_unsupported_characters(self):
 		for invalid in (
 			'',
-			'not-valid',
 			'has space',
-			'class',
+			' leading',
+			'trailing ',
+			'job\n',
+			'job\t',
+			'job/name',
+			'job:name',
+			'job"name',
+			'job\\name',
+			'\uC791\uC5C5',
+			'caf\u00e9',
+			'\uff11',
 		):
 			with self.subTest(name=invalid), self.assertRaises(ValueError):
 				class Invalid(