NAME¶

just-import-git - import one Git repository to a multi-repository configuration

SYNOPSIS¶

just-import-git [OPTION]... URL [foreign repository name]

DESCRIPTION¶

Extend an existing just-mr-repository-config(5) by adding one Git repository. In doing so, the dependencies declared in the imported repository are added as well and "file" repositories are transformed to "subdir" parts of the imported repository. This solves the problem, that a repository can refer to itself only as "." in a portable way. The importing party, however, always knows the URL it is importing from.

The imported repositories are renamed in a way that no conflicts with already present repositories arise. The repositories pulled in as dependencies are named in a way to remind for which repositories they came as a dependency. This renaming is taken into account at all places repositories are referred to, i.e., the "bindings" field, as well as roots defined by reference to other repositories.

Only the main parts of repositories are imported ("repository", "bindings", names, and roots). The "pragma" part, as well as unknown fields are dropped.

The repository to import is specified by its URL

The resulting configuration is printed on standard output.

OPTIONS¶

--as NAME

Specify the name the imported repository should have in the final configuration. If not specified, default to the name the repository has in the configuration file of the repository imported. In any case, the name is amended if it conflicts with an already existing name.

-b BRANCH

The branch in the imported repository to use; this branch is also recorded as the branch to follow. Defaults to "master".

-C CONFIGFILE

Use the specified file as the configuration to import into. The string - is treated as a request to take the config from stdin; so a file called - has to be described as ./-, or similar. If not specified, a config file is searched for in the same way as just-mr does when invoked with --norc.

-h, --help

Output a usage message and exit.

--map THEIRS OURS

Map repositories from the imported configuration to already existing ones. Those repositories are not imported (and the search for their transitive dependency is omitted) and instead the specified already existing repository is used. This is useful, if a sufficiently compatible repository already exists in the configuration.

-R RELPATH

Use the file, specified by path relative to the repository root, as multi-repository specification in the imported repository. If not specified, for a config file is searched in the same way as just-mr does, when invoked with --no-rc, however leaving out searches relative to global roots ("home" and "system"). In other words, repos.json and etc/repos.json are tried if this option is not given.

--plain

Pretend the foreign multi-repository specification is the canonical one for a single repository. Useful, if the repository to be imported does not have a repository configuration or should be imported without dependencies.

--absent

Add the pragma {"absent": true} to all imported repositories.

--mirror URL

Provides an alternative fetch location for the imported repository. Specifying this option multiple times will accumulate URLs in the order they appear on the command line. These URLs will not be used during the import, but instead will be recorded as the value of the "mirrors" key in the resulting configuration of the imported repository. See just-mr-repository-config(5).

--inherit-env VAR

Specify, for the imported repository, environment variables to be inherited when fetching the repository by calling git. These variables will not be taken into account during the import (where the whole environment is inherited), but instead will be recorded as the value for the "inherit env" key in the resulting configuration of the imported repository. See just-mr-repository-config(5).

See also¶

git(1), just-deduplicate-repos(1), just-mr-repository-config(5), just-mr(1)