{"id":13685576,"url":"https://github.com/devxoul/Carte","last_synced_at":"2025-05-01T04:31:38.512Z","repository":{"id":56905687,"uuid":"40135742","full_name":"devxoul/Carte","owner":"devxoul","description":"🍴 Open source license notice view generator for Swift","archived":false,"fork":false,"pushed_at":"2020-07-28T03:59:47.000Z","size":563,"stargazers_count":188,"open_issues_count":13,"forks_count":23,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-31T11:21:09.877Z","etag":null,"topics":["generator","ios","license","oss","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/devxoul.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-03T16:33:12.000Z","updated_at":"2025-03-19T16:50:44.000Z","dependencies_parsed_at":"2022-08-20T19:20:35.008Z","dependency_job_id":null,"html_url":"https://github.com/devxoul/Carte","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devxoul%2FCarte","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devxoul%2FCarte/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devxoul%2FCarte/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devxoul%2FCarte/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devxoul","download_url":"https://codeload.github.com/devxoul/Carte/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251824414,"owners_count":21649862,"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":["generator","ios","license","oss","swift"],"created_at":"2024-08-02T14:00:53.899Z","updated_at":"2025-05-01T04:31:36.389Z","avatar_url":"https://github.com/devxoul.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"# La Carte\n\n![Swift](https://img.shields.io/badge/Swift-4.0-orange.svg)\n[![CocoaPods](http://img.shields.io/cocoapods/v/Carte.svg?style=flat)](https://cocoapods.org/pods/Carte)\n[![Build Status](https://travis-ci.org/devxoul/Carte.svg?branch=master)](https://travis-ci.org/devxoul/Carte)\n[![Codecov](https://img.shields.io/codecov/c/github/devxoul/Carte.svg)](https://codecov.io/gh/devxoul/Carte)\n\nAn open source license notice view generator for Swift.\n\n## Screenshot\n\n![carte](https://cloud.githubusercontent.com/assets/931655/9243550/d781a822-41cc-11e5-91bb-8b5123b2c91e.png)\n\n\u003e ⬆ Those view controllers are automatically generated ✨\n\n## Features\n\n- **🚗 Automatic:** Carte automatically generates OSS notice from [CocoaPods](https://cocoapods.org).\n- **☕️ Easy Integration:** Install Carte and push CarteViewController. It's all done.\n- **🎨 Customizable:** Adding custom items, customizing CarteViewController. See [Customizing](#customizing) section.\n\n\n## Installation\n\nCarte only supports [CocoaPods](https://cocoapods.org) at this time.\n\n```ruby\npod 'Carte'\n```\n\n**⚠️ IMPORTANT**: Don't forget to add the post install hook to your Podfile. Add this script to the end of your Podfile:\n\n```ruby\npost_install do |installer|\n  pods_dir = File.dirname(installer.pods_project.path)\n  at_exit { `ruby #{pods_dir}/Carte/Sources/Carte/carte.rb configure` }\nend\n```\n\n## Usage\n\nCarte provides `CarteViewController`. You can use it as a normal view controller. Push, present or do whatever you want.\n\n```swift\nlet carteViewController = CarteViewController()\n```\n\nIf you want to create your own UI, use `Carte.items` to get `CarteItem`s.\n\n```swift\nclass Carte {\n  static var items: [CarteItem]\n}\n```\n\n## Customizing\n\n### Custom Items\n\n`CarteViewController` has a property named `items` which is an array of `CarteItem`. All of the licenses are stored in the `items`. You can add new items, remove existings, or sort items by manipulating `items` array.\n\nThis is an example of adding a new `CarteItem` and sorting items.\n\n```swift\nvar item = CarteItem(name: \"Carte\")\nitem.licenseText = \"The MIT License (MIT) ...Very long text...\"\n\nlet carteViewController = CarteViewController()\ncarteViewController.items.append(item)\ncarteViewController.items.sort { $0.name \u003c $1.name }\n```\n\n### Customizing View Controllers\n\n`CarteDetailViewController` is presented when user selects a table view cell. `CarteViewController` provides a handler for customizing it.\n\nDefinition: \n\n```swift\nvar configureDetailViewController: (CarteDetailViewController -\u003e Void)?\n```\n\nExample:\n\n```swift\nlet carteViewController = CarteViewController()\ncarteViewController.configureDetailViewController = { detailViewController in\n  detailViewController.navigationItem.leftBarButtonItem = ...\n  print(detailViewController.carteItem.name)\n}\n```\n\n## License\n\nCarte is under MIT license. See the [LICENSE](LICENSE) file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevxoul%2FCarte","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevxoul%2FCarte","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevxoul%2FCarte/lists"}