Course contentsShow
← Data Science
Lesson 2072 of 2,14547. Reproducible ResearchFree lesson

Configuration Files vs Hard-Coded Values

Use config files (YAML, JSON, .env) to externalize parameters, paths, and settings from your code.

Configuration Files vs Hard-Coded Values

You'll learn why externalizing parameters into config files makes your data science projects more reproducible and maintainable.

The Problem with Hard-Coded Values

Imagine changing a file path or model parameter scattered across 15 different scripts—tedious and error-prone. Hard-coded values (like data_path = "/home/user/data.csv" or learning_rate = 0.001 written directly in your code) create several problems:

  • Difficult to change: Update the same value in multiple places
  • Not reproducible: Others can't easily adapt your paths and settings
  • Experimental tracking nightmare: Hard to remember which parameter combinations you've tested
  • Environment-specific: Your local paths won't work on a colleague's machine or cloud server

Configuration Files: The Better Way

Configuration files externalize all these settings into separate, version-controlled files. Think of them as a control panel for your project—change settings in one place, and all your scripts automatically use the updated values.

Common Formats

  • YAML: Human-readable, great for hierarchical settings
  • JSON: Structured, works everywhere
  • .env: Perfect for secrets and environment variables (but don't commit sensitive ones!)

Example Structure

Instead of hard-coding, you create a config.yaml:

data:
  raw_path: ./data/raw/input.csv
  processed_path: ./data/processed/clean.csv

model:
  learning_rate: 0.001
  n_estimators: 100

Your scripts read this file at runtime, making them portable and easy to modify without touching code.

Why This Matters for Reproducibility

When you share your project, others see exactly what parameters you used. Different experiments? Just swap config files. Different environments? Update paths once. Your code stays clean, focused on logic rather than settings.

Key Takeaway: Externalize all parameters, paths, and settings into configuration files to make your data science projects portable, reproducible, and easy to maintain across experiments and environments.