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)

                                                                                              JUST-IMPORT-GIT(1)