shopify-cli 1.4.1 → 1.8.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (303) hide show
  1. checksums.yaml +4 -4
  2. data/.github/CODEOWNERS +2 -2
  3. data/.github/CONTRIBUTING.md +9 -1
  4. data/.github/PULL_REQUEST_TEMPLATE.md +3 -2
  5. data/.github/workflows/release.yml +0 -1
  6. data/.github/workflows/triage.yml +22 -0
  7. data/.rubocop.yml +21 -7
  8. data/.rubocop_todo.yml +2 -15
  9. data/.travis.yml +1 -1
  10. data/CHANGELOG.md +28 -0
  11. data/Gemfile +12 -11
  12. data/Gemfile.lock +17 -14
  13. data/README.md +39 -7
  14. data/RELEASING.md +5 -13
  15. data/Rakefile +32 -28
  16. data/bin/load_shopify.rb +6 -6
  17. data/bin/shopify +2 -2
  18. data/dev.yml +2 -2
  19. data/docs/_config.yml +1 -18
  20. data/docs/app/node/commands/index.md +2 -80
  21. data/docs/app/node/index.md +2 -33
  22. data/docs/app/rails/commands/index.md +2 -78
  23. data/docs/app/rails/index.md +2 -34
  24. data/docs/core/index.md +2 -84
  25. data/docs/getting-started/index.md +2 -25
  26. data/docs/getting-started/install/index.md +1 -118
  27. data/docs/getting-started/migrate/index.md +2 -94
  28. data/docs/getting-started/uninstall/index.md +2 -35
  29. data/docs/getting-started/upgrade/index.md +2 -39
  30. data/docs/help/start-app/index.md +2 -4
  31. data/docs/index.md +2 -24
  32. data/ext/shopify-cli/extconf.rb +7 -7
  33. data/install.sh +1 -1
  34. data/lib/docgen/markdown.rb +12 -12
  35. data/lib/graphql/fetch_specifications.graphql +14 -0
  36. data/lib/{project_types/extension/graphql → graphql}/get_app_by_api_key.graphql +0 -0
  37. data/lib/project_types/extension/cli.rb +54 -47
  38. data/lib/project_types/extension/commands/build.rb +3 -3
  39. data/lib/project_types/extension/commands/create.rb +17 -10
  40. data/lib/project_types/extension/commands/extension_command.rb +12 -5
  41. data/lib/project_types/extension/commands/push.rb +8 -8
  42. data/lib/project_types/extension/commands/register.rb +19 -30
  43. data/lib/project_types/extension/commands/serve.rb +31 -3
  44. data/lib/project_types/extension/commands/tunnel.rb +12 -12
  45. data/lib/project_types/extension/extension_project.rb +8 -4
  46. data/lib/project_types/extension/extension_project_keys.rb +4 -4
  47. data/lib/project_types/extension/features/argo.rb +117 -0
  48. data/lib/project_types/extension/features/argo_config.rb +5 -5
  49. data/lib/project_types/extension/features/argo_dependencies.rb +5 -5
  50. data/lib/project_types/extension/features/argo_setup.rb +2 -2
  51. data/lib/project_types/extension/features/argo_setup_steps.rb +4 -4
  52. data/lib/project_types/extension/forms/create.rb +28 -34
  53. data/lib/project_types/extension/forms/questions/ask_app.rb +53 -0
  54. data/lib/project_types/extension/forms/questions/ask_name.rb +40 -0
  55. data/lib/project_types/extension/forms/questions/ask_type.rb +47 -0
  56. data/lib/project_types/extension/messages/messages.rb +55 -52
  57. data/lib/project_types/extension/models/lazy_specification_handler.rb +12 -0
  58. data/lib/project_types/extension/models/specification.rb +37 -0
  59. data/lib/project_types/extension/models/specification_handlers/checkout_post_purchase.rb +19 -0
  60. data/lib/project_types/extension/models/specification_handlers/default.rb +67 -0
  61. data/lib/project_types/extension/models/specifications.rb +88 -0
  62. data/lib/project_types/extension/tasks/configure_features.rb +52 -0
  63. data/lib/project_types/extension/tasks/converters/app_converter.rb +6 -6
  64. data/lib/project_types/extension/tasks/converters/registration_converter.rb +6 -6
  65. data/lib/project_types/extension/tasks/converters/validation_error_converter.rb +4 -4
  66. data/lib/project_types/extension/tasks/converters/version_converter.rb +7 -7
  67. data/lib/project_types/extension/tasks/create_extension.rb +4 -4
  68. data/lib/project_types/extension/tasks/fetch_specifications.rb +18 -0
  69. data/lib/project_types/extension/tasks/get_app.rb +4 -4
  70. data/lib/project_types/extension/tasks/get_apps.rb +3 -3
  71. data/lib/project_types/extension/tasks/update_draft.rb +4 -4
  72. data/lib/project_types/extension/tasks/user_errors.rb +4 -4
  73. data/lib/project_types/node/cli.rb +19 -16
  74. data/lib/project_types/node/commands/connect.rb +15 -0
  75. data/lib/project_types/node/commands/create.rb +44 -41
  76. data/lib/project_types/node/commands/deploy.rb +4 -4
  77. data/lib/project_types/node/commands/deploy/heroku.rb +24 -24
  78. data/lib/project_types/node/commands/generate.rb +9 -18
  79. data/lib/project_types/node/commands/open.rb +2 -2
  80. data/lib/project_types/node/commands/populate.rb +6 -6
  81. data/lib/project_types/node/commands/populate/customer.rb +5 -5
  82. data/lib/project_types/node/commands/populate/draft_order.rb +5 -5
  83. data/lib/project_types/node/commands/populate/product.rb +5 -5
  84. data/lib/project_types/node/commands/serve.rb +9 -9
  85. data/lib/project_types/node/commands/tunnel.rb +7 -7
  86. data/lib/project_types/node/forms/create.rb +17 -8
  87. data/lib/project_types/node/messages/messages.rb +20 -53
  88. data/lib/project_types/rails/cli.rb +21 -18
  89. data/lib/project_types/rails/commands/connect.rb +15 -0
  90. data/lib/project_types/rails/commands/create.rb +58 -57
  91. data/lib/project_types/rails/commands/deploy.rb +4 -4
  92. data/lib/project_types/rails/commands/deploy/heroku.rb +30 -30
  93. data/lib/project_types/rails/commands/generate.rb +7 -7
  94. data/lib/project_types/rails/commands/generate/webhook.rb +6 -6
  95. data/lib/project_types/rails/commands/open.rb +2 -2
  96. data/lib/project_types/rails/commands/populate.rb +6 -6
  97. data/lib/project_types/rails/commands/populate/customer.rb +5 -5
  98. data/lib/project_types/rails/commands/populate/draft_order.rb +5 -5
  99. data/lib/project_types/rails/commands/populate/product.rb +5 -5
  100. data/lib/project_types/rails/commands/serve.rb +11 -11
  101. data/lib/project_types/rails/commands/tunnel.rb +7 -7
  102. data/lib/project_types/rails/forms/create.rb +35 -25
  103. data/lib/project_types/rails/gem.rb +24 -24
  104. data/lib/project_types/rails/messages/messages.rb +13 -9
  105. data/lib/project_types/rails/ruby.rb +2 -2
  106. data/lib/project_types/script/cli.rb +44 -38
  107. data/lib/project_types/script/commands/create.rb +15 -10
  108. data/lib/project_types/script/commands/disable.rb +3 -3
  109. data/lib/project_types/script/commands/enable.rb +19 -9
  110. data/lib/project_types/script/commands/push.rb +10 -17
  111. data/lib/project_types/script/config/extension_points.yml +30 -12
  112. data/lib/project_types/script/errors.rb +22 -0
  113. data/lib/project_types/script/forms/create.rb +29 -5
  114. data/lib/project_types/script/graphql/app_script_update_or_create.graphql +12 -1
  115. data/lib/project_types/script/layers/application/build_script.rb +19 -19
  116. data/lib/project_types/script/layers/application/create_script.rb +45 -12
  117. data/lib/project_types/script/layers/application/disable_script.rb +2 -2
  118. data/lib/project_types/script/layers/application/enable_script.rb +2 -2
  119. data/lib/project_types/script/layers/application/extension_points.rb +24 -0
  120. data/lib/project_types/script/layers/application/project_dependencies.rb +4 -4
  121. data/lib/project_types/script/layers/application/push_script.rb +15 -18
  122. data/lib/project_types/script/layers/domain/config_ui.rb +16 -0
  123. data/lib/project_types/script/layers/domain/errors.rb +23 -0
  124. data/lib/project_types/script/layers/domain/extension_point.rb +67 -7
  125. data/lib/project_types/script/layers/domain/metadata.rb +55 -0
  126. data/lib/project_types/script/layers/domain/push_package.rb +29 -6
  127. data/lib/project_types/script/layers/infrastructure/assemblyscript_project_creator.rb +45 -55
  128. data/lib/project_types/script/layers/infrastructure/assemblyscript_task_runner.rb +41 -45
  129. data/lib/project_types/script/layers/infrastructure/config_ui_repository.rb +46 -0
  130. data/lib/project_types/script/layers/infrastructure/errors.rb +32 -5
  131. data/lib/project_types/script/layers/infrastructure/extension_point_repository.rb +12 -6
  132. data/lib/project_types/script/layers/infrastructure/project_creator.rb +2 -1
  133. data/lib/project_types/script/layers/infrastructure/push_package_repository.rb +20 -13
  134. data/lib/project_types/script/layers/infrastructure/rust_project_creator.rb +72 -0
  135. data/lib/project_types/script/layers/infrastructure/rust_task_runner.rb +59 -0
  136. data/lib/project_types/script/layers/infrastructure/script_service.rb +39 -17
  137. data/lib/project_types/script/layers/infrastructure/task_runner.rb +4 -3
  138. data/lib/project_types/script/messages/messages.rb +76 -10
  139. data/lib/project_types/script/script_project.rb +26 -16
  140. data/lib/project_types/script/ui/error_handler.rb +135 -50
  141. data/lib/project_types/script/ui/printing_spinner.rb +1 -1
  142. data/lib/project_types/script/ui/strict_spinner.rb +1 -1
  143. data/lib/project_types/theme/cli.rb +40 -0
  144. data/lib/project_types/theme/commands/connect.rb +54 -0
  145. data/lib/project_types/theme/commands/create.rb +48 -0
  146. data/lib/project_types/theme/commands/deploy.rb +38 -0
  147. data/lib/project_types/theme/commands/generate.rb +20 -0
  148. data/lib/project_types/theme/commands/generate/env.rb +79 -0
  149. data/lib/project_types/theme/commands/push.rb +55 -0
  150. data/lib/project_types/theme/commands/serve.rb +31 -0
  151. data/lib/project_types/theme/forms/connect.rb +34 -0
  152. data/lib/project_types/theme/forms/create.rb +22 -0
  153. data/lib/project_types/theme/messages/messages.rb +147 -0
  154. data/lib/project_types/theme/tasks/ensure_themekit_installed.rb +78 -0
  155. data/lib/project_types/theme/themekit.rb +113 -0
  156. data/lib/rubygems_plugin.rb +3 -3
  157. data/lib/shopify-cli/admin_api.rb +52 -12
  158. data/lib/shopify-cli/admin_api/populate_resource_command.rb +17 -17
  159. data/lib/shopify-cli/admin_api/schema.rb +3 -3
  160. data/lib/shopify-cli/api.rb +36 -31
  161. data/lib/shopify-cli/command.rb +1 -1
  162. data/lib/shopify-cli/commands.rb +9 -9
  163. data/lib/shopify-cli/commands/config.rb +28 -28
  164. data/lib/shopify-cli/commands/connect.rb +35 -18
  165. data/lib/shopify-cli/commands/create.rb +5 -5
  166. data/lib/shopify-cli/commands/help.rb +6 -6
  167. data/lib/shopify-cli/commands/logout.rb +3 -3
  168. data/lib/shopify-cli/commands/system.rb +33 -33
  169. data/lib/shopify-cli/commands/version.rb +2 -2
  170. data/lib/shopify-cli/context.rb +43 -22
  171. data/lib/shopify-cli/core.rb +4 -4
  172. data/lib/shopify-cli/core/entry_point.rb +5 -5
  173. data/lib/shopify-cli/core/executor.rb +1 -1
  174. data/lib/shopify-cli/core/help_resolver.rb +2 -2
  175. data/lib/shopify-cli/core/monorail.rb +17 -16
  176. data/lib/shopify-cli/db.rb +2 -2
  177. data/lib/shopify-cli/feature.rb +1 -3
  178. data/lib/shopify-cli/form.rb +1 -1
  179. data/lib/shopify-cli/git.rb +17 -17
  180. data/lib/shopify-cli/helpers.rb +1 -1
  181. data/lib/shopify-cli/helpers/haikunator.rb +1 -1
  182. data/lib/shopify-cli/heroku.rb +28 -28
  183. data/lib/shopify-cli/http_request.rb +21 -9
  184. data/lib/shopify-cli/js_deps.rb +13 -13
  185. data/lib/shopify-cli/js_system.rb +5 -5
  186. data/lib/shopify-cli/lazy_delegator.rb +55 -0
  187. data/lib/shopify-cli/messages/messages.rb +21 -10
  188. data/lib/shopify-cli/method_object.rb +104 -0
  189. data/lib/shopify-cli/oauth.rb +25 -25
  190. data/lib/shopify-cli/oauth/servlet.rb +9 -9
  191. data/lib/shopify-cli/options.rb +3 -3
  192. data/lib/shopify-cli/packager.rb +24 -24
  193. data/lib/shopify-cli/partners_api.rb +38 -16
  194. data/lib/shopify-cli/partners_api/organizations.rb +10 -10
  195. data/lib/shopify-cli/process_supervision.rb +8 -8
  196. data/lib/shopify-cli/project.rb +27 -23
  197. data/lib/shopify-cli/project_type.rb +21 -5
  198. data/lib/shopify-cli/resolve_constant.rb +25 -0
  199. data/lib/shopify-cli/resources.rb +1 -1
  200. data/lib/shopify-cli/resources/env_file.rb +9 -9
  201. data/lib/shopify-cli/result.rb +432 -0
  202. data/lib/shopify-cli/shopifolk.rb +35 -18
  203. data/lib/shopify-cli/sub_command.rb +1 -1
  204. data/lib/shopify-cli/task.rb +9 -1
  205. data/lib/shopify-cli/tasks.rb +7 -7
  206. data/lib/shopify-cli/tasks/create_api_client.rb +13 -4
  207. data/lib/shopify-cli/tasks/ensure_dev_store.rb +12 -12
  208. data/lib/shopify-cli/tasks/ensure_env.rb +18 -15
  209. data/lib/shopify-cli/tasks/ensure_loopback_url.rb +4 -4
  210. data/lib/shopify-cli/tasks/select_org_and_shop.rb +28 -24
  211. data/lib/shopify-cli/tasks/update_dashboard_urls.rb +10 -10
  212. data/lib/shopify-cli/transform_data_structure.rb +86 -0
  213. data/lib/shopify-cli/tunnel.rb +36 -30
  214. data/lib/shopify-cli/version.rb +1 -1
  215. data/lib/shopify_cli.rb +57 -52
  216. data/shopify-cli.gemspec +6 -6
  217. data/shopify.fish +1 -1
  218. data/shopify.sh +1 -1
  219. data/vendor/deps/cli-kit/REVISION +1 -1
  220. data/vendor/deps/cli-kit/lib/cli/kit/logger.rb +2 -2
  221. data/vendor/deps/cli-kit/lib/cli/kit/system.rb +3 -3
  222. data/vendor/deps/cli-ui/REVISION +1 -1
  223. data/vendor/deps/cli-ui/lib/cli/ui.rb +26 -22
  224. data/vendor/deps/cli-ui/lib/cli/ui/ansi.rb +4 -6
  225. data/vendor/deps/cli-ui/lib/cli/ui/frame.rb +3 -3
  226. data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_stack.rb +8 -9
  227. data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_style.rb +1 -1
  228. data/vendor/deps/cli-ui/lib/cli/ui/glyph.rb +1 -0
  229. data/vendor/deps/cli-ui/lib/cli/ui/printer.rb +15 -3
  230. data/vendor/deps/cli-ui/lib/cli/ui/prompt/interactive_options.rb +4 -11
  231. data/vendor/deps/cli-ui/lib/cli/ui/spinner.rb +3 -5
  232. data/vendor/deps/cli-ui/lib/cli/ui/terminal.rb +10 -10
  233. data/vendor/deps/cli-ui/lib/cli/ui/version.rb +1 -1
  234. data/vendor/deps/cli-ui/lib/cli/ui/wrap.rb +56 -0
  235. data/vendor/deps/webrick/.gitignore +9 -0
  236. data/vendor/deps/webrick/Gemfile +3 -0
  237. data/vendor/deps/webrick/LICENSE.txt +22 -0
  238. data/vendor/deps/webrick/README.md +61 -0
  239. data/vendor/deps/webrick/Rakefile +10 -0
  240. data/vendor/deps/webrick/lib/webrick.rb +232 -0
  241. data/vendor/deps/webrick/lib/webrick/accesslog.rb +157 -0
  242. data/vendor/deps/webrick/lib/webrick/cgi.rb +313 -0
  243. data/vendor/deps/webrick/lib/webrick/compat.rb +36 -0
  244. data/vendor/deps/webrick/lib/webrick/config.rb +158 -0
  245. data/vendor/deps/webrick/lib/webrick/cookie.rb +172 -0
  246. data/vendor/deps/webrick/lib/webrick/htmlutils.rb +30 -0
  247. data/vendor/deps/webrick/lib/webrick/httpauth.rb +96 -0
  248. data/vendor/deps/webrick/lib/webrick/httpauth/authenticator.rb +117 -0
  249. data/vendor/deps/webrick/lib/webrick/httpauth/basicauth.rb +116 -0
  250. data/vendor/deps/webrick/lib/webrick/httpauth/digestauth.rb +395 -0
  251. data/vendor/deps/webrick/lib/webrick/httpauth/htdigest.rb +132 -0
  252. data/vendor/deps/webrick/lib/webrick/httpauth/htgroup.rb +97 -0
  253. data/vendor/deps/webrick/lib/webrick/httpauth/htpasswd.rb +158 -0
  254. data/vendor/deps/webrick/lib/webrick/httpauth/userdb.rb +53 -0
  255. data/vendor/deps/webrick/lib/webrick/httpproxy.rb +354 -0
  256. data/vendor/deps/webrick/lib/webrick/httprequest.rb +636 -0
  257. data/vendor/deps/webrick/lib/webrick/httpresponse.rb +564 -0
  258. data/vendor/deps/webrick/lib/webrick/https.rb +152 -0
  259. data/vendor/deps/webrick/lib/webrick/httpserver.rb +294 -0
  260. data/vendor/deps/webrick/lib/webrick/httpservlet.rb +23 -0
  261. data/vendor/deps/webrick/lib/webrick/httpservlet/abstract.rb +152 -0
  262. data/vendor/deps/webrick/lib/webrick/httpservlet/cgi_runner.rb +47 -0
  263. data/vendor/deps/webrick/lib/webrick/httpservlet/cgihandler.rb +126 -0
  264. data/vendor/deps/webrick/lib/webrick/httpservlet/erbhandler.rb +88 -0
  265. data/vendor/deps/webrick/lib/webrick/httpservlet/filehandler.rb +552 -0
  266. data/vendor/deps/webrick/lib/webrick/httpservlet/prochandler.rb +47 -0
  267. data/vendor/deps/webrick/lib/webrick/httpstatus.rb +194 -0
  268. data/vendor/deps/webrick/lib/webrick/httputils.rb +512 -0
  269. data/vendor/deps/webrick/lib/webrick/httpversion.rb +76 -0
  270. data/vendor/deps/webrick/lib/webrick/log.rb +156 -0
  271. data/vendor/deps/webrick/lib/webrick/server.rb +381 -0
  272. data/vendor/deps/webrick/lib/webrick/ssl.rb +215 -0
  273. data/vendor/deps/webrick/lib/webrick/utils.rb +265 -0
  274. data/vendor/deps/webrick/lib/webrick/version.rb +18 -0
  275. data/vendor/deps/webrick/webrick.gemspec +74 -0
  276. data/vendor/gen/template/bin/update-deps +9 -9
  277. metadata +83 -29
  278. data/docs/Gemfile +0 -5
  279. data/docs/Gemfile.lock +0 -258
  280. data/docs/_data/nav.yml +0 -35
  281. data/docs/_includes/footer.html +0 -15
  282. data/docs/_includes/head.html +0 -19
  283. data/docs/_includes/sidebar_nav.html +0 -22
  284. data/docs/_includes/toc.html +0 -112
  285. data/docs/_layouts/default.html +0 -79
  286. data/docs/css/docs.css +0 -157
  287. data/docs/images/header.png +0 -0
  288. data/docs/installing-ruby.md +0 -28
  289. data/lib/project_types/extension/features/argo/admin.rb +0 -20
  290. data/lib/project_types/extension/features/argo/base.rb +0 -129
  291. data/lib/project_types/extension/features/argo/checkout.rb +0 -20
  292. data/lib/project_types/extension/forms/register.rb +0 -47
  293. data/lib/project_types/extension/models/type.rb +0 -81
  294. data/lib/project_types/extension/models/types/checkout_post_purchase.rb +0 -23
  295. data/lib/project_types/extension/models/types/product_subscription.rb +0 -24
  296. data/lib/project_types/node/commands/generate/billing.rb +0 -39
  297. data/lib/project_types/node/commands/generate/page.rb +0 -59
  298. data/lib/project_types/node/commands/generate/webhook.rb +0 -37
  299. data/lib/project_types/script/layers/domain/script.rb +0 -18
  300. data/lib/project_types/script/layers/infrastructure/assemblyscript_tsconfig.rb +0 -38
  301. data/lib/project_types/script/layers/infrastructure/script_repository.rb +0 -59
  302. data/lib/project_types/script/templates/ts/as-pect.config.js +0 -27
  303. data/lib/project_types/script/templates/ts/as-pect.d.ts +0 -1
