Add Division

.clang-tidy

@@ -1,6 +1,6 @@
 # taken from https://github.com/cpp-linter/cpp-linter-action/blob/main/demo/.clang-tidy
 ---
-Checks: "clang-diagnostic-*,clang-analyzer-*,bugprone-*,misc-*,performance-*,readability-*,portability-*,modernize-*,cppcoreguidelines-*,google-*,llvm-*,cert-*,-llvm-header-guard,-modernize-use-nullptr,-misc-include-cleaner,-cert-err33-c,-clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling,-cppcoreguidelines-macro-to-enum,-modernize-macro-to-enum,-readability-function-cognitive-complexity,-google-readability-function-size,-readability-function-size,-modernize-use-trailing-return-type,-llvm-else-after-return,readability-else-after-return,-readability-implicit-bool-conversion,-google-readability-todo,-portability-avoid-pragma-once,-cppcoreguidelines-macro-usage,-readability-use-concise-preprocessor-directives,-cppcoreguidelines-owning-memory,-cppcoreguidelines-pro-bounds-array-to-pointer-decay"
+Checks: "clang-diagnostic-*,clang-analyzer-*,bugprone-*,misc-*,performance-*,readability-*,portability-*,modernize-*,cppcoreguidelines-*,google-*,llvm-*,cert-*,-llvm-header-guard,-modernize-use-nullptr,-misc-include-cleaner,-cert-err33-c,-clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling,-cppcoreguidelines-macro-to-enum,-modernize-macro-to-enum,-readability-function-cognitive-complexity,-google-readability-function-size,-readability-function-size,-modernize-use-trailing-return-type,-llvm-else-after-return,readability-else-after-return,-readability-implicit-bool-conversion,-google-readability-todo,-portability-avoid-pragma-once,-cppcoreguidelines-macro-usage,-readability-use-concise-preprocessor-directives,-cppcoreguidelines-owning-memory,-cppcoreguidelines-pro-bounds-array-to-pointer-decay,-cppcoreguidelines-avoid-magic-numbers"
 WarningsAsErrors: ""
 HeaderFilterRegex: "src/.*"
 ExcludeHeaderFilterRegex: src/thirdparty/.*|subprojects/.*

.devcontainer/Dockerfile

