16
0
Fork 0
This repository has been archived on 2026-03-24. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
grimoire-perceval-fedmsg-pl.../README.md

40 lines
2 KiB
Markdown
Raw Normal View History

## Welcome GSoC and Outreachy applicants!
This repo is brand new and it's meant to be :)
---
## Beginner tasks
#### Research about fedmsg and Perceval.
fedmsg is extensively documented and is used in a lot of Fedora applications. You can read the documentation on [Read the Docs](http://fedmsg.readthedocs.io/) and review applications that are found in the [fedora-infra GitHub repository](https://github.com/fedora-infra).
#### Write a minimal fedmsg app which can trigger an event (can be anything like tweeting, sending an IRC message, or anything crazy {Remember, sky is the limit!}) using fedmsg.
To get started with this task, please go through Ralph Bean's slides on [How to build your own fedmsg applications](http://threebean.org/presentations/fedmsg-flock14/#/step-1). It is a good starting point if you think fedmsg documentation doesn't answer your questions.
#### Write a basic Perceval plugin which pulls data from any REST API you like (yep, ANY!)
Perceval has a lot of backends defined already. If you like some real-time examples, head over to the [Perceval backend code](https://github.com/chaoss/grimoirelab-perceval/tree/master/perceval/backends/core) and review all the Python files available there. For instructions on how to use Perceval to gather data, [read the training manual](https://www.gitbook.com/book/grimoirelab/tutorial/details) designed by Grimoirelab developers :)
### Resources & Quick Reference
Fedmsg : http://fedmsg.readthedocs.io/
Perceval : https://github.com/grimoirelab/perceval
Getting started with Grimoire: https://www.gitbook.com/book/grimoirelab/tutorial/details
Writing fedmsg plugins : https://fedmsg.readthedocs.io/en/stable/subscribing/
Existing plugins (code) : https://github.com/chaoss/grimoirelab-perceval/tree/master/perceval/backends/core
If you have any questions about the tasks, please feel free to email skamath [at] fedoraproject [dot] org, or hop on to Freenode IRC and say hello to `skamath` on `#fedora-outreachy` or `#fedora-summer-coding` channel.