{"id":20207747,"url":"https://github.com/exasol/script-languages-container-tool","last_synced_at":"2026-01-29T07:21:36.721Z","repository":{"id":36961291,"uuid":"359838599","full_name":"exasol/script-languages-container-tool","owner":"exasol","description":"The script-languages-container-tool is responsible for building script-language container for extending Exasol UDFs","archived":false,"fork":false,"pushed_at":"2024-08-13T15:46:37.000Z","size":752,"stargazers_count":1,"open_issues_count":24,"forks_count":3,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-08-21T18:38:14.256Z","etag":null,"topics":["exasol","exasol-integration","language-container","script-languages","udf"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/exasol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-20T14:08:58.000Z","updated_at":"2024-08-26T17:36:37.717Z","dependencies_parsed_at":"2024-05-20T10:28:11.158Z","dependency_job_id":"644f1932-61a3-4877-ba80-697419942366","html_url":"https://github.com/exasol/script-languages-container-tool","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exasol%2Fscript-languages-container-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exasol%2Fscript-languages-container-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exasol%2Fscript-languages-container-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exasol%2Fscript-languages-container-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/exasol","download_url":"https://codeload.github.com/exasol/script-languages-container-tool/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248217160,"owners_count":21066634,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["exasol","exasol-integration","language-container","script-languages","udf"],"created_at":"2024-11-14T05:31:53.567Z","updated_at":"2026-01-29T07:21:31.692Z","avatar_url":"https://github.com/exasol.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Script-Languages-Container-Tool\n\n## Overview\n\nThe Script-Languages-Container-Tool (exaslct) is the build tool for the script language container.\nYou can build, export and upload script-language container from so-called flavors\nwhich are description how to build the script language container. You can find pre-defined flavors\nin the [script-languages-release](https://github.com/exasol/script-languages-release) repository.\nThere we also described how you could customize these flavors to your needs.\n\u003ch1 align=\"center\"\u003eExasol Script Languages Container Tool\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\nBuilding script-language container for extending Exasol UDFs.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\n\u003ca href=\"https://github.com/exasol/script-languages-container-tool/actions/workflows/ci.yml\"\u003e\n    \u003cimg src=\"https://github.com/exasol/script-languages-container-tool/actions/workflows/main.yml/badge.svg?branch=main\" alt=\"Checks Main\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\n    \u003cimg src=\"https://img.shields.io/pypi/l/exasol-script-languages-container-tool\" alt=\"License\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://pypi.org/project/exasol-script-languages-container-tool/\"\u003e\n    \u003cimg src=\"https://img.shields.io/pypi/dm/exasol-script-languages-container-tool\" alt=\"Downloads\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://pypi.org/project/exasol-script-languages-container-tool/\"\u003e\n    \u003cimg src=\"https://img.shields.io/pypi/pyversions/exasol-script-languages-container-tool\" alt=\"Supported Python Versions\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://pypi.org/project/exasol-script-languages-container-tool/\"\u003e\n    \u003cimg src=\"https://img.shields.io/pypi/v/exasol-script-languages-container-tool\" alt=\"PyPi Package\"\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n\n## In a Nutshell\n\n### Prerequisites\n\n**Note**: Since version 1.0.0 the \"starter scripts\" shipped with previous version, which pulled the `exaslct` docker container runtime, were removed. If you can't use Python3, you still can use our [AI-lab](https://github.com/exasol/ai-lab) which provides VM images, AMI images and a Docker images, all capable of building script-language-container.\n\n#### For installation\n\nIn order to install this tool, your system needs to provide\nthe following prerequisites:\n\n* Software\n    See [Dependencies](doc/dependencies.md)\n\n\n#### For running\n\nIn order to use this tool, your system needs to fulfill the following prerequisites:\n\n* Software\n    * Linux\n      * Python3 \u003e= 3.10\n    * [Docker](https://docs.docker.com/) \u003e= 17.05\n      * with support for [multi-stage builds required](https://docs.docker.com/develop/develop-images/multistage-build/)\n      * host volume mounts need to be allowed\n\n* System Setup\n    * We recommend at least 50 GB free disk space on the partition\n      where Docker stores its images, on linux Docker typically stores\n      the images at /var/lib/docker.\n    * For the partition where the output directory (default: ./.build_output)\n      is located we recommend additionally at least 10 GB free disk space.\n\nFurther, prerequisites might be necessary for specific tasks. These are listed under the corresponding section.\n\n### Installation\n\nIn general, it's good practice to install the package in a virtual environment, using `venv` or `Poetry`.\n\n#### Pip via PyPi\n\n```commandline\npython3 -m pip install exasol-script-languages-container-tool\n```\n\n#### Pipx via Pypi\n\nIf you plan to use `exasol-script-languages-container-tool` on the command line only via the `exaslct` script, we suggest the installation via `pipx`:\n\n```commandline\npipx install exasol-script-languages-container-tool\n```\n\n\n### Usage\n\nFor simplicity the following examples use the script version (`exaslct`), which will be installed together with the Python package. The script is just an alias for `python3 -m exasol.slc.tool.main`.\n\n#### How to build an existing flavor?\n\nCreate the language container and export it to the local file system\n\n```bash\nexaslct export --flavor-path=flavors/\u003cflavor-name\u003e --export-path \u003cexport-path\u003e\n```\n\nor deploy it directly to the BucketFS (both http and https are supported)\n\n```bash\nexaslct deploy --flavor-path=flavors/\u003cflavor-name\u003e --bucketfs-host \u003chostname-or-ip\u003e --bucketfs-port \u003cport\u003e \\\n                   --bucketfs-user w --bucketfs-password \u003cpassword\u003e  --bucketfs-name \u003cbucketfs-name\u003e \\\n                   --bucket \u003cbucket-name\u003e --path-in-bucket \u003cpath/in/bucket\u003e --bucketfs-use-https 1\n```\n\nOnce it is successfully deployed, it will print the ALTER SESSION statement\nthat can be used to activate the script language container in the database.\n\n#### How to activate a script language container in the database\n\nIf you uploaded a container manually, you can generate the language activation statement with\n\n```bash\nexaslct generate-language-activation --flavor-path=flavors/\u003cflavor-name\u003e --bucketfs-name \u003cbucketfs-name\u003e \\\n                                         --bucket-name \u003cbucket-name\u003e --path-in-bucket \u003cpath/in/bucket\u003e --container-name \u003ccontainer-name\u003e\n```\n\nwhere \\\u003ccontainer-name\u003e is the name of the uploaded archive without its file extension. To activate the language, execute the generated statement in your database session to activate the container for the current session or system wide.\n\nThis command will print a SQL statement to activate the language similar to the following one:\n\n```bash\nALTER SESSION SET SCRIPT_LANGUAGES='\u003cLANGUAGE_ALIAS\u003e=localzmq+protobuf:///\u003cbucketfs-name\u003e/\u003cbucket-name\u003e/\u003cpath-in-bucket\u003e/\u003ccontainer-name\u003e?lang=\u003clanguage\u003e#buckets/\u003cbucketfs-name\u003e/\u003cbucket-name\u003e/\u003cpath-in-bucket\u003e/\u003ccontainer-name\u003e/exaudf/exaudfclient[_py3]';\n```\n\n**Please, refer to the [User Guide](doc/user_guide/user_guide.md) for more detailed information, how to use exalsct.**\n\n## Features\n\n* Build a script language container as docker images\n* Export a script language container as an archive which can be used for extending Exasol UDFs\n* Upload a script language container as an archive to the Exasol DB's BucketFS\n* Generating the activation command for a script language container\n* Can use Docker registries, such as Docker Hub, as a cache to avoid rebuilding image without changes\n* Can push Docker images to Docker registries\n* Run tests for you container against an Exasol DB (docker-db or external db)\n\n## Table of Contents\n\n### Information for Users\n\n* [User Guide](doc/user_guide/user_guide.md)\n* [Changelog](doc/changes/changelog.md)\n\n## Information for Developers\n\n* [Developer Guide](doc/developer_guide/developer_guide.md)\n* [Dependencies](doc/dependencies.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexasol%2Fscript-languages-container-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexasol%2Fscript-languages-container-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexasol%2Fscript-languages-container-tool/lists"}