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 !
- Host: GitHub
- URL: https://github.com/guilyx/secret-santa
- Owner: guilyx
- License: mit
- Created: 2019-11-23T16:57:58.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-04-27T18:16:51.000Z (about 6 years ago)
- Last Synced: 2025-06-03T23:11:29.408Z (about 1 year ago)
- Topics: email, email-delivery, email-sender, python, santa, secret-santa, software
- Language: Python
- Homepage:
- Size: 102 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
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]

## 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