TerraformDevKit 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 631ca645a080aebd548ff5f41535be564205eb55
+  data.tar.gz: b7b4c8b3d1cae82a36ecfd5a9c5e2c37df0ce29c
+SHA512:
+  metadata.gz: aff2cf1d9f94408c7f6a61d049aaab32d774f36b358f73ee26562f57d04ed86e1216578eee3609dbcc4b6a5e6aea19744675f1f2f3a01de47c889df4903038b5
+  data.tar.gz: 8fae71f01f65ce6ea1c86b024bc5cbbc174a1894f15e4537dd0390595df3273a9cdeb7020020bb5f1a9250e163682233744fffd8bfccd2337588e85eca2d9f00

data/.gitignore

@@ -0,0 +1,131 @@
+
+# Created by https://www.gitignore.io/api/ruby,visualstudiocode,rubymine
+
+### Ruby ###
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+### RubyMine ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and Webstorm
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff:
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/dictionaries
+
+# Sensitive or high-churn files:
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.xml
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+
+# Gradle:
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# CMake
+cmake-build-debug/
+
+# Mongo Explorer plugin:
+.idea/**/mongoSettings.xml
+
+## File-based project format:
+*.iws
+
+## Plugin-specific files:
+
+# IntelliJ
+/out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+### RubyMine Patch ###
+# Comment Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-215987721
+
+.idea/
+ *.iml
+ modules.xml
+ .idea/misc.xml
+ *.ipr
+
+# Sonarlint plugin
+.idea/sonarlint
+
+### VisualStudioCode ###
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+
+# End of https://www.gitignore.io/api/ruby,visualstudiocode,rubymine
+
+# Custom
+
+Gemfile.lock
+.rspec_status

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.1.6
+before_install: gem install bundler -v 1.14.6

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in TerraformDevKit.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2017 Cimpress
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.md

