Skip to content

Commit 60bdd2b

Browse files
CarliCarli
Carli
authored and
Carli
committed
Add Quickstart and Usage
1 parent 15ed62d commit 60bdd2b

File tree

1 file changed

+30
-1
lines changed

1 file changed

+30
-1
lines changed

README.md

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,14 +18,43 @@ The following MS Project attributes are synced (overwritten) from gitlab:
1818
- Text30 (the reference to the issue is stored there)
1919
- Hyperlink (link to gitlab issue - note: somehow ms project is not handling the links correctly)
2020

21-
Not yet implemented but planned>
21+
Not yet implemented but planned:
2222
- Resources (from Assigned)
2323

2424
Moved issues will be handled if the group selected and the issue was moved within the
2525
group. Problem is that accessing issues only by ID is just allowed for admins.
2626
## Requirements
2727
This project runs only in an Windows Environment with Microsoft Project installed.
2828

29+
## Usage
30+
```
31+
usage: sync_gitlab2msproject [-h] [--version] [-v] [-vv] [--gitlab-url GITLAB_URL] [--gitlab-token GITLAB_TOKEN] {project,group} gitlab_resource_id project_file
32+
33+
Sync Gitlab Issue into MS Project
34+
35+
positional arguments:
36+
{project,group} Gitlab resource type to sync with
37+
gitlab_resource_id Gitlab resource id to sync with
38+
project_file Microsoft Project File to sync with
39+
40+
optional arguments:
41+
-h, --help show this help message and exit
42+
--version show program's version number and exit
43+
-v, --verbose set loglevel to INFO
44+
-vv, --very-verbose set loglevel to DEBUG
45+
--gitlab-url GITLAB_URL
46+
URL to the gitlab instance i.e. https://gitlab.your-company.com
47+
--gitlab-token GITLAB_TOKEN
48+
Gitlab personal access token
49+
50+
```
51+
52+
## Quickstart
53+
1. Optional: Install [pipx](https://github.com/pipxproject/pipx)
54+
2. Install the package `pipx install SyncGitlab2MSProject` (or use `pip` if you don't like pipx)
55+
3. Push the gitlab Issue to your MS Project file:
56+
`sync_gitlab2msproject --gitlab-url https://gitlab.company.com --gitlab-token <your_token> group <your_group_id> ms_project_file.mpp`
57+
2958
## Note
3059

3160
This project has been set up using PyScaffold 3.2.3. For details and usage

0 commit comments

Comments
 (0)