{"id":13994356,"url":"https://github.com/square/cocoapods-generate","last_synced_at":"2025-05-15T20:07:06.694Z","repository":{"id":32811162,"uuid":"134632340","full_name":"square/cocoapods-generate","owner":"square","description":"A CocoaPods plugin that allows you to easily generate a workspace from a podspec.","archived":false,"fork":false,"pushed_at":"2024-09-30T07:54:42.000Z","size":694,"stargazers_count":283,"open_issues_count":19,"forks_count":39,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-13T12:48:49.729Z","etag":null,"topics":["cocoapods","cocoapods-plugin","ios","swift"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/square.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-05-23T22:33:32.000Z","updated_at":"2025-03-03T09:19:27.000Z","dependencies_parsed_at":"2024-11-29T16:42:28.911Z","dependency_job_id":null,"html_url":"https://github.com/square/cocoapods-generate","commit_stats":{"total_commits":99,"total_committers":11,"mean_commits":9.0,"dds":0.6262626262626263,"last_synced_commit":"fc94b68a67728c7a69dd1c102822576854bbec49"},"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Fcocoapods-generate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Fcocoapods-generate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Fcocoapods-generate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/square%2Fcocoapods-generate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/square","download_url":"https://codeload.github.com/square/cocoapods-generate/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254414499,"owners_count":22067272,"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":["cocoapods","cocoapods-plugin","ios","swift"],"created_at":"2024-08-09T14:02:49.864Z","updated_at":"2025-05-15T20:07:01.552Z","avatar_url":"https://github.com/square.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"# `cocoapods-generate`\n\nA [CocoaPods](https://cocoapods.org/) plugin that allows you to easily generate a workspace from a podspec.\n\nWhether you want to completely remove all Xcode projects from your library's repository or you want to be able to focus on a small piece of a monorepo, a single `pod gen` command will build up a workspace suitable for writing, running, testing, and debugging in Xcode.\n\nWhen you're done working, you don't have to do anything -- and that means no merge conflicts, no managing Xcode projects, and no tearing down a sample app setup. `pod gen` manages all that for you.\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'cocoapods-generate'\n```\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install cocoapods-generate\n\n## CLI\n\nThe main point of interaction with the plugin is via the `pod gen` command.\nIt takes in a list of podspecs (or directories) as arguments,\nas well as many options that modify how `gen` will create your workspace.\n\n\u003c!-- begin cli usage --\u003e\n```\nUsage:\n\n    $ pod gen [PODSPEC|DIR ...]\n\n      Generates Xcode workspaces from a podspec.\n\n      pod gen allows you to keep your Podfile and podspecs as the single source of\n      truth for pods under development. By generating throw-away workspaces capable of\n      building, running, and testing a pod, you can focus on library development\n      without worrying about other code or managing an Xcode project.\n\n      pod gen works particularly well for monorepo projects, since it is capable of\n      using your existing settings when generating the workspace, making each gen'ed\n      project truly a small slice of the larger application.\n\nOptions:\n\n    --allow-root                           Allows CocoaPods to run as root\n    --silent                               Show nothing\n    --verbose                              Show more debugging information\n    --no-ansi                              Show output without ANSI codes\n    --help                                 Show help banner of specified command\n    --podfile-path=PATH                    Path to podfile to use\n    --use-podfile                          Whether restrictions should be copied from\n                                           the podfile\n    --use-podfile-plugins                  Whether plugins should be copied from the\n                                           podfile\n    --use-lockfile                         Whether the lockfile should be used to\n                                           discover transitive dependencies\n    --use-lockfile-versions                Whether versions from the lockfile should\n                                           be used\n    --use-libraries                        Whether to use libraries instead of\n                                           frameworks\n    --generate-multiple-pod-projects       Whether to generate multiple Xcode projects\n    --incremental-installation             Whether to use incremental installation\n    --gen-directory=PATH                   Path to generate workspaces in\n    --auto-open                            Whether to automatically open the generated\n                                           workspaces\n    --clean                                Whether to clean the generated directories\n                                           before generating\n    --app-host-source-dir=DIR              A directory containing sources to use for\n                                           the app host\n    --sources=SOURCE1,SOURCE2              The sources from which to pull dependent\n                                           pods (defaults to all repos in the podfile\n                                           if using the podfile, else all available\n                                           repos). Can be a repo name or URL. Multiple\n                                           sources must be comma-delimited.\n    --local-sources=SOURCE1,SOURCE2        Paths from which to find local podspecs for\n                                           transitive dependencies. Multiple\n                                           local-sources must be comma-delimited.\n    --platforms=ios,macos                  Limit to specific platforms. Default is all\n                                           platforms supported by the podspec.\n                                           Multiple platforms must be comma-delimited.\n    --repo-update                          Force running `pod repo update` before\n                                           install\n    --use-default-plugins                  Whether installation should activate\n                                           default plugins\n    --deterministic-uuids                  Whether installation should use\n                                           deterministic UUIDs for pods projects\n    --disable-input-output-paths           Whether to disable the input \u0026 output paths\n                                           of the CocoaPods script phases (Copy\n                                           Frameworks \u0026 Copy Resources)\n    --share-schemes-for-development-pods   Whether installation should share schemes\n                                           for development pods\n    --warn-for-multiple-pod-sources        Whether installation should warn when a pod\n                                           is found in multiple sources\n    --use-modular-headers                  Whether the target should be generated as a\n                                           clang module, treating dependencies as\n                                           modules, as if `use_modular_headers!` were\n                                           specified. Will error if both this option\n                                           and a podfile are specified\n    --single-workspace                     Whether to produce a single workspace for\n                                           all podspecs specified.\n    --xcode-version=xcode_version          The Xcode version to use for producing the\n                                           consumer sample project\n```\n\u003c!-- end cli usage --\u003e\n\n## `.gen_config.yml`\n\nAll of the command line options above can also be specified in a `.gen_config.yml` file.\n\nFor example, the equivalent of running `pod gen --no-deterministic-uuids --sources=a,b --gen-directory=/tmp/gen --use-libraries` would be\n\n```yaml\ndeterministic_uuids: false\nsources:\n- a\n- b\ngen_directory: /tmp/gen\nuse_libraries: true\n```\n\n## Development\n\nAfter checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/rake spec` to run the tests.\n\nYou can also run `bin/console` for an interactive prompt that will allow you to experiment.\n\nTo install this gem onto your local machine, run `bundle exec rake install`.\n\nTo release a new version, update the version number in `VERSION`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/square/cocoapods-generate. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.\n\n## Code of Conduct\n\nEveryone interacting in the cocoapods-generate project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/square/cocoapods-generate/blob/master/CODE_OF_CONDUCT.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquare%2Fcocoapods-generate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsquare%2Fcocoapods-generate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsquare%2Fcocoapods-generate/lists"}