bushido 0.0.29 → 0.0.30

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 (71) hide show
  1. data/Gemfile +23 -0
  2. data/Rakefile +9 -3
  3. data/app/controllers/bushido/data_controller.rb +4 -2
  4. data/app/controllers/bushido/envs_controller.rb +11 -3
  5. data/bushido.gemspec +1 -0
  6. data/lib/bushido/data.rb +44 -29
  7. data/lib/bushido/envs.rb +3 -31
  8. data/lib/bushido/hooks.rb +38 -0
  9. data/lib/bushido/ido_schema.rb +17 -0
  10. data/lib/bushido/middleware.rb +6 -5
  11. data/lib/bushido/models.rb +144 -0
  12. data/lib/bushido/orm/active_record.rb +44 -0
  13. data/lib/bushido/orm/mongoid.rb +31 -0
  14. data/lib/bushido/platform.rb +4 -1
  15. data/lib/bushido/schema.rb +42 -0
  16. data/lib/bushido/version.rb +1 -1
  17. data/lib/bushido.rb +17 -2
  18. data/lib/engine.rb +4 -7
  19. data/lib/generators/active_record/bushido_generator.rb +28 -0
  20. data/lib/generators/active_record/templates/migration.rb +20 -0
  21. data/lib/generators/bushido/bushido_generator.rb +14 -0
  22. data/lib/generators/bushido/install_generator.rb +24 -0
  23. data/lib/generators/bushido/orm_helpers.rb +21 -0
  24. data/lib/generators/mongoid/bushido_generator.rb +17 -0
  25. data/lib/generators/templates/README +5 -0
  26. data/lib/generators/templates/bushido.rb +10 -0
  27. data/lib/rails/#routes.rb# +16 -0
  28. data/test/controllers/envs_controller_test.rb +21 -0
  29. data/test/rails_app/Rakefile +9 -0
  30. data/test/rails_app/app/controllers/application_controller.rb +7 -0
  31. data/test/rails_app/app/helpers/application_helper.rb +2 -0
  32. data/test/rails_app/app/views/application/index.html.erb +1 -0
  33. data/test/rails_app/app/views/layouts/application.html.erb +14 -0
  34. data/test/rails_app/config/application.rb +50 -0
  35. data/test/rails_app/config/boot.rb +10 -0
  36. data/test/rails_app/config/database.yml +22 -0
  37. data/test/rails_app/config/environment.rb +5 -0
  38. data/test/rails_app/config/environments/development.rb +26 -0
  39. data/test/rails_app/config/environments/production.rb +49 -0
  40. data/test/rails_app/config/environments/test.rb +35 -0
  41. data/test/rails_app/config/initializers/backtrace_silencers.rb +7 -0
  42. data/test/rails_app/config/initializers/inflections.rb +10 -0
  43. data/test/rails_app/config/initializers/mime_types.rb +5 -0
  44. data/test/rails_app/config/initializers/secret_token.rb +7 -0
  45. data/test/rails_app/config/initializers/session_store.rb +8 -0
  46. data/test/rails_app/config/locales/en.yml +5 -0
  47. data/test/rails_app/config/routes.rb +62 -0
  48. data/test/rails_app/config.ru +4 -0
  49. data/test/rails_app/db/development.sqlite3 +0 -0
  50. data/test/rails_app/db/test.sqlite3 +0 -0
  51. data/test/rails_app/log/development.log +66 -0
  52. data/test/rails_app/log/production.log +0 -0
  53. data/test/rails_app/log/server.log +0 -0
  54. data/test/rails_app/log/test.log +0 -0
  55. data/test/rails_app/public/404.html +26 -0
  56. data/test/rails_app/public/422.html +26 -0
  57. data/test/rails_app/public/500.html +26 -0
  58. data/test/rails_app/public/favicon.ico +0 -0
  59. data/test/rails_app/public/javascripts/application.js +2 -0
  60. data/test/rails_app/public/javascripts/controls.js +965 -0
  61. data/test/rails_app/public/javascripts/dragdrop.js +974 -0
  62. data/test/rails_app/public/javascripts/effects.js +1123 -0
  63. data/test/rails_app/public/javascripts/prototype.js +6001 -0
  64. data/test/rails_app/public/javascripts/rails.js +191 -0
  65. data/test/rails_app/public/stylesheets/.gitkeep +0 -0
  66. data/test/rails_app/script/rails +6 -0
  67. data/test/test_helper.rb +9 -0
  68. metadata +154 -79
  69. data/config/routes.rb +0 -1
  70. data/test/routes_test.rb +0 -12
  71. data/test/test_executable.rb +0 -10
