98 lines
2.3 KiB
Ruby
98 lines
2.3 KiB
Ruby
services_template = <<-ERB
|
|
# Services
|
|
|
|
<% services.each do |service| %>
|
|
## <%= service[:title] %>
|
|
|
|
|
|
<% unless service[:description].blank? %>
|
|
<%= service[:description] %>
|
|
<% end %>
|
|
|
|
|
|
### Create/Edit <%= service[:title] %> service
|
|
|
|
Set <%= service[:title] %> service for a project.
|
|
<% unless service[:help].blank? %>
|
|
|
|
> <%= service[:help].gsub("\n", ' ') %>
|
|
|
|
<% end %>
|
|
|
|
```
|
|
PUT /projects/:id/services/<%= service[:dashed_name] %>
|
|
|
|
```
|
|
|
|
Parameters:
|
|
|
|
<% service[:params].each do |param| %>
|
|
- `<%= param[:name] %>` <%= param[:required] ? "(**required**)" : "(optional)" %><%= [" -", param[:description]].join(" ").gsub("\n", '') unless param[:description].blank? %>
|
|
|
|
<% end %>
|
|
|
|
### Delete <%= service[:title] %> service
|
|
|
|
Delete <%= service[:title] %> service for a project.
|
|
|
|
```
|
|
DELETE /projects/:id/services/<%= service[:dashed_name] %>
|
|
|
|
```
|
|
|
|
### Get <%= service[:title] %> service settings
|
|
|
|
Get <%= service[:title] %> service settings for a project.
|
|
|
|
```
|
|
GET /projects/:id/services/<%= service[:dashed_name] %>
|
|
|
|
```
|
|
|
|
<% end %>
|
|
ERB
|
|
|
|
namespace :services do
|
|
task doc: :environment do
|
|
services = Service.available_services_names.map do |s|
|
|
service_start = Time.now
|
|
klass = "#{s}_service".classify.constantize
|
|
|
|
service = klass.new
|
|
|
|
service_hash = {}
|
|
|
|
service_hash[:title] = service.title
|
|
service_hash[:dashed_name] = s.dasherize
|
|
service_hash[:description] = service.description
|
|
service_hash[:help] = service.help
|
|
service_hash[:params] = service.fields.map do |p|
|
|
param_hash = {}
|
|
|
|
param_hash[:name] = p[:name]
|
|
param_hash[:description] = p[:placeholder] || p[:title]
|
|
param_hash[:required] = klass.validators_on(p[:name].to_sym).any? do |v|
|
|
v.class == ActiveRecord::Validations::PresenceValidator
|
|
end
|
|
|
|
param_hash
|
|
end
|
|
service_hash[:params].sort_by! { |p| p[:required] ? 0 : 1 }
|
|
|
|
puts "Collected data for: #{service.title}, #{Time.now - service_start}"
|
|
service_hash
|
|
end
|
|
|
|
doc_start = Time.now
|
|
doc_path = File.join(Rails.root, 'doc', 'api', 'services.md')
|
|
|
|
result = ERB.new(services_template, trim_mode: '>')
|
|
.result(OpenStruct.new(services: services).instance_eval { binding })
|
|
|
|
File.open(doc_path, 'w') do |f|
|
|
f.write result
|
|
end
|
|
|
|
puts "write a new service.md to: #{doc_path}, #{Time.now - doc_start}"
|
|
end
|
|
end
|