@@ -1,7 +1,7 @@
1
- require 'json'
2
- require 'fileutils'
3
- require 'shopify_cli'
4
- require 'forwardable'
1
+ require "json"
2
+ require "fileutils"
3
+ require "shopify_cli"
4
+ require "forwardable"
5
5
 
6
6
  module ShopifyCli
7
7
  ##
@@ -19,14 +19,14 @@ module ShopifyCli
19
19
  PORT = 8081 # port that ngrok will bind to
20
20
  # mapping for supported operating systems for where to download ngrok from.
21
21
  DOWNLOAD_URLS = {
22
- mac: 'https://bin.equinox.io/c/4VmDzA7iaHb/ngrok-stable-darwin-amd64.zip',
23
- linux: 'https://bin.equinox.io/c/4VmDzA7iaHb/ngrok-stable-linux-amd64.zip',
24
- windows: 'https://bin.equinox.io/c/4VmDzA7iaHb/ngrok-stable-windows-amd64.zip',
22
+ mac: "https://bin.equinox.io/c/4VmDzA7iaHb/ngrok-stable-darwin-amd64.zip",
23
+ linux: "https://bin.equinox.io/c/4VmDzA7iaHb/ngrok-stable-linux-amd64.zip",
24
+ windows: "https://bin.equinox.io/c/4VmDzA7iaHb/ngrok-stable-windows-amd64.zip",
25
25
  }
