Perfect Sessions (core library) 简体中文

The Perfect Session core library, resurrected for Swift 6.2 / macOS 12 — a from-scratch rewrite of the original API surface targeting the modern Swift toolchain and strict concurrency. This package consolidates what used to be separate Perfect-Session-MySQL/-PostgreSQL/-Redis/-SQLite repos into one package with four backend products; those repos are superseded by this one. Perfect-Session-CouchDB and Perfect-Session-MongoDB are not superseded — CouchDB and MongoDB support was deliberately not carried forward into this rewrite (see below).

Status: core, in-use package with four fully implemented, tested storage backends (MySQL/PostgreSQL/Redis/SQLite) — pick whichever matches your existing infrastructure.

Compatibility with Swift

Package.swift declares swift-tools-version: 6.2 and platforms: [.macOS(.v12)]. The default branch is main. All 10 targets (5 libraries + 5 test targets) build under .swiftLanguageMode(.v6) — full Swift 6 strict-concurrency mode, repo-wide, not opt-in per file. SessionDriver is a fully async/await protocol (create/resume/save/destroy/clean/setup are all async, resume also throws) and is itself Sendable; PerfectSession and MemorySessionDriver are @unchecked Sendable with doc-comments justifying the escape hatch (JSON-safe [String: Any] payload, NSLock-protected mutable dictionary). No iOS/tvOS/watchOS/Linux platforms are declared — this is macOS-only today.

Building

Add it to your Package.swift:

dependencies: [
    .package(url: "https://github.com/PerfectlySoft/Perfect-Session.git", branch: "main"),
],
targets: [
    .target(
        name: "YourTarget",
        dependencies: [
            .product(name: "PerfectSessionCore", package: "Perfect-Session"),
            // plus whichever backend driver(s) you need, e.g.:
            .product(name: "PerfectSessionMySQL", package: "Perfect-Session"),
        ]
    )
]

PerfectSessionCore has no external database dependency — it provides the SessionDriver protocol, the PerfectSession request-handling filter, SessionConfig, an in-process MemorySessionDriver fallback, AuthFilter, and CSRFSecurity.

Database-Specific Drivers

Unlike the original upstream project, the database-specific drivers are not separate repositories — they are first-class targets/products built directly into this same package, in Sources/:

• PerfectSessionMySQL — depends on PerfectMySQL (../Perfect-MySQL). This is the driver currently configured and exercised in Perfect-Lasso's development/validation testing (scrubsSite, via LASSO_SESSION_DRIVER=mysql).
• PerfectSessionPostgreSQL — depends on PerfectPostgreSQL (../Perfect-PostgreSQL). Fully implemented and tested; not currently the selected driver.
• PerfectSessionRedis — depends on PerfectRedis (../Perfect-Redis) and swift-log. Fully implemented and tested; not currently the selected driver.
• PerfectSessionSQLite — depends on PerfectSQLite (../Perfect-SQLite) and swift-log. Fully implemented and tested; not currently the selected driver.

Each driver has its own matching test target (PerfectSessionMySQLTests, etc.) alongside PerfectSessionCoreTests. Simply depend on the product for the backend you want (see Building above) — there is no need to add anything beyond this package.

CouchDB and MongoDB drivers from the original PerfectlySoft project were not carried over into this resurrection and do not exist anywhere in this repo.

Further Information

The pre-Swift-6 version of this package is preserved on the legacy branch. Its backend driver dependencies (Perfect-MySQL, Perfect-PostgreSQL, Perfect-Redis, Perfect-SQLite) are real url: dependencies resolved by SwiftPM automatically — no sibling checkout needed.