nswtopo 2.0.0.pre.beta1 → 3.0

data/docs/inspect.md

@@ -0,0 +1,103 @@
+# Description
+
+Use the *inspect* command to examine ArcGIS REST endpoints and local GIS data.
+
+# ArcGIS REST layers
+
+List all the layers in an ArcGIS map or feature service as follows:
+
+```
+$ nswtopo inspect https://portal.spatial.nsw.gov.au/server/rest/services/NSW_Water_Theme/MapServer
+layers:
+├─ 0: HydroPoint
+├─ 1: AncillaryHydroPoint
+├─ 2: NamedWatercourse
+├─ 3: FuzzyExtentWaterLine
+├─ 4: Coastline
+├─ 5: HydroLine
+├─ 6: HydroArea
+└─ 7: FuzzyExtentWaterArea
+```
+
+List the fields for a layer using the layer URL, or with the `--layer` or `--id` option. The layer's fields and their types will be listed:
+
+```
+$ nswtopo inspect https://portal.spatial.nsw.gov.au/server/rest/services/NSW_Water_Theme/MapServer/6
+name: HydroArea
+id: 6
+geometry: Polygon
+fields:
+├─ attributereliabilitydate: Date
+├─ capturemethodcode: SmallInteger
+│  ...
+├─ urbanity: String
+└─ verticalaccuracy: Single
+```
+
+Use the `--fields` option to inspect values and counts for one or more fields:
+
+```
+$ nswtopo inspect --fields classsubtype,hydrotype https://portal.spatial.nsw.gov.au/server/rest/services/NSW_Water_Theme/MapServer/6
+classsubtype │ 447690 │ 1
+   hydrotype │   9070 │ ├─ 1
+   hydrotype │ 438620 │ └─ 2
+classsubtype │  20084 │ 2
+   hydrotype │  19849 │ ├─ 1
+   hydrotype │    235 │ └─ 2
+```
+
+Field names and all possible values are shown, with counts for each combination of values. In this case, the values are *coded values*. Use `--decode` to decode them:
+
+```
+$ nswtopo inspect --fields classsubtype,hydrotype --decode https://portal.spatial.nsw.gov.au/server/rest/services/NSW_Water_Theme/MapServer/6
+classsubtype │ 447690 │ WaterbodyArea
+   hydrotype │ 438620 │ ├─ ManMadeWaterBody
+   hydrotype │   9070 │ └─ NaturalWaterBody
+classsubtype │  20084 │ Watercourse
+   hydrotype │    235 │ ├─ Canal-Drain
+   hydrotype │  19849 │ └─ NaturalWatercourse
+```
+
+List all *coded value* conversions for a layer with the `--codes` option:
+
+```
+$ nswtopo inspect --codes https://portal.spatial.nsw.gov.au/server/rest/services/NSW_Water_Theme/MapServer/6
+perenniality:
+├─ 0 → NotApplicable
+├─ 1 → Perennial
+├─ 2 → NonPerennial
+└─ 3 → MainlyDry
+classsubtype:
+├─ 1 → WaterbodyArea
+│  └─ hydrotype:
+│     ├─ 1 → NaturalWaterBody
+│     └─ 2 → ManMadeWaterBody
+└─ 2 → Watercourse
+   └─ hydrotype:
+      ├─ 1 → NaturalWatercourse
+      └─ 2 → Canal-Drain
+```
+
+Use the `--where` option to restrict output using a SQL expression on the fields.
+
+# Local GIS Data
+
+Any OGR-readable data can likewise be examined using the `inspect` command. For example, to list layers contained in a spatialite file:
+
+```
+$ nswtopo inspect nsw.sqlite
+layers:
+├─ cableway (LineString)
+├─ electricitytransissionline (LineString)
+├─ railway (LineString)
+└─ trafficcontroldevice (Point)
+```
+
+To list field values for a layer:
+
+```
+$ nswtopo inspect nsw.sqlite --layer cableway --fields classsubtype
+classsubtype │  4 │ CableCar
+classsubtype │ 19 │ FlyingFox
+classsubtype │ 58 │ SkiLift
+```

data/docs/move.md

@@ -0,0 +1,9 @@
+# Description
+
+Use the *move* command to rearrange the layer order in a map. Specify the name of the layer you wish to move, and the layer you want to place it before or after:
+
+```
+$ nswtopo move map.tgz relief --after nsw.vegetation-spot5
+```
+
+Use the *info* command to see the names of layers currently in the map file.

