azure-plus 0.6.5

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 (298) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +13 -0
  3. data/.travis.yml +11 -0
  4. data/ChangeLog.txt +40 -0
  5. data/Gemfile +16 -0
  6. data/README.md +590 -0
  7. data/Rakefile +129 -0
  8. data/azure.gemspec +47 -0
  9. data/lib/azure.rb +52 -0
  10. data/lib/azure/base_management/affinity_group.rb +32 -0
  11. data/lib/azure/base_management/base_management_service.rb +238 -0
  12. data/lib/azure/base_management/location.rb +27 -0
  13. data/lib/azure/base_management/management_http_request.rb +244 -0
  14. data/lib/azure/base_management/serialization.rb +129 -0
  15. data/lib/azure/base_management/sql_management_http_request.rb +45 -0
  16. data/lib/azure/blob/blob.rb +32 -0
  17. data/lib/azure/blob/blob_service.rb +1424 -0
  18. data/lib/azure/blob/block.rb +31 -0
  19. data/lib/azure/blob/container.rb +32 -0
  20. data/lib/azure/blob/serialization.rb +285 -0
  21. data/lib/azure/cloud_service_management/cloud_service.rb +38 -0
  22. data/lib/azure/cloud_service_management/cloud_service_management_service.rb +361 -0
  23. data/lib/azure/cloud_service_management/configuration_set.rb +28 -0
  24. data/lib/azure/cloud_service_management/deployment.rb +64 -0
  25. data/lib/azure/cloud_service_management/input_endpoint.rb +29 -0
  26. data/lib/azure/cloud_service_management/instance_endpoint.rb +31 -0
  27. data/lib/azure/cloud_service_management/persistent_vm_downtime.rb +29 -0
  28. data/lib/azure/cloud_service_management/role.rb +30 -0
  29. data/lib/azure/cloud_service_management/role_instance.rb +40 -0
  30. data/lib/azure/cloud_service_management/serialization.rb +329 -0
  31. data/lib/azure/cloud_service_management/virtual_ip.rb +29 -0
  32. data/lib/azure/core.rb +39 -0
  33. data/lib/azure/core/auth/authorizer.rb +36 -0
  34. data/lib/azure/core/auth/shared_key.rb +110 -0
  35. data/lib/azure/core/auth/shared_key_lite.rb +48 -0
  36. data/lib/azure/core/auth/signer.rb +48 -0
  37. data/lib/azure/core/configuration.rb +211 -0
  38. data/lib/azure/core/error.rb +22 -0
  39. data/lib/azure/core/filtered_service.rb +44 -0
  40. data/lib/azure/core/http/debug_filter.rb +36 -0
  41. data/lib/azure/core/http/http_error.rb +88 -0
  42. data/lib/azure/core/http/http_filter.rb +53 -0
  43. data/lib/azure/core/http/http_request.rb +159 -0
  44. data/lib/azure/core/http/http_response.rb +140 -0
  45. data/lib/azure/core/http/retry_policy.rb +74 -0
  46. data/lib/azure/core/http/signer_filter.rb +34 -0
  47. data/lib/azure/core/service.rb +63 -0
  48. data/lib/azure/core/signed_service.rb +43 -0
  49. data/lib/azure/core/utility.rb +190 -0
  50. data/lib/azure/queue/message.rb +30 -0
  51. data/lib/azure/queue/queue.rb +29 -0
  52. data/lib/azure/queue/queue_service.rb +568 -0
  53. data/lib/azure/queue/serialization.rb +106 -0
  54. data/lib/azure/service/access_policy.rb +26 -0
  55. data/lib/azure/service/enumeration_results.rb +21 -0
  56. data/lib/azure/service/logging.rb +32 -0
  57. data/lib/azure/service/metrics.rb +31 -0
  58. data/lib/azure/service/retention_policy.rb +25 -0
  59. data/lib/azure/service/serialization.rb +240 -0
  60. data/lib/azure/service/signed_identifier.rb +30 -0
  61. data/lib/azure/service/storage_service.rb +79 -0
  62. data/lib/azure/service/storage_service_properties.rb +32 -0
  63. data/lib/azure/service_bus/action.rb +21 -0
  64. data/lib/azure/service_bus/auth/wrap_service.rb +89 -0
  65. data/lib/azure/service_bus/auth/wrap_signer.rb +69 -0
  66. data/lib/azure/service_bus/brokered_message.rb +124 -0
  67. data/lib/azure/service_bus/brokered_message_serializer.rb +159 -0
  68. data/lib/azure/service_bus/correlation_filter.rb +45 -0
  69. data/lib/azure/service_bus/empty_rule_action.rb +30 -0
  70. data/lib/azure/service_bus/false_filter.rb +38 -0
  71. data/lib/azure/service_bus/filter.rb +21 -0
  72. data/lib/azure/service_bus/interval.rb +104 -0
  73. data/lib/azure/service_bus/queue.rb +230 -0
  74. data/lib/azure/service_bus/resource.rb +109 -0
  75. data/lib/azure/service_bus/rule.rb +98 -0
  76. data/lib/azure/service_bus/rule_aspect.rb +34 -0
  77. data/lib/azure/service_bus/serialization.rb +160 -0
  78. data/lib/azure/service_bus/service_bus_service.rb +829 -0
  79. data/lib/azure/service_bus/sql_filter.rb +50 -0
  80. data/lib/azure/service_bus/sql_rule_action.rb +50 -0
  81. data/lib/azure/service_bus/subscription.rb +184 -0
  82. data/lib/azure/service_bus/topic.rb +187 -0
  83. data/lib/azure/service_bus/true_filter.rb +38 -0
  84. data/lib/azure/sql_database_management/serialization.rb +111 -0
  85. data/lib/azure/sql_database_management/sql_database.rb +31 -0
  86. data/lib/azure/sql_database_management/sql_database_management_service.rb +200 -0
  87. data/lib/azure/storage_management/serialization.rb +184 -0
  88. data/lib/azure/storage_management/storage_account.rb +40 -0
  89. data/lib/azure/storage_management/storage_management_service.rb +166 -0
  90. data/lib/azure/table/auth/shared_key.rb +92 -0
  91. data/lib/azure/table/auth/shared_key_lite.rb +44 -0
  92. data/lib/azure/table/batch.rb +330 -0
  93. data/lib/azure/table/batch_response.rb +118 -0
  94. data/lib/azure/table/edmtype.rb +127 -0
  95. data/lib/azure/table/entity.rb +31 -0
  96. data/lib/azure/table/guid.rb +24 -0
  97. data/lib/azure/table/query.rb +112 -0
  98. data/lib/azure/table/serialization.rb +108 -0
  99. data/lib/azure/table/table_service.rb +560 -0
  100. data/lib/azure/version.rb +31 -0
  101. data/lib/azure/virtual_machine_image_management/serialization.rb +51 -0
  102. data/lib/azure/virtual_machine_image_management/virtual_machine_disk.rb +25 -0
  103. data/lib/azure/virtual_machine_image_management/virtual_machine_image.rb +25 -0
  104. data/lib/azure/virtual_machine_image_management/virtual_machine_image_management_service.rb +66 -0
  105. data/lib/azure/virtual_machine_management/serialization.rb +436 -0
  106. data/lib/azure/virtual_machine_management/virtual_machine.rb +42 -0
  107. data/lib/azure/virtual_machine_management/virtual_machine_management_service.rb +549 -0
  108. data/lib/azure/virtual_network_management/serialization.rb +186 -0
  109. data/lib/azure/virtual_network_management/virtual_network.rb +36 -0
  110. data/lib/azure/virtual_network_management/virtual_network_management_service.rb +109 -0
  111. data/test/fixtures/32px-fulls-black.jpg +0 -0
  112. data/test/fixtures/affinity_group.xml +33 -0
  113. data/test/fixtures/all_containers.xml +20 -0
  114. data/test/fixtures/all_tables.xml +22 -0
  115. data/test/fixtures/certificate.pem +21 -0
  116. data/test/fixtures/container_acl.xml +11 -0
  117. data/test/fixtures/create_sql_database_server.xml +2 -0
  118. data/test/fixtures/create_storage_desc_error.xml +5 -0
  119. data/test/fixtures/create_storage_extendedprop_error.xml +8 -0
  120. data/test/fixtures/create_storage_extendedpropname_error.xml +6 -0
  121. data/test/fixtures/create_storage_full_error.xml +6 -0
  122. data/test/fixtures/create_storage_label_error.xml +5 -0
  123. data/test/fixtures/create_storage_location_error.xml +5 -0
  124. data/test/fixtures/create_storage_name_error.xml +6 -0
  125. data/test/fixtures/create_table_response_entry.xml +15 -0
  126. data/test/fixtures/delete_storage_container_error.xml +5 -0
  127. data/test/fixtures/delete_storage_error.xml +5 -0
  128. data/test/fixtures/deployment_error.xml +5 -0
  129. data/test/fixtures/empty_xml_file +0 -0
  130. data/test/fixtures/get_deployment.xml +94 -0
  131. data/test/fixtures/get_deployment_existing.xml +94 -0
  132. data/test/fixtures/get_deployment_missing.xml +5 -0
  133. data/test/fixtures/get_storage_account_error.xml +5 -0
  134. data/test/fixtures/get_storage_account_properties.xml +32 -0
  135. data/test/fixtures/get_storage_account_properties_new.xml +32 -0
  136. data/test/fixtures/http_error.xml +5 -0
  137. data/test/fixtures/insert_entity_response_entry.xml +25 -0
  138. data/test/fixtures/list_affinity_groups.xml +22 -0
  139. data/test/fixtures/list_blobs.xml +121 -0
  140. data/test/fixtures/list_block_all_with_none_committed.xml +22 -0
  141. data/test/fixtures/list_blocks_all.xml +23 -0
  142. data/test/fixtures/list_blocks_committed.xml +13 -0
  143. data/test/fixtures/list_cloud_services.xml +39 -0
  144. data/test/fixtures/list_containers.xml +38 -0
  145. data/test/fixtures/list_firewall_management_endpoint.xml +27 -0
  146. data/test/fixtures/list_images.xml +110 -0
  147. data/test/fixtures/list_locations.xml +62 -0
  148. data/test/fixtures/list_page_ranges.xml +11 -0
  149. data/test/fixtures/list_sql_database.xml +36 -0
  150. data/test/fixtures/list_sql_server_firewall.xml +23 -0
  151. data/test/fixtures/list_storage_account_single.xml +25 -0
  152. data/test/fixtures/list_storage_accounts.xml +46 -0
  153. data/test/fixtures/list_virtual_networks.xml +92 -0
  154. data/test/fixtures/logging.xml +11 -0
  155. data/test/fixtures/management_certificate.pem +55 -0
  156. data/test/fixtures/messages.xml +12 -0
  157. data/test/fixtures/metrics.xml +10 -0
  158. data/test/fixtures/privatekey.key +28 -0
  159. data/test/fixtures/query_entities_empty_response.xml +7 -0
  160. data/test/fixtures/query_entities_response.xml +45 -0
  161. data/test/fixtures/queue_service_properties.xml +22 -0
  162. data/test/fixtures/queue_service_properties_original.xml +19 -0
  163. data/test/fixtures/queues.xml +16 -0
  164. data/test/fixtures/retention_policy.xml +5 -0
  165. data/test/fixtures/sb_default_create_queue_response.xml +23 -0
  166. data/test/fixtures/sb_default_create_topic_response.xml +18 -0
  167. data/test/fixtures/sb_get_access_token_response.txt +1 -0
  168. data/test/fixtures/sb_queues_runtime_peek_message_response_headers.txt +9 -0
  169. data/test/fixtures/storage_service_properties.xml +23 -0
  170. data/test/fixtures/update_storage_account.xml +16 -0
  171. data/test/fixtures/update_storage_error.xml +5 -0
  172. data/test/fixtures/updated_storage_accounts.xml +53 -0
  173. data/test/fixtures/virtual_machine.xml +113 -0
  174. data/test/fixtures/windows_virtual_machine.xml +106 -0
  175. data/test/integration/affinity_group/Affinity_test.rb +55 -0
  176. data/test/integration/affinity_group/Create_Affinity_test.rb +63 -0
  177. data/test/integration/affinity_group/Delete_Affinity_test.rb +56 -0
  178. data/test/integration/affinity_group/List_Affinity_test.rb +41 -0
  179. data/test/integration/affinity_group/Update_Affinity_test.rb +82 -0
  180. data/test/integration/blob/blob_gb18030_test.rb +199 -0
  181. data/test/integration/blob/blob_metadata_test.rb +75 -0
  182. data/test/integration/blob/blob_pages_test.rb +119 -0
  183. data/test/integration/blob/blob_properties_test.rb +77 -0
  184. data/test/integration/blob/block_blob_test.rb +254 -0
  185. data/test/integration/blob/container/container_acl_test.rb +69 -0
  186. data/test/integration/blob/container/container_metadata_test.rb +50 -0
  187. data/test/integration/blob/container/create_container_test.rb +60 -0
  188. data/test/integration/blob/container/delete_container_test.rb +39 -0
  189. data/test/integration/blob/container/get_container_properties_test.rb +48 -0
  190. data/test/integration/blob/container/list_containers_test.rb +79 -0
  191. data/test/integration/blob/container/root_container_test.rb +54 -0
  192. data/test/integration/blob/copy_blob_test.rb +113 -0
  193. data/test/integration/blob/create_blob_snapshot_test.rb +80 -0
  194. data/test/integration/blob/create_page_blob_test.rb +83 -0
  195. data/test/integration/blob/delete_blob_test.rb +159 -0
  196. data/test/integration/blob/get_blob_test.rb +65 -0
  197. data/test/integration/blob/informative_errors_test.rb +39 -0
  198. data/test/integration/blob/lease/acquire_lease_test.rb +36 -0
  199. data/test/integration/blob/lease/break_lease_test.rb +40 -0
  200. data/test/integration/blob/lease/release_lease_test.rb +40 -0
  201. data/test/integration/blob/lease/renew_lease_test.rb +42 -0
  202. data/test/integration/blob/list_blobs_test.rb +113 -0
  203. data/test/integration/cloud_service/Cloud_Create_test.rb +44 -0
  204. data/test/integration/cloud_service/Cloud_Delete_test.rb +44 -0
  205. data/test/integration/database/create_sql_server_firewall_test.rb +86 -0
  206. data/test/integration/database/create_sql_server_test.rb +53 -0
  207. data/test/integration/database/delete_sql_server_firewall_test.rb +70 -0
  208. data/test/integration/database/delete_sql_server_test.rb +58 -0
  209. data/test/integration/database/list_sql_server_firewall_test.rb +45 -0
  210. data/test/integration/database/list_sql_servers_test.rb +44 -0
  211. data/test/integration/database/reset_password_sql_server_test.rb +55 -0
  212. data/test/integration/location/Location_List_test.rb +39 -0
  213. data/test/integration/queue/clear_messages_test.rb +42 -0
  214. data/test/integration/queue/create_message_test.rb +75 -0
  215. data/test/integration/queue/create_queue_test.rb +50 -0
  216. data/test/integration/queue/delete_message_test.rb +67 -0
  217. data/test/integration/queue/delete_queue_test.rb +45 -0
  218. data/test/integration/queue/informative_errors_test.rb +42 -0
  219. data/test/integration/queue/list_messages_encoded_test.rb +79 -0
  220. data/test/integration/queue/list_messages_test.rb +79 -0
  221. data/test/integration/queue/list_queues_test.rb +44 -0
  222. data/test/integration/queue/peek_messages_test.rb +59 -0
  223. data/test/integration/queue/queue_gb18030_test.rb +131 -0
  224. data/test/integration/queue/queue_metadata_test.rb +40 -0
  225. data/test/integration/queue/update_message_test.rb +74 -0
  226. data/test/integration/service_bus/informative_errors_test.rb +37 -0
  227. data/test/integration/service_bus/queues_scenario_test.rb +200 -0
  228. data/test/integration/service_bus/queues_test.rb +266 -0
  229. data/test/integration/service_bus/rules_test.rb +145 -0
  230. data/test/integration/service_bus/sb_queue_gb18030_test.rb +182 -0
  231. data/test/integration/service_bus/scenario_test.rb +101 -0
  232. data/test/integration/service_bus/subscriptions_test.rb +211 -0
  233. data/test/integration/service_bus/topics_scenario_test.rb +406 -0
  234. data/test/integration/service_bus/topics_test.rb +129 -0
  235. data/test/integration/storage_management/storage_management_test.rb +160 -0
  236. data/test/integration/table/create_table_test.rb +36 -0
  237. data/test/integration/table/delete_entity_batch_test.rb +107 -0
  238. data/test/integration/table/delete_entity_test.rb +94 -0
  239. data/test/integration/table/delete_table_test.rb +40 -0
  240. data/test/integration/table/get_table_test.rb +37 -0
  241. data/test/integration/table/informative_errors_test.rb +39 -0
  242. data/test/integration/table/insert_entity_batch_test.rb +100 -0
  243. data/test/integration/table/insert_entity_test.rb +88 -0
  244. data/test/integration/table/insert_or_merge_entity_batch_test.rb +159 -0
  245. data/test/integration/table/insert_or_merge_entity_test.rb +143 -0
  246. data/test/integration/table/insert_or_replace_entity_batch_test.rb +152 -0
  247. data/test/integration/table/insert_or_replace_entity_test.rb +137 -0
  248. data/test/integration/table/merge_entity_batch_test.rb +128 -0
  249. data/test/integration/table/merge_entity_test.rb +113 -0
  250. data/test/integration/table/query_entities_test.rb +195 -0
  251. data/test/integration/table/query_tables_test.rb +43 -0
  252. data/test/integration/table/query_test.rb +251 -0
  253. data/test/integration/table/table_acl_test.rb +52 -0
  254. data/test/integration/table/table_gb18030_test.rb +355 -0
  255. data/test/integration/table/update_entity_batch_test.rb +149 -0
  256. data/test/integration/table/update_entity_test.rb +131 -0
  257. data/test/integration/test_helper.rb +42 -0
  258. data/test/integration/vm/VM_Create_test.rb +260 -0
  259. data/test/integration/vm/VM_Delete_test.rb +55 -0
  260. data/test/integration/vm/VM_Operations_test.rb +173 -0
  261. data/test/integration/vm_image/virtual_machine_disk_test.rb +37 -0
  262. data/test/integration/vm_image/virtual_machine_image_test.rb +37 -0
  263. data/test/integration/vnet/Virtual_Network_Create_test.rb +122 -0
  264. data/test/integration/vnet/Virtual_Network_list_test.rb +53 -0
  265. data/test/support/env.rb +19 -0
  266. data/test/support/fixtures.rb +36 -0
  267. data/test/support/name_generator.rb +160 -0
  268. data/test/support/stubs.rb +42 -0
  269. data/test/support/virtual_machine_name_generator.rb +102 -0
  270. data/test/support/virtual_network_helper.rb +73 -0
  271. data/test/test_helper.rb +53 -0
  272. data/test/unit/affinity_group/affinity_group_test.rb +192 -0
  273. data/test/unit/affinity_group/serialization_test.rb +88 -0
  274. data/test/unit/base_management/location_test.rb +57 -0
  275. data/test/unit/blob/blob_service_test.rb +1947 -0
  276. data/test/unit/cloud_service_management/cloud_service_management_service_test.rb +276 -0
  277. data/test/unit/cloud_service_management/serialization_test.rb +169 -0
  278. data/test/unit/core/auth/shared_key_lite_test.rb +51 -0
  279. data/test/unit/core/auth/shared_key_test.rb +58 -0
  280. data/test/unit/core/auth/signer_test.rb +30 -0
  281. data/test/unit/core/http/http_error_test.rb +57 -0
  282. data/test/unit/core/http/http_request_test.rb +66 -0
  283. data/test/unit/core/http/http_response_test.rb +45 -0
  284. data/test/unit/core/http/retry_policy_test.rb +23 -0
  285. data/test/unit/database/serialization_test.rb +97 -0
  286. data/test/unit/database/sql_database_server_service_test.rb +288 -0
  287. data/test/unit/service/serialization_test.rb +502 -0
  288. data/test/unit/service/storage_service_test.rb +291 -0
  289. data/test/unit/storage_management/serialization_test.rb +232 -0
  290. data/test/unit/storage_management/storage_management_service_test.rb +261 -0
  291. data/test/unit/table/edmtype_test.rb +108 -0
  292. data/test/unit/virtual_machine_image_management/serialization_test.rb +35 -0
  293. data/test/unit/virtual_machine_image_management/virtual_machine_image_management_service_test.rb +65 -0
  294. data/test/unit/virtual_machine_management/serialization_test.rb +247 -0
  295. data/test/unit/virtual_machine_management/virtual_machine_management_service_test.rb +440 -0
  296. data/test/unit/vnet/serialization_test.rb +187 -0
  297. data/test/unit/vnet/virtual_network_management_service_test.rb +131 -0
  298. metadata +470 -0