@@ -0,0 +1,191 @@
1
+ (function() {
2
+ // Technique from Juriy Zaytsev
3
+ // http://thinkweb2.com/projects/prototype/detecting-event-support-without-browser-sniffing/
4
+ function isEventSupported(eventName) {
5
+ var el = document.createElement('div');
6
+ eventName = 'on' + eventName;
7
+ var isSupported = (eventName in el);
8
+ if (!isSupported) {
9
+ el.setAttribute(eventName, 'return;');
10
+ isSupported = typeof el[eventName] == 'function';
11
+ }
12
+ el = null;
13
+ return isSupported;
14
+ }
15
+
16
+ function isForm(element) {
17
+ return Object.isElement(element) && element.nodeName.toUpperCase() == 'FORM'
18
+ }
19
+
20
+ function isInput(element) {
21
+ if (Object.isElement(element)) {
22
+ var name = element.nodeName.toUpperCase()
23
+ return name == 'INPUT' || name == 'SELECT' || name == 'TEXTAREA'
24
+ }
25
+ else return false
26
+ }
27
+
28
+ var submitBubbles = isEventSupported('submit'),
29
+ changeBubbles = isEventSupported('change')
30
+
31
+ if (!submitBubbles || !changeBubbles) {
32
+ // augment the Event.Handler class to observe custom events when needed
33
+ Event.Handler.prototype.initialize = Event.Handler.prototype.initialize.wrap(
34
+ function(init, element, eventName, selector, callback) {
35
+ init(element, eventName, selector, callback)
36
+ // is the handler being attached to an element that doesn't support this event?
37
+ if ( (!submitBubbles && this.eventName == 'submit' && !isForm(this.element)) ||
38
+ (!changeBubbles && this.eventName == 'change' && !isInput(this.element)) ) {
39
+ // "submit" => "emulated:submit"
40
+ this.eventName = 'emulated:' + this.eventName
41
+ }
42
+ }
43
+ )
44
+ }
45
+
46
+ if (!submitBubbles) {
47
+ // discover forms on the page by observing focus events which always bubble
48
+ document.on('focusin', 'form', function(focusEvent, form) {
49
+ // special handler for the real "submit" event (one-time operation)
50
+ if (!form.retrieve('emulated:submit')) {
51
+ form.on('submit', function(submitEvent) {
52
+ var emulated = form.fire('emulated:submit', submitEvent, true)
53
+ // if custom event received preventDefault, cancel the real one too
54
+ if (emulated.returnValue === false) submitEvent.preventDefault()
55
+ })
56
+ form.store('emulated:submit', true)
57
+ }
58
+ })
59
+ }
60
+
61
+ if (!changeBubbles) {
62
+ // discover form inputs on the page
63
+ document.on('focusin', 'input, select, texarea', function(focusEvent, input) {
64
+ // special handler for real "change" events
65
+ if (!input.retrieve('emulated:change')) {
66
+ input.on('change', function(changeEvent) {
67
+ input.fire('emulated:change', changeEvent, true)
68
+ })
69
+ input.store('emulated:change', true)
70
+ }
71
+ })
72
+ }
73
+
74
+ function handleRemote(element) {
75
+ var method, url, params;
76
+
77
+ var event = element.fire("ajax:before");
78
+ if (event.stopped) return false;
79
+
80
+ if (element.tagName.toLowerCase() === 'form') {
81
+ method = element.readAttribute('method') || 'post';
82
+ url = element.readAttribute('action');
83
+ params = element.serialize();
84
+ } else {
85
+ method = element.readAttribute('data-method') || 'get';
86
+ url = element.readAttribute('href');
87
+ params = {};
88
+ }
89
+
90
+ new Ajax.Request(url, {
91
+ method: method,
92
+ parameters: params,
93
+ evalScripts: true,
94
+
95
+ onComplete: function(request) { element.fire("ajax:complete", request); },
96
+ onSuccess: function(request) { element.fire("ajax:success", request); },
97
+ onFailure: function(request) { element.fire("ajax:failure", request); }
98
+ });
99
+
100
+ element.fire("ajax:after");
101
+ }
102
+
103
+ function handleMethod(element) {
104
+ var method = element.readAttribute('data-method'),
105
+ url = element.readAttribute('href'),
106
+ csrf_param = $$('meta[name=csrf-param]')[0],
107
+ csrf_token = $$('meta[name=csrf-token]')[0];
108
+
109
+ var form = new Element('form', { method: "POST", action: url, style: "display: none;" });
110
+ element.parentNode.insert(form);
111
+
112
+ if (method !== 'post') {
113
+ var field = new Element('input', { type: 'hidden', name: '_method', value: method });
114
+ form.insert(field);
115
+ }
116
+
117
+ if (csrf_param) {
118
+ var param = csrf_param.readAttribute('content'),
119
+ token = csrf_token.readAttribute('content'),
120
+ field = new Element('input', { type: 'hidden', name: param, value: token });
121
+ form.insert(field);
122
+ }
123
+
124
+ form.submit();
125
+ }
126
+
127
+
128
+ document.on("click", "*[data-confirm]", function(event, element) {
129
+ var message = element.readAttribute('data-confirm');
130
+ if (!confirm(message)) event.stop();
131
+ });
132
+
133
+ document.on("click", "a[data-remote]", function(event, element) {
134
+ if (event.stopped) return;
135
+ handleRemote(element);
136
+ event.stop();
137
+ });
138
+
139
+ document.on("click", "a[data-method]", function(event, element) {
140
+ if (event.stopped) return;
141
+ handleMethod(element);
142
+ event.stop();
143
+ });
144
+
145
+ document.on("submit", function(event) {
146
+ var element = event.findElement(),
147
+ message = element.readAttribute('data-confirm');
148
+ if (message && !confirm(message)) {
149
+ event.stop();
150
+ return false;
151
+ }
152
+
153
+ var inputs = element.select("input[type=submit][data-disable-with]");
154
+ inputs.each(function(input) {
155
+ input.disabled = true;
156
+ input.writeAttribute('data-original-value', input.value);
157
+ input.value = input.readAttribute('data-disable-with');
158
+ });
159
+
160
+ var element = event.findElement("form[data-remote]");
161
+ if (element) {
162
+ handleRemote(element);
163
+ event.stop();
164
+ }
165
+ });
166
+
167
+ document.on("ajax:after", "form", function(event, element) {
168
+ var inputs = element.select("input[type=submit][disabled=true][data-disable-with]");
169
+ inputs.each(function(input) {
170
+ input.value = input.readAttribute('data-original-value');
171
+ input.removeAttribute('data-original-value');
172
+ input.disabled = false;
173
+ });
174
+ });
175
+
176
+ Ajax.Responders.register({
177
+ onCreate: function(request) {
178
+ var csrf_meta_tag = $$('meta[name=csrf-token]')[0];
179
+
180
+ if (csrf_meta_tag) {
181
+ var header = 'X-CSRF-Token',
182
+ token = csrf_meta_tag.readAttribute('content');
183
+
184
+ if (!request.options.requestHeaders) {
185
+ request.options.requestHeaders = {};
186
+ }
187
+ request.options.requestHeaders[header] = token;
188
+ }
189
+ }
190
+ });
191
+ })();
File without changes
@@ -0,0 +1,6 @@
1
+ #!/usr/bin/env ruby
2
+ # This command will automatically be run when you run "rails" with Rails 3 gems installed from the root of your application.
3
+
4
+ APP_PATH = File.expand_path('../../config/application', __FILE__)
5
+ require File.expand_path('../../config/boot', __FILE__)
6
+ require 'rails/commands'
@@ -0,0 +1,9 @@
1
+ ENV["RAILS_ENV"] = "test"
2
+ ENV["BUSHIDO_APP_KEY"] = "bushidoappkey"
3
+ require "rubygems"
4
+ require "bundler"
5
+ Bundler.setup
6
+
7
+ require "rails_app/config/environment"
8
+ require "rails/test_help"
9
+ require "rails/generators/test_case"
metadata CHANGED
@@ -1,83 +1,71 @@
1
- --- !ruby/object:Gem::Specification
1
+ --- !ruby/object:Gem::Specification
2
2
  name: bushido
