Class: LabClient::Klass
- Inherits:
-
OpenStruct
- Object
- OpenStruct
- LabClient::Klass
- Extended by:
- Docs
- Includes:
- CurlHelper
- Defined in:
- lib/labclient/klass.rb
Overview
Common Configuration for all Class Helpers
Direct Known Subclasses
Appearance, Application, ApplicationSetting, ApprovalRule, AuditEvent, Avatar, Award, Branch, BroadcastMessage, Changes, Commit, CommitComment, CommitDiff, CommitStatus, DeployKey, Discussion, Email, Epic, Event, GpgKey, Group, GroupAccessRequest, GroupBadge, GroupHook, GroupLabel, GroupLink, GroupMilestone, ImpersonationToken, Issue, Job, Key, License, Member, MergeApproval, MergeRequest, MergeRequestDiff, Namespace, Note, Pipeline, PipelineSchedule, Project, ProjectAccessRequest, ProjectBadge, ProjectCluster, ProjectDeployment, ProjectEnvironment, ProjectHook, ProjectLabel, ProjectMilestone, ProjectMirror, ProjectRelease, ProjectReleaseLink, ProjectService, ProjectSnippet, ProjectTrigger, ProjectVariable, PushRule, RegistryRepository, RegistryTag, ResourceLabel, Runner, Snippet, SystemHook, Tag, Todo, User, Wiki
Instance Attribute Summary collapse
-
#client ⇒ Object
readonly
Returns the value of attribute client.
-
#response ⇒ Object
readonly
Returns the value of attribute response.
Class Method Summary collapse
-
.date_time_attrs(list) ⇒ Object
Define a list of DateTime Attributes.
-
.user_attrs(list) ⇒ Object
Define a list of LabClient::User Attributes.
Instance Method Summary collapse
-
#api_methods ⇒ Object
Documented API Methods.
-
#collect_project_id(position = 1) ⇒ Object
(also: #collect_group_id, #collect_user_id)
TODO: Combine all of these?.
- #collect_release_id(position = 3) ⇒ Object
- #collect_repository_id(position = 4) ⇒ Object
-
#format_time?(time) ⇒ Boolean
Formatting Time Helper.
-
#group_name ⇒ Object
Category and Primary Key for docs.
-
#help(help_filter = nil) ⇒ Object
API Methods here have to be explicitly documented / custom helpers Assume no methods by default rubocop:disable Metrics/MethodLength, Metrics/AbcSize.
-
#initialize(hash = nil, response = nil, client = nil) ⇒ Klass
constructor
A new instance of Klass.
-
#klass ⇒ Object
Helper to get docs.
-
#success? ⇒ Boolean
Forward response success.
-
#to_json(*_args) ⇒ Object
Prevent stack level errors, but turning into has first.
- #update_self(obj) ⇒ Object
- #valid_group_project_levels ⇒ Object
- #verbose ⇒ Object
Methods included from Docs
desc, doc, docs, example, json, markdown, navigation, option, result, subtitle, title
Methods included from CurlHelper
Methods inherited from OpenStruct
Constructor Details
#initialize(hash = nil, response = nil, client = nil) ⇒ Klass
Returns a new instance of Klass.
99 100 101 102 103 104 105 106 107 108 |
# File 'lib/labclient/klass.rb', line 99 def initialize(hash = nil, response = nil, client = nil) @client = client @response = response @table = {} hash&.each_pair do |k, v| k = k.to_sym @table[k] = v end end |
Instance Attribute Details
#client ⇒ Object (readonly)
Returns the value of attribute client.
7 8 9 |
# File 'lib/labclient/klass.rb', line 7 def client @client end |
#response ⇒ Object (readonly)
Returns the value of attribute response.
7 8 9 |
# File 'lib/labclient/klass.rb', line 7 def response @response end |
Class Method Details
.date_time_attrs(list) ⇒ Object
Define a list of DateTime Attributes
121 122 123 124 125 126 127 |
# File 'lib/labclient/klass.rb', line 121 def self.date_time_attrs(list) list.each do |kind| define_method(kind) do DateTime.parse @table[kind] if has? kind end end end |
Instance Method Details
#api_methods ⇒ Object
Documented API Methods
44 45 46 47 48 49 50 51 52 53 54 55 56 57 |
# File 'lib/labclient/klass.rb', line 44 def api_methods docs = LabClient::Docs.docs.dig(group_name, 'Reference') unless docs puts 'No Available Help' return false end LabClient::Docs.docs.dig(group_name, 'Reference').map do |doc| doc[:options].map do |opt| opt[:name] end end.flatten.sort end |
#collect_project_id(position = 1) ⇒ Object Also known as: collect_group_id, collect_user_id
TODO: Combine all of these?
64 65 66 |
# File 'lib/labclient/klass.rb', line 64 def collect_project_id(position = 1) response.path.split('/')[position] end |
#collect_release_id(position = 3) ⇒ Object
71 72 73 |
# File 'lib/labclient/klass.rb', line 71 def collect_release_id(position = 3) response.path.split('/')[position] end |
#collect_repository_id(position = 4) ⇒ Object
75 76 77 |
# File 'lib/labclient/klass.rb', line 75 def collect_repository_id(position = 4) response.path.split('/')[position] end |
#format_time?(time) ⇒ Boolean
Formatting Time Helper
116 117 118 |
# File 'lib/labclient/klass.rb', line 116 def format_time?(time) time.respond_to?(:to_time) end |
#group_name ⇒ Object
Category and Primary Key for docs
80 81 82 |
# File 'lib/labclient/klass.rb', line 80 def group_name self.class.instance_variable_get('@group_name') || klass.pluralize end |
#help(help_filter = nil) ⇒ Object
API Methods here have to be explicitly documented / custom helpers Assume no methods by default rubocop:disable Metrics/MethodLength, Metrics/AbcSize
17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 |
# File 'lib/labclient/klass.rb', line 17 def help(help_filter = nil) docs = LabClient::Docs.docs.dig(group_name, 'Reference') unless docs puts 'No Available Help' return false end puts klass docs.each do |doc| next unless doc[:options] doc[:options].each do |opt| if help_filter next unless (opt[:name] + opt[:text]).include? help_filter.to_s end puts ' ' + opt[:name] puts " #{opt[:text]}\n" end end # Ignore Output nil end |
#klass ⇒ Object
Helper to get docs
90 91 92 |
# File 'lib/labclient/klass.rb', line 90 def klass self.class.name.split('::', 2).last.split(/(?=[A-Z])/).join(' ') end |
#success? ⇒ Boolean
Forward response success
111 112 113 |
# File 'lib/labclient/klass.rb', line 111 def success? @response.success? end |
#to_json(*_args) ⇒ Object
Prevent stack level errors, but turning into has first
85 86 87 |
# File 'lib/labclient/klass.rb', line 85 def to_json(*_args) to_h.to_json end |
#update_self(obj) ⇒ Object
94 95 96 97 |
# File 'lib/labclient/klass.rb', line 94 def update_self(obj) @table = obj.table self end |
#valid_group_project_levels ⇒ Object
59 60 61 |
# File 'lib/labclient/klass.rb', line 59 def valid_group_project_levels %i[guest reporter developer maintainer owner] end |
#verbose ⇒ Object
10 11 12 |
# File 'lib/labclient/klass.rb', line 10 def verbose ap self end |