22. モジュールとパッケージでコードを整理する

# greetings.py
def say_hello(name):
    """Return a friendly greeting."""
    return f"Hello, {name}!"
 
def say_goodbye(name):
    """Return a farewell message."""
    return f"Goodbye, {name}. See you soon!"
 
# モジュールレベルの変数
default_greeting = "Welcome"

# main.py
import greetings
 
message = greetings.say_hello("Alice")
print(message)  # Output: Hello, Alice!
 
farewell = greetings.say_goodbye("Bob")
print(farewell)  # Output: Goodbye, Bob. See you soon!
 
print(greetings.default_greeting)  # Output: Welcome

import greetings
 
# 関数へのアクセス
result = greetings.say_hello("Charlie")
 
# 変数へのアクセス
greeting = greetings.default_greeting
 
# モジュールの中身を確認することもできます
print(dir(greetings))  # モジュールで定義されたすべての名前を一覧表示します

import sys
 
for path in sys.path:
    print(path)

/home/user/projects/myproject
/usr/lib/python3.11
/usr/lib/python3.11/lib-dynload
/usr/local/lib/python3.11/site-packages

# 有効なモジュール名(およびファイル名)
import data_processor      # data_processor.py
import user_auth          # user_auth.py
import _internal_helpers  # _internal_helpers.py
 
# 無効 - エラーの原因になります
# import 2d_graphics       # Can't start with digit
# import my-module         # Hyphens not allowed
# import class             # 'class' is a keyword

# あなたのファイル: random.py
def my_function():
    return 42
 
# プロジェクト内の別ファイル
import random
print(random.randint(1, 6))  # ERROR! Your random.py doesn't have randint()

# demo_module.py
print("Module is being loaded!")
 
def greet():
    print("Hello from demo_module")
 
print("Module loading complete!")

# test_import.py
print("Before import")
import demo_module
print("After import")
 
demo_module.greet()

Before import
Module is being loaded!
Module loading complete!
After import
Hello from demo_module

import demo_module  # First import - executes module code
import demo_module  # Second import - uses cached module
import demo_module  # Third import - still uses cached module

Module is being loaded!
Module loading complete!

import math
 
result = math.sqrt(16)
print(result)  # Output: 4.0
 
pi_value = math.pi
print(pi_value)  # Output: 3.141592653589793

from math import sqrt, pi
 
result = sqrt(25)  # No 'math.' prefix needed
print(result)  # Output: 5.0
 
print(pi)  # Output: 3.141592653589793

# Using from import
from greetings import say_hello
 
message = say_hello("Diana")  # Direct access
print(message)  # Output: Hello, Diana!
 
# However, say_goodbye is not available since we didn't import it
# say_goodbye("Diana")  # NameError: name 'say_goodbye' is not defined

from greetings import say_hello, say_goodbye, default_greeting
 
print(say_hello("Eve"))      # Output: Hello, Eve!
print(say_goodbye("Frank"))  # Output: Goodbye, Frank!
print(default_greeting)      # Output: Welcome

from math import *
 
print(sqrt(9))   # Output: 3.0
print(cos(0))    # Output: 1.0
print(pi)        # Output: 3.141592653589793

# 問題が起きやすい例
from math import *
 
# 後でコード内に...
def sqrt(x):
    """Your own square root function."""
    return x ** 0.5
 
# どちらの sqrt を使っていますか? 自分のもの、それとも math のもの?
result = sqrt(16)  # Confusing!

import math as m
 
result = m.sqrt(36)
print(result)  # Output: 6.0

import datetime as dt
 
today = dt.date.today()
print(today)  # Output: 2025-12-19 (or current date)

from math import sqrt as square_root
 
result = square_root(49)
print(result)  # Output: 7.0

from math import sqrt as math_sqrt
 
def sqrt(x):
    """Custom square root with input validation."""
    if x < 0:
        return None
    return math_sqrt(x)
 
print(sqrt(25))   # Output: 5.0 (your function)
print(sqrt(-4))   # Output: None (your function)

