tuist/xcodegraph

Installation

To install XcodeGraph, you can add it to your project or package's Package.swift:

let package = Package(
    dependencies: [
        .package(url: "https://github.com/tuist/XcodeGraph.git", .upToNextMajor(from: "0.7.0")),
    ],
)

XcodeGraphMapper

• Documentation

XcodeGraphMapper parses .xcworkspace or .xcodeproj files using XcodeProj and constructs a XcodeGraph.Graph representing their projects, targets, and dependencies:

Usage

import XcodeGraphMapper
let mapper: XcodeGraphMapping = XcodeGraphMapper()
let path = try AbsolutePath(validating: "/path/to/MyProjectOrWorkspace")
let graph = try await mapper.map(at: path)
// You now have a Graph containing projects, targets, packages, and dependencies.*
// Example: print all target names across all projects*
for project in graph.projects.values {
    for (targetName, _) in project.targets {
        print("Found target: \(targetName)")
    }
}

Once you have the Graph, you can explore or transform it as needed—printing targets, analyzing dependencies, generating reports, or integrating into other build tools.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

<table> <tbody> <tr> <td align="center" valign="top" width="14.28%"><a href="http://darrarski.pl"><img src="https://avatars.githubusercontent.com/u/1384684?v=4?s=100" width="100px;" alt="Dariusz Rybicki"/><br />_{<b>Dariusz Rybicki</b>}</a><br /><a href="https://github.com/tuist/XcodeGraph/commits?author=darrarski" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Binlogo"><img src="https://avatars.githubusercontent.com/u/7845507?v=4?s=100" width="100px;" alt="Binlogo"/><br />_{<b>Binlogo</b>}</a><br /><a href="https://github.com/tuist/XcodeGraph/commits?author=Binlogo" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/filipracki"><img src="https://avatars.githubusercontent.com/u/27164368?v=4?s=100" width="100px;" alt="Filip Racki"/><br />_{<b>Filip Racki</b>}</a><br /><a href="https://github.com/tuist/XcodeGraph/commits?author=filipracki" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/rgnns"><img src="https://avatars.githubusercontent.com/u/811827?v=4?s=100" width="100px;" alt="Gabriel Liévano"/><br />_{<b>Gabriel Liévano</b>}</a><br /><a href="https://github.com/tuist/XcodeGraph/commits?author=rgnns" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/fila95"><img src="https://avatars.githubusercontent.com/u/7265334?v=4?s=100" width="100px;" alt="Giovanni Filaferro"/><br />_{<b>Giovanni Filaferro</b>}</a><br /><a href="https://github.com/tuist/XcodeGraph/commits?author=fila95" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Garfeild"><img src="https://avatars.githubusercontent.com/u/12799?v=4?s=100" width="100px;" alt="Anton Kolchunov"/><br />_{<b>Anton Kolchunov</b>}</a><br /><a href="https://github.com/tuist/XcodeGraph/commits?author=Garfeild" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/alexmx"><img src="https://avatars.githubusercontent.com/u/1628901?v=4?s=100" width="100px;" alt="Alex Maimescu"/><br />_{<b>Alex Maimescu</b>}</a><br /><a href="https://github.com/tuist/XcodeGraph/commits?author=alexmx" title="Code">💻</a></td> </tr> </tbody> </table>

This project follows the all-contributors specification. Contributions of any kind welcome!

Package Metadata

Repository: tuist/xcodegraph

Default branch: main

README: README.md