#📄 dotenv-mbt: A MoonBit Environment Variable Loader

• 🔄 Environment Loading – Loads variables from .env files into your application
• 🔍 Variable Substitution – Supports variable substitution in env files
• 🛠️ Easy to Use – Simple API for quick integration
• 🔒 Safe – Non-modifying API that doesn't affect the global environment
• 🌟 MoonBit Native – Designed specifically for the MoonBit language

#📥 Installation

moon add ShellWen/dotenv

#🚀 Usage Guide for dotenv-mbt

#📝 What is an Environment File?

HOST=localhost
PORT=3000
DATABASE_URL=mysql://user:pass@localhost/dbname

#🔍 Basic Usage

fn main {
  let env_map = @dotenv.EnvLoader::new?().unwrap().load?().unwrap()
  let host = env_map.get("HOST").unwrap()
  println("HOST=\{host}")
}

#⚙️ Configuration Options

// Load from a specific file path
let loader1 = @dotenv.EnvLoader::from_path?("./.env.dev").unwrap()

// Default loader (equivalent to with_path("./.env"))
let loader2 = @dotenv.EnvLoader::new?().unwrap()

#🔄 Variable Access

let env_map = @dotenv.EnvLoader::new?().unwrap().load?().unwrap()

// Get a variable (returns Option)
let host = env_map.get("HOST").unwrap()

// Get with default value if not found
let port = match env_map.get("PORT") {
  Some(p) => p
  None => "8080"
}

// Check if a variable exists
if env_map.get("DATABASE_URL").is_some() {
  // Do something with database URL
}

#🔀 Variable Substitution

HOST=localhost
URL=http://${HOST}:3000

#⚠️ Error Handling

match @dotenv.EnvLoader::new?().unwrap().load?() {
  Ok(env) =>
    // Use environment variables
    println("Loaded successfully")
  Err(e) =>
    // Handle error
    println("Error loading .env file")
}

#🛠️ Full Example

fn main {
  // Load environment from .env file
  let env = @dotenv.EnvLoader::new?().unwrap().load?().unwrap()

  // Access variables
  let host = env.get("HOST").unwrap()
  let port = match env.get("PORT") {
    Some(p) => p
    None => "8080"  // Default to 8080 if not set
  }

  // Use variables in your application
  println("Server running at \{host}:\{port}")

  // Check if a variable exists
  if env.get("DEBUG").is_some() {
    println("Debug mode enabled")
  }
}

#📦 Project Structure

1. dotenv-mbt - Core library for loading and parsing environment files.

#📚 Inspiration

#📜 License

#📢 Contact & Support

• GitHub Issues: Report an issue