26
26
 
27
- NGROK_TUNNELS_URI = URI.parse('http://localhost:4040/api/tunnels')
28
- TUNNELS_FIELD = 'tunnels'
29
- PUBLIC_URL_FIELD = 'public_url'
27
+ NGROK_TUNNELS_URI = URI.parse("http://localhost:4040/api/tunnels")
28
+ TUNNELS_FIELD = "tunnels"
29
+ PUBLIC_URL_FIELD = "public_url"
30
30
 
31
31
  ##
32
32
  # will find and stop a running tunnel process. It will also output if the
@@ -39,12 +39,12 @@ module ShopifyCli
39
39
  def stop(ctx)
40
40
  if ShopifyCli::ProcessSupervision.running?(:ngrok)
41
41
  if ShopifyCli::ProcessSupervision.stop(:ngrok)
42
- ctx.puts(ctx.message('core.tunnel.stopped'))
42
+ ctx.puts(ctx.message("core.tunnel.stopped"))
43
43
  else
44
- ctx.abort(ctx.message('core.tunnel.error.stop'))
44
+ ctx.abort(ctx.message("core.tunnel.error.stop"))
45
45
  end
46
46
  else
47
- ctx.puts(ctx.message('core.tunnel.not_running'))
47
+ ctx.puts(ctx.message("core.tunnel.not_running"))
48
48
  end
