You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Sami Vaarala db8ef89112 ditz issue update 11 years ago
api-testcases add specific negative return api test 11 years ago
bugs ditz issue update 11 years ago
doc rename test-builtin-xxx.js -> test-bi-xxx.js refs 11 years ago
ecmascript-testcases test case for built-in constructability (not comprehensive) 11 years ago
examples provide an explicit 'this' binding when calling program code in duk_cmdline, otherwise 'this' binding is incorrect when global code is strict 11 years ago
licenses murmurhash2 license 12 years ago
misc add c overflow misc test 11 years ago
references Ecmascript E5 and E5.1 specifications as references (license allows redistribution) 12 years ago
runtests knownbug marker on failure lines 11 years ago
src fixes for built-in constructability 11 years ago
website rename duk_builtin_xxx -> duk_bi_xxx in website example 11 years ago
.gitignore add stripped files to ignore too 12 years ago
LICENSE.txt add a basic README and LICENSE 12 years ago
Makefile makefile tweaks: add valgrind wrapped runs for several test sets, .PHONY target cleanup, other trivia 11 years ago
README.md add underscoretest to README.md 11 years ago
README.txt.dist remove full dist README, update source dist README 11 years ago
RELEASES.txt release note update 11 years ago
combine_src.py make combining sources deterministic so that combined sources diff better 11 years ago
make_dist.sh rename duk_builtin_xxx -> duk_bi_xxx in make and dist script 11 years ago
underscore-test-shim.js some underscore shim improvements 11 years ago
underscore_test add valgrind support to underscore_test 11 years ago

README.md

Duktape

Introduction

Duktape is an embeddable Javascript engine, with a focus on portability and compact footprint.

Duktape is easy to integrate into a C/C++ project: add duktape.c and duktape.h to your build, and use the Duktape API to call Ecmascript functions from C code and vice versa.

Main features:

  • Embeddable, portable, compact
  • Ecmascript E5/E5.1 compliant
  • Built-in regular expression engine
  • Built-in Unicode support
  • Minimal platform dependencies
  • Combined reference counting and mark-and-sweep garbage collection with finalization
  • Liberal license

See duktape.org for packaged end-user downloads and documentation.

Have fun!

About this repository

This repository is intended for Duktape developers only, and contains Duktape internals: test cases, internal documentation, sources for the duktape.org web site, etc.

Getting started: end user

When embedding Duktape in your application you should use the packaged source distributables available from duktape.org/download.html.

However, if you really want to use a bleeding edge version:

$ git clone https://github.com/svaarala/duktape.git
$ cd duktape
$ make dist-src

Then use duktape-<version>.tar.xz like a normal source distributable.

Getting started: developing Duktape

If you intend to change Duktape internals, run test cases, etc:

# Install NodeJS and npm
$ sudo apt-get install nodejs npm

# Compile the command line tool ('duk')
$ git clone https://github.com/svaarala/duktape.git
$ cd duktape
$ make

# Run Ecmascript and API testcases
$ make test
$ make apitest
$ make regfuzztest
$ make underscoretest

Note: the repo Makefile is intended for Linux developer use, it is not a multi-platform "end user" Makefile. In particular, the Makefile is not intended to work on e.g. OSX or Windows. The source distributable has more user-friendly Makefile examples, but you should normally simply write your own Makefile when integrating Duktape into your program.

License

See LICENSE.txt.