Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .swift-version
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
6.2-snapshot-2025-06-14
24 changes: 24 additions & 0 deletions Package.resolved

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

27 changes: 19 additions & 8 deletions Package.swift
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
// swift-tools-version: 6.1
// swift-tools-version: 6.2
// The swift-tools-version declares the minimum version of Swift required to build this package.

import PackageDescription

let package = Package(
name: "ExternalTermFormat",
platforms: [.macOS(.v15)],
products: [
// Products define the executables and libraries a package produces, making them visible to other packages.
.library(
Expand All @@ -13,23 +14,33 @@ let package = Package(
"ExternalTermFormat"
]),
],
traits: ["Embedded"],
dependencies: [
.package(url: "https://github.com/apple/swift-binary-parsing.git", branch: "main")
],
targets: [
// Targets are the basic building blocks of a package, defining a module or a test suite.
// Targets can depend on other targets in this package and products from dependencies.
.target(
name: "ExternalTermFormat",
cSettings: [
.unsafeFlags(["-fdeclspec"], .when(traits: ["Embedded"]))
],
dependencies: [.product(name: "BinaryParsing", package: "swift-binary-parsing")],
swiftSettings: [
.enableExperimentalFeature("Embedded", .when(traits: ["Embedded"])),
.unsafeFlags(["-Xfrontend", "-emit-empty-object-file"], .when(traits: ["Embedded"]))
.enableExperimentalFeature("Span"),
.enableExperimentalFeature("ValueGenerics"),
.enableExperimentalFeature("LifetimeDependence"),
]
),
.executableTarget(
name: "ExternalTermFormatBenchmarks",
dependencies: ["ExternalTermFormat"]
),
.testTarget(
name: "ExternalTermFormatTests",
dependencies: ["ExternalTermFormat"]
dependencies: [.target(name: "ExternalTermFormat")],
swiftSettings: [
.enableExperimentalFeature("Span"),
.enableExperimentalFeature("ValueGenerics"),
.enableExperimentalFeature("LifetimeDependence"),
]
),
]
)
20 changes: 18 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,23 @@
# External Term Format

> [!NOTE]
> This package requires Swift 6.2+ for its `Span` type.
> When running on macOS on an OS older than 26.0, make sure to set the `DYLD_LIBRARY_PATH`:
> ```
> swiftly run swift build
> DYLD_LIBRARY_PATH="/Library/Developer/Toolchains/swift-6.2-DEVELOPMENT-SNAPSHOT-2025-06-14-a.xctoolchain/usr/lib/swift/macosx" \
> .build/arm64-apple-macosx/debug/ExternalTermFormatBenchmarks
> ```

Encoding/decoding for Erlang's [External Term Format](https://www.erlang.org/doc/apps/erts/erl_ext_dist.html).
Compatible with Embedded Swift.

The entire package is built on the `Term` enum, which reflects all possible encoded values in Erlang's external term format.


Use `TermBuffer` to encode/decode raw bytes.
```
let greeting = Term.atom("Hello, world!")
greeting.encoded() // [131, ]

This package is fully compatible with Embedded Swift runtimes.
let decoded = Term(parsing: [131, ])
```
173 changes: 0 additions & 173 deletions Sources/ExternalTermFormat/ExternalTermFormat.swift

This file was deleted.

18 changes: 0 additions & 18 deletions Sources/ExternalTermFormat/PID.swift

This file was deleted.

Loading