Chương trình học Bài 46 trên tổng số 250 · Tệp, lỗi và mô-đun
Tệp, lỗi và mô-đun

Cấu hình và bí mật

Chương trình thật cần những thiết lập không nên nằm trong mã: khóa API, URL cơ sở dữ liệu, một cờ debug. Có hai lý do để giữ chúng ở ngoài. Thứ nhất, bí mật trong mã nguồn bị rò rỉ: ngay khi bạn commit một khóa API vào git, nó nằm trong lịch sử mãi mãi, và đẩy lên một repo công khai là trao nó cho cả thế giới. Thứ hai, cùng một mã nên chạy ở những nơi khác nhau (laptop của bạn, một máy chủ) với các thiết lập khác nhau.

Câu trả lời chuẩn là biến môi trường: các giá trị có tên mà hệ điều hành đưa cho tiến trình của bạn. Python đọc chúng từ os.environ, thứ cư xử như một dict:

import os
key = os.environ["API_KEY"]              # raises KeyError if missing
debug = os.environ.get("DEBUG", "off")   # a safe default instead

Khi phát triển, bạn giữ chúng trong một tệp .env mà bạn không bao giờ commit (bạn thêm .env vào .gitignore). Nó chỉ là các dòng KEY=value:

API_KEY=sk-abc123
# a comment
MODEL=claude-opus-5-5
DEBUG=on

Các thư viện như python-dotenv nạp tệp đó vào os.environ giùm bạn. Bên dưới, chúng phân tích đúng những dòng này. Trong bài tập này bạn sẽ tự viết bộ phân tích đó, cộng một hàm phụ che một bí mật để in nó vào log một cách an toàn.

Quy tắc vàng: đọc bí mật từ môi trường, ghi log ở dạng đã che, và không bao giờ mã hóa cứng chúng.

Đến lượt bạn

Xây ba hàm phụ. (1) load_env(text) phân tích nội dung của một tệp .env thành một dict. Bỏ qua dòng trống và dòng chú thích (bắt đầu bằng #). Tách mỗi dòng còn lại ở dấu = đầu tiên. Strip khoảng trắng, và bỏ một cặp dấu nháy bao quanh khỏi giá trị nếu có. Chỉ giữ một dòng nếu khóa là một tên môi trường hợp lệ: toàn chữ hoa, và là một định danh Python hợp lệ (chữ cái, chữ số và dấu gạch dưới, không bắt đầu bằng chữ số). (2) get_setting(env, key, default=None) trả về env[key] nếu có, nếu không thì default. (3) redact(value) trả về một chuỗi an toàn để ghi log chỉ hiện 4 ký tự cuối, ví dụ redact("sk-abc123") là "****c123"; các giá trị từ 4 ký tự trở xuống thành "****".

Bạn thấy vấn đề gì trong bài học này? Hãy báo cáo nó · Hỏi về bài học này

Bài tập này sẽ sớm mở.

Hoàn thành bài học trước đó để mở khóa bài này. Toàn bộ khóa học là miễn phí, không cần tài khoản, và bạn có thể đọc bài học này ngay bây giờ.