diff --git a/10_Wiki/Topics/Coding/Python/001_Python_철학과_The_Zen_of_Python.md b/10_Wiki/Topics/Coding/Python/001_Python_철학과_The_Zen_of_Python.md new file mode 100644 index 00000000..d0f8e3ad --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/001_Python_철학과_The_Zen_of_Python.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-001 +title: Python 철학과 The Zen of Python +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_zen] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_zen] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [PEP 20, 가독성, 코드 스타일] +--- + +# Python 철학과 The Zen of Python + +## 한 줄 통찰 +> Python다운 코드는 문법 암기보다 철학 이해에서 시작된다. + +## 핵심 개념 +- 요약: Python의 핵심 철학과 코드 스타일 선택 기준을 이해한다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[PEP 20]] +- [[가독성]] +- [[코드 스타일]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/002_Python_실행_모델과_인터프리터_이해.md b/10_Wiki/Topics/Coding/Python/002_Python_실행_모델과_인터프리터_이해.md new file mode 100644 index 00000000..ff13de00 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/002_Python_실행_모델과_인터프리터_이해.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-002 +title: Python 실행 모델과 인터프리터 이해 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_execution_model] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_execution_model] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [바이트코드, CPython, 디버깅] +--- + +# Python 실행 모델과 인터프리터 이해 + +## 한 줄 통찰 +> 실행 모델을 알면 성능과 디버깅 판단이 훨씬 쉬워진다. + +## 핵심 개념 +- 요약: 소스가 실행되는 흐름과 바이트코드, 인터프리터 동작의 큰 그림을 이해한다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[바이트코드]] +- [[CPython]] +- [[디버깅]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/003_변수_바인딩과_이름_해석.md b/10_Wiki/Topics/Coding/Python/003_변수_바인딩과_이름_해석.md new file mode 100644 index 00000000..b1adc981 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/003_변수_바인딩과_이름_해석.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-003 +title: 변수 바인딩과 이름 해석 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_name_binding] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_name_binding] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [스코프, 객체 모델, 참조] +--- + +# 변수 바인딩과 이름 해석 + +## 한 줄 통찰 +> Python에서는 값보다 객체와 이름의 관계를 먼저 이해해야 한다. + +## 핵심 개념 +- 요약: 이름, 객체, 스코프가 연결되는 Python식 바인딩 모델을 다룬다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[스코프]] +- [[객체 모델]] +- [[참조]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/004_불변과_가변_객체.md b/10_Wiki/Topics/Coding/Python/004_불변과_가변_객체.md new file mode 100644 index 00000000..1fa82b27 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/004_불변과_가변_객체.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-004 +title: 불변과 가변 객체 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_mutability] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_mutability] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [list, tuple, 공유 상태] +--- + +# 불변과 가변 객체 + +## 한 줄 통찰 +> 상태 버그의 상당수는 가변성 경계를 흐리게 두는 데서 시작된다. + +## 핵심 개념 +- 요약: mutable과 immutable 객체의 차이와 실무 함정을 정리한다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[list]] +- [[tuple]] +- [[공유 상태]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/005_숫자_타입과_연산_규칙.md b/10_Wiki/Topics/Coding/Python/005_숫자_타입과_연산_규칙.md new file mode 100644 index 00000000..68e81a28 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/005_숫자_타입과_연산_규칙.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-005 +title: 숫자 타입과 연산 규칙 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_numeric_types] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_numeric_types] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [float, Decimal, fractions] +--- + +# 숫자 타입과 연산 규칙 + +## 한 줄 통찰 +> 숫자 타입 선택은 정확성과 성능, 도메인 요구를 함께 본다. + +## 핵심 개념 +- 요약: int, float, complex, Decimal 등 숫자 모델과 선택 기준을 다룬다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[float]] +- [[Decimal]] +- [[fractions]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/006_문자열_모델과_유니코드.md b/10_Wiki/Topics/Coding/Python/006_문자열_모델과_유니코드.md new file mode 100644 index 00000000..ba167ae0 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/006_문자열_모델과_유니코드.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-006 +title: 문자열 모델과 유니코드 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_strings_unicode] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_strings_unicode] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [unicode, encoding, text processing] +--- + +# 문자열 모델과 유니코드 + +## 한 줄 통찰 +> 문자열 버그는 문법보다 인코딩 경계에서 많이 터진다. + +## 핵심 개념 +- 요약: 문자열, 인코딩, 유니코드 처리의 기본 원리를 정리한다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[unicode]] +- [[encoding]] +- [[text processing]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/007_bytes와_binary_data_처리.md b/10_Wiki/Topics/Coding/Python/007_bytes와_binary_data_처리.md new file mode 100644 index 00000000..6f5f877e --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/007_bytes와_binary_data_처리.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-007 +title: bytes와 binary data 처리 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_bytes_binary] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_bytes_binary] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [bytes, bytearray, memoryview] +--- + +# bytes와 binary data 처리 + +## 한 줄 통찰 +> 텍스트와 바이너리를 분리해 생각하면 데이터 처리 사고가 훨씬 선명해진다. + +## 핵심 개념 +- 요약: bytes, bytearray, memoryview 등 바이너리 처리 기본기를 다룬다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[bytes]] +- [[bytearray]] +- [[memoryview]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/008_비교_연산과_truthiness.md b/10_Wiki/Topics/Coding/Python/008_비교_연산과_truthiness.md new file mode 100644 index 00000000..78469d7e --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/008_비교_연산과_truthiness.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-008 +title: 비교 연산과 truthiness +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_truthiness] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_truthiness] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [None, bool, comparison] +--- + +# 비교 연산과 truthiness + +## 한 줄 통찰 +> Python의 truthiness를 제대로 이해하면 조건문 버그를 많이 줄일 수 있다. + +## 핵심 개념 +- 요약: 참/거짓 판정, 비교, None 처리 관례를 정리한다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[None]] +- [[bool]] +- [[comparison]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/009_if와_match_문_선택_기준.md b/10_Wiki/Topics/Coding/Python/009_if와_match_문_선택_기준.md new file mode 100644 index 00000000..cc1803aa --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/009_if와_match_문_선택_기준.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-009 +title: if와 match 문 선택 기준 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_if_match] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_if_match] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [match, pattern matching, control flow] +--- + +# if와 match 문 선택 기준 + +## 한 줄 통찰 +> 분기 구조가 복잡해질수록 표현 방식 자체가 설계 품질이 된다. + +## 핵심 개념 +- 요약: 조건 분기에서 if/elif와 structural pattern matching의 차이를 다룬다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[match]] +- [[pattern matching]] +- [[control flow]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/010_반복문과_순회_철학.md b/10_Wiki/Topics/Coding/Python/010_반복문과_순회_철학.md new file mode 100644 index 00000000..9b04bdde --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/010_반복문과_순회_철학.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-010 +title: 반복문과 순회 철학 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_loops_iteration] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_loops_iteration] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [for, iterable, iterator] +--- + +# 반복문과 순회 철학 + +## 한 줄 통찰 +> Python 루프는 카운터보다 iterable 중심 사고로 볼 때 더 강력하다. + +## 핵심 개념 +- 요약: for, while, iter protocol을 통해 Python다운 순회 방식을 이해한다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[for]] +- [[iterable]] +- [[iterator]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/011_리스트_컴프리헨션.md b/10_Wiki/Topics/Coding/Python/011_리스트_컴프리헨션.md new file mode 100644 index 00000000..cc2718ae --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/011_리스트_컴프리헨션.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-011 +title: 리스트 컴프리헨션 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_list_comprehension] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_list_comprehension] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [comprehension, readability, loop] +--- + +# 리스트 컴프리헨션 + +## 한 줄 통찰 +> 짧다고 항상 좋은 것이 아니라, 의도가 선명할 때만 컴프리헨션이 빛난다. + +## 핵심 개념 +- 요약: 리스트 컴프리헨션의 장점과 과용 위험을 정리한다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[comprehension]] +- [[readability]] +- [[loop]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/012_제너레이터_표현식.md b/10_Wiki/Topics/Coding/Python/012_제너레이터_표현식.md new file mode 100644 index 00000000..4fd46861 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/012_제너레이터_표현식.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-012 +title: 제너레이터 표현식 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_generator_expressions] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_generator_expressions] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [generator, lazy evaluation, iteration] +--- + +# 제너레이터 표현식 + +## 한 줄 통찰 +> 메모리 효율은 종종 eager보다 lazy 사고에서 나온다. + +## 핵심 개념 +- 요약: lazy evaluation을 위한 generator expression 패턴을 다룬다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[generator]] +- [[lazy evaluation]] +- [[iteration]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/013_슬라이싱과_시퀀스_사고.md b/10_Wiki/Topics/Coding/Python/013_슬라이싱과_시퀀스_사고.md new file mode 100644 index 00000000..5a213f7f --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/013_슬라이싱과_시퀀스_사고.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-013 +title: 슬라이싱과 시퀀스 사고 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_slicing_sequences] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_slicing_sequences] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [slice, sequence, copy] +--- + +# 슬라이싱과 시퀀스 사고 + +## 한 줄 통찰 +> 슬라이싱은 편하지만 복사와 뷰의 차이를 모르면 비용을 놓치기 쉽다. + +## 핵심 개념 +- 요약: 슬라이싱, step, copy semantics 등 시퀀스 조작 기본기를 정리한다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[slice]] +- [[sequence]] +- [[copy]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/014_예외_처리_기초.md b/10_Wiki/Topics/Coding/Python/014_예외_처리_기초.md new file mode 100644 index 00000000..89861344 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/014_예외_처리_기초.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-014 +title: 예외 처리 기초 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_exceptions_basics] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_exceptions_basics] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [exceptions, finally, error handling] +--- + +# 예외 처리 기초 + +## 한 줄 통찰 +> 예외 처리는 숨기기보다 실패를 구조화하는 도구여야 한다. + +## 핵심 개념 +- 요약: try/except/finally와 예외 철학을 다룬다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[exceptions]] +- [[finally]] +- [[error handling]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/015_컨텍스트_매니저_입문.md b/10_Wiki/Topics/Coding/Python/015_컨텍스트_매니저_입문.md new file mode 100644 index 00000000..0a63b245 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/015_컨텍스트_매니저_입문.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-015 +title: 컨텍스트 매니저 입문 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_context_manager_intro] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_context_manager_intro] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [with, resource management, context manager] +--- + +# 컨텍스트 매니저 입문 + +## 한 줄 통찰 +> 정리 코드를 흩뿌리기보다 생명주기를 구문 안에 묶는 것이 안전하다. + +## 핵심 개념 +- 요약: with 문과 자원 해제 패턴의 기초를 정리한다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[with]] +- [[resource management]] +- [[context manager]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/016_모듈과_import_시스템_기초.md b/10_Wiki/Topics/Coding/Python/016_모듈과_import_시스템_기초.md new file mode 100644 index 00000000..5ebc9c58 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/016_모듈과_import_시스템_기초.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-016 +title: 모듈과 import 시스템 기초 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_modules_imports] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_modules_imports] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [module, import, package] +--- + +# 모듈과 import 시스템 기초 + +## 한 줄 통찰 +> import 구조는 단순 편의가 아니라 아키텍처 경계의 일부다. + +## 핵심 개념 +- 요약: 모듈 경계와 import 동작, 패키지 구조의 기초를 이해한다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[module]] +- [[import]] +- [[package]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/017_스코프와_LEGB_규칙.md b/10_Wiki/Topics/Coding/Python/017_스코프와_LEGB_규칙.md new file mode 100644 index 00000000..25ee24df --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/017_스코프와_LEGB_규칙.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-017 +title: 스코프와 LEGB 규칙 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_scope_legb] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_scope_legb] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [scope, closure, global] +--- + +# 스코프와 LEGB 규칙 + +## 한 줄 통찰 +> 클로저와 전역 상태 문제는 LEGB를 선명히 이해하면 많이 줄어든다. + +## 핵심 개념 +- 요약: local, enclosing, global, builtins 스코프 해석 규칙을 다룬다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[scope]] +- [[closure]] +- [[global]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/018_함수는_일급_객체다.md b/10_Wiki/Topics/Coding/Python/018_함수는_일급_객체다.md new file mode 100644 index 00000000..8af1ee81 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/018_함수는_일급_객체다.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-018 +title: 함수는 일급 객체다 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_first_class_functions] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_first_class_functions] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [callable, higher-order function, callback] +--- + +# 함수는 일급 객체다 + +## 한 줄 통찰 +> 함수가 값이라는 감각을 가지면 콜백, 데코레이터, 전략 패턴이 자연스러워진다. + +## 핵심 개념 +- 요약: 함수를 값처럼 다루는 Python 패턴의 기초를 정리한다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[callable]] +- [[higher-order function]] +- [[callback]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/019_람다와_작은_함수_선택_기준.md b/10_Wiki/Topics/Coding/Python/019_람다와_작은_함수_선택_기준.md new file mode 100644 index 00000000..01378936 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/019_람다와_작은_함수_선택_기준.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-019 +title: 람다와 작은 함수 선택 기준 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_lambda_usage] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, python_lambda_usage] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [lambda, readability, functional style] +--- + +# 람다와 작은 함수 선택 기준 + +## 한 줄 통찰 +> 짧음과 명확함은 다르며, lambda는 용도가 분명할 때만 강하다. + +## 핵심 개념 +- 요약: lambda를 언제 쓰고 언제 이름 있는 함수로 분리할지 정리한다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[lambda]] +- [[readability]] +- [[functional style]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/020_Pythonic_코드를_읽는_법.md b/10_Wiki/Topics/Coding/Python/020_Pythonic_코드를_읽는_법.md new file mode 100644 index 00000000..b95b2285 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/020_Pythonic_코드를_읽는_법.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-020 +title: Pythonic 코드를 읽는 법 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [pythonic_code_reading] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, foundations, pythonic_code_reading] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "foundations" } +applied_in: [] +verification_status: conceptual +related_notes: [idiomatic python, readability, code review] +--- + +# Pythonic 코드를 읽는 법 + +## 한 줄 통찰 +> Pythonic은 유행어가 아니라 의도와 가독성의 균형 감각이다. + +## 핵심 개념 +- 요약: 관용적인 Python 코드를 해석하고 팀 기준으로 번역하는 방법을 다룬다. +- 지식 축: Python 언어의 핵심 개념과 문법 기초를 다루는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 핵심 개념을 언어 철학과 연결해 이해하면 응용 범위가 넓어진다. +- 작동 원리를 알아야 문법 암기보다 더 빠르게 문제를 풀 수 있다. +- 기초 개념은 후속 라이브러리와 프레임워크 선택의 기준이 된다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 예제를 외우기보다 언제 이 개념을 선택해야 하는지 기준을 함께 적는다. +- 간단한 규칙보다 경계 조건과 예외를 먼저 확인한다. +- 다른 언어 습관을 그대로 가져오지 말고 Python다운 해법을 우선 검토한다. + +## 안티패턴 +- 문법만 외우고 데이터 모델을 이해하지 않는다. +- Python 철학보다 다른 언어의 습관을 그대로 들여온다. +- 기초를 건너뛰고 프레임워크 사용법만 익힌다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[idiomatic python]] +- [[readability]] +- [[code review]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/021_list_tuple_set_dict_선택_기준.md b/10_Wiki/Topics/Coding/Python/021_list_tuple_set_dict_선택_기준.md new file mode 100644 index 00000000..cf7e257c --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/021_list_tuple_set_dict_선택_기준.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-021 +title: list, tuple, set, dict 선택 기준 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_core_collections] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_core_collections] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [list, tuple, dict] +--- + +# list, tuple, set, dict 선택 기준 + +## 한 줄 통찰 +> 자료구조 선택 하나가 코드 성격을 바꿀 수 있다. + +## 핵심 개념 +- 요약: 핵심 컬렉션 타입의 차이와 선택 기준을 정리한다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[list]] +- [[tuple]] +- [[dict]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/022_dict_내부_모델과_해시_기반_사고.md b/10_Wiki/Topics/Coding/Python/022_dict_내부_모델과_해시_기반_사고.md new file mode 100644 index 00000000..ccfd44b6 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/022_dict_내부_모델과_해시_기반_사고.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-022 +title: dict 내부 모델과 해시 기반 사고 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_dict_hashing] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_dict_hashing] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [dict, hash, mapping] +--- + +# dict 내부 모델과 해시 기반 사고 + +## 한 줄 통찰 +> dict를 잘 이해하면 Python 데이터 구조 전반이 더 선명해진다. + +## 핵심 개념 +- 요약: dict의 해시 기반 작동 원리와 실무 함정을 다룬다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[dict]] +- [[hash]] +- [[mapping]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/023_set_활용_패턴.md b/10_Wiki/Topics/Coding/Python/023_set_활용_패턴.md new file mode 100644 index 00000000..3373cabb --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/023_set_활용_패턴.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-023 +title: set 활용 패턴 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_set_patterns] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_set_patterns] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [set, membership, deduplication] +--- + +# set 활용 패턴 + +## 한 줄 통찰 +> set는 단순한 자료형이 아니라 의도를 드러내는 강한 표현이다. + +## 핵심 개념 +- 요약: 중복 제거, membership test, 집합 연산을 실무에 적용하는 법을 정리한다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[set]] +- [[membership]] +- [[deduplication]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/024_deque와_queue_패턴.md b/10_Wiki/Topics/Coding/Python/024_deque와_queue_패턴.md new file mode 100644 index 00000000..19a0ca29 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/024_deque와_queue_패턴.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-024 +title: deque와 queue 패턴 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_deque_queue] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_deque_queue] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [deque, queue, collections] +--- + +# deque와 queue 패턴 + +## 한 줄 통찰 +> list로 억지 구현하기보다 목적에 맞는 구조를 쓰는 것이 Python답다. + +## 핵심 개념 +- 요약: collections.deque를 중심으로 큐/스택 패턴을 다룬다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[deque]] +- [[queue]] +- [[collections]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/025_namedtuple과_dataclass_비교.md b/10_Wiki/Topics/Coding/Python/025_namedtuple과_dataclass_비교.md new file mode 100644 index 00000000..d65b8551 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/025_namedtuple과_dataclass_비교.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-025 +title: namedtuple과 dataclass 비교 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_namedtuple_dataclass] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_namedtuple_dataclass] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [namedtuple, dataclass, records] +--- + +# namedtuple과 dataclass 비교 + +## 한 줄 통찰 +> 가벼운 구조체 선택도 변경 가능성 기준으로 봐야 한다. + +## 핵심 개념 +- 요약: 간단한 레코드 구조를 표현하는 여러 선택지를 비교한다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[namedtuple]] +- [[dataclass]] +- [[records]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/026_함수_시그니처_설계.md b/10_Wiki/Topics/Coding/Python/026_함수_시그니처_설계.md new file mode 100644 index 00000000..4aaec05f --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/026_함수_시그니처_설계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-026 +title: 함수 시그니처 설계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_function_signatures] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_function_signatures] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [signature, kwargs, api design] +--- + +# 함수 시그니처 설계 + +## 한 줄 통찰 +> 좋은 함수 시그니처는 문서 절반을 대신한다. + +## 핵심 개념 +- 요약: positional, keyword-only, defaults를 포함한 함수 API 설계를 다룬다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[signature]] +- [[kwargs]] +- [[api design]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/027_기본값_인자의_함정.md b/10_Wiki/Topics/Coding/Python/027_기본값_인자의_함정.md new file mode 100644 index 00000000..4c510b2b --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/027_기본값_인자의_함정.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-027 +title: 기본값 인자의 함정 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_default_arguments] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_default_arguments] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [default args, mutability, None sentinel] +--- + +# 기본값 인자의 함정 + +## 한 줄 통찰 +> 작은 편의가 큰 공유 상태 버그로 이어질 수 있다. + +## 핵심 개념 +- 요약: mutable default argument 문제와 안전한 패턴을 정리한다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[default args]] +- [[mutability]] +- [[None sentinel]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/028_args와_kwargs_실전.md b/10_Wiki/Topics/Coding/Python/028_args와_kwargs_실전.md new file mode 100644 index 00000000..798202fa --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/028_args와_kwargs_실전.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-028 +title: args와 kwargs 실전 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_args_kwargs] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_args_kwargs] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [*args, **kwargs, api design] +--- + +# args와 kwargs 실전 + +## 한 줄 통찰 +> 유연성은 좋지만, 지나치면 API 경계가 흐려진다. + +## 핵심 개념 +- 요약: 가변 인자 사용 패턴과 남용 방지 기준을 정리한다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[*args]] +- [[**kwargs]] +- [[api design]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/029_클로저와_nonlocal.md b/10_Wiki/Topics/Coding/Python/029_클로저와_nonlocal.md new file mode 100644 index 00000000..7e0e01bc --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/029_클로저와_nonlocal.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-029 +title: 클로저와 nonlocal +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_closures_nonlocal] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_closures_nonlocal] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [closure, nonlocal, factory] +--- + +# 클로저와 nonlocal + +## 한 줄 통찰 +> 작은 상태 캡슐화는 클래스보다 클로저가 더 적합할 때가 있다. + +## 핵심 개념 +- 요약: 클로저를 상태 캡슐화와 함수 팩토리에 쓰는 패턴을 다룬다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[closure]] +- [[nonlocal]] +- [[factory]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/030_partial과_함수_조합.md b/10_Wiki/Topics/Coding/Python/030_partial과_함수_조합.md new file mode 100644 index 00000000..fe2d3bf3 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/030_partial과_함수_조합.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-030 +title: partial과 함수 조합 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_partial_composition] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_partial_composition] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [partial, functools, composition] +--- + +# partial과 함수 조합 + +## 한 줄 통찰 +> 반복 인자를 고정하는 작은 추상화가 API 가독성을 크게 높인다. + +## 핵심 개념 +- 요약: functools.partial 등 함수 조합 패턴을 정리한다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[partial]] +- [[functools]] +- [[composition]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/031_iterator_protocol_깊게_보기.md b/10_Wiki/Topics/Coding/Python/031_iterator_protocol_깊게_보기.md new file mode 100644 index 00000000..6eeea332 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/031_iterator_protocol_깊게_보기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-031 +title: iterator protocol 깊게 보기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_iterator_protocol] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_iterator_protocol] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [iterator, iter, next] +--- + +# iterator protocol 깊게 보기 + +## 한 줄 통찰 +> iterator protocol은 Python 컬렉션과 lazy 처리의 공통 뼈대다. + +## 핵심 개념 +- 요약: iter, next, StopIteration 기반 순회 모델을 다룬다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[iterator]] +- [[iter]] +- [[next]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/032_generator_함수_설계.md b/10_Wiki/Topics/Coding/Python/032_generator_함수_설계.md new file mode 100644 index 00000000..09a6647b --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/032_generator_함수_설계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-032 +title: generator 함수 설계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_generator_functions] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_generator_functions] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [yield, streaming, lazy evaluation] +--- + +# generator 함수 설계 + +## 한 줄 통찰 +> 제너레이터는 메모리 절약뿐 아니라 처리 파이프라인 사고를 열어준다. + +## 핵심 개념 +- 요약: yield 기반 스트리밍 처리와 제너레이터 함수 설계를 다룬다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[yield]] +- [[streaming]] +- [[lazy evaluation]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/033_yield_from과_위임.md b/10_Wiki/Topics/Coding/Python/033_yield_from과_위임.md new file mode 100644 index 00000000..aff9cc66 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/033_yield_from과_위임.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-033 +title: yield from과 위임 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_yield_from] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_yield_from] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [yield from, generator, composition] +--- + +# yield from과 위임 + +## 한 줄 통찰 +> 반복 로직 합성은 작은 위임 문법 하나로 훨씬 깔끔해질 수 있다. + +## 핵심 개념 +- 요약: 서브제너레이터 위임과 구성 패턴을 정리한다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[yield from]] +- [[generator]] +- [[composition]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/034_enumerate_zip_unpacking.md b/10_Wiki/Topics/Coding/Python/034_enumerate_zip_unpacking.md new file mode 100644 index 00000000..93270d9c --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/034_enumerate_zip_unpacking.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-034 +title: enumerate, zip, unpacking +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_iteration_helpers] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_iteration_helpers] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [enumerate, zip, unpacking] +--- + +# enumerate, zip, unpacking + +## 한 줄 통찰 +> 반복 제어를 간결하게 만들수록 로직이 더 잘 보인다. + +## 핵심 개념 +- 요약: 순회 헬퍼와 언패킹을 Pythonic하게 쓰는 법을 다룬다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[enumerate]] +- [[zip]] +- [[unpacking]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/035_정렬과_key_함수.md b/10_Wiki/Topics/Coding/Python/035_정렬과_key_함수.md new file mode 100644 index 00000000..2678df6c --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/035_정렬과_key_함수.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-035 +title: 정렬과 key 함수 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_sorting_keys] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_sorting_keys] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [sorted, key, stability] +--- + +# 정렬과 key 함수 + +## 한 줄 통찰 +> 정렬 전략은 비교보다 key 추출로 단순화할 때 읽기 쉬워진다. + +## 핵심 개념 +- 요약: sorted, sort, key, stability 개념을 정리한다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[sorted]] +- [[key]] +- [[stability]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/036_파일_IO_기본_패턴.md b/10_Wiki/Topics/Coding/Python/036_파일_IO_기본_패턴.md new file mode 100644 index 00000000..c482b067 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/036_파일_IO_기본_패턴.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-036 +title: 파일 I/O 기본 패턴 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_file_io] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_file_io] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [file io, with, encoding] +--- + +# 파일 I/O 기본 패턴 + +## 한 줄 통찰 +> I/O는 데이터보다 경계와 자원 수명이 더 중요하다. + +## 핵심 개념 +- 요약: 텍스트/바이너리 파일 읽기 쓰기 패턴과 주의점을 정리한다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[file io]] +- [[with]] +- [[encoding]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/037_pathlib_중심_파일_시스템_다루기.md b/10_Wiki/Topics/Coding/Python/037_pathlib_중심_파일_시스템_다루기.md new file mode 100644 index 00000000..3d8157dc --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/037_pathlib_중심_파일_시스템_다루기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-037 +title: pathlib 중심 파일 시스템 다루기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pathlib] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_pathlib] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [pathlib, filesystem, paths] +--- + +# pathlib 중심 파일 시스템 다루기 + +## 한 줄 통찰 +> 경로는 문자열이 아니라 경로 객체로 다룰 때 실수가 줄어든다. + +## 핵심 개념 +- 요약: os.path보다 pathlib를 중심으로 경로 처리 패턴을 다룬다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[pathlib]] +- [[filesystem]] +- [[paths]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/038_json_처리와_직렬화_기준.md b/10_Wiki/Topics/Coding/Python/038_json_처리와_직렬화_기준.md new file mode 100644 index 00000000..c0f63f07 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/038_json_처리와_직렬화_기준.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-038 +title: json 처리와 직렬화 기준 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_json_serialization] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_json_serialization] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [json, serialization, schema] +--- + +# json 처리와 직렬화 기준 + +## 한 줄 통찰 +> 직렬화는 데이터 구조를 외부 세계와 약속하는 행위다. + +## 핵심 개념 +- 요약: json 모듈과 직렬화 경계 설계 기준을 정리한다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[json]] +- [[serialization]] +- [[schema]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/039_csv와_구조적_텍스트_처리.md b/10_Wiki/Topics/Coding/Python/039_csv와_구조적_텍스트_처리.md new file mode 100644 index 00000000..66c0f11b --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/039_csv와_구조적_텍스트_처리.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-039 +title: csv와 구조적 텍스트 처리 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_csv_processing] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_csv_processing] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [csv, dialect, text processing] +--- + +# csv와 구조적 텍스트 처리 + +## 한 줄 통찰 +> 간단한 표 형식도 경계 조건을 무시하면 쉽게 깨진다. + +## 핵심 개념 +- 요약: csv 모듈을 중심으로 구조적 텍스트 처리 패턴을 다룬다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[csv]] +- [[dialect]] +- [[text processing]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/040_재귀와_반복_선택_기준.md b/10_Wiki/Topics/Coding/Python/040_재귀와_반복_선택_기준.md new file mode 100644 index 00000000..358a462e --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/040_재귀와_반복_선택_기준.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-040 +title: 재귀와 반복 선택 기준 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_recursion_vs_iteration] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, structures, python_recursion_vs_iteration] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "structures" } +applied_in: [] +verification_status: conceptual +related_notes: [recursion, iteration, stack] +--- + +# 재귀와 반복 선택 기준 + +## 한 줄 통찰 +> 우아함보다 종료 조건과 디버깅 가능성을 먼저 봐야 한다. + +## 핵심 개념 +- 요약: 재귀와 반복 중 어떤 표현이 더 적절한지 판단 기준을 정리한다. +- 지식 축: 자료구조, 함수, 객체 모델처럼 Python 코드를 조직하는 기본 구조 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표현 방식보다 데이터 흐름과 상태 관리 구조를 먼저 봐야 한다. +- Python 표준 자료구조를 제대로 알면 라이브러리 의존을 줄일 수 있다. +- 구조 선택은 성능과 가독성, 유지보수성에 동시에 영향을 준다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 문제를 자료와 동작으로 분해한 뒤 적합한 구조를 고른다. +- 작은 편의보다 장기 유지보수 비용을 우선 본다. +- 공유 상태와 변경 가능성을 먼저 점검한다. + +## 안티패턴 +- 모든 문제를 같은 자료구조로 해결하려 한다. +- 가독성을 희생하면서 과도하게 축약한다. +- 공유 mutable 상태를 무심코 퍼뜨린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[recursion]] +- [[iteration]] +- [[stack]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/041_데코레이터_기초.md b/10_Wiki/Topics/Coding/Python/041_데코레이터_기초.md new file mode 100644 index 00000000..2e3314ab --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/041_데코레이터_기초.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-041 +title: 데코레이터 기초 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_decorators_basics] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_decorators_basics] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [decorator, higher-order function, wrapping] +--- + +# 데코레이터 기초 + +## 한 줄 통찰 +> 데코레이터는 문법 트릭이 아니라 반복 관심사를 묶는 도구다. + +## 핵심 개념 +- 요약: 함수 데코레이터의 기본 구조와 사용 이유를 정리한다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[decorator]] +- [[higher-order function]] +- [[wrapping]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/042_functoolswraps와_메타데이터_보존.md b/10_Wiki/Topics/Coding/Python/042_functoolswraps와_메타데이터_보존.md new file mode 100644 index 00000000..26f439d2 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/042_functoolswraps와_메타데이터_보존.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-042 +title: functools.wraps와 메타데이터 보존 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_functools_wraps] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_functools_wraps] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [functools.wraps, decorator, introspection] +--- + +# functools.wraps와 메타데이터 보존 + +## 한 줄 통찰 +> 작은 메타데이터 보존이 디버깅과 문서화를 크게 돕는다. + +## 핵심 개념 +- 요약: 데코레이터 작성 시 wraps를 써야 하는 이유를 다룬다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[functools.wraps]] +- [[decorator]] +- [[introspection]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/043_클래스_데코레이터.md b/10_Wiki/Topics/Coding/Python/043_클래스_데코레이터.md new file mode 100644 index 00000000..7715f8fa --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/043_클래스_데코레이터.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-043 +title: 클래스 데코레이터 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_class_decorators] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_class_decorators] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [class decorator, metaprogramming, class] +--- + +# 클래스 데코레이터 + +## 한 줄 통찰 +> 클래스 데코레이터는 메타클래스보다 가벼운 대안이 될 수 있다. + +## 핵심 개념 +- 요약: 클래스 수준에서 동작을 주입하는 패턴을 정리한다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[class decorator]] +- [[metaprogramming]] +- [[class]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/044_descriptor_protocol.md b/10_Wiki/Topics/Coding/Python/044_descriptor_protocol.md new file mode 100644 index 00000000..2d9492fc --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/044_descriptor_protocol.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-044 +title: descriptor protocol +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_descriptor_protocol] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_descriptor_protocol] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [descriptor, __get__, __set__] +--- + +# descriptor protocol + +## 한 줄 통찰 +> Python 객체 모델의 핵심 마법은 descriptor를 이해할 때 비로소 열린다. + +## 핵심 개념 +- 요약: property 뒤에 있는 descriptor 모델과 실전 응용을 다룬다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[descriptor]] +- [[__get__]] +- [[__set__]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/045_property와_검증_로직.md b/10_Wiki/Topics/Coding/Python/045_property와_검증_로직.md new file mode 100644 index 00000000..75d3db19 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/045_property와_검증_로직.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-045 +title: property와 검증 로직 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_property_validation] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_property_validation] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [property, validation, encapsulation] +--- + +# property와 검증 로직 + +## 한 줄 통찰 +> 단순 getter/setter보다 도메인 규칙 노출 방식이 더 중요하다. + +## 핵심 개념 +- 요약: property를 써서 속성 접근과 검증을 설계하는 기준을 정리한다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[property]] +- [[validation]] +- [[encapsulation]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/046_staticmethod_classmethod_instance_method.md b/10_Wiki/Topics/Coding/Python/046_staticmethod_classmethod_instance_method.md new file mode 100644 index 00000000..6a3ce96e --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/046_staticmethod_classmethod_instance_method.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-046 +title: staticmethod, classmethod, instance method +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_method_types] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_method_types] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [staticmethod, classmethod, oop] +--- + +# staticmethod, classmethod, instance method + +## 한 줄 통찰 +> 메서드 종류는 문법이 아니라 책임 배치 문제다. + +## 핵심 개념 +- 요약: 세 가지 메서드 종류의 역할과 선택 기준을 다룬다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[staticmethod]] +- [[classmethod]] +- [[oop]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/047_ABC와_Protocol.md b/10_Wiki/Topics/Coding/Python/047_ABC와_Protocol.md new file mode 100644 index 00000000..f454d6e3 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/047_ABC와_Protocol.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-047 +title: ABC와 Protocol +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_abc_protocol] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_abc_protocol] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [abc, protocol, typing] +--- + +# ABC와 Protocol + +## 한 줄 통찰 +> 계약을 어떻게 표현하느냐가 결합도를 좌우한다. + +## 핵심 개념 +- 요약: 추상 베이스 클래스와 structural typing 기반 Protocol을 비교한다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[abc]] +- [[protocol]] +- [[typing]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/048_메타클래스_언제_쓰는가.md b/10_Wiki/Topics/Coding/Python/048_메타클래스_언제_쓰는가.md new file mode 100644 index 00000000..880d1eb9 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/048_메타클래스_언제_쓰는가.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-048 +title: 메타클래스 언제 쓰는가 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_metaclasses] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_metaclasses] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [metaclass, class creation, advanced] +--- + +# 메타클래스 언제 쓰는가 + +## 한 줄 통찰 +> 메타클래스는 마지막 수단에 가까우며, 목적이 분명해야 한다. + +## 핵심 개념 +- 요약: 메타클래스의 역할과 대체 가능한 선택지를 정리한다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[metaclass]] +- [[class creation]] +- [[advanced]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/049___new__와___init___차이.md b/10_Wiki/Topics/Coding/Python/049___new__와___init___차이.md new file mode 100644 index 00000000..f8c163eb --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/049___new__와___init___차이.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-049 +title: __new__와 __init__ 차이 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_new_init] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_new_init] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [__new__, __init__, object model] +--- + +# __new__와 __init__ 차이 + +## 한 줄 통찰 +> 생성자 로직을 나눠 이해하면 불변 객체와 팩토리 설계가 쉬워진다. + +## 핵심 개념 +- 요약: 객체 생성 수명주기와 __new__/__init__ 역할을 다룬다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[__new__]] +- [[__init__]] +- [[object model]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/050___slots__와_메모리_최적화.md b/10_Wiki/Topics/Coding/Python/050___slots__와_메모리_최적화.md new file mode 100644 index 00000000..61638146 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/050___slots__와_메모리_최적화.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-050 +title: __slots__와 메모리 최적화 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_slots] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_slots] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [__slots__, memory, optimization] +--- + +# __slots__와 메모리 최적화 + +## 한 줄 통찰 +> 메모리 최적화는 측정 기반이어야 하고 가독성 비용과 같이 봐야 한다. + +## 핵심 개념 +- 요약: __slots__ 사용 이유와 제약, 언제 쓸지 정리한다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[__slots__]] +- [[memory]] +- [[optimization]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/051_dunder_methods와_연산자_오버로딩.md b/10_Wiki/Topics/Coding/Python/051_dunder_methods와_연산자_오버로딩.md new file mode 100644 index 00000000..3ef8a636 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/051_dunder_methods와_연산자_오버로딩.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-051 +title: dunder methods와 연산자 오버로딩 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_dunder_methods] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_dunder_methods] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [dunder, operator overloading, data model] +--- + +# dunder methods와 연산자 오버로딩 + +## 한 줄 통찰 +> 연산자 오버로딩은 멋짐보다 직관성과 기대 일치를 먼저 봐야 한다. + +## 핵심 개념 +- 요약: 특수 메서드와 연산자 오버로딩 설계 기준을 다룬다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[dunder]] +- [[operator overloading]] +- [[data model]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/052_dataclass_고급_옵션.md b/10_Wiki/Topics/Coding/Python/052_dataclass_고급_옵션.md new file mode 100644 index 00000000..bad8e7f2 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/052_dataclass_고급_옵션.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-052 +title: dataclass 고급 옵션 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_dataclass_advanced] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_dataclass_advanced] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [dataclass, frozen, slots] +--- + +# dataclass 고급 옵션 + +## 한 줄 통찰 +> dataclass는 편의 기능이지만 도메인 모델 설계 의도를 먼저 세워야 한다. + +## 핵심 개념 +- 요약: frozen, slots, kw_only 등 dataclass 옵션을 정리한다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[dataclass]] +- [[frozen]] +- [[slots]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/053_Enum과_상수_모델링.md b/10_Wiki/Topics/Coding/Python/053_Enum과_상수_모델링.md new file mode 100644 index 00000000..f38ff17b --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/053_Enum과_상수_모델링.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-053 +title: Enum과 상수 모델링 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_enum_modeling] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_enum_modeling] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [Enum, constants, domain model] +--- + +# Enum과 상수 모델링 + +## 한 줄 통찰 +> 매직 문자열을 줄이는 것만으로도 도메인 버그가 많이 줄어든다. + +## 핵심 개념 +- 요약: Enum으로 상태와 상수를 모델링하는 기준을 다룬다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Enum]] +- [[constants]] +- [[domain model]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/054_singledispatch와_다형_함수.md b/10_Wiki/Topics/Coding/Python/054_singledispatch와_다형_함수.md new file mode 100644 index 00000000..ebeec95a --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/054_singledispatch와_다형_함수.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-054 +title: singledispatch와 다형 함수 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_singledispatch] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_singledispatch] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [singledispatch, polymorphism, dispatch] +--- + +# singledispatch와 다형 함수 + +## 한 줄 통찰 +> 클래스 계층 없이도 함수 단위 확장성을 만들 수 있다. + +## 핵심 개념 +- 요약: functools.singledispatch를 통한 함수 기반 다형성 패턴을 다룬다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[singledispatch]] +- [[polymorphism]] +- [[dispatch]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/055_contextlib_고급_패턴.md b/10_Wiki/Topics/Coding/Python/055_contextlib_고급_패턴.md new file mode 100644 index 00000000..bb6fb912 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/055_contextlib_고급_패턴.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-055 +title: contextlib 고급 패턴 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_contextlib] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_contextlib] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [contextlib, ExitStack, resource management] +--- + +# contextlib 고급 패턴 + +## 한 줄 통찰 +> 자원 생명주기 조합은 contextlib를 알수록 훨씬 안전해진다. + +## 핵심 개념 +- 요약: contextmanager와 ExitStack을 포함한 contextlib 실전 패턴을 정리한다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[contextlib]] +- [[ExitStack]] +- [[resource management]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/056_weakref와_객체_수명.md b/10_Wiki/Topics/Coding/Python/056_weakref와_객체_수명.md new file mode 100644 index 00000000..91541d27 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/056_weakref와_객체_수명.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-056 +title: weakref와 객체 수명 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_weakref] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_weakref] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [weakref, cache, lifecycle] +--- + +# weakref와 객체 수명 + +## 한 줄 통찰 +> 객체를 오래 붙잡는 실수는 캐시와 이벤트 시스템에서 자주 생긴다. + +## 핵심 개념 +- 요약: weak reference를 통한 캐시, 콜백, 메모리 관계를 다룬다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[weakref]] +- [[cache]] +- [[lifecycle]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/057_copy와_deepcopy.md b/10_Wiki/Topics/Coding/Python/057_copy와_deepcopy.md new file mode 100644 index 00000000..876f65dc --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/057_copy와_deepcopy.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-057 +title: copy와 deepcopy +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_copy_deepcopy] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_copy_deepcopy] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [copy, deepcopy, object graph] +--- + +# copy와 deepcopy + +## 한 줄 통찰 +> 복사는 값 복제가 아니라 관계 복제 문제로 봐야 한다. + +## 핵심 개념 +- 요약: 복사 의미론과 custom copy 설계 기준을 정리한다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[copy]] +- [[deepcopy]] +- [[object graph]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/058_pickle_직렬화_위험과_활용.md b/10_Wiki/Topics/Coding/Python/058_pickle_직렬화_위험과_활용.md new file mode 100644 index 00000000..031c6afd --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/058_pickle_직렬화_위험과_활용.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-058 +title: pickle 직렬화 위험과 활용 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pickle] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_pickle] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [pickle, serialization, security] +--- + +# pickle 직렬화 위험과 활용 + +## 한 줄 통찰 +> 편리한 직렬화일수록 신뢰 경계를 엄격히 봐야 한다. + +## 핵심 개념 +- 요약: pickle의 편의와 보안 위험, 대안 선택 기준을 다룬다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[pickle]] +- [[serialization]] +- [[security]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/059_introspection과_inspect_모듈.md b/10_Wiki/Topics/Coding/Python/059_introspection과_inspect_모듈.md new file mode 100644 index 00000000..ad122358 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/059_introspection과_inspect_모듈.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-059 +title: introspection과 inspect 모듈 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_introspection_inspect] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_introspection_inspect] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [inspect, introspection, runtime] +--- + +# introspection과 inspect 모듈 + +## 한 줄 통찰 +> 동적 언어의 힘은 introspection에서 오지만, 과용은 복잡도를 부른다. + +## 핵심 개념 +- 요약: 런타임 introspection 패턴과 inspect 활용을 정리한다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[inspect]] +- [[introspection]] +- [[runtime]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/060_ast_기반_코드_조작_기초.md b/10_Wiki/Topics/Coding/Python/060_ast_기반_코드_조작_기초.md new file mode 100644 index 00000000..28604688 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/060_ast_기반_코드_조작_기초.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-060 +title: ast 기반 코드 조작 기초 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_ast_basics] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, advanced, python_ast_basics] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "advanced" } +applied_in: [] +verification_status: conceptual +related_notes: [ast, code transformation, analysis] +--- + +# ast 기반 코드 조작 기초 + +## 한 줄 통찰 +> 코드를 텍스트보다 구조로 다루면 자동화의 수준이 달라진다. + +## 핵심 개념 +- 요약: ast 모듈로 코드를 분석하고 변환하는 기본기를 다룬다. +- 지식 축: 데코레이터, 디스크립터, 메타클래스 등 Python의 고급 메커니즘 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 고급 기능은 강력하지만 팀의 이해 비용도 함께 높인다. +- 추상화 이득이 분명할 때만 사용해야 유지보수성이 살아난다. +- 언어 내부 모델을 이해할수록 문제에 맞는 최소 추상화를 고를 수 있다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 고급 기능 도입 전 대체 가능한 단순한 방법이 없는지 먼저 본다. +- 팀이 읽고 수정할 수 있는 수준인지 확인한다. +- 추상화가 실제 반복 제거와 API 안정성에 기여하는지 검토한다. + +## 안티패턴 +- 멋있어 보여서 고급 문법을 먼저 적용한다. +- 설명 없이 메타프로그래밍을 남발한다. +- 디버깅 비용을 무시하고 추상화 층만 늘린다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[ast]] +- [[code transformation]] +- [[analysis]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/061_collections_모듈_핵심.md b/10_Wiki/Topics/Coding/Python/061_collections_모듈_핵심.md new file mode 100644 index 00000000..116fc0db --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/061_collections_모듈_핵심.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-061 +title: collections 모듈 핵심 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_collections_module] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_collections_module] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [collections, Counter, defaultdict] +--- + +# collections 모듈 핵심 + +## 한 줄 통찰 +> 표준 라이브러리 작은 도구를 알면 코드가 훨씬 또렷해진다. + +## 핵심 개념 +- 요약: Counter, defaultdict, OrderedDict, deque 등 핵심 컬렉션 유틸을 정리한다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[collections]] +- [[Counter]] +- [[defaultdict]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/062_itertools_사고법.md b/10_Wiki/Topics/Coding/Python/062_itertools_사고법.md new file mode 100644 index 00000000..6ec5c346 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/062_itertools_사고법.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-062 +title: itertools 사고법 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_itertools] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_itertools] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [itertools, iteration, lazy] +--- + +# itertools 사고법 + +## 한 줄 통찰 +> 반복 로직은 직접 구현보다 조합하는 쪽이 더 안전할 때가 많다. + +## 핵심 개념 +- 요약: itertools로 순회 조합과 파이프라인을 구성하는 패턴을 다룬다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[itertools]] +- [[iteration]] +- [[lazy]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/063_functools_실전.md b/10_Wiki/Topics/Coding/Python/063_functools_실전.md new file mode 100644 index 00000000..f86351b3 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/063_functools_실전.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-063 +title: functools 실전 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_functools] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_functools] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [functools, lru_cache, partial] +--- + +# functools 실전 + +## 한 줄 통찰 +> 함수 유틸은 작지만 설계 감각을 크게 바꿀 수 있다. + +## 핵심 개념 +- 요약: lru_cache, reduce, partial 등 functools 주요 도구를 정리한다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[functools]] +- [[lru_cache]] +- [[partial]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/064_operator_모듈.md b/10_Wiki/Topics/Coding/Python/064_operator_모듈.md new file mode 100644 index 00000000..a9f08a25 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/064_operator_모듈.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-064 +title: operator 모듈 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_operator_module] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_operator_module] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [operator, itemgetter, attrgetter] +--- + +# operator 모듈 + +## 한 줄 통찰 +> 작은 표준 함수들이 key extraction과 조합 코드를 더 읽기 쉽게 만든다. + +## 핵심 개념 +- 요약: operator 함수를 통한 함수형 스타일과 성능 미세 개선 포인트를 다룬다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[operator]] +- [[itemgetter]] +- [[attrgetter]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/065_pathlib_깊게_쓰기.md b/10_Wiki/Topics/Coding/Python/065_pathlib_깊게_쓰기.md new file mode 100644 index 00000000..c26345a5 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/065_pathlib_깊게_쓰기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-065 +title: pathlib 깊게 쓰기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pathlib_advanced] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_pathlib_advanced] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [pathlib, filesystem, glob] +--- + +# pathlib 깊게 쓰기 + +## 한 줄 통찰 +> 경로 연산을 문자열 덧붙이기로 처리하는 습관에서 빨리 벗어나는 게 좋다. + +## 핵심 개념 +- 요약: pathlib를 더 실무적으로 쓰는 패턴을 정리한다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[pathlib]] +- [[filesystem]] +- [[glob]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/066_tempfile과_안전한_임시_파일.md b/10_Wiki/Topics/Coding/Python/066_tempfile과_안전한_임시_파일.md new file mode 100644 index 00000000..a64faa51 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/066_tempfile과_안전한_임시_파일.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-066 +title: tempfile과 안전한 임시 파일 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_tempfile] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_tempfile] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [tempfile, filesystem, cleanup] +--- + +# tempfile과 안전한 임시 파일 + +## 한 줄 통찰 +> 임시 자원은 편하지만 수명과 정리 정책을 놓치기 쉽다. + +## 핵심 개념 +- 요약: 임시 파일과 디렉토리를 안전하게 다루는 패턴을 다룬다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[tempfile]] +- [[filesystem]] +- [[cleanup]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/067_shutil과_파일_작업.md b/10_Wiki/Topics/Coding/Python/067_shutil과_파일_작업.md new file mode 100644 index 00000000..05c52624 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/067_shutil과_파일_작업.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-067 +title: shutil과 파일 작업 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_shutil] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_shutil] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [shutil, copy, archive] +--- + +# shutil과 파일 작업 + +## 한 줄 통찰 +> 표준 도구를 쓰면 운영체제 차이와 예외 처리 부담을 줄일 수 있다. + +## 핵심 개념 +- 요약: 고수준 파일 조작과 복사/이동/아카이브 패턴을 정리한다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[shutil]] +- [[copy]] +- [[archive]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/068_glob와_파일_패턴_검색.md b/10_Wiki/Topics/Coding/Python/068_glob와_파일_패턴_검색.md new file mode 100644 index 00000000..aef01241 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/068_glob와_파일_패턴_검색.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-068 +title: glob와 파일 패턴 검색 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_glob] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_glob] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [glob, filesystem, patterns] +--- + +# glob와 파일 패턴 검색 + +## 한 줄 통찰 +> 파일 시스템 탐색도 표현 방식이 분명해야 버그가 줄어든다. + +## 핵심 개념 +- 요약: glob, pathlib.glob 기반 파일 탐색 패턴을 정리한다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[glob]] +- [[filesystem]] +- [[patterns]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/069_re와_정규표현식_실전.md b/10_Wiki/Topics/Coding/Python/069_re와_정규표현식_실전.md new file mode 100644 index 00000000..82a86fcc --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/069_re와_정규표현식_실전.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-069 +title: re와 정규표현식 실전 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_regex] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_regex] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [re, regex, text processing] +--- + +# re와 정규표현식 실전 + +## 한 줄 통찰 +> regex는 강력하지만 읽기 비용을 관리해야 한다. + +## 핵심 개념 +- 요약: 정규표현식의 실전 적용과 가독성 유지 기준을 다룬다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[re]] +- [[regex]] +- [[text processing]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/070_datetime과_시간대_처리.md b/10_Wiki/Topics/Coding/Python/070_datetime과_시간대_처리.md new file mode 100644 index 00000000..7c417a1b --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/070_datetime과_시간대_처리.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-070 +title: datetime과 시간대 처리 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_datetime_timezones] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_datetime_timezones] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [datetime, timezone, time] +--- + +# datetime과 시간대 처리 + +## 한 줄 통찰 +> 시간 문제는 항상 언젠가 터지므로 초기에 기준을 세워야 한다. + +## 핵심 개념 +- 요약: datetime, timezone-aware 처리와 실무 함정을 정리한다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[datetime]] +- [[timezone]] +- [[time]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/071_zoneinfo_현대적_사용법.md b/10_Wiki/Topics/Coding/Python/071_zoneinfo_현대적_사용법.md new file mode 100644 index 00000000..9939968a --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/071_zoneinfo_현대적_사용법.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-071 +title: zoneinfo 현대적 사용법 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_zoneinfo] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_zoneinfo] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [zoneinfo, timezone, datetime] +--- + +# zoneinfo 현대적 사용법 + +## 한 줄 통찰 +> 로컬 시간과 UTC 경계를 모호하게 두면 데이터 일관성이 무너진다. + +## 핵심 개념 +- 요약: 표준 zoneinfo 기반 시간대 처리 방식을 다룬다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[zoneinfo]] +- [[timezone]] +- [[datetime]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/072_decimal과_금융_계산.md b/10_Wiki/Topics/Coding/Python/072_decimal과_금융_계산.md new file mode 100644 index 00000000..85b58ebc --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/072_decimal과_금융_계산.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-072 +title: decimal과 금융 계산 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_decimal] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_decimal] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [decimal, money, precision] +--- + +# decimal과 금융 계산 + +## 한 줄 통찰 +> 정확도 요구가 높은 도메인에서는 숫자 타입이 곧 설계다. + +## 핵심 개념 +- 요약: 부동소수점 대신 decimal을 써야 하는 상황과 패턴을 정리한다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[decimal]] +- [[money]] +- [[precision]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/073_fractions와_유리수_표현.md b/10_Wiki/Topics/Coding/Python/073_fractions와_유리수_표현.md new file mode 100644 index 00000000..224cee56 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/073_fractions와_유리수_표현.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-073 +title: fractions와 유리수 표현 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_fractions] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_fractions] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [fractions, numeric, precision] +--- + +# fractions와 유리수 표현 + +## 한 줄 통찰 +> 문제에 맞는 수 표현을 쓰면 복잡한 보정 코드를 줄일 수 있다. + +## 핵심 개념 +- 요약: fractions 모듈의 활용 장면과 대체 기준을 다룬다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[fractions]] +- [[numeric]] +- [[precision]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/074_statistics_모듈.md b/10_Wiki/Topics/Coding/Python/074_statistics_모듈.md new file mode 100644 index 00000000..20347b46 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/074_statistics_모듈.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-074 +title: statistics 모듈 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_statistics_module] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_statistics_module] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [statistics, data, analysis] +--- + +# statistics 모듈 + +## 한 줄 통찰 +> 작은 분석까지 무조건 pandas로 갈 필요는 없다. + +## 핵심 개념 +- 요약: 표준 statistics 모듈로 간단 통계를 처리하는 기준을 정리한다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[statistics]] +- [[data]] +- [[analysis]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/075_random과_난수_제어.md b/10_Wiki/Topics/Coding/Python/075_random과_난수_제어.md new file mode 100644 index 00000000..99a80f19 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/075_random과_난수_제어.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-075 +title: random과 난수 제어 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_random_module] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_random_module] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [random, seeding, reproducibility] +--- + +# random과 난수 제어 + +## 한 줄 통찰 +> 난수도 목적에 따라 테스트용, 시뮬레이션용, 보안용을 나눠야 한다. + +## 핵심 개념 +- 요약: random 모듈의 사용법과 재현성, 보안 한계를 다룬다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[random]] +- [[seeding]] +- [[reproducibility]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/076_secrets와_보안_난수.md b/10_Wiki/Topics/Coding/Python/076_secrets와_보안_난수.md new file mode 100644 index 00000000..4018ff07 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/076_secrets와_보안_난수.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-076 +title: secrets와 보안 난수 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_secrets] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_secrets] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [secrets, security, tokens] +--- + +# secrets와 보안 난수 + +## 한 줄 통찰 +> 편한 난수와 안전한 난수는 다르다. + +## 핵심 개념 +- 요약: 보안 민감 난수 생성에 secrets를 써야 하는 이유를 정리한다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[secrets]] +- [[security]] +- [[tokens]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/077_hashlib와_해시_기초.md b/10_Wiki/Topics/Coding/Python/077_hashlib와_해시_기초.md new file mode 100644 index 00000000..2d295f15 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/077_hashlib와_해시_기초.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-077 +title: hashlib와 해시 기초 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_hashlib] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_hashlib] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [hashlib, sha256, integrity] +--- + +# hashlib와 해시 기초 + +## 한 줄 통찰 +> 해시는 보안 만능키가 아니라 목적에 맞는 도구 선택이 중요하다. + +## 핵심 개념 +- 요약: 해시 계산, 파일 검증, 무결성 체크 패턴을 다룬다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[hashlib]] +- [[sha256]] +- [[integrity]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/078_uuid와_식별자_생성.md b/10_Wiki/Topics/Coding/Python/078_uuid와_식별자_생성.md new file mode 100644 index 00000000..cccd944d --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/078_uuid와_식별자_생성.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-078 +title: uuid와 식별자 생성 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_uuid] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_uuid] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [uuid, identifier, data model] +--- + +# uuid와 식별자 생성 + +## 한 줄 통찰 +> 식별자는 데이터 모델과 운영 추적의 핵심 연결점이다. + +## 핵심 개념 +- 요약: uuid 생성 전략과 식별자 설계 시 고려사항을 정리한다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[uuid]] +- [[identifier]] +- [[data model]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/079_logging_표준_패턴.md b/10_Wiki/Topics/Coding/Python/079_logging_표준_패턴.md new file mode 100644 index 00000000..60148a40 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/079_logging_표준_패턴.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-079 +title: logging 표준 패턴 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_logging] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_logging] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [logging, observability, ops] +--- + +# logging 표준 패턴 + +## 한 줄 통찰 +> print에서 logging으로 넘어가는 순간 운영 관측성이 달라진다. + +## 핵심 개념 +- 요약: logging 모듈 기반 구조적 로그와 레벨 설계 기본을 다룬다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[logging]] +- [[observability]] +- [[ops]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/080_argparse로_CLI_만들기.md b/10_Wiki/Topics/Coding/Python/080_argparse로_CLI_만들기.md new file mode 100644 index 00000000..30f2edd5 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/080_argparse로_CLI_만들기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-080 +title: argparse로 CLI 만들기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_argparse] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, stdlib, python_argparse] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "stdlib" } +applied_in: [] +verification_status: conceptual +related_notes: [argparse, cli, tooling] +--- + +# argparse로 CLI 만들기 + +## 한 줄 통찰 +> 작은 자동화 도구일수록 CLI 품질이 생산성을 좌우한다. + +## 핵심 개념 +- 요약: argparse를 사용한 간단 CLI 설계와 구조를 정리한다. +- 지식 축: 표준 라이브러리와 내장 모듈을 활용해 의존성을 줄이는 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 표준 라이브러리를 알면 구현 속도와 이식성이 좋아진다. +- 내장 모듈은 운영 환경에서 기본 신뢰 자산이 된다. +- 표준 도구를 먼저 보는 습관이 과잉 라이브러리 도입을 막는다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 외부 패키지 도입 전에 표준 라이브러리 대안을 먼저 검토한다. +- 운영 환경 제약과 배포 편의성을 함께 본다. +- API의 단순함과 테스트 용이성을 기준으로 선택한다. + +## 안티패턴 +- 표준 라이브러리로 충분한데도 패키지를 추가한다. +- 운영 환경 제약을 무시하고 무거운 의존성을 들인다. +- 기본 모듈의 한계를 모른 채 과용한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[argparse]] +- [[cli]] +- [[tooling]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/081_typing_기본기.md b/10_Wiki/Topics/Coding/Python/081_typing_기본기.md new file mode 100644 index 00000000..bc054ecd --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/081_typing_기본기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-081 +title: typing 기본기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_typing_basics] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_typing_basics] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [typing, mypy, api design] +--- + +# typing 기본기 + +## 한 줄 통찰 +> 타입 힌트는 주석이 아니라 설계 의사소통 도구다. + +## 핵심 개념 +- 요약: 기본 타입 힌트 문법과 점진적 타입 도입 전략을 정리한다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[typing]] +- [[mypy]] +- [[api design]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/082_Optional과_Union_판단.md b/10_Wiki/Topics/Coding/Python/082_Optional과_Union_판단.md new file mode 100644 index 00000000..533f7a9e --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/082_Optional과_Union_판단.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-082 +title: Optional과 Union 판단 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_optional_union] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_optional_union] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [Optional, Union, None] +--- + +# Optional과 Union 판단 + +## 한 줄 통찰 +> None이 끼는 순간 API 경계가 더 중요한 설계 문제가 된다. + +## 핵심 개념 +- 요약: Optional, Union, None 처리 기준을 다룬다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Optional]] +- [[Union]] +- [[None]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/083_Literal과_제한된_값_모델링.md b/10_Wiki/Topics/Coding/Python/083_Literal과_제한된_값_모델링.md new file mode 100644 index 00000000..d003e769 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/083_Literal과_제한된_값_모델링.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-083 +title: Literal과 제한된 값 모델링 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_literal_types] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_literal_types] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [Literal, typing, domain model] +--- + +# Literal과 제한된 값 모델링 + +## 한 줄 통찰 +> 문자열 상수를 타입으로 끌어올리면 많은 실수를 미리 막을 수 있다. + +## 핵심 개념 +- 요약: Literal을 활용한 명시적 값 제한과 API 선명화 패턴을 정리한다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Literal]] +- [[typing]] +- [[domain model]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/084_TypedDict와_dict_스키마.md b/10_Wiki/Topics/Coding/Python/084_TypedDict와_dict_스키마.md new file mode 100644 index 00000000..104c0552 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/084_TypedDict와_dict_스키마.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-084 +title: TypedDict와 dict 스키마 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_typeddict] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_typeddict] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [TypedDict, schema, typing] +--- + +# TypedDict와 dict 스키마 + +## 한 줄 통찰 +> 느슨한 dict도 경계에서 스키마를 가지면 협업 비용이 크게 줄어든다. + +## 핵심 개념 +- 요약: TypedDict로 dict 구조를 타입화하는 기준을 다룬다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[TypedDict]] +- [[schema]] +- [[typing]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/085_Protocol_기반_구조적_타이핑.md b/10_Wiki/Topics/Coding/Python/085_Protocol_기반_구조적_타이핑.md new file mode 100644 index 00000000..cf41961a --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/085_Protocol_기반_구조적_타이핑.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-085 +title: Protocol 기반 구조적 타이핑 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_protocol_typing] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_protocol_typing] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [Protocol, duck typing, typing] +--- + +# Protocol 기반 구조적 타이핑 + +## 한 줄 통찰 +> 상속 없이도 계약을 표현할 수 있다는 점이 Python 타입 시스템의 큰 장점이다. + +## 핵심 개념 +- 요약: duck typing과 정적 타입을 연결하는 Protocol 설계 방식을 다룬다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Protocol]] +- [[duck typing]] +- [[typing]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/086_Generic_타입_설계.md b/10_Wiki/Topics/Coding/Python/086_Generic_타입_설계.md new file mode 100644 index 00000000..ee66b91b --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/086_Generic_타입_설계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-086 +title: Generic 타입 설계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_generics] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_generics] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [Generic, TypeVar, typing] +--- + +# Generic 타입 설계 + +## 한 줄 통찰 +> 제네릭은 재사용성을 높이지만 복잡도 비용도 함께 온다. + +## 핵심 개념 +- 요약: 제네릭 타입과 TypeVar 사용 기준을 정리한다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Generic]] +- [[TypeVar]] +- [[typing]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/087_ParamSpec과_Callable_모델링.md b/10_Wiki/Topics/Coding/Python/087_ParamSpec과_Callable_모델링.md new file mode 100644 index 00000000..f85e0aeb --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/087_ParamSpec과_Callable_모델링.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-087 +title: ParamSpec과 Callable 모델링 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_paramspec_callable] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_paramspec_callable] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [ParamSpec, Callable, decorator] +--- + +# ParamSpec과 Callable 모델링 + +## 한 줄 통찰 +> 함수를 감싸는 순간 타입 정보 보존이 설계 품질이 된다. + +## 핵심 개념 +- 요약: 고차 함수와 decorator를 타입 안전하게 표현하는 방법을 다룬다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[ParamSpec]] +- [[Callable]] +- [[decorator]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/088_TypeAlias와_의미_있는_타입_이름.md b/10_Wiki/Topics/Coding/Python/088_TypeAlias와_의미_있는_타입_이름.md new file mode 100644 index 00000000..83ee393a --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/088_TypeAlias와_의미_있는_타입_이름.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-088 +title: TypeAlias와 의미 있는 타입 이름 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_typealias] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_typealias] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [TypeAlias, domain language, typing] +--- + +# TypeAlias와 의미 있는 타입 이름 + +## 한 줄 통찰 +> 좋은 타입 이름 하나가 문서 여러 줄을 대신할 수 있다. + +## 핵심 개념 +- 요약: TypeAlias를 통해 도메인 의미를 코드에 드러내는 패턴을 정리한다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[TypeAlias]] +- [[domain language]] +- [[typing]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/089_NewType로_도메인_경계_강화.md b/10_Wiki/Topics/Coding/Python/089_NewType로_도메인_경계_강화.md new file mode 100644 index 00000000..7eefbf71 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/089_NewType로_도메인_경계_강화.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-089 +title: NewType로 도메인 경계 강화 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_newtype] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_newtype] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [NewType, domain model, typing] +--- + +# NewType로 도메인 경계 강화 + +## 한 줄 통찰 +> 숫자와 문자열이 같아 보여도 도메인 의미는 다를 수 있다. + +## 핵심 개념 +- 요약: NewType을 사용해 같은 원시 타입이라도 다른 의미를 구분하는 기준을 다룬다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[NewType]] +- [[domain model]] +- [[typing]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/090_Self_타입과_fluent_API.md b/10_Wiki/Topics/Coding/Python/090_Self_타입과_fluent_API.md new file mode 100644 index 00000000..5883d1b2 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/090_Self_타입과_fluent_API.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-090 +title: Self 타입과 fluent API +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_self_type] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_self_type] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [Self, fluent api, typing] +--- + +# Self 타입과 fluent API + +## 한 줄 통찰 +> 타입 시스템이 자기 반환 API를 이해하면 리팩토링이 쉬워진다. + +## 핵심 개념 +- 요약: Self 타입을 통한 메서드 체이닝과 자기 참조 패턴을 정리한다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Self]] +- [[fluent api]] +- [[typing]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/091_mypy_운영_전략.md b/10_Wiki/Topics/Coding/Python/091_mypy_운영_전략.md new file mode 100644 index 00000000..6cf66463 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/091_mypy_운영_전략.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-091 +title: mypy 운영 전략 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_mypy_strategy] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_mypy_strategy] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [mypy, strictness, tooling] +--- + +# mypy 운영 전략 + +## 한 줄 통찰 +> 타입 도입은 기술 문제이자 팀 운영 문제다. + +## 핵심 개념 +- 요약: mypy를 팀에 도입하고 점진적으로 엄격도를 높이는 방법을 다룬다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[mypy]] +- [[strictness]] +- [[tooling]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/092_pyright와_타입_검사_도구_비교.md b/10_Wiki/Topics/Coding/Python/092_pyright와_타입_검사_도구_비교.md new file mode 100644 index 00000000..613943bb --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/092_pyright와_타입_검사_도구_비교.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-092 +title: pyright와 타입 검사 도구 비교 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pyright_comparison] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_pyright_comparison] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [pyright, mypy, type checker] +--- + +# pyright와 타입 검사 도구 비교 + +## 한 줄 통찰 +> 도구 선택은 기능보다 팀 속도와 피드백 루프를 봐야 한다. + +## 핵심 개념 +- 요약: pyright, mypy 등 타입 검사 도구 선택 기준을 정리한다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[pyright]] +- [[mypy]] +- [[type checker]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/093_런타임_검증과_pydantic.md b/10_Wiki/Topics/Coding/Python/093_런타임_검증과_pydantic.md new file mode 100644 index 00000000..ae13338e --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/093_런타임_검증과_pydantic.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-093 +title: 런타임 검증과 pydantic +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_runtime_validation] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_runtime_validation] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [pydantic, validation, typing] +--- + +# 런타임 검증과 pydantic + +## 한 줄 통찰 +> 타입 힌트만으로 외부 입력을 믿으면 경계에서 깨진다. + +## 핵심 개념 +- 요약: 정적 타입과 런타임 데이터 검증의 역할 분리를 다룬다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[pydantic]] +- [[validation]] +- [[typing]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/094_dataclass와_타입_힌트_조합.md b/10_Wiki/Topics/Coding/Python/094_dataclass와_타입_힌트_조합.md new file mode 100644 index 00000000..f19157be --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/094_dataclass와_타입_힌트_조합.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-094 +title: dataclass와 타입 힌트 조합 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_dataclass_typing] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_dataclass_typing] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [dataclass, typing, models] +--- + +# dataclass와 타입 힌트 조합 + +## 한 줄 통찰 +> 모델 정의는 간결하되 의미는 선명해야 한다. + +## 핵심 개념 +- 요약: dataclass와 타입 힌트를 결합해 도메인 모델을 정리하는 기준을 다룬다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[dataclass]] +- [[typing]] +- [[models]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/095_attrs와_dataclass_비교.md b/10_Wiki/Topics/Coding/Python/095_attrs와_dataclass_비교.md new file mode 100644 index 00000000..f84199b3 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/095_attrs와_dataclass_비교.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-095 +title: attrs와 dataclass 비교 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_attrs_vs_dataclass] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_attrs_vs_dataclass] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [attrs, dataclass, modeling] +--- + +# attrs와 dataclass 비교 + +## 한 줄 통찰 +> 도구 비교는 기능표보다 실제 모델링 요구로 봐야 한다. + +## 핵심 개념 +- 요약: attrs와 dataclass의 장단점과 선택 기준을 정리한다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[attrs]] +- [[dataclass]] +- [[modeling]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/096_타입_힌트_성능_오해_바로잡기.md b/10_Wiki/Topics/Coding/Python/096_타입_힌트_성능_오해_바로잡기.md new file mode 100644 index 00000000..8231488a --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/096_타입_힌트_성능_오해_바로잡기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-096 +title: 타입 힌트 성능 오해 바로잡기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_typing_performance] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_typing_performance] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [typing, performance, misconceptions] +--- + +# 타입 힌트 성능 오해 바로잡기 + +## 한 줄 통찰 +> 타입 힌트는 주로 개발 생산성 자산이지 성능 기능이 아니다. + +## 핵심 개념 +- 요약: 타입 힌트가 성능에 미치는 실제 영향과 오해를 정리한다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[typing]] +- [[performance]] +- [[misconceptions]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/097_문서화와_타입의_관계.md b/10_Wiki/Topics/Coding/Python/097_문서화와_타입의_관계.md new file mode 100644 index 00000000..41974faf --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/097_문서화와_타입의_관계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-097 +title: 문서화와 타입의 관계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_docs_and_types] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_docs_and_types] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [docstring, typing, documentation] +--- + +# 문서화와 타입의 관계 + +## 한 줄 통찰 +> 타입만으로 전달되지 않는 의도는 문서가 채워야 한다. + +## 핵심 개념 +- 요약: 문서 문자열과 타입 힌트를 어떻게 함께 설계할지 다룬다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[docstring]] +- [[typing]] +- [[documentation]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/098_공개_API_타입_안정성.md b/10_Wiki/Topics/Coding/Python/098_공개_API_타입_안정성.md new file mode 100644 index 00000000..b233dcfb --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/098_공개_API_타입_안정성.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-098 +title: 공개 API 타입 안정성 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_public_api_typing] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_public_api_typing] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [api, typing, library design] +--- + +# 공개 API 타입 안정성 + +## 한 줄 통찰 +> 공개 API의 타입 품질은 사용자 경험의 일부다. + +## 핵심 개념 +- 요약: 라이브러리/패키지 공개 API에서 타입 안정성을 확보하는 기준을 다룬다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[api]] +- [[typing]] +- [[library design]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/099_테스트_코드에도_타입을_붙일_것인가.md b/10_Wiki/Topics/Coding/Python/099_테스트_코드에도_타입을_붙일_것인가.md new file mode 100644 index 00000000..39af4d48 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/099_테스트_코드에도_타입을_붙일_것인가.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-099 +title: 테스트 코드에도 타입을 붙일 것인가 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_typed_tests] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_typed_tests] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [tests, typing, mypy] +--- + +# 테스트 코드에도 타입을 붙일 것인가 + +## 한 줄 통찰 +> 모든 곳에 같은 엄격도를 강요하기보다 효율적인 범위를 정해야 한다. + +## 핵심 개념 +- 요약: 테스트 코드 타입 적용 범위와 실용적 기준을 정리한다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[tests]] +- [[typing]] +- [[mypy]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/100_타입_기반_리팩토링.md b/10_Wiki/Topics/Coding/Python/100_타입_기반_리팩토링.md new file mode 100644 index 00000000..b99480fb --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/100_타입_기반_리팩토링.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-100 +title: 타입 기반 리팩토링 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_type_refactoring] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, typing, python_type_refactoring] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "typing" } +applied_in: [] +verification_status: conceptual +related_notes: [refactoring, typing, safety] +--- + +# 타입 기반 리팩토링 + +## 한 줄 통찰 +> 좋은 타입은 변경을 막는 족쇄가 아니라 변경을 돕는 지도다. + +## 핵심 개념 +- 요약: 타입 정보를 활용해 안전하게 코드 구조를 바꾸는 전략을 다룬다. +- 지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다. +- 정확한 타입은 리팩토링 자신감을 높인다. +- 점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 경계와 공개 API부터 타입을 강화한다. +- 복잡한 타입은 가독성과 안정성의 균형을 본다. +- 런타임 검증과 정적 타입의 역할을 분리한다. + +## 안티패턴 +- 타입을 형식 체크용 장식으로만 붙인다. +- 과도한 타입 마법으로 가독성을 해친다. +- 공개 API에 타입 기준이 없어 협업 비용을 키운다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[refactoring]] +- [[typing]] +- [[safety]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/101_asyncio_기본기.md b/10_Wiki/Topics/Coding/Python/101_asyncio_기본기.md new file mode 100644 index 00000000..47097472 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/101_asyncio_기본기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-101 +title: asyncio 기본기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_asyncio_basics] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_asyncio_basics] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [asyncio, event loop, coroutine] +--- + +# asyncio 기본기 + +## 한 줄 통찰 +> 비동기는 문법보다 실행 모델을 이해해야 안전하게 쓸 수 있다. + +## 핵심 개념 +- 요약: 이벤트 루프, coroutine, task 등 asyncio 기초를 정리한다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[asyncio]] +- [[event loop]] +- [[coroutine]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/102_coroutine과_await_의미론.md b/10_Wiki/Topics/Coding/Python/102_coroutine과_await_의미론.md new file mode 100644 index 00000000..daac81ff --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/102_coroutine과_await_의미론.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-102 +title: coroutine과 await 의미론 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_coroutines_await] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_coroutines_await] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [await, coroutine, scheduling] +--- + +# coroutine과 await 의미론 + +## 한 줄 통찰 +> await 한 줄이 제어 흐름을 넘기는 지점이라는 감각이 중요하다. + +## 핵심 개념 +- 요약: await가 실제로 무엇을 하는지와 coroutine 모델을 다룬다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[await]] +- [[coroutine]] +- [[scheduling]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/103_Task_생성과_관리.md b/10_Wiki/Topics/Coding/Python/103_Task_생성과_관리.md new file mode 100644 index 00000000..3beb6c29 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/103_Task_생성과_관리.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-103 +title: Task 생성과 관리 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_asyncio_tasks] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_asyncio_tasks] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [Task, gather, asyncio] +--- + +# Task 생성과 관리 + +## 한 줄 통찰 +> 태스크는 만들기보다 수명과 실패 전파를 관리하는 것이 더 어렵다. + +## 핵심 개념 +- 요약: create_task, gather, wait 등 task 관리 패턴을 정리한다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Task]] +- [[gather]] +- [[asyncio]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/104_cancelation_설계.md b/10_Wiki/Topics/Coding/Python/104_cancelation_설계.md new file mode 100644 index 00000000..d21b0abe --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/104_cancelation_설계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-104 +title: cancelation 설계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_async_cancellation] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_async_cancellation] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [cancellation, cleanup, asyncio] +--- + +# cancelation 설계 + +## 한 줄 통찰 +> 취소는 예외 상황이 아니라 기본 흐름으로 설계해야 한다. + +## 핵심 개념 +- 요약: 비동기 cancellation 흐름과 안전한 정리 패턴을 다룬다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[cancellation]] +- [[cleanup]] +- [[asyncio]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/105_timeout과_경계_제어.md b/10_Wiki/Topics/Coding/Python/105_timeout과_경계_제어.md new file mode 100644 index 00000000..0a441032 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/105_timeout과_경계_제어.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-105 +title: timeout과 경계 제어 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_async_timeouts] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_async_timeouts] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [timeout, asyncio, reliability] +--- + +# timeout과 경계 제어 + +## 한 줄 통찰 +> 무한 대기는 종종 가장 비싼 운영 버그다. + +## 핵심 개념 +- 요약: 비동기 작업의 timeout 정책과 실패 경계를 정리한다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[timeout]] +- [[asyncio]] +- [[reliability]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/106_Semaphore와_동시성_제한.md b/10_Wiki/Topics/Coding/Python/106_Semaphore와_동시성_제한.md new file mode 100644 index 00000000..177a7621 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/106_Semaphore와_동시성_제한.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-106 +title: Semaphore와 동시성 제한 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_async_semaphore] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_async_semaphore] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [Semaphore, backpressure, asyncio] +--- + +# Semaphore와 동시성 제한 + +## 한 줄 통찰 +> 빠름보다 시스템을 무너뜨리지 않는 속도가 중요하다. + +## 핵심 개념 +- 요약: 비동기에서 동시 실행 수를 제한하는 패턴을 다룬다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Semaphore]] +- [[backpressure]] +- [[asyncio]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/107_Queue_기반_producer-consumer.md b/10_Wiki/Topics/Coding/Python/107_Queue_기반_producer-consumer.md new file mode 100644 index 00000000..7f8da8d9 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/107_Queue_기반_producer-consumer.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-107 +title: Queue 기반 producer-consumer +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_async_queue] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_async_queue] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [Queue, producer consumer, asyncio] +--- + +# Queue 기반 producer-consumer + +## 한 줄 통찰 +> 파이프라인은 순서보다 흐름과 압력 제어를 봐야 한다. + +## 핵심 개념 +- 요약: asyncio.Queue로 생산자-소비자 파이프라인을 구성하는 방법을 정리한다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Queue]] +- [[producer consumer]] +- [[asyncio]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/108_async_context_manager.md b/10_Wiki/Topics/Coding/Python/108_async_context_manager.md new file mode 100644 index 00000000..3a35fa7d --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/108_async_context_manager.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-108 +title: async context manager +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_async_context_manager] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_async_context_manager] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [async with, context manager, resource management] +--- + +# async context manager + +## 한 줄 통찰 +> 비동기 자원도 정리 규칙이 명확해야 누수와 좀비 연결을 막을 수 있다. + +## 핵심 개념 +- 요약: 비동기 자원 생명주기를 with로 다루는 패턴을 정리한다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[async with]] +- [[context manager]] +- [[resource management]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/109_threading_기본과_GIL.md b/10_Wiki/Topics/Coding/Python/109_threading_기본과_GIL.md new file mode 100644 index 00000000..35fa4c5c --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/109_threading_기본과_GIL.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-109 +title: threading 기본과 GIL +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_threading_gil] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_threading_gil] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [threading, GIL, concurrency] +--- + +# threading 기본과 GIL + +## 한 줄 통찰 +> GIL은 'thread 쓸모없음'이 아니라 CPU와 I/O 경계 이해 문제다. + +## 핵심 개념 +- 요약: GIL의 의미와 threading이 유효한 장면을 정리한다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[threading]] +- [[GIL]] +- [[concurrency]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/110_concurrentfutures_실전.md b/10_Wiki/Topics/Coding/Python/110_concurrentfutures_실전.md new file mode 100644 index 00000000..63a6efd4 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/110_concurrentfutures_실전.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-110 +title: concurrent.futures 실전 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_concurrent_futures] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_concurrent_futures] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [concurrent.futures, executor, parallelism] +--- + +# concurrent.futures 실전 + +## 한 줄 통찰 +> 풀 기반 병렬 처리는 편하지만 작업 크기와 직렬화 비용을 봐야 한다. + +## 핵심 개념 +- 요약: ThreadPoolExecutor와 ProcessPoolExecutor 선택 기준을 다룬다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[concurrent.futures]] +- [[executor]] +- [[parallelism]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/111_multiprocessing와_프로세스_병렬.md b/10_Wiki/Topics/Coding/Python/111_multiprocessing와_프로세스_병렬.md new file mode 100644 index 00000000..5db4cb18 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/111_multiprocessing와_프로세스_병렬.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-111 +title: multiprocessing와 프로세스 병렬 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_multiprocessing] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_multiprocessing] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [multiprocessing, process, cpu bound] +--- + +# multiprocessing와 프로세스 병렬 + +## 한 줄 통찰 +> CPU 병렬은 늘 이득이 아니라 데이터 이동 비용과의 싸움이다. + +## 핵심 개념 +- 요약: 프로세스 기반 병렬 처리와 직렬화/초기화 비용을 정리한다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[multiprocessing]] +- [[process]] +- [[cpu bound]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/112_subprocess_안전하게_쓰기.md b/10_Wiki/Topics/Coding/Python/112_subprocess_안전하게_쓰기.md new file mode 100644 index 00000000..53cce7f3 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/112_subprocess_안전하게_쓰기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-112 +title: subprocess 안전하게 쓰기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_subprocess] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_subprocess] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [subprocess, shell, security] +--- + +# subprocess 안전하게 쓰기 + +## 한 줄 통찰 +> 쉘 호출은 강력하지만 경계와 입력 신뢰도를 엄격히 봐야 한다. + +## 핵심 개념 +- 요약: 외부 프로세스 실행과 I/O 처리, 보안 기준을 다룬다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[subprocess]] +- [[shell]] +- [[security]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/113_signal_처리와_graceful_shutdown.md b/10_Wiki/Topics/Coding/Python/113_signal_처리와_graceful_shutdown.md new file mode 100644 index 00000000..7bedf24b --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/113_signal_처리와_graceful_shutdown.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-113 +title: signal 처리와 graceful shutdown +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_signals_shutdown] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_signals_shutdown] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [signal, shutdown, ops] +--- + +# signal 처리와 graceful shutdown + +## 한 줄 통찰 +> 종료 품질은 운영 시스템의 성숙도를 보여준다. + +## 핵심 개념 +- 요약: 신호 처리와 정상 종료 설계 패턴을 정리한다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[signal]] +- [[shutdown]] +- [[ops]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/114_asyncio와_blocking_코드_섞기.md b/10_Wiki/Topics/Coding/Python/114_asyncio와_blocking_코드_섞기.md new file mode 100644 index 00000000..fe378906 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/114_asyncio와_blocking_코드_섞기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-114 +title: asyncio와 blocking 코드 섞기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_async_blocking_bridge] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_async_blocking_bridge] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [asyncio, blocking, executor] +--- + +# asyncio와 blocking 코드 섞기 + +## 한 줄 통찰 +> 한 줄의 blocking 호출이 전체 이벤트 루프를 멈출 수 있다. + +## 핵심 개념 +- 요약: 비동기 루프 안에서 blocking 함수를 다루는 안전한 전략을 정리한다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[asyncio]] +- [[blocking]] +- [[executor]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/115_backpressure_개념과_Python_구현.md b/10_Wiki/Topics/Coding/Python/115_backpressure_개념과_Python_구현.md new file mode 100644 index 00000000..482dd1c0 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/115_backpressure_개념과_Python_구현.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-115 +title: backpressure 개념과 Python 구현 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_backpressure] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_backpressure] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [backpressure, queue, streaming] +--- + +# backpressure 개념과 Python 구현 + +## 한 줄 통찰 +> 처리량보다 흐름 제어를 이해하는 순간 시스템 안정성이 올라간다. + +## 핵심 개념 +- 요약: 입력 속도와 처리 속도 불균형을 제어하는 패턴을 다룬다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[backpressure]] +- [[queue]] +- [[streaming]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/116_웹소켓_서버의_비동기_패턴.md b/10_Wiki/Topics/Coding/Python/116_웹소켓_서버의_비동기_패턴.md new file mode 100644 index 00000000..1d939b04 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/116_웹소켓_서버의_비동기_패턴.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-116 +title: 웹소켓 서버의 비동기 패턴 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_websocket_async] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_websocket_async] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [websocket, asyncio, realtime] +--- + +# 웹소켓 서버의 비동기 패턴 + +## 한 줄 통찰 +> 실시간 서버는 연결 수명과 fan-out 비용을 항상 같이 봐야 한다. + +## 핵심 개념 +- 요약: 웹소켓 기반 실시간 서버에서 asyncio 설계 포인트를 정리한다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[websocket]] +- [[asyncio]] +- [[realtime]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/117_async_generator와_streaming_API.md b/10_Wiki/Topics/Coding/Python/117_async_generator와_streaming_API.md new file mode 100644 index 00000000..45638bc2 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/117_async_generator와_streaming_API.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-117 +title: async generator와 streaming API +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_async_generators] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_async_generators] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [async generator, streaming, api] +--- + +# async generator와 streaming API + +## 한 줄 통찰 +> 스트리밍은 데이터 형식보다 전달 리듬 설계가 중요하다. + +## 핵심 개념 +- 요약: 비동기 스트리밍 응답을 모델링하는 async generator 패턴을 정리한다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[async generator]] +- [[streaming]] +- [[api]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/118_trio와_anyio_관점.md b/10_Wiki/Topics/Coding/Python/118_trio와_anyio_관점.md new file mode 100644 index 00000000..2c1dfb7f --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/118_trio와_anyio_관점.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-118 +title: trio와 anyio 관점 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_trio_anyio] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_trio_anyio] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [trio, anyio, structured concurrency] +--- + +# trio와 anyio 관점 + +## 한 줄 통찰 +> API 차이보다 취소 모델과 구조적 동시성 철학이 더 중요하다. + +## 핵심 개념 +- 요약: asyncio와 다른 동시성 프레임워크의 철학 차이를 다룬다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[trio]] +- [[anyio]] +- [[structured concurrency]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/119_구조적_동시성.md b/10_Wiki/Topics/Coding/Python/119_구조적_동시성.md new file mode 100644 index 00000000..0e504df8 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/119_구조적_동시성.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-119 +title: 구조적 동시성 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_structured_concurrency] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_structured_concurrency] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [structured concurrency, TaskGroup, asyncio] +--- + +# 구조적 동시성 + +## 한 줄 통찰 +> 태스크를 던져놓기보다 수명을 구조화해야 예측 가능성이 생긴다. + +## 핵심 개념 +- 요약: 작업 수명을 부모-자식 구조로 다루는 접근을 정리한다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[structured concurrency]] +- [[TaskGroup]] +- [[asyncio]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/120_비동기_디버깅.md b/10_Wiki/Topics/Coding/Python/120_비동기_디버깅.md new file mode 100644 index 00000000..2a25f5d1 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/120_비동기_디버깅.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-120 +title: 비동기 디버깅 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_async_debugging] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, async, python_async_debugging] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "async" } +applied_in: [] +verification_status: conceptual +related_notes: [debugging, asyncio, observability] +--- + +# 비동기 디버깅 + +## 한 줄 통찰 +> 비동기 버그는 코드보다 타이밍과 상태 전이를 봐야 잡힌다. + +## 핵심 개념 +- 요약: 비동기 코드에서 재현과 추적, 상태 가시성을 높이는 방법을 정리한다. +- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다. +- asyncio, threads, processes는 서로 다른 비용 구조를 가진다. +- 정확한 cancellation, timeout, backpressure 설계가 중요하다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- I/O bound와 CPU bound를 먼저 구분한다. +- 동시성 도입 전 단순 구조로 충분한지 검토한다. +- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다. + +## 안티패턴 +- 비동기를 만능 성능 해법처럼 쓴다. +- 취소와 종료 흐름을 설계하지 않는다. +- 공유 상태 경쟁 조건을 무시한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[debugging]] +- [[asyncio]] +- [[observability]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/121_pytest_기본기.md b/10_Wiki/Topics/Coding/Python/121_pytest_기본기.md new file mode 100644 index 00000000..4d53dd2e --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/121_pytest_기본기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-121 +title: pytest 기본기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pytest_basics] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_pytest_basics] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [pytest, tests, assertions] +--- + +# pytest 기본기 + +## 한 줄 통찰 +> 좋은 테스트 도구는 코드보다 사고 방식을 바꾼다. + +## 핵심 개념 +- 요약: pytest의 핵심 철학과 기본 테스트 작성법을 정리한다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[pytest]] +- [[tests]] +- [[assertions]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/122_fixture_설계.md b/10_Wiki/Topics/Coding/Python/122_fixture_설계.md new file mode 100644 index 00000000..82be680c --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/122_fixture_설계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-122 +title: fixture 설계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pytest_fixtures] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_pytest_fixtures] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [fixture, pytest, test architecture] +--- + +# fixture 설계 + +## 한 줄 통찰 +> fixture는 편의 기능이 아니라 테스트 의존성 모델이다. + +## 핵심 개념 +- 요약: pytest fixture의 수명과 의존 구조를 실무적으로 다룬다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[fixture]] +- [[pytest]] +- [[test architecture]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/123_parameterized_tests.md b/10_Wiki/Topics/Coding/Python/123_parameterized_tests.md new file mode 100644 index 00000000..8a3e4300 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/123_parameterized_tests.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-123 +title: parameterized tests +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pytest_parametrize] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_pytest_parametrize] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [parametrize, pytest, cases] +--- + +# parameterized tests + +## 한 줄 통찰 +> 반복 테스트는 복붙보다 데이터 구조로 표현할 때 더 읽기 쉽다. + +## 핵심 개념 +- 요약: pytest.mark.parametrize로 케이스를 구조화하는 방식을 정리한다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[parametrize]] +- [[pytest]] +- [[cases]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/124_mock와_monkeypatch.md b/10_Wiki/Topics/Coding/Python/124_mock와_monkeypatch.md new file mode 100644 index 00000000..fcd7c053 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/124_mock와_monkeypatch.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-124 +title: mock와 monkeypatch +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_mock_monkeypatch] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_mock_monkeypatch] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [mock, monkeypatch, dependency isolation] +--- + +# mock와 monkeypatch + +## 한 줄 통찰 +> mock는 빠른 해결책이지만 설계 냄새를 감추는 도구가 되기 쉽다. + +## 핵심 개념 +- 요약: 외부 의존을 격리하는 mock/monkeypatch 사용 기준을 정리한다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[mock]] +- [[monkeypatch]] +- [[dependency isolation]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/125_통합_테스트_경계_설계.md b/10_Wiki/Topics/Coding/Python/125_통합_테스트_경계_설계.md new file mode 100644 index 00000000..4ac92e40 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/125_통합_테스트_경계_설계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-125 +title: 통합 테스트 경계 설계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_integration_testing] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_integration_testing] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [integration test, boundaries, pytest] +--- + +# 통합 테스트 경계 설계 + +## 한 줄 통찰 +> 현실과 닿는 테스트가 있어야 자신감 있는 배포가 가능하다. + +## 핵심 개념 +- 요약: 단위 테스트와 통합 테스트 사이의 적절한 경계를 다룬다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[integration test]] +- [[boundaries]] +- [[pytest]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/126_property-based_testing_with_Hypothesis.md b/10_Wiki/Topics/Coding/Python/126_property-based_testing_with_Hypothesis.md new file mode 100644 index 00000000..0f2a6ef7 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/126_property-based_testing_with_Hypothesis.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-126 +title: property-based testing with Hypothesis +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_hypothesis] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_hypothesis] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [Hypothesis, property testing, pytest] +--- + +# property-based testing with Hypothesis + +## 한 줄 통찰 +> 예시보다 규칙을 테스트하면 더 넓은 버그 공간을 만날 수 있다. + +## 핵심 개념 +- 요약: Hypothesis를 이용한 속성 기반 테스트 사고법을 정리한다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Hypothesis]] +- [[property testing]] +- [[pytest]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/127_snapshot_testing_신중하게_쓰기.md b/10_Wiki/Topics/Coding/Python/127_snapshot_testing_신중하게_쓰기.md new file mode 100644 index 00000000..cbecf290 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/127_snapshot_testing_신중하게_쓰기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-127 +title: snapshot testing 신중하게 쓰기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_snapshot_testing] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_snapshot_testing] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [snapshot, regression, tests] +--- + +# snapshot testing 신중하게 쓰기 + +## 한 줄 통찰 +> 빠른 회귀 방지가 곧 의미 있는 테스트는 아니다. + +## 핵심 개념 +- 요약: 스냅샷 테스트의 장점과 오남용 위험을 정리한다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[snapshot]] +- [[regression]] +- [[tests]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/128_coverage_해석.md b/10_Wiki/Topics/Coding/Python/128_coverage_해석.md new file mode 100644 index 00000000..419c54bc --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/128_coverage_해석.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-128 +title: coverage 해석 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_coverage] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_coverage] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [coverage, quality, tests] +--- + +# coverage 해석 + +## 한 줄 통찰 +> coverage는 지도이지 목적지가 아니다. + +## 핵심 개념 +- 요약: coverage 지표를 어떻게 읽고 어디까지 신뢰할지 정리한다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[coverage]] +- [[quality]] +- [[tests]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/129_mutation_testing_in_Python.md b/10_Wiki/Topics/Coding/Python/129_mutation_testing_in_Python.md new file mode 100644 index 00000000..3f227135 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/129_mutation_testing_in_Python.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-129 +title: mutation testing in Python +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_mutation_testing] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_mutation_testing] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [mutation testing, mutmut, quality] +--- + +# mutation testing in Python + +## 한 줄 통찰 +> 테스트가 있는 것과 강한 것은 다르다. + +## 핵심 개념 +- 요약: mutmut 등 도구를 통한 mutation testing 의미를 정리한다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[mutation testing]] +- [[mutmut]] +- [[quality]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/130_tox와_nox_기반_테스트_매트릭스.md b/10_Wiki/Topics/Coding/Python/130_tox와_nox_기반_테스트_매트릭스.md new file mode 100644 index 00000000..b5cdf38c --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/130_tox와_nox_기반_테스트_매트릭스.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-130 +title: tox와 nox 기반 테스트 매트릭스 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_tox_nox] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_tox_nox] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [tox, nox, ci] +--- + +# tox와 nox 기반 테스트 매트릭스 + +## 한 줄 통찰 +> 환경 차이를 초기에 잡아야 배포 후 놀라지 않는다. + +## 핵심 개념 +- 요약: 여러 버전과 환경에서 테스트를 돌리는 전략을 다룬다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[tox]] +- [[nox]] +- [[ci]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/131_doctest_활용_기준.md b/10_Wiki/Topics/Coding/Python/131_doctest_활용_기준.md new file mode 100644 index 00000000..e9b35931 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/131_doctest_활용_기준.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-131 +title: doctest 활용 기준 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_doctest] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_doctest] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [doctest, documentation, tests] +--- + +# doctest 활용 기준 + +## 한 줄 통찰 +> 예제 문서가 실제로 실행된다는 사실은 큰 신뢰 자산이 된다. + +## 핵심 개념 +- 요약: doctest를 문서와 검증에 어떻게 활용할지 정리한다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[doctest]] +- [[documentation]] +- [[tests]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/132_logging_기반_디버깅.md b/10_Wiki/Topics/Coding/Python/132_logging_기반_디버깅.md new file mode 100644 index 00000000..bbca84b1 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/132_logging_기반_디버깅.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-132 +title: logging 기반 디버깅 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_debug_logging] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_debug_logging] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [logging, debugging, observability] +--- + +# logging 기반 디버깅 + +## 한 줄 통찰 +> 디버깅은 출력이 아니라 질문을 남기는 로그에서 시작된다. + +## 핵심 개념 +- 요약: 로그를 이용해 재현 조건과 상태 전이를 추적하는 방식을 정리한다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[logging]] +- [[debugging]] +- [[observability]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/133_pdb와_디버거_사용법.md b/10_Wiki/Topics/Coding/Python/133_pdb와_디버거_사용법.md new file mode 100644 index 00000000..7a68f6f4 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/133_pdb와_디버거_사용법.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-133 +title: pdb와 디버거 사용법 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pdb] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_pdb] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [pdb, debugger, inspection] +--- + +# pdb와 디버거 사용법 + +## 한 줄 통찰 +> 멈춰서 보는 감각이 생기면 추측성 디버깅이 줄어든다. + +## 핵심 개념 +- 요약: pdb와 인터랙티브 디버깅의 기본 흐름을 정리한다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[pdb]] +- [[debugger]] +- [[inspection]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/134_프로파일링_기초.md b/10_Wiki/Topics/Coding/Python/134_프로파일링_기초.md new file mode 100644 index 00000000..f3d4270f --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/134_프로파일링_기초.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-134 +title: 프로파일링 기초 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_profiling_basics] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_profiling_basics] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [profiling, cProfile, performance] +--- + +# 프로파일링 기초 + +## 한 줄 통찰 +> 느리다는 감상 대신 어디가 느린지 측정하는 습관이 중요하다. + +## 핵심 개념 +- 요약: cProfile, pstats 등으로 병목을 찾는 기본기를 다룬다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[profiling]] +- [[cProfile]] +- [[performance]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/135_메모리_프로파일링.md b/10_Wiki/Topics/Coding/Python/135_메모리_프로파일링.md new file mode 100644 index 00000000..270a8298 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/135_메모리_프로파일링.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-135 +title: 메모리 프로파일링 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_memory_profiling] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_memory_profiling] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [memory, profiling, leaks] +--- + +# 메모리 프로파일링 + +## 한 줄 통찰 +> 속도보다 메모리로 먼저 무너지는 시스템도 많다. + +## 핵심 개념 +- 요약: 메모리 사용량을 측정하고 누수를 추적하는 방법을 정리한다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[memory]] +- [[profiling]] +- [[leaks]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/136_benchmarking과_pyperf.md b/10_Wiki/Topics/Coding/Python/136_benchmarking과_pyperf.md new file mode 100644 index 00000000..e6e72b19 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/136_benchmarking과_pyperf.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-136 +title: benchmarking과 pyperf +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_benchmarking] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_benchmarking] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [benchmark, pyperf, performance] +--- + +# benchmarking과 pyperf + +## 한 줄 통찰 +> 성능 수치는 재현 가능한 측정 문맥과 함께 읽어야 한다. + +## 핵심 개념 +- 요약: 벤치마크 설계와 pyperf 같은 도구 활용 기준을 다룬다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[benchmark]] +- [[pyperf]] +- [[performance]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/137_flaky_test_줄이기.md b/10_Wiki/Topics/Coding/Python/137_flaky_test_줄이기.md new file mode 100644 index 00000000..15a1ad4a --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/137_flaky_test_줄이기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-137 +title: flaky test 줄이기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_flaky_tests] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_flaky_tests] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [flaky tests, reliability, ci] +--- + +# flaky test 줄이기 + +## 한 줄 통찰 +> 신뢰할 수 없는 테스트는 없는 테스트만큼 위험하다. + +## 핵심 개념 +- 요약: 불안정 테스트 원인과 줄이는 전략을 정리한다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[flaky tests]] +- [[reliability]] +- [[ci]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/138_에러_재현_최소화.md b/10_Wiki/Topics/Coding/Python/138_에러_재현_최소화.md new file mode 100644 index 00000000..ff390ca5 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/138_에러_재현_최소화.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-138 +title: 에러 재현 최소화 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_minimal_repro] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_minimal_repro] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [minimal repro, debugging, bug report] +--- + +# 에러 재현 최소화 + +## 한 줄 통찰 +> 좋은 재현 케이스 하나가 긴 추측보다 훨씬 강하다. + +## 핵심 개념 +- 요약: 버그 리포트와 재현 케이스를 최소한으로 줄여내는 방법을 다룬다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[minimal repro]] +- [[debugging]] +- [[bug report]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/139_assert_설계와_메시지.md b/10_Wiki/Topics/Coding/Python/139_assert_설계와_메시지.md new file mode 100644 index 00000000..eb838654 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/139_assert_설계와_메시지.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-139 +title: assert 설계와 메시지 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_assert_design] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_assert_design] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [assert, pytest, diagnostics] +--- + +# assert 설계와 메시지 + +## 한 줄 통찰 +> 실패 메시지는 미래의 자신과 동료를 위한 문서다. + +## 핵심 개념 +- 요약: 좋은 assert 문과 실패 메시지 설계 기준을 정리한다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[assert]] +- [[pytest]] +- [[diagnostics]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/140_테스트_데이터_전략.md b/10_Wiki/Topics/Coding/Python/140_테스트_데이터_전략.md new file mode 100644 index 00000000..46a07a92 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/140_테스트_데이터_전략.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-140 +title: 테스트 데이터 전략 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_test_data_strategy] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, testing, python_test_data_strategy] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "testing" } +applied_in: [] +verification_status: conceptual +related_notes: [test data, fixtures, factories] +--- + +# 테스트 데이터 전략 + +## 한 줄 통찰 +> 테스트 데이터가 지저분하면 테스트 설계도 흔들린다. + +## 핵심 개념 +- 요약: fixture data, factories, golden files 전략을 다룬다. +- 지식 축: 테스트, 품질 검증, 디버깅을 다루는 Python 실무 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 좋은 테스트는 코드 구조를 드러내고 변경 비용을 낮춘다. +- 테스트 전략은 실행 속도와 신뢰도의 균형을 다뤄야 한다. +- 디버깅은 증상보다 재현 가능 조건을 찾는 과정이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 핵심 도메인 로직부터 테스트 경계를 명확히 한다. +- 테스트 피라미드와 실행 시간 예산을 함께 본다. +- 재현성 높은 실패 사례를 자산으로 저장한다. + +## 안티패턴 +- 행복 경로만 테스트한다. +- 테스트가 구조를 고정해 리팩토링을 방해하게 만든다. +- 디버깅 결과를 기록하지 않아 같은 실수를 반복한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[test data]] +- [[fixtures]] +- [[factories]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/141_venv와_환경_격리.md b/10_Wiki/Topics/Coding/Python/141_venv와_환경_격리.md new file mode 100644 index 00000000..74ba87c9 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/141_venv와_환경_격리.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-141 +title: venv와 환경 격리 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_venv] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_venv] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [venv, virtualenv, environment] +--- + +# venv와 환경 격리 + +## 한 줄 통찰 +> 재현성 없는 Python 환경은 작은 프로젝트도 불안정하게 만든다. + +## 핵심 개념 +- 요약: 가상환경의 기본 개념과 왜 격리가 필요한지 정리한다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[venv]] +- [[virtualenv]] +- [[environment]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/142_pip_기본기와_의존성_관리.md b/10_Wiki/Topics/Coding/Python/142_pip_기본기와_의존성_관리.md new file mode 100644 index 00000000..78b5d3c9 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/142_pip_기본기와_의존성_관리.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-142 +title: pip 기본기와 의존성 관리 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pip_dependencies] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_pip_dependencies] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [pip, requirements, dependencies] +--- + +# pip 기본기와 의존성 관리 + +## 한 줄 통찰 +> 패키지 설치는 시작일 뿐, 버전 전략이 더 중요하다. + +## 핵심 개념 +- 요약: pip 사용 패턴과 requirements 관리 기본을 다룬다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[pip]] +- [[requirements]] +- [[dependencies]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/143_requirementstxt와_constraintstxt.md b/10_Wiki/Topics/Coding/Python/143_requirementstxt와_constraintstxt.md new file mode 100644 index 00000000..bdcab314 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/143_requirementstxt와_constraintstxt.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-143 +title: requirements.txt와 constraints.txt +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_requirements_constraints] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_requirements_constraints] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [requirements, constraints, packaging] +--- + +# requirements.txt와 constraints.txt + +## 한 줄 통찰 +> 의존성 명세를 나누면 업데이트 리스크를 더 잘 통제할 수 있다. + +## 핵심 개념 +- 요약: 두 파일의 역할 차이와 운영 전략을 정리한다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[requirements]] +- [[constraints]] +- [[packaging]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/144_pyprojecttoml_현대_표준.md b/10_Wiki/Topics/Coding/Python/144_pyprojecttoml_현대_표준.md new file mode 100644 index 00000000..20950692 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/144_pyprojecttoml_현대_표준.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-144 +title: pyproject.toml 현대 표준 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pyproject_toml] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_pyproject_toml] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [pyproject.toml, packaging, tooling] +--- + +# pyproject.toml 현대 표준 + +## 한 줄 통찰 +> 설정의 중심을 한곳에 두면 도구 통합과 재현성이 좋아진다. + +## 핵심 개념 +- 요약: 현대 Python 프로젝트의 pyproject.toml 구조를 정리한다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[pyproject.toml]] +- [[packaging]] +- [[tooling]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/145_setuptools와_build_backend.md b/10_Wiki/Topics/Coding/Python/145_setuptools와_build_backend.md new file mode 100644 index 00000000..bdd67058 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/145_setuptools와_build_backend.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-145 +title: setuptools와 build backend +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_setuptools_backend] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_setuptools_backend] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [setuptools, build backend, packaging] +--- + +# setuptools와 build backend + +## 한 줄 통찰 +> 패키징 도구 선택은 메타데이터, 빌드, 배포 흐름을 같이 봐야 한다. + +## 핵심 개념 +- 요약: build backend 개념과 setuptools 위치를 정리한다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[setuptools]] +- [[build backend]] +- [[packaging]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/146_poetry와_uv_선택_기준.md b/10_Wiki/Topics/Coding/Python/146_poetry와_uv_선택_기준.md new file mode 100644 index 00000000..1075a9d7 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/146_poetry와_uv_선택_기준.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-146 +title: poetry와 uv 선택 기준 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_poetry_uv] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_poetry_uv] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [poetry, uv, dependencies] +--- + +# poetry와 uv 선택 기준 + +## 한 줄 통찰 +> 도구 전쟁보다 팀 속도와 재현성 요구를 먼저 봐야 한다. + +## 핵심 개념 +- 요약: 현대 의존성 도구 선택 기준을 실무 관점에서 정리한다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[poetry]] +- [[uv]] +- [[dependencies]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/147_editable_install과_개발_편의.md b/10_Wiki/Topics/Coding/Python/147_editable_install과_개발_편의.md new file mode 100644 index 00000000..63138690 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/147_editable_install과_개발_편의.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-147 +title: editable install과 개발 편의 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_editable_install] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_editable_install] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [editable install, packaging, dev workflow] +--- + +# editable install과 개발 편의 + +## 한 줄 통찰 +> 로컬 패키지 개발 경험을 잘 설계하면 리팩토링 비용이 줄어든다. + +## 핵심 개념 +- 요약: editable install의 의미와 개발 흐름에서의 활용을 다룬다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[editable install]] +- [[packaging]] +- [[dev workflow]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/148_패키지_구조_설계_src_layout.md b/10_Wiki/Topics/Coding/Python/148_패키지_구조_설계_src_layout.md new file mode 100644 index 00000000..7b28ba0c --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/148_패키지_구조_설계_src_layout.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-148 +title: 패키지 구조 설계 src layout +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_src_layout] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_src_layout] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [src layout, package structure, imports] +--- + +# 패키지 구조 설계 src layout + +## 한 줄 통찰 +> 패키지 구조는 테스트/배포 오류를 미리 예방하는 아키텍처 장치다. + +## 핵심 개념 +- 요약: src layout와 flat layout 선택 기준을 정리한다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[src layout]] +- [[package structure]] +- [[imports]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/149_의존성_잠금_전략.md b/10_Wiki/Topics/Coding/Python/149_의존성_잠금_전략.md new file mode 100644 index 00000000..d5de7a8c --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/149_의존성_잠금_전략.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-149 +title: 의존성 잠금 전략 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_lockfiles] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_lockfiles] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [lockfile, reproducibility, dependencies] +--- + +# 의존성 잠금 전략 + +## 한 줄 통찰 +> 같은 requirements라도 잠금 전략이 없으면 같은 환경이 아니다. + +## 핵심 개념 +- 요약: lockfile과 버전 핀 전략, 재현성 기준을 다룬다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[lockfile]] +- [[reproducibility]] +- [[dependencies]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/150_버전_관리와_semantic_versioning.md b/10_Wiki/Topics/Coding/Python/150_버전_관리와_semantic_versioning.md new file mode 100644 index 00000000..317d3989 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/150_버전_관리와_semantic_versioning.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-150 +title: 버전 관리와 semantic versioning +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_versioning] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_versioning] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [semver, versioning, releases] +--- + +# 버전 관리와 semantic versioning + +## 한 줄 통찰 +> 버전은 숫자가 아니라 사용자와의 약속이다. + +## 핵심 개념 +- 요약: 라이브러리/앱 버전 전략과 변경 호환성 기준을 정리한다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[semver]] +- [[versioning]] +- [[releases]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/151_wheel과_sdist_이해.md b/10_Wiki/Topics/Coding/Python/151_wheel과_sdist_이해.md new file mode 100644 index 00000000..938e7e55 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/151_wheel과_sdist_이해.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-151 +title: wheel과 sdist 이해 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_wheel_sdist] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_wheel_sdist] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [wheel, sdist, distribution] +--- + +# wheel과 sdist 이해 + +## 한 줄 통찰 +> 배포 포맷을 이해하면 설치 문제를 더 빠르게 진단할 수 있다. + +## 핵심 개념 +- 요약: 배포 산출물인 wheel과 sdist의 차이를 다룬다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[wheel]] +- [[sdist]] +- [[distribution]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/152_pip-tools와_잠금_자동화.md b/10_Wiki/Topics/Coding/Python/152_pip-tools와_잠금_자동화.md new file mode 100644 index 00000000..198e9364 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/152_pip-tools와_잠금_자동화.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-152 +title: pip-tools와 잠금 자동화 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pip_tools] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_pip_tools] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [pip-tools, dependencies, lock] +--- + +# pip-tools와 잠금 자동화 + +## 한 줄 통찰 +> 간단한 도구 하나로 업데이트 통제가 훨씬 쉬워질 수 있다. + +## 핵심 개념 +- 요약: pip-tools를 통한 선언형 의존성 관리 전략을 정리한다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[pip-tools]] +- [[dependencies]] +- [[lock]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/153_pre-commit과_품질_게이트.md b/10_Wiki/Topics/Coding/Python/153_pre-commit과_품질_게이트.md new file mode 100644 index 00000000..0b5f58d8 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/153_pre-commit과_품질_게이트.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-153 +title: pre-commit과 품질 게이트 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pre_commit] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_pre_commit] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [pre-commit, lint, tooling] +--- + +# pre-commit과 품질 게이트 + +## 한 줄 통찰 +> 작은 자동화가 코드베이스 일관성을 지켜준다. + +## 핵심 개념 +- 요약: pre-commit 기반 로컬 품질 게이트 운영을 다룬다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[pre-commit]] +- [[lint]] +- [[tooling]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/154_ruff_modern_linting.md b/10_Wiki/Topics/Coding/Python/154_ruff_modern_linting.md new file mode 100644 index 00000000..65b94d09 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/154_ruff_modern_linting.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-154 +title: ruff modern linting +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_ruff] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_ruff] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [ruff, lint, format] +--- + +# ruff modern linting + +## 한 줄 통찰 +> 도구가 빨라질수록 규칙은 더 일상적인 피드백 루프로 들어온다. + +## 핵심 개념 +- 요약: ruff를 중심으로 한 현대적 lint/format 워크플로우를 정리한다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[ruff]] +- [[lint]] +- [[format]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/155_black과_코드_포맷팅.md b/10_Wiki/Topics/Coding/Python/155_black과_코드_포맷팅.md new file mode 100644 index 00000000..f0ef949e --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/155_black과_코드_포맷팅.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-155 +title: black과 코드 포맷팅 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_black] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_black] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [black, formatting, style] +--- + +# black과 코드 포맷팅 + +## 한 줄 통찰 +> 스타일 논쟁을 줄이면 더 중요한 설계 논의에 시간을 쓸 수 있다. + +## 핵심 개념 +- 요약: black의 철학과 포맷팅 자동화의 장단점을 다룬다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[black]] +- [[formatting]] +- [[style]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/156_isort와_import_정렬.md b/10_Wiki/Topics/Coding/Python/156_isort와_import_정렬.md new file mode 100644 index 00000000..db385d1e --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/156_isort와_import_정렬.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-156 +title: isort와 import 정렬 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_isort] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_isort] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [isort, imports, style] +--- + +# isort와 import 정렬 + +## 한 줄 통찰 +> 작은 일관성도 코드 리뷰 피로를 크게 낮춘다. + +## 핵심 개념 +- 요약: import 정렬 도구와 팀 규칙 정합성 문제를 다룬다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[isort]] +- [[imports]] +- [[style]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/157_환경_변수와_설정_관리.md b/10_Wiki/Topics/Coding/Python/157_환경_변수와_설정_관리.md new file mode 100644 index 00000000..96f2b97e --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/157_환경_변수와_설정_관리.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-157 +title: 환경 변수와 설정 관리 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_config_management] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_config_management] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [config, env vars, secrets] +--- + +# 환경 변수와 설정 관리 + +## 한 줄 통찰 +> 설정은 코드 바깥에 있지만 품질과 운영의 핵심이다. + +## 핵심 개념 +- 요약: 앱 설정, secrets, 환경 분리 전략을 정리한다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[config]] +- [[env vars]] +- [[secrets]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/158_Docker로_Python_앱_배포.md b/10_Wiki/Topics/Coding/Python/158_Docker로_Python_앱_배포.md new file mode 100644 index 00000000..29d70a07 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/158_Docker로_Python_앱_배포.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-158 +title: Docker로 Python 앱 배포 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_docker_deploy] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_docker_deploy] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [Docker, deployment, containers] +--- + +# Docker로 Python 앱 배포 + +## 한 줄 통찰 +> 이미지 크기보다 재현성과 시작 속도, 보안 경계를 함께 봐야 한다. + +## 핵심 개념 +- 요약: Python 앱을 컨테이너화할 때 고려할 빌드와 런타임 포인트를 다룬다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Docker]] +- [[deployment]] +- [[containers]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/159_CI에서_Python_테스트_실행.md b/10_Wiki/Topics/Coding/Python/159_CI에서_Python_테스트_실행.md new file mode 100644 index 00000000..e32df8db --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/159_CI에서_Python_테스트_실행.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-159 +title: CI에서 Python 테스트 실행 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_ci_testing] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_ci_testing] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [CI, pytest, automation] +--- + +# CI에서 Python 테스트 실행 + +## 한 줄 통찰 +> 로컬에서만 통하는 파이프라인은 자동화가 아니라 착각이다. + +## 핵심 개념 +- 요약: CI 파이프라인에서 Python 품질 게이트를 설계하는 기준을 정리한다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[CI]] +- [[pytest]] +- [[automation]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/160_배포_아티팩트와_릴리스_운영.md b/10_Wiki/Topics/Coding/Python/160_배포_아티팩트와_릴리스_운영.md new file mode 100644 index 00000000..d04c64fd --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/160_배포_아티팩트와_릴리스_운영.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-160 +title: 배포 아티팩트와 릴리스 운영 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_release_artifacts] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, packaging, python_release_artifacts] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "packaging" } +applied_in: [] +verification_status: conceptual +related_notes: [release, artifacts, packaging] +--- + +# 배포 아티팩트와 릴리스 운영 + +## 한 줄 통찰 +> 패키지 배포는 파일 업로드가 아니라 변경 책임의 전달이다. + +## 핵심 개념 +- 요약: 릴리스 아티팩트, 태그, 배포 노트 운영 방식을 다룬다. +- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다. +- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다. +- 의존성 관리는 기술 부채의 주요 출발점이다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다. +- 재현 가능한 환경과 잠금 전략을 함께 설계한다. +- 개발용 설정과 배포용 설정을 명확히 분리한다. + +## 안티패턴 +- 전역 환경에 무분별하게 설치한다. +- 의존성 버전 전략 없이 패키지를 추가한다. +- 배포 메타데이터를 나중 문제로 미룬다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[release]] +- [[artifacts]] +- [[packaging]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/161_FastAPI_구조_설계.md b/10_Wiki/Topics/Coding/Python/161_FastAPI_구조_설계.md new file mode 100644 index 00000000..df2987eb --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/161_FastAPI_구조_설계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-161 +title: FastAPI 구조 설계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_fastapi_architecture] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_fastapi_architecture] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [FastAPI, web, architecture] +--- + +# FastAPI 구조 설계 + +## 한 줄 통찰 +> 프레임워크보다 라우팅, 서비스, 스키마 경계 설계가 더 중요하다. + +## 핵심 개념 +- 요약: FastAPI 기반 서비스 구조와 경계 분리 기준을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[FastAPI]] +- [[web]] +- [[architecture]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/162_Django의_강점과_한계.md b/10_Wiki/Topics/Coding/Python/162_Django의_강점과_한계.md new file mode 100644 index 00000000..96e9a6d6 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/162_Django의_강점과_한계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-162 +title: Django의 강점과 한계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_django_tradeoffs] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_django_tradeoffs] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [Django, web, framework] +--- + +# Django의 강점과 한계 + +## 한 줄 통찰 +> 배터리 포함 프레임워크는 생산성과 제약을 함께 가져온다. + +## 핵심 개념 +- 요약: Django를 언제 선택하고 언제 과한지 판단 기준을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Django]] +- [[web]] +- [[framework]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/163_Flask와_마이크로_프레임워크_사고.md b/10_Wiki/Topics/Coding/Python/163_Flask와_마이크로_프레임워크_사고.md new file mode 100644 index 00000000..05d2b597 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/163_Flask와_마이크로_프레임워크_사고.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-163 +title: Flask와 마이크로 프레임워크 사고 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_flask_microframework] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_flask_microframework] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [Flask, microframework, web] +--- + +# Flask와 마이크로 프레임워크 사고 + +## 한 줄 통찰 +> 작다고 단순한 것은 아니며, 선택한 만큼 구조 책임이 커진다. + +## 핵심 개념 +- 요약: Flask류 마이크로 프레임워크의 장단점과 구조 전략을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Flask]] +- [[microframework]] +- [[web]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/164_SQLAlchemy_ORM_기초.md b/10_Wiki/Topics/Coding/Python/164_SQLAlchemy_ORM_기초.md new file mode 100644 index 00000000..a53b4843 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/164_SQLAlchemy_ORM_기초.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-164 +title: SQLAlchemy ORM 기초 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_sqlalchemy_basics] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_sqlalchemy_basics] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [SQLAlchemy, ORM, database] +--- + +# SQLAlchemy ORM 기초 + +## 한 줄 통찰 +> ORM는 SQL을 없애는 도구가 아니라 데이터 경계를 추상화하는 도구다. + +## 핵심 개념 +- 요약: ORM 모델링과 세션 관리 기본을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[SQLAlchemy]] +- [[ORM]] +- [[database]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/165_Pydantic_모델_설계.md b/10_Wiki/Topics/Coding/Python/165_Pydantic_모델_설계.md new file mode 100644 index 00000000..ab1c4cf9 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/165_Pydantic_모델_설계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-165 +title: Pydantic 모델 설계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pydantic_models] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_pydantic_models] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [Pydantic, validation, schemas] +--- + +# Pydantic 모델 설계 + +## 한 줄 통찰 +> 검증 모델과 도메인 모델을 섞지 않는 감각이 중요하다. + +## 핵심 개념 +- 요약: Pydantic으로 입출력 스키마를 모델링하는 기준을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Pydantic]] +- [[validation]] +- [[schemas]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/166_Pandas_데이터_처리_기본기.md b/10_Wiki/Topics/Coding/Python/166_Pandas_데이터_처리_기본기.md new file mode 100644 index 00000000..b8e7df23 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/166_Pandas_데이터_처리_기본기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-166 +title: Pandas 데이터 처리 기본기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_pandas_basics] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_pandas_basics] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [pandas, dataframe, analysis] +--- + +# Pandas 데이터 처리 기본기 + +## 한 줄 통찰 +> 데이터프레임은 편하지만, 변형 흐름이 흐려지면 디버깅이 어려워진다. + +## 핵심 개념 +- 요약: pandas에서 데이터 조작 기본 패턴과 안티패턴을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[pandas]] +- [[dataframe]] +- [[analysis]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/167_Polars와_현대_데이터프레임.md b/10_Wiki/Topics/Coding/Python/167_Polars와_현대_데이터프레임.md new file mode 100644 index 00000000..1fd71ca5 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/167_Polars와_현대_데이터프레임.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-167 +title: Polars와 현대 데이터프레임 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_polars] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_polars] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [polars, pandas, data] +--- + +# Polars와 현대 데이터프레임 + +## 한 줄 통찰 +> 도구 비교는 유행보다 데이터 크기와 팀 익숙함을 먼저 봐야 한다. + +## 핵심 개념 +- 요약: Polars의 강점과 pandas 대비 선택 기준을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[polars]] +- [[pandas]] +- [[data]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/168_NumPy_배열_사고.md b/10_Wiki/Topics/Coding/Python/168_NumPy_배열_사고.md new file mode 100644 index 00000000..0786966b --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/168_NumPy_배열_사고.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-168 +title: NumPy 배열 사고 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_numpy_arrays] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_numpy_arrays] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [NumPy, arrays, broadcasting] +--- + +# NumPy 배열 사고 + +## 한 줄 통찰 +> NumPy는 반복문을 없애는 기술이 아니라 데이터 형태를 바꾸는 사고다. + +## 핵심 개념 +- 요약: 벡터화, 브로드캐스팅, 배열 연산 모델을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[NumPy]] +- [[arrays]] +- [[broadcasting]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/169_Jupyter_노트북_운영_규칙.md b/10_Wiki/Topics/Coding/Python/169_Jupyter_노트북_운영_규칙.md new file mode 100644 index 00000000..e8d01a31 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/169_Jupyter_노트북_운영_규칙.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-169 +title: Jupyter 노트북 운영 규칙 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_jupyter_workflow] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_jupyter_workflow] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [Jupyter, notebook, reproducibility] +--- + +# Jupyter 노트북 운영 규칙 + +## 한 줄 통찰 +> 탐색 도구와 생산 코드 경계를 명확히 해야 혼란이 줄어든다. + +## 핵심 개념 +- 요약: 노트북 기반 탐색과 재현 가능한 결과물 사이의 균형을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Jupyter]] +- [[notebook]] +- [[reproducibility]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/170_Click과_Typer로_CLI_앱_만들기.md b/10_Wiki/Topics/Coding/Python/170_Click과_Typer로_CLI_앱_만들기.md new file mode 100644 index 00000000..882c0b0b --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/170_Click과_Typer로_CLI_앱_만들기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-170 +title: Click과 Typer로 CLI 앱 만들기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_cli_frameworks] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_cli_frameworks] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [Click, Typer, CLI] +--- + +# Click과 Typer로 CLI 앱 만들기 + +## 한 줄 통찰 +> 도구성 앱일수록 사용자 경험은 CLI 설계에 크게 좌우된다. + +## 핵심 개념 +- 요약: CLI 프레임워크 선택 기준과 실전 사용 패턴을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Click]] +- [[Typer]] +- [[CLI]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/171_requests와_httpx_비교.md b/10_Wiki/Topics/Coding/Python/171_requests와_httpx_비교.md new file mode 100644 index 00000000..aad12ca3 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/171_requests와_httpx_비교.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-171 +title: requests와 httpx 비교 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_http_clients] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_http_clients] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [requests, httpx, http] +--- + +# requests와 httpx 비교 + +## 한 줄 통찰 +> 네트워크 호출은 문법보다 timeout, retry, observability가 중요하다. + +## 핵심 개념 +- 요약: 동기/비동기 HTTP 클라이언트 선택 기준을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[requests]] +- [[httpx]] +- [[http]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/172_BeautifulSoup와_HTML_파싱.md b/10_Wiki/Topics/Coding/Python/172_BeautifulSoup와_HTML_파싱.md new file mode 100644 index 00000000..6596801a --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/172_BeautifulSoup와_HTML_파싱.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-172 +title: BeautifulSoup와 HTML 파싱 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_html_parsing] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_html_parsing] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [BeautifulSoup, scraping, html] +--- + +# BeautifulSoup와 HTML 파싱 + +## 한 줄 통찰 +> 웹 문서는 구조가 더럽기 때문에 파서는 관용적이어야 한다. + +## 핵심 개념 +- 요약: 스크래핑과 HTML 파싱 기초, 경계 조건을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[BeautifulSoup]] +- [[scraping]] +- [[html]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/173_async_웹_크롤링_패턴.md b/10_Wiki/Topics/Coding/Python/173_async_웹_크롤링_패턴.md new file mode 100644 index 00000000..11424b29 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/173_async_웹_크롤링_패턴.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-173 +title: async 웹 크롤링 패턴 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_async_scraping] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_async_scraping] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [scraping, asyncio, httpx] +--- + +# async 웹 크롤링 패턴 + +## 한 줄 통찰 +> 크롤링은 속도보다 대상 서비스와의 관계를 먼저 생각해야 한다. + +## 핵심 개념 +- 요약: 비동기 기반 대량 요청/수집 패턴과 예절을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[scraping]] +- [[asyncio]] +- [[httpx]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/174_Celery와_작업_큐.md b/10_Wiki/Topics/Coding/Python/174_Celery와_작업_큐.md new file mode 100644 index 00000000..0610ee96 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/174_Celery와_작업_큐.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-174 +title: Celery와 작업 큐 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_celery_tasks] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_celery_tasks] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [Celery, task queue, workers] +--- + +# Celery와 작업 큐 + +## 한 줄 통찰 +> 비동기 업무 분리는 실행 모델과 장애 모델을 함께 설계해야 한다. + +## 핵심 개념 +- 요약: 백그라운드 작업 큐 설계와 Celery 활용 기준을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Celery]] +- [[task queue]] +- [[workers]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/175_Airflow와_워크플로_오케스트레이션.md b/10_Wiki/Topics/Coding/Python/175_Airflow와_워크플로_오케스트레이션.md new file mode 100644 index 00000000..aaa10332 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/175_Airflow와_워크플로_오케스트레이션.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-175 +title: Airflow와 워크플로 오케스트레이션 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_airflow] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_airflow] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [Airflow, DAG, data engineering] +--- + +# Airflow와 워크플로 오케스트레이션 + +## 한 줄 통찰 +> 워크플로 도구는 코드보다 운영 책임과 관측성 기준이 중요하다. + +## 핵심 개념 +- 요약: 배치 파이프라인과 DAG 기반 운영 모델을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[Airflow]] +- [[DAG]] +- [[data engineering]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/176_Python_성능_튜닝_기본기.md b/10_Wiki/Topics/Coding/Python/176_Python_성능_튜닝_기본기.md new file mode 100644 index 00000000..cf99492b --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/176_Python_성능_튜닝_기본기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-176 +title: Python 성능 튜닝 기본기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_performance_tuning] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_performance_tuning] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [performance, profiling, optimization] +--- + +# Python 성능 튜닝 기본기 + +## 한 줄 통찰 +> 튜닝은 감이 아니라 가장 큰 병목부터 제거하는 작업이다. + +## 핵심 개념 +- 요약: 병목 측정부터 알고리즘, 자료구조, 구현 최적화 순서를 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[performance]] +- [[profiling]] +- [[optimization]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/177_메모리_효율적인_데이터_처리.md b/10_Wiki/Topics/Coding/Python/177_메모리_효율적인_데이터_처리.md new file mode 100644 index 00000000..1a176722 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/177_메모리_효율적인_데이터_처리.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-177 +title: 메모리 효율적인 데이터 처리 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_memory_efficient_processing] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_memory_efficient_processing] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [memory, streaming, chunking] +--- + +# 메모리 효율적인 데이터 처리 + +## 한 줄 통찰 +> 큰 데이터를 다룰 때는 전체 로드보다 흐름 처리 사고가 중요하다. + +## 핵심 개념 +- 요약: streaming, chunking, lazy evaluation으로 메모리를 아끼는 전략을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[memory]] +- [[streaming]] +- [[chunking]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/178_Python_보안_기본기.md b/10_Wiki/Topics/Coding/Python/178_Python_보안_기본기.md new file mode 100644 index 00000000..00980403 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/178_Python_보안_기본기.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-178 +title: Python 보안 기본기 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_security_basics] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_security_basics] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [security, validation, secrets] +--- + +# Python 보안 기본기 + +## 한 줄 통찰 +> Python 보안은 프레임워크보다 경계와 신뢰 모델에서 시작된다. + +## 핵심 개념 +- 요약: 입력 검증, secrets 관리, deserialization 위험 등 보안 기본을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[security]] +- [[validation]] +- [[secrets]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/179_Python_자동화_스크립트_설계.md b/10_Wiki/Topics/Coding/Python/179_Python_자동화_스크립트_설계.md new file mode 100644 index 00000000..ff6f7a8e --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/179_Python_자동화_스크립트_설계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-179 +title: Python 자동화 스크립트 설계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_automation_scripts] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_automation_scripts] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [automation, scripts, ops] +--- + +# Python 자동화 스크립트 설계 + +## 한 줄 통찰 +> 짧은 스크립트일수록 예외 처리와 idempotency가 중요하다. + +## 핵심 개념 +- 요약: 작은 운영 자동화 스크립트를 안전하게 설계하는 기준을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[automation]] +- [[scripts]] +- [[ops]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/180_Python_프로젝트_아키텍처_패턴.md b/10_Wiki/Topics/Coding/Python/180_Python_프로젝트_아키텍처_패턴.md new file mode 100644 index 00000000..b6926f4f --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/180_Python_프로젝트_아키텍처_패턴.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-180 +title: Python 프로젝트 아키텍처 패턴 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_project_architecture] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_project_architecture] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [architecture, project structure, modules] +--- + +# Python 프로젝트 아키텍처 패턴 + +## 한 줄 통찰 +> Python 프로젝트의 혼란은 대개 경계보다 파일 수부터 늘릴 때 시작된다. + +## 핵심 개념 +- 요약: 언어 차원을 넘어 Python 프로젝트 구조를 어떻게 잡을지 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[architecture]] +- [[project structure]] +- [[modules]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/181_Python_플러그인_시스템.md b/10_Wiki/Topics/Coding/Python/181_Python_플러그인_시스템.md new file mode 100644 index 00000000..be9394d9 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/181_Python_플러그인_시스템.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-181 +title: Python 플러그인 시스템 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_plugin_architecture] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_plugin_architecture] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [plugins, entry points, architecture] +--- + +# Python 플러그인 시스템 + +## 한 줄 통찰 +> 확장성을 원한다면 코어와 플러그인의 계약을 먼저 설계해야 한다. + +## 핵심 개념 +- 요약: entry points, discovery, 확장 가능한 구조를 다루는 패턴을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[plugins]] +- [[entry points]] +- [[architecture]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/182_Python_관측_가능성.md b/10_Wiki/Topics/Coding/Python/182_Python_관측_가능성.md new file mode 100644 index 00000000..c65c57ad --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/182_Python_관측_가능성.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-182 +title: Python 관측 가능성 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_observability] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_observability] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [observability, logging, metrics] +--- + +# Python 관측 가능성 + +## 한 줄 통찰 +> 운영 가능한 코드는 동작하는 코드보다 한 단계 더 멀리 간다. + +## 핵심 개념 +- 요약: 로그, 메트릭, 트레이싱을 Python 서비스에 넣는 기준을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[observability]] +- [[logging]] +- [[metrics]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/183_structlog와_구조적_로깅.md b/10_Wiki/Topics/Coding/Python/183_structlog와_구조적_로깅.md new file mode 100644 index 00000000..aead0385 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/183_structlog와_구조적_로깅.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-183 +title: structlog와 구조적 로깅 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_structured_logging] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_structured_logging] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [structlog, logging, observability] +--- + +# structlog와 구조적 로깅 + +## 한 줄 통찰 +> 운영 로그는 문자열보다 질의 가능한 이벤트에 가까워야 한다. + +## 핵심 개념 +- 요약: 구조적 로그와 JSON 로그 운용 기준을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[structlog]] +- [[logging]] +- [[observability]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/184_Python에서_OpenTelemetry.md b/10_Wiki/Topics/Coding/Python/184_Python에서_OpenTelemetry.md new file mode 100644 index 00000000..9e99a773 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/184_Python에서_OpenTelemetry.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-184 +title: Python에서 OpenTelemetry +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_opentelemetry] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_opentelemetry] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [OpenTelemetry, tracing, ops] +--- + +# Python에서 OpenTelemetry + +## 한 줄 통찰 +> 성능과 장애는 개별 서비스보다 호출 체인에서 봐야 한다. + +## 핵심 개념 +- 요약: 분산 추적과 telemetry 계측 기본을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[OpenTelemetry]] +- [[tracing]] +- [[ops]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/185_Python_API_rate_limiting.md b/10_Wiki/Topics/Coding/Python/185_Python_API_rate_limiting.md new file mode 100644 index 00000000..ab473d2c --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/185_Python_API_rate_limiting.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-185 +title: Python API rate limiting +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_rate_limiting] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_rate_limiting] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [rate limiting, api, reliability] +--- + +# Python API rate limiting + +## 한 줄 통찰 +> 부하 제어는 성능 기능이 아니라 신뢰성 기능이다. + +## 핵심 개념 +- 요약: 서버와 클라이언트 양쪽에서 rate limit를 다루는 전략을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[rate limiting]] +- [[api]] +- [[reliability]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/186_Python_캐싱_전략.md b/10_Wiki/Topics/Coding/Python/186_Python_캐싱_전략.md new file mode 100644 index 00000000..89ef032a --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/186_Python_캐싱_전략.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-186 +title: Python 캐싱 전략 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_caching] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_caching] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [cache, Redis, performance] +--- + +# Python 캐싱 전략 + +## 한 줄 통찰 +> 캐시는 빠르게 만들지만, 무효화 설계 없이는 버그도 빠르게 만든다. + +## 핵심 개념 +- 요약: lru_cache부터 Redis 캐시까지 계층별 캐싱 기준을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[cache]] +- [[Redis]] +- [[performance]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/187_Python과_메시지_큐.md b/10_Wiki/Topics/Coding/Python/187_Python과_메시지_큐.md new file mode 100644 index 00000000..714d9466 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/187_Python과_메시지_큐.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-187 +title: Python과 메시지 큐 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_message_queues] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_message_queues] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [messaging, Kafka, RabbitMQ] +--- + +# Python과 메시지 큐 + +## 한 줄 통찰 +> 비동기 메시징은 느슨한 결합과 새로운 장애 모델을 동시에 가져온다. + +## 핵심 개념 +- 요약: RabbitMQ, Kafka 등과 Python 서비스 통합 관점을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[messaging]] +- [[Kafka]] +- [[RabbitMQ]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/188_Python_데이터_파이프라인_설계.md b/10_Wiki/Topics/Coding/Python/188_Python_데이터_파이프라인_설계.md new file mode 100644 index 00000000..7cd26520 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/188_Python_데이터_파이프라인_설계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-188 +title: Python 데이터 파이프라인 설계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_data_pipelines] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_data_pipelines] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [data pipeline, batch, streaming] +--- + +# Python 데이터 파이프라인 설계 + +## 한 줄 통찰 +> 데이터 흐름은 코드보다 재현성과 실패 복구 전략이 중요하다. + +## 핵심 개념 +- 요약: 배치/스트리밍 데이터 파이프라인의 기본 설계 원칙을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[data pipeline]] +- [[batch]] +- [[streaming]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/189_Python_ETL_품질_기준.md b/10_Wiki/Topics/Coding/Python/189_Python_ETL_품질_기준.md new file mode 100644 index 00000000..8952c54b --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/189_Python_ETL_품질_기준.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-189 +title: Python ETL 품질 기준 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_etl_quality] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_etl_quality] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [ETL, data quality, reliability] +--- + +# Python ETL 품질 기준 + +## 한 줄 통찰 +> ETL은 동작만 하면 되는 스크립트가 아니라 신뢰성이 필요한 시스템이다. + +## 핵심 개념 +- 요약: ETL 작업의 검증, idempotency, 스키마 변화 대응 기준을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[ETL]] +- [[data quality]] +- [[reliability]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/190_Python_머신러닝_스크립트_운영.md b/10_Wiki/Topics/Coding/Python/190_Python_머신러닝_스크립트_운영.md new file mode 100644 index 00000000..1910cecc --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/190_Python_머신러닝_스크립트_운영.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-190 +title: Python 머신러닝 스크립트 운영 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_ml_script_ops] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_ml_script_ops] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [ml, experiments, reproducibility] +--- + +# Python 머신러닝 스크립트 운영 + +## 한 줄 통찰 +> 모델보다 데이터 버전, 설정, 재현성이 더 큰 운영 문제를 만든다. + +## 핵심 개념 +- 요약: 실험 코드와 운영 코드의 경계를 포함한 ML Python 실무를 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[ml]] +- [[experiments]] +- [[reproducibility]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/191_Python_package_as_library_설계.md b/10_Wiki/Topics/Coding/Python/191_Python_package_as_library_설계.md new file mode 100644 index 00000000..46a824f1 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/191_Python_package_as_library_설계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-191 +title: Python package as library 설계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_library_design] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_library_design] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [library, api, packaging] +--- + +# Python package as library 설계 + +## 한 줄 통찰 +> 내부 코드와 공개 라이브러리는 수정 자유도의 철학이 다르다. + +## 핵심 개념 +- 요약: 라이브러리로 배포되는 Python 코드의 API와 호환성 설계를 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[library]] +- [[api]] +- [[packaging]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/192_Python_package_as_app_설계.md b/10_Wiki/Topics/Coding/Python/192_Python_package_as_app_설계.md new file mode 100644 index 00000000..2638acce --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/192_Python_package_as_app_설계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-192 +title: Python package as app 설계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_app_design] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_app_design] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [application, packaging, deployment] +--- + +# Python package as app 설계 + +## 한 줄 통찰 +> 앱은 사용자 경험과 운영 수명주기를 같이 설계해야 한다. + +## 핵심 개념 +- 요약: 애플리케이션형 Python 프로젝트의 시작점과 운영 경계를 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[application]] +- [[packaging]] +- [[deployment]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/193_Python_monorepo_전략.md b/10_Wiki/Topics/Coding/Python/193_Python_monorepo_전략.md new file mode 100644 index 00000000..19386a54 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/193_Python_monorepo_전략.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-193 +title: Python monorepo 전략 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_monorepo] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_monorepo] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [monorepo, packages, architecture] +--- + +# Python monorepo 전략 + +## 한 줄 통찰 +> 저장소 구조는 협업 속도와 의존성 건강도를 함께 좌우한다. + +## 핵심 개념 +- 요약: 여러 Python 패키지와 서비스가 공존하는 저장소 운영 기준을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[monorepo]] +- [[packages]] +- [[architecture]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/194_Python에서_C_확장과_FFI.md b/10_Wiki/Topics/Coding/Python/194_Python에서_C_확장과_FFI.md new file mode 100644 index 00000000..8cc85943 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/194_Python에서_C_확장과_FFI.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-194 +title: Python에서 C 확장과 FFI +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_c_extensions_ffi] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_c_extensions_ffi] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [cffi, ctypes, native interop] +--- + +# Python에서 C 확장과 FFI + +## 한 줄 통찰 +> 성능 최적화는 언어를 바꾸는 결정을 포함할 때가 있다. + +## 핵심 개념 +- 요약: C 확장, ctypes, cffi, pyo3 등 성능/연동 선택지를 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[cffi]] +- [[ctypes]] +- [[native interop]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/195_Python과_WebAssembly_가능성.md b/10_Wiki/Topics/Coding/Python/195_Python과_WebAssembly_가능성.md new file mode 100644 index 00000000..b40432c3 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/195_Python과_WebAssembly_가능성.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-195 +title: Python과 WebAssembly 가능성 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_wasm] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_wasm] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [WebAssembly, Pyodide, deployment] +--- + +# Python과 WebAssembly 가능성 + +## 한 줄 통찰 +> 새 배포 환경은 매력적이지만 실행 모델과 패키지 제약을 먼저 봐야 한다. + +## 핵심 개념 +- 요약: Pyodide 등 Python on WebAssembly의 가능성과 제약을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[WebAssembly]] +- [[Pyodide]] +- [[deployment]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/196_Python과_시스템_스크립팅.md b/10_Wiki/Topics/Coding/Python/196_Python과_시스템_스크립팅.md new file mode 100644 index 00000000..c8a24e8a --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/196_Python과_시스템_스크립팅.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-196 +title: Python과 시스템 스크립팅 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_system_scripting] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_system_scripting] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [scripting, subprocess, ops] +--- + +# Python과 시스템 스크립팅 + +## 한 줄 통찰 +> 시스템 스크립트일수록 보수성과 안전장치가 더 중요하다. + +## 핵심 개념 +- 요약: 운영체제 자동화와 파일/프로세스 제어에 Python을 쓰는 기준을 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[scripting]] +- [[subprocess]] +- [[ops]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/197_Python과_LLM_애플리케이션.md b/10_Wiki/Topics/Coding/Python/197_Python과_LLM_애플리케이션.md new file mode 100644 index 00000000..35e7e3dc --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/197_Python과_LLM_애플리케이션.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-197 +title: Python과 LLM 애플리케이션 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_llm_apps] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_llm_apps] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [LLM, AI apps, orchestration] +--- + +# Python과 LLM 애플리케이션 + +## 한 줄 통찰 +> AI 앱에서도 결국 중요한 건 모델보다 경계, 비용, 검증 루프다. + +## 핵심 개념 +- 요약: Python으로 LLM 기반 애플리케이션을 구성할 때의 기본 구조를 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[LLM]] +- [[AI apps]] +- [[orchestration]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/198_Python_RAG_파이프라인_구조.md b/10_Wiki/Topics/Coding/Python/198_Python_RAG_파이프라인_구조.md new file mode 100644 index 00000000..8ebc1fcf --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/198_Python_RAG_파이프라인_구조.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-198 +title: Python RAG 파이프라인 구조 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_rag_pipelines] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_rag_pipelines] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [RAG, retrieval, AI] +--- + +# Python RAG 파이프라인 구조 + +## 한 줄 통찰 +> RAG는 단순한 호출 체인이 아니라 데이터 품질 문제이기도 하다. + +## 핵심 개념 +- 요약: 임베딩, 검색, 프롬프트, 평가를 포함한 RAG 구조를 다룬다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[RAG]] +- [[retrieval]] +- [[AI]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/199_Python_에이전트_도구_통합.md b/10_Wiki/Topics/Coding/Python/199_Python_에이전트_도구_통합.md new file mode 100644 index 00000000..acafc005 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/199_Python_에이전트_도구_통합.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-199 +title: Python 에이전트 도구 통합 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_agent_tooling] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_agent_tooling] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [agents, tool calling, orchestration] +--- + +# Python 에이전트 도구 통합 + +## 한 줄 통찰 +> 에이전트 품질은 모델보다 도구 경계와 상태 관리에서 많이 갈린다. + +## 핵심 개념 +- 요약: Python에서 도구 호출형 에이전트 시스템을 설계하는 기준을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[agents]] +- [[tool calling]] +- [[orchestration]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/10_Wiki/Topics/Coding/Python/200_Python_코딩_운영_체계.md b/10_Wiki/Topics/Coding/Python/200_Python_코딩_운영_체계.md new file mode 100644 index 00000000..c63a4e00 --- /dev/null +++ b/10_Wiki/Topics/Coding/Python/200_Python_코딩_운영_체계.md @@ -0,0 +1,71 @@ +--- +id: wiki-2026-0514-python-200 +title: Python 코딩 운영 체계 +category: 10_Wiki/Topics/Coding/Python +status: needs_review +canonical_id: self +aliases: [python_coding_operating_system] +duplicate_of: none +source_trust_level: C +confidence_score: 0.6 +created_at: 2026-05-14 +updated_at: 2026-05-14 +last_reinforced: 2026-05-14 +review_reason: ai_generated_concept_batch +merge_history: [] +tags: [Python, ecosystem, python_coding_operating_system] +raw_sources: [user_request:2026-05-14-python-coding-batch] +tech_stack: { language: "Python", pillar: "ecosystem" } +applied_in: [] +verification_status: conceptual +related_notes: [workflow, architecture, python] +--- + +# Python 코딩 운영 체계 + +## 한 줄 통찰 +> Python 실력은 개별 문법보다 전체 워크플로우를 연결하는 능력에서 완성된다. + +## 핵심 개념 +- 요약: 언어 기초부터 패키징, 테스트, 운영까지 Python 코딩 지식을 시스템으로 묶는 관점을 정리한다. +- 지식 축: 데이터, 웹, 자동화, 성능, 보안 등 Python 생태계 응용 지식 축 +- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다. + +## 세부 내용 +- 생태계 선택은 언어 기초보다 도메인 요구와 운영 제약을 더 크게 반영한다. +- 프레임워크보다 경계, 데이터 흐름, 운영 모델을 먼저 이해해야 한다. +- Python의 강점은 생산성이고, 약점은 무심코 감추면 운영 비용이 커진다. +- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다. + +## 의사결정 기준 +- 도메인 문제와 팀 역량에 맞는 스택을 고른다. +- 운영 환경, 확장성, 관측 가능성을 함께 본다. +- 생산성 이점과 성능 비용을 분리해 판단한다. + +## 안티패턴 +- 유행하는 프레임워크를 기준 없이 도입한다. +- 운영 단계의 로깅과 모니터링을 뒤로 미룬다. +- 도메인 요구보다 튜토리얼 편의성을 우선한다. + +## 적용 사례 +- 아직 직접 연결된 실제 적용 사례는 없다. +- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다. + +## 중복 검사 결과 +- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다. +- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다. + +## 모순 및 업데이트 +- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다. +- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다. + +## 관련 문서 +- [[workflow]] +- [[architecture]] +- [[python]] + +## Raw Source +- user_request:2026-05-14-python-coding-batch + +## 변경 이력 +- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성. diff --git a/20_Meta/ReviewQueue/application_candidates.md b/20_Meta/ReviewQueue/application_candidates.md new file mode 100644 index 00000000..1f88e4c7 --- /dev/null +++ b/20_Meta/ReviewQueue/application_candidates.md @@ -0,0 +1,19 @@ +# Application Candidates + +## 2026-05-14 창의성 카테고리 배치 + +- 입력 요약: 창의성 지식 보강을 위해 `10_Wiki/Topics/창의성` 아래 200개의 개념 문서를 생성함. +- 관련 문서: `10_Wiki/Topics/창의성/*.md` +- 문제 유형: `verification_status: conceptual` 상태의 신규 개념 문서 일괄 생성 +- 추천 처리: `planning_lead`, `design_lead`, `steve_jobs`의 발상/질문/콘셉트 설계 워크플로우에 우선 연결 검토 +- 이유: 다수 문서가 질문 설계, 브레인스토밍, 콘셉트 정의, AI 협업, 평가 기준 등 실제 작업 흐름에 바로 연결 가능함 +- 사용자 확인 필요 여부: 없음. 다만 실제 적용 사례 연결은 후속 강화 작업 필요 + +## 2026-05-14 Python 코딩 카테고리 배치 + +- 입력 요약: Python 코딩 지식 보강을 위해 `10_Wiki/Topics/Coding/Python` 아래 200개의 개념 문서를 생성함. +- 관련 문서: `10_Wiki/Topics/Coding/Python/*.md` +- 문제 유형: `verification_status: conceptual` 상태의 신규 개념 문서 일괄 생성 +- 추천 처리: `dev_lead`, `steve_jobs`, `planning_lead`의 설계/구현/리뷰 워크플로우에 우선 연결 검토 +- 이유: 다수 문서가 Python 언어 기초, 타입, 비동기, 테스트, 패키징, 운영 판단 기준으로 바로 연결 가능함 +- 사용자 확인 필요 여부: 없음. 다만 실제 코드/프로젝트 연결은 후속 강화 작업 필요