import math
from datetime import date, time
from random import randint as random_int
 
# プレフィックス付きで math を使う
radius = 5
area = math.pi * radius ** 2
 
# date と time を直接使う
today = date.today()
current_time = time(14, 30)
 
# 別名を付けた関数を使う
dice_roll = random_int(1, 6)

# data_processor.py
import math
from statistics import mean, median
from datetime import datetime as dt
 
def calculate_statistics(numbers):
    """Calculate various statistics for a list of numbers."""
    if not numbers:
        return None
    
    avg = mean(numbers)
    mid = median(numbers)
    std_dev = math.sqrt(sum((x - avg) ** 2 for x in numbers) / len(numbers))
    
    return {
        'mean': avg,
        'median': mid,
        'std_dev': std_dev,
        'timestamp': dt.now()
    }
 
# Test the function
data = [10, 20, 30, 40, 50]
stats = calculate_statistics(data)
print(f"Mean: {stats['mean']}")      # Output: Mean: 30.0
print(f"Median: {stats['median']}")  # Output: Median: 30
print(f"Std Dev: {stats['std_dev']:.2f}")  # Output: Std Dev: 14.14

import math
 
# 三角関数
angle_rad = math.radians(45)  # 度をラジアンに変換
print(math.sin(angle_rad))    # Output: 0.7071067811865476
print(math.cos(angle_rad))    # Output: 0.7071067811865475
 
# 丸めと絶対値
print(math.ceil(4.2))   # Output: 5 (round up)
print(math.floor(4.8))  # Output: 4 (round down)
print(math.fabs(-7.5))  # Output: 7.5 (absolute value as float)
 
# 指数と対数
print(math.exp(2))      # Output: 7.38905609893065 (e^2)
print(math.log(100))    # Output: 4.605170185988092 (natural log)
print(math.log10(100))  # Output: 2.0 (base-10 log)
 
# 定数
print(math.pi)  # Output: 3.141592653589793
print(math.e)   # Output: 2.718281828459045

import random
 
# ランダム整数
dice = random.randint(1, 6)  # Random integer from 1 to 6 (inclusive)
print(f"Dice roll: {dice}")
 
# ランダム浮動小数
probability = random.random()  # Random float from 0.0 to 1.0
print(f"Probability: {probability:.4f}")
 
# シーケンスからランダムに 1 つ選ぶ
colors = ['red', 'blue', 'green', 'yellow']
chosen_color = random.choice(colors)
print(f"Chosen color: {chosen_color}")
 
# リストをその場でシャッフル
deck = ['A', 'K', 'Q', 'J', '10']
random.shuffle(deck)
print(f"Shuffled deck: {deck}")
 
# 重複なしのランダムサンプル
lottery_numbers = random.sample(range(1, 50), 6)
print(f"Lottery numbers: {sorted(lottery_numbers)}")

Dice roll: 4
Probability: 0.7382
Chosen color: green
Shuffled deck: ['Q', 'A', '10', 'K', 'J']
Lottery numbers: [7, 15, 23, 31, 38, 42]

from datetime import date, time, datetime, timedelta
 
# 現在の日付と時刻
today = date.today()
now = datetime.now()
print(f"Today: {today}")  # Output: Today: 2025-12-19
print(f"Now: {now}")      # Output: Now: 2025-12-19 14:30:45.123456
 
# 特定の日付と時刻の作成
birthday = date(1990, 5, 15)
meeting_time = time(14, 30)
appointment = datetime(2025, 12, 25, 10, 0)
 
print(f"Birthday: {birthday}")          # Output: Birthday: 1990-05-15
print(f"Meeting: {meeting_time}")       # Output: Meeting: 14:30:00
print(f"Appointment: {appointment}")    # Output: Appointment: 2025-12-25 10:00:00
 
