fastqr 1.0.1

data/bindings/ruby/lib/fastqr.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+require_relative "fastqr/version"
+require_relative "fastqr/platform"
+
+# Load pre-built binary if available, otherwise try to load compiled extension
+begin
+  if FastQR::Platform.prebuilt_available?
+    # Load from pre-built binary
+    require 'ffi'
+
+    module FastQR
+      module Native
+        extend FFI::Library
+
+        lib_path = Platform.lib_path
+        ffi_lib lib_path
+
+        # Define C functions
+        attach_function :fastqr_generate_c, :fastqr_generate, [:string, :string, :pointer], :bool
+        attach_function :fastqr_version, [], :string
+      end
+    end
+  else
+    # Fall back to compiled extension
+    require_relative "fastqr/fastqr"
+  end
+rescue LoadError => e
+  warn "Warning: Could not load FastQR native extension: #{e.message}"
+  warn "Please run: gem install fastqr -- --with-system-libraries"
+end
+
+module FastQR
+  class Error < StandardError; end
+
+  # Generate QR code with options
+  #
+  # @param data [String] Data to encode (UTF-8 supported)
+  # @param output_path [String] Path to save the QR code image
+  # @param options [Hash] Generation options
+  # @option options [Integer] :size Size in pixels (default: 300, QR codes are square)
+  # @option options [Boolean] :optimize_size Auto round-up to nearest integer multiple for best performance (default: false)
+  # @option options [Array<Integer>] :foreground RGB color array [r, g, b] (default: [0, 0, 0])
+  # @option options [Array<Integer>] :background RGB color array [r, g, b] (default: [255, 255, 255])
+  # @option options [String] :error_level Error correction level: 'L', 'M', 'Q', 'H' (default: 'M')
+  # @option options [String] :logo Path to logo image
+  # @option options [Integer] :logo_size Logo size as percentage (default: 20)
+  # @option options [Integer] :quality Image quality 1-100 (default: 95)
+  # @option options [String] :format Output format: 'png', 'jpg', 'webp' (default: 'png')
+  # @return [Boolean] true if successful
+  #
+  # @example Basic usage
+  #   FastQR.generate("Hello World", "qr.png")
+  #
+  # @example With options
+  #   FastQR.generate("Hello", "qr.png",
+  #     size: 500,
+  #     foreground: [255, 0, 0],
+  #     background: [255, 255, 200],
+  #     error_level: 'H'
+  #   )
+  #
+  # @example With logo
+  #   FastQR.generate("Company", "qr.png",
+  #     size: 600,
+  #     logo: "logo.png",
+  #     logo_size: 25
+  #   )
+  def self.generate(data, output_path, options = {})
+    raise Error, "Data cannot be empty" if data.nil? || data.empty?
+    raise Error, "Output path cannot be empty" if output_path.nil? || output_path.empty?
+
+    result = super(data, output_path, options)
+    raise Error, "Failed to generate QR code" unless result
+
+    result
+  end
+
+  # Generate multiple QR codes in batch mode (7x faster!)
+  #
+  # @param data_array [Array<String>] Array of strings to encode
+  # @param output_dir [String] Directory to save QR codes (will be created if it doesn't exist)
+  # @param options [Hash] Generation options (same as generate)
+  # @return [Hash] Result with :success and :failed counts
+  #
+  # @example Batch generation
+  #   data = ["QR 1", "QR 2", "QR 3"]
+  #   FastQR.generate_batch(data, "output_dir/", size: 500)
+  #   # Creates: output_dir/1.png, output_dir/2.png, output_dir/3.png
+  def self.generate_batch(data_array, output_dir, options = {})
+    raise Error, "Data array cannot be empty" if data_array.nil? || data_array.empty?
+    raise Error, "Output directory cannot be empty" if output_dir.nil? || output_dir.empty?
+
+    # Create output directory
+    require 'fileutils'
+    FileUtils.mkdir_p(output_dir)
+
+    # Create a temporary batch file
+    require 'tempfile'
+    temp_file = Tempfile.new(['fastqr_batch', '.txt'])
+    begin
+      data_array.each { |line| temp_file.puts(line) }
+      temp_file.close
+
+      # Call CLI with batch mode
+      lib_dir = File.expand_path('../../../lib', __dir__)
+      cli_path = File.join(lib_dir, Platform.binary_name)
+
+      # Build command
+      cmd_parts = [cli_path, '-F', temp_file.path, output_dir]
+      cmd_parts += ['-s', options[:size].to_s] if options[:size]
+      cmd_parts += ['-o'] if options[:optimize_size]
+      cmd_parts += ['-f', options[:foreground].join(',')] if options[:foreground]
+      cmd_parts += ['-b', options[:background].join(',')] if options[:background]
+      cmd_parts += ['-e', options[:error_level]] if options[:error_level]
+      cmd_parts += ['-l', options[:logo]] if options[:logo]
+      cmd_parts += ['-p', options[:logo_size].to_s] if options[:logo_size]
+      cmd_parts += ['-q', options[:quality].to_s] if options[:quality]
+
+      result = system(*cmd_parts, out: File::NULL, err: File::NULL)
+      raise Error, "Batch generation failed" unless result
+
+      {success: data_array.size, failed: 0}
+    ensure
+      temp_file.unlink
+    end
+  end
+end
+

