Allow users to specify config values at runtime such as document name, directory name, and other fields directly from the command line when executing dodl commands, adding flexibility and control over document generation.
This already exists for dates and placeholders (e.g. Topic), but should be expanded to directory path etc.
Motivation
Providing the ability to specify config values from the command line enhances user experience by enabling powerful overrides and potentially zero-reliance on configuration files. This could open up possibilities like testing new placeholders / paths etc.
Proposed Solution
Add support for command-line flags or arguments that allow users to input values like document name, directory, and specific document fields dynamically. For instance, dodl create --filename "MyDoc" --dir "ProjectX" --topic "Standup" could populate the specified values directly into the generated document.
Alternatives Considered
Using Environment Variables: While a possible alternative, environment variables do not provide the same level of flexibility or ease as command-line flags for one-off customisation.
Prompting for Missing Values: While prompting could achieve a similar outcome, it would require interactive input, which may not align with the headless operation goal.
Additional Context
This enhancement should integrate seamlessly with existing configuration and templating logic, allowing dynamic value insertion while maintaining overall consistency with the configuration file's default settings.
Checklist
[x] I have checked existing issues to ensure this feature has not been requested.
[x] I have considered the potential impact on existing functionality.
Summary
Allow users to specify config values at runtime such as document name, directory name, and other fields directly from the command line when executing
dodlcommands, adding flexibility and control over document generation.This already exists for dates and placeholders (e.g. Topic), but should be expanded to directory path etc.
Motivation
Providing the ability to specify config values from the command line enhances user experience by enabling powerful overrides and potentially zero-reliance on configuration files. This could open up possibilities like testing new placeholders / paths etc.
Proposed Solution
Add support for command-line flags or arguments that allow users to input values like document name, directory, and specific document fields dynamically. For instance,
dodl create --filename "MyDoc" --dir "ProjectX" --topic "Standup"could populate the specified values directly into the generated document.Alternatives Considered
Additional Context
This enhancement should integrate seamlessly with existing configuration and templating logic, allowing dynamic value insertion while maintaining overall consistency with the configuration file's default settings.
Checklist