[](https://github.com/gotec/git2net/actions/workflows/python-app.yml)
[](https://git2net.readthedocs.io/en/latest/?badge=latest)
# git2net
`git2net` is an Open Source Python package that facilitates the extraction of co-editing networks
from git repositories.
## Download and installation
`git2net` is pure `python` code. It has no platform-specific dependencies and thus works on all
platforms. The only requirement is a version of `git >= 2.0`. Assuming you are using `pip`, you can install latest version of `git2net` by running:
```
> pip install git2net
```
This also installs the necessary dependencies. `git2net` depends on the `python-Levenshtein` package to compute Levenshtein distances for edited lines of code. On sytems running Windows, automatically compiling this C based module might fail during installation. In this case, unofficial Windows binaries can be found [here](https://www.lfd.uci.edu/~gohlke/pythonlibs/#python-levenshtein), which might help you get started.
## How to use git2net
### Tutorials
After installation, we suggest to check out our [tutorials](https://github.com/gotec/git2net-tutorials), detailing how to get started using `git2net`.
We provide tutorials covering different aspects of analysing your repository with `git2net`.
You can directly interact with the notebooks in *Binder*, or view them in *NBViewer* via the badges below.
[](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD)
[](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/)
In addition, we provide links to the individual tutorial notebooks below:
| Tutorial | Binder | Google Colab | NBViewer |
| :--- | :---: | :---: | :---: |
| 1. Cloning a repository for analysis | [](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD?labpath=1_Cloning_Git_Repositories.ipynb) | [](https://colab.research.google.com/github/gotec/git2net-tutorials/blob/master/1_Cloning_Git_Repositories.ipynb) | [](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/1_Cloning_Git_Repositories.ipynb) |
| 2. Mining git repositories with [`git2net`](https://github.com/gotec/git2net) | [](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD?labpath=2_Mining_Git_Repositories.ipynb) | [](https://colab.research.google.com/github/gotec/git2net-tutorials/blob/master/2_Mining_Git_Repositories.ipynb) | [](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/2_Mining_Git_Repositories.ipynb) |
| 3. Author disambiguation with [`gambit`](https://github.com/gotec/gambit) | [](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD?labpath=3_Author_Disambiguation.ipynb) | [](https://colab.research.google.com/github/gotec/git2net-tutorials/blob/master/3_Author_Disambiguation.ipynb) | [](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/3_Author_Disambiguation.ipynb) |
| 4. Network analysis with [`pathpy`](https://www.pathpy.net/) | [](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD?labpath=4_Network_Analysis.ipynb) | [](https://colab.research.google.com/github/gotec/git2net-tutorials/blob/master/4_Network_Analysis.ipynb) | [](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/4_Network_Analysis.ipynb) |
| 5. Database-based analyses | [](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD?labpath=5_Database_Analysis.ipynb) | [](https://colab.research.google.com/github/gotec/git2net-tutorials/blob/master/5_Database_Analysis.ipynb) | [](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/5_Database_Analysis.ipynb) |
| 6. Computing file complexity [`git2net`](https://github.com/gotec/git2net) | [](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD?labpath=6_Computing_Complexities.ipynb) | [](https://colab.research.google.com/github/gotec/git2net-tutorials/blob/master/6_Computing_Complexities.ipynb) | [](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/6_Computing_Complexities.ipynb) |
### Documentation
`git2net`'s documentation is available at [git2net.readthedocs.io](https://git2net.readthedocs.io).
### Usage examples
We have published some motivating results as well as details on the mining algorithm in ["git2net - Mining Time-Stamped Co-Editing Networks from Large git Repositories"](https://dl.acm.org/doi/10.1109/MSR.2019.00070).
In ["Analysing Time-Stamped Co-Editing Networks in Software Development Teams using git2net"](https://link.springer.com/article/10.1007/s10664-020-09928-2), we use `git2net` to mine more than 1.2 million commits of over 25,000 developers. We use this data to test a hypothesis on the relation between developer productivity and co-editing patterns in software teams.
Finally, in ["Big Data = Big Insights? Operationalising Brooks' Law in a Massive GitHub Data Set"](https://arxiv.org/abs/2201.04588), we mine a corpus containing over 200 GitHub repositories using `git2net`. Based on the resulting data, we study the relationship between team size and productivity in OSS development teams. If you want to use this extensive data set for your own study, we made it publicly available on [zenodo.org](https://doi.org/10.5281/zenodo.5294965).
[](https://doi.org/10.5281/zenodo.5294965)
## How to cite git2net
```
@inproceedings{gote2019git2net,
title={git2net: {M}ining time-stamped co-editing networks from large git repositories},
author={Gote, Christoph and Scholtes, Ingo and Schweitzer, Frank},
booktitle={Proceedings of the 16th International Conference on Mining Software Repositories},
pages={433--444},
year={2019},
organization={IEEE Press}
}
@article{gote2021analysing,
title={Analysing time-stamped co-editing networks in software development teams using git2net},
author={Gote, Christoph and Scholtes, Ingo and Schweitzer, Frank},
journal={Empirical Software Engineering},
volume={26},
number={4},
pages={1--41},
year={2021},
publisher={Springer}
}
```
## License
This software is licensed under the GNU Affero General Public License v3 (AGPL-3.0).
Raw data
{
"_id": null,
"home_page": "https://github.com/franceme/git4net",
"name": "git4net",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8.0",
"maintainer_email": "",
"keywords": "co-editing,networks,repository,mining,network,analysis",
"author": "Miles Frantz",
"author_email": "frantzme@vt.edu",
"download_url": "https://files.pythonhosted.org/packages/2c/ef/119f628c172c5333b507237320770ecc0ec47c28dba6ec6fba19f4dd5b2b/git4net-0.0.2.tar.gz",
"platform": null,
"description": "[](https://github.com/gotec/git2net/actions/workflows/python-app.yml)\n[](https://git2net.readthedocs.io/en/latest/?badge=latest)\n\n\n# git2net\n\n`git2net` is an Open Source Python package that facilitates the extraction of co-editing networks\nfrom git repositories.\n\n\n## Download and installation\n\n`git2net` is pure `python` code. It has no platform-specific dependencies and thus works on all\nplatforms. The only requirement is a version of `git >= 2.0`. Assuming you are using `pip`, you can install latest version of `git2net` by running:\n\n```\n> pip install git2net\n```\n\nThis also installs the necessary dependencies. `git2net` depends on the `python-Levenshtein` package to compute Levenshtein distances for edited lines of code. On sytems running Windows, automatically compiling this C based module might fail during installation. In this case, unofficial Windows binaries can be found [here](https://www.lfd.uci.edu/~gohlke/pythonlibs/#python-levenshtein), which might help you get started.\n\n\n## How to use git2net\n\n### Tutorials\n\nAfter installation, we suggest to check out our [tutorials](https://github.com/gotec/git2net-tutorials), detailing how to get started using `git2net`.\nWe provide tutorials covering different aspects of analysing your repository with `git2net`.\nYou can directly interact with the notebooks in *Binder*, or view them in *NBViewer* via the badges below.\n\n[](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD)\n[](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/)\n\nIn addition, we provide links to the individual tutorial notebooks below:\n\n| Tutorial | Binder | Google Colab | NBViewer |\n| :--- | :---: | :---: | :---: |\n| 1. Cloning a repository for analysis | [](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD?labpath=1_Cloning_Git_Repositories.ipynb) | [](https://colab.research.google.com/github/gotec/git2net-tutorials/blob/master/1_Cloning_Git_Repositories.ipynb) | [](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/1_Cloning_Git_Repositories.ipynb) |\n| 2. Mining git repositories with [`git2net`](https://github.com/gotec/git2net) | [](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD?labpath=2_Mining_Git_Repositories.ipynb) | [](https://colab.research.google.com/github/gotec/git2net-tutorials/blob/master/2_Mining_Git_Repositories.ipynb) | [](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/2_Mining_Git_Repositories.ipynb) |\n| 3. Author disambiguation with [`gambit`](https://github.com/gotec/gambit) | [](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD?labpath=3_Author_Disambiguation.ipynb) | [](https://colab.research.google.com/github/gotec/git2net-tutorials/blob/master/3_Author_Disambiguation.ipynb) | [](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/3_Author_Disambiguation.ipynb) |\n| 4. Network analysis with [`pathpy`](https://www.pathpy.net/) | [](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD?labpath=4_Network_Analysis.ipynb) | [](https://colab.research.google.com/github/gotec/git2net-tutorials/blob/master/4_Network_Analysis.ipynb) | [](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/4_Network_Analysis.ipynb) |\n| 5. Database-based analyses | [](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD?labpath=5_Database_Analysis.ipynb) | [](https://colab.research.google.com/github/gotec/git2net-tutorials/blob/master/5_Database_Analysis.ipynb) | [](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/5_Database_Analysis.ipynb) |\n| 6. Computing file complexity [`git2net`](https://github.com/gotec/git2net) | [](https://mybinder.org/v2/gh/gotec/git2net-tutorials/HEAD?labpath=6_Computing_Complexities.ipynb) | [](https://colab.research.google.com/github/gotec/git2net-tutorials/blob/master/6_Computing_Complexities.ipynb) | [](https://nbviewer.org/github/gotec/git2net-tutorials/tree/main/6_Computing_Complexities.ipynb) |\n\n### Documentation\n\n`git2net`'s documentation is available at [git2net.readthedocs.io](https://git2net.readthedocs.io).\n\n### Usage examples\n\nWe have published some motivating results as well as details on the mining algorithm in [\"git2net - Mining Time-Stamped Co-Editing Networks from Large git Repositories\"](https://dl.acm.org/doi/10.1109/MSR.2019.00070).\n\nIn [\"Analysing Time-Stamped Co-Editing Networks in Software Development Teams using git2net\"](https://link.springer.com/article/10.1007/s10664-020-09928-2), we use `git2net` to mine more than 1.2 million commits of over 25,000 developers. We use this data to test a hypothesis on the relation between developer productivity and co-editing patterns in software teams.\n\nFinally, in [\"Big Data = Big Insights? Operationalising Brooks' Law in a Massive GitHub Data Set\"](https://arxiv.org/abs/2201.04588), we mine a corpus containing over 200 GitHub repositories using `git2net`. Based on the resulting data, we study the relationship between team size and productivity in OSS development teams. If you want to use this extensive data set for your own study, we made it publicly available on [zenodo.org](https://doi.org/10.5281/zenodo.5294965).\n\n[](https://doi.org/10.5281/zenodo.5294965)\n\n## How to cite git2net\n\n```\n@inproceedings{gote2019git2net,\n title={git2net: {M}ining time-stamped co-editing networks from large git repositories},\n author={Gote, Christoph and Scholtes, Ingo and Schweitzer, Frank},\n booktitle={Proceedings of the 16th International Conference on Mining Software Repositories},\n pages={433--444},\n year={2019},\n organization={IEEE Press}\n}\n\n@article{gote2021analysing,\n title={Analysing time-stamped co-editing networks in software development teams using git2net},\n author={Gote, Christoph and Scholtes, Ingo and Schweitzer, Frank},\n journal={Empirical Software Engineering},\n volume={26},\n number={4},\n pages={1--41},\n year={2021},\n publisher={Springer}\n}\n```\n\n\n## License\n\nThis software is licensed under the GNU Affero General Public License v3 (AGPL-3.0).\n",
"bugtrack_url": null,
"license": "AGPL-3.0+",
"summary": "My short description for my project.",
"version": "0.0.2",
"project_urls": {
"Homepage": "https://github.com/franceme/git4net"
},
"split_keywords": [
"co-editing",
"networks",
"repository",
"mining",
"network",
"analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "089ae508698da4361bc4bc6d3335b33bc516a2fe990230958e4cd73206d4434a",
"md5": "96a2f749be98d20e754876a4b4be5199",
"sha256": "0bc48abfd0d3216d65816b114a4aa27e75b26a6c461e8f166481a43b132b0313"
},
"downloads": -1,
"filename": "git4net-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "96a2f749be98d20e754876a4b4be5199",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.0",
"size": 45347,
"upload_time": "2023-07-28T22:49:36",
"upload_time_iso_8601": "2023-07-28T22:49:36.820377Z",
"url": "https://files.pythonhosted.org/packages/08/9a/e508698da4361bc4bc6d3335b33bc516a2fe990230958e4cd73206d4434a/git4net-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2cef119f628c172c5333b507237320770ecc0ec47c28dba6ec6fba19f4dd5b2b",
"md5": "59348147ab76d8a85210a32ecd5d571c",
"sha256": "233912edaf727b2bba7561389a2c505c463156132a72fc93c6913ac4187af327"
},
"downloads": -1,
"filename": "git4net-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "59348147ab76d8a85210a32ecd5d571c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.0",
"size": 51842,
"upload_time": "2023-07-28T22:49:39",
"upload_time_iso_8601": "2023-07-28T22:49:39.429090Z",
"url": "https://files.pythonhosted.org/packages/2c/ef/119f628c172c5333b507237320770ecc0ec47c28dba6ec6fba19f4dd5b2b/git4net-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-28 22:49:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "franceme",
"github_project": "git4net",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "git4net"
}
JSON
