| categories | date | student | organisation | organisation_link | project | project_link | tarball | sha256sum | mentors | phase | bio | social | blog | activity | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
2019-08-25 |
Mohammed Amine Hilaly |
coala |
git-bug Github and Gitlab bidirectional syncing |
d0dc2fc5a78d5c1fa173eac6b83961e5fc913493b7a3f880c3880f89b8140360 |
[Michael Muré](https://github.com/MichaelMure)
|
I'm a final year student of Computer Science at SUPINFO International school, Strasbourg. I worked during the summer implementing Github and Gitlab bidirectional syncing for the git-bug project. I also worked on adding features to the code base and improving other existing components and the user interface.
|
|
hilalyamine@gmail.com |
|
-
Both of the GitHub and Gitlab bridges are now operational, and can be used for bidirectional syncing with private and public repositories
-
The GitHub and Gitlab bridges both have an iterator that helps decoupling the import logic from the requests made to the apis
-
git-bug bridges can be configured using interactive shell mode or by passing all necessary informations by flags
-
GitHub bridge configuration can now generate tokens with the minimal needed scopes to interact with public and private repositories
-
The bridges push and pull commands now support graceful shutdown and can be safely interrupted.
-
The Github and Gitlab bridges have end to end testing for importing and exporting issues
The biggest challenge for me was trying to ensure that the importers and exporters worked correctly even after running successive imports/exports with different bridges. This implicated writing efficient end to end tests for the Github and Gitlab bridges.
Another challenge was studying the Github and Gitlab API since each one of them has its own way to read and write issues.
On one hand the project wasn't difficult, git-bug, Github, Gitlab provided good documentations over all which helped me to implement the core functionalities. On the other hand the project wasn't easy, i have encountred so many edges cases that needed trickier implementations and more deep testing.
The GSoC experience helped me improve at many different levels especially in the Go programming language and software engineering in general. I've learned many things during this project, most importantly code quality and readability for Golang projects. My mentor reviewed my Pull Requests in a regular basis which led me to write a maintainable, better quality and well tested code.
I've also learned good practices about writing unit tests and end to end tests, using and building GraphQL apis with Go, concurrency patterns and process cancellation.
-
import and export only issues created or updated after a certain date and time. This would be very usefull to improve the import and export time for repositories containing a lot of issues
-
support importing and exporting media files included in issues and comments
-
Implementing a global bridge configuration to share one token for multiple repositories instead of storing a token with each configured bridge
-
Implementing more bridges (bugilla, gitea ...)
-
since the Github and the Gitlab exporters are very similar it would be nice to try to have one general exporter that consumes objects providing methods to write to the API directly
For example trying to implement the IssueProvider for all the bridges
type IssuesProvider interface {
CreateIssue(title, body string) (issueID string, err error)
EditIssueBody(issueID, body string) (err error)
EditIssueTitle(issueID, title string) (err error)
EditIssueStatus(issueID, status bug.Status) (err error)
EditIssueLabels(issueID, labels []bug.Label) (err error)
CreateComment(issueID, body string) (commentID string, err error)
EditComment(issueID, commentID, body string) error
}this way we can simplify the process of implementing the exporters for the new bridges