The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
SPVM-0.9699
River stage two • 23 direct dependents • 26 total dependents
31 ++
/ SPVM

Name

SPVM - SPVM Language

Caution

SPVM is not yet 1.0 release. It is quite often changed without warnings until I feel that the implementation is good enough.

Usage

Creating SPVM Module:

  # lib/SPVM/MyMath.spvm
  class MyMath {
    static method sum : int ($nums : int[]) {

      my $total = 0;
      for (my $i = 0; $i < @$nums; $i++) {
        $total += $nums->[$i];
      }

      return $total;
    }
  }

Calling SPVM methods from Perl:

  # sum.pl
  use strict;
  use warnings;
  use FindBin;
  use lib "$FindBin::Bin/lib";

  use SPVM 'MyMath';

  # Call method
  my $total = SPVM::MyMath->sum([3, 6, 8, 9]);

  print "$total\n";

Description

SPVM (Static Perl Virtual Machine) is a perl-ish static typed programing language. SPVM provides fast calculation, fast array operations, easy C/C++ binding, and creating executable files.

Loading Module

If you load SVPM module from Perl, use the following syntax.

  use SPVM 'Foo';

Suppose the following SPVM/Foo.spvm is placed on a module search path.

  # SPVM/Foo.spvm
  class Foo {
    static method sum : int ($x1 : int, $x2 : int) {
      return $x1 + $x2;
    }
  }

If you load SPVM Foo::Bar module, do the following.

  use SPVM 'Foo::Bar';

Suppose the following SPVM/Foo/Bar.spvm is placed on a module search path.

  # SPVM/Foo/Bar.spvm
  class Foo::Bar {
    static method sum : int ($x1 : int, $x2 : int) {
      return $x1 + $x2;
    }
  }

use SPVM MODULE_NAME compile the SPVM module and the dependent modules.

Note that at this point a SPVM runtime has not yet been created.

A default SPVM runtime is created the first time you call a method of SPVM module or call a function or method of the Exchange API.

Class Method Call

Let's call SPVM class method from Perl.

  use SPVM 'Foo';

  my $total = SPVM::Foo->sum(1, 2);

The definition of Foo module is the following.

  # SPVM/Foo.spvm
  class Foo {
    static method sum : int ($x1 : int, $x2 : int) {
      return $x1 + $x2;
    }
  }

If the number of arguments does not match the number of arguments of the SPVM method, an exception occurs.

The Perl values of the arguments are converted to the SPVM values by the rule of argument convertion.

If the type is non-conforming, an exception occurs.

The SPVM return value is converted to a Perl return value by the rule of return value convertion.

The SPVM exception is converted to a Perl exception.

Instance Method Call

Let's call SPVM instance method from Perl.

  use SPVM 'Foo';

  my $foo = SPVM::Foo->new;

  my $total = $foo->sum(1, 2);

The definition of Foo module is the following.

  # SPVM/Foo.spvm
  class Foo {
    static method new : Foo () {
      return new Foo;
    }

    method sum : int ($x1 : int, $x2 : int) (
      return $x1 + $x2;
    }
  }

Exchange API

Exchange API is APIs to convert Perl data structures to/from SPVM data structures and to call SPVM methods from Perl.

api

  my $api = SPVM::api();

Gets the global SPVM::ExchangeAPI object.

Document

SPVM documents.

Tutorial

SPVM Tutorial.

Language Specification

SPVM Language Specification.

Standard Modules

SPVM Standard Modules.

Exchange APIs

SPVM Exchange APIs is functions to convert between Perl data structures and SPVM data structures.

Native Module

The native module is the module that is implemented by native language such as the C language or C++.

Native APIs

SPVM native APIs are public APIs that are used in native language sources such as the C language or C++.

Resource

A resource is a native module that contains a set of sources and headers of native language such as the C language or C++.

Creating Executable File

spvmcc is the compiler and linker to create the executable file from SPVM source codes.

Creating SPVM Distribution

spvmdist is the command to create SPVM distribution.

Benchmark

SPVM performance benchmarks.

Environment Variables

SPVM_BUILD_DIR

SPVM building directory to build precompile and native methods. If the SPVM_BUILD_DIR environment variable is not set, the building of precompile and native methods fails.

bash:

  export SPVM_BUILD_DIR=~/.spvm_build

csh:

  setenv SPVM_BUILD_DIR ~/.spvm_build

SPVM_CC_DEBUG

Print debug messages of SPVM::Builder::CC to stderr.

SPVM_CC_FORCE

Force the compilation and the link of SPVM::Builder::CC.

Repository

Github

Bug Report

GitHub Issue

Support

Github Discussions

Author

Yuki Kimoto <kimoto.yuki@gmail.com>

Core Developers

moti<motohiko.ave@gmail.com>

Contributors

Copyright & License

Copyright (c) 2023 Yuki Kimoto

MIT License