[PYTHON] def로 함수를 정의하는 기본 구조 : 클린 코드를 위한 설계의 정석

def로 함수를 정의하는 기본 구조

 

파이썬 프로그래밍의 세계에서 함수(Function)는 코드의 재사용성을 높이고 복잡한 로직을 구조화하는 가장 강력한 도구입니다. 단순히 코드를 묶어두는 단위를 넘어, 프로그램의 가독성과 유지보수성을 결정짓는 핵심적인 요소죠. 본 가이드에서는 파이썬의 키워드인 def를 활용해 함수를 정의하는 기본 문법부터, 실무에서 사랑받는 'Pythonic'한 함수 설계 철학까지 심도 있게 다룹니다.

---

1. 함수 정의의 본질: 왜 'def'인가?

파이썬에서 함수를 만드는 과정은 def(Define의 약자) 예약어로 시작됩니다. 이는 인터프리터에게 "이제부터 특정 작업을 수행할 코드 블록을 이름 아래에 저장하겠다"고 선언하는 것과 같습니다. 좋은 함수 정의는 그 이름만으로도 어떤 일을 하는지 명확히 전달하며, 내부 구현을 몰라도 사용할 수 있는 추상화(Abstraction)의 정수를 보여줍니다.

---

2. 파이썬 함수 정의의 표준 구조 분석

함수는 크게 선언부, 본문, 반환부의 세 영역으로 나뉩니다. 각 요소가 가진 역할과 문법적 규칙을 표를 통해 비교해 보겠습니다.

구성 요소	문법 형식	핵심 역할	필수 여부
헤더 (Header)	def 함수이름(매개변수):	함수의 식별 및 입력 정의	필수
독스트링 (Docstring)	"""설명문"""	기능 설명 및 문서화	권장
본문 (Body)	들여쓰기 된 코드 블록	실제 로직 수행	필수
반환문 (Return)	return 결과값	작업 결과 전달 및 종료	선택

---

3. 전문가처럼 함수 정의하기: 4가지 핵심 원칙

① 명명 규칙 (Naming Convention)

파이썬 커뮤니티의 표준인 PEP 8에 따라 함수 이름은 소문자로 작성하며, 단어 사이는 언더바(_)로 연결하는 snake_case를 권장합니다. 이름은 동사형으로 시작하여 기능이 명확히 드러나게 짓는 것이 관례입니다.

② 매개변수의 적절한 활용

함수는 외부로부터 데이터를 받아들여 처리합니다. 이때 기본값(Default parameter)을 설정하면 함수 호출 시의 유연성을 극대화할 수 있습니다. 하지만 가변 객체(리스트 등)를 기본값으로 사용하는 실수는 경계해야 합니다.

③ 단일 책임 원칙 (Single Responsibility Principle)

한 함수는 '단 하나의 일'만 수행해야 합니다. 만약 함수 본문이 너무 길거나 여러 가지 일을 동시에 하고 있다면, 더 작은 단위의 함수로 쪼개는 설계적 결단이 필요합니다.

④ 타입 힌팅 (Type Hinting)

최신 파이썬(3.5+)에서는 def add(a: int, b: int) -> int:와 같이 입력과 출력의 타입을 명시할 수 있습니다. 이는 강제성은 없지만, 협업과 디버깅 과정에서 코드의 안정성을 비약적으로 높여줍니다.

---

4. Sample Example: 실전 최적화 함수 정의

단순한 연산을 넘어, 예외 처리를 포함한 구조적인 함수 정의 사례입니다.

def calculate_grade(score: float) -> str:
    """
    점수를 입력받아 성적 등급을 반환하는 함수.
    
    Args:
        score (float): 0에서 100 사이의 점수
    Returns:
        str: A, B, C, D, F 중 하나의 등급
    """
    if not (0 <= score <= 100):
        return "Invalid Score"
    
    if score >= 90:
        return "A"
    elif score >= 80:
        return "B"
    elif score >= 70:
        return "C"
    elif score >= 60:
        return "D"
    else:
        return "F"

# 함수 호출 및 결과 활용
student_score = 85.5
grade = calculate_grade(student_score)
print(f"학생의 성적은 {grade}학점입니다.")

---

5. 초보자가 가장 많이 하는 실수: 스코프(Scope)

함수 내부에서 정의된 변수는 지역 변수(Local Variable)로, 함수 밖에서는 접근할 수 없습니다. 반대로 함수 밖의 전역 변수(Global Variable)를 함수 내부에서 수정하려면 global 키워드가 필요하지만, 이는 예기치 못한 부작용을 낳기 쉬우므로 지양하는 것이 좋습니다. 가급적 인자를 통해 값을 전달하고 결과값을 리턴받는 구조가 가장 안전합니다.

---

6. 결론: 함수는 프로그램의 문장이다

글을 쓸 때 문장이 명확해야 의미가 전달되듯, 프로그램에서는 함수 정의가 명확해야 로직이 전달됩니다. def라는 짧은 키워드로 시작하는 이 구조는 파이썬이 지향하는 "읽기 쉬운 코드"의 기초이자 전부입니다. 오늘부터는 단순히 작동하는 코드를 넘어, 타인이 읽었을 때 의도가 단번에 파악되는 아름다운 함수를 정의해 보시기 바랍니다.

---

7. 내용의 출처 및 참고 자료

• Python Software Foundation. "The Python Tutorial - Defining Functions".
• Guido van Rossum, Barry Warsaw, Nick Coghlan. "PEP 8 – Style Guide for Python Code".
• Effective Python by Brett Slatkin (Pearson Education).