env_dir

func MakeDefault ¶

func MakeDefault(
	context errors.Context,
	utilityName string,
	debugOptions debug.Options,
	repoName string,
) mad_env_dir.Env

MakeDefault forwards to mad_env_dir.MakeDefault. The dodder EnvVarNames bundle is injected via configFor so the previous dodder-only env-var contracts (DODDER_XDG_UTILITY_OVERRIDE etc.) keep working.

func MakeDefaultAndInitialize ¶

func MakeDefaultAndInitialize(
	context errors.Context,
	utilityName string,
	do debug.Options,
	repoId scoped_id.Id,
) mad_env_dir.Env

func MakeDefaultNoInit ¶

func MakeDefaultNoInit(
	context errors.Context,
	utilityName string,
	debugOptions debug.Options,
	repoName string,
) mad_env_dir.Env

func MakeFromXDGDotenvPath ¶

func MakeFromXDGDotenvPath(
	context errors.Context,
	debugOptions debug.Options,
	xdgDotenvPath string,
	repoName string,
) mad_env_dir.Env

MakeFromXDGDotenvPath: scope is determined by the dotenv's XDG; configFor is therefore called with the dodder default since the scope isn't known until the dotenv is read. dodder's env-var bundle is the right choice here regardless because dodder processes always honor DODDER_XDG_UTILITY_OVERRIDE.

func MakeStandardXDGUser ¶ added in v0.2.6

func MakeStandardXDGUser(
	context errors.Context,
	utilityName string,
	debugOptions debug.Options,
	repoName string,
) mad_env_dir.Env

MakeStandardXDGUser builds a fully-initialized env_dir pinned to the XDG user home with the cwd walk-up DISABLED (permitCwdXDGOverride false), so it addresses the user-scope paths regardless of any ancestor .dodder/ override. Unlike MakeDefaultNoInit it runs the standard XDG initialization, so Data.ActualValue is populated and safe to read. Use it to enumerate the user scope alongside the cwd scope (FDR-0019 #276).

func MakeWithDefaultHome ¶

func MakeWithDefaultHome(
	context errors.Context,
	utilityName string,
	debugOptions debug.Options,
	permitCwdXDGOverride bool,
	initialize bool,
	repoName string,
) mad_env_dir.Env

func MakeWithHomeAndInitialize ¶

func MakeWithHomeAndInitialize(
	context errors.Context,
	utilityName string,
	home string,
	debugOptions debug.Options,
	repoName string,
) mad_env_dir.Env

MakeWithHomeAndInitialize keeps dodder's argument order (utilityName, home, debug) which differs from madder's (Config, scope, home).

func MakeWithXDG ¶

func MakeWithXDG(
	context errors.Context,
	debugOptions debug.Options,
	x xdg.XDG,
	repoName string,
) mad_env_dir.Env

MakeWithXDG: scope is on the supplied xdg.UtilityName; we route through configFor so the right env-var bundle attaches.

func MakeWithXDGRootOverrideHomeAndInitialize ¶

func MakeWithXDGRootOverrideHomeAndInitialize(
	context errors.Context,
	xdgRootOverride string,
	utilityName string,
	debugOptions debug.Options,
	repoName string,
) mad_env_dir.Env

MakeWithXDGRootOverrideHomeAndInitialize keeps dodder's argument order (xdgRootOverride before utilityName) for caller stability. Forwards to madder's MakeWithXDGRootOverrideHomeAndInitialize which uses the inverse order.