|
| 1 | +# sortinghat-eclipse-foundation |
| 2 | + |
| 3 | +SortingHat backend to import identities from Eclipse Foundation |
| 4 | + |
| 5 | +## Requirements |
| 6 | + |
| 7 | + - Python >= 3.9 |
| 8 | + |
| 9 | +You will also need some other libraries for running the tool, you can find the |
| 10 | +whole list of dependencies in [pyproject.toml](pyproject.toml) file. |
| 11 | + |
| 12 | +## Installation |
| 13 | + |
| 14 | +There are several ways to install sortinghat-eclipse-foundation on your system: packages or source |
| 15 | +code using Poetry or pip. |
| 16 | + |
| 17 | +### PyPI |
| 18 | + |
| 19 | +sortinghat-eclipse-foundation can be installed using pip, a tool for installing Python packages. |
| 20 | +To do it, run the next command: |
| 21 | +``` |
| 22 | +$ pip install sortinghat-eclipse-foundation |
| 23 | +``` |
| 24 | + |
| 25 | +### Source code |
| 26 | + |
| 27 | +To install from the source code you will need to clone the repository first: |
| 28 | +``` |
| 29 | +$ git clone https://github.com/bitergia-analytics/sortinghat-eclipse-foundation |
| 30 | +$ cd sortinghat-eclipse-foundation |
| 31 | +``` |
| 32 | + |
| 33 | +Then use pip or Poetry to install the package along with its dependencies. |
| 34 | + |
| 35 | +#### Pip |
| 36 | + |
| 37 | +To install the package from local directory run the following command: |
| 38 | +``` |
| 39 | +$ pip install . |
| 40 | +``` |
| 41 | +In case you are a developer, you should install sortinghat-eclipse-foundation in editable mode: |
| 42 | +``` |
| 43 | +$ pip install -e . |
| 44 | +``` |
| 45 | + |
| 46 | +#### Poetry |
| 47 | + |
| 48 | +We use [poetry](https://python-poetry.org/) for dependency management and |
| 49 | +packaging. You can install it following its [documentation](https://python-poetry.org/docs/#installation). |
| 50 | +Once you have installed it, you can install sortinghat-openinfra and the dependencies in |
| 51 | +a project isolated environment using: |
| 52 | +``` |
| 53 | +$ poetry install |
| 54 | +``` |
| 55 | +To spaw a new shell within the virtual environment use: |
| 56 | +``` |
| 57 | +$ poetry shell |
| 58 | +``` |
| 59 | + |
| 60 | +## Usage |
| 61 | + |
| 62 | +Install this SortingHat backend to import identities from the Eclipse Foundation. |
| 63 | +You can use this importer using the API or the UI. The name of the backend is |
| 64 | +`EclipseFoundation`. You will have to provide the credentials on the settings file |
| 65 | +in order to access the Eclipse Foundation API: |
| 66 | + |
| 67 | +- `ECLIPSE_FOUNDATION_USER_ID`: username on the Eclipse Foundation platform. |
| 68 | +- `ECLIPSE_FOUNDATION_PASSWORD`: password for the previous user. |
| 69 | + |
| 70 | +The user will also have the next permissions for reading the identities: |
| 71 | + |
| 72 | +- `eclipsefdn_view_all_profiles` |
0 commit comments