mirror of
https://github.com/luau-lang/luau.git
synced 2024-12-13 21:40:43 +00:00
3f1508c83a
- Improve error recovery during type checking - Initial (not fully complete) implementation for singleton types (RFC RFC: Singleton types #37) - Implement a C-friendly interface for compiler (luacode.h) - Remove C++ features from lua.h (removed default arguments from luau_load and lua_pushcfunction) - Fix lua_breakpoint behavior when enabled=false - Implement coroutine.close (RFC RFC: coroutine.close #88) Note, this introduces small breaking changes in lua.h: - luau_load env argument is now required, pass an extra 0 - lua_pushcfunction now must be called with 3 arguments; if you were calling it with 2 arguments, pass an extra NULL; if you were calling it with 4, use lua_pushcclosure. These changes are necessary to make sure lua.h can be used from pure C - the future release will make it possible by adding an option to luaconf.h to change function name mangling to be C-compatible. We don't anticipate breaking the FFI interface in the future, but this change was necessary to restore C compatibility. Closes #121 Fixes #213
68 lines
2.4 KiB
C++
68 lines
2.4 KiB
C++
// This file is part of the Luau programming language and is licensed under MIT License; see LICENSE.txt for details
|
|
#pragma once
|
|
|
|
#include "Luau/ParseOptions.h"
|
|
#include "Luau/Location.h"
|
|
#include "Luau/StringUtils.h"
|
|
#include "Luau/Common.h"
|
|
|
|
namespace Luau
|
|
{
|
|
class AstStatBlock;
|
|
class AstNameTable;
|
|
class BytecodeBuilder;
|
|
class BytecodeEncoder;
|
|
|
|
// Note: this structure is duplicated in luacode.h, don't forget to change these in sync!
|
|
struct CompileOptions
|
|
{
|
|
// 0 - no optimization
|
|
// 1 - baseline optimization level that doesn't prevent debuggability
|
|
// 2 - includes optimizations that harm debuggability such as inlining
|
|
int optimizationLevel = 1;
|
|
|
|
// 0 - no debugging support
|
|
// 1 - line info & function names only; sufficient for backtraces
|
|
// 2 - full debug info with local & upvalue names; necessary for debugger
|
|
int debugLevel = 1;
|
|
|
|
// 0 - no code coverage support
|
|
// 1 - statement coverage
|
|
// 2 - statement and expression coverage (verbose)
|
|
int coverageLevel = 0;
|
|
|
|
// global builtin to construct vectors; disabled by default
|
|
const char* vectorLib = nullptr;
|
|
const char* vectorCtor = nullptr;
|
|
|
|
// null-terminated array of globals that are mutable; disables the import optimization for fields accessed through these
|
|
const char** mutableGlobals = nullptr;
|
|
};
|
|
|
|
class CompileError : public std::exception
|
|
{
|
|
public:
|
|
CompileError(const Location& location, const std::string& message);
|
|
|
|
virtual ~CompileError() throw();
|
|
|
|
virtual const char* what() const throw();
|
|
|
|
const Location& getLocation() const;
|
|
|
|
static LUAU_NORETURN void raise(const Location& location, const char* format, ...) LUAU_PRINTF_ATTR(2, 3);
|
|
|
|
private:
|
|
Location location;
|
|
std::string message;
|
|
};
|
|
|
|
// compiles bytecode into bytecode builder using either a pre-parsed AST or parsing it from source; throws on errors
|
|
void compileOrThrow(BytecodeBuilder& bytecode, AstStatBlock* root, const AstNameTable& names, const CompileOptions& options = {});
|
|
void compileOrThrow(BytecodeBuilder& bytecode, const std::string& source, const CompileOptions& options = {}, const ParseOptions& parseOptions = {});
|
|
|
|
// compiles bytecode into a bytecode blob, that either contains the valid bytecode or an encoded error that luau_load can decode
|
|
std::string compile(
|
|
const std::string& source, const CompileOptions& options = {}, const ParseOptions& parseOptions = {}, BytecodeEncoder* encoder = nullptr);
|
|
|
|
} // namespace Luau
|