@@ -0,0 +1,51 @@
+ARG UBUNTU_VARIANT=24.04
+ARG BUILD_PLATFORM
+
+FROM --platform=${BUILD_PLATFORM} ubuntu:${UBUNTU_VARIANT}
+
+LABEL devcontainer.metadata='[{ \
+    "remoteUser": "ubuntu", \
+    "features": {} \
+    }]'
+
+COPY ./post_run.sh ./install_clang.sh /tmp/
+
+# Prevent interactive prompts
+ENV DEBIAN_FRONTEND=noninteractive
+
+ENV CC_LD="mold"
+ENV LD="mold"
+ENV CXX_LD="mold"
+
+# Install common utilities, gcc 14 and clang, also prepare meson
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+    sudo \
+    bash-completion \
+    build-essential \
+    ca-certificates \
+    curl \
+    git \
+    less \
+    locales \
+    wget \
+    gcc-14 g++-14 \
+    python3-pip \
+    libgmp-dev \
+    ninja-build \
+    pkg-config \
+    mold \
+    && pip install meson --break-system-packages \
+    && chmod +x /tmp/install_clang.sh \
+    && /tmp/install_clang.sh \
+    && rm /tmp/install_clang.sh \
+    && rm -rf /var/lib/apt/lists/* 
+
+# setup post run script and directories
+RUN chmod +x /tmp/post_run.sh \
+    && mkdir -pv /runtime/ \
+    && chown ubuntu:ubuntu /runtime/ \
+    && chmod 755 /runtime/ 
+
+USER ubuntu
+WORKDIR /work

.devcontainer/amd64/devcontainer.json

@@ -0,0 +1,52 @@
+{
+    "name": "Ubuntu 24.04 Dev Amd64",
+    "build": {
+        "dockerfile": "../Dockerfile",
+        "args": {
+            "UBUNTU_VARIANT": "24.04",
+            "BUILD_PLATFORM": "linux/amd64"
+        }
+    },
+    "runArgs": [
+        "--platform=linux/amd64"
+    ],
+    "mounts": [
+        "source=${localWorkspaceFolder},target=/work,type=bind,consistency=cached"
+    ],
+    "postCreateCommand": "/tmp/post_run.sh",
+    "workspaceFolder": "/work",
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "xaver.clang-format",
+                "llvm-vs-code-extensions.vscode-clangd",
+                "mesonbuild.mesonbuild"
+            ],
+            "settings": {
+                "terminal.integrated.shell.linux": "/bin/bash",
+                "clangd.path": "/usr/bin/clangd",
+                "clangd.arguments": [
+                    "--all-scopes-completion",
+                    "--background-index",
+                    "--background-index-priority=background",
+                    "--clang-tidy",
+                    "--completion-style=bundled",
+                    "--function-arg-placeholders",
+                    "--enable-config",
+                    "-j",
+                    "3",
+                    "--malloc-trim",
+                    "--pretty",
+                    "--header-insertion=never",
+                    "--compile-commands-dir=/runtime/build_sym_link"
+                ],
+                "[c]": {
+                    "editor.defaultFormatter": "xaver.clang-format"
+                },
+                "[cpp]": {
+                    "editor.defaultFormatter": "xaver.clang-format"
+                }
+            }
+        }
+    }
+}

.devcontainer/arm64/devcontainer.json

@@ -0,0 +1,52 @@
+{
+    "name": "Ubuntu 24.04 Dev Arm64",
+    "build": {
+        "dockerfile": "../Dockerfile",
+        "args": {
+            "UBUNTU_VARIANT": "24.04",
+            "BUILD_PLATFORM": "linux/arm64/v8"
+        }
+    },
+    "runArgs": [
+        "--platform=linux/arm64/v8"
+    ],
+    "mounts": [
+        "source=${localWorkspaceFolder},target=/work,type=bind,consistency=cached"
+    ],
+    "postCreateCommand": "/tmp/post_run.sh",
+    "workspaceFolder": "/work",
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "xaver.clang-format",
+                "llvm-vs-code-extensions.vscode-clangd",
+                "mesonbuild.mesonbuild"
+            ],
+            "settings": {
+                "terminal.integrated.shell.linux": "/bin/bash",
+                "clangd.path": "/usr/bin/clangd",
+                "clangd.arguments": [
+                    "--all-scopes-completion",
+                    "--background-index",
+                    "--background-index-priority=background",
+                    "--clang-tidy",
+                    "--completion-style=bundled",
+                    "--function-arg-placeholders",
+                    "--enable-config",
+                    "-j",
+                    "3",
+                    "--malloc-trim",
+                    "--pretty",
+                    "--header-insertion=never",
+                    "--compile-commands-dir=/runtime/build_sym_link"
+                ],
+                "[c]": {
+                    "editor.defaultFormatter": "xaver.clang-format"
+                },
+                "[cpp]": {
+                    "editor.defaultFormatter": "xaver.clang-format"
+                }
+            }
+        }
+    }
+}

.devcontainer/install_clang.sh

@@ -0,0 +1,104 @@
+#!/usr/bin/env bash
+
+set -xe
+
+function register_clang_version {
+    local version="$1"
+    local priority="$2"
+
+    echo "registering clang v${version} with priority ${priority}"
+
+    update-alternatives \
+        --install /usr/bin/llvm-config llvm-config "/usr/bin/llvm-config-${version}" "${priority}" \
+        --slave /usr/bin/llvm-ar llvm-ar "/usr/bin/llvm-ar-${version}" \
+        --slave /usr/bin/llvm-as llvm-as "/usr/bin/llvm-as-${version}" \
+        --slave /usr/bin/llvm-bcanalyzer llvm-bcanalyzer "/usr/bin/llvm-bcanalyzer-${version}" \
+        --slave /usr/bin/llvm-cov llvm-cov "/usr/bin/llvm-cov-${version}" \
+        --slave /usr/bin/llvm-diff llvm-diff "/usr/bin/llvm-diff-${version}" \
+        --slave /usr/bin/llvm-dis llvm-dis "/usr/bin/llvm-dis-${version}" \
+        --slave /usr/bin/llvm-dwarfdump llvm-dwarfdump "/usr/bin/llvm-dwarfdump-${version}" \
+        --slave /usr/bin/llvm-extract llvm-extract "/usr/bin/llvm-extract-${version}" \
+        --slave /usr/bin/llvm-link llvm-link "/usr/bin/llvm-link-${version}" \
+        --slave /usr/bin/llvm-mc llvm-mc "/usr/bin/llvm-mc-${version}" \
+        --slave /usr/bin/llvm-mcmarkup llvm-mcmarkup "/usr/bin/llvm-mcmarkup-${version}" \
+        --slave /usr/bin/llvm-nm llvm-nm "/usr/bin/llvm-nm-${version}" \
+        --slave /usr/bin/llvm-objdump llvm-objdump "/usr/bin/llvm-objdump-${version}" \
+        --slave /usr/bin/llvm-ranlib llvm-ranlib "/usr/bin/llvm-ranlib-${version}" \
+        --slave /usr/bin/llvm-readobj llvm-readobj "/usr/bin/llvm-readobj-${version}" \
+        --slave /usr/bin/llvm-rtdyld llvm-rtdyld "/usr/bin/llvm-rtdyld-${version}" \
+        --slave /usr/bin/llvm-size llvm-size "/usr/bin/llvm-size-${version}" \
+        --slave /usr/bin/llvm-stress llvm-stress "/usr/bin/llvm-stress-${version}" \
+        --slave /usr/bin/llvm-symbolizer llvm-symbolizer "/usr/bin/llvm-symbolizer-${version}" \
+        --slave /usr/bin/llvm-tblgen llvm-tblgen "/usr/bin/llvm-tblgen-${version}"
+
+    update-alternatives \
+        --install /usr/bin/clang clang "/usr/bin/clang-${version}" "${priority}" \
+        --slave /usr/bin/clang++ clang++ "/usr/bin/clang++-${version}" \
+        --slave /usr/bin/asan_symbolize asan_symbolize "/usr/bin/asan_symbolize-${version}" \
+        --slave /usr/bin/c-index-test c-index-test "/usr/bin/c-index-test-${version}" \
+        --slave /usr/bin/clang-check clang-check "/usr/bin/clang-check-${version}" \
+        --slave /usr/bin/clang-cl clang-cl "/usr/bin/clang-cl-${version}" \
+        --slave /usr/bin/clang-cpp clang-cpp "/usr/bin/clang-cpp-${version}" \
+        --slave /usr/bin/clang-format clang-format "/usr/bin/clang-format-${version}" \
+        --slave /usr/bin/clang-format-diff clang-format-diff "/usr/bin/clang-format-diff-${version}" \
+        --slave /usr/bin/clang-include-fixer clang-include-fixer "/usr/bin/clang-include-fixer-${version}" \
+        --slave /usr/bin/clang-offload-bundler clang-offload-bundler "/usr/bin/clang-offload-bundler-${version}" \
+        --slave /usr/bin/clang-query clang-query "/usr/bin/clang-query-${version}" \
+        --slave /usr/bin/clang-rename clang-rename "/usr/bin/clang-rename-${version}" \
+        --slave /usr/bin/clang-reorder-fields clang-reorder-fields "/usr/bin/clang-reorder-fields-${version}" \
+        --slave /usr/bin/clang-tidy clang-tidy "/usr/bin/clang-tidy-${version}" \
+        --slave /usr/bin/lldb lldb "/usr/bin/lldb-${version}" \
+        --slave /usr/bin/lldb-server lldb-server "/usr/bin/lldb-server-${version}" \
+        --slave /usr/bin/lldb-dap lldb-dap "/usr/bin/lldb-dap-${version}" \
+        --slave /usr/bin/ld.lld ld.lld "/usr/bin/ld.lld-${version}"
+
+    update-alternatives \
+        --install /usr/bin/clangd clangd "/usr/bin/clangd-${version}" "${priority}"
+}
+
+function install_clang_via_apt() {
+    CLANG_VERSION="$1"
+
+    apt-get install -y --no-install-recommends \
+        "clang-$CLANG_VERSION" \
+        "clangd-$CLANG_VERSION" \
+        "clang-tidy-$CLANG_VERSION" \
+        "clang-format-$CLANG_VERSION" \
+        "clang-tools-$CLANG_VERSION" \
+        "lld-$CLANG_VERSION" \
+        "lldb-$CLANG_VERSION" \
+        "llvm-$CLANG_VERSION"
+
+    register_clang_version "$CLANG_VERSION" "$CLANG_VERSION"
+
+}
+
+function install_clang_via_llvm() {
+    CLANG_VERSION="$1"
+
+    apt-get install -y --no-install-recommends \
+        lsb-release \
+        wget \
+        software-properties-common \
+        gnupg
+
+    wget apt.llvm.org/llvm.sh -O "/tmp/llvm.sh"
+    chmod +x /tmp/llvm.sh
+
+    /tmp/llvm.sh "$CLANG_VERSION"
+    rm /tmp/llvm.sh
+
+    install_clang_via_apt "$CLANG_VERSION"
+
+}
+
+ARCH="$(uname -m)"
+
+if [ "$ARCH" = "riscv64" ]; then
+    install_clang_via_apt 20
+elif [ "$ARCH" = "x86_64" ] || [ "$ARCH" = "aarch64" ]; then
+    install_clang_via_llvm 21
+else
+    echo "invalid arch: '$ARCH'"
+    exit 2
+fi

.devcontainer/post_run.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+
+set -xe
+
+TARGET_DIR="/runtime/build_sym_link"
+
+if [ -e "$TARGET_DIR" ]; then
+    rm "$TARGET_DIR"
+fi
+
+ARCH="$(uname -m)"
+
+if [ "$ARCH" = "riscv64" ]; then
+    ln -s /work/build_riscv "$TARGET_DIR"
+elif [ "$ARCH" = "aarch64" ]; then
+    ln -s /work/build_arm64 "$TARGET_DIR"
+elif [ "$ARCH" = "x86_64" ]; then
+    ln -s /work/build "$TARGET_DIR"
+else
+    echo "invalid arch: '$ARCH'"
+    exit 2
+fi

.devcontainer/riscv64/devcontainer.json

@@ -0,0 +1,52 @@
+{
+    "name": "Ubuntu 24.04 Dev RiscV64",
+    "build": {
+        "dockerfile": "../Dockerfile",
+        "args": {
+            "UBUNTU_VARIANT": "24.04",
+            "BUILD_PLATFORM": "linux/riscv64"
+        }
+    },
+    "runArgs": [
+        "--platform=linux/riscv64"
+    ],
+    "mounts": [
+        "source=${localWorkspaceFolder},target=/work,type=bind,consistency=cached"
+    ],
+    "postCreateCommand": "/tmp/post_run.sh",
+    "workspaceFolder": "/work",
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "xaver.clang-format",
+                "llvm-vs-code-extensions.vscode-clangd",
+                "mesonbuild.mesonbuild"
+            ],
+            "settings": {
+                "terminal.integrated.shell.linux": "/bin/bash",
+                "clangd.path": "/usr/bin/clangd",
+                "clangd.arguments": [
+                    "--all-scopes-completion",
+                    "--background-index",
+                    "--background-index-priority=background",
+                    "--clang-tidy",
+                    "--completion-style=bundled",
+                    "--function-arg-placeholders",
+                    "--enable-config",
+                    "-j",
+                    "3",
+                    "--malloc-trim",
+                    "--pretty",
+                    "--header-insertion=never",
+                    "--compile-commands-dir=/runtime/build_sym_link"
+                ],
+                "[c]": {
+                    "editor.defaultFormatter": "xaver.clang-format"
+                },
+                "[cpp]": {
+                    "editor.defaultFormatter": "xaver.clang-format"
+                }
+            }
+        }
+    }
+}

.github/workflows/build.yml

@@ -31,6 +31,12 @@ jobs:
             use-clang: false
             arm: true
 
+          - name: Linux (Clang, ARM64)
+            os: ubuntu
+            os-version: 24.04-arm
+            use-clang: true
+            arm: true
+
           - name: Linux (GCC, x86_64)
             os: ubuntu
             os-version: 24.04

.github/workflows/lint.yml

@@ -53,7 +53,7 @@ jobs:
           step-summary: true
           file-annotations: true
           ignore: subprojects|build|test|*.cpp|*.hpp
-          extra-args: -std=c23
+          extra-args: -std=c23 -DBIGINT_C_LIB_INTERNAL_USAGE
 
       - uses: cpp-linter/cpp-linter-action@v2
         name: Lint C++ Files