# timedelta による日付計算
tomorrow = today + timedelta(days=1)
next_week = today + timedelta(weeks=1)
print(f"Tomorrow: {tomorrow}")    # Output: Tomorrow: 2025-12-20
print(f"Next week: {next_week}")  # Output: Next week: 2025-12-26
 
# 構成要素の取り出し
print(f"Year: {today.year}")      # Output: Year: 2025
print(f"Month: {today.month}")    # Output: Month: 12
print(f"Day: {today.day}")        # Output: Day: 19

import os
 
# 現在の作業ディレクトリ
current_dir = os.getcwd()
print(f"Current directory: {current_dir}")
 
# ディレクトリ内のファイル一覧
files = os.listdir('.')
print(f"Files: {files[:3]}")  # 最初の 3 件を表示
 
# パスが存在するかチェック
exists = os.path.exists('myfile.txt')
print(f"File exists: {exists}")
 
# パス要素を結合(OS 間で動作)
file_path = os.path.join('data', 'users', 'profile.txt')
print(f"Path: {file_path}")  # Output: data/users/profile.txt (or data\users\profile.txt on Windows)

import sys
 
# Python のバージョン情報
print(f"Python version: {sys.version}")
print(f"Version info: {sys.version_info}")
 
# プラットフォーム情報
print(f"Platform: {sys.platform}")  # Output: linux, darwin, win32, etc.
 
# 最大整数サイズ
print(f"Max int: {sys.maxsize}")

import statistics
 
grades = [85, 92, 78, 90, 88, 95, 82]
 
# 中心傾向
avg = statistics.mean(grades)
mid = statistics.median(grades)
mode_val = statistics.mode([1, 2, 2, 3, 3, 3, 4])
 
print(f"Mean: {avg}")      # Output: Mean: 87.14285714285714
print(f"Median: {mid}")    # Output: Median: 88
print(f"Mode: {mode_val}") # Output: Mode: 3
 
# ばらつき
std_dev = statistics.stdev(grades)
variance = statistics.variance(grades)
 
print(f"Standard deviation: {std_dev:.2f}")  # Output: Standard deviation: 5.90
print(f"Variance: {variance:.2f}")           # Output: Variance: 34.81

from collections import Counter, defaultdict
 
# Counter - 出現回数を数える
text = "hello world"
letter_counts = Counter(text)
print(letter_counts)  # Output: Counter({'l': 3, 'o': 2, 'h': 1, 'e': 1, ' ': 1, 'w': 1, 'r': 1, 'd': 1})
print(letter_counts['l'])  # Output: 3
 
# defaultdict - デフォルト値を持つ辞書
word_lists = defaultdict(list)
word_lists['fruits'].append('apple')
word_lists['fruits'].append('banana')
word_lists['vegetables'].append('carrot')
print(dict(word_lists))  # Output: {'fruits': ['apple', 'banana'], 'vegetables': ['carrot']}

# 利用可能なモジュールをすべて表示(少し時間がかかります)
help('modules')
 
# 特定モジュールのヘルプを表示
import math
help(math)
 
# モジュールの中身を確認
import random
print(dir(random))

# grade_calculator.py
"""Module for calculating and analyzing student grades."""
 
def calculate_average(grades):
    """Calculate the average of a list of grades."""
    if not grades:
        return 0
    return sum(grades) / len(grades)
 
def get_letter_grade(numeric_grade):
    """Convert a numeric grade to a letter grade."""
    if numeric_grade >= 90:
        return 'A'
    elif numeric_grade >= 80:
        return 'B'
    elif numeric_grade >= 70:
        return 'C'
    elif numeric_grade >= 60:
        return 'D'
    else:
        return 'F'
 
def find_highest(grades):
    """Find the highest grade in a list."""
    if not grades:
        return None
    return max(grades)
 
def find_lowest(grades):
    """Find the lowest grade in a list."""
    if not grades:
        return None
    return min(grades)
 
# モジュールレベルの定数
PASSING_GRADE = 60
HONOR_ROLL_THRESHOLD = 90

# student_report.py
import grade_calculator
 
