fue 0.1.2 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72a7e11f7580c260950fb8f48393fe791cfdf1261c3d32afd97ceb76d87a8e64
-  data.tar.gz: 97998c5b26b45a9dbbae295a930764bdc08ee9d394f109dd3166f82ef8542dca
+  metadata.gz: 6784a7e45c93b1e0622f4e719f58c541246a15fd64927245c97bd0f03574252a
+  data.tar.gz: ce2c2b1ef2f06c9cdd56d638ab4bbd7df8e1497ffb26190514d1e4b9f0ab621f
 SHA512:
-  metadata.gz: cc2b85d03975f63b4328abc85aa39416c4e739b0d67f07087242e85b5a87df1585c99550350365a184d670cbef550fc3c92ca36b00ef1b1da39969ee2300b842
-  data.tar.gz: 2a29212ce1dde69ed9ed1639a0d2c137ba682d3cacb3217ff935bc0636e1e244d9d3d5e98b0788ed17c149b400865f5edda22befeec18a0bb8319dc31ce7070f
+  metadata.gz: d503619065aab23dfd208305f1aafd9b8869538662397e6e471008be90c9713d510ac6e6af3ac5bfe2f1c392514749fa7eee8bd175aac2604da6e2223bb41ff4
+  data.tar.gz: 4d9ee34e80d5d031b291c4318fdab7733f95a5f5cf19e956078212b0a83e3700f54ee0e5227ee1635dcc2e0169e3d2a74d605a5db118f42d061e3ff0f17631b5

data/CHANGELOG.md

@@ -1,5 +1,24 @@
-### 0.1.2 (Next)
+### 0.3.1 (Next)
 
