logtalk/logtalk3-swi repository overview

This file is part of Logtalk https://logtalk.org/⁠
SPDX-FileCopyrightText: 2017-2024 Paulo Moura [email protected]⁠
SPDX-FileCopyrightText: 2017 Sergio Castro [email protected]⁠
SPDX-License-Identifier: Apache-2.0

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.

⁠Logtalk Docker configuration for SWI-Prolog

For development, this Docker image is superseded by the portable Docker image, which can be built to include only the SWI-Prolog backend. The portable Docker image provides a more comprehensive Logtalk installation (including full support for developer tools) and a better user experience.

⁠Build arguments

• LOGTALK_VERSION
  The Logtalk version to be built.

Valid identifiers are as shown in the Logtalk GitHub repository at release names⁠. Defaults to master, which causes the Docker image to be built with the latest version of Logtalk in its master branch.

⁠Volumes

• /source
  The work directory where Logtalk is started. The code base can be mounted here.

• /logtalkuser_prefix
  To customize its installation, the user can mount in this volume the parent directory in its host system where the custom Logtalk user directory is located. If no Logtalk user directory exists, it will be created the first time and will be persisted and used in the following executions of the Logtalk container.

⁠Building a Logtalk image

⁠Nightly build

docker build -t="logtalk/logtalk3-swi:nightly" .

⁠Last stable release

docker build --build-arg LOGTALK_VERSION=lgt3091stable -t="logtalk/logtalk3-swi:3091" -t="logtalk/logtalk3-swi:latest" .

Update the lgt3091stable and 3091 strings for the current version number.

⁠Running a Logtalk container

⁠From the nightly build (providing a top-level interpreter)

docker run -it --name logtalk_nightly "logtalk/logtalk3-swi:nightly"

⁠From the last stable release (providing a top-level interpreter)

docker run -it --name logtalk_latest "logtalk/logtalk3-swi:latest"

⁠From the last stable release (adding a ~/project directory as a volume)

docker run -it --name logtalk_latest -v $(HOME)/project:/source "logtalk/logtalk3-swi:latest"