# 学生のテスト得点
test_scores = [85, 92, 78, 88, 95]
 
# 統計値を計算
average = grade_calculator.calculate_average(test_scores)
letter = grade_calculator.get_letter_grade(average)
highest = grade_calculator.find_highest(test_scores)
lowest = grade_calculator.find_lowest(test_scores)
 
# レポートを生成
print("Student Grade Report")
print("=" * 40)
print(f"Test Scores: {test_scores}")
print(f"Average: {average:.1f}")
print(f"Letter Grade: {letter}")
print(f"Highest Score: {highest}")
print(f"Lowest Score: {lowest}")
 
# 成績優秀者かチェック
if average >= grade_calculator.HONOR_ROLL_THRESHOLD:
    print("Status: HONOR ROLL!")
elif average >= grade_calculator.PASSING_GRADE:
    print("Status: Passing")
else:
    print("Status: Needs Improvement")

Student Grade Report
========================================
Test Scores: [85, 92, 78, 88, 95]
Average: 87.6
Letter Grade: B
Highest Score: 95
Lowest Score: 78
Status: Passing

import grade_calculator
help(grade_calculator)

# config.py
"""Application configuration settings."""
 
# データベース設定
DB_HOST = "localhost"
DB_PORT = 5432
DB_NAME = "myapp"
 
# アプリケーション設定
MAX_LOGIN_ATTEMPTS = 3
SESSION_TIMEOUT = 1800  # seconds
DEBUG_MODE = False
 
# ファイルパス
DATA_DIR = "/var/data"
LOG_DIR = "/var/log"
 
# 機能フラグ
ENABLE_CACHING = True
ENABLE_LOGGING = True

# app.py
import config
 
def connect_database():
    """Connect to the database using config settings."""
    print(f"Connecting to {config.DB_HOST}:{config.DB_PORT}")
    print(f"Database: {config.DB_NAME}")
    
    if config.DEBUG_MODE:
        print("DEBUG: Connection details logged")
 
def check_login_attempts(attempts):
    """Check if login attempts exceed the limit."""
    if attempts >= config.MAX_LOGIN_ATTEMPTS:
        print(f"Too many attempts! Maximum is {config.MAX_LOGIN_ATTEMPTS}")
        return False
    return True
 
connect_database()
print(check_login_attempts(2))  # Output: True
print(check_login_attempts(4))  # Output: Too many attempts! Maximum is 3

Connecting to localhost:5432
Database: myapp
True
Too many attempts! Maximum is 3

# file1.py
import config
config.DEBUG_MODE = True
print(f"File1 - Debug mode: {config.DEBUG_MODE}")
 
# file2.py
import config
print(f"File2 - Debug mode: {config.DEBUG_MODE}")  # Will be True!

# user_manager.py
"""Module for managing user accounts."""
 
# プライベートなヘルパー関数
def _validate_email(email):
    """Internal function to validate email format."""
    return '@' in email and '.' in email
 
# 公開関数
def create_user(username, email):
    """Create a new user account."""
    if not _validate_email(email):
        return None
    
    user = {
        'username': username,
        'email': email,
        'active': True
    }
    return user
 
# プライベート定数
_MAX_USERNAME_LENGTH = 20
 
# 公開定数
MIN_PASSWORD_LENGTH = 8

import user_manager
 
# 公開関数 - 利用が意図されている
user = user_manager.create_user("alice", "alice@example.com")
 
# プライベート関数 - アクセスはできるが頼るべきではない
# (将来のバージョンで変更される可能性があります)
is_valid = user_manager._validate_email("test@test.com")

myproject/
    main.py
    utilities/
        __init__.py
        text.py
        math.py
        file.py

data_tools/
    __init__.py
    validators.py
    formatters.py

# data_tools/validators.py
"""Data validation functions."""
 
def is_valid_email(email):
    """Check if email has basic valid format."""
    return '@' in email and '.' in email.split('@')[1]
 