+* [#29](https://github.com/dblock/fue/issues/29): Fix: `error: can't modify frozen String` - [@dblock](https://github.com/dblock).
+
+### 0.3.0 (2020/05/22)
+
+* [#25](https://github.com/dblock/fue/pull/25): Added `contributors`, find repo contributors' e-mails - [@dblock](https://github.com/dblock).
+* [#12](https://github.com/dblock/fue/issues/12): Added explicit ruby call to run fue - [@SYNstack](https://github.com/SYNstack).
+* [#13](https://github.com/dblock/fue/issues/13): Changed shell tests to be OS-neutral - [@SYNstack](https://github.com/SYNstack).
+* [#16](https://github.com/dblock/fue/issues/16): Setup Windows CI - [@SYNstack](https://github.com/synstack).
+* [#17](https://github.com/dblock/fue/issues/19): Fix open-ended dependencies in gemspec - [@SYNstack](https://github.com/synstack).
+
+### 0.2.1 (2018/8/23)
+
+* [#2](https://github.com/dblock/fue/issues/2): Prompt to authenticate with Github - [@dblock](https://github.com/dblock).
+* [#7](https://github.com/dblock/fue/issues/7): Display version - [@dblock](https://github.com/dblock).
+
+### 0.2.0 (2018/8/22)
+
+* [#6](https://github.com/dblock/fue/issues/6): Configure max depth and breadth separately - [@dblock](https://github.com/dblock).
+* [#5](https://github.com/dblock/fue/issues/5): Iterate over more than 100 repositories - [@dblock](https://github.com/dblock).
 * [#5](https://github.com/dblock/fue/issues/5): Fix error message and clarify max depth - [@dblock](https://github.com/dblock).
 
 ### 0.1.1 (2018/8/14)

data/CONTRIBUTING.md

@@ -4,11 +4,11 @@ This project is work of [many contributors](https://github.com/dblock/fue/graphs
 
 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.
+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.
+Fork the [project on GitHub](https://github.com/dblock/fue) and check out your copy.
 
 ```
 git clone https://github.com/contributor/fue.git
@@ -47,7 +47,7 @@ We definitely appreciate pull requests that highlight or reproduce a problem, ev
 
 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`.
+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 ignored issues, including line lengths or code complexity metrics, run `bundle exec rubocop --auto-gen-config`.
 
 Make sure that `bundle exec rake` completes without errors.
 

data/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2018 Daniel Doubrovkine.
+Copyright (c) 2018-2020 Daniel Doubrovkine.
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -3,8 +3,11 @@ 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)
+[![Build status](https://ci.appveyor.com/api/projects/status/github/dblock/fue?branch=master&svg=true)](https://ci.appveyor.com/project/dblock/fue)
 
-Find an e-mail address of a Github user from their commit log.
+Find e-mail addresses of a Github users from their commit logs.
+
+Fue is short for "Finding Unicorn Engineers".
 
 ![](images/fue.gif)
 
@@ -14,34 +17,45 @@ Find an e-mail address of a Github user from their commit log.
 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`.
+### Commands
 
 #### Find Someone's Email
 
-The `find` command looks through user's initial repo commits.
+The `find` command looks through user's initial repository commits.
 
 ```
-GITHUB_ACCESS_TOKEN=token fue find defunkt
+$ fue --verbose find defunkt
 
 Chris Wanstrath <chris@ozmm.org>
 Chris Wanstrath <chris@github.com>
 ```
 
+#### Find All Repo Contributors' Emails
+
+The `contributors` command looks through a git log of contributors, then fetches their e-mails.
+
+```
+$ fue --verbose contributors defunkt/colored
+
+defunkt: Chris Wanstrath <chris@ozmm.org>
+kch: Caio Chassot <kch@users.noreply.github.com>
+```
+
+### Options
+
 #### Specify More Depth
 
-By default the code looks at the last 10 repos. You can have more depth, up to 100 (a limit enforced by Github).
+By default the code looks at 1 commit from the last 10 repositories. You can look at more repositories (breadth) and more commits (depth). The maximum value for depth is 100, enforced by Github. Fue will iterate over a number of repositories larger than 100.
 
 ```
-GITHUB_ACCESS_TOKEN=token fue find --depth=100 defunkt
+$ fue find --breadth=100 --depth=5 defunkt
 
 Chris Wanstrath <chris@ozmm.org>
 Chris Wanstrath <chris@github.com>
 defunkt <chris@ozmm.org>
 ```
 
-#### Get Help
+### Get Help
 
 ```
 fue help
@@ -49,12 +63,41 @@ fue help
 
 Displays additional options.
 
+### Access Tokens
+
+Fue will prompt you for Github credentials and 2FA, if enabled.
+
+```
+$ fue find defunkt
+Enter dblock's GitHub password (never stored): ******************
+Enter GitHub 2FA code: ******
+Token saved to keychain.
+```
+
+The access token will be generated with `public_repo` scope and stored in the keychain. It can be later deleted from [here](https://github.com/settings/tokens). You can also skip the prompts and use a previously obtained token with `-t` or by setting the `GITHUB_ACCESS_TOKEN` environment variable.
+
+See [Creating a Personal Access Token for the Command Line](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line) for more information about personal tokens.
+
+## Debugging
+
+If you run into an unexpected error, try getting a stack trace with `GLI_DEBUG=true`.
+
+```
+$ GLI_DEBUG=true fue find dblock
+
+FrozenError: can't modify frozen String
+  /Users/dblock/source/dblock/fue/lib/fue/auth.rb:97:in `get_secure'
+  /Users/dblock/source/dblock/fue/lib/fue/auth.rb:80:in `get_password'
+  /Users/dblock/source/dblock/fue/lib/fue/auth.rb:50:in `password'
+  /Users/dblock/source/dblock/fue/lib/fue/auth.rb:59:in `block in github'
+```
+
 ## Contributing
 
-There're [a few feature requests and known issues](https://github.com/dblock/fue/issues). Please contribute! See [CONTRIBUTING](CONTRIBUTING.md).
+There are [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).
+Copyright (c) 2018-2020, 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

@@ -1,35 +1,67 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
+
 require 'gli'
 require 'fue'
-require 'graphlient'
 
 class App
   extend GLI::App
 
-  program_desc "Find a Github user's e-mail address."
+  program_desc "Find a GitHub user's e-mail address."
+  version Fue::VERSION
 
   switch %i[v verbose], desc: 'Produce verbose output.', default_value: false
-  flag %i[t token], desc: 'Github access token.', default_value: ENV['GITHUB_ACCESS_TOKEN']
+  flag %i[t token], desc: 'GitHub access token.', default_value: ENV['GITHUB_ACCESS_TOKEN']
+  flag %i[u username], desc: 'GitHub username.', default_value: Fue::Auth.instance.username
 
   arguments :strict
   subcommand_option_handling :normal
 
   pre do |global_options, _command, options, _args|
     options = global_options.dup
-    token = options.delete(:token)
+    token = options.delete(:token) || Fue::Auth.instance.token
     $fue = Fue::Finder.new(token, options)
   end
 
   default_command :help
 
-  desc "Find a Github user's e-mail address."
+  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[d depth], desc: 'Maximum search depth in each repository.', default_value: 1
+    c.flag %i[b breadth], desc: 'Maximum number of repositories to search.', default_value: 10
     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))
+      options[:depth] = options[:depth].to_i
+      options[:breadth] = options[:breadth].to_i
+      if global_options[:verbose]
+        puts "Searching for e-mail address for '#{username}' " \
+             "in the first #{options[:depth].to_i > 1 ? "#{options[:depth]} commits" : 'commit'} " \
+             "of #{options[:breadth]} most recent repositor#{options[:breadth] == 1 ? 'y' : 'ies'} ..."
+      end
+      puts $fue.emails(options.merge(username: username, verbose: global_options[:verbose]))
+      exit_now! nil, 0
+    end
+  end
+
+  desc "Find a GitHub repo contributors' e-mail addresses."
+  arg 'repo'
+  command :contributors do |c|
+    c.flag %i[d depth], desc: 'Maximum search depth in each repository for a given user.', default_value: 1
+    c.flag %i[b breadth], desc: 'Maximum number of repositories to search.', default_value: 10
+    c.action do |global_options, options, args|
+      repo = args.first
+      options[:depth] = options[:depth].to_i
+      options[:breadth] = options[:breadth].to_i
+      if global_options[:verbose]
+        puts "Searching for contributors' e-mail addresses in '#{repo}' " \
+             "in the first #{options[:depth].to_i > 1 ? "#{options[:depth]} commits" : 'commit'} " \
+             "of #{options[:breadth]} most recent repositor#{options[:breadth] == 1 ? 'y' : 'ies'} ..."
+      end
+      contributor_emails = $fue.contributors(options.merge(repo: repo, verbose: global_options[:verbose]))
+      contributor_emails.each_pair do |username, emails|
+        puts "#{username}: #{emails.join(', ')}"
+      end
       exit_now! nil, 0
     end
   end

data/lib/fue.rb

@@ -1,2 +1,12 @@
+# frozen_string_literal: true
+
+require 'graphlient'
+require 'github_api'
+require 'open3'
+require 'English'
+
 require 'fue/version'
+require 'fue/shell'
 require 'fue/finder'
+require 'fue/security'
+require 'fue/auth'

data/lib/fue/auth.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+module Fue
+  class Auth
+    def self.instance
+      @instance ||= new
+    end
+
+    def token
+      stored_options = { username: username, server: 'github.com', label: 'fue' }
+      stored_token = Fue::Security.get(stored_options)
+      unless stored_token
+        stored_token = github_token
+        Fue::Security.store!(stored_options.merge(password: stored_token))
+        puts 'Token saved to keychain.'
+      end
+      stored_token
+    end
+
+    def username
+      @username ||= begin
+        username = get_git_username&.chomp
+        username = get_username if username.nil? || username.empty?
+        username
+      end
+    end
+
+    private
+
+    def get_git_username
+      Fue::Shell.system!('git config user.name')
+    rescue RuntimeError
+      nil
+    end
+
+    def github_token(code = nil)
+      github(code).auth.create(scopes: ['public_repo'], note: note).token
+    rescue Github::Error::Unauthorized => e
+      case e.response_headers['X-GitHub-OTP']
+      when /required/
+        github_token(get_code)
+      else
+        raise e
+      end
+    rescue Github::Error::UnprocessableEntity => e
+      raise e, 'A fue token already exists! Please revoke all previously-generated fue personal access tokens at https://github.com/settings/tokens.'
+    end
+
+    def password
+      @password ||= get_password
+    end
+
+    def note
+      "Fui (https://github.com/dblock/fue) on #{Socket.gethostname}"
+    end
+
+    def github(code = nil)
+      Github.new do |config|
+        config.basic_auth = [username, password].join(':')
+        if code
+          config.connection_options = {
+            headers: {
+              'X-GitHub-OTP' => code
+            }
+          }
+        end
+      end
+    end
+
+    def get_username
+      print 'Enter GitHub username: '
+      username = $stdin.gets
+      username&.chomp
+    rescue Interrupt => e
+      raise e, 'ctrl + c'
+    end
+
+    def get_password
+      print "Enter #{username}'s GitHub password (never stored): "
+      get_secure
+    end
+
+    def get_code
+      print 'Enter GitHub 2FA code: '
+      get_secure
+    end
+
+    def get_secure
+      current_tty = `stty -g`
+      system 'stty raw -echo -icanon isig' if $CHILD_STATUS.success?
+      input = String.new
+      while (char = $stdin.getbyte) && !((char == 13) || (char == 10))
+        if (char == 127) || (char == 8)
+          input[-1, 1] = '' unless input.empty?
+        else
+          $stdout.write '*'
+          input << char.chr
+        end
+      end
+      print "\r\n"
+      input
+    rescue Interrupt => e
+      raise e, 'ctrl + c'
+    ensure
+      system "stty #{current_tty}" unless current_tty.empty?
+    end
+  end
+end

data/lib/fue/finder.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Fue
   class Finder
     attr_reader :token
@@ -19,20 +21,18 @@ module Fue
 
     def emails(options = {})
       query = <<-GRAPHQL
-        query($login: String!, $author_id: ID!, $depth: Int!) {
+        query($login: String!, $author_id: ID!, $depth: Int!, $breadth: Int!, $cursor: String) {
           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
-                            }
+            repositories(last: $breadth, after: $cursor, isFork:false, privacy: PUBLIC) {
+              nodes {
+                defaultBranchRef {
+                  target {
+                    ... on Commit {
+                      history(first: $depth, author: { id: $author_id }) {
+                        nodes {
+                          author {
+                            email
+                            name
                           }
                         }
                       }
@@ -40,23 +40,108 @@ module Fue
                   }
                 }
               }
+              pageInfo {
+                startCursor
+              }
             }
           }
         }
       GRAPHQL
 
+      # max number of repositories to search
+      max_breadth = options[:breadth] || 10
+
       query_options = {
         login: options[:username],
         author_id: author_id(options[:username]),
-        depth: (options[:depth] || 10).to_i
+        # max number of commits to look into
+        depth: options[:depth] || 1
       }
 
-      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}>"
+      $stdout.write "Searching for emails for #{options[:username]} ." if options[:verbose]
+
+      emails = Set.new
+
+      loop do
+        query_options[:breadth] = [max_breadth, 100].min
+        response = graphql_client.query(query, query_options)
+        repositories = response&.data&.user&.repositories
+        repositories&.nodes&.each do |history|
+          default_history = history.default_branch_ref&.target&.history
+          default_history&.nodes&.each do |node|
+            emails << "#{node.author.name} <#{node.author.email}>"
+          end
         end
-      end.flatten.compact.uniq
+        query_options[:cursor] = repositories&.page_info&.start_cursor
+        break unless query_options[:cursor]
+
+        max_breadth -= 100
+        break if max_breadth <= 0
+
+        $stdout.write '.' if options[:verbose]
+      end
+
+      puts " found #{emails.size} email address#{emails.size == 1 ? '' : 'es'}." if options[:verbose]
+
+      emails.to_a
+    end
+
+    def contributors(options = {})
+      query = <<-GRAPHQL
+        query($owner: String!, $name: String!, $cursor: String) {
+          repository(owner: $owner, name: $name) {
+            defaultBranchRef {
+              target {
+                ... on Commit {
+                  history(first: 100, after: $cursor) {
+                    nodes {
+                      author {
+                        user {
+                          login
+                        }
+                      }
+                    }
+                    pageInfo {
+                      endCursor
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      GRAPHQL
+
+      repo_owner, repo_name = options[:repo].split('/', 2)
+
+      query_options = {
+        owner: repo_owner,
+        name: repo_name
+      }
+
+      logins = Set.new
+
+      $stdout.write 'Fetching contributors .' if options[:verbose]
+
+      loop do
+        response = graphql_client.query(query, query_options)
+        history = response&.data&.repository&.default_branch_ref&.target&.history
+        history&.nodes&.each do |node|
+          login = node.author.user&.login
+          logins << login if login
+        end
+        query_options[:cursor] = history&.page_info.end_cursor
+        $stdout.write '.' if options[:verbose]
+        break unless query_options[:cursor]
+      end
+
+      puts " found #{logins.size} contributor#{logins.size == 1 ? '' : 's'}." if options[:verbose]
+
+      logins.map do |login|
+        [login, emails(options.merge(username: login))]
+      rescue StandardError => e
+        warn e.to_s
+      end.compact.to_h
     end
 
     private

data/lib/fue/security.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Fue
+  module Security
+    class << self
+      def store!(options)
+        Fue::Shell.system!(security('add', options))
+      end
+
+      def get(options)
+        Fue::Shell.system!(security('find', options))
+      rescue RuntimeError
+        nil
+      end
+
+      private
+
+      def security(command = nil, options = nil)
+        run = [security_path]
+        run << "#{command}-internet-password"
+        run << "-a #{options[:username]}"
+        run << "-s #{options[:server]}"
+        if command == 'add'
+          run << "-l #{options[:label]}"
+          run << '-U'
+          run << "-w #{options[:password]}" if options.key?(:password)
+        else
+          run << '-w'
+        end
+        run.join ' '
+      end
+
+      def security_path
+        @security_path ||= begin
+          `which security`.chomp
+        rescue StandardError
+          'security'
+        end
+      end
+    end
+  end
+end

data/lib/fue/shell.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Fue
+  module Shell
+    class << self
+      def system!(*cmd)
+        stdout, stderr, status = Open3.capture3(*cmd)
+        raise ["exit code #{status}", stderr].compact.join("\n") unless status.success?
+
+        stdout.slice!(0..-(1 + $INPUT_RECORD_SEPARATOR.size))
+      end
+    end
+  end
+end

data/lib/fue/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Fue
-  VERSION = '0.1.2'.freeze
+  VERSION = '0.3.1'
 end

metadata

@@ -1,29 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: fue
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.3.1
 platform: ruby
 authors:
 - Daniel Doubrovkine
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-08-18 00:00:00.000000000 Z
+date: 2021-07-19 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: github_api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.18.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.18.2
 - !ruby/object:Gem::Dependency
   name: gli
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.17'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.17'
 - !ruby/object:Gem::Dependency
   name: graphlient
   requirement: !ruby/object:Gem::Requirement
@@ -38,7 +52,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.3.2
-description: 
+description:
 email: dblock@dblock.org
 executables:
 - fue
@@ -51,13 +65,16 @@ files:
 - README.md
 - bin/fue
 - lib/fue.rb
+- lib/fue/auth.rb
 - lib/fue/finder.rb
+- lib/fue/security.rb
+- lib/fue/shell.rb
 - lib/fue/version.rb
 homepage: http://github.com/dblock/fue
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -65,16 +82,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: 1.3.6
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
-signing_key: 
+rubygems_version: 3.0.4
+signing_key:
 specification_version: 4
-summary: Find an e-mail address of a Github user.
+summary: Find an e-mail address of a GitHub user.
 test_files: []