A tool to manage identities
Project description
A tool to manage identities.
Usage
usage: sortinghat [--help] [-c <file>] [-u <user>] [-p <password>] [--host <host>] [--port <port>] [-d <name>] command [<cmd_args>] The most commonly used sortinghat commands are: add Add identities affiliate Affiliate identities autoprofile Auto complete profiles blacklist List, add or delete entries from the blacklist config Get and set configuration parameters countries List information about countries enroll Enroll identities into organizations export Export data (i.e identities) from the registry init Create an empty registry load Import data (i.e identities, organizations) on the registry merge Merge unique identities mv Move an identity into a unique identity log List enrollment information available in the registry orgs List, add or delete organizations and domains profile Edit profile rm Remove identities from the registry show Show information about a unique identity unify Merge identities using a matching algorithm withdraw Remove identities from organizations General options: -h, --help show this help message and exit -c FILE, --config FILE set configuration file -u USER, --user USER database user name -p PASSWORD, --password PASSWORD database user password -d DATABASE, --database DATABASE name of the database where the registry will be stored --host HOST name of the host where the database server is running --port PORT port of the host where the database server is running Run 'sortinghat <command> --help' to get information about a specific command.
Installation
Native
You can install sortinghat just by running setup.py script:
$ python setup.py install
This will install it in the python default directories in your system.
If you don’t install sortinghat with root privileges, or don’t want to install it in the default directories, you can also use the source code directory, as cloned from the main git repo. It is enough to configure your $PATH and $PYTHONPATH so that sortinghat, and the Python modules it needs, are found.
Add to your $PATH the directory which contains the sortinghat executables:
$ export PATH=$PATH:sortinghatdir/bin
In $PYHTONPATH, you need to include sortinghat as well. If sortinghatdir is the path where sortinghat is installed:
$ export PYTHONPATH=$PYTHONPATH:sortinghatdir
You are ready to use sortinghat!
Docker
You can use our image from DockerHub (metricsgrimoire/sortinghat) and skip the docker build step. If you prefer to build the image yourself execute:
$ docker build -t metricsgrimoire/sortinghat .
Next step would be to start a MySQL docker container for data storage:
$ docker run --name mysql \
-e MYSQL_ROOT_PASSWORD=sortinghat \
-d mysql
Run the sortinghat docker container in interactive mode:
$ docker run -i -t --rm \
--link mysql:mysql \
-e SORTINGHAT_DB_HOST=mysql \
-e SORTINGHAT_DB_PASSWORD=sortinghat \
-e SORTINGHAT_DB_DATABASE=sortinghat \
metricsgrimoire/sortinghat \
/bin/bash
Now you can initialize sortinghat with the database name sortinghat:
$ sortinghat init sortinghat
You are ready to use sortinghat and explore the commands documented below. Have fun!
Configuration
Set the database parameters via the config command:
$ sortinghat config set db.host <mysql-host> $ sortinghat config set db.user <user> $ sortinghat config set db.password <password> $ sortinghat config set db.database <name> $ sortinghat config set db.port <port>
Alternatively you can set environment variables:
$ export SORTINGHAT_DB_HOST=<mysql-host> $ export SORTINGHAT_DB_USER=<user> $ export SORTINGHAT_DB_PASSWORD=<password> $ export SORTINGHAT_DB_DATABASE=<name> $ export SORTINGHAT_DB_PORT=<port>
After this initialize a new database:
$ sortinghat init <name>
Basic commands
Add some unique identities ``` $ sortinghat add –name “John Smith” –email “jsmith@example.com” –username “jsmith” –source scm New identity 03e12d00e37fd45593c49a5a5a1652deca4cf302 added to 03e12d00e37fd45593c49a5a5a1652deca4cf302
$ sortinghat add –name “John Doe” –email “jdoe@example.com” –source scm New identity a7637bb1737bc2a83f3a3e25b9b441cba62d97c2 added to a7637bb1737bc2a83f3a3e25b9b441cba62d97c2
* Set a profile
$ sortinghat profile –name “John Smith” –email “jsmith@example.com” –country US 03e12d00e37fd45593c49a5a5a1652deca4cf302 unique identity 03e12d00e37fd45593c49a5a5a1652deca4cf302
Profile: * Name: John Smith * E-Mail: jsmith@example.com * Bot: No * Country: US - United States of America
* Add an identity to an existing unique identity
$ sortinghat add –username “jsmith” –source mls –uuid 03e12d00e37fd45593c49a5a5a1652deca4cf302 New identity 0dbc8c481b56df6da15398c83dde2f844030e978 added to 03e12d00e37fd45593c49a5a5a1652deca4cf302
* Merge two identities
$ sortinghat merge a7637bb1737bc2a83f3a3e25b9b441cba62d97c2 03e12d00e37fd45593c49a5a5a1652deca4cf302 Unique identity a7637bb1737bc2a83f3a3e25b9b441cba62d97c2 merged on 03e12d00e37fd45593c49a5a5a1652deca4cf302
* Move an identity into a unique identity
$ sortinghat mv a7637bb1737bc2a83f3a3e25b9b441cba62d97c2 a7637bb1737bc2a83f3a3e25b9b441cba62d97c2 New unique identity a7637bb1737bc2a83f3a3e25b9b441cba62d97c2 created. Identity moved
* Remove a unique identity
$ sortinghat rm a7637bb1737bc2a83f3a3e25b9b441cba62d97c2 Unique identity a7637bb1737bc2a83f3a3e25b9b441cba62d97c2 removed
* Show identities information
$ sortinghat show unique identity 03e12d00e37fd45593c49a5a5a1652deca4cf302
Profile: * Name: John Smith * E-Mail: jsmith@example.com * Bot: No * Country: US - United States of America
Identities: 03e12d00e37fd45593c49a5a5a1652deca4cf302 John Smith jsmith@example.com jsmith scm 0dbc8c481b56df6da15398c83dde2f844030e978 - - jsmith mls
No enrollments
* Add some organizations
$ sortinghat orgs -a Example $ sortinghat orgs -a Bitergia $ sortinghat orgs -a Individual
* Add some domains to the organizations
$ sortinghat orgs -a Example example.com –top-domain $ sortinghat orgs -a Example web.example.com $ sortinghat orgs -a Bitergia bitergia.com –top-domain
* List organizations
$ sortinghat orgs Bitergia bitergia.com * Example example.com * Example web.example.com Individual
* Remove domains
$ sortinghat orgs -d Example web.example.com
* Remove organizations
$ sortinghat orgs -d Bitergia
* Enroll
$ sortinghat enroll –from 2014-06-01 –to 2015-09-01 03e12d00e37fd45593c49a5a5a1652deca4cf302 Example $ sortinghat enroll –from 2015-09-01 03e12d00e37fd45593c49a5a5a1652deca4cf30 Individual
* Show enrollments information
$ sortinghat show 03e12d00e37fd45593c49a5a5a1652deca4cf302 unique identity 03e12d00e37fd45593c49a5a5a1652deca4cf302
Profile: * Name: John Smith * E-Mail: jsmith@example.com * Bot: No * Country: US - United States of America
Identities: 03e12d00e37fd45593c49a5a5a1652deca4cf302 John Smith jsmith@example.com jsmith scm 0dbc8c481b56df6da15398c83dde2f844030e978 - - jsmith mls
Enrollments: Example 2014-06-01 00:00:00 2015-09-01 00:00:00 Individual 2015-09-01 00:00:00 2100-01-01 00:00:00
* Withdraw
$ sortinghat withdraw –from 2014-06-01 –to 2015-09-01 03e12d00e37fd45593c49a5a5a1652deca4cf302 Example
## Import / Export * Import data from a Sorting Hat JSON file
$ sortinghat load sh.json Loading blacklist… Entry added to the blacklist 1/1 blacklist entries loaded Loading unique identities… + 00000ba7f563234e5f239e912f2df1021695122e (old 00000ba7f563234e5f239e912f2df1021695122e) loaded + 00003e37e7586be36c64ce4f9eafa89f11be2448 (old 00003e37e7586be36c64ce4f9eafa89f11be2448) loaded … + fa84729382093928570aef849483948489238498 (old fa84729382093928570aef849483948489238498) loaded 100/100 unique identities loaded
* Export identities
$ sortinghat export –identities sh_ids.json
* Export organizations
$ sortinghat export –orgs sh_orgs.json ```
Requirements
Python 2.7 and >= 3.4
MySQL >= 5.5
SQLAlchemy >= 0.8
Jinja2 >= 2.7
python-dateutil >= 1.5
You will also need a MySQL Python driver to connect with the database server. We recommend to use one these packages:
MySQLdb (only available for Python 2.7)
PyMySQL
Optionally, you can install Pandas library to speed up the matching process:
python-pandas >= 0.15
License
Licensed under GNU General Public License (GPL), version 3 or later.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sortinghat-0.2.0rc2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1140e98be5554e3ec70520cf496dbb0c63d1ebef1b954a18edcf278c2871f244 |
|
MD5 | b52b5b35f59a85d44140483974e07fa5 |
|
BLAKE2b-256 | eada005c6d5eb1593a540df81027e1e168f656117d3b40478bc59aa5fb980507 |