github-lister-core 0.1.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.github/CODEOWNERS +5 -0
- data/.github/CODE_OF_CONDUCT.md +76 -0
- data/.github/CONTRIBUTING.md +9 -0
- data/.github/FUNDING.yml +4 -0
- data/.github/ISSUE_TEMPLATE/ask_question.md +10 -0
- data/.github/ISSUE_TEMPLATE/bug_report.md +30 -0
- data/.github/ISSUE_TEMPLATE/config.yml +1 -0
- data/.github/ISSUE_TEMPLATE/feature_request.md +20 -0
- data/.github/PULL_REQUEST_TEMPLATE.md +28 -0
- data/.github/SECURITY.md +39 -0
- data/.github/SUPPORT.md +8 -0
- data/.gitignore +17 -0
- data/.reek.yml +10 -0
- data/.rspec +3 -0
- data/.rubocop.yml +31 -0
- data/.travis.yml +129 -0
- data/CHANGELOG.md +29 -0
- data/Gemfile +6 -0
- data/LICENSE.md +25 -0
- data/README.md +121 -0
- data/Rakefile +6 -0
- data/VERSION.txt +1 -0
- data/bin/console +14 -0
- data/bin/setup +8 -0
- data/github-lister-core.gemspec +45 -0
- data/lib/github-lister-core/client.rb +27 -0
- data/lib/github-lister-core/errors.rb +76 -0
- data/lib/github-lister-core/languages.rb +28 -0
- data/lib/github-lister-core/organisations.rb +62 -0
- data/lib/github-lister-core/preview.rb +11 -0
- data/lib/github-lister-core/releases.rb +53 -0
- data/lib/github-lister-core/repos.rb +92 -0
- data/lib/github-lister-core/topics.rb +29 -0
- data/lib/github-lister-core/users.rb +46 -0
- data/lib/github-lister-core/utils.rb +75 -0
- data/lib/github-lister-core/version.rb +3 -0
- data/lib/github-lister-core/wrapper.rb +32 -0
- data/lib/github-lister-core.rb +113 -0
- data/stale.yml +17 -0
- data/testing/get-raw.rb +36 -0
- metadata +215 -0
checksums.yaml
ADDED
@@ -0,0 +1,7 @@
|
|
1
|
+
---
|
2
|
+
SHA256:
|
3
|
+
metadata.gz: be1e198375f2783e65381f8668c7bd4abc56d2e3cdc6a78b2929f19b4ccd9f4f
|
4
|
+
data.tar.gz: 68a794988bbe92f704d94d350c7c21b2aff0a1c3a90aa9d530efe03cf49628b6
|
5
|
+
SHA512:
|
6
|
+
metadata.gz: bb99c15f2c71b763e67bb84414f9d4ca1b8d206c00d39f283ea4c3a36a2ced6253cb40f8de57b52a27588ebeb382ebd40617478d7de27b22e584f831c4fadcb7
|
7
|
+
data.tar.gz: 9b46b2fbfec39bc13880995eb1b8c432dd1d6df2b93a8756e8814f87c9b4fd6eb79246987ed475babbe47917ce12edb512aab78830fd14b83ec406c60e2fd9a9
|
data/.github/CODEOWNERS
ADDED
@@ -0,0 +1,76 @@
|
|
1
|
+
# Contributor Covenant Code of Conduct
|
2
|
+
|
3
|
+
## Our Pledge
|
4
|
+
|
5
|
+
In the interest of fostering an open and welcoming environment, we as
|
6
|
+
contributors and maintainers pledge to making participation in our project and
|
7
|
+
our community a harassment-free experience for everyone, regardless of age, body
|
8
|
+
size, disability, ethnicity, sex characteristics, gender identity and expression,
|
9
|
+
level of experience, education, socio-economic status, nationality, personal
|
10
|
+
appearance, race, religion, or sexual identity and orientation.
|
11
|
+
|
12
|
+
## Our Standards
|
13
|
+
|
14
|
+
Examples of behavior that contributes to creating a positive environment
|
15
|
+
include:
|
16
|
+
|
17
|
+
* Using welcoming and inclusive language
|
18
|
+
* Being respectful of differing viewpoints and experiences
|
19
|
+
* Gracefully accepting constructive criticism
|
20
|
+
* Focusing on what is best for the community
|
21
|
+
* Showing empathy towards other community members
|
22
|
+
|
23
|
+
Examples of unacceptable behavior by participants include:
|
24
|
+
|
25
|
+
* The use of sexualized language or imagery and unwelcome sexual attention or
|
26
|
+
advances
|
27
|
+
* Trolling, insulting/derogatory comments, and personal or political attacks
|
28
|
+
* Public or private harassment
|
29
|
+
* Publishing others' private information, such as a physical or electronic
|
30
|
+
address, without explicit permission
|
31
|
+
* Other conduct which could reasonably be considered inappropriate in a
|
32
|
+
professional setting
|
33
|
+
|
34
|
+
## Our Responsibilities
|
35
|
+
|
36
|
+
Project maintainers are responsible for clarifying the standards of acceptable
|
37
|
+
behavior and are expected to take appropriate and fair corrective action in
|
38
|
+
response to any instances of unacceptable behavior.
|
39
|
+
|
40
|
+
Project maintainers have the right and responsibility to remove, edit, or
|
41
|
+
reject comments, commits, code, wiki edits, issues, and other contributions
|
42
|
+
that are not aligned to this Code of Conduct, or to ban temporarily or
|
43
|
+
permanently any contributor for other behaviors that they deem inappropriate,
|
44
|
+
threatening, offensive, or harmful.
|
45
|
+
|
46
|
+
## Scope
|
47
|
+
|
48
|
+
This Code of Conduct applies both within project spaces and in public spaces
|
49
|
+
when an individual is representing the project or its community. Examples of
|
50
|
+
representing a project or community include using an official project e-mail
|
51
|
+
address, posting via an official social media account, or acting as an appointed
|
52
|
+
representative at an online or offline event. Representation of a project may be
|
53
|
+
further defined and clarified by project maintainers.
|
54
|
+
|
55
|
+
## Enforcement
|
56
|
+
|
57
|
+
Instances of abusive, harassing, or otherwise unacceptable behavior may be
|
58
|
+
reported by contacting the project team at . All
|
59
|
+
complaints will be reviewed and investigated and will result in a response that
|
60
|
+
is deemed necessary and appropriate to the circumstances. The project team is
|
61
|
+
obligated to maintain confidentiality with regard to the reporter of an incident.
|
62
|
+
Further details of specific enforcement policies may be posted separately.
|
63
|
+
|
64
|
+
Project maintainers who do not follow or enforce the Code of Conduct in good
|
65
|
+
faith may face temporary or permanent repercussions as determined by other
|
66
|
+
members of the project's leadership.
|
67
|
+
|
68
|
+
## Attribution
|
69
|
+
|
70
|
+
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
|
71
|
+
available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
|
72
|
+
|
73
|
+
[homepage]: https://www.contributor-covenant.org
|
74
|
+
|
75
|
+
For answers to common questions about this code of conduct, see
|
76
|
+
https://www.contributor-covenant.org/faq
|
@@ -0,0 +1,9 @@
|
|
1
|
+
# Contributing
|
2
|
+
|
3
|
+
Please refer to the [contributing](https://github.com/WolfSoftware/contributing) documentation.
|
4
|
+
|
5
|
+
## Important
|
6
|
+
|
7
|
+
ALL commits must be signed to ensure the identity of the developer, any pull requests that are made with unsigned commits will be rejected as a matter of course.
|
8
|
+
|
9
|
+
> This project has a [code of conduct](CODE_OF_CONDUCT.md). By interacting with this repository, organization, or community you agree to abide by its terms.
|
data/.github/FUNDING.yml
ADDED
@@ -0,0 +1,30 @@
|
|
1
|
+
---
|
2
|
+
name: Bug report
|
3
|
+
about: Create a report to help us improve
|
4
|
+
title: ''
|
5
|
+
labels: 'bug'
|
6
|
+
assignees: 'TGWolf'
|
7
|
+
|
8
|
+
---
|
9
|
+
|
10
|
+
**Describe the bug**
|
11
|
+
A clear and concise description of what the bug is.
|
12
|
+
|
13
|
+
**To Reproduce**
|
14
|
+
Steps to reproduce the behavior:
|
15
|
+
1.
|
16
|
+
2.
|
17
|
+
3.
|
18
|
+
4.
|
19
|
+
|
20
|
+
**Expected behavior**
|
21
|
+
A clear and concise description of what you expected to happen.
|
22
|
+
|
23
|
+
**Screenshots**
|
24
|
+
If applicable, add screenshots to help explain your problem.
|
25
|
+
|
26
|
+
**Environment**
|
27
|
+
Any relevant information about your environment, OS version, virtualised or not.
|
28
|
+
|
29
|
+
**Additional context**
|
30
|
+
Add any other context about the problem here.
|
@@ -0,0 +1 @@
|
|
1
|
+
blank_issues_enabled: false
|
@@ -0,0 +1,20 @@
|
|
1
|
+
---
|
2
|
+
name: Feature request
|
3
|
+
about: Suggest an idea for this project
|
4
|
+
title: ''
|
5
|
+
labels: 'enhancement'
|
6
|
+
assignees: 'TGWolf'
|
7
|
+
|
8
|
+
---
|
9
|
+
|
10
|
+
**Is your feature request related to a problem? Please describe.**
|
11
|
+
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
|
12
|
+
|
13
|
+
**Describe the solution you'd like**
|
14
|
+
A clear and concise description of what you want to happen.
|
15
|
+
|
16
|
+
**Describe alternatives you've considered**
|
17
|
+
A clear and concise description of any alternative solutions or features you've considered.
|
18
|
+
|
19
|
+
**Additional context**
|
20
|
+
Add any other context or screenshots about the feature request here.
|
@@ -0,0 +1,28 @@
|
|
1
|
+
Thanks for submitting a pull request! Please provide enough information so that others can review your pull request:
|
2
|
+
|
3
|
+
**Summary**
|
4
|
+
|
5
|
+
<!-- Summary of the PR -->
|
6
|
+
|
7
|
+
This PR fixes/implements the following **bugs/features**
|
8
|
+
|
9
|
+
* [ ] Bug 1
|
10
|
+
* [ ] Feature 1
|
11
|
+
* [ ] Breaking changes
|
12
|
+
|
13
|
+
<!-- You can skip this if you're fixing a typo or adding an app to the Showcase. -->
|
14
|
+
|
15
|
+
Explain the **motivation** for making this change. What existing problem does the pull request solve?
|
16
|
+
|
17
|
+
<!-- Example: When "Adding a function to do X", explain why it is necessary to have a way to do X. -->
|
18
|
+
|
19
|
+
**Test plan (required)**
|
20
|
+
|
21
|
+
Demonstrate the code is solid. Example: The exact commands you ran and their output, screenshots help greatly.
|
22
|
+
|
23
|
+
<!-- Make sure tests pass on both Travis. -->
|
24
|
+
|
25
|
+
**Closing issues**
|
26
|
+
|
27
|
+
<!-- Put `fixes #XXXX` in your comment to auto-close the issue that your PR fixes (if such). -->
|
28
|
+
Fixes #
|
data/.github/SECURITY.md
ADDED
@@ -0,0 +1,39 @@
|
|
1
|
+
# Security Policies and Procedures
|
2
|
+
|
3
|
+
This document outlines security procedures and general policies for this project.
|
4
|
+
|
5
|
+
* [Reporting a Bug](#reporting-a-bug)
|
6
|
+
* [Disclosure Policy](#disclosure-policy)
|
7
|
+
* [Comments on this Policy](#comments-on-this-policy)
|
8
|
+
|
9
|
+
## Reporting a Bug
|
10
|
+
|
11
|
+
We take **ALL** security related bugs and issues very seriously.
|
12
|
+
|
13
|
+
If you think you have identified a security related issue, please [report it immediately](mailto:disclose@wolfsoftware.com)
|
14
|
+
and include the word "SECURITY" in the subject line. If you are not sure, don’t worry.
|
15
|
+
Better safe than sorry – just send an email.
|
16
|
+
|
17
|
+
* Please provide as much information as you can.
|
18
|
+
* Please do not open issues related to any security concerns publicly.
|
19
|
+
* Please do not include anyone else on the disclosure email.
|
20
|
+
|
21
|
+
Report security bugs in third-party modules to the person or team maintaining
|
22
|
+
the module.
|
23
|
+
|
24
|
+
## Disclosure Policy
|
25
|
+
|
26
|
+
When a security report is received, we will carry out the following steps:
|
27
|
+
|
28
|
+
* Confirm the problem and determine the affected versions.
|
29
|
+
* Audit code to find any potential similar problems.
|
30
|
+
* Prepare fixes for all releases still under maintenance. These fixes will be
|
31
|
+
released as fast as possible.
|
32
|
+
|
33
|
+
We will endeavor to keep you informed of the progress towards a fix
|
34
|
+
and full announcement, and may ask for additional information or guidance.
|
35
|
+
|
36
|
+
## Comments on this Policy
|
37
|
+
|
38
|
+
If you have suggestions on how this process could be improved please submit a
|
39
|
+
pull request.
|
data/.github/SUPPORT.md
ADDED
@@ -0,0 +1,8 @@
|
|
1
|
+
# Support
|
2
|
+
|
3
|
+
If the documentation is not providing the information that you require then you have a couple of options:
|
4
|
+
|
5
|
+
1. [Start a discussion](https://github.com/DevelopersToolbox/github-lister-core/discussions).
|
6
|
+
1. [Open an issue](https://github.com/DevelopersToolbox/github-lister-core/issues), using the `Ask a question` option.
|
7
|
+
|
8
|
+
> This project has a [code of conduct](CODE_OF_CONDUCT.md). By interacting with this repository, organization, or community you agree to abide by its terms.
|
data/.gitignore
ADDED
data/.reek.yml
ADDED
data/.rspec
ADDED
data/.rubocop.yml
ADDED
@@ -0,0 +1,31 @@
|
|
1
|
+
AllCops:
|
2
|
+
NewCops: enable
|
3
|
+
TargetRubyVersion: 2.5
|
4
|
+
|
5
|
+
Layout/IndentationWidth:
|
6
|
+
Width: 4
|
7
|
+
|
8
|
+
Layout/LineLength:
|
9
|
+
Enabled: false
|
10
|
+
|
11
|
+
Naming/FileName:
|
12
|
+
Enabled: false
|
13
|
+
|
14
|
+
Naming/RescuedExceptionsVariableName:
|
15
|
+
PreferredName: exception
|
16
|
+
|
17
|
+
Style/FrozenStringLiteralComment:
|
18
|
+
Enabled: false
|
19
|
+
|
20
|
+
Style/HashSyntax:
|
21
|
+
EnforcedStyle: hash_rockets
|
22
|
+
|
23
|
+
Style/RaiseArgs:
|
24
|
+
EnforcedStyle: compact
|
25
|
+
|
26
|
+
Style/Semicolon:
|
27
|
+
AllowAsExpressionSeparator: true
|
28
|
+
|
29
|
+
Style/SymbolArray:
|
30
|
+
Enabled: false
|
31
|
+
|
data/.travis.yml
ADDED
@@ -0,0 +1,129 @@
|
|
1
|
+
matrix:
|
2
|
+
include:
|
3
|
+
- language: ruby
|
4
|
+
name: Bundler (rvm 2.5)
|
5
|
+
rvm: 2.5
|
6
|
+
before_install:
|
7
|
+
- gem install bundler
|
8
|
+
- language: ruby
|
9
|
+
name: Bundler (rvm 2.6)
|
10
|
+
rvm: 2.6
|
11
|
+
before_install:
|
12
|
+
- gem install bundler
|
13
|
+
- language: ruby
|
14
|
+
name: Bundler (rvm 2.7)
|
15
|
+
rvm: 2.7
|
16
|
+
before_install:
|
17
|
+
- gem install bundler
|
18
|
+
- language: ruby
|
19
|
+
name: Bundler (rvm 3.0)
|
20
|
+
rvm: 3.0
|
21
|
+
before_install:
|
22
|
+
- gem install bundler
|
23
|
+
- language: ruby
|
24
|
+
name: Rubocop (rvm 2.5)
|
25
|
+
rvm: 2.5
|
26
|
+
before_install:
|
27
|
+
- git clone https://github.com/TravisToolbox/rubocop.git
|
28
|
+
install:
|
29
|
+
- "./rubocop/install.sh"
|
30
|
+
script:
|
31
|
+
- "./rubocop/scan.sh"
|
32
|
+
- language: ruby
|
33
|
+
name: Rubocop (rvm 2.6)
|
34
|
+
rvm: 2.6
|
35
|
+
before_install:
|
36
|
+
- git clone https://github.com/TravisToolbox/rubocop.git
|
37
|
+
install:
|
38
|
+
- "./rubocop/install.sh"
|
39
|
+
script:
|
40
|
+
- "./rubocop/scan.sh"
|
41
|
+
- language: ruby
|
42
|
+
name: Rubocop (rvm 2.7)
|
43
|
+
rvm: 2.7
|
44
|
+
before_install:
|
45
|
+
- git clone https://github.com/TravisToolbox/rubocop.git
|
46
|
+
install:
|
47
|
+
- "./rubocop/install.sh"
|
48
|
+
script:
|
49
|
+
- "./rubocop/scan.sh"
|
50
|
+
- language: ruby
|
51
|
+
name: Rubocop (rvm 3.0)
|
52
|
+
rvm: 3.0
|
53
|
+
before_install:
|
54
|
+
- git clone https://github.com/TravisToolbox/rubocop.git
|
55
|
+
install:
|
56
|
+
- "./rubocop/install.sh"
|
57
|
+
script:
|
58
|
+
- "./rubocop/scan.sh"
|
59
|
+
- language: ruby
|
60
|
+
name: Reek (rvm 2.5)
|
61
|
+
rvm: 2.5
|
62
|
+
before_install:
|
63
|
+
- git clone https://github.com/TravisToolbox/reek.git
|
64
|
+
install:
|
65
|
+
- "./reek/install.sh"
|
66
|
+
script:
|
67
|
+
- "./reek/scan.sh"
|
68
|
+
- language: ruby
|
69
|
+
name: Reek (rvm 2.6)
|
70
|
+
rvm: 2.6
|
71
|
+
before_install:
|
72
|
+
- git clone https://github.com/TravisToolbox/reek.git
|
73
|
+
install:
|
74
|
+
- "./reek/install.sh"
|
75
|
+
script:
|
76
|
+
- "./reek/scan.sh"
|
77
|
+
- language: ruby
|
78
|
+
name: Reek (rvm 2.7)
|
79
|
+
rvm: 2.7
|
80
|
+
before_install:
|
81
|
+
- git clone https://github.com/TravisToolbox/reek.git
|
82
|
+
install:
|
83
|
+
- "./reek/install.sh"
|
84
|
+
script:
|
85
|
+
- "./reek/scan.sh"
|
86
|
+
- language: ruby
|
87
|
+
name: Reek (rvm 3.0)
|
88
|
+
rvm: 3.0
|
89
|
+
before_install:
|
90
|
+
- git clone https://github.com/TravisToolbox/reek.git
|
91
|
+
install:
|
92
|
+
- "./reek/install.sh"
|
93
|
+
script:
|
94
|
+
- "./reek/scan.sh"
|
95
|
+
- language: ruby
|
96
|
+
name: YAML Linting (rvm 2.7)
|
97
|
+
rvm: 2.7
|
98
|
+
before_install:
|
99
|
+
- git clone https://github.com/TravisToolbox/yaml-lint
|
100
|
+
install:
|
101
|
+
- "./yaml-lint/install.sh"
|
102
|
+
script:
|
103
|
+
- "./yaml-lint/scan.sh"
|
104
|
+
- language: bash
|
105
|
+
name: Shellcheck (Bash)
|
106
|
+
os: linux
|
107
|
+
arch: arm64-graviton2
|
108
|
+
before_install:
|
109
|
+
- git clone https://github.com/TravisToolbox/shellcheck
|
110
|
+
install:
|
111
|
+
- "./shellcheck/install.sh"
|
112
|
+
script:
|
113
|
+
- "./shellcheck/scan.sh"
|
114
|
+
- language: ruby
|
115
|
+
name: Link Checking (rvm 2.7)
|
116
|
+
rvm: 2.7
|
117
|
+
env:
|
118
|
+
- WHITELIST="https://img.shields.io"
|
119
|
+
- EXCLUDE_FILES="CHANGELOG.md,github-lister-core.gemspec"
|
120
|
+
before_install:
|
121
|
+
- git clone https://github.com/TravisToolbox/awesomebot
|
122
|
+
install:
|
123
|
+
- "./awesomebot/install.sh"
|
124
|
+
script:
|
125
|
+
- "./awesomebot/scan.sh"
|
126
|
+
notifications:
|
127
|
+
email: false
|
128
|
+
slack:
|
129
|
+
secure: OAh1PldyUAdO1CaXQhktRIqxWJc0O7D+3aHr1b6iiK4l2Kkzy2UcRYevw61UoBZj3/7PAnC1Pp0PttekcqAtrTx6ZVA9SP2md0BT9M0VzDrSePxT4T0gnj+ESb6vT4xYS0jz83hu4T+s0YoRrCZR4OOWyFHobEJzxxjRjf4nK9ldmwMaSFlncGst9tHIxjKgKApnnA0TttreVDM4y6Szq1CAUv0N6MUN+bIzwaQhKAhjdRqmZEYsufxeia6WUeN57z6Bt06y5pCSt5rwF3uQUxN8zcP7Sl5nCqBhlsh+LlXYUOlK7l8tVJ4r/yX0reHf8YXqA+IEKVatpjSNu4c9M6zyku/L547hWyRuVKe/Q4ADWgI45pipweE79dRCwPmclNNT8obhoQcaLGWj1wsV9udibOy8fGZYWXESTk6pUCcQWJmdIoyvrCgICvRFCs6QfzWqKcgerkv+8V1RwlPx7wAStRvgOAmoZ3RLjjbXbwymriHYTIim1grDTegQZJa4R3ITUuzy8R0Neod/HO5FO1M/XMiFJI2qIpjX1hT5gFRSb2JvzK0JrdAiuZ8xEk02r8Ix/hxJCF95TSe9VmIL5wKKp108OwXXOisF/bNzExgRK5gGKnNMoFW2aVmM3SAd9R8JPWdVwRTrS7PEdQE6NDKZsXaqITLy6KpPMGxcSrY=
|
data/CHANGELOG.md
ADDED
@@ -0,0 +1,29 @@
|
|
1
|
+
# Changelog
|
2
|
+
|
3
|
+
All notable changes to this project will be documented in this file.
|
4
|
+
|
5
|
+
|
6
|
+
This changelog was automatically generated using [Caretaker](https://github.com/DevelopersToolbox/caretaker) by [Wolf Software](https://github.com/WolfSoftware)
|
7
|
+
|
8
|
+
### [Unreleased](https://github.com/DevelopersToolbox/github-lister-core/compare/v0.1.0...HEAD)
|
9
|
+
|
10
|
+
- Spell checking [`[head]`](https://github.com/DevelopersToolbox/github-lister-core/commit/)
|
11
|
+
|
12
|
+
- Final pre-release flight check [`[2788d33]`](https://github.com/DevelopersToolbox/github-lister-core/commit/2788d33540ad219e8ce1bcaad6d60f84d560e118)
|
13
|
+
|
14
|
+
- Pre-release [`[bdc0937]`](https://github.com/DevelopersToolbox/github-lister-core/commit/bdc09379f4ecdc14a36698384400860308762854)
|
15
|
+
|
16
|
+
- Pre-release [`[5f23931]`](https://github.com/DevelopersToolbox/github-lister-core/commit/5f2393147b2b149472cc0f9ca5a1b6407eef621d)
|
17
|
+
|
18
|
+
- Cleaning [`[dfdc9c9]`](https://github.com/DevelopersToolbox/github-lister-core/commit/dfdc9c9f689e3973eb417793807e5e69184dcaed)
|
19
|
+
|
20
|
+
- Lots of changes [`[4906d56]`](https://github.com/DevelopersToolbox/github-lister-core/commit/4906d565a2df9dbee91ab1055acbdb4bd5b3d194)
|
21
|
+
|
22
|
+
- Create publib / private functions [`[d0c9b7d]`](https://github.com/DevelopersToolbox/github-lister-core/commit/d0c9b7df4a5d25ade1dc53cb1c6832381421e55e)
|
23
|
+
|
24
|
+
- fix [`[99e9078]`](https://github.com/DevelopersToolbox/github-lister-core/commit/99e9078d97bab679ad8f2b0267ea7c72fbc0f423)
|
25
|
+
|
26
|
+
- Added some basic docs for developers, added WAY more tests [`[e388381]`](https://github.com/DevelopersToolbox/github-lister-core/commit/e3883819591e5918f6a1db834072bb364f14256b)
|
27
|
+
|
28
|
+
- First major push [`[af06a65]`](https://github.com/DevelopersToolbox/github-lister-core/commit/af06a658bb68ba204a790fa6758b4929090545ee)
|
29
|
+
|
data/Gemfile
ADDED
data/LICENSE.md
ADDED
@@ -0,0 +1,25 @@
|
|
1
|
+
The MIT License (MIT)
|
2
|
+
=====================
|
3
|
+
|
4
|
+
Copyright © `2009-2021` `Wolf Software Limited`
|
5
|
+
|
6
|
+
Permission is hereby granted, free of charge, to any person
|
7
|
+
obtaining a copy of this software and associated documentation
|
8
|
+
files (the “Software”), to deal in the Software without
|
9
|
+
restriction, including without limitation the rights to use,
|
10
|
+
copy, modify, merge, publish, distribute, sublicense, and/or sell
|
11
|
+
copies of the Software, and to permit persons to whom the
|
12
|
+
Software is furnished to do so, subject to the following
|
13
|
+
conditions:
|
14
|
+
|
15
|
+
The above copyright notice and this permission notice shall be
|
16
|
+
included in all copies or substantial portions of the Software.
|
17
|
+
|
18
|
+
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND,
|
19
|
+
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
|
20
|
+
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
21
|
+
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
|
22
|
+
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
|
23
|
+
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
24
|
+
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
|
25
|
+
OTHER DEALINGS IN THE SOFTWARE.
|
data/README.md
ADDED
@@ -0,0 +1,121 @@
|
|
1
|
+
<h1 align="center">
|
2
|
+
<a href="https://github.com/WolfSoftware">
|
3
|
+
<img src="https://raw.githubusercontent.com/WolfSoftware/branding/master/images/general/banners/64/black-and-white.png" alt="Wolf Software Logo" />
|
4
|
+
</a>
|
5
|
+
<br>
|
6
|
+
Github Lister Core Library
|
7
|
+
</h1>
|
8
|
+
|
9
|
+
<p align="center">
|
10
|
+
<a href="https://travis-ci.com/DevelopersToolbox/github-lister-core">
|
11
|
+
<img src="https://img.shields.io/travis/com/DevelopersToolbox/github-lister-core/master?style=for-the-badge&logo=travis" alt="Build Status">
|
12
|
+
</a>
|
13
|
+
<a href="https://github.com/DevelopersToolbox/github-lister-core/releases/latest">
|
14
|
+
<img src="https://img.shields.io/github/v/release/DevelopersToolbox/github-lister-core?color=blue&style=for-the-badge&logo=github&logoColor=white&label=Latest%20Release" alt="Release">
|
15
|
+
</a>
|
16
|
+
<a href="https://github.com/DevelopersToolbox/github-lister-core/releases/latest">
|
17
|
+
<img src="https://img.shields.io/github/commits-since/DevelopersToolbox/github-lister-core/latest.svg?color=blue&style=for-the-badge&logo=github&logoColor=white" alt="Commits since release">
|
18
|
+
</a>
|
19
|
+
<a href="LICENSE.md">
|
20
|
+
<img src="https://img.shields.io/badge/license-MIT-blue?style=for-the-badge&logo=read-the-docs&logoColor=white" alt="Software License">
|
21
|
+
</a>
|
22
|
+
<br>
|
23
|
+
<a href=".github/CODE_OF_CONDUCT.md">
|
24
|
+
<img src="https://img.shields.io/badge/Code%20of%20Conduct-blue?style=for-the-badge&logo=read-the-docs&logoColor=white" />
|
25
|
+
</a>
|
26
|
+
<a href=".github/CONTRIBUTING.md">
|
27
|
+
<img src="https://img.shields.io/badge/Contributing-blue?style=for-the-badge&logo=read-the-docs&logoColor=white" />
|
28
|
+
</a>
|
29
|
+
<a href=".github/SECURITY.md">
|
30
|
+
<img src="https://img.shields.io/badge/Report%20Security%20Concern-blue?style=for-the-badge&logo=read-the-docs&logoColor=white" />
|
31
|
+
</a>
|
32
|
+
<a href=".github/SUPPORT.md">
|
33
|
+
<img src="https://img.shields.io/badge/Get%20Support-blue?style=for-the-badge&logo=read-the-docs&logoColor=white" />
|
34
|
+
</a>
|
35
|
+
</p>
|
36
|
+
|
37
|
+
## Overview
|
38
|
+
|
39
|
+
The gem aims to provide a simple, fast and, clean way to extract repository information from GitHub. It comes with several methods but it is intentionally limited to repository based information.
|
40
|
+
|
41
|
+
If you are looking for a GitHub API wrapper we suggest looking at the [Octokit](https://rubygems.org/gems/octokit) gem, which is the tool we have used in this project.
|
42
|
+
|
43
|
+
This was written to work as the lookup core for some other projects, but we felt people may be able to make use of it as a standalone library.
|
44
|
+
|
45
|
+
To make the lookups as fast as possible we make extensive use of the [Parallel](https://rubygems.org/gems/parallel) gem to run as many API queries as possible in parallel.
|
46
|
+
|
47
|
+
## Usage
|
48
|
+
|
49
|
+
```ruby
|
50
|
+
require 'github-lister-core'
|
51
|
+
|
52
|
+
# Not a real token
|
53
|
+
options = { :token => '1234567890abcdef1234567890abcdef1234567890abcdef' }
|
54
|
+
|
55
|
+
GithubListerCore.user_repos(options)
|
56
|
+
```
|
57
|
+
|
58
|
+
> You can access all of the methods using the alias GCL instead of GithubListerCore
|
59
|
+
|
60
|
+
### Methods
|
61
|
+
|
62
|
+
| Function | Purpose |
|
63
|
+
| -------- | ------- |
|
64
|
+
| user\_repos | Details about all of the repositories owned by the user |
|
65
|
+
| org\_repos | Details about all repositories within an organisation |
|
66
|
+
| org\_members_repos | Details about all repositories in all organisations a user is a member of |
|
67
|
+
| all\_repos | user\_repos + user\_org\_repos |
|
68
|
+
| org\_membership | Details about all the organisation a user is a member of |
|
69
|
+
|
70
|
+
#### Method Returns
|
71
|
+
|
72
|
+
All of the exposed methods will return data in JSON format.
|
73
|
+
|
74
|
+
### Options
|
75
|
+
|
76
|
+
| Option Name | Purpose |
|
77
|
+
| ----------- | ------- |
|
78
|
+
| :token | The GitHub authentication token (require if no username) |
|
79
|
+
| :user or :username | The GitHub username to use when performing queries (If no username is given, the username of the current authenticates user will be used instead) |
|
80
|
+
| :org or :org_name | The name of the organisation to use when performing queries. (This is only used by the org_repos method and is required for this method) |
|
81
|
+
| :use_slugs | This will return only the repo name (:full_name) or the organisation name (:login) instead of the full details |
|
82
|
+
| :add_topics | This will add the repository topics to the details (Requires an additional look query per repo) |
|
83
|
+
| :add_latest_release | This will add information about the latest release to the details (Requires an additional look query per repo) |
|
84
|
+
| :add_releases | This will add information about releases to the repository (Requires an additional look query per repo) |
|
85
|
+
| :add_languages | This will add the repository languages to the details (Requires an additional look query per repo) |
|
86
|
+
|
87
|
+
> :user, :username, :org, :org_name can be either a single user/organisation name _OR_ a comma-separated list of user/organisation names _OR_ an array of user/organisation names. If more than one name is given, the results for all names will be merged together into one result set.
|
88
|
+
|
89
|
+
## Contributing
|
90
|
+
|
91
|
+
We are always happy for people to contribute, if you want to do so the following information should assist you in setting up a local dev environment.
|
92
|
+
|
93
|
+
Please keep in mind the purpose of this tool, it implements a very specific and narrow set of the GitHub API but this is by design, so we may not always accept pull requests if we feel they are taking the project too far beyond its designed scope.
|
94
|
+
|
95
|
+
### Setup
|
96
|
+
|
97
|
+
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
|
98
|
+
|
99
|
+
To install this gem onto your local machine, run `bundle exec rake install`.
|
100
|
+
|
101
|
+
### Testing
|
102
|
+
|
103
|
+
For local testing make sure that you run `bundle exec rspec spec` and then `rake install` to install the gem locally.
|
104
|
+
|
105
|
+
For further information please refer to the [contributing](.github/CONTRIBUTING.md) documentation.
|
106
|
+
|
107
|
+
## Contributors
|
108
|
+
|
109
|
+
<p>
|
110
|
+
<a href="https://github.com/TGWolf">
|
111
|
+
<img src="https://img.shields.io/badge/Wolf-black?style=for-the-badge" />
|
112
|
+
</a>
|
113
|
+
</p>
|
114
|
+
|
115
|
+
## Show Support
|
116
|
+
|
117
|
+
<p>
|
118
|
+
<a href="https://ko-fi.com/wolfsoftware">
|
119
|
+
<img src="https://img.shields.io/badge/Ko%20Fi-blue?style=for-the-badge&logo=ko-fi&logoColor=white" />
|
120
|
+
</a>
|
121
|
+
</p>
|
data/Rakefile
ADDED
data/VERSION.txt
ADDED
@@ -0,0 +1 @@
|
|
1
|
+
0.1.0
|
data/bin/console
ADDED
@@ -0,0 +1,14 @@
|
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
|
3
|
+
require 'bundler/setup'
|
4
|
+
require 'github/lister/core'
|
5
|
+
|
6
|
+
# You can add fixtures and/or initialization code here to make experimenting
|
7
|
+
# with your gem easier. You can also use a different console, if you like.
|
8
|
+
|
9
|
+
# (If you use this, don't forget to add pry to your Gemfile!)
|
10
|
+
# require "pry"
|
11
|
+
# Pry.start
|
12
|
+
|
13
|
+
require 'irb'
|
14
|
+
IRB.start(__FILE__)
|