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 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
@@ -0,0 +1,5 @@
1
+ #
2
+ # These owners will be the default owners for everything in the repo.
3
+ #
4
+ * @TGWolf
5
+
@@ -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.
@@ -0,0 +1,4 @@
1
+ # Funding
2
+ # https://help.github.com/en/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository
3
+
4
+ ko_fi: wolfsoftware
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: Ask a question
3
+ about: Feel free to ask us a question
4
+ title: ''
5
+ labels: 'question'
6
+ assignees: 'TGWolf'
7
+
8
+ ---
9
+
10
+ **What would you like to know?**
@@ -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 #
@@ -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.
@@ -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
@@ -0,0 +1,17 @@
1
+ **/ab-results*
2
+
3
+ /.bundle/
4
+ /.yardoc
5
+ /_yardoc/
6
+ /coverage/
7
+ /doc/
8
+ /pkg/
9
+ /spec/reports/
10
+ /tmp/
11
+
12
+ # rspec failure tracking
13
+ .rspec_status
14
+
15
+ /Gemfile.lock
16
+
17
+ *.gem
data/.reek.yml ADDED
@@ -0,0 +1,10 @@
1
+ ---
2
+ detectors:
3
+ TooManyStatements:
4
+ max_statements: 10
5
+ TooManyMethods:
6
+ max_methods: 20
7
+ DataClump:
8
+ enabled: false
9
+ NilCheck:
10
+ enabled: false
data/.rspec ADDED
@@ -0,0 +1,3 @@
1
+ --format documentation
2
+ --color
3
+ --require spec_helper
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
@@ -0,0 +1,6 @@
1
+ source 'https://rubygems.org'
2
+
3
+ git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
4
+
5
+ # Specify your gem's dependencies in slackit.gemspec
6
+ gemspec
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
@@ -0,0 +1,6 @@
1
+ require 'bundler/gem_tasks'
2
+ require 'rspec/core/rake_task'
3
+
4
+ RSpec::Core::RakeTask.new(:spec)
5
+
6
+ task :default => :spec
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__)