Beyley / zBoxer

Boxer is a simple library that allows for easy cross-platform creation of message boxes / alerts / what have you.

zBoxer 🥊

Introduction

zBoxer is a fork of Boxer, a simple library that allows for easy cross-platform creation of message boxes / alerts / what have you.

Example

macOS:

Windows:

Linux:

Language

zBoxer is written in C, Obj-C and Zig.

Compiling zBoxer

zBoxer is set up to be built with Zig.

Just run zig build in the project root, can cross compile from/to all supported platforms, and no external deps are needed

Including zBoxer

build.zig:

const zboxer = b.dependency("zBoxer", .{
   .target = target,
   .optimize = optimize,
});
const zboxer_lib = zboxer.artifact("boxer");
exe.linkLibrary(zboxer_lib);
try exe.include_dirs.appendSlice(zboxer_lib.include_dirs.items);

build.zig.zon:

.{
   .name = "APPNAME",
   .version = "0.0.0",
   .dependencies = .{
      .zBoxer = .{
         .url = "https://github.com/Beyley/zBoxer/archive/LATEST_COMMIT_HASH_HERE.tar.gz",
      },
      .xcode_frameworks = .{
         .url = "https://github.com/hexops/xcode-frameworks-pkg/archive/d486474a6af7fafd89e8314e0bf7eca4709f811b.tar.gz",
         .hash = "1220293eae4bf67a7c27a18a8133621337cde91a97bc6859a9431b3b2d4217dfb5fb",
      },
   },
}

Then when it complains that the hash is wrong, add the corrosponding .hash = "HASHHERE", into the zBoxer dependency

Using Boxer

To create a message box using zBoxer, call the 'boxerShow' C method and provide a message, title, style, and buttons:

boxerShow("Simple message boxes are very easy to create.", "Simple Example", kBoxerDefaultStyle, kBoxerDefaultButtons);

Different styles / buttons may be specified, and the user's selection can be determined from the function's return value:

BoxerSelection sel = boxerShow("Make a choice:", "Decision", BoxerStyleWarning, BoxerButtonsYesNo);

Calls to 'show' are blocking - execution of your program will not continue until the user dismisses the message box.

Encoding

zBoxer accepts strings encoded in UTF-8