fue 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5fd514e2bbe05ce162d9d7b260ff91307419d7cc
+  data.tar.gz: b9aeb1d8ea34f127c610f3287597b1ba0d366149
+SHA512:
+  metadata.gz: e0fa226b7581601e4fd81932001945c222d37011ce3a2ecf59a6ef195533c05ba81df4ecc091bc64a67d62210bd019bf8bf1e29e05cddb91e66f0f9b15b9e35b
+  data.tar.gz: 027792f0c9651167dbda104386c00d9fce63094895c969f25a748942d5182e0453600cbb4619d52a2a9cb89aca9685950b48ef2a258aef3557b0a2f72c7fba97

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+### 0.1.0 (2018/8/14)
+
+* Initial public release, with help from [@orta](https://github.com/orta) - [@dblock](https://github.com/dblock).

data/CONTRIBUTING.md

@@ -0,0 +1,125 @@
+# Contributing to Fue
+
+This project is work of [many contributors](https://github.com/dblock/fue/graphs/contributors).
+
+You're encouraged to submit [pull requests](https://github.com/dblock/fue/pulls), [propose features and discuss issues](https://github.com/dblock/fue/issues).
+
+In the examples below, substitute your Github username for `contributor` in URLs.
+
+### Fork the Project
+
+Fork the [project on Github](https://github.com/dblock/fue) and check out your copy.
+
+```
+git clone https://github.com/contributor/fue.git
+cd fue
+git remote add upstream https://github.com/dblock/fue.git
+```
+
+### Bundle Install and Test
+
+Ensure that you can build the project and run tests.
+
+```
+bundle install
+bundle exec rake
+```
+
+## Contribute Code
+
+### Create a Topic Branch
+
+Make sure your fork is up-to-date and create a topic branch for your feature or bug fix.
+
+```
+git checkout master
+git pull upstream master
+git checkout -b my-feature-branch
+```
+
+### Write Tests
+
+Try to write a test that reproduces the problem you're trying to fix or describes a feature that you want to build. Add tests to [spec](spec).
+
+We definitely appreciate pull requests that highlight or reproduce a problem, even without a fix.
+
+### Write Code
+
+Implement your feature or bug fix.
+
+Ruby style is enforced with [Rubocop](https://github.com/bbatsov/rubocop). Run `bundle exec rubocop` and fix any style issues highlighted, auto-correct issues when possible with `bundle exec rubocop -a`. To silence generally ingored issues, including line lengths or code complexity metrics, run `bundle exec rubocop --auto-gen-config`.
+
+Make sure that `bundle exec rake` completes without errors.
+
+### Write Documentation
+
+Document any external behavior in the [README](README.md).
+
+### Update Changelog
+
+Add a line to [CHANGELOG](CHANGELOG.md) under *Next Release*. Don't remove *Your contribution here*.
+
+Make it look like every other line, including a link to the issue being fixed, your name and link to your Github account.
+
+### Commit Changes
+
+Make sure git knows your name and email address:
+
+```
+git config --global user.name "Your Name"
+git config --global user.email "contributor@example.com"
+```
+
+Writing good commit logs is important. A commit log should describe what changed and why.
+
+```
+git add ...
+git commit
+```
+
+### Push
+
+```
+git push origin my-feature-branch
+```
+
+### Make a Pull Request
+
+Go to https://github.com/contributor/fue and select your feature branch. Click the 'Pull Request' button and fill out the form. Pull requests are usually reviewed within a few days.
+
+### Update CHANGELOG Again
+
+Update the [CHANGELOG](CHANGELOG.md) with the pull request number. A typical entry looks as follows.
+
+```
+* [#123](https://github.com/dblock/fue/pull/123): Reticulated splines - [@contributor](https://github.com/contributor).
+```
+
+Amend your previous commit and force push the changes.
+
+```
+git commit --amend
+git push origin my-feature-branch -f
+```
+
+### Rebase
+
+If you've been working on a change for a while, rebase with upstream/master.
+
+```
+git fetch upstream
+git rebase upstream/master
+git push origin my-feature-branch -f
+```
+
+### Check on Your Pull Request
+
+Go back to your pull request after a few minutes and see whether it passed muster with Travis-CI. Everything should look green, otherwise fix issues and amend your commit as described above.
+
+### Be Patient
+
+It's likely that your change will not be merged and that the nitpicky maintainers will ask you to do more, or fix seemingly benign problems. Hang on there!
+
+## Thank You
+
+Please do know that we really appreciate and value your time and work. We love you, really.

data/LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2018 Daniel Doubrovkine.
+
+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,58 @@
+Fue
+===
+
+[![Gem Version](https://badge.fury.io/rb/fue.svg)](https://badge.fury.io/rb/fue)
+[![Build Status](https://travis-ci.org/dblock/fue.svg)](https://travis-ci.org/dblock/fue)
+
+Find an e-mail address of a Github user from their commit log.
+
+## Usage
+
+```
+gem install fue
+```
+
+#### Get a Github Access Token
+
+Obtain a Github access token from [here](https://github.com/settings/tokens) with `public_repo` permissions. See [help](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line) for more information. Set the token as `GITHUB_ACCESS_TOKEN`.
+
+#### Find Someone's Email
+
+The `find` command looks through user's initial repo commits.
+
+```
+GITHUB_ACCESS_TOKEN=token fue find defunkt
+
+Chris Wanstrath <chris@ozmm.org>
+Chris Wanstrath <chris@github.com>
+```
+
+#### Specify More Depth
+
+By default the code looks at the last 10 repos. You can have more depth.
+
+```
+GITHUB_ACCESS_TOKEN=token fue find --depth=100 defunkt
+
+Chris Wanstrath <chris@ozmm.org>
+Chris Wanstrath <chris@github.com>
+defunkt <chris@ozmm.org>
+```
+
+#### Get Help
+
+```
+fue help
+```
+
+Displays additional options.
+
+## Contributing
+
+There're [a few feature requests and known issues](https://github.com/dblock/fue/issues). Please contribute! See [CONTRIBUTING](CONTRIBUTING.md).
+
+## Copyright and License
+
+Copyright (c) 2018, Daniel Doubrovkine, [Artsy](http://artsy.github.io), with help from [Orta](https://github.com/orta).
+
+This project is licensed under the [MIT License](LICENSE.md).

data/bin/fue

@@ -0,0 +1,38 @@
+#!/usr/bin/env ruby
+require 'gli'
+require 'fue'
+require 'graphlient'
+
+class App
+  extend GLI::App
+
+  program_desc "Find a Github user's e-mail address."
+
+  switch %i[v verbose], desc: 'Produce verbose output.', default_value: false
+
+  arguments :strict
+  subcommand_option_handling :normal
+
+  pre do |global_options, _command, options, _args|
+    options = global_options.dup
+    token = options.delete(:token)
+    $fue = Fue::Finder.new(token, options)
+  end
+
+  default_command :help
+
+  desc "Find a Github user's e-mail address."
+  arg 'username'
+  command :find do |c|
+    c.flag %i[d depth], desc: 'Maximum search depth.', default_value: 10
+    c.flag %i[t token], required: true, desc: 'Github access token.', default_value: ENV['GITHUB_ACCESS_TOKEN']
+    c.action do |global_options, options, args|
+      username = args.first
+      puts "Searching for e-mail address for '#{username}' at max depth of #{options[:depth]} ..." if global_options[:verbose]
+      puts $fue.emails(options.merge(username: username))
+      exit_now! nil, 0
+    end
+  end
+end
+
+exit App.run(ARGV)

data/lib/fue/finder.rb

@@ -0,0 +1,74 @@
+module Fue
+  class Finder
+    attr_reader :token
+
+    def initialize(token, _options = {})
+      @token = token
+    end
+
+    def author_id(username)
+      query = <<-GRAPHQL
+        query($login: String!) {
+          user(login: $login) {
+            id
+          }
+        }
+      GRAPHQL
+      graphql_client.query(query, login: username).data.user.id
+    end
+
+    def emails(options = {})
+      query = <<-GRAPHQL
+        query($login: String!, $author_id: ID!, $depth: Int!) {
+          user(login: $login) {
+            repositories(last: $depth, isFork:false, privacy: PUBLIC) {
+              edges {
+                node {
+                  defaultBranchRef {
+                    target {
+                      ... on Commit {
+                        history(first: 1, author: { id: $author_id }) {
+                          nodes {
+                            author {
+                              email
+                              name
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      GRAPHQL
+
+      query_options = {
+        login: options[:username],
+        author_id: author_id(options[:username]),
+        depth: (options[:depth] || 10).to_i
+      }
+
+      graphql_client.query(query, query_options).data.user.repositories.edges.map do |edge|
+        next unless edge.node.default_branch_ref
+        edge.node.default_branch_ref.target.history.nodes.map do |node|
+          "#{node.author.name} <#{node.author.email}>"
+        end
+      end.flatten.compact.uniq
+    end
+
+    private
+
+    def graphql_client
+      @graphql_client ||= Graphlient::Client.new(
+        'https://api.github.com/graphql',
+        headers: {
+          'Authorization' => "Bearer #{token}",
+          'Content-Type' => 'application/json'
+        }
+      )
+    end
+  end
+end

data/lib/fue/version.rb

@@ -0,0 +1,3 @@
+module Fue
+  VERSION = '0.1.0'.freeze
+end

data/lib/fue.rb

@@ -0,0 +1,2 @@
+require 'fue/version'
+require 'fue/finder'

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: fue
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Daniel Doubrovkine
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-08-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: graphlient
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+description: 
+email: dblock@dblock.org
+executables:
+- fue
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CONTRIBUTING.md
+- LICENSE.md
+- README.md
+- bin/fue
+- lib/fue.rb
+- lib/fue/finder.rb
+- lib/fue/version.rb
+homepage: http://github.com/dblock/fue
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.12
+signing_key: 
+specification_version: 4
+summary: Find an e-mail address of a Github user.
+test_files: []