49
49
  end
50
50
 
@@ -65,15 +65,15 @@ module ShopifyCli
65
65
  install(ctx)
66
66
  url, account, seconds_remaining = start_ngrok(ctx, port)
67
67
  if account
68
- ctx.puts(ctx.message('core.tunnel.start_with_account', url, account))
68
+ ctx.puts(ctx.message("core.tunnel.start_with_account", url, account))
69
69
  else
70
70
  if seconds_remaining <= 0
71
- ctx.puts(ctx.message('core.tunnel.timed_out'))
71
+ ctx.puts(ctx.message("core.tunnel.timed_out"))
72
72
  url, _account, seconds_remaining = restart_ngrok(ctx, port)
73
73
  end
74
- ctx.puts(ctx.message('core.tunnel.start', url))
75
- ctx.puts(ctx.message('core.tunnel.will_timeout', seconds_to_hm(seconds_remaining)))
76
- ctx.puts(ctx.message('core.tunnel.signup_suggestion', ShopifyCli::TOOL_NAME))
74
+ ctx.puts(ctx.message("core.tunnel.start", url))
75
+ ctx.puts(ctx.message("core.tunnel.will_timeout", seconds_to_hm(seconds_remaining)))
76
+ ctx.puts(ctx.message("core.tunnel.signup_suggestion", ShopifyCli::TOOL_NAME))
77
77
  end
