github-search 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 62d7994a724738d0ea8c2af08b5ea162d32810cc
+  data.tar.gz: 32edb6b1077d6e9eeaf82517f4a76a31b3d7c339
+SHA512:
+  metadata.gz: dd5d8258ae51c2e63e04861369f46894f3e5fdf0218c880084dc9bd34f6824792e2a081943e142d325c67753e9644ece6126d3cbf5bbe47767eba8b68ec63bf7
+  data.tar.gz: aee86fb64032a79a56ce459c50a51256670f5b359e54c7457babcd2fdc39d0d52c071ea8d2a9dfc429862d8917b82a9294a25d29862d2e3535e9276ff35b52c5

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - "1.9.2"
+  - "1.9.3"
+  - "2.1.3"

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in githubsearch.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Laura Eck
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,250 @@
+# GithubSearch
+[![Build Status](https://travis-ci.org/Morred/github-search.svg?branch=master)](https://travis-ci.org/Morred/github-search) [![Code Climate](https://codeclimate.com/github/Morred/github-search/badges/gpa.svg)](https://codeclimate.com/github/Morred/github-search)
+
+A wrapper gem for the Github Search API.
+
+### General info
++ The GitHub Search API provides up to 1,000 results for each search.
++ The GitHub Search API has a custom rate limit. For requests using Basic Authentication, OAuth, or client ID and secret, you can make up to 30 requests per minute. For unauthenticated requests, the rate limit allows you to make up to 10 requests per minute.
++ For queries that exceed the time limit, the API returns the matches that were already found prior to the timeout, and the response has the incomplete_results property set to true.
+
+See the official documentation for the Github Search API here: https://developer.github.com/v3/search/
+
+## Table of Contents
+1. [Searching](https://github.com/Morred/github-search#searching)
+  + [Searching Issues](https://github.com/Morred/github-search#searching-issues)
+  + [Searching Repositories](https://github.com/Morred/github-search#searching-repositories)
+  + [Searching Users](https://github.com/Morred/github-search#searching-users)
+  + [Searching Code](https://github.com/Morred/github-search#searching-code)
+2. [Sorting and Ordering](https://github.com/Morred/github-search#sorting-and-ordering)
+  + [Sorting Issues](https://github.com/Morred/github-search#sorting-issues)
+  + [Sorting Repositories](https://github.com/Morred/github-search#sorting-repositories)
+  + [Sorting Users](https://github.com/Morred/github-search#sorting-users)
+  + [Ordering](https://github.com/Morred/github-search#ordering)
+3. [Installation](https://github.com/Morred/github-search#installation)
+
+## Searching
+
+Instantiate a new searcher, then use it to search, like so:
+
+```ruby
+github = GithubSearch::Searcher.new
+
+result = github.issues.search("test", "issue", repo: "Morred/github-search", label: "enhancement")
+```
+
+You can currently search issues, repositories and users.
+
+### Searching Issues
+
+Example:
+```ruby
+result = github.issues.search("test", "foo", repo: "Morred/github-search", language: "Ruby")
+```
+
+Search for any number of keywords as strings (such as "test" and "foo" in the above example) as well as search qualifiers (such as repo and language in the above example).
+
+#### Currently supported issue search qualifiers are:
+
+**assignee**  
+Finds issues or pull requests that are assigned to a certain user.  
+**author**  
+Finds issues or pull requests created by a certain user.  
+**closed**  
+Filters issues or pull requests based on the date when they were closed.  
+*Values: e.g. >2014-12-25, <=2015-01-17, 2019-02-03*  
+**commenter**  
+Finds issues or pull requests that a certain user commented on.  
+**comments**  
+Filters issues or pull requests based on the quantity of comments.  
+*Values: e.g. >500, 50..100*  
+**created**  
+Filters issues or pull requests based on date of creation.  
+*Values: e.g. >2014-12-25, <=2015-01-17, 2019-02-03*  
+**in**  
+Qualifies which fields are searched. With this qualifier you can restrict the search to just the title, body, comments, or any combination of these.  
+**involves**  
+Finds issues or pull requests that were either created by a certain user, assigned to that user, mention that user, or were commented on by that user.  
+**is**  
+Searches for items within repositories that match a certain state, such as open, closed, or merged.  
+*Values: open, closed, unmerged, merged, pr, issue*  
+**labels**  
+Filters issues or pull requests based on their labels.  
+**language**  
+Searches for issues or pull requests within repositories that match a certain language.  
+*Values: e.g. Ruby, C++, Swift*  
+**mentions**  
+Finds issues or pull requests that mention a certain user.  
+**merged**  
+Filters pull requests based on the date when they were merged.  
+*Values: e.g. >2014-12-25, <=2015-01-17, 2019-02-03*  
+**no**  
+Filters items missing certain metadata, such as label, milestone, or assignee.  
+*Values: label, milestone, assignee*  
+**repo**  
+Limits searches to a specific repository.  
+**state**  
+Filter issues or pull requests based on whether they’re open or closed.  
+*Values: open, closed*  
+**team**  
+For organizations you’re a member of, finds issues or pull requests that @mention a team within the organization.  
+**type**  
+With this qualifier you can restrict the search to issues or pull request only.  
+*Values: pr, issue*  
+**updated**  
+Filters issues or pull requests based on when they were last updated.  
+*Values: e.g. >2014-12-25, <=2015-01-17, 2019-02-03*  
+**user**  
+Limits searches to a specific user.
+
+### Searching Repositories
+
+Example:
+```ruby
+result = github.repositories.search("foo", user: "Morred", language: "Ruby")
+```
+
+Search for any number of keywords as strings (such as "foo" in the above example) as well as search qualifiers (such as user and language in the above example).
+
+#### Currently supported repository search qualifiers are:
+
+**created**
+Filters repositories based on date of creation.  
+*Values: e.g. >2014-12-25, <=2015-01-17, 2019-02-03*  
+**forks**  
+Filters repositories based on the number of forks, and/or whether forked repositories should be included in the results at all.  
+**in**  
+Qualifies which fields are searched. With this qualifier you can restrict the search to just the repository name, description, readme, or any combination of these.
+*Values: name, description, readme*  
+**language**  
+Searches repositories based on the language they’re written in.  
+*Values: e.g. Ruby, C++, Swift*  
+**pushed**  
+Filters repositories based on when they were last updated.  
+*Values: e.g. >2014-12-25, <=2015-01-17, 2019-02-03*  
+**size**  
+Finds repositories that match a certain size (in kilobytes).  
+**stars**  
+Searches repositories based on the number of stars.  
+**user**  
+Limits searches to a specific user.  
+
+### Searching Users
+
+Example:
+```ruby
+result = github.users.search("morred", repos: ">10", language: "Ruby")
+```
+
+Search for any number of keywords as strings (such as "morred" in the above example) as well as search qualifiers (such as repos and language in the above example).
+
+#### Currently supported user search qualifiers are:
+
+**created**  
+Filter users based on when they joined.  
+*Values: e.g. >2014-12-25, <=2015-01-17, 2019-02-03*  
+
+**followers**  
+Filter users based on the number of followers they have.  
+**in**  
+Qualifies which fields are searched. With this qualifier you can restrict the search to just the username, public email, full name, or any combination of these.  
+**language**  
+Search for users that have repositories that match a certain language.  
+*Values: e.g. Ruby, C++, Swift*  
+**location**  
+Filter users by the location indicated in their profile.  
+*Values: e.g. Germany, Tokyo*  
+**repos**  
+Filters users based on the number of repositories they have.
+*Values: e.g. 20, >10, <100*  
+**type**  
+With this qualifier you can restrict the search to just personal accounts or just organization accounts.  
+*Values: User, Organization*  
+
+### Searching Code  
+
+**TODO**  
+
+## Sorting and Ordering
+
+Example:
+```ruby
+result = github.repositories.search("test", user: "Morred", sort: :stars, order: :asc)
+```
+
+**By default, all results are sorted by best match. The default order is descending.**
+
+### Sorting Issues
+
+Issues can be sorted by:
+
+**comments**  
+Issues are sorted by comments count.
+
+**created**  
+Issues are sorted by their created_at date.
+
+**updated**  
+Issues are sorted by their updated_at date.
+
+### Sorting Repositories
+
+Repositories can be sorted by:
+
+**stars**  
+Repositories are sorted by stars count.
+
+**forks**  
+Repositories are sorted by forks count.
+
+**updated**  
+Somewhat counterintuitively, repositories are *not* sorted by updated_at, but instead by pushed_at.
+
+### Sorting Users
+
+Users can be sorted by:
+
+**followers**  
+Users are sorted by followers count.
+
+**repositories**  
+Users are sorted by repositories count.
+
+**joined**  
+Users are sorted by their joined_at date.
+
+### Ordering
+
+You can only order your search results when a sort parameter is provided.
+
+**asc**  
+Ascending order.
+
+**desc**  
+Descending order.
+
+The default order is descending. 
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'github-search'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install github-search
+
+## Contributing
+
+1. Fork it ( https://github.com/Morred/github-search/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.libs << "spec"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => 'test'
+

data/github-search.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'github-search/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "github-search"
+  spec.version       = GithubSearch::VERSION
+  spec.authors       = ["Laura Eck"]
+  spec.email         = ["laura.tatsutahime@gmail.com"]
+  spec.summary       = %q{A wrapper for the Github Search API}
+  spec.description   = %q{This gem wraps the Github Search API and allows you to search users, repositories and issues}
+  spec.homepage      = "https://github.com/Morred/github-search"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", '~> 5.5'
+  spec.add_development_dependency "vcr", "~> 2.9"
+  spec.add_development_dependency "webmock", "~> 1.20"
+
+  spec.add_dependency "faraday", "~> 0.9"
+  spec.add_dependency "json", "~> 1.8"
+end

data/lib/github-search.rb

@@ -0,0 +1,12 @@
+require "github-search/version"
+require "github-search/searcher"
+require "github-search/search_string_builder"
+require "github-search/issue"
+require "github-search/repository"
+require "github-search/user"
+
+module GithubSearch
+  
+  API_URL = "https://api.github.com/search"
+
+end

data/lib/github-search/issue.rb

@@ -0,0 +1,55 @@
+require 'faraday'
+require 'json'
+
+module GithubSearch
+  class Issue < Searcher
+    attr_reader :id,
+                :number,
+                :title,
+                :body,
+                :url,
+                :labels_url,
+                :comments_url,
+                :events_url,
+                :html_url,
+                :user,
+                :labels,
+                :state,
+                :locked,
+                :assignee,
+                :milestone,
+                :comments,
+                :created_at,
+                :updated_at,
+                :closed_at,
+                :score
+
+    def initialize(attributes)
+      @id             = attributes["id"]
+      @number         = attributes["number"]
+      @title          = attributes["title"]
+      @body           = attributes["body"]
+      @url            = attributes["url"]
+      @labels_url     = attributes["labels_url"]
+      @comments_url   = attributes["comments_url"]
+      @events_url     = attributes["events_url"]
+      @html_url       = attributes["html_url"]
+      @user           = attributes["user"]
+      @labels         = attributes["labels"]
+      @state          = attributes["state"]
+      @locked         = attributes["locked"]
+      @assignee       = attributes["assignee"]
+      @milestone      = attributes["milestone"]
+      @comments       = attributes["comments"]
+      @created_at     = attributes["created_at"]
+      @updated_at     = attributes["updated_at"]
+      @closed_at      = attributes["closed_at"]
+      @score          = attributes["score"]
+    end
+
+    def self.sort_options
+      [:comments, :created, :updated]
+    end
+
+  end
+end

data/lib/github-search/repository.rb

@@ -0,0 +1,151 @@
+require 'faraday'
+require 'json'
+
+module GithubSearch
+  class Repository < Searcher
+    attr_reader :id,
+                :name,
+                :full_name,
+                :owner,
+                :private,
+                :html_url,
+                :description,
+                :fork,
+                :url,
+                :forks_url,
+                :keys_url,
+                :collaborators_url,
+                :teams_url,
+                :hooks_url,
+                :issue_events_url,
+                :events_url,
+                :assignees_url,
+                :branches_url,
+                :tags_url,
+                :blobs_url,
+                :git_tags_url,
+                :git_refs_url,
+                :trees_url,
+                :statuses_url,
+                :languages_url,
+                :stargazers_url,
+                :contributors_url,
+                :subscribers_url,
+                :subscription_url,
+                :commits_url,
+                :git_commits_url,
+                :comments_url,
+                :issue_comment_url,
+                :contents_url,
+                :compare_url,
+                :merges_url,
+                :archive_url,
+                :downloads_url,
+                :issues_url,
+                :pulls_url,
+                :milestones_url,
+                :notifications_url,
+                :labels_url,
+                :releases_url,
+                :created_at,
+                :updated_at,
+                :pushed_at,
+                :git_url,
+                :ssh_url,
+                :clone_url,
+                :svn_url,
+                :homepage,
+                :size,
+                :stargazers_count,
+                :watchers_count,
+                :language,
+                :has_issues,
+                :has_downloads,
+                :has_wiki,
+                :has_pages,
+                :forks_count,
+                :mirror_url,
+                :open_issues_count,
+                :forks,
+                :open_issues,
+                :watchers,
+                :default_branch,
+                :score
+
+    def initialize(attributes)
+      @id                   = attributes["id"]
+      @name                 = attributes["name"]
+      @full_name            = attributes["full_name"]
+      @owner                = attributes["owner"]
+      @private              = attributes["private"]
+      @html_url             = attributes["html_url"]
+      @description          = attributes["description"]
+      @fork                 = attributes["fork"]
+      @url                  = attributes["url"]
+      @forks_url            = attributes["forks_url"]
+      @keys_url             = attributes["keys_url"]
+      @collaborators_url    = attributes["collaborators_url"]
+      @teams_url            = attributes["teams_url"]
+      @hooks_url            = attributes["hooks_url"]
+      @issue_events_url     = attributes["issue_events_url"]
+      @events_url           = attributes["events_url"]
+      @assignees_url        = attributes["assignees_url"]
+      @branches_url         = attributes["branches_url"]
+      @tags_url             = attributes["tags_url"]
+      @blobs_url            = attributes["blobs_url"]
+      @git_tags_url         = attributes["git_tags_url"]
+      @git_refs_url         = attributes["git_refs_url"]
+      @trees_url            = attributes["trees_url"]
+      @statuses_url         = attributes["statuses_url"]
+      @languages_url        = attributes["languages_url"]
+      @stargazers_url       = attributes["stargazers_url"]
+      @contributors_url     = attributes["contributors_url"]
+      @subscribers_url      = attributes["subscribers_url"]
+      @subscription_url     = attributes["subscription_url"]
+      @commits_url          = attributes["commits_url"]
+      @git_commits_url      = attributes["git_commits_url"]
+      @comments_url         = attributes["comments_url"]
+      @issue_comment_url    = attributes["issue_comment_url"]
+      @contents_url         = attributes["contents_url"]
+      @compare_url          = attributes["compare_url"]
+      @merges_url           = attributes["merges_url"]
+      @archive_url          = attributes["archive_url"]
+      @downloads_url        = attributes["downloads_url"]
+      @issues_url           = attributes["issues_url"]
+      @pulls_url            = attributes["pulls_url"]
+      @milestones_url       = attributes["milestones_url"]
+      @notifications_url    = attributes["notifications_url"]
+      @labels_url           = attributes["labels_url"]
+      @releases_url         = attributes["releases_url"]
+      @created_at           = attributes["created_at"]
+      @updated_at           = attributes["updated_at"]
+      @pushed_at            = attributes["pushed_at"]
+      @git_url              = attributes["git_url"]
+      @ssh_url              = attributes["ssh_url"]
+      @clone_url            = attributes["clone_url"]
+      @svn_url              = attributes["svn_url"]
+      @homepage             = attributes["homepage"]
+      @size                 = attributes["size"]
+      @stargazers_count     = attributes["stargazers_count"]
+      @watchers_count       = attributes["watchers_count"]
+      @language             = attributes["language"]
+      @has_issues           = attributes["has_issues"]
+      @has_downloads        = attributes["has_downloads"]
+      @has_wiki             = attributes["has_wiki"]
+      @has_pages            = attributes["has_pages"]
+      @forks_count          = attributes["forks_count"]
+      @mirror_url           = attributes["mirror_url"]
+      @open_issues_count    = attributes["open_issues_count"]
+      @forks                = attributes["forks"]
+      @open_issues          = attributes["open_issues"]
+      @watchers             = attributes["watchers"]  
+      @default_branch       = attributes["default_branch"]   
+      @score                = attributes["score"]
+    end
+
+    def self.sort_options
+      [:stars, :forks, :updated]
+    end
+
+  end
+end