fix: unignore build scripts in .gitignore

Author: jayeshmepani

.gitignore

@@ -8,7 +8,11 @@ __pycache__/
 
 # Distribution / packaging
 .Python
-build/
+build/*
+!build/*.sh
+!build/*.ps1
+!build/*.py
+!build/*.php
 develop-eggs/
 dist/
 downloads/

build/compile-linux.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -e
+DIR="$(cd "$(dirname "$0")" && pwd)"
+ROOT_DIR="$(dirname "$DIR")"
+
+ARCH=$(uname -m)
+if [ "$ARCH" = "x86_64" ] || [ "$ARCH" = "amd64" ]; then
+    TARGET="linux-x64"
+else
+    TARGET="linux-arm64"
+fi
+
+echo "Building for $TARGET"
+cd "$DIR"
+if [ ! -d "libpostal" ]; then
+    git clone https://github.com/openvenues/libpostal.git
+fi
+cd libpostal
+./bootstrap.sh
+./configure --disable-data-download
+make -j4
+
+mkdir -p "$ROOT_DIR/postalkit/libs/$TARGET"
+cp src/.libs/libpostal.so "$ROOT_DIR/postalkit/libs/$TARGET/"
+echo "Success: Compiled to $ROOT_DIR/postalkit/libs/$TARGET/libpostal.so"

build/compile-macos.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -e
+DIR="$(cd "$(dirname "$0")" && pwd)"
+ROOT_DIR="$(dirname "$DIR")"
+
+ARCH=$(uname -m)
+if [ "$ARCH" = "x86_64" ] || [ "$ARCH" = "amd64" ]; then
+    TARGET="macos-x64"
+else
+    TARGET="macos-arm64"
+fi
+
+echo "Building for $TARGET"
+cd "$DIR"
+if [ ! -d "libpostal" ]; then
+    git clone https://github.com/openvenues/libpostal.git
+fi
+cd libpostal
+./bootstrap.sh
+./configure --disable-data-download
+make -j4
+
+mkdir -p "$ROOT_DIR/postalkit/libs/$TARGET"
+cp src/.libs/libpostal.dylib "$ROOT_DIR/postalkit/libs/$TARGET/"
+echo "Success: Compiled to $ROOT_DIR/postalkit/libs/$TARGET/libpostal.dylib"

build/compile-windows.ps1

@@ -0,0 +1,22 @@
+$ErrorActionPreference = "Stop"
+$DIR = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ROOT_DIR = Split-Path -Parent $DIR
+$TARGET = "windows-x64"
+
+Write-Host "Building for $TARGET"
+Set-Location $DIR
+if (-not (Test-Path "libpostal")) {
+    git clone https://github.com/openvenues/libpostal.git
+}
+Set-Location "libpostal"
+Copy-Item -Recurse -Force windows\* .\
+bash ./bootstrap.sh
+bash ./configure --disable-data-download
+make -j4
+
+$TARGET_DIR = "$ROOT_DIR\postalkit\libs\$TARGET"
+if (-not (Test-Path $TARGET_DIR)) {
+    New-Item -ItemType Directory -Force -Path $TARGET_DIR
+}
+Copy-Item src\.libs\libpostal-1.dll "$TARGET_DIR\postal.dll" -Force
+Write-Host "Success: Compiled to $TARGET_DIR\postal.dll"

build/compile.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -e
+DIR="$(cd "$(dirname "$0")" && pwd)"
+OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+
+if [[ "$OS" == *"linux"* ]]; then
+    bash "$DIR/compile-linux.sh"
+elif [[ "$OS" == *"darwin"* ]]; then
+    bash "$DIR/compile-macos.sh"
+else
+    echo "Unsupported OS. Use compile-windows.ps1 for Windows."
+    exit 1
+fi

build/fetch-prebuilt.php

@@ -0,0 +1,50 @@
+#!/usr/bin/env php
+<?php
+
+$postalkitVersion = "v0.1.0";
+$repoUrl = "https://github.com/jayeshmepani/libpostal-ffi-python/releases/download/{$postalkitVersion}";
+
+$targets = [
+    'linux-x64' => 'libpostal-linux-x64.tar.gz',
+    'linux-arm64' => 'libpostal-linux-arm64.tar.gz',
+    'macos-x64' => 'libpostal-macos-x64.tar.gz',
+    'macos-arm64' => 'libpostal-macos-arm64.tar.gz',
+    'windows-x64' => 'libpostal-windows-x64.zip',
+];
+
+$libsDir = dirname(__DIR__) . '/postalkit/libs';
+
+foreach ($targets as $target => $filename) {
+    $targetDir = "{$libsDir}/{$target}";
+    if (!is_dir($targetDir)) {
+        mkdir($targetDir, 0777, true);
+    }
+
+    $url = "{$repoUrl}/{$filename}";
+    $dest = "{$targetDir}/{$filename}";
+
+    echo "Downloading {$url}...\n";
+    $content = file_get_contents($url);
+    if ($content === false) {
+        echo "Failed to download {$url}. Skipping.\n";
+        continue;
+    }
+
+    file_put_contents($dest, $content);
+
+    echo "Extracting {$dest}...\n";
+    if (str_ends_with($filename, '.zip')) {
+        $zip = new ZipArchive;
+        if ($zip->open($dest) === TRUE) {
+            $zip->extractTo($targetDir);
+            $zip->close();
+        } else {
+            echo "Failed to extract zip.\n";
+        }
+    } else {
+        exec("tar -xzf " . escapeshellarg($dest) . " -C " . escapeshellarg($targetDir));
+    }
+
+    unlink($dest);
+    echo "Successfully setup {$target}\n";
+}

build/fetch-prebuilt.py

@@ -0,0 +1,48 @@
+import urllib.request
+import tarfile
+import zipfile
+import os
+import sys
+from pathlib import Path
+
+POSTALKIT_VERSION = "v0.1.0"
+REPO_URL = f"https://github.com/jayeshmepani/libpostal-ffi-python/releases/download/{POSTALKIT_VERSION}"
+
+TARGETS = {
+    'linux-x64': 'libpostal-linux-x64.tar.gz',
+    'linux-arm64': 'libpostal-linux-arm64.tar.gz',
+    'macos-x64': 'libpostal-macos-x64.tar.gz',
+    'macos-arm64': 'libpostal-macos-arm64.tar.gz',
+    'windows-x64': 'libpostal-windows-x64.zip',
+}
+
+def fetch_prebuilt():
+    libs_dir = Path(__file__).parent.parent / "postalkit" / "libs"
+    
+    for target, filename in TARGETS.items():
+        target_dir = libs_dir / target
+        target_dir.mkdir(parents=True, exist_ok=True)
+        
+        url = f"{REPO_URL}/{filename}"
+        dest = target_dir / filename
+        
+        print(f"Downloading {url}...")
+        try:
+            urllib.request.urlretrieve(url, dest)
+        except Exception as e:
+            print(f"Failed to download {url}: {e}")
+            continue
+            
+        print(f"Extracting {dest}...")
+        if filename.endswith('.zip'):
+            with zipfile.ZipFile(dest, 'r') as zip_ref:
+                zip_ref.extractall(target_dir)
+        else:
+            with tarfile.open(dest, "r:gz") as tar:
+                tar.extractall(path=target_dir)
+                
+        os.remove(dest)
+        print(f"Successfully setup {target}")
+
+if __name__ == "__main__":
+    fetch_prebuilt()