78
78
  url
79
79
  end
@@ -89,7 +89,7 @@ module ShopifyCli
89
89
  #
90
90
  def auth(ctx, token)
91
91
  install(ctx)
92
- ctx.system(File.join(ShopifyCli.cache_dir, 'ngrok'), 'authtoken', token)
92
+ ctx.system(File.join(ShopifyCli.cache_dir, "ngrok"), "authtoken", token)
93
93
  end
94
94
 
95
95
  ##
@@ -123,14 +123,15 @@ module ShopifyCli
123
123
  private
124
124
 
125
125
  def install(ctx)
126
- return if File.exist?(File.join(ShopifyCli.cache_dir, ctx.windows? ? 'ngrok.exe' : 'ngrok'))
127
- check_prereq_command(ctx, 'curl')
128
- check_prereq_command(ctx, ctx.linux? ? 'unzip' : 'tar')
126
+ ngrok = "ngrok#{ctx.executable_file_extension}"
127
+ return if File.exist?(File.join(ShopifyCli.cache_dir, ngrok))
128
+ check_prereq_command(ctx, "curl")
129
+ check_prereq_command(ctx, ctx.linux? ? "unzip" : "tar")
129
130
  spinner = CLI::UI::SpinGroup.new
130
- spinner.add('Installing ngrok...') do
131
- zip_dest = File.join(ShopifyCli.cache_dir, 'ngrok.zip')
131
+ spinner.add("Installing ngrok...") do
132
+ zip_dest = File.join(ShopifyCli.cache_dir, "ngrok.zip")
132
133
  unless File.exist?(zip_dest)
133
- ctx.system('curl', '-o', zip_dest, DOWNLOAD_URLS[ctx.os], chdir: ShopifyCli.cache_dir)
134
+ ctx.system("curl", "-o", zip_dest, DOWNLOAD_URLS[ctx.os], chdir: ShopifyCli.cache_dir)
134
135
  end
135
136
  args = if ctx.linux?
