repofetch 0.4.2 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a76fb4a912612b2c1c549434f7cfae5fbb88728d036a17f77060e5ae868eebaa
-  data.tar.gz: 01c3fefe7a5799a65e5a078bbb6d3ca891fe56c8db3b38a9f4989b8cd0336bf7
+  metadata.gz: 3ad5af8ce1827ff6413451767fc8040cc710a057ecfde81d2d5db8c33282a15d
+  data.tar.gz: 3b9658cdeaf490accc551548464ea534e49b86a15dde562b16eec7da0d2d9d05
 SHA512:
-  metadata.gz: 7190241c2007f706a366628ff13d1aeea7c64a2c37fc54b335d20eca2d3697a640dfd6cef50192d551dab8712e9abb4ca52a9cd0d43044922ca8f7fce6cb4eea
-  data.tar.gz: '0295d4dbc84815a2037dc239cbfcbfd2d3062d1d8ceb8fb17b9990744a67923c5310ddb5bfa9a6515eb723d981bca6b8e4a8394b63aa3c520d49254d43bdba49'
+  metadata.gz: 07a62248fa6ff9248b85b01fc7f8376ae6b17fd5b9f30fce25a7e1ad139892b4ee230e84e3eb43b1aa2d1b94c66ee0be8f330100b2949b3ba95edbe7bb7cb2b2
+  data.tar.gz: 814a0249c286baf5523a461c50acadd75c2f31149185e5c8f8886e2f48feddcc770445fac5f6441092663cd1dbdea6dd40c2a457526d2740774be67bdafdc709

data/CONTRIBUTING.md

