0.4.1

Added

• New Buffer class to read memory fast (#125 by @Hywan)

  To get the memory buffer, use the Memory.buffer getter. A Buffer implements the Python Buffer Protocol. The goal is to get faster reading operations than the existing memory views API.

  bytearray(instance.memory.buffer) is 15x faster than instance.memory.int8_view().
  memoryview(instance.memory.buffer) is 14x faster than instance.memory.int8_view().

  # Get the memory buffer.
  buffer = Instance(wasm_bytes).memory.buffer
  
  # Use the buffer with `memoryview`
  memory_view = memoryview(buffer)
  
  # Use the buffer with `byte_array`
  byte_array = bytearray(buffer)
  
  # Enjoy the byte array API!
  assert byte_array[3:9].decode() == 'Wasmer'

• Support exported globals through the Instance.globals API (#120 by @Hywan)

  instance = Instance(wasm_bytes)
  x = instance.globals.x
  
  assert x.value == 7
  assert x.mutable == True
  
  x.value = 153
  
  assert x.value == 153

• Implement a WebAssembly custom section query API (#118 by @Hywan)

  Module.custom_section_names is used to list all the custom section names.

  Module.custom_section is used to read the value of a specific custom section. If the custom section does not exist, None is returned.

  assert Module(wasm_bytes).custom_section('hello') == b'World!'

• Add the Module.imports getter to list all imports, and introduce the ImportKind enum (#117 by @Hywan)

  assert Module(wasm_bytes).imports == [
      {
          'kind': ImportKind.FUNCTION,
          'namespace': 'ns',
          'name': 'f1',
      },
      {
          'kind': ImportKind.FUNCTION,
          'namespace': 'ns',
          'name': 'f2',
      },
      {
          'kind': ImportKind.MEMORY,
          'namespace': 'ns',
          'name': 'm1',
          # Additional pairs specific to `MEMORY`
          'minimum_pages': 3,
          'maximum_pages': 4,
      },
      {
          'kind': ImportKind.GLOBAL,
          'namespace': 'ns',
          'name': 'g1',
          # Additional pairs specific to `GLOBAL`
          'mutable': False,
          'type': 'f32'
      },
      {
          'kind': ImportKind.TABLE,
          'namespace': 'ns',
          'name': 't1',
          # Additional pairs specific to `TABLE`
          'minimum_elements': 1,
          'maximum_elements': 2,
          'element_type': 'anyfunc',
      }
  ]

• Add the Module.exports getter to list all exports, and introduce the ExportKind enum (#115 and #116 by @Hywan)

  assert Module(wasm_bytes).exports == [
      {
          'name': 'memory',
          'kind': ExportKind.MEMORY,
      },
      {
          'name': '__heap_base',
          'kind': ExportKind.GLOBAL,
      },
      {
          'name': '__data_end',
          'kind': ExportKind.GLOBAL,
      },
      {
          'name': 'sum',
          'kind': ExportKind.FUNCTION,
      },
  ]

• Support modules without an exported memory (#114 by @Hywan)

  instance = Instance(wasm_bytes)
  
  # Now the `memory` getter can return `None`
  assert instance.memory == None

• Add Rust trait to allow inspection of exported functions (#71 by @Mec-iS)

  instance = Instance(wasm_bytes)
  assert isinstance(instance.exports.sum.getfullargspec, str)
  assert isinstance(instance.exports.sum.getargs, str)

• Memory views support slice assignment (#63 by @Hywan).

  memory = instance.memory.uint8_view()
  memory[0:4] = b"abcd"

  The slice is bound to the memory view length. The slice accepts start, stop, and step parameters, so it is possible to write view[0:5:2] for instance. There is a huge difference with list slice assignment in Python: Elements in memory cannot be moved, so the assignment only overwrite elements.

  // With regular Python list
  a = [1, 2, 3, 4, 5]
  a[1:3] = [10, 11, 12]
  
  assert a == [1, 10, 11, 12, 4, 5]
  
  // With WebAssembly memory views
  view[0:5] = [1, 2, 3, 4, 5]
  view[1:3] = [10, 11, 12]
  
  assert view[0:5] == [1, 10, 11, 4, 5]

  It is 10 times faster than a regular loop to write data in memory.

  Read the pull request to learn more.

• Make wasmer silently available anywhere with wasmer-any (#62 by @syrusakbary)

Changed

• Improve documentation of Memory (#127 by @Hywan)
• Add a C to WebAssembly example in the documentation (#122 by @Hywan)
• Explain new features (#119 by @Hywan)
• Migrate to Github Actions for the CI (#97, #98 #99 and #101 by @Hywan)
• Update Wasmer from 0.6.0 to 0.14 (#70, #80, #88, #95, #113 and #132 by @Hywan)
• Update Pyo3 from 0.8.2 to 0.8.4 (#93, #96)

Security

• Bump spin from 0.5.0 to 0.5.2 (#72]