136
137
  %W(unzip -u #{zip_dest})
@@ -141,6 +142,11 @@ module ShopifyCli
141
142
  ctx.rm(zip_dest)
142
143
  end
143
144
  spinner.wait
145
+
146
+ # final check to see if ngrok is accessible
147
+ unless File.exist?(File.join(ShopifyCli.cache_dir, ngrok))
148
+ ctx.abort(ctx.message("core.tunnel.error.ngrok", ngrok, ShopifyCli.cache_dir))
149
+ end
144
150
  end
145
151
 
146
152
  def fetch_url(ctx, log_path)
@@ -151,7 +157,7 @@ module ShopifyCli
151
157
  end
152
158
 
153
159
  def ngrok_command(port)
154
- "\"#{File.join(ShopifyCli.cache_dir, 'ngrok')}\" http -inspect=false -log=stdout -log-level=debug #{port}"
160
+ "\"#{File.join(ShopifyCli.cache_dir, "ngrok")}\" http -inspect=false -log=stdout -log-level=debug #{port}"
155
161
  end
156
162
 
157
163
  def seconds_to_hm(seconds)
@@ -167,15 +173,15 @@ module ShopifyCli
167
173
 
168
174
  def restart_ngrok(ctx, port)
169
175
  unless ShopifyCli::ProcessSupervision.stop(:ngrok)
170
- ctx.abort(ctx.message('core.tunnel.error.stop'))
176
+ ctx.abort(ctx.message("core.tunnel.error.stop"))
171
177
  end
172
178
  start_ngrok(ctx, port)
173
179
  end
174
180
 
175
181
  def check_prereq_command(ctx, command)
176
182
  cmd_path = ctx.which(command)
177
- ctx.abort(ctx.message('core.tunnel.error.prereq_command_required', command)) if cmd_path.nil?
178
- ctx.done(ctx.message('core.tunnel.prereq_command_location', command, cmd_path))
183
+ ctx.abort(ctx.message("core.tunnel.error.prereq_command_required", command)) if cmd_path.nil?
184
+ ctx.done(ctx.message("core.tunnel.prereq_command_location", command, cmd_path))
179
185
  end
180
186
 
181
187
  class LogParser # :nodoc:
@@ -193,7 +199,7 @@ module ShopifyCli
193
199
  sleep(1)
194
200
  end
195
201
 
196
- raise FetchUrlError, Context.message('core.tunnel.error.url_fetch_failure') unless url
202
+ raise FetchUrlError, Context.message("core.tunnel.error.url_fetch_failure") unless url
197
203
  end
198
204
 
199
205
  def parse
@@ -1,3 +1,3 @@
1
1
  module ShopifyCli
2
- VERSION = '1.4.1'
2
+ VERSION = "1.8.0"
3
3
  end
data/lib/shopify_cli.rb CHANGED
@@ -8,23 +8,23 @@ Thread.report_on_exception = false
8
8
  # require_relative 'support/ruby_backports'
9
9
 
10
10
  # See bin/load_shopify.rb
11
- ENV['PATH'] = ENV['PATH'].split(':').select { |p| p.start_with?('/', '~') }.join(':') unless defined?($original_env)
11
+ ENV["PATH"] = ENV["PATH"].split(":").select { |p| p.start_with?("/", "~") }.join(":") unless defined?($original_env)
12
12
 
13
13
  # Load vendor and CLI UI/Kit.
14
14
  # Nothing else should be loaded at this point and nothing else should be added to the load path on boot
15
15
  vendor_path = File.expand_path("../../vendor/lib", __FILE__)
16
16
  $LOAD_PATH.unshift(vendor_path) unless $LOAD_PATH.include?(vendor_path)
17
17
 
18
- deps = %w(cli-ui cli-kit smart_properties)
18
+ deps = %w(cli-ui cli-kit smart_properties webrick)
19
19
  deps.each do |dep|
20
20
  vendor_path = File.expand_path("../../vendor/deps/#{dep}/lib", __FILE__)
21
21
  $LOAD_PATH.unshift(vendor_path) unless $LOAD_PATH.include?(vendor_path)
22
22
  end
23
23
 
24
- require 'cli/ui'
25
- require 'cli/kit'
26
- require 'smart_properties'
27
- require_relative 'shopify-cli/version'
24
+ require "cli/ui"
25
+ require "cli/kit"
26
+ require "smart_properties"
27
+ require_relative "shopify-cli/version"
28
28
 
29
29
  # Enable stdout routing. At this point all calls to STDOUT (and STDERR) will go through this class.
30
30
  # See https://github.com/Shopify/cli-ui/blob/master/lib/cli/ui/stdout_router.rb for more info
@@ -39,16 +39,16 @@ CLI::UI::StdoutRouter.enable
39
39
  module ShopifyCli
40
40
  extend CLI::Kit::Autocall
41
41
 
42
- TOOL_NAME = 'shopify'
43
- TOOL_FULL_NAME = 'Shopify CLI'
44
- ROOT = File.expand_path('../..', __FILE__)
45
- PROJECT_TYPES_DIR = File.join(ROOT, 'lib', 'project_types')
46
- TEMP_DIR = File.join(ROOT, '.tmp')
42
+ TOOL_NAME = "shopify"
43
+ TOOL_FULL_NAME = "Shopify CLI"
44
+ ROOT = File.expand_path("../..", __FILE__)
45
+ PROJECT_TYPES_DIR = File.join(ROOT, "lib", "project_types")
46
+ TEMP_DIR = File.join(ROOT, ".tmp")
47
47
 
48
48
  # programmer emoji if default install location, else wrench emoji
49
- EMOJI = ROOT == '/opt/shopify' ? "\u{1f469}\u{200d}\u{1f4bb}" : "\u{1f527}"
49
+ EMOJI = ROOT == "/opt/shopify" ? "\u{1f469}\u{200d}\u{1f4bb}" : "\u{1f527}"
50
50
  # shrug or boom emoji
51
- FAILMOJI = ROOT == '/opt/shopify' ? "\u{1f937}" : "\u{1f4a5}"
51
+ FAILMOJI = ROOT == "/opt/shopify" ? "\u{1f937}" : "\u{1f4a5}"
52
52
 
53
53
  # Exit management in `shopify-app-cli` follows the management set out by CLI Kit.
54
54
  # https://github.com/Shopify/cli-kit/blob/master/lib/cli/kit.rb
@@ -94,44 +94,49 @@ module ShopifyCli
94
94
  )
95
95
  end
96
96
 
97
- autoload :AdminAPI, 'shopify-cli/admin_api'
98
- autoload :API, 'shopify-cli/api'
99
- autoload :Command, 'shopify-cli/command'
100
- autoload :Commands, 'shopify-cli/commands'
101
- autoload :Context, 'shopify-cli/context'
102
- autoload :Core, 'shopify-cli/core'
103
- autoload :DB, 'shopify-cli/db'
104
- autoload :Feature, 'shopify-cli/feature'
105
- autoload :Form, 'shopify-cli/form'
106
- autoload :Git, 'shopify-cli/git'
107
- autoload :Helpers, 'shopify-cli/helpers'
108
- autoload :Heroku, 'shopify-cli/heroku'
109
- autoload :JsDeps, 'shopify-cli/js_deps'
110
- autoload :JsSystem, 'shopify-cli/js_system'
111
- autoload :Log, 'shopify-cli/log'
112
- autoload :OAuth, 'shopify-cli/oauth'
113
- autoload :Options, 'shopify-cli/options'
114
- autoload :PartnersAPI, 'shopify-cli/partners_api'
115
- autoload :ProcessSupervision, 'shopify-cli/process_supervision'
116
- autoload :Project, 'shopify-cli/project'
117
- autoload :ProjectType, 'shopify-cli/project_type'
118
- autoload :Resources, 'shopify-cli/resources'
119
- autoload :Shopifolk, 'shopify-cli/shopifolk'
120
- autoload :SubCommand, 'shopify-cli/sub_command'
121
- autoload :Task, 'shopify-cli/task'
122
- autoload :Tasks, 'shopify-cli/tasks'
123
- autoload :Tunnel, 'shopify-cli/tunnel'
124
-
125
- require 'shopify-cli/messages/messages'
97
+ autoload :AdminAPI, "shopify-cli/admin_api"
98
+ autoload :API, "shopify-cli/api"
99
+ autoload :Command, "shopify-cli/command"
100
+ autoload :Commands, "shopify-cli/commands"
101
+ autoload :Context, "shopify-cli/context"
102
+ autoload :Core, "shopify-cli/core"
103
+ autoload :DB, "shopify-cli/db"
104
+ autoload :Feature, "shopify-cli/feature"
105
+ autoload :Form, "shopify-cli/form"
106
+ autoload :Git, "shopify-cli/git"
107
+ autoload :Helpers, "shopify-cli/helpers"
108
+ autoload :Heroku, "shopify-cli/heroku"
109
+ autoload :JsDeps, "shopify-cli/js_deps"
110
+ autoload :JsSystem, "shopify-cli/js_system"
111
+ autoload :MethodObject, "shopify-cli/method_object"
112
+ autoload :LazyDelegator, "shopify-cli/lazy_delegator"
113
+ autoload :Log, "shopify-cli/log"
114
+ autoload :OAuth, "shopify-cli/oauth"
115
+ autoload :Options, "shopify-cli/options"
116
+ autoload :PartnersAPI, "shopify-cli/partners_api"
117
+ autoload :ProcessSupervision, "shopify-cli/process_supervision"
118
+ autoload :Project, "shopify-cli/project"
119
+ autoload :ProjectType, "shopify-cli/project_type"
120
+ autoload :ResolveConstant, "shopify-cli/resolve_constant"
121
+ autoload :Resources, "shopify-cli/resources"
122
+ autoload :Result, "shopify-cli/result"
123
+ autoload :Shopifolk, "shopify-cli/shopifolk"
124
+ autoload :SubCommand, "shopify-cli/sub_command"
125
+ autoload :Task, "shopify-cli/task"
126
+ autoload :Tasks, "shopify-cli/tasks"
127
+ autoload :TransformDataStructure, "shopify-cli/transform_data_structure"
128
+ autoload :Tunnel, "shopify-cli/tunnel"
129
+
130
+ require "shopify-cli/messages/messages"
126
131
  Context.load_messages(ShopifyCli::Messages::MESSAGES)
