.. role:: bash(code)
:language: bash
.. role:: json(code)
:language: json
.. role:: python(code)
:language: python
=====
ingit
=====
Tool for managing a large collection of repositories in git.
.. image:: https://img.shields.io/pypi/v/ingit.svg
:target: https://pypi.org/project/ingit
:alt: package version from PyPI
.. image:: https://github.com/mbdevpl/ingit/actions/workflows/python.yml/badge.svg?branch=main
:target: https://github.com/mbdevpl/ingit/actions
:alt: build status from GitHub
.. image:: https://codecov.io/gh/mbdevpl/ingit/branch/main/graph/badge.svg
:target: https://codecov.io/gh/mbdevpl/ingit
:alt: test coverage from Codecov
.. image:: https://api.codacy.com/project/badge/Grade/477a1bc423f9465bb1ba8caeb895385b
:target: https://app.codacy.com/gh/mbdevpl/ingit
:alt: grade from Codacy
.. image:: https://img.shields.io/github/license/mbdevpl/ingit.svg
:target: https://github.com/mbdevpl/ingit/blob/v0.4.15/NOTICE
:alt: license
If you have 100 git-versioned projects, keeping tabs on everything can be quite troublesome.
That's where *ingit* comes in. It mimics selected git commands, however you can perform the same
action on a group of repositories instead of just one.
Additionally, it has an interactive mode in which you can go over your repositories and quickly
perform typical suggested actions in each individual repository based on its current status.
.. contents::
:backlinks: none
Overview
========
Basic usage
-----------
For general help, see:
.. code:: bash
ingit -h
For command-specific help, see:
.. code:: bash
ingit command -h
Commands are of two kinds in general:
* git-like commands, which work similar to their git versions;
* ingit-only commands, which you won't find in git.
Currently available ingit-only commands are:
* ``ingit summary`` will show summary of repositories registered in ingit;
* ``ingit register`` will add an existing git repository to ingit configuration;
* ``ingit foreach`` will execute a custom command for each repository.
Currently available git-like commands are:
* ``ingit clone`` will mass-clone registered repositories;
* ``ingit init`` will mass-init registered repositories;
* ``ingit fetch`` will mass-fetch existing registered repositories;
* ``ingit checkout`` will interactively checkout branches;
* ``ingit merge`` will interactively merge branches;
* ``ingit push`` will mass-push existing registered repositories;
* ``ingit gc`` will do mass garbage collection of existing registered repositories;
* ``ingit status`` will give comprehensive status report for every existing registered repository.
Filtering the repositories
--------------------------
Git-like commands of ingit
(namely: ``ingit clone``, ``ingit init``, ``ingit fetch``, ``ingit checkout``,
``ingit merge``, ``ingit push``, ``ingit gc`` and ``ingit status``),
as well as ``ingit summary`` and ``ingit foreach``,
by default operate on all registered repositories.
However, they all can take the options ``--regex``/``-r`` and ``--predicate``/``-p``
that filter out the repositories using repository metadata (i.e. name, tags, path and remotes)
which is stored in the repositories configuration.
If both ``--regex``/``-r`` and ``--predicate``/``-p`` are provided,
predicate is applied first.
Filtering repositories by regular expression
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The ``--regex``/``-r`` option accepts any regular expression (also a simple string)
and filters the repos by trying to simply find a match in any of the metadata.
Specifically, ingit will forward your input regular expression into this function:
.. code:: python
def regex_predicate(regex, name, tags, path, remotes):
return (
re.search(regex, name) is not None
or any(re.search(regex, tag) is not None for tag in tags)
or re.search(regex, str(path)) is not None
or any(re.search(regex, name) for name, url in remotes.items()))
The actual implementation is here: `ingit/runtime.py#L24 <https://github.com/mbdevpl/ingit/blob/v0.4.15/ingit/runtime.py#L24>`_
Filtering repositories by predicate
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The ``--predicate``/``-p`` option accepts a python boolean expression which will be inserted
into a predicate function template, as below:
.. code:: python
lambda name, tags, path, remotes: (predicate)
The actual implementation is here: `ingit/main.py#L266 <https://github.com/mbdevpl/ingit/blob/v0.4.15/ingit/main.py#L266>`_
Therefore, executing ``ingit --predicate "'python' in tags" fetch`` results
in the following predicate being applied:
.. code:: python
lambda name, tags, path, remotes: ('python' in tags)
And thus only repositories that have ``'python'`` in their tags are fetched.
Configuration
-------------
Ingit works based on configuration in 2 JSON files:
* runtime configuration
* repositories configuration
If either of the files doesn't exist, defaults will be generated.
The default paths to the files can be overridden via ``--config`` and ``--repos``
command-line options.
Runtime configuration
~~~~~~~~~~~~~~~~~~~~~
Most importantly, stores repositories root directory -- it's a directory which ingit assumes
to contain git-versioned projects.
Example:
.. code:: json
{
"description": "ingit runtime configuration file",
"ingit-version": "0.4.0",
"machines": [
{
"name": "desktop",
"repos_path": "~/Projects"
},
{
"interactive": false,
"names": ["server", "server.domain.com"],
"repos_path": "$HOME/Projects"
}
]
}
Repositories configuration
~~~~~~~~~~~~~~~~~~~~~~~~~~
It's a file that lists all registered projects and keeps their metadata.
It is automatically updated when ``ingit register`` is used.
Example:
.. code:: json
{
"description": "ingit repositories configuration file",
"ingit-version": "0.4.0",
"repos": [
{
"name": "ingit",
"remotes": {
"github": "git@github.com:mbdevpl/ingit.git"
},
"tags": [
"active",
"git",
"github",
"my",
"python"
]
},
{
"name": "pylint",
"remotes": {
"github": "git@github.com:mbdevpl/pylint.git",
"source": "https://github.com/PyCQA/pylint"
},
"tags": [
"external",
"github",
"python"
]
}
]
}
Entry of each repository is a JSON object that can have the following fields:
.. code:: json
{
"name": "name of the project",
"path": "path doesn't have to be specified, by default it will be 'repos_path/name'",
"paths": {
"machine name 1": "path used only on machine 1",
"machine name 2": "path used only on machine 2",
"": "if no machine name is given, the path is used in all other cases"
},
"remotes": {
"remote name 1": "url 1",
"remote name 2": "url 2"
},
"tags": [
"tags are completely optional",
"but repositories are much easier to manage if they are consistently tagged"
]
}
The ``repos_path`` mentioned above is taken from the runtime configuration of ingit.
At most one of ``path`` or ``paths`` is allowed for each repo.
The two path specifications below are equivalent:
.. code:: json
{
"name": "name of the project",
"path": "some path"
}
.. code:: json
{
"name": "name of the project",
"paths": {
"": "some path"
}
}
Command details
===============
Below, details of each command are described.
``ingit summary``
-----------------
Show summary of registered repositories and status of configured repository root.
First of all, print a list of registered repositories. By default, all
registered repositories are listed, but, as in case of most commands, the
results can be filtered via a predicate or regex.
Independently, print a list of all unregistered repositories and all not
versioned paths present in the configured repositories root.
``ingit register``
------------------
Start tracking a repository in ingit.
.. code:: bash
ingit register [PATH] [--tags TAG ...]
The initial configuration is set according to basic repository information:
its root directory name becomes "name" and its currently configured remotes
become "remotes". You can edit the configuration manually afterwards.
The final "path" to the repository stored in the configuration depends on the
``repos_path`` in runtime configuration. The configured "path" will be:
* resolved absolute path if there is no ``repos_path`` configured or
repository path is outside of the ``repos_path``;
* resolved relative path to the ``repos_path``, if the repository path is
within it;
* nothing (i.e. not stored) if the if the repository is stored directly in
``repos_path`` (i.e. there are no intermediate directories).
Behaviour of storing relative/no paths in some cases is implemented to make
configuration file much less verbose in typical usage scenarios. To prevent
this behaviour, and force all repository paths to be absolute, simply set the
``repos_path`` in your runtime configuration to JSON ``null``.
Use ``PATH`` to provide the path to root directory of repository.
If not provided, current working directory is used.
Use ``--tags`` to provide tags for this repository, they will be added to the
initial configuration. Tags have no other effect than making repository
filtering easier.
``ingit foreach``
------------------
The given command is executed in a shell in working directory of each
project.
Use ``--timeout`` to set timeout of the command (in seconds).
``ingit clone``
---------------
Execute ``git clone <remote-url> --recursive --origin <remote-name> <path>``,
where values of ``<path>`` and ``<remote-...>`` are taken from default remote
configuration of the repository.
After cloning, add all remaining configured remotes to the repository and
fetch them.
For example, if repository configuration is as follows:
.. code:: json
{
"name": "Spack",
"path": "~/Software/Spack",
"remotes": {
"source": "https://github.com/spack/spack.git",
"github": "git@github.com:mbdevpl/spack.git"
},
"tags": []
}
The clone command will be:
``git clone https://github.com/spack/spack.git --recursive --origin source ~/Software/Spack``
because ``source`` is the first configured remote.
The subsequent commands will be ``git remote add github git@github.com:mbdevpl/spack.git``
and ``git fetch github``.
``ingit init``
--------------
Execute ``git init`` followed by ``git remote add`` for each configured
remote.
``ingit fetch``
---------------
Execute ``git fetch <remote-name>``, where the remote name is the remote of
the current tracking branch, or all remotes of the repository if there's no
tracking branch, or repository is in detached head state.
Use ``--all`` to fetch all remotes in all cases.
``ingit checkout``
------------------
Interactively select revision to checkout from list of local branches, remote
non-tracking branches and local tags.
The list of branches to select from is composed by combining:
* local branches
* non-tracking branches on all remotes
* local tags
Checking out a remote branch will create a local branch with the same unless
it already exists. If it already exists, repository will end up in detached
head state.
Also, checking out any tag will put repository in a detached head state.
``ingit merge``
---------------
**Not yet implemented!** The following functionality is intended.
Interactively merge all branches to their tracking branches. For each not
merged ``<branch>``-``<tracking-branch>`` pair, execute
``git checkout <branch>`` and then if the merge is fast-forward,
automatically execute ``git merge <tracking-branch> --ff-only``. If not, then
show more information about the situation of the repository, and propose:
* ``git merge --log <tracking-branch>``,
* ``git rebase -i <tracking-branch>`` and
* ``git reset --hard <tracking-branch>``.
If repository is dirty when this command is executed, do nothing. After work
is done, return to the originally checked-out branch.
``ingit push``
--------------
Execute ``git push <remote-name> <branch>:<tracking-branch-name>`` for the
active branch.
The above functionality works, but the following functionality is **not yet implemented**.
Use ``--all`` to execute the push for every branch that has a remote tracking
branch.
``ingit gc``
------------
Execute ``git gc --aggressive --prune``.
``ingit status``
----------------
Perform git status, as well as other diagnostic git commands.
Execute:
* ``git status --short --branch`` to inform about any uncommitted changes,
* ``git log tracking_branch..branch`` to inform about commits that are not
yet pushed to the remote,
* ``git log branch..tracking_branch`` to inform about commits that are not
yet merged from the remote.
Additionally, compare registered remotes with actual remotes to make sure
that ingit configuration is in sync with the repository metadata.
Use ``--ignored`` to include ignored files in the status report, just as with
``git status``.
Requirements
============
Python version 3.8 or later.
Python libraries as specified in `requirements.txt <https://github.com/mbdevpl/ingit/blob/v0.4.15/requirements.txt>`_.
Building and running tests additionally requires packages listed in `requirements_test.txt <https://github.com/mbdevpl/ingit/blob/v0.4.15/requirements_test.txt>`_.
Tested on Linux, macOS and Windows.
Raw data
{
"_id": null,
"home_page": "https://github.com/mbdevpl/ingit",
"name": "ingit",
"maintainer": "Mateusz Bysiek",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "mateusz.bysiek@gmail.com",
"keywords": "tools,vcs,repository management,git,submodules",
"author": "Mateusz Bysiek",
"author_email": "mateusz.bysiek@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/bc/e1/f2b24543af96c6a9250ac81485bdbb061ea06a629edb566bc040a1bcce7e/ingit-0.4.15.tar.gz",
"platform": null,
"description": ".. role:: bash(code)\n :language: bash\n\n.. role:: json(code)\n :language: json\n\n.. role:: python(code)\n :language: python\n\n\n=====\ningit\n=====\n\nTool for managing a large collection of repositories in git.\n\n.. image:: https://img.shields.io/pypi/v/ingit.svg\n :target: https://pypi.org/project/ingit\n :alt: package version from PyPI\n\n.. image:: https://github.com/mbdevpl/ingit/actions/workflows/python.yml/badge.svg?branch=main\n :target: https://github.com/mbdevpl/ingit/actions\n :alt: build status from GitHub\n\n.. image:: https://codecov.io/gh/mbdevpl/ingit/branch/main/graph/badge.svg\n :target: https://codecov.io/gh/mbdevpl/ingit\n :alt: test coverage from Codecov\n\n.. image:: https://api.codacy.com/project/badge/Grade/477a1bc423f9465bb1ba8caeb895385b\n :target: https://app.codacy.com/gh/mbdevpl/ingit\n :alt: grade from Codacy\n\n.. image:: https://img.shields.io/github/license/mbdevpl/ingit.svg\n :target: https://github.com/mbdevpl/ingit/blob/v0.4.15/NOTICE\n :alt: license\n\nIf you have 100 git-versioned projects, keeping tabs on everything can be quite troublesome.\n\nThat's where *ingit* comes in. It mimics selected git commands, however you can perform the same\naction on a group of repositories instead of just one.\n\nAdditionally, it has an interactive mode in which you can go over your repositories and quickly\nperform typical suggested actions in each individual repository based on its current status.\n\n.. contents::\n :backlinks: none\n\n\nOverview\n========\n\n\nBasic usage\n-----------\n\nFor general help, see:\n\n.. code:: bash\n\n ingit -h\n\n\nFor command-specific help, see:\n\n.. code:: bash\n\n ingit command -h\n\n\nCommands are of two kinds in general:\n\n* git-like commands, which work similar to their git versions;\n* ingit-only commands, which you won't find in git.\n\n\nCurrently available ingit-only commands are:\n\n* ``ingit summary`` will show summary of repositories registered in ingit;\n* ``ingit register`` will add an existing git repository to ingit configuration;\n* ``ingit foreach`` will execute a custom command for each repository.\n\n\nCurrently available git-like commands are:\n\n* ``ingit clone`` will mass-clone registered repositories;\n* ``ingit init`` will mass-init registered repositories;\n* ``ingit fetch`` will mass-fetch existing registered repositories;\n* ``ingit checkout`` will interactively checkout branches;\n* ``ingit merge`` will interactively merge branches;\n* ``ingit push`` will mass-push existing registered repositories;\n* ``ingit gc`` will do mass garbage collection of existing registered repositories;\n* ``ingit status`` will give comprehensive status report for every existing registered repository.\n\n\nFiltering the repositories\n--------------------------\n\nGit-like commands of ingit\n(namely: ``ingit clone``, ``ingit init``, ``ingit fetch``, ``ingit checkout``,\n``ingit merge``, ``ingit push``, ``ingit gc`` and ``ingit status``),\nas well as ``ingit summary`` and ``ingit foreach``,\nby default operate on all registered repositories.\n\nHowever, they all can take the options ``--regex``/``-r`` and ``--predicate``/``-p``\nthat filter out the repositories using repository metadata (i.e. name, tags, path and remotes)\nwhich is stored in the repositories configuration.\n\nIf both ``--regex``/``-r`` and ``--predicate``/``-p`` are provided,\npredicate is applied first.\n\n\nFiltering repositories by regular expression\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nThe ``--regex``/``-r`` option accepts any regular expression (also a simple string)\nand filters the repos by trying to simply find a match in any of the metadata.\n\nSpecifically, ingit will forward your input regular expression into this function:\n\n.. code:: python\n\n def regex_predicate(regex, name, tags, path, remotes):\n return (\n re.search(regex, name) is not None\n or any(re.search(regex, tag) is not None for tag in tags)\n or re.search(regex, str(path)) is not None\n or any(re.search(regex, name) for name, url in remotes.items()))\n\nThe actual implementation is here: `ingit/runtime.py#L24 <https://github.com/mbdevpl/ingit/blob/v0.4.15/ingit/runtime.py#L24>`_\n\n\nFiltering repositories by predicate\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nThe ``--predicate``/``-p`` option accepts a python boolean expression which will be inserted\ninto a predicate function template, as below:\n\n.. code:: python\n\n lambda name, tags, path, remotes: (predicate)\n\nThe actual implementation is here: `ingit/main.py#L266 <https://github.com/mbdevpl/ingit/blob/v0.4.15/ingit/main.py#L266>`_\n\nTherefore, executing ``ingit --predicate \"'python' in tags\" fetch`` results\nin the following predicate being applied:\n\n.. code:: python\n\n lambda name, tags, path, remotes: ('python' in tags)\n\nAnd thus only repositories that have ``'python'`` in their tags are fetched.\n\n\nConfiguration\n-------------\n\nIngit works based on configuration in 2 JSON files:\n\n* runtime configuration\n* repositories configuration\n\nIf either of the files doesn't exist, defaults will be generated.\n\nThe default paths to the files can be overridden via ``--config`` and ``--repos``\ncommand-line options.\n\n\nRuntime configuration\n~~~~~~~~~~~~~~~~~~~~~\n\nMost importantly, stores repositories root directory -- it's a directory which ingit assumes\nto contain git-versioned projects.\n\nExample:\n\n.. code:: json\n\n {\n \"description\": \"ingit runtime configuration file\",\n \"ingit-version\": \"0.4.0\",\n \"machines\": [\n {\n \"name\": \"desktop\",\n \"repos_path\": \"~/Projects\"\n },\n {\n \"interactive\": false,\n \"names\": [\"server\", \"server.domain.com\"],\n \"repos_path\": \"$HOME/Projects\"\n }\n ]\n }\n\n\nRepositories configuration\n~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nIt's a file that lists all registered projects and keeps their metadata.\n\nIt is automatically updated when ``ingit register`` is used.\n\nExample:\n\n.. code:: json\n\n {\n \"description\": \"ingit repositories configuration file\",\n \"ingit-version\": \"0.4.0\",\n \"repos\": [\n {\n \"name\": \"ingit\",\n \"remotes\": {\n \"github\": \"git@github.com:mbdevpl/ingit.git\"\n },\n \"tags\": [\n \"active\",\n \"git\",\n \"github\",\n \"my\",\n \"python\"\n ]\n },\n {\n \"name\": \"pylint\",\n \"remotes\": {\n \"github\": \"git@github.com:mbdevpl/pylint.git\",\n \"source\": \"https://github.com/PyCQA/pylint\"\n },\n \"tags\": [\n \"external\",\n \"github\",\n \"python\"\n ]\n }\n ]\n }\n\nEntry of each repository is a JSON object that can have the following fields:\n\n.. code:: json\n\n {\n \"name\": \"name of the project\",\n \"path\": \"path doesn't have to be specified, by default it will be 'repos_path/name'\",\n \"paths\": {\n \"machine name 1\": \"path used only on machine 1\",\n \"machine name 2\": \"path used only on machine 2\",\n \"\": \"if no machine name is given, the path is used in all other cases\"\n },\n \"remotes\": {\n \"remote name 1\": \"url 1\",\n \"remote name 2\": \"url 2\"\n },\n \"tags\": [\n \"tags are completely optional\",\n \"but repositories are much easier to manage if they are consistently tagged\"\n ]\n }\n\n\nThe ``repos_path`` mentioned above is taken from the runtime configuration of ingit.\n\nAt most one of ``path`` or ``paths`` is allowed for each repo.\n\nThe two path specifications below are equivalent:\n\n.. code:: json\n\n {\n \"name\": \"name of the project\",\n \"path\": \"some path\"\n }\n\n.. code:: json\n\n {\n \"name\": \"name of the project\",\n \"paths\": {\n \"\": \"some path\"\n }\n }\n\n\n\nCommand details\n===============\n\nBelow, details of each command are described.\n\n\n``ingit summary``\n-----------------\n\nShow summary of registered repositories and status of configured repository root.\n\nFirst of all, print a list of registered repositories. By default, all\nregistered repositories are listed, but, as in case of most commands, the\nresults can be filtered via a predicate or regex.\n\nIndependently, print a list of all unregistered repositories and all not\nversioned paths present in the configured repositories root.\n\n\n``ingit register``\n------------------\n\nStart tracking a repository in ingit.\n\n.. code:: bash\n\n ingit register [PATH] [--tags TAG ...]\n\nThe initial configuration is set according to basic repository information:\nits root directory name becomes \"name\" and its currently configured remotes\nbecome \"remotes\". You can edit the configuration manually afterwards.\n\nThe final \"path\" to the repository stored in the configuration depends on the\n``repos_path`` in runtime configuration. The configured \"path\" will be:\n\n* resolved absolute path if there is no ``repos_path`` configured or\n repository path is outside of the ``repos_path``;\n* resolved relative path to the ``repos_path``, if the repository path is\n within it;\n* nothing (i.e. not stored) if the if the repository is stored directly in\n ``repos_path`` (i.e. there are no intermediate directories).\n\nBehaviour of storing relative/no paths in some cases is implemented to make\nconfiguration file much less verbose in typical usage scenarios. To prevent\nthis behaviour, and force all repository paths to be absolute, simply set the\n``repos_path`` in your runtime configuration to JSON ``null``.\n\nUse ``PATH`` to provide the path to root directory of repository.\nIf not provided, current working directory is used.\n\nUse ``--tags`` to provide tags for this repository, they will be added to the\ninitial configuration. Tags have no other effect than making repository\nfiltering easier.\n\n\n``ingit foreach``\n------------------\n\nThe given command is executed in a shell in working directory of each\nproject.\n\nUse ``--timeout`` to set timeout of the command (in seconds).\n\n\n``ingit clone``\n---------------\n\nExecute ``git clone <remote-url> --recursive --origin <remote-name> <path>``,\nwhere values of ``<path>`` and ``<remote-...>`` are taken from default remote\nconfiguration of the repository.\n\nAfter cloning, add all remaining configured remotes to the repository and\nfetch them.\n\nFor example, if repository configuration is as follows:\n\n.. code:: json\n\n {\n \"name\": \"Spack\",\n \"path\": \"~/Software/Spack\",\n \"remotes\": {\n \"source\": \"https://github.com/spack/spack.git\",\n \"github\": \"git@github.com:mbdevpl/spack.git\"\n },\n \"tags\": []\n }\n\nThe clone command will be:\n``git clone https://github.com/spack/spack.git --recursive --origin source ~/Software/Spack``\nbecause ``source`` is the first configured remote.\nThe subsequent commands will be ``git remote add github git@github.com:mbdevpl/spack.git``\nand ``git fetch github``.\n\n\n``ingit init``\n--------------\n\nExecute ``git init`` followed by ``git remote add`` for each configured\nremote.\n\n\n``ingit fetch``\n---------------\n\nExecute ``git fetch <remote-name>``, where the remote name is the remote of\nthe current tracking branch, or all remotes of the repository if there's no\ntracking branch, or repository is in detached head state.\n\nUse ``--all`` to fetch all remotes in all cases.\n\n\n``ingit checkout``\n------------------\n\nInteractively select revision to checkout from list of local branches, remote\nnon-tracking branches and local tags.\n\nThe list of branches to select from is composed by combining:\n\n* local branches\n* non-tracking branches on all remotes\n* local tags\n\nChecking out a remote branch will create a local branch with the same unless\nit already exists. If it already exists, repository will end up in detached\nhead state.\n\nAlso, checking out any tag will put repository in a detached head state.\n\n\n``ingit merge``\n---------------\n\n**Not yet implemented!** The following functionality is intended.\n\nInteractively merge all branches to their tracking branches. For each not\nmerged ``<branch>``-``<tracking-branch>`` pair, execute\n``git checkout <branch>`` and then if the merge is fast-forward,\nautomatically execute ``git merge <tracking-branch> --ff-only``. If not, then\nshow more information about the situation of the repository, and propose:\n\n* ``git merge --log <tracking-branch>``,\n* ``git rebase -i <tracking-branch>`` and\n* ``git reset --hard <tracking-branch>``.\n\nIf repository is dirty when this command is executed, do nothing. After work\nis done, return to the originally checked-out branch.\n\n\n``ingit push``\n--------------\n\nExecute ``git push <remote-name> <branch>:<tracking-branch-name>`` for the\nactive branch.\n\nThe above functionality works, but the following functionality is **not yet implemented**.\n\nUse ``--all`` to execute the push for every branch that has a remote tracking\nbranch.\n\n\n``ingit gc``\n------------\n\nExecute ``git gc --aggressive --prune``.\n\n\n``ingit status``\n----------------\n\nPerform git status, as well as other diagnostic git commands.\n\nExecute:\n\n* ``git status --short --branch`` to inform about any uncommitted changes,\n* ``git log tracking_branch..branch`` to inform about commits that are not\n yet pushed to the remote,\n* ``git log branch..tracking_branch`` to inform about commits that are not\n yet merged from the remote.\n\nAdditionally, compare registered remotes with actual remotes to make sure\nthat ingit configuration is in sync with the repository metadata.\n\nUse ``--ignored`` to include ignored files in the status report, just as with\n``git status``.\n\n\nRequirements\n============\n\nPython version 3.8 or later.\n\nPython libraries as specified in `requirements.txt <https://github.com/mbdevpl/ingit/blob/v0.4.15/requirements.txt>`_.\n\nBuilding and running tests additionally requires packages listed in `requirements_test.txt <https://github.com/mbdevpl/ingit/blob/v0.4.15/requirements_test.txt>`_.\n\nTested on Linux, macOS and Windows.\n",
"bugtrack_url": null,
"license": "GNU General Public License v3 or later (GPLv3+)",
"summary": "Tool for managing a large collection of repositories in git.",
"version": "0.4.15",
"project_urls": {
"Homepage": "https://github.com/mbdevpl/ingit"
},
"split_keywords": [
"tools",
"vcs",
"repository management",
"git",
"submodules"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "071f03b4be4f3bb52faebb40bd04978a8ac8f20e51538ccc7a3a213cdd1ba62b",
"md5": "2b3a3fb885823a2c55738e28db209b63",
"sha256": "da8aa5bde87aa89facc1a4c27e9b04da65f11d7f2233a6d6a918887a2216580f"
},
"downloads": -1,
"filename": "ingit-0.4.15-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2b3a3fb885823a2c55738e28db209b63",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 40333,
"upload_time": "2023-09-02T16:47:54",
"upload_time_iso_8601": "2023-09-02T16:47:54.241281Z",
"url": "https://files.pythonhosted.org/packages/07/1f/03b4be4f3bb52faebb40bd04978a8ac8f20e51538ccc7a3a213cdd1ba62b/ingit-0.4.15-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bce1f2b24543af96c6a9250ac81485bdbb061ea06a629edb566bc040a1bcce7e",
"md5": "efbeba6573f9ef4ad2d6ba172c98062c",
"sha256": "0c3466c6bef0816485426211ff6f8f122f282a6442010302744cb836421b531c"
},
"downloads": -1,
"filename": "ingit-0.4.15.tar.gz",
"has_sig": false,
"md5_digest": "efbeba6573f9ef4ad2d6ba172c98062c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 48210,
"upload_time": "2023-09-02T16:47:56",
"upload_time_iso_8601": "2023-09-02T16:47:56.067234Z",
"url": "https://files.pythonhosted.org/packages/bc/e1/f2b24543af96c6a9250ac81485bdbb061ea06a629edb566bc040a1bcce7e/ingit-0.4.15.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-02 16:47:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mbdevpl",
"github_project": "ingit",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "ingit"
}
JSON