3
- version: !ruby/object:Gem::Version
4
- hash: 37
5
- prerelease: false
6
- segments:
7
- - 0
8
- - 0
9
- - 29
10
- version: 0.0.29
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.0.30
5
+ prerelease:
11
6
  platform: ruby
12
- authors:
7
+ authors:
13
8
  - Sean Grove
14
9
  - Kev Zettler
15
10
  autorequire:
16
11
  bindir: bin
17
12
  cert_chain: []
18
-
19
- date: 2011-06-22 00:00:00 -07:00
13
+ date: 2011-07-20 00:00:00.000000000 -07:00
20
14
  default_executable:
21
- dependencies:
22
- - !ruby/object:Gem::Dependency
15
+ dependencies:
16
+ - !ruby/object:Gem::Dependency
23
17
  name: rest-client
24
- prerelease: false
25
- requirement: &id001 !ruby/object:Gem::Requirement
18
+ requirement: &2151803600 !ruby/object:Gem::Requirement
26
19
  none: false
27
- requirements:
28
- - - ">="
29
- - !ruby/object:Gem::Version
30
- hash: 13
31
- segments:
32
- - 1
33
- - 6
34
- - 1
20
+ requirements:
21
+ - - ! '>='
22
+ - !ruby/object:Gem::Version
35
23
  version: 1.6.1