@@ -0,0 +1,247 @@
1
+ #-------------------------------------------------------------------------
2
+ # Copyright 2013 Microsoft Open Technologies, Inc.
3
+ #
4
+ # Licensed under the Apache License, Version 2.0 (the "License");
5
+ # you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+ #--------------------------------------------------------------------------
15
+ require 'test_helper'
16
+
17
+ describe Azure::VirtualMachineManagement::Serialization do
18
+ subject { Azure::VirtualMachineManagement::Serialization }
19
+
20
+ let(:vm_xml) { Nokogiri::XML(Fixtures['virtual_machine']) }
21
+ let(:csn) { 'cloud-service-1' }
22
+
23
+ describe '#virtual_machines_from_xml' do
24
+
25
+ it 'accepts an XML string' do
26
+ subject.virtual_machines_from_xml(vm_xml, csn)
27
+ end
28
+
29
+ it 'returns an Array of VirtualMachine instances' do
30
+ result = subject.virtual_machines_from_xml(vm_xml, csn).first
31
+ result.must_be_kind_of Azure::VirtualMachineManagement::VirtualMachine
32
+ end
33
+
34
+ it "returns a virtual_machine, with it's attribute populated" do
35
+ virtual_machine = subject.virtual_machines_from_xml(vm_xml, csn).first
36
+ virtual_machine.vm_name.must_equal 'instance-name'
37
+ virtual_machine.role_size.must_equal 'Small'
38
+ virtual_machine.hostname.must_equal 'host-name'
39
+ virtual_machine.cloud_service_name.must_equal 'cloud-service-1'
40
+ virtual_machine.deployment_name.must_equal 'deployment-name'
41
+ virtual_machine.ipaddress.must_equal '137.116.17.187'
42
+ virtual_machine.availability_set_name.must_equal 'vm-availability'
43
+ end
44
+
45
+ it "returns a virtual_machine, with it's tcp_endpoints attribute" do
46
+ virtual_machine = subject.virtual_machines_from_xml(vm_xml, csn).first
47
+ virtual_machine.tcp_endpoints.must_be_kind_of Array
48
+ virtual_machine.tcp_endpoints.must_include(
49
+ name: 'SSH',
50
+ vip: '137.116.17.187',
51
+ public_port: '22',
52
+ local_port: '22',
53
+ protocol: 'tcp'
54
+ )
55
+ virtual_machine.tcp_endpoints.must_include(
56
+ name: 'tcp-port-80',
57
+ vip: '137.117.17.187',
58
+ public_port: '80',
59
+ local_port: '80',
60
+ protocol: 'tcp'
61
+ )
62
+ virtual_machine.tcp_endpoints.must_include(
63
+ name: 'tcp-port-3889',
64
+ vip: '137.116.17.187',
65
+ public_port: '3889',
66
+ local_port: '3889',
67
+ protocol: 'tcp'
68
+ )
69
+ end
70
+
71
+ end
72
+
73
+ describe '#shutdown_virtual_machine_to_xml' do
74
+
75
+ it 'returns an xml for virtual machine shutdown' do
76
+ result = subject.shutdown_virtual_machine_to_xml
77
+ result.must_be_kind_of String
78
+ doc = Nokogiri::XML(result)
79
+ doc.css('OperationType').text.must_equal 'ShutdownRoleOperation'
80
+ doc.css('PostShutdownAction').text.must_equal 'StoppedDeallocated'
81
+ end
82
+
83
+ end
84
+
85
+ describe '#start_virtual_machine_to_xml' do
86
+
87
+ it 'returns an xml for start virtual machine' do
88
+ result = subject.start_virtual_machine_to_xml
89
+ result.must_be_kind_of String
90
+ doc = Nokogiri::XML(result)
91
+ doc.css('OperationType').text.must_equal 'StartRoleOperation'
92
+ end
93
+
94
+ end
95
+
96
+ describe '#restart_virtual_machine_to_xml' do
97
+
98
+ it 'returns an xml for restart virtual machine' do
99
+ result = subject.restart_virtual_machine_to_xml
100
+ result.must_be_kind_of String
101
+ doc = Nokogiri::XML(result)
102
+ doc.css('OperationType').text.must_equal 'RestartRoleOperation'
103
+ end
104
+
105
+ end
106
+
107
+ describe '#deployment_to_xml' do
108
+ let(:params) do
109
+ {
110
+ vm_name: 'virtual-machine-name',
111
+ vm_user: 'username',
112
+ image: 'linux_image',
113
+ password: 'password',
114
+ location: 'West US'
115
+ }
116
+ end
117
+
118
+ let(:options) do
119
+ {
120
+ storage_account_name: 'storageaccountname',
121
+ cloud_service_name: 'cloud-service-name',
122
+ tcp_endpoints: '80,3389:3390,85:85',
123
+ availability_set_name: 'aval-set',
124
+ winrm_https_port: '5988',
125
+ winrm_transport: ['http','https']
126
+ }
127
+ end
128
+
129
+ it 'returns an VirtualMachine object with correct tcp endpoints' do
130
+ params[:certificate] = {fingerprint: 'CFB8C256D2986559C630547F2D0'}
131
+ options[:os_type] = 'Windows'
132
+ options[:existing_ports] = ['5985']
133
+ result = subject.deployment_to_xml params, options
134
+ doc = Nokogiri::XML(result)
135
+ endpoints = doc.css('Deployment RoleList ConfigurationSet InputEndpoints InputEndpoint')
136
+ tcp_endpoints = []
137
+ endpoints.each do |endpoint|
138
+ ep = {}
139
+ ep[:name] = xml_content(endpoint, 'Name')
140
+ ep[:public_port] = xml_content(endpoint, 'Port')
141
+ ep[:local_port] = xml_content(endpoint, 'LocalPort')
142
+ tcp_endpoints << ep
143
+ end
144
+ doc.css('Deployment RoleList AvailabilitySetName').text.must_equal 'aval-set'
145
+ result.must_be_kind_of String
146
+ tcp_endpoints.must_include(
147
+ name: 'TCP-PORT-80',
148
+ public_port: '80',
149
+ local_port: '80'
150
+ )
151
+ tcp_endpoints.must_include(
152
+ name: 'TCP-PORT-3390',
153
+ public_port: '3390',
154
+ local_port: '3389'
155
+ )
156
+ tcp_endpoints.must_include(
157
+ name: 'TCP-PORT-85',
158
+ public_port: '85',
159
+ local_port: '85'
160
+ )
161
+ tcp_endpoints.must_include(
162
+ name: 'PowerShell',
163
+ public_port: '5988',
164
+ local_port: '5986'
165
+ )
166
+ end
167
+ end
168
+
169
+ describe '#add_data_disk_to_xml' do
170
+
171
+ let(:options) do
172
+ {
173
+ disk_size: 100,
174
+ }
175
+ end
176
+ let(:media_link) { 'https://sta.blob.managment.core.net/vhds/1234.vhd' }
177
+
178
+ before do
179
+ Loggerx.expects(:puts).returns(nil).at_least(0)
180
+ @vm = Azure::VirtualMachineManagement::VirtualMachine.new
181
+ @vm.data_disks = []
182
+ @vm.media_link = media_link
183
+ end
184
+
185
+ it 'returns an xml for newly created data disk' do
186
+ result = subject.add_data_disk_to_xml(@vm, options)
187
+ doc = Nokogiri::XML(result)
188
+ disk_size = doc.css('DataVirtualHardDisk LogicalDiskSizeInGB').text
189
+ media_link = doc.css('DataVirtualHardDisk MediaLink').text
190
+ disk_name = doc.css('DataVirtualHardDisk DiskName').text
191
+ result.must_be_kind_of String
192
+ disk_size.must_equal options[:disk_size].to_s
193
+ media_link.wont_be_empty
194
+ disk_name.must_be_empty
195
+ end
196
+
197
+ it 'returns an xml for existing data disk' do
198
+ options[:import] = true
199
+ options[:disk_name] = 'disk_name'
200
+ result = subject.add_data_disk_to_xml(@vm, options)
201
+ doc = Nokogiri::XML(result)
202
+ media_link = doc.css('DataVirtualHardDisk MediaLink').text
203
+ disk_name = doc.css('DataVirtualHardDisk DiskName').text
204
+ result.must_be_kind_of String
205
+ media_link.must_be_empty
206
+ disk_name.wont_be_empty
207
+ end
208
+
209
+ it 'raise error when disk name is empty' do
210
+ options[:import] = true
211
+ exception = assert_raises(RuntimeError) do
212
+ subject.add_data_disk_to_xml(@vm, options)
213
+ end
214
+ assert_match(/The data disk name is not valid/i, exception.message)
215
+ end
216
+ end
217
+
218
+ describe '#assign_random_port' do
219
+ let(:preferred_port) { '22' }
220
+ before do
221
+ subject.class.send(:public, *subject.class.private_instance_methods)
222
+ Loggerx.expects(:puts).returns(nil).at_least(0)
223
+ end
224
+
225
+ it 'returns random port number when preferred port is in use' do
226
+ result = subject.assign_random_port(preferred_port, [preferred_port])
227
+ assert_operator result.to_i, :>=, 10000
228
+ assert_operator result.to_i, :<=, 65535
229
+ end
230
+
231
+ it 'returns preferred port number when used ports is nil' do
232
+ result = subject.assign_random_port(preferred_port, nil)
233
+ result.must_equal preferred_port
234
+ end
235
+
236
+ it 'returns preferred port number when used ports is empty' do
237
+ result = subject.assign_random_port(preferred_port, [])
238
+ result.must_equal preferred_port
239
+ end
240
+
241
+ it 'returns random port number when preferred port is in use' do
242
+ result = subject.assign_random_port(preferred_port, ['1', preferred_port])
243
+ assert_operator result.to_i, :>=, 10000
244
+ assert_operator result.to_i, :<=, 65535
245
+ end
246
+ end
247
+ end
@@ -0,0 +1,440 @@
1
+ #-------------------------------------------------------------------------
2
+ # Copyright 2013 Microsoft Open Technologies, Inc.
3
+ #
4
+ # Licensed under the Apache License, Version 2.0 (the "License");
5
+ # you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+ #--------------------------------------------------------------------------
15
+ require 'test_helper'
16
+
17
+ describe Azure::VirtualMachineManagementService do
18
+ VirtualMachine = Azure::VirtualMachineManagement::VirtualMachine
19
+
20
+ subject do
21
+ Azure::VirtualMachineManagementService.new
22
+ end
23
+
24
+ let(:params) do
25
+ {
26
+ vm_name: 'instance1',
27
+ vm_user: 'root',
28
+ image: '5112500ae3b842c8b9c604889f8753c3__OpenLogic-CentOS-63APR20130415',
29
+ password: 'root',
30
+ location: 'West US'
31
+ }
32
+ end
33
+
34
+ let(:windows_params) do
35
+ {
36
+ vm_name: 'instance1',
37
+ vm_user: 'administrator',
38
+ image: 'a699494373c04fc0bc8f2bb1389d6106__Windows-Server-2012-Datacenter-201304.01-en.us-127GB.vhd',
39
+ password: 'Admin123',
40
+ location: 'West US'
41
+ }
42
+ end
43
+
44
+ let(:location_request_path) { '/locations' }
45
+ let(:locations_xml) { Fixtures['list_locations'] }
46
+ let(:location_response) do
47
+ response = mock
48
+ response.stubs(:body).returns(locations_xml)
49
+ response
50
+ end
51
+ let(:location_response_body) { Nokogiri::XML location_response.body }
52
+ let(:mock_virtual_machine_request) { mock }
53
+ let(:windows_images_xml) { Fixtures['list_images'] }
54
+ let(:images_request_path) { '/services/images' }
55
+ let(:mock_request) { mock }
56
+ let(:os_response_body) do
57
+ response = mock
58
+ response.stubs(:body).returns(windows_images_xml)
59
+ Nokogiri::XML response.body
60
+ end
61
+
62
+ before do
63
+ Loggerx.stubs(:info).returns(nil)
64
+ Loggerx.expects(:puts).returns(nil).at_least(0)
65
+ ManagementHttpRequest.stubs(:new).with(
66
+ :get,
67
+ images_request_path,
68
+ nil
69
+ ).returns(mock_request)
70
+ mock_request.expects(:call).returns(os_response_body).at_least(0)
71
+ end
72
+
73
+ describe '#list_virtual_machines' do
74
+ let(:request_path) { '/services/hostedservices' }
75
+ let(:cloud_services_xml) { Fixtures['list_cloud_services'] }
76
+ let(:virtual_machine_xml) { Fixtures['virtual_machine'] }
77
+ let(:deployment_error_xml) { Fixtures['deployment_error'] }
78
+ let(:method) { :get }
79
+ let(:mock_cloud_service_request) { mock }
80
+ let(:cloud_service_response) do
81
+ cloud_service_response = mock
82
+ cloud_service_response.stubs(:body).returns(cloud_services_xml)
83
+ cloud_service_response
84
+ end
85
+ let(:virtual_machine_response) do
86
+ virtual_machine_response = mock
87
+ virtual_machine_response.stubs(:body).returns(virtual_machine_xml)
88
+ virtual_machine_response
89
+ end
90
+ let(:deployment_error_response) do
91
+ http_error_response = mock
92
+ http_error_response.stubs(:body).returns(deployment_error_xml)
93
+ http_error_response
94
+ end
95
+ let(:cloud_service_response_body) { Nokogiri::XML cloud_service_response.body }
96
+ let(:virtual_machine_response_body) { Nokogiri::XML virtual_machine_response.body }
97
+
98
+ before do
99
+ ManagementHttpRequest.stubs(:new).with(method, request_path, nil).returns(mock_cloud_service_request)
100
+ mock_cloud_service_request.expects(:call).returns(cloud_service_response_body)
101
+ ManagementHttpRequest.stubs(:new).with(method, anything).returns(mock_virtual_machine_request)
102
+ mock_virtual_machine_request.stubs(:warn=).returns(true).twice
103
+ mock_virtual_machine_request.expects(:call).twice.returns(virtual_machine_response_body).returns(Nokogiri::XML deployment_error_response.body)
104
+ end
105
+
106
+ it 'assembles a URI for the request' do
107
+ subject.list_virtual_machines
108
+ end
109
+
110
+ it "returns a virtual_machine, with it's attribute populated" do
111
+ virtual_machine = subject.list_virtual_machines.first
112
+ virtual_machine.vm_name.must_equal 'instance-name'
113
+ virtual_machine.role_size.must_equal 'Small'
114
+ virtual_machine.hostname.must_equal 'host-name'
115
+ virtual_machine.cloud_service_name.must_equal 'cloud-service-1'
116
+ virtual_machine.deployment_name.must_equal 'deployment-name'
117
+ virtual_machine.ipaddress.must_equal '137.116.17.187'
118
+ virtual_machine.virtual_network_name.must_equal 'test-virtual-network'
119
+ end
120
+
121
+ it 'returns a list of virtual machines for the subscription' do
122
+ results = subject.list_virtual_machines
123
+ results.must_be_kind_of Array
124
+ results.length.must_equal 1
125
+ results.first.must_be_kind_of VirtualMachine
126
+ end
127
+
128
+ it "returns a virtual_machine, with it's tcp_endpoints attribute" do
129
+ virtual_machine = subject.list_virtual_machines.first
130
+ virtual_machine.tcp_endpoints.must_be_kind_of Array
131
+ virtual_machine.tcp_endpoints.must_include(
132
+ name: 'SSH',
133
+ vip: '137.116.17.187',
134
+ public_port: '22',
135
+ local_port: '22',
136
+ protocol: 'tcp'
137
+ )
138
+ virtual_machine.tcp_endpoints.must_include(
139
+ name: 'tcp-port-80',
140
+ vip: '137.117.17.187',
141
+ public_port: '80',
142
+ local_port: '80',
143
+ protocol: 'tcp'
144
+ )
145
+ virtual_machine.tcp_endpoints.must_include(
146
+ name: 'tcp-port-3889',
147
+ vip: '137.116.17.187',
148
+ public_port: '3889',
149
+ local_port: '3889',
150
+ protocol: 'tcp'
151
+ )
152
+ end
153
+ end
154
+
155
+ describe '#get_virtual_machine' do
156
+
157
+ before do
158
+ virtual_machine = VirtualMachine.new do |vm|
159
+ vm.vm_name = 'instance-name'
160
+ vm.cloud_service_name = 'cloud-service-1'
161
+ end
162
+ Azure::VirtualMachineManagementService.any_instance.stubs(
163
+ :list_virtual_machines
164
+ ).returns([virtual_machine])
165
+ end
166
+
167
+ it 'return nil if virtual machine and cloud server does not exist ' do
168
+ virtual_machine = subject.get_virtual_machine 'name', 'cloud-service'
169
+ virtual_machine.must_equal nil
170
+ end
171
+
172
+ it 'return nil if virtual machine or cloud server does not exist ' do
173
+ vm = subject.get_virtual_machine 'name', 'cloud-service-1'
174
+ vm.must_equal nil
175
+ vm = subject.get_virtual_machine 'name2', 'cloud_service_name'
176
+ vm.must_equal nil
177
+ end
178
+
179
+ it 'return virtual machine instance if virtual machine name and cloud server name are valid ' do
180
+ vm = subject.get_virtual_machine 'instance-name', 'cloud-service-1'
181
+ vm.must_be_kind_of VirtualMachine
182
+ end
183
+ end
184
+
185
+ describe '#create_virtual_machine' do
186
+ let(:method) { :get }
187
+
188
+ before do
189
+ mock_request = mock
190
+ ManagementHttpRequest.stubs(:new).with(
191
+ method,
192
+ location_request_path,
193
+ nil
194
+ ).returns(mock_request)
195
+ mock_request.expects(:call).returns(location_response_body).at_least(0)
196
+ Azure::CloudServiceManagementService.any_instance.stubs(:create_cloud_service)
197
+ Azure::CloudServiceManagementService.any_instance.stubs(:upload_certificate)
198
+ Azure::StorageManagementService.any_instance.stubs(:create_storage_account)
199
+ mock_request = mock
200
+ ManagementHttpRequest.expects(:new).with(
201
+ :post,
202
+ anything,
203
+ anything
204
+ ).returns(mock_request)
205
+ mock_request.expects(:call).returns(nil)
206
+ virtual_machine = VirtualMachine.new do |vm|
207
+ vm.vm_name = 'instance-name'
208
+ vm.ipaddress = '192.168.1.1'
209
+ end
210
+ Azure::VirtualMachineManagementService.stubs(
211
+ :get_virtual_machine
212
+ ).returns(virtual_machine)
213
+ end
214
+
215
+ it 'should set options hash with valid cloud_service_name, deployment_name, storage_account_name.' do
216
+ options = {}
217
+ subject.create_virtual_machine(params, options)
218
+ csn = options[:cloud_service_name]
219
+ csn.wont_be_nil
220
+ options[:storage_account_name].wont_be_nil
221
+ options[:deployment_name].wont_be_nil
222
+ options[:os_type].must_equal 'Linux'
223
+ assert_match(/^#{params[:vm_name] + '-service'}*/, csn)
224
+ end
225
+
226
+ it 'should set options hash with valid cloud service name.' do
227
+ options = {
228
+ storage_account_name: 'storage_account_name',
229
+ deployment_name: 'unique_deployment_name',
230
+ tcp_endpoints: '80,3889:3889'
231
+ }
232
+ subject.create_virtual_machine(params, options)
233
+ csn = options[:cloud_service_name]
234
+ csn.wont_be_nil
235
+ assert_match(/^#{params[:vm_name] + '-service-'}*/, csn)
236
+ options[:os_type].must_equal 'Linux'
237
+ end
238
+
239
+ end
240
+
241
+ describe '#create_virtual_machine with invalid parameters for windows machine' do
242
+ let(:virtual_machine_xml) { Fixtures['virtual_machine'] }
243
+ let(:method) { :get }
244
+
245
+ before do
246
+ mock_request = mock
247
+ ManagementHttpRequest.stubs(:new).with(
248
+ method,
249
+ location_request_path,
250
+ nil
251
+ ).returns(mock_request)
252
+ mock_request.expects(:call).returns(location_response_body).at_least(0)
253
+ Azure::CloudServiceManagementService.any_instance.stubs(:create_cloud_service)
254
+ Azure::CloudServiceManagementService.any_instance.stubs(:upload_certificate)
255
+ Azure::StorageManagementService.any_instance.stubs(:create_storage_account)
256
+ mock_request = mock
257
+ ManagementHttpRequest.expects(:new).with(
258
+ :post,
259
+ anything,
260
+ anything
261
+ ).returns(mock_request).at_least(0)
262
+ mock_request.expects(:call).returns(nil).at_least(0)
263
+ virtual_machine_obj = VirtualMachine.new do |virtual_machine|
264
+ virtual_machine.vm_name = 'windows-instance'
265
+ virtual_machine.ipaddress = '192.168.1.1'
266
+ end
267
+ Azure::VirtualMachineManagementService.any_instance.stubs(
268
+ :get_virtual_machine
269
+ ).returns(virtual_machine_obj)
270
+ end
271
+
272
+ it 'should set options os_type with windows.' do
273
+ options = {}
274
+ subject.create_virtual_machine(windows_params, options)
275
+ csn = options[:cloud_service_name]
276
+ csn.wont_be_nil
277
+ options[:storage_account_name].wont_be_nil
278
+ options[:deployment_name].wont_be_nil
279
+ options[:os_type].must_equal 'Windows'
280
+ assert_match(/^#{params[:vm_name] + '-service'}*/, csn)
281
+ end
282
+
283
+ it 'throws error when vm_user is not given' do
284
+ windows_params.delete(:vm_user)
285
+ options = {}
286
+ virtual_machine = subject.create_virtual_machine(windows_params, options)
287
+ assert_match(/You did not provide a valid 'vm_user' value*/, virtual_machine)
288
+ end
289
+
290
+ it 'self-signed certificate is generated by vm and used for the virtual machine when certificate path is not given.' do
291
+ options = { winrm_transport: %w(https http) }
292
+ virtual_machine = subject.create_virtual_machine(windows_params, options)
293
+ virtual_machine.wont_be_nil
294
+ end
295
+
296
+ it 'throws error when certificate path is not invalid.' do
297
+ options = {
298
+ winrm_transport: %w(https http),
299
+ private_key_file: 'f:/invalid_path/private_key' ,
300
+ certificate_file: 'f:/invalid_path/certificate.pem'
301
+ }
302
+ virtual_machine = subject.create_virtual_machine(windows_params, options)
303
+ assert_match(/No such file or directory -*/, virtual_machine)
304
+ end
305
+
306
+ it 'should not throws certificate error when wirnm_transport is http' do
307
+ options = {
308
+ winrm_transport: ['http'],
309
+ private_key_file: 'f:/invalid_path/private_key' ,
310
+ certificate_file: 'f:/invalid_path/certificate.pem'
311
+ }
312
+ virtual_machine = subject.create_virtual_machine(windows_params, options)
313
+ virtual_machine.must_be_kind_of VirtualMachine
314
+ virtual_machine.wont_be_nil
315
+ end
316
+
317
+ it 'throws error when location is not given' do
318
+ params.delete(:location)
319
+ virtual_machine = subject.create_virtual_machine(params)
320
+ error_msg = "You did not provide a valid 'location' value"
321
+ assert_match(/#{error_msg}*/, virtual_machine)
322
+ end
323
+
324
+ it 'throws error when wrong location is given' do
325
+ params.merge!(location: 'wrong location')
326
+ virtual_machine = subject.create_virtual_machine(params)
327
+ assert_match(/Value 'wrong location' specified for parameter 'location' is invalid.*/, virtual_machine)
328
+ end
329
+
330
+ it 'throws error when empty location is given' do
331
+ params.merge!(location: nil)
332
+ virtual_machine = subject.create_virtual_machine(params)
333
+ assert_match(/You did not provide a valid 'location' value*/, virtual_machine)
334
+ end
335
+
336
+ it 'location should be case insensitive' do
337
+ params.merge!(location: 'west us')
338
+ subject.create_virtual_machine(params)
339
+ end
340
+
341
+ it 'throw error when available_services has not persistentvmrole for given location' do
342
+ params.merge!(location: 'West Europe')
343
+ msg = subject.create_virtual_machine(params)
344
+ assert_match(/Persistentvmrole not enabled for "West Europe"*/, msg)
345
+ end
346
+
347
+ it 'vm_size should be case sensitive' do
348
+ options = {
349
+ vm_size: 'extralarge'
350
+ }
351
+ msg = subject.create_virtual_machine(params, options)
352
+ assert_match(/Value 'extralarge' specified for parameter 'vm_size' is invalid/, msg)
353
+ end
354
+
355
+ it 'throws error when wrong role size is given' do
356
+ options = {
357
+ vm_size: 'wrong size'
358
+ }
359
+ virtual_machine = subject.create_virtual_machine(params, options)
360
+ error_msg = "'wrong size' specified for parameter 'vm_size' is invalid."
361
+ assert_match(/#{error_msg}*/, virtual_machine)
362
+ end
363
+
364
+ it 'should not throw any error if role size is empty' do
365
+ options = {
366
+ vm_size: ''
367
+ }
368
+ subject.create_virtual_machine(params, options)
369
+ end
370
+ end
371
+
372
+ describe '#get_os_type' do
373
+
374
+ before do
375
+ subject.class.send(:public, *subject.class.private_instance_methods)
376
+ end
377
+
378
+ it 'returns os type of given virtual machine image' do
379
+ result = subject.get_os_type 'RightImage-CentOS-6.2-x64-v5.8.8.1'
380
+ result.must_equal 'Linux'
381
+ end
382
+
383
+ it 'errors if the virtual machine image does not exist' do
384
+ exception = assert_raises(RuntimeError) do
385
+ subject.get_os_type 'invalid-image-name'
386
+ end
387
+ error_msg = 'The virtual machine image source is not valid'
388
+ assert_match(/#{error_msg}/i, exception.message)
389
+ end
390
+ end
391
+
392
+ describe '#add_role' do
393
+
394
+ before do
395
+ windows_params[:cloud_service_name] = 'cloud-service-1'
396
+ end
397
+
398
+ it 'should throws error when cloud service name is empty' do
399
+ windows_params.delete(:cloud_service_name)
400
+ exception = assert_raises(RuntimeError) do
401
+ subject.add_role(params)
402
+ end
403
+ error_msg = 'You did not provide a valid \'cloud_service_name\' value'
404
+ assert_match(/#{error_msg}/i, exception.message)
405
+ end
406
+
407
+ it 'throws error when vm_user is not given' do
408
+ windows_params.delete(:vm_user)
409
+ exception = assert_raises(RuntimeError) do
410
+ subject.add_role(windows_params)
411
+ end
412
+ error_msg = 'You did not provide a valid \'vm_user\' value'
413
+ assert_match(/#{error_msg}/i, exception.message)
414
+ end
415
+
416
+ it 'throws error when certificate path is not invalid.' do
417
+ options = {
418
+ winrm_transport: %w(https http),
419
+ private_key_file: 'f:/invalid_path/private_key' ,
420
+ certificate_file: 'f:/invalid_path/certificate.pem'
421
+ }
422
+ exception = assert_raises(RuntimeError) do
423
+ subject.add_role(windows_params, options)
424
+ end
425
+ error_msg = 'No such file or directory -'
426
+ assert_match(/#{error_msg}/i, exception.message)
427
+ end
428
+
429
+ it 'throws error when wrong role size is given' do
430
+ options = { vm_size: 'wrong size' }
431
+ exception = assert_raises(RuntimeError) do
432
+ subject.add_role(windows_params, options)
433
+ end
434
+ error_msg = "wrong size' specified for parameter 'vm_size' is invalid."
435
+ assert_match(/#{error_msg}*/, exception.message)
436
+ end
437
+
438
+ end
439
+
440
+ end