@@ -13,6 +13,12 @@ bundle install
 bundle exec overcommit --install
 ```
 
+### Demo Animations
+
+The demo animations are created using [vhs]. If you are going to create or
+update the demo animations, please follow the installation instructions for
+[vhs].
+
 ## Writing a 3rd-party plugin
 
 3rd-party plugins are Ruby gems that users can install and activate in their
@@ -131,3 +137,4 @@ MyCoolPlugin.register
   negative space, and uncolored text for positive space.
 
 [git-base]: https://www.rubydoc.info/github/ruby-git/ruby-git/Git/Base
+[vhs]: https://github.com/charmbracelet/vhs

data/Gemfile.lock

@@ -1,13 +1,13 @@
 PATH
   remote: .
   specs:
-    repofetch (0.4.2)
+    repofetch (0.4.4)
       actionview (~> 7.0, >= 7.0.4)
       dotenv (~> 2.8)
       faraday-retry (~> 2.0)
       git (~> 1.12)
       octokit (~> 6.0, >= 6.0.1)
-      sawyer (~> 0.9)
+      sawyer
 
 GEM
   remote: https://rubygems.org/
@@ -41,7 +41,7 @@ GEM
     faraday-net_http (3.0.2)
     faraday-retry (2.0.0)
       faraday (~> 2.0)
-    git (1.13.0)
+    git (1.13.1)
       addressable (~> 2.8)
       rchardet (~> 1.8)
     i18n (1.12.0)
@@ -51,10 +51,8 @@ GEM
     loofah (2.19.1)
       crass (~> 1.0.2)
       nokogiri (>= 1.5.9)
-    mini_portile2 (2.8.1)
     minitest (5.17.0)
-    nokogiri (1.13.10)
-      mini_portile2 (~> 2.8.0)
+    nokogiri (1.14.0-x86_64-linux)
       racc (~> 1.4)
     octokit (6.0.1)
       faraday (>= 1, < 3)
@@ -65,7 +63,7 @@ GEM
       iniparse (~> 1.4)
       rexml (~> 3.2)
     parallel (1.22.1)
-    parser (3.1.3.0)
+    parser (3.2.0.0)
       ast (~> 2.4.1)
     public_suffix (5.0.1)
     racc (1.6.2)
@@ -85,31 +83,31 @@ GEM
       rspec-mocks (~> 3.12.0)
     rspec-core (3.12.0)
       rspec-support (~> 3.12.0)
-    rspec-expectations (3.12.0)
+    rspec-expectations (3.12.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
-    rspec-mocks (3.12.0)
+    rspec-mocks (3.12.2)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
     rspec-snapshot (2.0.1)
       awesome_print (> 1.0.0)
       rspec (> 3.0.0)
     rspec-support (3.12.0)
-    rubocop (1.42.0)
+    rubocop (1.43.0)
       json (~> 2.3)
       parallel (~> 1.10)
-      parser (>= 3.1.2.1)
+      parser (>= 3.2.0.0)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
       rexml (>= 3.2.5, < 4.0)
       rubocop-ast (>= 1.24.1, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
+      unicode-display_width (>= 2.4.0, < 3.0)
     rubocop-ast (1.24.1)
       parser (>= 3.1.1.0)
     rubocop-rake (0.6.0)
       rubocop (~> 1.0)
-    rubocop-rspec (2.16.0)
+    rubocop-rspec (2.17.0)
       rubocop (~> 1.33)
     ruby-progressbar (1.11.0)
     ruby2_keywords (0.0.5)
@@ -127,13 +125,13 @@ GEM
     simplecov_json_formatter (0.1.4)
     tzinfo (2.0.5)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (2.3.0)
+    unicode-display_width (2.4.2)
     webrick (1.7.0)
     yard (0.9.28)
       webrick (~> 1.7.0)
 
 PLATFORMS
-  ruby
+  x86_64-linux
 
 DEPENDENCIES
   bundler (~> 2.0)
@@ -151,4 +149,4 @@ DEPENDENCIES
   yard (~> 0.9.28)
 
 BUNDLED WITH
-   2.1.2
+   2.4.3

data/README.md

@@ -3,7 +3,7 @@
 [![Gem Version](https://badge.fury.io/rb/repofetch.svg)](https://badge.fury.io/rb/repofetch)
 [![GitHub contributors (via allcontributors.org)](https://img.shields.io/github/all-contributors/spenserblack/repofetch)](./CREDITS.md)
 ![CI](https://github.com/spenserblack/repofetch/workflows/CI/badge.svg)
-[![CodeQL](https://github.com/spenserblack/repofetch/actions/workflows/codeql.yml/badge.svg)](https://github.com/spenserblack/repofetch/actions/workflows/codeql.yml)
+[![CodeQL](https://github.com/spenserblack/repofetch/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/spenserblack/repofetch/actions/workflows/github-code-scanning/codeql)
 [![codecov](https://codecov.io/gh/spenserblack/repofetch/branch/master/graph/badge.svg?token=3572AEWQAY)](https://codecov.io/gh/spenserblack/repofetch)
 
 Fetch details about your remote repository.
@@ -12,7 +12,7 @@ Fetch details about your remote repository.
 
 ![basic demo](./demos/demo.gif)
 
-![advanced plugin usage](./demos/github-plugin.gif)
+![advanced plugin usage](./demos/gitlab-plugin.gif)
 
 ## Description
 
@@ -20,9 +20,15 @@ repofetch is a CLI tool to fetch stats (think [neofetch] or
 [onefetch]) that uses plugins for its implementation. The original version was focused on
 repository stats, and any official plugin will be for repositories, hence the "repo" in
 repofetch. With 3rd-party plugins, however, it can support other types of outputs, too.
+This tool may be renamed in the future.
+
+Follow [this discussion](https://github.com/spenserblack/repofetch/discussions/219)
+for details about the potential rename.
 
 ## Installation
 
+[![Packaging status](https://repology.org/badge/vertical-allrepos/ruby:repofetch.svg)](https://repology.org/project/ruby:repofetch/versions)
+
 ### Via RubyGems.org
 
 ```bash
