Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/icanhazstring/random-issue-picker
Select a random issue from github or gitlab by certain criteria
https://github.com/icanhazstring/random-issue-picker
github gitlab hacktoberfest issue php random
Last synced: 22 days ago
JSON representation
Select a random issue from github or gitlab by certain criteria
- Host: GitHub
- URL: https://github.com/icanhazstring/random-issue-picker
- Owner: icanhazstring
- Created: 2019-06-29T18:16:12.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-12-30T10:45:06.000Z (almost 3 years ago)
- Last Synced: 2024-10-04T12:59:57.533Z (about 1 month ago)
- Topics: github, gitlab, hacktoberfest, issue, php, random
- Language: PHP
- Homepage:
- Size: 39.1 KB
- Stars: 24
- Watchers: 3
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Random Issue Picker
The random issue picker, can be used to pick surprisingly random issues in your preferred langauge.
Requirements:
* Composer
* PHP 7.3+
## How to use it
```shell
$ git clone https://github.com/icanhazstring/random-issue-picker.git
$ cd random-issue-picker
$ composer install
$ bin/rip random:issue
```
As a preparation for the [Hacktoberfest 2020](https://hacktoberfest.digitalocean.com) we have added some features to support `topic`, `language` and `label` as input parameter, so now you can use
```shell
$ bin/rip random:issue -l php -t hacktoberfest -t php --label good-first-issue
```
As a preparation for the [Hacktoberfest 2021](https://hacktoberfest.digitalocean.com) we have added support for Gitlab. To search for Gitlab projects the input parameter `--source (-s)` was added.
GitLab requires a [Personal Access Token](https://gitlab.com/-/profile/personal_access_tokens). If you want to use Gitlab as Provider you need to add your PAT into the `.env` File.
```shell
# .env
# GITLAB_PAT=
$ bin/rip random:issue -s gitlab
```
Default values:
| Parameter | Default Value | Example |
|------------------|----------------------|---------------------------
| --language, -l | php | -l javascript |
| --topic, -t | hacktoberfest | -t tool -t hacktoberfest |
| --label | | --label good-first-issue |
| --source, -s | github | -s github|gitlab |
Note:
As in the first step a random repository will be searched that matches the
given language and topics and in the second step a random issue will be selected
from this repository, it is more likely to not find an issue, if the --label
parameter is used.
## Watch me create this tool
[YouTube : Making The Tool](https://www.youtube.com/watch?v=QRf4CQxpznM)
## How to contribute
```shell
$ git clone https://github.com/icanhazstring/random-issue-picker.git
```
The minimum requirement, as mentioned above, is PHP 7.3. You either have it installed locally, or you can
run the tool and every check using `docker`. There is `Makefile` present to support your work.
You can run `make up` to build the image and run the container.
> For more available commands refer to the [Makefile](Makefile)
After you have done this, you can install the dependencies using `make composer install`.
When you've made your changes, create a pull request and you are ready to go.
Have fun contributing :+1: