An open API service indexing awesome lists of open source software.

https://github.com/guilyx/secret-santa

🎄🎁 Random attribution of Secret Santas in a group via email, deletion of the sent emails. Can't cheat !
https://github.com/guilyx/secret-santa

email email-delivery email-sender python santa secret-santa software

Last synced: 13 days ago
JSON representation

🎄🎁 Random attribution of Secret Santas in a group via email, deletion of the sent emails. Can't cheat !

Awesome Lists containing this project

README

          

[![Say Thanks][saythanks-shield]][saythanks-url]
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![MIT License][license-shield]][license-url]
[![LinkedIn][linkedin-shield]][linkedin-url]
![github-ci](https://github.com/master-coro/artin-pathfinding/workflows/github-ci/badge.svg)




Logo

## Setup

To setup the project on your local machine:

1. Click on `Fork`.
2. Go to your fork and `clone` the project to your local machine.
3. `git clone https://github.com/Guilyx/secret-santa.git`
4. `pip3 install -r requirements.txt`

## Run

Simply run `python3 src/main.py` in the repo's root

## Contribute

To contribute to the project:

1. Choose any open issue from [here](https://github.com/Guilyx/secret-santa/issues).
2. Comment on the issue: `Can I work on this?` and get assigned.
3. Make changes to your fork and send a PR.

To create a PR:

Follow the given link to make a successful and valid PR: https://help.github.com/articles/creating-a-pull-request/

To send a PR, follow these rules carefully, **otherwise your PR will be closed**:

1. Make PR title in this formats:
```
Fixes #IssueNo : Name of Issue
```
```
Feature #IssueNo : Name of Issue
```
```
Enhancement #IssueNo : Name of Issue
```

According to what type of issue you believe it is.

For any doubts related to the issues, i.e., to understand the issue better etc, comment down your queries on the respective issue.

## License

Distributed under the MIT License. See `LICENSE` for more information.

## Contact

Erwin Lejeune - [@spida_rwin](https://twitter.com/spida_rwin) - erwin.lejeune15@gmail.com

## Contributors

Everyone part of the original team or that assisted throughout the development.

- [Erwin Lejeune](https://github.com/Guilyx)

[saythanks-shield]:https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg?style=flat-square
[saythanks-url]:https://saythanks.io/to/erwin.lejeune15%40gmail.com
[contributors-shield]: https://img.shields.io/github/contributors/guilyx/secret-santa.svg?style=flat-square
[contributors-url]: https://github.com/guilyx/secret-santa/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/guilyx/secret-santa.svg?style=flat-square
[forks-url]: https://github.com/guilyx/secret-santa/network/members
[stars-shield]: https://img.shields.io/github/stars/guilyx/secret-santa.svg?style=flat-square
[stars-url]: https://github.com/guilyx/secret-santa/stargazers
[issues-shield]: https://img.shields.io/github/issues/guilyx/secret-santa.svg?style=flat-square
[issues-url]: https://github.com/guilyx/secret-santa/issues
[license-shield]: https://img.shields.io/github/license/guilyx/secret-santa.svg?style=flat-square
[license-url]: https://github.com/guilyx/secret-santa/blob/master/LICENSE.md
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=flat-square&logo=linkedin&colorB=555
[linkedin-url]: https://linkedin.com/in/erwinlejeune-lkn