Class: Generator::API

Inherits:
Object
  • Object
show all
Includes:
FileWriter, Formatter
Defined in:
lib/generator/api.rb

Constant Summary

Constants included from Formatter

Formatter::MAX_LINE_LENGTH

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Formatter

#convert_doc_links_to_full_url, #convert_html_links_to_yard, #format_method_definition, #split_long_comment_line

Methods included from FileWriter

#format_files, #write_file

Constructor Details

#initialize(file) ⇒ API

Returns a new instance of API.



57
58
59
60
 
# File 'lib/generator/api.rb', line 57

def initialize(file)
  @file = file
  @written_files = []
end

Instance Attribute Details

#file ⇒ Object (readonly)

Returns the value of attribute file.



25
26
27
 
# File 'lib/generator/api.rb', line 25

def file
  @file
end

Class Method Details

.apis ⇒ Object 



35
36
37
38
39
40
41
42
43
 
# File 'lib/generator/api.rb', line 35

def apis
  api_models = Dir.glob(File.join(Config::BASE_PATH, "selling-partner-api-models/models/**/*.json"))
  APINameResolver.validate_no_unmapped_collisions!(api_models)

  api_models.map { |file| new(file) }.sort_by do |api|
    version_key = api.version.start_with?("v") ? api.version : "z#{api.version}"
    [api.name, version_key]
  end
end

.cleanup! ⇒ Object 



45
46
47
48
49
50
51
52
53
54
 
# File 'lib/generator/api.rb', line 45

def cleanup!
  ["lib", "sig"].each do |base|
    apis_path = File.join(Config::BASE_PATH, base, "peddler/apis")
    FileUtils.mkdir_p(apis_path)
    # Delete only generated API subdirectories, preserve all files (money.rb, etc.)
    Dir.glob(File.join(apis_path, "*")).select { |p| File.directory?(p) }.each do |dir|
      FileUtils.rm_rf(dir)
    end
  end
end

.generate ⇒ Object 



28
29
30
31
32
33
 
# File 'lib/generator/api.rb', line 28

def generate
  cleanup!

  # Generate each API in parallel
  Parallel.each(apis, &:generate)
end

Instance Method Details

#class_name ⇒ Object 



147
148
149
 
# File 'lib/generator/api.rb', line 147

def class_name
  name_with_version.camelize
end

#convenience_method_name ⇒ Object 



169
170
171
 
# File 'lib/generator/api.rb', line 169

def convenience_method_name
  name
end

#description ⇒ Object 



123
124
125
126
127
128
129
 
# File 'lib/generator/api.rb', line 123

def description
  description = model["info"]["description"]
  description = convert_html_links_to_yard(description)
  description = convert_doc_links_to_full_url(description)

  split_long_comment_line(description, base_indent: 4)
end

#file_path ⇒ Object 



191
192
193
 
# File 'lib/generator/api.rb', line 191

def file_path
  File.join(Config::BASE_PATH, "lib/#{library_name}.rb")
end

#generate ⇒ Object 



62
63
64
65
66
67
68
69
70
71
72
 
# File 'lib/generator/api.rb', line 62

def generate
  generate_api_class!
  generate_types!

  # Reload to pick up newly generated files for RBS introspection
  IntrospectionLoader.reload
  generate_rbs!
  format_files(@written_files)

  Generator.logger.info("Generated api #{name_with_version}")
end

#generate_api_class! ⇒ Object 



74
75
76
 
# File 'lib/generator/api.rb', line 74

def generate_api_class!
  @written_files << write_file(file_path, render)
end

#generate_rbs! ⇒ Object 



99
100
101
102
 
# File 'lib/generator/api.rb', line 99

def generate_rbs!
  # Generate unified RBS file with both API operations and type definitions
  @written_files << RBS::Unified.new(self, name_with_version, @api_types || []).generate
end

#generate_types! ⇒ Object 



78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
 
# File 'lib/generator/api.rb', line 78

