import

Import graph information.

import [ --type <format> ] --from <path> [ --layers <layerlist> ] [ --name <importname> ]

--type

The --type argument specifies the kind of import. Valid options are :

noodle This is the default type if it is unspecified. The structure in the specified noodle directory is recreated in the local noodle.
graphml The graph is recreated on an import layer.
obsidian The graph is recreated on an import layer.

--from

The --from argument specifies where to get the import information. In the cases of --type noodle and --type obsidian a directory is imported. Noodle directories are required to have been [[Noodle Initialization|initialized]] with noodle. The Obisidian path does not require a .obsidian subdirectory, so long as there are markdown files which are linked using the Obsidian syntax e.g.:

Sample text that links to [[path/to/something|something]].
This is also a link: [[something else]].

In the case of a --type graphml import, the value of the --from argument is the path to a graphml file. In all cases, if the path does not contain the appropriate information, the command aborts.

--name

The --name flag sets the import name.

All imported doodles are given a prefix identical to the specified name resulting in each doodle being named according to the following format:

<specifiedname>.<originaldoodlename>

[[Illegal Doodle Names|Doodle naming constraint]] violations cause the command to abort.

In the cases of --type graphml and --type obsidian the links are made on a layer named with the import name.

If the --name flag is not specified import uses the behaviour specified in the table below:

Import Type	Default Import Name	Numbers for Subsequent Imports
`noodle`	`import_n`	`import_n1`, `import_n2`, `import_n3` etc.
`obisidian`	`import_b`	`import_b1`, `import_b2`, `import_b3` etc.
`graphml`	`import_g`	`import_g1`, `import_g2`, `import_g3` etc.

Note that if you name a random doodle using a prefix which follows the form above, this can result in the automatic prefixes skipping numbers. E.g. if there’s a doodle called import_n7_xx.weirdfileextension, an unspecified name may result in the automatic prefix import_n8.

--layers

The layerlist specifies which layers are to be imported. Only a --type noodle import permits specification of a layerlist. If no layers are specified, all layers are imported.

Alternative Usage

This command is also accessible from outside the interactive cli. I.e. you can call it in bash.

noodle import [ --type <format> ] --from <path> [ --layers <layerlist> ] [ --name <importname> ]

Arguments passed to the shell command behave the same way as in noodlecli. Running this command from the shell is not permitted if an instance of noodle currently has the working directory open.

Aliases

No command aliases.