Class SubmoduleWalk
- All Implemented Interfaces:
AutoCloseable
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic enum
The values for the config parameter submodule.<name>.ignore -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate RepositoryBuilderFactory
private Config
private String
private StoredConfig
private final Repository
private AbstractTreeIterator
private final TreeWalk
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
static boolean
containsGitModulesFile
(Repository repository) Checks whether the working tree contains a .gitmodules file.static SubmoduleWalk
forIndex
(Repository repository) Create a generator to walk over the submodule entries currently in the index The.gitmodules
file is read from the index.static SubmoduleWalk
forPath
(Repository repository, AnyObjectId treeId, String path) Create a generator and advance it to the submodule entry at the given pathstatic SubmoduleWalk
forPath
(Repository repository, AbstractTreeIterator iterator, String path) Create a generator and advance it to the submodule entry at the given pathprivate BaseRepositoryBuilder
<?, ? extends Repository> Get the configured update field for current entry.Get the configured remote URL for current entry.Get directory that will be the root of the submodule's local repositorygetHead()
Get commit id that HEAD points to in the current submodule's repositoryGet ref that HEAD points to in the current submodule's repositoryThe module name for the current submodule entry (used for the section name of .git/config)private String
getModuleName
(String modulePath) Get the configured ignore field for the current entry.Get the configured path for current entry.Get the configured update field for current entry.Get the configured remote URL for current entry.Get object id of current submodule entrygetPath()
Get path of current submodule entryGet the resolved remote URL for the current submodule.Get repository for current submodule entrystatic File
getSubmoduleDirectory
(Repository parent, String path) Get submodule directorystatic String
getSubmoduleRemoteUrl
(Repository parent, String url) Resolve submodule repository URL.static Repository
getSubmoduleRepository
(File parent, String path) Get submodule repository at pathstatic Repository
getSubmoduleRepository
(File parent, String path, FS fs) Get submodule repository at path, using the specified file system abstractionstatic Repository
getSubmoduleRepository
(File parent, String path, FS fs, BaseRepositoryBuilder<?, ? extends Repository> builder) Get submodule repository at path, using the specified file system abstraction and the specified builderstatic Repository
getSubmoduleRepository
(Repository parent, String path) Get submodule repositoryprivate void
Load the config for this walk from.gitmodules
.private void
boolean
next()
Advance to next submodule in the index tree.reset()
Reset generator and start new submodule walkvoid
Sets theRepositoryBuilderFactory
to use for creating submodule repositories.setFilter
(TreeFilter filter) Set tree filtersetModulesConfig
(Config config) Set the config used by this walk.Set the tree used by this walk for finding.gitmodules
.Set the tree used by this walk for finding.gitmodules
.setTree
(AnyObjectId treeId) Set the tree used for finding submodule entriessetTree
(AbstractTreeIterator iterator) Set the tree iterator used for finding submodule entries
-
Field Details
-
repository
-
walk
-
repoConfig
-
rootTree
-
modulesConfig
-
path
-
pathToName
-
factory
-
-
Constructor Details
-
SubmoduleWalk
Create submodule generator- Parameters:
repository
- theRepository
.- Throws:
IOException
-
-
Method Details
-
forIndex
Create a generator to walk over the submodule entries currently in the index The.gitmodules
file is read from the index.- Parameters:
repository
- aRepository
object.- Returns:
- generator over submodule index entries. The caller is responsible
for calling
close()
. - Throws:
IOException
-
forPath
public static SubmoduleWalk forPath(Repository repository, AnyObjectId treeId, String path) throws IOException Create a generator and advance it to the submodule entry at the given path- Parameters:
repository
- aRepository
object.treeId
- the root of a tree containing both a submodule at the given path and .gitmodules at the root.path
- aString
object.- Returns:
- generator at given path. The caller is responsible for calling
close()
. Null if no submodule at given path. - Throws:
IOException
-
forPath
public static SubmoduleWalk forPath(Repository repository, AbstractTreeIterator iterator, String path) throws IOException Create a generator and advance it to the submodule entry at the given path- Parameters:
repository
- aRepository
object.iterator
- the root of a tree containing both a submodule at the given path and .gitmodules at the root.path
- aString
object.- Returns:
- generator at given path. The caller is responsible for calling
close()
. Null if no submodule at given path. - Throws:
IOException
-
getSubmoduleDirectory
Get submodule directory- Parameters:
parent
- theRepository
.path
- submodule path- Returns:
- directory
-
getSubmoduleRepository
Get submodule repository- Parameters:
parent
- theRepository
.path
- submodule path- Returns:
- repository or null if repository doesn't exist
- Throws:
IOException
-
getSubmoduleRepository
Get submodule repository at path- Parameters:
parent
- the parentpath
- submodule path- Returns:
- repository or null if repository doesn't exist
- Throws:
IOException
-
getSubmoduleRepository
Get submodule repository at path, using the specified file system abstraction- Parameters:
parent
-path
-fs
- the file system abstraction to be used- Returns:
- repository or null if repository doesn't exist
- Throws:
IOException
- Since:
- 4.10
-
getSubmoduleRepository
public static Repository getSubmoduleRepository(File parent, String path, FS fs, BaseRepositoryBuilder<?, ? extends Repository> builder) throws IOExceptionGet submodule repository at path, using the specified file system abstraction and the specified builder- Parameters:
parent
-Repository
that contains the submodulepath
- of the working tree of the submodulefs
-FS
to usebuilder
-BaseRepositoryBuilder
to use to build the submodule repository- Returns:
- the
Repository
of the submodule, ornull
if it doesn't exist - Throws:
IOException
- on errors- Since:
- 5.6
-
getSubmoduleRemoteUrl
Resolve submodule repository URL.This handles relative URLs that are typically specified in the '.gitmodules' file by resolving them against the remote URL of the parent repository.
Relative URLs will be resolved against the parent repository's working directory if the parent repository has no configured remote URL.
- Parameters:
parent
- parent repositoryurl
- absolute or relative URL of the submodule repository- Returns:
- resolved URL
- Throws:
IOException
-
setModulesConfig
Set the config used by this walk. This method need only be called if constructing a walk manually instead of with one of the static factory methods above.- Parameters:
config
- .gitmodules config object- Returns:
- this generator
-
setRootTree
Set the tree used by this walk for finding.gitmodules
.The root tree is not read until the first submodule is encountered by the walk.
This method need only be called if constructing a walk manually instead of with one of the static factory methods above.
- Parameters:
tree
- tree containing .gitmodules- Returns:
- this generator
-
setRootTree
Set the tree used by this walk for finding.gitmodules
.The root tree is not read until the first submodule is encountered by the walk.
This method need only be called if constructing a walk manually instead of with one of the static factory methods above.
- Parameters:
id
- ID of a tree containing .gitmodules- Returns:
- this generator
- Throws:
IOException
-
loadModulesConfig
Load the config for this walk from.gitmodules
.Uses the root tree if
setRootTree(AbstractTreeIterator)
was previously called, otherwise uses the working tree.If no submodule config is found, loads an empty config.
- Returns:
- this generator
- Throws:
IOException
- if an error occurred, or if the repository is bareConfigInvalidException
-
loadPathNames
private void loadPathNames() -
containsGitModulesFile
Checks whether the working tree contains a .gitmodules file. That's a hint that the repo contains submodules.- Parameters:
repository
- the repository to check- Returns:
true
if the working tree contains a .gitmodules file,false
otherwise. Always returnsfalse
for bare repositories.- Throws:
IOException
CorruptObjectException
- if any.- Since:
- 3.6
-
lazyLoadModulesConfig
- Throws:
IOException
ConfigInvalidException
-
getModuleName
-
setFilter
Set tree filter- Parameters:
filter
- aTreeFilter
object.- Returns:
- this generator
-
setTree
Set the tree iterator used for finding submodule entries- Parameters:
iterator
- anAbstractTreeIterator
object.- Returns:
- this generator
- Throws:
CorruptObjectException
-
setTree
Set the tree used for finding submodule entries- Parameters:
treeId
- anAnyObjectId
object.- Returns:
- this generator
- Throws:
IOException
IncorrectObjectTypeException
- if any.MissingObjectException
- if any.
-
reset
Reset generator and start new submodule walk- Returns:
- this generator
-
getDirectory
Get directory that will be the root of the submodule's local repository- Returns:
- submodule repository directory
-
next
Advance to next submodule in the index tree. The object id and path of the next entry can be obtained by callinggetObjectId()
andgetPath()
.- Returns:
- true if entry found, false otherwise
- Throws:
IOException
-
getPath
Get path of current submodule entry- Returns:
- path
-
setBuilderFactory
Sets theRepositoryBuilderFactory
to use for creating submodule repositories. If none is set, a plainRepositoryBuilder
is used.- Parameters:
factory
- to set- Since:
- 5.6
-
getBuilder
-
getModuleName
The module name for the current submodule entry (used for the section name of .git/config)- Returns:
- name
- Throws:
ConfigInvalidException
IOException
- Since:
- 4.10
-
getObjectId
Get object id of current submodule entry- Returns:
- object id
-
getModulesPath
Get the configured path for current entry. This will be the value from the .gitmodules file in the current repository's working tree.- Returns:
- configured path
- Throws:
ConfigInvalidException
IOException
-
getConfigUrl
Get the configured remote URL for current entry. This will be the value from the repository's config.- Returns:
- configured URL
- Throws:
ConfigInvalidException
IOException
-
getModulesUrl
Get the configured remote URL for current entry. This will be the value from the .gitmodules file in the current repository's working tree.- Returns:
- configured URL
- Throws:
ConfigInvalidException
IOException
-
getConfigUpdate
Get the configured update field for current entry. This will be the value from the repository's config.- Returns:
- update value
- Throws:
ConfigInvalidException
IOException
-
getModulesUpdate
Get the configured update field for current entry. This will be the value from the .gitmodules file in the current repository's working tree.- Returns:
- update value
- Throws:
ConfigInvalidException
IOException
-
getModulesIgnore
public SubmoduleWalk.IgnoreSubmoduleMode getModulesIgnore() throws IOException, ConfigInvalidExceptionGet the configured ignore field for the current entry. This will be the value from the .gitmodules file in the current repository's working tree.- Returns:
- ignore value
- Throws:
ConfigInvalidException
IOException
- Since:
- 3.6
-
getRepository
Get repository for current submodule entry- Returns:
- repository or null if non-existent
- Throws:
IOException
-
getHead
Get commit id that HEAD points to in the current submodule's repository- Returns:
- object id of HEAD reference
- Throws:
IOException
-
getHeadRef
Get ref that HEAD points to in the current submodule's repository- Returns:
- ref name, null on failures
- Throws:
IOException
-
getRemoteUrl
Get the resolved remote URL for the current submodule.This method resolves the value of
getModulesUrl()
to an absolute URL- Returns:
- resolved remote URL
- Throws:
IOException
ConfigInvalidException
-
close
public void close()Release any resources used by this walker's reader.
- Specified by:
close
in interfaceAutoCloseable
- Since:
- 4.0
-