Struct ImportArgs 

pub struct ImportArgs {
    pub file: PathBuf,
    pub dry_run: bool,
    pub merge: bool,
    pub force: bool,
    pub strict: bool,
    pub remap_ids: bool,
    pub parent: Option<String>,
}

Arguments for the import subcommand

Fields

file: PathBuf

Path to the export file to import

dry_run: bool

Validate import without modifying database

Parses the file, validates schema compatibility, and reports what would be imported without making any changes.

merge: bool

Merge mode: add missing items, skip existing

By default, import replaces all project data. With –merge:

• Tasks: skip if ID already exists, insert if new
• Dependencies: skip if exact match exists
• Attachments: configurable via –attachment-mode

force: bool

Force overwrite of existing data without prompting

In replace mode (default): skip confirmation prompt In merge mode: overwrite conflicts instead of skipping

strict: bool

Enable strict validation mode

Rejects imports with:

• Circular dependencies (normally just warned)
• Missing referenced tasks
• Invalid status values

remap_ids: bool

Generate fresh IDs and remap all references

When enabled, every task receives a new petname ID and all references (dependencies, attachments, tags, state history) are updated to use the new IDs. This allows importing the same snapshot multiple times without ID collisions.

parent: Option<String>

Attach imported tree under a parent task

When provided, root tasks in the imported snapshot (those with no “contains” dependency pointing to them) will be linked to the given parent task via a “contains” dependency. This allows importing a snapshot as a subtree of an existing task.

Implementations

impl ImportArgs

pub fn is_gzipped(&self) -> bool

Check if this is a gzipped file based on extension

pub fn import_mode(&self) -> &'static str

Describe the import mode for logging

Trait Implementations

impl Args for ImportArgs

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl Debug for ImportArgs

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for ImportArgs

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.