def generate_types!
  api_types = types
  return [] if api_types.empty?

  # Detect circular dependencies across all types for this API
  detector = CircularDependencyDetector.new(api_types)
  detector.detect
  api_types.each do |type|
    type.circular_dependencies = detector.circular_deps
    type.cycle_edges = detector.cycle_edges
  end

  # Generate each type Ruby file
  api_types.each do |type|
    @written_files << type.generate
  end

  # Store types for RBS generation
  @api_types = api_types
end

#github_model_filename ⇒ Object 



199
200
201
202
 
# File 'lib/generator/api.rb', line 199

def github_model_filename
  parts = file.split("/")
  "#{parts[-2]}/#{parts[-1]}"
end

#has_helper? ⇒ Boolean

Returns:

  • (Boolean) 


135
136
137
 
# File 'lib/generator/api.rb', line 135

def has_helper?
  File.exist?("lib/" + helper_library_name + ".rb")
end

#helper_class_name ⇒ Object 



139
140
141
 
# File 'lib/generator/api.rb', line 139

def helper_class_name
  "Peddler::Helpers::#{name_with_version.camelize}"
end

#helper_library_name ⇒ Object 



143
144
145
 
# File 'lib/generator/api.rb', line 143

def helper_library_name
  "peddler/helpers/#{name_with_version}"
end

#latest_version? ⇒ Boolean

Returns:

  • (Boolean) 


163
164
165
166
167
 
# File 'lib/generator/api.rb', line 163

def latest_version?
  all_apis = self.class.apis.select { |api| api.name == name }
  latest_version = VersionSelector.find_latest_version(all_apis.map(&:version))
  version == latest_version
end

#library_name ⇒ Object 



131
132
133
 
# File 'lib/generator/api.rb', line 131

def library_name
  "peddler/apis/#{name_with_version}"
end

#name ⇒ Object 



151
152
153
 
# File 'lib/generator/api.rb', line 151

def name
  @name ||= APINameResolver.new(file).name
end

#name_with_version ⇒ Object 



159
160
161
 
# File 'lib/generator/api.rb', line 159

def name_with_version
  [name, version].join("_")
end

#openapi_spec ⇒ Object 



195
196
197
 
# File 'lib/generator/api.rb', line 195

def openapi_spec
  model
end

#operations ⇒ Object 



173
174
175
176
177
178
 
# File 'lib/generator/api.rb', line 173

def operations
  @operations ||= begin
    ops = paths.flat_map { |path| path.operations(name_with_version) }.compact
    deduplicate_operations(ops)
  end
end

#paths ⇒ Object 



187
188
189
 
# File 'lib/generator/api.rb', line 187

def paths
  model["paths"].map { |path, methods| Path.new(path, methods) }
end

#title ⇒ Object 



119
120
121
 
# File 'lib/generator/api.rb', line 119

def title
  split_long_comment_line(model["info"]["title"], base_indent: 4)
end

#type_names ⇒ Object 



180
181
182
183
184
185
 
# File 'lib/generator/api.rb', line 180

def type_names
  openapi_spec["definitions"]
    .select { |name, def_| def_["type"] == "object" && !MoneyDetector.money_type?(name) && !def_["additionalProperties"] }
    .keys
    .sort
end

#types ⇒ Object 



104
105
106
107
108
109
110
111
112
113
114
115
116
117
 
# File 'lib/generator/api.rb', line 104

def types
  arr = []
  openapi_spec["definitions"].each do |name, definition|
    # Skip non-object definitions but allow allOf compositions and arrays
    next unless definition["type"] == "object" || definition["allOf"] || definition["type"] == "array"
    # Skip Money types as we use the custom Money type for these
    next if MoneyDetector.money_type?(name)
    # Skip types with ONLY additionalProperties (no defined properties) - they'll be referenced as Hash
    next if definition["additionalProperties"] && !definition["properties"] && !definition["allOf"]

    arr << Type.new(name, definition, name_with_version, openapi_spec)
  end
  arr
end

#version ⇒ Object 



155
156
157
 
# File 'lib/generator/api.rb', line 155

def version
  model["info"]["version"].tr("-", "_")
end