{"id":13572637,"url":"https://github.com/bloomberg/xcdiff","last_synced_at":"2025-05-16T03:03:55.885Z","repository":{"id":35703015,"uuid":"214506285","full_name":"bloomberg/xcdiff","owner":"bloomberg","description":"A tool which helps you diff xcodeproj files.","archived":false,"fork":false,"pushed_at":"2025-02-14T14:18:42.000Z","size":947,"stargazers_count":941,"open_issues_count":8,"forks_count":43,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-05-10T11:36:48.086Z","etag":null,"topics":["diff","swift","xcode","xcodeproj","xcodeproject"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bloomberg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2019-10-11T18:38:04.000Z","updated_at":"2025-05-06T10:01:37.000Z","dependencies_parsed_at":"2024-04-15T08:54:35.321Z","dependency_job_id":null,"html_url":"https://github.com/bloomberg/xcdiff","commit_stats":{"total_commits":119,"total_committers":18,"mean_commits":6.611111111111111,"dds":"0.46218487394957986","last_synced_commit":"a2c5476d39740c70bacab7d9cf84a7f225c9623e"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bloomberg%2Fxcdiff","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bloomberg%2Fxcdiff/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bloomberg%2Fxcdiff/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bloomberg%2Fxcdiff/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bloomberg","download_url":"https://codeload.github.com/bloomberg/xcdiff/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254459084,"owners_count":22074604,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["diff","swift","xcode","xcodeproj","xcodeproject"],"created_at":"2024-08-01T14:01:29.329Z","updated_at":"2025-05-16T03:03:50.873Z","avatar_url":"https://github.com/bloomberg.png","language":"Swift","funding_links":[],"categories":["Swift","Other Text Formats"],"sub_categories":["Diff Enhancers"],"readme":"\u003cp align=\"center\"\u003e\n   \u003cimg src=\"Documentation/Resources/xcdiff.png\" alt=\"xcdiff logo\" /\u003e\n\u003c/p\u003e\n\n[![Build Status](https://github.com/bloomberg/xcdiff/actions/workflows/xcdiff.yaml/badge.svg)](https://github.com/bloomberg/xcdiff/actions/workflows/xcdiff.yaml)\n[![Coverage Status](https://codecov.io/gh/bloomberg/xcdiff/branch/main/graph/badge.svg)](https://codecov.io/gh/bloomberg/xcdiff)\n\n*xcdiff* is an extensible tool that **finds differences between two .xcodeproj project files**. It can be thought of as git diff for .xcodeproj files, which can be used directly from the command line as well as a library supporting your own set of tools.\n\n## How to use xcdiff\n\nRunning the command `xcdiff` in your project directory will search for two `.xcodeproj` files in this directory and use all of xcdiff's comparators on the projects (e.g. targets, sources and headers).\n\nYou can also specify two particular projects for xcdiff to compare.\n\n```sh\nxcdiff -p1 OriginalProject.xcodeproj -p2 GeneratedProject.xcodeproj\n```\n\nHere is an example output:\n\n\u003cp align=\"center\"\u003e\n   \u003cimg src=\"Documentation/Resources/xcdiff-demo.png\" alt=\"xcdiff demo\" /\u003e\n\u003c/p\u003e\n\nTo see a detailed report of differences you can specify the `--verbose` (`-v`) option.\n\n```sh\nxcdiff -p1 OriginalProject.xcodeproj -p2 GeneratedProject.xcodeproj -v\n```\n\n\u003cp align=\"center\"\u003e\n   \u003cimg src=\"Documentation/Resources/xcdiff-demo-v.png\" alt=\"xcdiff demo -v\" /\u003e\n\u003c/p\u003e\n\n## Use Cases\n\n- When adopting project generation (e.g. using tools like [XcodeGen](https://github.com/yonaskolb/XcodeGen) or [Tuist](https://github.com/tuist/tuist)), comparing the generated xcodeproj files against the original ones can help boost confidence in the migration process.\n- _Probably a few more we haven't thought of yet!..._\n\n## Installation\n\n- [Install xcdiff](Documentation/Installation.md#CLI) and use from the command line.\n- [Add as a dependency](Documentation/Installation.md#Framework) of your macOS project (xcdiff follows the [semantic versioning][3]).\n\n## Documentation\n\n- Read [xcdiff CLI](Documentation/CLI.md) documentation or try `xcdiff --help`.\n- Check out how to use [XCDiffCore Framework](Documentation/Framework.md) in your own project.\n\n## Contributions\n\nAll improvements to xcdiff are very welcome!\n\nIf you see an issue that you would like to see fixed, the best way to make it happen is to help out by submitting a [Pull Request](../../pulls) implementing it. **Before sending a [Pull Request](../../pulls), please make sure you read our [Contribution Guidelines][2]**. Information in [Development Documentation](Documentation/Development.md) can help you to set up your local development environment.\n\nWe also welcome [Issue Reports](../../issues). Be sure to choose the proper issue template for your issue, so that all necessary details are provided.\n\n## Attributions\n\nWe would like to thank the authors and contributors of the following projects:\n\n- [XcodeProj](https://github.com/tuist/xcodeproj)\n- [SwiftPM](https://github.com/apple/swift-package-manager) (Utility Library)\n\n## Code of Conduct\n\nThis project has adopted a [Code of Conduct][1].\nIf you have any concerns about the Code, or behavior which you have experienced\nin the project, please contact us at opensource@bloomberg.net.\n\n## Security Vulnerability Reporting\n\nIf you believe you have identified a security vulnerability in this project,\nplease send email to the project team at opensource@bloomberg.net, detailing\nthe suspected issue and any methods you've found to reproduce it.\n\nPlease do NOT open an issue in the GitHub repository, as we'd prefer to keep\nvulnerability reports private until we've had an opportunity to review and\naddress them.\n\n## License\n\nxcdiff is released under version 2.0 of the [Apache License](LICENSE.txt).\n\n\n[1]: https://github.com/bloomberg/.github/blob/master/CODE_OF_CONDUCT.md\n[2]: https://github.com/bloomberg/.github/blob/master/CONTRIBUTING.md\n[3]: https://semver.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbloomberg%2Fxcdiff","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbloomberg%2Fxcdiff","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbloomberg%2Fxcdiff/lists"}