def is_valid_phone(phone):
    """Check if phone number has valid format (simple check)."""
    digits = ''.join(c for c in phone if c.isdigit())
    return len(digits) == 10
 
def is_positive_number(value):
    """Check if value is a positive number."""
    try:
        return float(value) > 0
    except (ValueError, TypeError):
        return False

# data_tools/formatters.py
"""Data formatting functions."""
 
def format_phone(phone):
    """Format phone number as (XXX) XXX-XXXX."""
    digits = ''.join(c for c in phone if c.isdigit())
    if len(digits) != 10:
        return phone
    return f"({digits[:3]}) {digits[3:6]}-{digits[6:]}"
 
def format_currency(amount):
    """Format number as currency."""
    return f"${amount:,.2f}"
 
def format_percentage(value, decimals=1):
    """Format number as percentage."""
    return f"{value * 100:.{decimals}f}%"

# data_tools/__init__.py
"""Data processing tools package."""

# Method 1: Import the module from the package
import data_tools.validators
 
email = "user@example.com"
is_valid = data_tools.validators.is_valid_email(email)
print(f"Email valid: {is_valid}")  # Output: Email valid: True
 
# Method 2: Import specific module with from
from data_tools import formatters
 
phone = "1234567890"
formatted = formatters.format_phone(phone)
print(f"Formatted phone: {formatted}")  # Output: Formatted phone: (123) 456-7890
 
# Method 3: Import specific functions
from data_tools.validators import is_valid_phone
from data_tools.formatters import format_currency
 
print(is_valid_phone("555-1234"))  # Output: False (not 10 digits)
print(format_currency(1234.56))    # Output: $1,234.56

# data_tools/__init__.py
"""Data processing tools package."""
 
# よく使う関数をパッケージ名前空間にインポート
from data_tools.validators import is_valid_email, is_valid_phone
from data_tools.formatters import format_phone, format_currency
 
# パッケージバージョン
__version__ = '1.0.0'
 
# パッケージレベルの定数
DEFAULT_CURRENCY_SYMBOL = '$'

# Instead of: from data_tools.validators import is_valid_email
# You can write:
from data_tools import is_valid_email, format_currency
 
print(is_valid_email("test@test.com"))  # Output: True
print(format_currency(99.99))           # Output: $99.99

# demo_name.py
print(f"The __name__ variable is: {__name__}")

python demo_name.py

The __name__ variable is: __main__

# test_import.py
import demo_name

The __name__ variable is: demo_name

if __name__ == "__main__":
    # Code here runs only when file is executed directly
    pass

# math_utils.py
"""Utility functions for mathematical operations."""
 
def calculate_area(radius):
    """Calculate the area of a circle."""
    return 3.14159 * radius ** 2
 
def calculate_circumference(radius):
    """Calculate the circumference of a circle."""
    return 2 * 3.14159 * radius
 
# テストコード - ファイルが直接実行されたときだけ動きます
if __name__ == "__main__":
    print("Testing math_utils functions...")
    
    test_radius = 5
    area = calculate_area(test_radius)
    circumference = calculate_circumference(test_radius)
    
    print(f"Radius: {test_radius}")
    print(f"Area: {area:.2f}")
    print(f"Circumference: {circumference:.2f}")

python math_utils.py

Testing math_utils functions...
Radius: 5
Area: 78.54
Circumference: 31.42

# use_math_utils.py
import math_utils
# テストコードは実行されません!
 
area = math_utils.calculate_area(10)
print(f"Area of circle: {area:.2f}")  # Output: Area of circle: 314.16

# string_tools.py
def reverse_string(text):
    """Reverse a string."""
    return text[::-1]
 
def count_vowels(text):
    """Count vowels in text."""
    vowels = 'aeiouAEIOU'
    return sum(1 for char in text if char in vowels)
 
if __name__ == "__main__":
    # デモ用コード
    sample = "Hello, World!"
    
    print(f"Original: {sample}")
    print(f"Reversed: {reverse_string(sample)}")
    print(f"Vowels: {count_vowels(sample)}")