Added experimental Perl 6 support
Hauke D
7 years ago
parent
5d8fe5b39a
commit
4e1e17b292
@ -0,0 +1,134 @@
|
|||||||
|
|
||||||
|
\[ [Using](using.html) -
|
||||||
|
[Building](building.html) -
|
||||||
|
🦋 -
|
||||||
|
[Notes](notes.html) -
|
||||||
|
[Legal](legal.html) -
|
||||||
|
[Wiki](https://github.com/haukex/webperl/wiki/Perl6) \]
|
||||||
|
|
||||||
|
WebPerl Experimental Perl 6 Support 🦋
|
||||||
|
=====================================
|
||||||
|
|
||||||
|
|
||||||
|
Thanks to [**Paweł Murias**](https://github.com/pmurias) and his
|
||||||
|
amazing work on **`Rakudo.js`** and
|
||||||
|
[**6Pad**](https://perl6.github.io/6pad/), I've been able to patch
|
||||||
|
support for Perl 6 into WebPerl!
|
||||||
|
|
||||||
|
Currently **requires Google Chrome** (due to BigInt support), see the
|
||||||
|
[Quick Start](#quick-start) below on how to get this up and running on
|
||||||
|
your local machine!
|
||||||
|
|
||||||
|
```html
|
||||||
|
<script src="webperl.js"></script>
|
||||||
|
<script type="text/perl6">
|
||||||
|
|
||||||
|
print "Hello, Perl 6 World!\n"; # goes to JavaScript console by default
|
||||||
|
|
||||||
|
my $document = EVAL(:lang<JavaScript>, 'return document');
|
||||||
|
my $window = EVAL(:lang<JavaScript>, 'return window');
|
||||||
|
$document.getElementById('my_button')
|
||||||
|
.addEventListener("click", -> $event {
|
||||||
|
$window.alert("You clicked the button!");
|
||||||
|
} );
|
||||||
|
</script>
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
Quick Start
|
||||||
|
-----------
|
||||||
|
|
||||||
|
In a console (the following assumes Linux):
|
||||||
|
|
||||||
|
$ git clone https://github.com/haukex/webperl.git
|
||||||
|
$ cd webperl
|
||||||
|
$ wget https://github.com/haukex/webperl/releases/download/v0.07-beta/webperl_prebuilt_v0.07-beta.zip
|
||||||
|
$ unzip -j webperl_prebuilt_v0.07-beta.zip '*/emperl.*' -d web
|
||||||
|
$ cpanm --installdeps .
|
||||||
|
$ cd experiments ; cpanm --installdeps . ; cd ..
|
||||||
|
$ experiments/p6/6init.pl # this patches Perl 6 support in
|
||||||
|
$ plackup web/webperl.psgi
|
||||||
|
|
||||||
|
Then point your Chrome browser at <http://localhost:5000/6demo.html>,
|
||||||
|
and have a look at its source.
|
||||||
|
|
||||||
|
Have fun!
|
||||||
|
|
||||||
|
|
||||||
|
Experimental Status and Notes
|
||||||
|
-----------------------------
|
||||||
|
|
||||||
|
- I don't have enough experience with `Rakudo.js`
|
||||||
|
- <https://github.com/rakudo/rakudo/tree/master/src/vm/js>
|
||||||
|
- <https://perl6.github.io/6pad/>
|
||||||
|
- <http://blogs.perl.org/users/pawel_murias/>
|
||||||
|
- <https://github.com/perl6/perl6-parcel-example>
|
||||||
|
- <https://www.youtube.com/watch?v=LN0mKjmraVs>
|
||||||
|
|
||||||
|
- requires BigInt support, which is currently only available in Chrome
|
||||||
|
- <https://developers.google.com/web/updates/2018/05/bigint>
|
||||||
|
- <https://github.com/tc39/proposal-bigint>
|
||||||
|
- <https://v8.dev/blog/bigint>
|
||||||
|
|
||||||
|
- Large download (10MB compressed, 74MB uncompressed) - can we
|
||||||
|
repackage it to make it smaller, or is there a good way to
|
||||||
|
distribute this?
|
||||||
|
|
||||||
|
- STDERR only goes to console, STDOUT gets output with HTML escapes
|
||||||
|
|
||||||
|
|
||||||
|
Documentation
|
||||||
|
-------------
|
||||||
|
|
||||||
|
My code steal^H^H^H^H^Hborrows the prepackaged `Rakudo.js` build from
|
||||||
|
[6Pad](https://perl6.github.io/6pad/) and caches it locally. The script
|
||||||
|
`experiments/p6/6init.pl` also patches the experimental P6 support into
|
||||||
|
`webperl.js` (see the [Quick Start](#quick-start) above).
|
||||||
|
|
||||||
|
Note that both Perl 5 and Perl 6 are only loaded on demand by
|
||||||
|
`webperl.js`, so if you only use one or the other, you won't have the
|
||||||
|
overhead of loading both.
|
||||||
|
|
||||||
|
For now, I've basically just patched `Rakudo.js`'s `evalP6()` into
|
||||||
|
`Raku.eval()`, and `NQP_STDOUT` into `Raku.output`, to make things more
|
||||||
|
like the Perl 5 WebPerl, and provided some of the same API for Perl 6
|
||||||
|
as I provide for Perl 5.
|
||||||
|
|
||||||
|
The JS API provided by WebPerl for Perl 6 currently closely mirrors
|
||||||
|
[the Perl 5 API](using.html#webperljs): There is a JS object `Raku`
|
||||||
|
which provides the following functions / properties that do mostly the
|
||||||
|
same as for Perl 5:
|
||||||
|
|
||||||
|
- `Raku.addStateChangeListener( function (from,to) {} )`
|
||||||
|
- `Raku.state`
|
||||||
|
- `Raku.output = function (str,chan) {}`
|
||||||
|
- `Raku.makeOutputTextarea()`
|
||||||
|
- `Raku.init( function () {} )`
|
||||||
|
- `Raku.eval( code )`
|
||||||
|
|
||||||
|
You can add Perl 6 code to your HTML pages with `<script>` tags
|
||||||
|
with `type="text/perl6"` or `type="text/raku"`.
|
||||||
|
|
||||||
|
For everything else, I defer to `Rakudo.js` for now! I will update this
|
||||||
|
documentation as things evolve.
|
||||||
|
|
||||||
|
|
||||||
|
***
|
||||||
|
|
||||||
|
Additional notes on WebPerl's experimental Perl 6 support may be found
|
||||||
|
in the [GitHub Wiki](https://github.com/haukex/webperl/wiki/Perl6).
|
||||||
|
|
||||||
|
***
|
||||||
|
|
||||||
|
Copyright (c) 2018 Hauke Daempfling (haukex@zero-g.net)
|
||||||
|
at the Leibniz Institute of Freshwater Ecology and Inland Fisheries (IGB),
|
||||||
|
Berlin, Germany, <http://www.igb-berlin.de>
|
||||||
|
|
||||||
|
Please see the ["Legal" page](legal.html) for details.
|
||||||
|
|
||||||
|
***
|
||||||
|
|
||||||
|
You can find the source for this page at
|
||||||
|
<https://github.com/haukex/webperl/blob/gh-pages/perl6.md>
|
||||||
|
|
||||||
|
|
||||||
Loading…
Reference in New Issue