swift-primitives/swift-ascii-serializer-primitives

Quick Start

The serializers turn an integer into its ASCII digit codes directly — no String allocation and no intermediate base-10 string. Every standard-library integer is made Serializable, so asciiCodes and a buffer-appending append(contentsOf:) are available out of the box.

import ASCII_Serializer_Primitives

// Write an integer's decimal digits straight into an ASCII-code buffer.
var buffer: [ASCII.Code] = []
buffer.append(contentsOf: 8080)        // [0x38, 0x30, 0x38, 0x30]   "8080"
buffer.append(contentsOf: -7)          // appends 0x2D, 0x37          "-7"

// `asciiCodes` is the canonical ASCII form of any Serializable integer.
let codes: [ASCII.Code] = 255.asciiCodes   // [0x32, 0x35, 0x35]      "255"

Reach for a serializer directly when you want to choose the radix:

import ASCII_Serializer_Primitives

let hex = ASCII.Hexadecimal.Serializer<UInt32>()
var out: [ASCII.Code] = []
hex.serialize(0xDEAD, into: &out)      // [0x64, 0x65, 0x61, 0x64]   "dead"

let decimal = ASCII.Decimal.Serializer<Int16>()
out.removeAll(keepingCapacity: true)
decimal.serialize(-32_768, into: &out) // serializes the magnitude with a leading '-'

0 serializes to the single digit '0'; negative signed values are prefixed with '-' and their magnitude is written, matching Swift's String(_:radix:) convention. Both serializers report Failure == Never, so serialization cannot fail.

Installation

dependencies: [
    .package(url: "https://github.com/swift-primitives/swift-ascii-serializer-primitives.git", branch: "main")
]

.target(
    name: "App",
    dependencies: [
        .product(name: "ASCII Serializer Primitives", package: "swift-ascii-serializer-primitives"),
    ]
)

Requires Swift 6.3.1 and macOS 26 / iOS 26 / tvOS 26 / watchOS 26 / visionOS 26 (or the matching Linux / Windows toolchain).

Architecture

Eight library products (an umbrella, six subject-domain libraries, and a test-support target), composed over the ASCII.Code, Serializer, and Binary primitives. Import the umbrella ASCII Serializer Primitives for the whole surface, or a single sub-product to keep the dependency narrow. There is no deprecated or compatibility product in this catalogue — every product below is current.

| Product | Target | Purpose | |---------|--------|---------| | ASCII Serializer Primitives | Sources/ASCII Serializer Primitives/ | Umbrella that re-exports every sub-target below. | | ASCII Decimal Serializer Primitives | Sources/ASCII Decimal Serializer Primitives/ | ASCII.Decimal.Serializer<T> — writes the decimal ASCII digits of a FixedWidthInteger. | | ASCII Hexadecimal Serializer Primitives | Sources/ASCII Hexadecimal Serializer Primitives/ | ASCII.Hexadecimal.Serializer<T> — writes the lowercase hexadecimal ASCII digits of a FixedWidthInteger. | | ASCII Binary Serializer Primitives | Sources/ASCII Binary Serializer Primitives/ | Writes the base-2 ASCII digits of a FixedWidthInteger. | | ASCII Octal Serializer Primitives | Sources/ASCII Octal Serializer Primitives/ | Writes the base-8 ASCII digits of a FixedWidthInteger. | | Serializable ASCII Primitives | Sources/Serializable ASCII Primitives/ | The asciiCodes accessor on any Serializable whose buffer is [ASCII.Code]. | | Serializable Integer Primitives | Sources/Serializable Integer Primitives/ | Serializable conformances for the standard-library integers, plus RangeReplaceableCollection.append(contentsOf:) for integers into an [ASCII.Code] buffer. | | ASCII Serializer Primitives Test Support | Tests/Support/ | Re-exports the umbrella for test consumers. |

Foundation-free.

Platform Support

| Platform | Status | |----------|--------| | macOS 26 | Full support | | Linux | Full support | | Windows | Full support | | iOS / tvOS / watchOS / visionOS | Supported |

Community

License

Apache 2.0. See LICENSE.md.

Package Metadata

Repository: swift-primitives/swift-ascii-serializer-primitives

Default branch: main

README: README.md