127
132
 
128
133
  def self.cache_dir
129
- cache_dir = if ENV.key?('RUNNING_SHOPIFY_CLI_TESTS')
134
+ cache_dir = if ENV.key?("RUNNING_SHOPIFY_CLI_TESTS")
130
135
  TEMP_DIR
131
- elsif ENV['LOCALAPPDATA'].nil?
132
- File.join(File.expand_path(ENV.fetch('XDG_CACHE_HOME', '~/.cache')), TOOL_NAME)
136
+ elsif ENV["LOCALAPPDATA"].nil?
137
+ File.join(File.expand_path(ENV.fetch("XDG_CACHE_HOME", "~/.cache")), TOOL_NAME)
133
138
  else
134
- File.join(File.expand_path(ENV['LOCALAPPDATA']), TOOL_NAME)
139
+ File.join(File.expand_path(ENV["LOCALAPPDATA"]), TOOL_NAME)
135
140
  end
136
141
 
137
142
  # Make sure the cache dir always exists
@@ -141,20 +146,20 @@ module ShopifyCli
141
146
  end
142
147
 
143
148
  def self.tool_config_path
144
- if ENV.key?('RUNNING_SHOPIFY_CLI_TESTS')
149
+ if ENV.key?("RUNNING_SHOPIFY_CLI_TESTS")
145
150
  TEMP_DIR
146
- elsif ENV['APPDATA'].nil?
147
- File.join(File.expand_path(ENV.fetch('XDG_CONFIG_HOME', '~/.config')), TOOL_NAME)
151
+ elsif ENV["APPDATA"].nil?
152
+ File.join(File.expand_path(ENV.fetch("XDG_CONFIG_HOME", "~/.config")), TOOL_NAME)
148
153
  else
149
- File.join(File.expand_path(ENV['APPDATA']), TOOL_NAME)
154
+ File.join(File.expand_path(ENV["APPDATA"]), TOOL_NAME)
150
155
  end
151
156
  end
152
157
 
153
158
  def self.log_file
154
- File.join(tool_config_path, 'logs', 'log.log')
159
+ File.join(tool_config_path, "logs", "log.log")
155
160
  end
156
161
 
157
162
  def self.debug_log_file
158
- File.join(tool_config_path, 'logs', 'debug.log')
163
+ File.join(tool_config_path, "logs", "debug.log")
159
164
  end
160
165
  end
data/shopify-cli.gemspec CHANGED
@@ -1,11 +1,11 @@
1
- require_relative 'lib/shopify-cli/version'
1
+ require_relative "lib/shopify-cli/version"
2
2
 
3
3
  Gem::Specification.new do |spec|
4
4
  spec.name = "shopify-cli"
5
5
  spec.version = ShopifyCli::VERSION
6
6
  spec.authors = ["Shopify"]
7
7
  spec.email = ["dev-tools-education@shopify.com"]
8
- spec.license = 'MIT'
8
+ spec.license = "MIT"
9
9
 
10
10
  spec.summary = "Shopify CLI helps you build Shopify apps faster."
11
11
  spec.description = <<~HERE
@@ -25,7 +25,7 @@ Gem::Specification.new do |spec|
25
25
 
26
26
  # Specify which files should be added to the gem when it is released.
27
27
  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
28
- spec.files = Dir.chdir(File.expand_path('..', __FILE__)) do
28
+ spec.files = Dir.chdir(File.expand_path("..", __FILE__)) do
29
29
  %x(git ls-files -z).split("\x0").reject do |f|
30
30
  f.match(%r{^(test|spec|features|packaging)/}) ||
31
31
  f.match(%r{^bin/(update-deps|shopify.bat)$})
@@ -35,7 +35,7 @@ Gem::Specification.new do |spec|
35
35
  spec.require_paths = ["lib", "vendor"]
36
36
  spec.extensions = ["ext/shopify-cli/extconf.rb"]
37
37
 
38
- spec.add_development_dependency('bundler', '~> 1.17')
39
- spec.add_development_dependency('rake', '~> 12.3', '>= 12.3.3')
40
- spec.add_development_dependency('minitest', '~> 5.0')
38
+ spec.add_development_dependency("bundler", "~> 1.17")
39
+ spec.add_development_dependency("rake", "~> 12.3", ">= 12.3.3")
40
+ spec.add_development_dependency("minitest", "~> 5.0")
41
41
  end
data/shopify.fish CHANGED
@@ -7,6 +7,6 @@ if [ $status != "0" ]
7
7
  echo "This version of Shopify App CLI is no longer supported. You’ll need to migrate to the new CLI version to continue.
8
8
 
9
9
  Please visit this page for complete instructions:
10
- https://shopify.github.io/shopify-app-cli/migrate/
10
+ https://shopify.dev/tools/cli/troubleshooting#migrate-from-a-legacy-version
11
11
  "
12
12
  end
data/shopify.sh CHANGED
@@ -6,6 +6,6 @@ if [ "$?" != "0" ]; then
6
6
  echo "This version of Shopify App CLI is no longer supported. You’ll need to migrate to the new CLI version to continue.
7
7
 
8
8
  Please visit this page for complete instructions:
9
- https://shopify.github.io/shopify-app-cli/migrate/
9
+ https://shopify.dev/tools/cli/troubleshooting#migrate-from-a-legacy-version
10
10
  "
11
11
  fi
