BigW Consortium Gitlab

services.rake 2.29 KB
Newer Older
Kirilll Zaitsev committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
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] %>

```

43 44 45 46 47 48 49 50 51
### Get <%= service[:title] %> service settings

Get <%= service[:title] %> service settings for a project.

```
GET /projects/:id/services/<%= service[:dashed_name] %>

```

Kirilll Zaitsev committed
52 53 54 55
<% end %>
ERB

namespace :services do
56
  task doc: :environment do
Kirilll Zaitsev committed
57 58 59
    services = Service.available_services_names.map do |s|
      service_start = Time.now
      klass = "#{s}_service".classify.constantize
60

Kirilll Zaitsev committed
61 62 63 64 65 66 67 68 69 70 71 72 73
      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]
74
        param_hash[:required] = klass.validators_on(p[:name].to_sym).any? do |v|
Kirilll Zaitsev committed
75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98
          v.class == ActiveRecord::Validations::PresenceValidator
        end

        param_hash
      end.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, 0 , '>')
      .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.to_s}, #{Time.now-doc_start}"

  end
end