36
24
  type: :runtime
37
- version_requirements: *id001
38
- - !ruby/object:Gem::Dependency
39
- name: json
40
25
  prerelease: false
41
- requirement: &id002 !ruby/object:Gem::Requirement
26
+ version_requirements: *2151803600
27
+ - !ruby/object:Gem::Dependency
28
+ name: json
29
+ requirement: &2151801420 !ruby/object:Gem::Requirement
42
30
  none: false
43
- requirements:
44
- - - ">="
45
- - !ruby/object:Gem::Version
46
- hash: 11
47
- segments:
48
- - 1
49
- - 4
50
- - 6
31
+ requirements:
32
+ - - ! '>='
33
+ - !ruby/object:Gem::Version
51
34
  version: 1.4.6
52
35
  type: :runtime
53
- version_requirements: *id002
54
- - !ruby/object:Gem::Dependency
55
- name: highline
56
36
  prerelease: false
57
- requirement: &id003 !ruby/object:Gem::Requirement
37
+ version_requirements: *2151801420
38
+ - !ruby/object:Gem::Dependency
39
+ name: highline
40
+ requirement: &2151800220 !ruby/object:Gem::Requirement
58
41
  none: false
59
- requirements:
60
- - - ">="
61
- - !ruby/object:Gem::Version
62
- hash: 13
63
- segments:
64
- - 1
65
- - 6
66
- - 1
42
+ requirements:
43
+ - - ! '>='
44
+ - !ruby/object:Gem::Version
67
45
  version: 1.6.1
68
46
  type: :runtime
69
- version_requirements: *id003
47
+ prerelease: false
48
+ version_requirements: *2151800220
49
+ - !ruby/object:Gem::Dependency
50
+ name: orm_adapter
51
+ requirement: &2151798860 !ruby/object:Gem::Requirement
52
+ none: false
53
+ requirements:
54
+ - - ~>
55
+ - !ruby/object:Gem::Version
56
+ version: 0.0.3
57
+ type: :runtime
58
+ prerelease: false
59
+ version_requirements: *2151798860
70
60
  description: A module for integrating the Bushido platform into a rails app
71
- email:
61
+ email:
72
62
  - support@bushi.do
73
63
  - s@bushi.do
74
- executables:
64
+ executables:
75
65
  - bushido
76
66
  extensions: []
77
-
78
67
  extra_rdoc_files: []
79
-
80
- files:
68
+ files:
81
69
  - .gitignore
82
70
  - Gemfile
83
71
  - Rakefile
@@ -85,56 +73,143 @@ files:
85
73
  - app/controllers/bushido/envs_controller.rb
86
74
  - bin/bushido
87
75
  - bushido.gemspec
88
- - config/routes.rb
89
76
  - lib/bushido.rb
90
77
  - lib/bushido/app.rb
91
78
  - lib/bushido/command.rb