@@ -1 +1 @@
1
- 1013aa5c5664e7034ca3f02fd2e0513361b07e95 (dirty)
1
+ 6eadd6c7f7fc9217008c2cfb0bc3101cb6cf3b41
@@ -61,7 +61,7 @@ module CLI
61
61
  #
62
62
  # @param msg [String] the message to log
63
63
  def debug(msg)
64
- $stdout.puts CLI::UI.fmt(msg) if is_debug?
64
+ $stdout.puts CLI::UI.fmt(msg) if debug?
65
65
  @debug_logger.debug(format_debug(msg))
66
66
  end
67
67
 
@@ -73,7 +73,7 @@ module CLI
73
73
  "[#{CLI::UI::StdoutRouter.current_id[:id]}] #{msg}"
74
74
  end
75
75
 
76
- def is_debug?
76
+ def debug?
77
77
  val = ENV[@env_debug_name]
78
78
  val && val != '0' && val != ''
79
79
  end
@@ -94,11 +94,11 @@ module CLI
94
94
  delegate_open3(*a, sudo: sudo, env: env, method: :popen2, **kwargs, &block)
95
95
  end
96
96
 
97
- def popen2e(*a, sudo: false, env: ENV, **kwargs)
97
+ def popen2e(*a, sudo: false, env: ENV, **kwargs, &block)
98
98
  delegate_open3(*a, sudo: sudo, env: env, method: :popen2e, **kwargs, &block)
99
99
  end
100
100
 
101
- def popen3(*a, sudo: false, env: ENV, **kwargs)
101
+ def popen3(*a, sudo: false, env: ENV, **kwargs, &block)
102
102
  delegate_open3(*a, sudo: sudo, env: env, method: :popen3, **kwargs, &block)
103
103
  end
104
104
 
@@ -112,7 +112,7 @@ module CLI
112
112
  # - `**kwargs`: additional keyword arguments to pass to Process.spawn
113
113
  #
114
114
  # #### Returns
115
- # - `status`: boolean success status of the command execution
115
+ # - `status`: The `Process:Status` result for the command execution
116
116
  #
117
117
  # #### Usage
118
118
  # `stat = CLI::Kit::System.system('ls', 'a_folder')`
@@ -1 +1 @@
1
- 5ea578d3110af35c73837a8008147ce53a4b56ed (dirty)
1
+ 168ce68b31d8436b2b222d6f063e5c7225785bd4
@@ -1,18 +1,19 @@
1
1
  module CLI
2
2
  module UI
3
- autoload :ANSI, 'cli/ui/ansi'
4
- autoload :Glyph, 'cli/ui/glyph'
5
- autoload :Color, 'cli/ui/color'
6
- autoload :Frame, 'cli/ui/frame'
7
- autoload :OS, 'cli/ui/os'
8
- autoload :Printer, 'cli/ui/printer'
9
- autoload :Progress, 'cli/ui/progress'
10
- autoload :Prompt, 'cli/ui/prompt'
11
- autoload :Terminal, 'cli/ui/terminal'
12
- autoload :Truncater, 'cli/ui/truncater'
13
- autoload :Formatter, 'cli/ui/formatter'
14
- autoload :Spinner, 'cli/ui/spinner'
15
- autoload :Widgets, 'cli/ui/widgets'
3
+ autoload :ANSI, 'cli/ui/ansi'
4
+ autoload :Glyph, 'cli/ui/glyph'
5
+ autoload :Color, 'cli/ui/color'
6
+ autoload :Frame, 'cli/ui/frame'
7
+ autoload :OS, 'cli/ui/os'
8
+ autoload :Printer, 'cli/ui/printer'
9
+ autoload :Progress, 'cli/ui/progress'
10
+ autoload :Prompt, 'cli/ui/prompt'
11
+ autoload :Terminal, 'cli/ui/terminal'
12
+ autoload :Truncater, 'cli/ui/truncater'
13
+ autoload :Formatter, 'cli/ui/formatter'
14
+ autoload :Spinner, 'cli/ui/spinner'
15
+ autoload :Widgets, 'cli/ui/widgets'
16
+ autoload :Wrap, 'cli/ui/wrap'
16
17
 
17
18
  # Convenience accessor to +CLI::UI::Spinner::SpinGroup+
18
19
  SpinGroup = Spinner::SpinGroup
@@ -29,7 +30,7 @@ module CLI
29
30
  end
30
31
 
31
32
  # Color resolution using +CLI::UI::Color.lookup+
32
- # Will lookup using +Color.lookup+ if a symbol, otherwise we assume it is a valid color and return it
33
+ # Will lookup using +Color.lookup+ unless it's already a CLI::UI::Color (or nil)
33
34
  #
34
35
  # ==== Attributes
35
36
  #
@@ -37,26 +38,25 @@ module CLI
37
38
  #
38
39
  def self.resolve_color(input)
39
40
  case input
40
- when Symbol
41
- CLI::UI::Color.lookup(input)
42
- else
41
+ when CLI::UI::Color, nil
43
42
  input
43
+ else
44
+ CLI::UI::Color.lookup(input)
44
45
  end
45
46
  end
46
47
 
47
48
  # Frame style resolution using +CLI::UI::Frame::FrameStyle.lookup+.
48
- # Will lookup using +FrameStyle.lookup+ if the input is a symbol. Otherwise,
49
- # we assume it's a valid FrameStyle
49
+ # Will lookup using +FrameStyle.lookup+ unless it's already a CLI::UI::Frame::FrameStyle(or nil)
50
50
  #
51
51
  # ==== Attributes
52
52
  #
53
53
  # * +input+ - frame style to resolve
54
54
  def self.resolve_style(input)
55
55
  case input
56
- when Symbol
57
- CLI::UI::Frame::FrameStyle.lookup(input)
58
- else
56
+ when CLI::UI::Frame::FrameStyle, nil
59
57
  input
58
+ else
59
+ CLI::UI::Frame::FrameStyle.lookup(input)
60
60
  end
61
61
  end
62
62
 
@@ -114,6 +114,10 @@ module CLI
114
114
  CLI::UI::Formatter.new(input).format(enable_color: enable_color)
115
115
  end
116
116
 
117
+ def self.wrap(input)
118
+ CLI::UI::Wrap.new(input).wrap
119
+ end
120
+
117
121
  # Convenience Method for +CLI::UI::Printer.puts+
118
122
  #
119
123
  # ==== Attributes