hiddengems 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +9 -0
  3. data/Gemfile +8 -0
  4. data/README.md +75 -0
  5. data/Rakefile +4 -0
  6. data/bin/console +15 -0
  7. data/bin/setup +8 -0
  8. data/exe/hiddengems.rb +116 -0
  9. data/hiddengems.gemspec +42 -0
  10. data/lib/hiddengems/version.rb +5 -0
  11. data/lib/hiddengems.rb +8 -0
  12. metadata +142 -0
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA256:
3
+ metadata.gz: 0f68060eb1130cc3f42b1db1801de72527a1bdc51980557883b12493dd72bbde
4
+ data.tar.gz: 2092ac85a1696099c7cfab6802b30f2b741c3354f4abc6ad2b01b3d0de49f58e
5
+ SHA512:
6
+ metadata.gz: ff84e6f76960871827d4e7cc3d254ab6170628b651092c8833db041b6700b309feb0ab36be91288a9126d3f0d3c970681939ac65bf7afd45e76151a6678a8c97
7
+ data.tar.gz: 29c84023222bb564c2b27e53c4b5d5f4783861d62d9c73d178ca9f2d7288c6569edb0cd5c7b70c8f70b7d04ed9fcfddcc30980b3ae4ba81a10ef1482054e0b50
data/.gitignore ADDED
@@ -0,0 +1,9 @@
1
+ /.bundle/
2
+ /.yardoc
3
+ /_yardoc/
4
+ /coverage/
5
+ /doc/
6
+ /pkg/
7
+ /spec/reports/
8
+ /tmp/
9
+ Gemfile.lock
data/Gemfile ADDED
@@ -0,0 +1,8 @@
1
+ # frozen_string_literal: true
2
+
3
+ source "https://rubygems.org"
4
+
5
+ # Specify your gem's dependencies in hiddengems.gemspec
6
+ gemspec
7
+
8
+ gem "rake", "~> 13.0"
data/README.md ADDED
@@ -0,0 +1,75 @@
1
+ # Hiddengems
2
+
3
+ This gem provides an executable - hiddengems.rb - that submits a search term to rubygems.org
4
+ and sorts the search results by a number of ranking parameters:
5
+
6
+ - number of downloads
7
+ - number of versions
8
+ - date of latest version
9
+ - average date of all released versions
10
+
11
+ Using the above, it produces a table of found gems sorted by "vitality", which
12
+ works like this:
13
+
14
+ The gem's ranking order for each of the above ranking parameters is summed together.
15
+ The ranking sum that is loweest produces the highest "vitality" ranking.
16
+
17
+ Example:
18
+
19
+ ```
20
+ $ hiddengems.rb 'zabbix sender'
21
+ Search term zabbix sender returned 6 hits
22
+ Simple Rankings
23
+ +---------------------------+------------------------+---------------------------+---------------------------+
24
+ |by_downloads |by_versions |by_latest_version_date |by_avg_version_date |
25
+ +---------------------------+------------------------+---------------------------+---------------------------+
26
+ |zabbix-ruby-client (51296) |zabbix-ruby-client (24) |zabbix_sender_api (2022) |zabbix_sender_api (2021) |
27
+ |zabbix_sender (34951) |zabbix_sender_api (11) |zabbix_sender (2020) |zabbix_sender (2017) |
28
+ |zabbix_send (13447) |zabbix_sender (5) |zabbix_sender_legacy (2016)|zabbix_sender_legacy (2016)|
29
+ |zabbix_receiver (10271) |zabbix_sender_legacy (5)|zabbix-ruby-client (2016) |zabbix_receiver (2015) |
30
+ |zabbix_sender_api (10031) |zabbix_receiver (5) |zabbix_receiver (2015) |zabbix-ruby-client (2014) |
31
+ |zabbix_sender_legacy (9939)|zabbix_send (3) |zabbix_send (2013) |zabbix_send (2013) |
32
+ +---------------------------+------------------------+---------------------------+---------------------------+
33
+
34
+ Vitality Ranking:
35
+ +-----------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+
36
+ |name |info |
37
+ +-----------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+
38
+ |zabbix_sender |Zabbix Sender gem |
39
+ |zabbix_sender_api |This gem implements an api that abstracts the zabbix sender/trapper mechanism. It saves tons of time when you… |
40
+ |zabbix_sender_legacy |Improved zabbix_sender gem just for legacy ruby < 2.0 like in Debian Wheezy |
41
+ |zabbix-ruby-client |A zabbix alternative to zabbix-agent using zabbix-sender. |
42
+ |zabbix_send |Send data to Zabbix trappers from Ruby |
43
+ |zabbix_receiver |Server to receive sender data from zabbix-agent. |
44
+ +-----------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+
45
+ ```
46
+
47
+ ## Installation
48
+
49
+ Add this line to your application's Gemfile:
50
+
51
+ ```ruby
52
+ gem 'hiddengems'
53
+ ```
54
+
55
+ And then execute:
56
+
57
+ $ bundle install
58
+
59
+ Or install it yourself as:
60
+
61
+ $ gem install hiddengems
62
+
63
+ ## Usage
64
+
65
+ $ hiddengems.rb 'search term'
66
+
67
+ ## Development
68
+
69
+ After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
70
+
71
+ To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
72
+
73
+ ## Contributing
74
+
75
+ Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/hiddengems.
data/Rakefile ADDED
@@ -0,0 +1,4 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "bundler/gem_tasks"
4
+ task default: %i[]
data/bin/console ADDED
@@ -0,0 +1,15 @@
1
+ #!/usr/bin/env ruby
2
+ # frozen_string_literal: true
3
+
4
+ require "bundler/setup"
5
+ require "hiddengems"
6
+
7
+ # You can add fixtures and/or initialization code here to make experimenting
8
+ # with your gem easier. You can also use a different console, if you like.
9
+
10
+ # (If you use this, don't forget to add pry to your Gemfile!)
11
+ # require "pry"
12
+ # Pry.start
13
+
14
+ require "irb"
15
+ IRB.start(__FILE__)
data/bin/setup ADDED
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+ IFS=$'\n\t'
4
+ set -vx
5
+
6
+ bundle install
7
+
8
+ # Do any other automated setup that you need to do here
data/exe/hiddengems.rb ADDED
@@ -0,0 +1,116 @@
1
+ #!/usr/bin/env ruby
2
+ require 'json'
3
+ require 'time'
4
+ require 'faraday'
5
+ require 'ostruct'
6
+ require 'tty-table'
7
+ require 'pry-rescue'
8
+
9
+ searchTerm = ARGV[0]
10
+
11
+ module GemEntry
12
+ def catalogEntry
13
+ "#{name}: #{info}"
14
+ end
15
+
16
+ def totalVersions
17
+ versions.size
18
+ end
19
+
20
+ def latestVersionDate
21
+ sortedVersions.first.publishedDate
22
+ end
23
+
24
+ def avgDateOfAllVersions
25
+ sum = versions.inject(0) { |memo,version|
26
+ memo += version.publishedDate.to_time.to_i
27
+ }
28
+ Time.at(sum / totalVersions)
29
+ end
30
+
31
+ def sortedVersions
32
+ versions.sort {|a,b| a.publishDate <=> b.publishDate}
33
+ end
34
+ def versionDownloadHistory
35
+ res = Array.new
36
+ nextRelease = Date.today
37
+ sortedVersions.each {|version|
38
+ version[:downloadsPerDay] = version.downloadsPerDayFrom(nextRelease)
39
+ res.push(version.to_h)
40
+ nextRelease = version.publishedDate
41
+ }
42
+ res
43
+ end
44
+ end
45
+
46
+ module GemVersion
47
+ def publishedDate
48
+ Date.iso8601(built_at)
49
+ end
50
+ def downloadsPerDayFrom(aDate)
51
+ begin
52
+ downloads_count / (aDate - publishedDate).to_i
53
+ rescue ZeroDivisionError
54
+ downloads_count
55
+ end
56
+ end
57
+ end
58
+
59
+
60
+ curpage = 1
61
+ gems = Array.new
62
+ gemdict = Hash.new
63
+ until curpage == 0
64
+ gemPage = JSON.parse(Faraday.get("https://rubygems.org/api/v1/search.json?page=#{curpage}&query=#{searchTerm}").body).collect { |each| OpenStruct.new(each)}.collect {|gem|
65
+ gem.extend(GemEntry)
66
+ gem[:versions] = JSON.parse(
67
+ Faraday.get(
68
+ "https://rubygems.org/api/v1/versions/#{gem.name}.json"
69
+ ).body
70
+ ).collect { |version|
71
+ version = OpenStruct.new(version).extend(GemVersion)
72
+ }
73
+ gem[:rank] = 0
74
+ gemdict[gem.name] = gem
75
+ gem
76
+ }
77
+ gems += gemPage
78
+ curpage = ((gemPage.size < 30) ? 0 : curpage.next)
79
+ end
80
+
81
+
82
+ puts "Search term #{searchTerm} returned #{gems.size} hits"
83
+
84
+ # Things we wanna see sorted:
85
+ # + number of versions
86
+ # + date of last version
87
+ # + avg date of all versions
88
+ # + number of downloads
89
+ # - downloads per day per version
90
+ # - average downloads per day
91
+ # - last downloads per day
92
+ # - velocity of downloads per day per version
93
+
94
+
95
+ data = Hash.new
96
+ data[:by_downloads] = gems.sort {|a,b| b.downloads <=> a.downloads}.collect {|each| "#{each.name} (#{each.downloads})"}
97
+ data[:by_versions] = gems.sort {|a,b| b.totalVersions <=> a.totalVersions}.collect {|each| "#{each.name} (#{each.totalVersions})"}
98
+ data[:by_latest_version_date] = gems.sort {|a,b| b.latestVersionDate <=> a.latestVersionDate}.collect {|each| "#{each.name} (#{each.latestVersionDate.year})"}
99
+ data[:by_avg_version_date] = gems.sort {|a,b| b.avgDateOfAllVersions<=> a.avgDateOfAllVersions}.collect {|each| "#{each.name} (#{each.avgDateOfAllVersions.year})"}
100
+ report = Array.new
101
+ gems.each_index {|index|
102
+ record = Hash.new
103
+ [:by_downloads,:by_versions,:by_latest_version_date,:by_avg_version_date].each {|column|
104
+ record[column] = data[column][index]
105
+ gemdict[data[column][index].split(' (').first][:rank] += index
106
+ }
107
+ report.push(record)
108
+ }
109
+
110
+ puts "Simple Rankings"
111
+ puts TTY::Table.new(header: data.keys, rows: report).render(:ascii)
112
+
113
+ puts "\nVitality Ranking:"
114
+ puts TTY::Table.new(header: [:name,:info], rows: gems.sort {|a,b| a.ranking<=>b.ranking}.collect {|each| [each.name,each.info]}).render(:ascii, column_widths: [15,20],resize: true)
115
+
116
+ puts
data/hiddengems.gemspec ADDED
@@ -0,0 +1,42 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative "lib/hiddengems/version"
4
+
5
+ Gem::Specification.new do |spec|
6
+ spec.name = "hiddengems"
7
+ spec.version = Hiddengems::VERSION
8
+ spec.authors = ["Dave Parker"]
9
+ spec.email = ["dparker@svdasein.org"]
10
+
11
+ spec.summary = "Search for ruby gems with a search term (like bestgems.org) with better ranking"
12
+ spec.description = "Provides a cli that lets you search rubygems for a search term. Displays multiple ranking criteria with emphasis on project vitality"
13
+ spec.homepage = "https://gitlab.com/svdasein/hiddengems"
14
+ spec.required_ruby_version = ">= 2.4.0"
15
+
16
+ spec.metadata["allowed_push_host"] = "https://rubygems.org"
17
+
18
+ spec.metadata["homepage_uri"] = spec.homepage
19
+ spec.metadata["source_code_uri"] = "https://gitlab.com/svdasein/hiddengems"
20
+ spec.metadata["changelog_uri"] = "https://gitlab.com/svdasein/hiddengems/CHANGELOG"
21
+
22
+ # Specify which files should be added to the gem when it is released.
23
+ # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
24
+ spec.files = Dir.chdir(File.expand_path(__dir__)) do
25
+ `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
26
+ end
27
+ spec.bindir = "exe"
28
+ spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
29
+ spec.require_paths = ["lib"]
30
+
31
+ # Uncomment to register a new dependency of your gem
32
+ # spec.add_dependency "example-gem", "~> 1.0"
33
+ spec.add_dependency 'json'
34
+ spec.add_dependency 'time'
35
+ spec.add_dependency 'faraday'
36
+ spec.add_dependency 'ostruct'
37
+ spec.add_dependency 'tty-table'
38
+ spec.add_dependency 'pry-rescue'
39
+
40
+ # For more information and examples about making a new gem, checkout our
41
+ # guide at: https://bundler.io/guides/creating_gem.html
42
+ end
data/lib/hiddengems/version.rb ADDED
@@ -0,0 +1,5 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Hiddengems
4
+ VERSION = "0.1.0"
5
+ end
data/lib/hiddengems.rb ADDED
@@ -0,0 +1,8 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative "hiddengems/version"
4
+
5
+ module Hiddengems
6
+ class Error < StandardError; end
7
+ # Your code goes here...
8
+ end
metadata ADDED
@@ -0,0 +1,142 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: hiddengems
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.1.0
5
+ platform: ruby
6
+ authors:
7
+ - Dave Parker
8
+ autorequire:
9
+ bindir: exe
10
+ cert_chain: []
11
+ date: 2022-08-29 00:00:00.000000000 Z
12
+ dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: json
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - ">="
18
+ - !ruby/object:Gem::Version
19
+ version: '0'
20
+ type: :runtime
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ - - ">="
25
+ - !ruby/object:Gem::Version
26
+ version: '0'
27
+ - !ruby/object:Gem::Dependency
28
+ name: time
29
+ requirement: !ruby/object:Gem::Requirement
30
+ requirements:
31
+ - - ">="
32
+ - !ruby/object:Gem::Version
33
+ version: '0'
34
+ type: :runtime
35
+ prerelease: false
36
+ version_requirements: !ruby/object:Gem::Requirement
37
+ requirements:
38
+ - - ">="
39
+ - !ruby/object:Gem::Version
40
+ version: '0'
41
+ - !ruby/object:Gem::Dependency
42
+ name: faraday
43
+ requirement: !ruby/object:Gem::Requirement
44
+ requirements:
45
+ - - ">="
46
+ - !ruby/object:Gem::Version
47
+ version: '0'
48
+ type: :runtime
49
+ prerelease: false
50
+ version_requirements: !ruby/object:Gem::Requirement
51
+ requirements:
52
+ - - ">="
53
+ - !ruby/object:Gem::Version
54
+ version: '0'
55
+ - !ruby/object:Gem::Dependency
56
+ name: ostruct
57
+ requirement: !ruby/object:Gem::Requirement
58
+ requirements:
59
+ - - ">="
60
+ - !ruby/object:Gem::Version
61
+ version: '0'
62
+ type: :runtime
63
+ prerelease: false
64
+ version_requirements: !ruby/object:Gem::Requirement
65
+ requirements:
66
+ - - ">="
67
+ - !ruby/object:Gem::Version
68
+ version: '0'
69
+ - !ruby/object:Gem::Dependency
70
+ name: tty-table
71
+ requirement: !ruby/object:Gem::Requirement
72
+ requirements:
73
+ - - ">="
74
+ - !ruby/object:Gem::Version
75
+ version: '0'
76
+ type: :runtime
77
+ prerelease: false
78
+ version_requirements: !ruby/object:Gem::Requirement
79
+ requirements:
80
+ - - ">="
81
+ - !ruby/object:Gem::Version
82
+ version: '0'
83
+ - !ruby/object:Gem::Dependency
84
+ name: pry-rescue
85
+ requirement: !ruby/object:Gem::Requirement
86
+ requirements:
87
+ - - ">="
88
+ - !ruby/object:Gem::Version
89
+ version: '0'
90
+ type: :runtime
91
+ prerelease: false
92
+ version_requirements: !ruby/object:Gem::Requirement
93
+ requirements:
94
+ - - ">="
95
+ - !ruby/object:Gem::Version
96
+ version: '0'
97
+ description: Provides a cli that lets you search rubygems for a search term. Displays
98
+ multiple ranking criteria with emphasis on project vitality
99
+ email:
100
+ - dparker@svdasein.org
101
+ executables:
102
+ - hiddengems.rb
103
+ extensions: []
104
+ extra_rdoc_files: []
105
+ files:
106
+ - ".gitignore"
107
+ - Gemfile
108
+ - README.md
109
+ - Rakefile
110
+ - bin/console
111
+ - bin/setup
112
+ - exe/hiddengems.rb
113
+ - hiddengems.gemspec
114
+ - lib/hiddengems.rb
115
+ - lib/hiddengems/version.rb
116
+ homepage: https://gitlab.com/svdasein/hiddengems
117
+ licenses: []
118
+ metadata:
119
+ allowed_push_host: https://rubygems.org
120
+ homepage_uri: https://gitlab.com/svdasein/hiddengems
121
+ source_code_uri: https://gitlab.com/svdasein/hiddengems
122
+ changelog_uri: https://gitlab.com/svdasein/hiddengems/CHANGELOG
123
+ post_install_message:
124
+ rdoc_options: []
125
+ require_paths:
126
+ - lib
127
+ required_ruby_version: !ruby/object:Gem::Requirement
128
+ requirements:
129
+ - - ">="
130
+ - !ruby/object:Gem::Version
131
+ version: 2.4.0
132
+ required_rubygems_version: !ruby/object:Gem::Requirement
133
+ requirements:
134
+ - - ">="
135
+ - !ruby/object:Gem::Version
136
+ version: '0'
137
+ requirements: []
138
+ rubygems_version: 3.1.6
139
+ signing_key:
140
+ specification_version: 4
141
+ summary: Search for ruby gems with a search term (like bestgems.org) with better ranking
142
+ test_files: []