data/docs/render.md

@@ -1,6 +1,10 @@
 # Description
 
-Once you've added your layers, use the *render* command to create the map itself. Different output formats are available for various purposes.
+Once you've added your layers, use the *render* command to create the map itself. Different output formats are available for various purposes. In its simplest form, to render a GeoTIFF from a map file:
+
+```
+$ nswtopo render map.tgz map.tif
+```
 
 Specify your output format either as a filename with appropriate extension, or just the format extension itself (in which case the map's file name will be used). You can create multiple outputs at once.
 
@@ -15,7 +19,8 @@ The following formats are available:
 * **pdf**: *Portable Document Format*, either in the original vector form, or as a raster by setting a resolution with `--ppi`
 * **kmz**: for use with *Google Earth* (add as a network link for best results)
 * **zip**: a tiled format used by the *Avenza Maps* mobile app
-* **mbtiles**: a tiled format for use with mobile GPS apps including *Locus Map* and *Guru Maps*
+* **mbtiles**: a tiled format for use with mobile GPS apps including *Locus Map* and *OruxMaps*
+* **gemf**: a fast tiled format compatible with *Locus Map*
 * **svgz**: a compressed SVG format, viewable directly in some browsers
 * **png**: the well-known *Portable Network Graphics* format
 * **jpg**: the well-known *JPEG* format (not well-suited to maps)
@@ -28,9 +33,7 @@ For the *mbtiles* format, resolution values are fixed to zoom levels. The defaul
 
 # Setting Up Chrome
 
-To create any output format except SVG, you'll need to have *Google Chrome* installed. Chrome is used by *nswtopo* in headless mode to render the vector SVG format as a raster graphic. *Firefox* can also be used, although it does not render some effects correctly. (On MacOS and Linux, Chrome is also used to measure font metrics during labelling.)
-
-Add the path for your Chrome executable to your *nswtopo* configuration as follows:
+You'll need to have *Google Chrome* or *Chromium* installed. The Chrome browser is used by *nswtopo* in headless mode to measure font metrics during labelling, and to render the vector SVG format as a raster graphic or PDF. Chrome should be detected automatically, but you can also configure its path manually if necessary:
 
 ```
 $ nswtopo config --chrome "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
@@ -38,6 +41,12 @@ $ nswtopo config --chrome "/Applications/Google Chrome.app/Contents/MacOS/Google
 
 # Miscellaneous
 
-For raster formats, use the `--dither` option to create the raster in indexed colour mode. This can reduce file size. For best results, have the `pngquant` program available on your command line for the dithering process.
+After generating your map in SVG format, you can add content outside of *nswtopo* using a vector graphics editor such as Inkscape. You can then generate raster formats from the edited SVG instead of the map file:
 
-After generating your map in SVG format, you can add content outside of *nswtopo* using a vector graphics editor such as Inkscape. Use the `--external` option to render from the edited map, instead of the internal copy maintained by *nswtopo*.
+```
+$ nswtopo render map.svg map.tif
+```
+
+Maps normally use a white background. To specify a different background colour, use the `--background` option.
+
+For raster formats, use the `--dither` option to create the raster in indexed colour mode. This can reduce file size. For best results, have the `pngquant` program available on your command line for the dithering process.

data/docs/scrape.md

@@ -0,0 +1,67 @@
+# Description
+
+Use *scrape* to download data from ArcGIS REST endpoint. Data may be downloaded from both *FeatureServer* and *MapServer* services, including *MapServer* services with no *Query* capability.
+
+# Usage
+
+Download some layers from an NSW ArcGIS server to a sqlite database `nsw.sqlite`:
+
+```
+$ nswtopo scrape https://portal.spatial.nsw.gov.au/server/rest/services/NSW_Transport_Theme/MapServer/1 nsw.sqlite
+nswtopo: saved 87731 features
+$ nswtopo scrape https://portal.spatial.nsw.gov.au/server/rest/services/NSW_Features_of_Interest_Category/MapServer/6 nsw.sqlite
+nswtopo: saved 6569 features
+$ nswtopo scrape https://portal.spatial.nsw.gov.au/server/rest/services/NSW_Transport_Theme/MapServer/10 nsw.sqlite
+nswtopo: saved 81 features
+```
+
+Provide the full URL for the layer, including id number, or use the `--id` or `--layer` option along with the service URL:
+
+```
+$ nswtopo scrape --layer Railway https://portal.spatial.nsw.gov.au/server/rest/services/NSW_Transport_Theme/MapServer nsw.sqlite
+nswtopo: saved 12979 features
+```
+
+Shapefile and sqlite output formats are supported. The filename extension determines the format, with `.sqlite` or `.db` selecting sqlite output, `.shp` a single shapefile layer, and any other filename a shapefile directory.
+
+Downloaded layers are named according to the ArcGIS layer name, or from the `--layer` option if specified.
+
+# Filtering
+
+Use the `--coords` option to restrict feature download to a specified bounding box:
+
+```
+$ nswtopo scrape --coords 148.26,-36.52,148.38,-36.47 https://portal.spatial.nsw.gov.au/server/rest/services/NSW_Transport_Theme/MapServer/10 nsw.sqlite
+nswtopo: saved 12 features
+```
+
+Use the `--where` option to restrict the download to certain field values:
+
+```
+$ nswtopo scrape --where "classsubtype = 1" https://portal.spatial.nsw.gov.au/server/rest/services/NSW_Transport_Theme/MapServer/10 nsw.sqlite
+nswtopo: saved 58 features
+```
+
+# Fields
+
+If all fields are not needed, apply the `--fields` option to specify a list of fields to be downloaded:
+
+```
+$ nswtopo scrape --fields CONTOUR_TY,ELEVATION https://services.thelist.tas.gov.au/arcgis/rest/services/Public/OpenDataWFS/MapServer/16 tas.sqlite
+nswtopo: saved 528438 features
+```
+
+Some ArcGIS fields contain `coded values`—integers or short strings representing longer, more descriptive strings. These can be decoded during download using the `--decode` option:
+
+```
+$ nswtopo scrape --fields classsubtype,hydrotype --decode https://portal.spatial.nsw.gov.au/server/rest/services/NSW_Water_Theme/MapServer/6 nsw.sqlite
+nswtopo: saved 467774 features
+```
+
+The `--decode` flag is particularly useful with type and subtype fields, where the same subtype code has a different meaning depending on the type code. Use the *inspect* command to view all codings for a given layer.
+
+# Scraping from Map Layers
+
+Some ArcGIS REST map layers do not expose the *Query* capability, preventing feature queries. It is still possible to download features from such a layer, provided it supports SVG output and dynamic layers.
+
+When this situation occurs, you may be prompted to provide a *unique value* field name with the `--unique` option. Choose a layer field which is likely to have a small number of possible values. Using `--fields` to restrict the fields is also recommended. Specify only the fields you need to reduce download time.

data/docs/spot-heights.md

@@ -10,14 +10,18 @@ DEM tiles from the ELVIS website are delivered as doubly-zipped files. It's not
 # Spot Height Configuration
 Use the `--spacing` option to determine the maximum density of spot heights on the map. The value in millimetres represents the minimum distance between any two spot heights.
 
-Choose the amount of smoothing to apply to the DEM with the `--smooth` option. The value represents a smoothing radius in millimetres. For consistency, the same smoothing radius shoult be used for both contours and spot heights.
+Choose the amount of smoothing to apply to the DEM with the `--smooth` option. The value represents a smoothing radius in millimetres. For consistency in elevation, the same smoothing radius should be used for both contours and spot heights.
 
 Use the `--prefer` option to favour `knolls` or `saddles` when selecting spot locations. No preference is taken by default.
 
+Use the `--extent` option to set a minimum size in millimetres when searching for spot-height features. Smaller, localised knolls and saddles will be rejected.
+
+DEM tiles are normally processed at their maximumum native resolution. Change this using the `--resolution` option. A reduced resolution (say 5 metres) can markedly improve processing speed for 1- and 2-metre tiles.
+
 # Layer Position
 
 Use an `--after`, `--before` or `--replace` option to insert the spot heights in an appropriate layer position. You will most likely want to replace an existing spot heights layer:
 
 ```
-$ nswtopo contours --replace nsw.topographic.spot-heights map.tgz DATA_25994.zip
+$ nswtopo spot-heights --replace nsw.topographic.spot-heights map.tgz DATA_25994.zip
 ```

data/lib/nswtopo/archive.rb

@@ -1,14 +1,11 @@
 module NSWTopo
   class Archive
     extend Safely
+    include Enumerable
+    Invalid = Class.new RuntimeError
 
-    def initialize(path, tar_in)
-      @tar_in, @basename, @entries = tar_in, path.basename(".tgz").basename(".tar.gz").to_s, Hash[]
-    end
-    attr_reader :basename
-
-    def delete(filename)
-      @entries[filename] = nil
+    def initialize(tar)
+      @tar, @entries = tar, Hash[]
     end
 
     def write(filename, content)
@@ -17,15 +14,36 @@ module NSWTopo
       @entries[filename] = Gem::Package::TarReader::Entry.new header, io
     end
 
-    def mtime(filename)
-      header = @entries.key?(filename) ? @entries[filename]&.header : @tar_in.seek(filename, &:header)
-      Time.at header.mtime if header
+    def each(&block)
+      @tar.rewind
+      @tar.each do |entry|
+        yield entry unless @entries.key? entry.full_name
+      end
+      @entries.each do |filename, entry|
+        yield entry if entry
+      end
+    end
+
+    def delete(filename)
+      find do |entry|
+        entry.full_name == filename
+      end&.tap do
+        @entries[filename] = nil
+      end
     end
 
     def read(filename)
-      @entries.key?(filename) ? @entries[filename]&.read : @tar_in.seek(filename, &:read)
-    ensure
-      @entries[filename]&.rewind
+      find do |entry|
+        entry.full_name == filename
+      end&.read
+    end
+
+    def mtime(filename)
+      find do |entry|
+        entry.full_name == filename
+      end&.then do |entry|
+        Time.at entry.header.mtime
+      end
     end
 
     def uptodate?(depender, *dependees)
@@ -36,36 +54,25 @@ module NSWTopo
       end
     end
 
-    def each(&block)
-      @tar_in.each do |entry|
-        yield entry unless @entries.key? entry.full_name
-      end
-      @entries.each do |filename, entry|
-        yield entry if entry
-      end
-    end
-
     def changed?
-      return true if @entries.values.any?
-      @entries.keys.any? do |filename|
-        @tar_in.seek(filename, &:itself)
-      end
+      @entries.any?
     end
 
-    def self.open(out_path, in_path = nil, &block)
+    def self.open(out_path: nil, in_path: nil, &block)
       buffer, reader = StringIO.new, in_path ? Zlib::GzipReader : StringIO
 
       reader.open(*in_path) do |input|
-        if in_path
-          version = input.comment.to_s[/^nswtopo (.+)$/, 1]
-          raise "unrecognised map file: %s" % in_path unless version
-          comparison = version.split(?.).map(&:to_i) <=> MIN_VERSION.split(?.).map(&:to_i)
-          raise "map file too old: version %s, minimum %s required" % [version, MIN_VERSION] unless comparison >= 0
-        end
-        Gem::Package::TarReader.new(input) do |tar_in|
-          archive = new(out_path, tar_in).tap(&block)
-          Gem::Package::TarWriter.new(buffer) do |tar_out|
-            archive.each &tar_out.method(:add_entry)
+        begin
+          version = Version[input.comment]
+          raise "map file too old: created with nswtopo %s, minimum %s required" % [version, MIN_VERSION] unless version >= MIN_VERSION
+          raise "nswtopo too old: map file created with nswtopo %s, this version %s" % [version, VERSION] unless version <= VERSION
+        rescue Version::Error
+          raise "unrecognised map file: %s" % in_path
+        end if in_path && false != Config["versioning"]
+        Gem::Package::TarReader.new(input) do |tar|
+          archive = new(tar).tap(&block)
+          Gem::Package::TarWriter.new(buffer) do |tar|
+            archive.each &tar.method(:add_entry)
           end if archive.changed?
         end
       end
@@ -73,8 +80,8 @@ module NSWTopo
       Dir.mktmppath do |temp_dir|
         log_update "nswtopo: saving map..."
         temp_path = temp_dir / "temp.tgz"
-        Zlib::GzipWriter.open temp_path, Zlib::BEST_COMPRESSION do |gzip|
-          gzip.comment = "nswtopo %s" % VERSION
+        Zlib::GzipWriter.open temp_path, Config["zlib-level"] || Zlib::BEST_SPEED do |gzip|
+          gzip.comment = VERSION.creator_string
           gzip.write buffer.string
         rescue Interrupt
           log_update "nswtopo: interrupted, please wait..."
@@ -82,12 +89,14 @@ module NSWTopo
         end
         safely "saving map file, please wait..." do
           FileUtils.cp temp_path, out_path
+        rescue SystemCallError
+          raise "couldn't save #{out_path}"
         end
         log_success "map saved"
-      end unless buffer.size.zero?
+      end if out_path && buffer.size.nonzero?
 
     rescue Zlib::GzipFile::Error
-      raise "unrecognised map file: %s" % in_path
+      raise Invalid
     end
   end
 end

data/lib/nswtopo/chrome.rb

@@ -0,0 +1,227 @@
+module NSWTopo
+  class Chrome
+    MIN_VERSION = 112
+    TIMEOUT_KILL = 5
+    TIMEOUT_LOADEVENT = 30
+    TIMEOUT_COMMAND = 10
+    TIMEOUT_SCREENSHOT = 120
+
+    ARGS = %W[
+      --disable-background-networking
+      --disable-component-extensions-with-background-pages
+      --disable-component-update
+      --disable-default-apps
+      --disable-extensions
+      --disable-features=site-per-process,Translate
+      --disable-lcd-text
+      --disable-renderer-backgrounding
+      --force-color-profile=srgb
+      --force-device-scale-factor=1
+      --headless=new
+      --hide-scrollbars
+      --no-default-browser-check
+      --no-first-run
+      --no-startup-window
+      --remote-debugging-pipe=JSON
+      --use-mock-keychain
+    ]
+
+    class Error < RuntimeError
+      def initialize(message = "chrome error")
+        super
+      end
+    end
+
+    def self.mac?
+      /darwin/ === RbConfig::CONFIG["host_os"]
+    end
+
+    def self.windows?
+      /mingw|mswin|cygwin/ === RbConfig::CONFIG["host_os"]
+    end
+
+    def self.path
+      @path ||= case
+      when Config["chrome"]
+        [Config["chrome"]]
+      when mac?
+        ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome", "/Applications/Chromium.app/Contents/MacOS/Chromium"]
+      when windows?
+        ["C:/Program Files/Google/Chrome/Application/chrome.exe", "C:/Program Files (x86)/Google/Chrome/Application/chrome.exe"]
+      else
+        ENV["PATH"].split(File::PATH_SEPARATOR).product(%w[chrome google-chrome chromium chromium-browser]).map do |path, binary|
+          [path, binary].join(File::SEPARATOR)
+        end
+      end.find do |path|
+        File.executable?(path) && !File.directory?(path)
+      end.tap do |path|
+        raise Error, "couldn't find chrome" unless path
+        stdout, status = Open3.capture2 path, "--version"
+        raise Error, "couldn't start chrome" unless status.success?
+        version = /(?<major>\d+)(?:\.\d+)*/.match stdout
+        raise Error, "couldn't start chrome" unless version
+        raise Error, "chrome version #{MIN_VERSION} or higher required" if version[:major].to_i < MIN_VERSION
+      end
+    end
+
+    def self.rmdir(tmp)
+      Proc.new do
+        FileUtils.remove_entry tmp
+      rescue SystemCallError
+      end
+    end
+
+    def self.kill(pid, *pipes)
+      Proc.new do
+        if windows?
+          *, status = Open3.capture2e *%W[taskkill /f /t /pid #{pid}]
+          Process.kill "KILL", pid unless status.success?
+        else
+          Timeout.timeout(TIMEOUT_KILL, Error) do
+            Process.kill "-USR1", Process.getpgid(pid)
+            Process.wait pid
+          rescue Error
+            Process.kill "-KILL", Process.getpgid(pid)
+            Process.wait pid
+          end
+        end
+      rescue Errno::ESRCH, Errno::ECHILD
+      ensure
+        pipes.each(&:close)
+      end
+    end
+
+    def close
+      Chrome.kill(@pid, @input, @output).call
+      Chrome.rmdir(@data_dir).call
+      ObjectSpace.undefine_finalizer self
+    end
+
+    def self.with_browser(url, **opts, &block)
+      browser = new url, **opts
+      block.call browser
+    ensure
+      browser&.close
+    end
+
+    def initialize(url, width: 800, height: 600, background: { r: 0, g: 0, b: 0, a: 0 }, args: [])
+      @id, @data_dir = 0, Dir.mktmpdir("nswtopo_headless_chrome_")
+      ObjectSpace.define_finalizer self, Chrome.rmdir(@data_dir)
+
+      args << "--disable-gpu" if Config["gpu"] == false
+      args << "--user-data-dir=#{@data_dir}"
+
+      input, @input, @output, output = *IO.pipe, *IO.pipe
+      input.nonblock, output.nonblock = false, false
+      @input.sync = true
+
+      @pid = Process.spawn Chrome.path, *ARGS, *args, 1 => File::NULL, 2 => File::NULL, 3 => input, 4 => output, :pgroup => Chrome.windows? ? nil : true
+      ObjectSpace.define_finalizer self, Chrome.kill(@pid, @input, @output)
+      input.close; output.close
+
+      target_id = command("Target.createTarget", url: url).fetch("targetId")
+      @session_id = command("Target.attachToTarget", targetId: target_id, flatten: true).fetch("sessionId")
+      command "Page.enable"
+      wait "Page.loadEventFired", timeout: TIMEOUT_LOADEVENT
+      command "Emulation.setDeviceMetricsOverride", width: width, height: height, deviceScaleFactor: 1, mobile: false
+      command "Emulation.setDefaultBackgroundColorOverride", color: background
+      @node_id = command("DOM.getDocument").fetch("root").fetch("nodeId")
+    rescue SystemCallError
+      raise Error, "couldn't start chrome"
+    rescue KeyError
+      raise Error
+    end
+
+    def send(**message)
+      message.merge! sessionId: @session_id if @session_id
+      @input.write message.to_json, ?\0
+    end
+
+    def messages
+      Enumerator.produce do
+        json = @output.readline(?\0).chomp(?\0)
+        JSON.parse(json).tap do |message|
+          raise Error if message["error"]
+          raise Error if message["method"] == "Target.detachedFromTarget"
+        end
+      rescue JSON::ParserError, EOFError
+        raise Error
+      end
+    end
+
+    def wait(event, timeout: nil)
+      Timeout.timeout(timeout) do
+        messages.find do |message|
+          message["method"] == event
+        end
+      end
+    rescue Timeout::Error
+      raise Error
+    end
+
+    def command(method, timeout: TIMEOUT_COMMAND, **params)
+      send id: @id += 1, method: method, params: params
+      Timeout.timeout(timeout) do
+        messages.find do |message|
+          message["id"] == @id
+        end
+      end.fetch("result")
+    rescue Timeout::Error, KeyError
+      raise Error
+    end
+
+    def screenshot(png_path)
+      data = command("Page.captureScreenshot", timeout: TIMEOUT_SCREENSHOT).fetch("data")
+      png_path.binwrite Base64.decode64(data)
+    rescue KeyError
+      raise Error
+    end
+
+    def print_to_pdf(pdf_path)
+      data = command("Page.printToPDF", timeout: nil, preferCSSPageSize: true).fetch("data")
+      pdf_path.binwrite Base64.decode64(data)
+    rescue KeyError
+      raise Error
+    end
+
+    def query_selector_node_id(selector)
+      command("DOM.querySelector", selector: selector, nodeId: @node_id).fetch("nodeId")
+    rescue KeyError
+      raise Error
+    end
+
+    class Node
+      def initialize(browser, selector)
+        @browser, @node_id = browser, browser.query_selector_node_id(selector)
+      end
+
+      def [](name)
+        @browser.command("DOM.getAttributes", nodeId: @node_id).fetch("attributes").each_slice(2).to_h.fetch(name.to_s)
+      rescue KeyError
+        raise Error
+      end
+
+      def []=(name, value)
+        if value.nil?
+          @browser.command "DOM.removeAttribute", nodeId: @node_id, name: name
+        else
+          @browser.command "DOM.setAttributeValue", nodeId: @node_id, name: name, value: value
+        end
+      end
+
+      def value=(value)
+        @browser.command "DOM.setNodeValue", nodeId: @node_id + 1, value: value
+      end
+
+      def width
+        @browser.command("DOM.getBoxModel", nodeId: @node_id).fetch("model").fetch("content").each_slice(2).map(&:first).minmax.reverse.inject(&:-)
+      rescue KeyError
+        raise Error
+      end
+    end
+
+    def query_selector(selector)
+      Node.new self, selector
+    end
+  end
+end