92
79
  - lib/bushido/data.rb
93
80
  - lib/bushido/envs.rb
94
81
  - lib/bushido/event.rb
82
+ - lib/bushido/hooks.rb
83
+ - lib/bushido/ido_schema.rb
95
84
  - lib/bushido/middleware.rb
85
+ - lib/bushido/models.rb
86
+ - lib/bushido/orm/active_record.rb
87
+ - lib/bushido/orm/mongoid.rb
96
88
  - lib/bushido/platform.rb
89
+ - lib/bushido/schema.rb
97
90
  - lib/bushido/user.rb
98
91
  - lib/bushido/utils.rb
99
92
  - lib/bushido/version.rb
100
93
  - lib/engine.rb
94
+ - lib/generators/active_record/bushido_generator.rb
95
+ - lib/generators/active_record/templates/migration.rb
96
+ - lib/generators/bushido/bushido_generator.rb
97
+ - lib/generators/bushido/install_generator.rb
98
+ - lib/generators/bushido/orm_helpers.rb
99
+ - lib/generators/mongoid/bushido_generator.rb
100
+ - lib/generators/templates/README
101
+ - lib/generators/templates/bushido.rb
102
+ - lib/rails/#routes.rb#
101
103
  - lib/rails/routes.rb
102
- - test/routes_test.rb
103
- - test/test_executable.rb
104
+ - test/controllers/envs_controller_test.rb
105
+ - test/rails_app/Rakefile
106
+ - test/rails_app/app/controllers/application_controller.rb
107
+ - test/rails_app/app/helpers/application_helper.rb
108
+ - test/rails_app/app/views/application/index.html.erb
109
+ - test/rails_app/app/views/layouts/application.html.erb
110
+ - test/rails_app/config.ru
111
+ - test/rails_app/config/application.rb
112
+ - test/rails_app/config/boot.rb
113
+ - test/rails_app/config/database.yml
114
+ - test/rails_app/config/environment.rb
115
+ - test/rails_app/config/environments/development.rb
116
+ - test/rails_app/config/environments/production.rb
117
+ - test/rails_app/config/environments/test.rb
118
+ - test/rails_app/config/initializers/backtrace_silencers.rb
119
+ - test/rails_app/config/initializers/inflections.rb
120
+ - test/rails_app/config/initializers/mime_types.rb
121
+ - test/rails_app/config/initializers/secret_token.rb
122
+ - test/rails_app/config/initializers/session_store.rb
123
+ - test/rails_app/config/locales/en.yml
124
+ - test/rails_app/config/routes.rb
125
+ - test/rails_app/db/development.sqlite3
126
+ - test/rails_app/db/test.sqlite3
127
+ - test/rails_app/log/development.log
128
+ - test/rails_app/log/production.log
129
+ - test/rails_app/log/server.log
130
+ - test/rails_app/log/test.log
131
+ - test/rails_app/public/404.html
132
+ - test/rails_app/public/422.html
133
+ - test/rails_app/public/500.html
134
+ - test/rails_app/public/favicon.ico
135
+ - test/rails_app/public/javascripts/application.js
136
+ - test/rails_app/public/javascripts/controls.js
137
+ - test/rails_app/public/javascripts/dragdrop.js
138
+ - test/rails_app/public/javascripts/effects.js
139
+ - test/rails_app/public/javascripts/prototype.js
140
+ - test/rails_app/public/javascripts/rails.js
141
+ - test/rails_app/public/stylesheets/.gitkeep
142
+ - test/rails_app/script/rails
143
+ - test/test_helper.rb
104
144
  has_rdoc: true
105
145
  homepage: https://github.com/sgrove/bushidogem
106
146
  licenses: []
107
-
108
147
  post_install_message:
109
148
  rdoc_options: []
110
-
111
- require_paths:
149
+ require_paths:
112
150
  - lib
113
- required_ruby_version: !ruby/object:Gem::Requirement
151
+ required_ruby_version: !ruby/object:Gem::Requirement
114
152
  none: false
115
- requirements:
116
- - - ">="
117
- - !ruby/object:Gem::Version
118
- hash: 3
119
- segments:
153
+ requirements:
154
+ - - ! '>='
155
+ - !ruby/object:Gem::Version
156
+ version: '0'
157
+ segments:
120
158
  - 0
