mirror of
https://github.com/jerryscript-project/jerryscript.git
synced 2025-12-15 16:29:21 +00:00
fdbbd0e8af
This commit changes the concept of JerryScript port implementations
from a simple directory of C source files (which get injected among
the sources of `jerry-core`) into a proper static library (which
may be linked to an application together with `jerry-core`). As a
consequence, this commit introduces a new library to the
JerryScript component architecture: the sources of the default port
implementation form `jerry-port-default`.
Changes in more detail:
- The sources in `targets/default` are moved to `jerry-port/default`
and are turned into a proper static library.
- Actually, the default port implementation has two library
variants, one that implements the bare minimum only
(`jerry-port-default-minimal`) and one that has some extra
functionalities specific to this implementation (the "full"
`jerry-port-default`).
- The new libraries have an interface header in
`jerry-port/default/include`, which extends the common
`jerryscript-port.h` API with functions specific to these
libraries.
- All non-standard port functions have now the
`jerry_port_default_` prefix (this affects `jobqueue_init` and
`jobqueue_run`).
- The jobqueue implementation functions became config macro
independent: it is now the responsibility of the linker to pick
the needed objects from the library, and omit those (e.g.,
jobqueue-related code) that are not referenced.
- Build of the libraries can be controlled with the new
`JERRY_PORT_DEFAULT` cmake option.
- The cmake option `PORT_DIR` is dropped, and `PORT_DIR/*.c` is not
appended to `jerry-core` sources.
- Instead, the `jerry` tool of `jerry-main` links to
`jerry-port-default`, while `jerry-minimal` links to
`jerry-port-default-minimal`.
- `tests/unit-core` tests are also linked to
`jerry-port-default-minimal`.
- Tools adapted.
- `build.py` has `--jerry-port-default` instead of `--port-dir`.
- `check-*.sh` have paths updated (`jerry-port/default` instead
of `targets/default`).
- Miscellaneous.
- Dropped `#ifndef`s from `jerryscript-port.h`. It is a public
header of the `jerry-core` library, which means that it must
not contain configuration-dependent parts (once the library is
built with some config macros and the archive and the headers
are installed, there is no way for the header to tell what
those config macrose were).
- Added documentation comments to the JobQueue Port API (in
`jerryscript-port.h`) and to several default port
implementation functions (in `jerry-port/default`).
JerryScript-DCO-1.0-Signed-off-by: Akos Kiss akiss@inf.u-szeged.hu
98 lines
2.7 KiB
C
98 lines
2.7 KiB
C
/* Copyright JS Foundation and other contributors, http://js.foundation
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#include <stdarg.h>
|
|
|
|
#include "jerryscript-port.h"
|
|
#include "jerryscript-port-default.h"
|
|
|
|
#ifndef DISABLE_EXTRA_API
|
|
|
|
/**
|
|
* Actual log level
|
|
*/
|
|
static jerry_log_level_t jerry_port_default_log_level = JERRY_LOG_LEVEL_ERROR;
|
|
|
|
#define JERRY_PORT_DEFAULT_LOG_LEVEL jerry_port_default_log_level
|
|
|
|
/**
|
|
* Get the log level
|
|
*
|
|
* @return current log level
|
|
*
|
|
* Note:
|
|
* This function is only available if the port implementation library is
|
|
* compiled without the DISABLE_EXTRA_API macro.
|
|
*/
|
|
jerry_log_level_t
|
|
jerry_port_default_get_log_level (void)
|
|
{
|
|
return jerry_port_default_log_level;
|
|
} /* jerry_port_default_get_log_level */
|
|
|
|
/**
|
|
* Set the log level
|
|
*
|
|
* Note:
|
|
* This function is only available if the port implementation library is
|
|
* compiled without the DISABLE_EXTRA_API macro.
|
|
*/
|
|
void
|
|
jerry_port_default_set_log_level (jerry_log_level_t level) /**< log level */
|
|
{
|
|
jerry_port_default_log_level = level;
|
|
} /* jerry_port_default_set_log_level */
|
|
|
|
#else /* DISABLE_EXTRA_API */
|
|
#define JERRY_PORT_DEFAULT_LOG_LEVEL JERRY_LOG_LEVEL_ERROR
|
|
#endif /* !DISABLE_EXTRA_API */
|
|
|
|
/**
|
|
* Provide console message implementation for the engine.
|
|
*/
|
|
void
|
|
jerry_port_console (const char *format, /**< format string */
|
|
...) /**< parameters */
|
|
{
|
|
va_list args;
|
|
va_start (args, format);
|
|
vfprintf (stdout, format, args);
|
|
va_end (args);
|
|
} /* jerry_port_console */
|
|
|
|
/**
|
|
* Default implementation of jerry_port_log. Prints log message to standard
|
|
* error with 'vfprintf' if message level is less than or equal to the set log
|
|
* level.
|
|
*
|
|
* Note:
|
|
* Changing the log level from JERRY_LOG_LEVEL_ERROR is only possible if
|
|
* the port implementation library is compiled without the
|
|
* DISABLE_EXTRA_API macro.
|
|
*/
|
|
void
|
|
jerry_port_log (jerry_log_level_t level, /**< log level */
|
|
const char *format, /**< format string */
|
|
...) /**< parameters */
|
|
{
|
|
if (level <= JERRY_PORT_DEFAULT_LOG_LEVEL)
|
|
{
|
|
va_list args;
|
|
va_start (args, format);
|
|
vfprintf (stderr, format, args);
|
|
va_end (args);
|
|
}
|
|
} /* jerry_port_log */
|