Metadata-Version: 2.1
Name: gambit-disambig
Version: 1.0.3
Summary: An Open Source name disambiguation tool for version control systems
Home-page: https://github.com/gotec/gambit
Author: Christoph Gote
Author-email: cgote@ethz.ch
License: AGPL-3.0+
Keywords: alias disambiguation repository mining version control system
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: pandas
Requires-Dist: unidecode
Requires-Dist: python-levenshtein
Requires-Dist: pyjarowinkler
Requires-Dist: tqdm (>=4.27.0)
Requires-Dist: numpy

# gambit

`gambit` is an Open Source name disambiguation tool for version control systems.

## Download and installation

`gambit` is pure `python` code. It has no platform-specific dependencies and thus works on all
platforms. Assuming you are using `pip`, you can install latest version of `gambit` by running:

```
> pip install gambit-disambig
```

This also installs the necessary dependencies. `gambit` 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 gambit
After installation, we suggest to check out our [tutorial](https://github.com/gotec/gambit/blob/master/TUTORIAL.ipynb), detailing how to get started using `gambit`. We also provide detailed inline documentation serving as reference.

We have published some motivating results as well as details on the disambiguation algorithm and its hyperparameters in ["gambit – An Open Source Name Disambiguation Tool for Version Control Systems"](https://arxiv.org/abs/2103.05666). An earlier version of gambit used to obtain the results shown in our paper is archived on [zenodo.org](http://doi.org/10.5281/zenodo.4384646).
Due to GDPR, we cannot publish the manually disambiguated ground-truth data on zenodo. However, if you require this data for research purposes or replication of our results please feel free to contact us directly.

All functions of `gambit` have been tested on Ubuntu, Mac OS, and Windows.

## How to cite gambit

```
@misc{gote2021gambit,
      title={gambit -- An Open Source Name Disambiguation Tool for Version Control Systems}, 
      author={Christoph Gote and Christian Zingg},
      year={2021},
      eprint={2103.05666},
      archivePrefix={arXiv},
      primaryClass={cs.SE}
}
```

## License

This software is licensed under the GNU Affero General Public License v3 (AGPL-3.0).