121
- version: "0"
122
- required_rubygems_version: !ruby/object:Gem::Requirement
159
+ hash: 1185013954013927202
160
+ required_rubygems_version: !ruby/object:Gem::Requirement
123
161
  none: false
124
- requirements:
125
- - - ">="
126
- - !ruby/object:Gem::Version
127
- hash: 3
128
- segments:
162
+ requirements:
163
+ - - ! '>='
164
+ - !ruby/object:Gem::Version
165
+ version: '0'
166
+ segments:
129
167
  - 0
130
- version: "0"
168
+ hash: 1185013954013927202
131
169
  requirements: []
132
-
133
170
  rubyforge_project: bushido
134
- rubygems_version: 1.3.7
171
+ rubygems_version: 1.6.2
135
172
  signing_key:
136
173
  specification_version: 3
137
174
  summary: Bushido integration
138
- test_files:
139
- - test/routes_test.rb
140
- - test/test_executable.rb
175
+ test_files:
176
+ - test/controllers/envs_controller_test.rb
177
+ - test/rails_app/Rakefile
178
+ - test/rails_app/app/controllers/application_controller.rb
179
+ - test/rails_app/app/helpers/application_helper.rb
180
+ - test/rails_app/app/views/application/index.html.erb
181
+ - test/rails_app/app/views/layouts/application.html.erb
182
+ - test/rails_app/config.ru
183
+ - test/rails_app/config/application.rb
184
+ - test/rails_app/config/boot.rb
185
+ - test/rails_app/config/database.yml
186
+ - test/rails_app/config/environment.rb
187
+ - test/rails_app/config/environments/development.rb
188
+ - test/rails_app/config/environments/production.rb
189
+ - test/rails_app/config/environments/test.rb
190
+ - test/rails_app/config/initializers/backtrace_silencers.rb
191
+ - test/rails_app/config/initializers/inflections.rb
192
+ - test/rails_app/config/initializers/mime_types.rb
193
+ - test/rails_app/config/initializers/secret_token.rb
194
+ - test/rails_app/config/initializers/session_store.rb
195
+ - test/rails_app/config/locales/en.yml
196
+ - test/rails_app/config/routes.rb
197
+ - test/rails_app/db/development.sqlite3
198
+ - test/rails_app/db/test.sqlite3
199
+ - test/rails_app/log/development.log
200
+ - test/rails_app/log/production.log
201
+ - test/rails_app/log/server.log
202
+ - test/rails_app/log/test.log
203
+ - test/rails_app/public/404.html
204
+ - test/rails_app/public/422.html
205
+ - test/rails_app/public/500.html
206
+ - test/rails_app/public/favicon.ico
207
+ - test/rails_app/public/javascripts/application.js
208
+ - test/rails_app/public/javascripts/controls.js
209
+ - test/rails_app/public/javascripts/dragdrop.js
210
+ - test/rails_app/public/javascripts/effects.js
211
+ - test/rails_app/public/javascripts/prototype.js
212
+ - test/rails_app/public/javascripts/rails.js
213
+ - test/rails_app/public/stylesheets/.gitkeep
214
+ - test/rails_app/script/rails
215
+ - test/test_helper.rb
data/config/routes.rb DELETED
@@ -1 +0,0 @@
1
-
data/test/routes_test.rb DELETED
@@ -1,12 +0,0 @@
1
- require 'test_helper'
2
-
3
- class DefaultRoutingTest < ActionController::TestCase
4
- test 'set passed variable' do
5
- assert_recognizes({:controller => 'bushido', :action => 'index'}, {:path => 'bushido', :method => :post})
6
- end
7
-
8
- test 'get passed variable' do
9
- assert_recognizes({:controller => 'bushido', :action => 'index'}, {:path => 'bushido', :method => :get})
10
- end
11
-
12
- end
@@ -1,10 +0,0 @@
1
- require 'test/unit'
2
-
3
- class TestExecutable < Test::Unit::TestCase #:nodoc:
4
- EXECUTABLE =
5
- def test_complains_with_no_args
6
- output = %x{#{File.expand_path('../../bin/bushido', __FILE__)}}
7
- assert output =~ /See bushido -h for more detailed instructions/
8
- end
9
- end
10
-