@@ -0,0 +1,55 @@
+# TerraformDevKit
+
+Set of scripts to ease development and testing with [Terraform](https://www.terraform.io/).
+
+The script collection incldues support for:
+
+* Managing AWS credentials
+* Simple reading and writing to AWS DynamoDB
+* Polling until an AWS ApiGateway resource becomes ready
+* Executing commands
+* Locally installing Terraform and [Terragrunt](https://github.com/gruntwork-io/terragrunt)
+* Backing up the state from a failed Terraform execution
+* Multiplatform tools
+* Simple configuration management
+
+Most of these scripts exist to provide support to a module development and testing environment for Terraform: [TerraformModules](https://github.com/betabandido/TerraformModules). But, they might be useful for other purposes too.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'TerraformDevKit'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install TerraformDevKit
+
+## Usage
+
+To use the library simply import it as:
+
+```ruby
+require 'TerraformDevKit'
+```    
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/betabandido/TerraformDevKit.
+
+
+## License
+
+The gem is available as open source under the terms of the [Apache License, Version 2.0](https://opensource.org/licenses/Apache-2.0).

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/TerraformDevKit.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'TerraformDevKit/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'TerraformDevKit'
+  spec.version       = TerraformDevKit::VERSION
+  spec.authors       = ['Victor Jimenez']
+  spec.email         = ['vjimenez@vistaprint.com']
+
+  spec.summary       = 'Set of scripts to ease development and testing with Terraform.'
+  spec.homepage      = 'https://github.com/betabandido/TerraformDevKit'
+  spec.license       = 'Apache-2.0'
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.14'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+
+  spec.add_runtime_dependency 'aws-sdk', '~> 2.9.37'
+  spec.add_runtime_dependency 'rubyzip', '~> 1.2.1'
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "TerraformDevKit"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/wait_for_url

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+
+require 'open-uri'
+require 'openssl'
+
+# Interval between retries (in seconds)
+INTERVAL_LENGTH = 5.0
+
+# Maximum amount of time to keep retrying (in seconds)
+MAX_TIME_TO_RETRY = 300.0
+
+if ARGV.length != 1
+  puts 'USAGE: wait_for_url.rb <url>'
+  exit
+end
+
+url = ARGV[0]
+retries = (MAX_TIME_TO_RETRY / INTERVAL_LENGTH).ceil
+
+begin
+  puts "Fetching #{url}"
+  open(url, ssl_verify_mode: OpenSSL::SSL::VERIFY_NONE, redirect: false)
+rescue OpenURI::HTTPError => error
+  response = error.io
+  puts "Response status code: #{response.status[0]}"
+  unless (retries -= 1).zero? || response.status[0] != '500'
+    sleep(INTERVAL_LENGTH)
+    retry
+  end
+rescue OpenURI::HTTPRedirect => error
+  puts "Redirect to: #{error.uri}"
+end

data/lib/TerraformDevKit.rb

@@ -0,0 +1,9 @@
+require 'TerraformDevKit/aws'
+require 'TerraformDevKit/backup_state'
+require 'TerraformDevKit/command'
+require 'TerraformDevKit/config'
+require 'TerraformDevKit/dynamodb'
+require 'TerraformDevKit/os'
+require 'TerraformDevKit/terraform_installer'
+require 'TerraformDevKit/terragrunt_installer'
+require 'TerraformDevKit/version'

data/lib/TerraformDevKit/aws.rb

@@ -0,0 +1,63 @@
+require 'aws-sdk'
+
+Aws.use_bundled_cert!
+
+module TerraformDevKit
+  class AwsConfig
+    def initialize(config)
+      unless config.nil?
+        @profile = config.fetch('profile', nil)
+        @region = config.fetch('region', nil)
+        @access_key_id = config.fetch('access_key_id', nil)
+        @secret_access_key = config.fetch('secret_access_key', nil)
+      end
+    end
+
+    def credentials
+      unless profile.nil?
+        credentials = Aws::SharedCredentials.new(profile_name: profile)
+        return credentials if credentials.set?
+      end
+
+      return Aws::Credentials.new(*access_keys) if access_keys_available?
+
+      raise 'Cannot find AWS credentials'
+    end
+
+    def region
+      @region || ENV['AWS_REGION']
+    end
+
+    def profile
+      @profile || ENV['AWS_PROFILE']
+    end
+
+    private
+
+    def access_keys
+      return config_access_keys if config_has_access_keys?
+      return environment_access_keys if environment_has_access_keys?
+      nil
+    end
+
+    def access_keys_available?
+      config_has_access_keys? || environment_has_access_keys?
+    end
+
+    def config_has_access_keys?
+      !@access_key_id.nil? && !@secret_access_key.nil?
+    end
+
+    def config_access_keys
+      return @access_key_id, @secret_access_key
+    end
+
+    def environment_has_access_keys?
+      ENV.key?('AWS_ACCESS_KEY_ID') && ENV.key?('AWS_SECRET_ACCESS_KEY')
+    end
+
+    def environment_access_keys
+      return ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
+    end
+  end
+end

data/lib/TerraformDevKit/backup_state.rb

@@ -0,0 +1,18 @@
+require 'fileutils'
+
+require_relative 'zip_file_generator'
+
+module TerraformDevKit
+  class BackupState
+    def self.backup(prefix)
+      backup_path = ENV['TM_STATE_BACKUP_PATH']
+      return if backup_path.nil?
+
+      filename = "#{prefix}failure_state.zip"
+      ZipFileGenerator.new('.', filename).write
+
+      FileUtils.cp(filename, backup_path)
+      puts "Copied state to #{File.join(backup_path, filename)}"
+    end
+  end
+end

data/lib/TerraformDevKit/command.rb

@@ -0,0 +1,20 @@
+require 'open3'
+
+module TerraformDevKit
+  class Command
+    def self.run(cmd, directory = Dir.pwd)
+      output = []
+
+      Open3.popen2e(cmd, chdir: directory) do |_, stdout, thread|
+        while line = stdout.gets
+          output << line
+          puts(line)
+        end
+
+        raise "Error running command #{cmd}" unless thread.value.success?
+      end
+
+      output.join('')
+    end
+  end
+end

data/lib/TerraformDevKit/config.rb

@@ -0,0 +1,15 @@
+require 'yaml'
+
+module TerraformDevKit
+  class Configuration
+    @config = nil
+
+    def self.init(path)
+      @config = YAML.safe_load(File.read(path))
+    end
+
+    def self.get(key)
+      @config[key] unless @config.nil?
+    end
+  end
+end

data/lib/TerraformDevKit/download.rb

@@ -0,0 +1,17 @@
+require 'open-uri'
+require 'openssl'
+
+module TerraformDevKit
+  def self.download_file(url, filename, force_download: false)
+    unless File.exist?(filename) && !force_download
+      dirname = File.dirname(filename)
+      FileUtils.mkdir_p(dirname) unless Dir.exist?(dirname)
+
+      puts "Downloading #{url} to #{filename}..."
+
+      open(filename, 'wb') do |file|
+        file << open(url, ssl_verify_mode: OpenSSL::SSL::VERIFY_NONE).read
+      end
+    end
+  end
+end

data/lib/TerraformDevKit/dynamodb.rb

@@ -0,0 +1,24 @@
+require 'aws-sdk'
+
+Aws.use_bundled_cert!
+
+module TerraformDevKit
+  class DynamoDB
+    def initialize(credentials, region)
+      @db_client = Aws::DynamoDB::Resource.new(
+        credentials: credentials,
+        region: region
+      )
+    end
+
+    def get_item(table_name, key)
+      table = @db_client.table(table_name)
+      table.get_item(key: key)
+    end
+
+    def put_item(table_name, item)
+      table = @db_client.table(table_name)
+      table.put_item(item: item)
+    end
+  end
+end

data/lib/TerraformDevKit/os.rb

@@ -0,0 +1,29 @@
+module TerraformDevKit
+  class OS
+    def self.host_os
+      case RUBY_PLATFORM
+      when /linux/
+        'linux'
+      when /darwin/
+        'darwin'
+      when /mingw/
+        'windows'
+      else
+        raise 'Cannot determine OS'
+      end
+    end
+
+    def self.env_path_separator
+      case host_os
+      when 'linux', 'darwin'
+        ':'
+      when 'windows'
+        ';'
+      end
+    end
+
+    def self.join_env_path(path1, path2)
+      "#{path1}#{env_path_separator}#{path2}"
+    end
+  end
+end

data/lib/TerraformDevKit/terraform_installer.rb

@@ -0,0 +1,47 @@
+require 'zip'
+
+require_relative 'download'
+require_relative 'os'
+require_relative 'command'
+
+module TerraformDevKit
+  class TerraformInstaller
+    LOCAL_FILE_NAME = 'terraform.zip'.freeze
+
+    def self.installed_terraform_version
+      version = Command.run('terraform --version').tr("\r\n", '')
+      match = /Terraform v(\d+\.\d+\.\d+)/.match(version)
+      match[1] unless match.nil?
+    rescue
+      nil
+    end
+
+    def self.download_terraform(version)
+      TerraformDevKit.download_file(
+        "https://releases.hashicorp.com/terraform/#{version}/terraform_#{version}_#{OS.host_os}_amd64.zip",
+        LOCAL_FILE_NAME,
+        force_download: true
+      )
+    end
+
+    def self.unzip_terraform
+      Zip::File.open(LOCAL_FILE_NAME) do |zip_file|
+        zip_file.each do |entry|
+          puts "Extracting #{entry.name}"
+          entry.restore_permissions = true
+          entry.extract { true }
+        end
+      end
+    end
+
+    def self.install_local(version)
+      if installed_terraform_version == version
+        puts 'Terraform already installed'
+        return
+      end
+
+      download_terraform(version)
+      unzip_terraform
+    end
+  end
+end

data/lib/TerraformDevKit/terragrunt_installer.rb

@@ -0,0 +1,41 @@
+require 'fileutils'
+
+require_relative 'download'
+require_relative 'os'
+require_relative 'command'
+
+module TerraformDevKit
+  class TerragruntInstaller
+    EXTENSION = (OS.host_os == 'windows' ? '.exe' : '').freeze
+    LOCAL_FILE_NAME = "terragrunt#{EXTENSION}".freeze
+
+    def self.installed_terragrunt_version
+      version = Command.run('terragrunt --version').tr("\r\n", '')
+      match = /terragrunt version v(\d+\.\d+\.\d+)/.match(version)
+      match[1] unless match.nil?
+    rescue
+      nil
+    end
+
+    def self.download_terragrunt(version)
+      TerraformDevKit.download_file(
+        "https://github.com/gruntwork-io/terragrunt/releases/download/v#{version}/terragrunt_#{OS.host_os}_amd64#{EXTENSION}",
+        LOCAL_FILE_NAME,
+        force_download: true
+      )
+    end
+
+    def self.install_local(version)
+      if installed_terragrunt_version == version
+        puts 'Terragrunt already installed'
+        return
+      end
+
+      download_terragrunt(version)
+
+      unless TerraformDevKit::OS.host_os == 'windows'
+        FileUtils.chmod('u+x', LOCAL_FILE_NAME)
+      end
+    end
+  end
+end

data/lib/TerraformDevKit/version.rb

@@ -0,0 +1,3 @@
+module TerraformDevKit
+  VERSION = "0.1.0"
+end

data/lib/TerraformDevKit/zip_file_generator.rb

@@ -0,0 +1,48 @@
+require 'zip'
+
+module TerraformDevKit
+  class ZipFileGenerator
+    def initialize(input_dir, output_file)
+      puts "REAL ONE"
+      @input_dir = input_dir
+      @output_file = output_file
+    end
+
+    def write
+      entries = Dir.entries(@input_dir)
+      entries.delete('.')
+      entries.delete('..')
+      Zip::File.open(@output_file, Zip::File::CREATE) do |zipfile|
+        write_entries(entries, '', zipfile)
+      end
+    end
+
+    private
+
+    def write_entries(entries, path, zipfile)
+      entries.each do |e|
+        zip_file_path = path == '' ? e : File.join(path, e)
+        disk_file_path = File.join(@input_dir, zip_file_path)
+        if File.directory?(disk_file_path)
+          write_directory(disk_file_path, zip_file_path, zipfile)
+        else
+          write_file(disk_file_path, zip_file_path, zipfile)
+        end
+      end
+    end
+
+    def write_directory(disk_file_path, zip_file_path, zipfile)
+      zipfile.mkdir(zip_file_path)
+      subdir = Dir.entries(disk_file_path)
+      subdir.delete('.')
+      subdir.delete('..')
+      write_entries(subdir, zip_file_path, zipfile)
+    end
+
+    def write_file(disk_file_path, zip_file_path, zipfile)
+      zipfile.get_output_stream(zip_file_path) do |f|
+        f.puts(File.open(disk_file_path, 'rb').read)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,138 @@
+--- !ruby/object:Gem::Specification
+name: TerraformDevKit
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Victor Jimenez
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-06-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.37
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.9.37
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+description: 
+email:
+- vjimenez@vistaprint.com
+executables:
+- wait_for_url
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- TerraformDevKit.gemspec
+- bin/console
+- bin/setup
+- exe/wait_for_url
+- lib/TerraformDevKit.rb
+- lib/TerraformDevKit/aws.rb
+- lib/TerraformDevKit/backup_state.rb
+- lib/TerraformDevKit/command.rb
+- lib/TerraformDevKit/config.rb
+- lib/TerraformDevKit/download.rb
+- lib/TerraformDevKit/dynamodb.rb
+- lib/TerraformDevKit/os.rb
+- lib/TerraformDevKit/terraform_installer.rb
+- lib/TerraformDevKit/terragrunt_installer.rb
+- lib/TerraformDevKit/version.rb
+- lib/TerraformDevKit/zip_file_generator.rb
+homepage: https://github.com/betabandido/TerraformDevKit
+licenses:
+- Apache-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Set of scripts to ease development and testing with Terraform.
+test_files: []