/IranOpenSourceHackathon

Iran Open Source Hackathon

Primary LanguagePython

logo

Join the chat at https://gitter.im/Iran-Open-Source-Hackathon/community

Iran Open Source Hackathon is an open-source hackathon (duh) with the aim of encouraging participation in open-source contribution amongst Iranian developers. There is a curated list of repositories whose maintainers volunteered to be part of the hackathon. Contribute to any of these repositories during the hackathon, and at the end top contributors will be acknowledged here (so yes in the end its just about bragging rights).

👉 If you are a maintainer and want to enter some of your repositories in the hackathon so our participants will contribute to them, check this section.


A Note on Terminology

In these documents, keywords MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, MAY, and OPTIONAL, when appearing in caps lock and in bold, are to be interpreted as described in RFC 2119. This is not a software spec document, but still the extra clarity helps avoiding confusion.


⚠️⚠️ WORK IN PROGRESS NOTICE

This is work in progress. As long as this notice is up here, any rule, date, information, etc is subject to sudden change without any prior notice.

If a piece of information is followed by ⚠️, then there is a good chance we will change it in near future and current information is mostly a placeholder.



How Can I Participate?

Contribute to one of these repositories during the time of the hackathon:

  • Make a pull request, include #iosh in its title, body or comments.
  • The pull request MUST be accepted to the repository before the end of the hackathon.
  • Each pull request will count towards your total score.
  • At the end, all top contributors (highest number of PRs) will be acknowledged here. We'll update the list during the hackathon every 3 hours as well.

👉 If you are unfamiliar with open-source contribution, git or github, take a look at these resources. You could also join us at gitter to seek help and pointers.

NOTE: Please carefully read our code of conduct before you start contributing.


Why Should I Participate?

  • You will help improve software that people like you use (apes together strong).
  • You will learn a lot (like seriously, a TON).
  • You will earn street-cred (which also helps with employability).

I Am A Maintainer. Can I Add My Repos To This Hackathon?

Of course! You need to:

  1. Fork this repository.
  2. For each repository like https://github.com/jafar/my-repo, add a yaml file to first/repos
    (i.e. first/repos/jafar/my-repo.yaml):
# first/repos/jafar/my-repo.yaml

name: My Cool Repository
description: I am particularly cool here
languages:
  - JavaScript
  - Hashemi
  - ...
  1. Make a pull request.

👉 You can see examples in the repos directory.

👉 You can add a list of maintainers (with whom hackathon participants can be in contact) as well:

# first/repos/jafar/my-repo.yaml

name: My Cool Repository
description: I am particularly cool here
languages:
  - JavaScript
  - Hashemi
#
# 👉 for user `https://github.com/asghar`, add `asghar` to this list
# 👉 also don't forget the repo owner if they are going to be a maintainer as well
#
maintainers:
  - jafar            # 👉 MUST be GitHub username, NOT YOUR NAME!
  - asghar
  - nooshin
  - maliheh

👉 If your repo belongs to a company or organization, you MUST specify maintainers independently.

NOTE: Please carefully read our code of conduct before you submit your repositories.


Repositories

Name Description Owner Maintainer(s) Languages
Anbar A basic S3 compatible storage server in Rust. mehdy mehdy rust
text-to-commit-history Write a large text on your Github profile, with your commits history (contribution graph). erfaniaa erfaniaa Python
Laravel Crypt Model Encoding and Decoding laravel model attributes made easy. ajangi ajangi php
webp-server Simple and minimal image server capable of storing, resizing, converting and caching images. mehdipourfar mehdipourfar Go
Letiner An intelligent Leitner to memorize information, especially words, without needing to maintain boxes manually. It can be synced with Dropbox. justmisam justmisam Javascript, HTML, CSS
Pyeez A simple framework to create console applications (like htop). mehdy mehdy python
ICECREAM ICECREAM framework for Bottle designed to simplify building restful API. xenups xenups, navidnabavi Python
Keepalived Exporter Prometheus exporter for Keepalived metrics. cafebazaar mehdy go
Javascript persian interview questions A book with more than 1000 js questions Mariotek sayjeyhi javascript, markdown
flutter-global-configs A flutter package to manage application configurations via singleton pattern. mehdizarepour mehdizarepour Dart
Callbag JSX callbags + JSX: fast and tiny interactive web apps loreanvictor loreanvictor typescript
TyFON Typed Functions Over Network loreanvictor loreanvictor typescript, javascript
thatcher-effect-dataset-generator Using OpenCV to apply Thatcher effect on a set of face images erfaniaa erfaniaa Python
PyLMQ Python Library for LMQ justmisam justmisam Python
jsonplaceholder RTL fake REST/GraphQL API for testing and prototyping. moharnadreza moharnadreza TypeScript, JavaScript, CSS
gogit A simple Github Toolkit written in Golang ajangi ajangi golang
Laravel Toman Elegant Zarinpal and IDPay payment gateways for Laravel evryn AmirrezaNasiri PHP
instagram-text-editor An Instagram like text editor Flutter widget that helps you to change your text style. mehdizarepour mehdizarepour Dart
Iconbox A world of famous icon packs with easy to use interface iconsbox sayjeyhi javascript, typescript
FL Chart A powerful Flutter chart library, currently supporting Line Chart, Bar Chart, Pie Chart, Scatter Chart and Radar Chart. imaNNeoFighT imaNNeoFighT dart
Peanar A background job scheduler for Node.js based on RabbitMQ martianboy martianboy typescript
Lightweight Message Queue (LMQ) A lightweight message queue to work with short messages or content references as messages. justmisam justmisam Go
gRPC Go Contracts Verify the communication of your microservices by writing contracts for your RPCs shayanh shayanh go
Microsoft Windows 7 Preview on Web Yet another OS preview via web technologies focused on Microsoft Windows 7. nainemom nainemom javascript
BarnameKon Telegram bot which create "Add to Google Calendar" link for your events. anvaari anvaari python
text-style-editor Text style editor widget for flutter. mehdizarepour mehdizarepour Dart
React.js persian interview questions A book with more than 300 react.js questions Mariotek sayjeyhi javascript, markdown
gato A dart utility library inspired by javascript lodash library. mehdizarepour mehdizarepour Dart
divar-starter-kit React.js SSR-ready boilerplate using Razzle. divar-ir iMohammadReza javascript
paperify Backup files on paper using QRCodes. alisinabh alisinabh shell
PHP Rest Response A PHP standard response structure to unify responses between microservices. ajangi ajangi php
Zarb project Zarb blockchain zarbchain b00f Go, Rust, Javascript

To be completed


Duration

Beginning تیر ۱۵ 06 July
Ending شهریور ۱۵ 06 September

۱۴۰۰ / 2021


👉 For Participants

Your pull requests MUST be submitted after beginning of the hackathon period and be merged before the end of the hackathon.


👉 For Maintainers

Ideally, submit your repositories before the start of the hackathon, though you can submit it during the duration of the hackathon as well.


Top Contributors

To be determined

Contributor Total PRs Repos

Top Repos

To be determined

Repo Total PRs Contributors