@@ -45,6 +51,12 @@ yay -S ruby-repofetch-bin
 yay -S ruby-repofetch
 ```
 
+### Via NetBSD
+
+```bash
+pkgin install ruby-repofetch
+```
+
 ### Installing Version `< 0.4.0`
 
 Version 0.3.3 and lower was a different implementation written in Rust. While `>= 0.4.0` is unstable

data/RELEASE_NOTES

@@ -1,18 +1,6 @@
-0.4.2
+Bitbucket Cloud Bugfix
 
-## Added
+## Fixed
 
-- GitLab plugin
-  - Enable by adding `- repofetch/gitlab` to your config file
-
-## Other
-
-- Publish gem with GitHub Actions
-
-## Breaking for 3rd-party plugins
-
-### Changed
-
-- Configuration to be a class variable on `Repofetch` instead of a value that's
-  passed to various instantiation and rendering methods
-- Stats to automatically receive theme from the base `Plugin` class
+- Bitbucket Cloud not getting automatically detected when running `repofetch` in a
+  Bitbucket Cloud repository

data/lib/repofetch/DEFAULT_CONFIG

@@ -1,6 +1,7 @@
 ---
 # vim: set ft=yaml:
 plugins:
+  - 'repofetch/bitbucketcloud'
   - 'repofetch/github'
   - 'repofetch/gitlab'
 emojis: true

data/lib/repofetch/bitbucketcloud/ASCII

@@ -0,0 +1,17 @@
+%{blue}@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+%{blue}@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+%{blue} @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 
+%{blue} @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 
+%{blue}  @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@  
+%{blue}  @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@  
+%{blue}   @@@@@@@@@               .........   
+%{blue}   @@@@@@@@@               .........   
+%{blue}    @@@@@@@@@             :::::::::    
+%{blue}    @@@@@@@@@             :::::::::    
+%{blue}     @@@@@@@@@           !!!!!!!!!     
+%{blue}     @@@@@@@@@           !!!!!!!!!     
+%{blue}      @@@@@@@@@@@@@@@@@@@@@@@@@@@      
+%{blue}      @@@@@@@@@@@@@@@@@@@@@@@@@@@      
+%{blue}       @@@@@@@@@@@@@@@@@@@@@@@@@       
+%{blue}       @@@@@@@@@@@@@@@@@@@@@@@@@       
+%{blue}        @@@@@@@@@@@@@@@@@@@@@@@        

data/lib/repofetch/bitbucketcloud.rb

@@ -0,0 +1,158 @@
+# frozen_string_literal: true
+
+require 'action_view'
+require 'optparse'
+require 'repofetch'
+require 'repofetch/exceptions'
+require 'sawyer'
+
+class Repofetch
+  # Adds support for Bitbucket repositories.
+  class BitbucketCloud < Repofetch::Plugin
+    include ActionView::Helpers::NumberHelper
+
+    HTTP_REMOTE_REGEX = %r{https?://bitbucket\.org/(?<owner>[\w._-]+)/(?<repo>[\w._-]+)}.freeze
+    SSH_REMOTE_REGEX = %r{git@bitbucket\.org:(?<owner>[\w._-]+)/(?<repo>[\w._-]+)}.freeze
+    ASCII = File.read(File.expand_path('bitbucketcloud/ASCII', __dir__))
+
+    attr_reader :repo_identifier
+
+    def initialize(repo_identifier)
+      super
+
+      @repo_identifier = repo_identifier
+    end
+
+    def header
+      "#{repo_data['owner']['display_name']}/#{repo_data['name']} @ Bitbucket"
+    end
+
+    def stats
+      stats = [http_clone_url, ssh_clone_url, watchers, forks, created, updated, size, issues, pull_requests]
+
+      stats.each { |stat| %i[bold blue].each { |style| stat.style_label!(style) } }
+    end
+
+    def ascii
+      ASCII
+    end
+
+    def agent
+      @agent ||= Sawyer::Agent.new('https://api.bitbucket.org/2.0') do |http|
+        http.headers['Authorization'] = "Bearer #{token}" unless token.nil?
+      end
+    end
+
+    def token
+      ENV.fetch('BITBUCKET_TOKEN', nil)
+    end
+
+    # Detects that the repository is a Bitbucket repository.
+    def self.matches_repo?(git)
+      default_remote = Repofetch.default_remote(git)
+      matches_remote?(default_remote&.url)
+    end
+
+    # Detects that the remote URL is for a Bitbucket Cloud repository.
+    def self.matches_remote?(remote)
+      HTTP_REMOTE_REGEX.match?(remote) || SSH_REMOTE_REGEX.match?(remote)
+    end
+
+    # Gets the owner and repository from a GitHub local repository.
+    def self.repo_identifiers(git)
+      default_remote = Repofetch.default_remote(git)
+      remote_identifiers(default_remote&.url)
+    end
+
+    # Gets the owner and repository from a GitHub remote URL.
+    #
+    # Returns nil if there is no match.
+    def self.remote_identifiers(remote)
+      match = HTTP_REMOTE_REGEX.match(remote)
+      match = SSH_REMOTE_REGEX.match(remote) if match.nil?
+      raise "Remote #{remote.inspect} doesn't look like a Bitbucket Cloud remote" if match.nil?
+
+      [match[:owner], match[:repo].delete_suffix('.git')]
+    end
+
+    # Creates an instance from a +Git::Base+ instance.
+    #
+    # @raise [Repofetch::PluginUsageError] if this plugin was selected *and* arguments were passed.
+    def self.from_git(git, args)
+      raise Repofetch::PluginUsageError, 'Explicitly activate this plugin to CLI arguments' unless args.empty?
+
+      owner, repository = repo_identifiers(git)
+
+      new("#{owner}/#{repository}")
+    end
+
+    def self.from_args(args)
+      parser = OptionParser.new do |opts|
+        opts.banner = 'Usage: <plugin activation> -- [options] OWNER/PROJECT'
+        opts.separator ''
+        opts.separator 'This plugin can use the BITBUCKET_TOKEN environment variable'
+      end
+      parser.parse(args)
+
+      raise Repofetch::PluginUsageError, parser.to_s unless args.length == 1
+
+      new(args[0])
+    end
+
+    protected
+
+    def repo_data
+      @repo_data ||= agent.call(:get, "repositories/#{@repo_identifier}").data
+    end
+
+    def clone_urls
+      @clone_urls ||= repo_data['links']['clone'].to_h { |clone| [clone['name'].to_sym, clone['href']] }
+    end
+
+    def http_clone_url
+      Repofetch::Stat.new('HTTP(S)', clone_urls[:https], emoji: '🌐')
+    end
+
+    def ssh_clone_url
+      Repofetch::Stat.new('SSH', clone_urls[:ssh], emoji: '🔑')
+    end
+
+    def watchers
+      @watcher_data ||= agent.call(:get, "repositories/#{@repo_identifier}/watchers").data
+      Repofetch::Stat.new('subscribers', @watcher_data['size'], emoji: '👀')
+    end
+
+    def forks
+      @fork_data ||= agent.call(:get, "repositories/#{@repo_identifier}/forks").data
+      Repofetch::Stat.new('forks', @fork_data['size'], emoji: '🔱')
+    end
+
+    def created
+      Repofetch::TimespanStat.new('created', repo_data['created_on'], emoji: '🐣')
+    end
+
+    def updated
+      Repofetch::TimespanStat.new('updated', repo_data['updated_on'], emoji: '📤')
+    end
+
+    def size
+      # NOTE: Size is in bytes
+      # TODO: Move this somewhere else instead of using a copy-paste
+      byte_size = number_to_human_size(repo_data['size'] || 0, precision: 2, significant: false,
+                                                               strip_insignificant_zeros: false)
+      Repofetch::Stat.new('size', byte_size, emoji: '💽')
+    end
+
+    def issues
+      @issue_data ||= agent.call(:get, "repositories/#{@repo_identifier}/issues").data
+      Repofetch::Stat.new('issues', @issue_data['size'], emoji: '❗')
+    end
+
+    def pull_requests
+      @pull_request_data ||= agent.call(:get, "repositories/#{@repo_identifier}/pullrequests").data
+      Repofetch::Stat.new('pull requests', @pull_request_data['size'], emoji: '🔀')
+    end
+  end
+end
+
+Repofetch::BitbucketCloud.register

data/lib/repofetch/cli.rb

@@ -4,6 +4,7 @@ require 'git'
 require 'optparse'
 require 'repofetch'
 require 'repofetch/config'
+require 'repofetch/exceptions'
 
 class Repofetch
   # Command line interface for repofetch.
@@ -29,7 +30,7 @@ class Repofetch
 
       begin
         plugin = new_plugin
-      rescue ArgumentError => e
+      rescue Repofetch::PluginUsageError => e
         warn e
         return 1
       end
@@ -62,13 +63,14 @@ class Repofetch
     private
 
     def add_repository_options(opts)
-      opts.on('-r', '--repository PATH', 'Use the provided repository. Defaults to the current directory.') do |path|
+      opts.on('-r', '--repository', '-p', '--path PATH',
+              'Use the provided path. Defaults to the current directory.') do |path|
         @repository_path = path
       end
     end
 
     def add_plugin_options(opts)
-      opts.on('-p', '--plugin PLUGIN', 'Use the specified plugin.') do |plugin|
+      opts.on('-P', '--plugin PLUGIN', 'Use the specified plugin.') do |plugin|
         @plugin = available_plugins[plugin]
       end
 

data/lib/repofetch/exceptions.rb

@@ -1,13 +1,18 @@
 # frozen_string_literal: true
 
-# Raised when there aren't any available plugins.
 class Repofetch
   class Error < RuntimeError
   end
 
+  # Raised when there aren't any available plugins.
   class NoPluginsError < Error
   end
 
+  # Raised when more than one plugin is activated.
   class TooManyPluginsError < Error
   end
+
+  # Raised when a user incorrectly uses the CLI with a plugin.
+  class PluginUsageError < Error
+  end
 end

data/lib/repofetch/github.rb

@@ -4,14 +4,15 @@ require 'action_view'
 require 'octokit'
 require 'optparse'
 require 'repofetch'
+require 'repofetch/exceptions'
 
 class Repofetch
   # Adds support for GitHub repositories.
   class Github < Repofetch::Plugin
     include ActionView::Helpers::NumberHelper
 
-    HTTP_REMOTE_REGEX = %r{https?://github\.com/(?<owner>[\w.\-]+)/(?<repository>[\w.\-]+)}.freeze
-    SSH_REMOTE_REGEX = %r{git@github\.com:(?<owner>[\w.\-]+)/(?<repository>[\w.\-]+)}.freeze
+    HTTP_REMOTE_REGEX = %r{https?://github\.com/(?<owner>[\w.-]+)/(?<repository>[\w.-]+)}.freeze
+    SSH_REMOTE_REGEX = %r{git@github\.com:(?<owner>[\w.-]+)/(?<repository>[\w.-]+)}.freeze
     ASCII = File.read(File.expand_path('github/ASCII', __dir__))
 
     attr_reader :owner, :repository
@@ -30,15 +31,15 @@ class Repofetch
     end
 
     def stats
-      stats = [url, stargazers, subscribers, forks, created, updated, size, issues, pull_requests]
+      stats = [http_clone_url, ssh_clone_url, stargazers, subscribers, forks, created, updated, size, issues,
+               pull_requests]
       stats.each { |stat| stat.style_label!(:bold) }
     end
 
     # Detects that the repository is a GitHub repository.
     def self.matches_repo?(git)
       default_remote = Repofetch.default_remote(git)
-      url = default_remote&.url
-      matches_remote?(url)
+      matches_remote?(default_remote&.url)
     end
 
     # Detects that the remote URL is for a GitHub repository.
@@ -49,8 +50,7 @@ class Repofetch
     # Gets the owner and repository from a GitHub local repository.
     def self.repo_identifiers(git)
       default_remote = Repofetch.default_remote(git)
-      url = default_remote&.url
-      remote_identifiers(url)
+      remote_identifiers(default_remote&.url)
     end
 
     # Gets the owner and repository from a GitHub remote URL.
@@ -66,10 +66,9 @@ class Repofetch
 
     # Creates an instance from a +Git::Base+ instance.
     #
-    # @raise [ArgumentError] if this plugin was selected *and* arguments were passed.
+    # @raise [Repofetch::PluginUsageError] if this plugin was selected *and* arguments were passed.
     def self.from_git(git, args)
-      # TODO: Raise a better exception than ArgumentError
-      raise ArgumentError, 'Explicitly activate this plugin to CLI arguments' unless args.empty?
+      raise Repofetch::PluginUsageError, 'Explicitly activate this plugin to CLI arguments' unless args.empty?
 
       owner, repository = repo_identifiers(git)
 
@@ -78,7 +77,7 @@ class Repofetch
 
     # Creates an instance from CLI args and configuration.
     #
-    # @raise [ArgumentError] if +args+ couldn't be parsed.
+    # @raise [Repofetch::PluginUsageError] if +args+ couldn't be parsed.
     def self.from_args(args)
       parser = OptionParser.new do |opts|
         opts.banner = 'Usage: <plugin activation> -- [options] OWNER/REPOSITORY'
@@ -88,8 +87,7 @@ class Repofetch
       parser.parse(args)
       split = args[0]&.split('/')
 
-      # TODO: Raise a better exception than ArgumentError
-      raise ArgumentError, parser.to_s unless split&.length == 2
+      raise Repofetch::PluginUsageError, parser.to_s unless split&.length == 2
 
       new(*split)
     end
@@ -109,8 +107,12 @@ class Repofetch
       @repo_stats
     end
 
-    def url
-      Repofetch::Stat.new('URL', repo_stats['clone_url'], emoji: '🌐')
+    def http_clone_url
+      Repofetch::Stat.new('HTTP(S)', repo_stats['clone_url'], emoji: '🌐')
+    end
+
+    def ssh_clone_url
+      Repofetch::Stat.new('SSH', repo_stats['ssh_url'], emoji: '🔑')
     end
 
     def stargazers
@@ -134,12 +136,8 @@ class Repofetch
     end
 
     def size
-      byte_size = number_to_human_size(
-        (repo_stats['size'] || 0) * 1024,
-        precision: 2,
-        significant: false,
-        strip_insignificant_zeros: false
-      )
+      byte_size = number_to_human_size((repo_stats['size'] || 0) * 1024, precision: 2, significant: false,
+                                                                         strip_insignificant_zeros: false)
       Repofetch::Stat.new('size', byte_size, emoji: '💽')
     end
 

data/lib/repofetch/gitlab.rb

@@ -2,13 +2,14 @@
 
 require 'cgi'
 require 'repofetch'
+require 'repofetch/exceptions'
 require 'sawyer'
 
 class Repofetch
   # Adds support for GitLab repositories.
   class Gitlab < Repofetch::Plugin
-    HTTP_REMOTE_REGEX = %r{https?://gitlab\.com/(?<path>[\w.\-][\w.\-/]+)}.freeze
-    SSH_REMOTE_REGEX = %r{git@gitlab\.com:(?<path>[\w.\-][\w.\-/]+)}.freeze
+    HTTP_REMOTE_REGEX = %r{https?://gitlab\.com/(?<path>[\w.-][\w.\-/]+)}.freeze
+    SSH_REMOTE_REGEX = %r{git@gitlab\.com:(?<path>[\w.-][\w.\-/]+)}.freeze
     ASCII = File.read(File.expand_path('gitlab/ASCII', __dir__))
 
     attr_reader :repo_identifier
@@ -21,11 +22,15 @@ class Repofetch
     end
 
     def header
-      "#{repo_data['name_with_namespace']} @ GitLab"
+      "#{header_format(repo_data['name_with_namespace'])} @ #{header_format('GitLab')}"
+    end
+
+    def header_format(text)
+      theme.format(:bold, theme.format(:red, text))
     end
 
     def stats
-      stats = [url, stars, forks, created, updated]
+      stats = [http_clone_url, ssh_clone_url, stars, forks, created, updated]
 
       # NOTE: Stats that require authentication
       stats << open_issues unless token.nil?
@@ -51,8 +56,12 @@ class Repofetch
       @repo_data ||= agent.call(:get, "projects/#{@repo_identifier}").data
     end
 
-    def url
-      Repofetch::Stat.new('URL', repo_data['http_url_to_repo'], emoji: '🌐')
+    def http_clone_url
+      Repofetch::Stat.new('HTTP(S)', repo_data['http_url_to_repo'], emoji: '🌐')
+    end
+
+    def ssh_clone_url
+      Repofetch::Stat.new('SSH', repo_data['ssh_url_to_repo'], emoji: '🔑')
     end
 
     def stars
@@ -108,10 +117,9 @@ class Repofetch
 
     # Creates an instance from a +Git::Base+ instance.
     #
-    # @raise [ArgumentError] if this plugin was selected *and* arguments were passed.
+    # @raise [Repofetch::PluginUsageError] if this plugin was selected *and* arguments were passed.
     def self.from_git(git, args)
-      # TODO: Raise a better exception than ArgumentError
-      raise ArgumentError, 'Explicitly activate this plugin to CLI arguments' unless args.empty?
+      raise Repofetch::PluginUsageError, 'Explicitly activate this plugin to CLI arguments' unless args.empty?
 
       path = repo_identifier(git)
 
@@ -119,6 +127,15 @@ class Repofetch
     end
 
     def self.from_args(args)
+      parser = OptionParser.new do |opts|
+        opts.banner = 'Usage: <plugin activation> -- [options] OWNER/PROJECT/SUBPROJECT'
+        opts.separator ''
+        opts.separator 'This plugin can use the GITLAB_TOKEN environment variable to fetch more data'
+      end
+      parser.parse(args)
+
+      raise Repofetch::PluginUsageError, parser.to_s unless args.length == 1
+
       new(args[0])
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: repofetch
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.4.4
 platform: ruby
 authors:
 - Spenser Black
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-01-01 00:00:00.000000000 Z
+date: 2023-01-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionview
@@ -96,16 +96,16 @@ dependencies:
   name: sawyer
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -296,6 +296,8 @@ files:
 - exe/repofetch
 - lib/repofetch.rb
 - lib/repofetch/DEFAULT_CONFIG
+- lib/repofetch/bitbucketcloud.rb
+- lib/repofetch/bitbucketcloud/ASCII
 - lib/repofetch/cli.rb
 - lib/repofetch/config.rb
 - lib/repofetch/env.rb