data/bindings/ruby/prebuilt/macos-arm64.tar.gz

@@ -0,0 +1 @@
+Not Found

data/bindings/ruby/prebuilt/macos-x86_64.tar.gz

@@ -0,0 +1 @@
+Not Found

data/build.sh

@@ -0,0 +1,109 @@
+#!/bin/bash
+
+# FastQR Quick Build Script
+# This script automates the build process for FastQR
+
+set -e
+
+echo "🚀 FastQR Build Script"
+echo "======================"
+echo ""
+
+# Detect OS
+OS="unknown"
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    OS="macos"
+    echo "📱 Detected: macOS"
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+    OS="linux"
+    echo "🐧 Detected: Linux"
+else
+    echo "❌ Unsupported OS: $OSTYPE"
+    exit 1
+fi
+
+# Check dependencies
+echo ""
+echo "🔍 Checking dependencies..."
+
+if ! command -v cmake &> /dev/null; then
+    echo "❌ cmake not found. Please install CMake 3.15+"
+    exit 1
+fi
+echo "✅ cmake found: $(cmake --version | head -n1)"
+
+if ! command -v pkg-config &> /dev/null; then
+    echo "❌ pkg-config not found"
+    exit 1
+fi
+echo "✅ pkg-config found"
+
+if ! pkg-config --exists libqrencode; then
+    echo "❌ libqrencode not found. Install with:"
+    if [[ "$OS" == "macos" ]]; then
+        echo "   brew install qrencode"
+    else
+        echo "   sudo apt-get install libqrencode-dev"
+    fi
+    exit 1
+fi
+echo "✅ libqrencode found: $(pkg-config --modversion libqrencode)"
+
+if ! pkg-config --exists vips; then
+    echo "❌ libvips not found. Install with:"
+    if [[ "$OS" == "macos" ]]; then
+        echo "   brew install vips"
+    else
+        echo "   sudo apt-get install libvips-dev"
+    fi
+    exit 1
+fi
+echo "✅ libvips found: $(pkg-config --modversion vips)"
+
+# Build
+echo ""
+echo "🔨 Building FastQR..."
+
+# Create build directory
+BUILD_DIR="build"
+if [ -d "$BUILD_DIR" ]; then
+    echo "📁 Cleaning old build directory..."
+    rm -rf "$BUILD_DIR"
+fi
+
+mkdir -p "$BUILD_DIR"
+cd "$BUILD_DIR"
+
+# Configure
+echo "⚙️  Configuring..."
+cmake .. \
+    -DCMAKE_BUILD_TYPE=Release \
+    -DCMAKE_INSTALL_PREFIX=/usr/local \
+    -DFASTQR_BUILD_EXAMPLES=ON
+
+# Build
+echo "🔧 Compiling..."
+if [[ "$OS" == "macos" ]]; then
+    NCPU=$(sysctl -n hw.ncpu)
+else
+    NCPU=$(nproc)
+fi
+
+make -j$NCPU
+
+# Test
+echo ""
+echo "🧪 Running tests..."
+make test
+
+echo ""
+echo "✅ Build completed successfully!"
+echo ""
+echo "📦 To install system-wide, run:"
+echo "   cd $BUILD_DIR && sudo make install"
+echo ""
+echo "🎯 To test the CLI:"
+echo "   ./fastqr \"Hello World\" test.png"
+echo ""
+echo "💡 See README.md for usage examples"
+

data/cmake/fastqrConfig.cmake.in

@@ -0,0 +1,6 @@
+@PACKAGE_INIT@
+
+include("${CMAKE_CURRENT_LIST_DIR}/fastqrTargets.cmake")
+
+check_required_components(fastqr)
+

data/composer.json

@@ -0,0 +1,36 @@
+{
+    "name": "fastqr/fastqr",
+    "description": "Fast QR code generator with UTF-8 support, custom colors, logo embedding, and precise size control",
+    "type": "library",
+    "keywords": ["qr", "qrcode", "qr-code", "generator", "utf8", "unicode", "vietnamese", "japanese", "fast"],
+    "homepage": "https://github.com/tranhuucanh/fastqr",
+    "license": "LGPL-2.1",
+    "authors": [
+        {
+            "name": "FastQR Project",
+            "email": "fastqr@example.com"
+        }
+    ],
+    "require": {
+        "php": ">=7.4",
+        "ext-ffi": "*"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^9.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "FastQR\\": "bindings/php/src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "FastQR\\Tests\\": "bindings/php/tests/"
+        }
+    },
+    "scripts": {
+        "test": "phpunit"
+    },
+    "minimum-stability": "stable"
+}
+