Decompose GitHub resources into products

Package.swift

@@ -15,7 +15,31 @@ let package = Package(
         .library(
             name: "GitHub",
             targets: ["GitHub"]
-        )
+        ),
+        .library(
+            name: "GitHub OAuth",
+            targets: ["GitHub OAuth"]
+        ),
+        .library(
+            name: "GitHub Organizations",
+            targets: ["GitHub Organizations"]
+        ),
+        .library(
+            name: "GitHub Repositories",
+            targets: ["GitHub Repositories"]
+        ),
+        .library(
+            name: "GitHub Stargazers",
+            targets: ["GitHub Stargazers"]
+        ),
+        .library(
+            name: "GitHub Traffic",
+            targets: ["GitHub Traffic"]
+        ),
+        .library(
+            name: "GitHub Users",
+            targets: ["GitHub Users"]
+        ),
     ],
     dependencies: [
         .package(
@@ -26,14 +50,45 @@ let package = Package(
             url: "https://github.com/swift-primitives/swift-either-primitives.git",
             branch: "main"
         ),
+        .package(
+            url: "https://github.com/swift-ietf/swift-rfc-3986.git",
+            branch: "main"
+        ),
         .package(
             url: "https://github.com/swift-standards/swift-github-standard.git",
             branch: "main"
-        )
+        ),
     ],
     targets: [
         .target(
             name: "GitHub",
+            dependencies: [
+                .target(name: "GitHub OAuth"),
+                .target(name: "GitHub Organizations"),
+                .target(name: "GitHub Repositories"),
+                .target(name: "GitHub Stargazers"),
+                .target(name: "GitHub Traffic"),
+                .target(name: "GitHub Users"),
+            ]
+        ),
+        .target(
+            name: "GitHub OAuth",
+            dependencies: [
+                .product(
+                    name: "GitHub Standard",
+                    package: "swift-github-standard"
+                )
+            ]
+        ),
+        .testTarget(
+            name: "GitHub OAuth Core Tests",
+            dependencies: [
+                .target(name: "GitHub OAuth"),
+                .product(name: "RFC 3986", package: "swift-rfc-3986"),
+            ]
+        ),
+        .target(
+            name: "GitHub Organizations",
             dependencies: [
                 .product(
                     name: "Async Lifecycle Primitives",
@@ -43,15 +98,83 @@ let package = Package(
                     name: "Either Primitives",
                     package: "swift-either-primitives"
                 ),
+                .product(
+                    name: "GitHub Standard",
+                    package: "swift-github-standard"
+                ),
+            ]
+        ),
+        .testTarget(
+            name: "GitHub Organizations Core Tests",
+            dependencies: [.target(name: "GitHub Organizations")]
+        ),
+        .target(
+            name: "GitHub Repositories",
+            dependencies: [
                 .product(
                     name: "GitHub Standard",
                     package: "swift-github-standard"
                 )
             ]
         ),
         .testTarget(
-            name: "GitHub Core Tests",
-            dependencies: ["GitHub"]
+            name: "GitHub Repositories Core Tests",
+            dependencies: [.target(name: "GitHub Repositories")]
+        ),
+        .target(
+            name: "GitHub Stargazers",
+            dependencies: [
+                .product(
+                    name: "Async Lifecycle Primitives",
+                    package: "swift-async-primitives"
+                ),
+                .product(
+                    name: "Either Primitives",
+                    package: "swift-either-primitives"
+                ),
+                .product(
+                    name: "GitHub Standard",
+                    package: "swift-github-standard"
+                ),
+            ]
+        ),
+        .testTarget(
+            name: "GitHub Stargazers Core Tests",
+            dependencies: [.target(name: "GitHub Stargazers")]
+        ),
+        .target(
+            name: "GitHub Traffic",
+            dependencies: [
+                .product(
+                    name: "GitHub Standard",
+                    package: "swift-github-standard"
+                )
+            ]
+        ),
+        .testTarget(
+            name: "GitHub Traffic Core Tests",
+            dependencies: [.target(name: "GitHub Traffic")]
+        ),
+        .target(
+            name: "GitHub Users",
+            dependencies: [
+                .product(
+                    name: "Async Lifecycle Primitives",
+                    package: "swift-async-primitives"
+                ),
+                .product(
+                    name: "Either Primitives",
+                    package: "swift-either-primitives"
+                ),
+                .product(
+                    name: "GitHub Standard",
+                    package: "swift-github-standard"
+                ),
+            ]
+        ),
+        .testTarget(
+            name: "GitHub Users Core Tests",
+            dependencies: [.target(name: "GitHub Users")]
         ),
     ],
     swiftLanguageModes: [.v6]

README.md

@@ -17,6 +17,12 @@ persistence, or application policy.
 | Product | Module | Purpose |
 | --- | --- | --- |
 | GitHub | `GitHub` | Typed one-call clients and bounded paginated traversals |
+| GitHub OAuth | `GitHub_OAuth` | Authorization and token exchange |
+| GitHub Organizations | `GitHub_Organizations` | Organization repository listing and bounded traversal |
+| GitHub Repositories | `GitHub_Repositories` | Repository lookup and content retrieval |
+| GitHub Stargazers | `GitHub_Stargazers` | Timestamped stargazer listing and bounded traversal |
+| GitHub Traffic | `GitHub_Traffic` | Repository views, clones, paths, and referrers |
+| GitHub Users | `GitHub_Users` | Authenticated-user profile, emails, and repository listing |
 
 ## Installation
 
@@ -38,6 +44,22 @@ dependencies: [
 )
 ```
 
+Each resource is also its own product, so a consumer that only needs one
+resource can depend on it directly instead of the `GitHub` umbrella:
+
+```swift
+.target(
+    name: "YourTarget",
+    dependencies: [
+        .product(name: "GitHub Traffic", package: "swift-github")
+    ]
+)
+```
+
+The six per-resource products are `GitHub OAuth`, `GitHub Organizations`,
+`GitHub Repositories`, `GitHub Stargazers`, `GitHub Traffic`, and
+`GitHub Users` — see Products above.
+
 ## Usage
 
 Clients are generic over their typed failure:
@@ -83,8 +105,10 @@ in
 Aggregating views, clones, paths, and referrers into an application snapshot is
 application policy and is intentionally outside this package.
 
-No deprecated `GitHub Traffic`, `GitHub Stargazers`, or
-`GitHub Repositories` compatibility products are provided.
+`GitHub Traffic`, `GitHub Stargazers`, and `GitHub Repositories` are
+first-class per-resource products (see Products above) that a consumer can
+depend on directly. They are not deprecated compatibility shims for the
+`GitHub` umbrella.
 
 ## Error Handling
 

Sources/GitHub OAuth/exports.swift

@@ -0,0 +1 @@
+@_exported public import GitHub_Standard

Sources/GitHub Organizations/exports.swift

@@ -0,0 +1,3 @@
+@_exported public import Async_Lifecycle_Primitives
+@_exported public import Either_Primitives
+@_exported public import GitHub_Standard

Sources/GitHub Repositories/exports.swift

@@ -1,2 +1 @@
-@_exported import GitHub_Repositories_Live
-@_exported import GitHub_Shared
+@_exported public import GitHub_Standard

Sources/GitHub Stargazers/exports.swift

@@ -0,0 +1,3 @@
+@_exported public import Async_Lifecycle_Primitives
+@_exported public import Either_Primitives
+@_exported public import GitHub_Standard

Sources/GitHub Traffic/exports.swift

@@ -0,0 +1 @@
+@_exported public import GitHub_Standard

Sources/GitHub Users/exports.swift

@@ -0,0 +1,3 @@
+@_exported public import Async_Lifecycle_Primitives
+@_exported public import Either_Primitives
+@_exported public import GitHub_Standard

Sources/GitHub/exports.swift

@@ -1,3 +1,6 @@
-@_exported public import Async_Lifecycle_Primitives
-@_exported public import Either_Primitives
-@_exported public import GitHub_Standard
+@_exported public import GitHub_OAuth
+@_exported public import GitHub_Organizations
+@_exported public import GitHub_Repositories
+@_exported public import GitHub_Stargazers
+@_exported public import GitHub_Traffic
+@_exported public import GitHub_Users

Tests/GitHub Core Tests/GitHub.OAuth.Client Tests.swift → Tests/GitHub OAuth Core Tests/GitHub.OAuth.Client Tests.swift

@@ -1,7 +1,7 @@
 import RFC_3986
 import Testing
 
-@testable import GitHub
+@testable import GitHub_OAuth
 
 extension GitHub.OAuth {
     @Suite("GitHub.OAuth.Client.Unit")

Tests/GitHub Core Tests/GitHub.OAuth.Fixture.Failure.swift → Tests/GitHub OAuth Core Tests/GitHub.OAuth.Fixture.Failure.swift

@@ -1,4 +1,4 @@
-@testable import GitHub
+@testable import GitHub_OAuth
 
 extension GitHub.OAuth.Fixture {
     enum Failure: Swift.Error, Equatable, Sendable {

Tests/GitHub Core Tests/GitHub.OAuth.Fixture.swift → Tests/GitHub OAuth Core Tests/GitHub.OAuth.Fixture.swift

@@ -1,4 +1,4 @@
-@testable import GitHub
+@testable import GitHub_OAuth
 
 extension GitHub.OAuth {
     enum Fixture {}

Tests/GitHub Core Tests/GitHub.Organization.Repositories.Client Tests.swift → Tests/GitHub Organizations Core Tests/GitHub.Organization.Repositories.Client Tests.swift

@@ -1,6 +1,6 @@
 import Testing
 
-@testable import GitHub
+@testable import GitHub_Organizations
 
 extension GitHub.Organization.Repositories {
     @Suite("GitHub.Organization.Repositories.Client.Unit")

Tests/GitHub Core Tests/GitHub.Organization.Repositories.Fixture.Failure.swift → Tests/GitHub Organizations Core Tests/GitHub.Organization.Repositories.Fixture.Failure.swift

@@ -1,4 +1,4 @@
-@testable import GitHub
+@testable import GitHub_Organizations
 
 extension GitHub.Organization.Repositories.Fixture {
     enum Failure: Swift.Error, Equatable, Sendable {

Tests/GitHub Core Tests/GitHub.Organization.Repositories.Fixture.swift → Tests/GitHub Organizations Core Tests/GitHub.Organization.Repositories.Fixture.swift

@@ -1,4 +1,4 @@
-@testable import GitHub
+@testable import GitHub_Organizations
 
 extension GitHub.Organization.Repositories {
     enum Fixture {}

Tests/GitHub Core Tests/GitHub.Repository.Content.Client Tests.swift → Tests/GitHub Repositories Core Tests/GitHub.Repository.Content.Client Tests.swift

@@ -1,6 +1,6 @@
 import Testing
 
-@testable import GitHub
+@testable import GitHub_Repositories
 
 extension GitHub.Repository.Content {
     @Suite("GitHub.Repository.Content.Client.Unit")

Tests/GitHub Core Tests/GitHub.Repository.Fixture.Failure.swift → Tests/GitHub Repositories Core Tests/GitHub.Repository.Fixture.Failure.swift

@@ -1,4 +1,4 @@
-@testable import GitHub
+@testable import GitHub_Repositories
 
 extension GitHub.Repository.Fixture {
     enum Failure: Swift.Error, Equatable, Sendable {

Tests/GitHub Core Tests/GitHub.Repository.Fixture.swift → Tests/GitHub Repositories Core Tests/GitHub.Repository.Fixture.swift

@@ -1,4 +1,4 @@
-@testable import GitHub
+@testable import GitHub_Repositories
 
 extension GitHub.Repository {
     enum Fixture {}

Tests/GitHub Core Tests/GitHub.Repository.Get.Client Tests.swift → Tests/GitHub Repositories Core Tests/GitHub.Repository.Get.Client Tests.swift

@@ -1,6 +1,6 @@
 import Testing
 
-@testable import GitHub
+@testable import GitHub_Repositories
 
 extension GitHub.Repository.Get {
     @Suite("GitHub.Repository.Get.Client.Unit")

Tests/GitHub Core Tests/GitHub.Repository.Stargazers.Client Tests.swift → Tests/GitHub Stargazers Core Tests/GitHub.Repository.Stargazers.Client Tests.swift

@@ -1,6 +1,6 @@
 import Testing
 
-@testable import GitHub
+@testable import GitHub_Stargazers
 
 extension GitHub.Repository.Stargazers {
     @Suite("GitHub.Repository.Stargazers.Client.Unit")
@@ -46,7 +46,7 @@ extension GitHub.Repository.Stargazers {
                 size: .maximum
             )
             let limit: GitHub.Repository.Stargazers.Traversal.Limit
-            do throws(GitHub.Repository.Fixture.Failure) {
+            do throws(GitHub.Repository.Stargazers.Fixture.Failure) {
                 limit = try self.limit(pages: 2, items: 1)
             } catch {
                 Issue.record("invalid traversal limit fixture: \(error)")
@@ -123,7 +123,7 @@ extension GitHub.Repository.Stargazers {
         private func limit(
             pages: UInt,
             items: UInt
-        ) throws(GitHub.Repository.Fixture.Failure)
+        ) throws(GitHub.Repository.Stargazers.Fixture.Failure)
             -> GitHub.Repository.Stargazers.Traversal.Limit
         {
             guard

Tests/GitHub Stargazers Core Tests/GitHub.Repository.Stargazers.Fixture.Failure.swift

@@ -0,0 +1,7 @@
+@testable import GitHub_Stargazers
+
+extension GitHub.Repository.Stargazers.Fixture {
+    enum Failure: Swift.Error, Equatable, Sendable {
+        case unexpected
+    }
+}

Tests/GitHub Stargazers Core Tests/GitHub.Repository.Stargazers.Fixture.swift

@@ -0,0 +1,5 @@
+@testable import GitHub_Stargazers
+
+extension GitHub.Repository.Stargazers {
+    enum Fixture {}
+}