{"id":20875034,"url":"https://github.com/servicestack/swiftref","last_synced_at":"2026-04-19T21:35:22.288Z","repository":{"id":66141400,"uuid":"79928403","full_name":"ServiceStack/swiftref","owner":"ServiceStack","description":"Console App to add / update a Swift ServiceStack Reference","archived":false,"fork":false,"pushed_at":"2017-01-25T00:13:23.000Z","size":45,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-09T22:07:07.777Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ServiceStack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"publiccode":null,"codemeta":null}},"created_at":"2017-01-24T16:13:27.000Z","updated_at":"2017-01-24T22:13:06.000Z","dependencies_parsed_at":"2023-02-24T08:15:09.905Z","dependency_job_id":null,"html_url":"https://github.com/ServiceStack/swiftref","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ServiceStack%2Fswiftref","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ServiceStack%2Fswiftref/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ServiceStack%2Fswiftref/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ServiceStack%2Fswiftref/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ServiceStack","download_url":"https://codeload.github.com/ServiceStack/swiftref/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243249011,"owners_count":20260768,"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":[],"created_at":"2024-11-18T06:41:21.868Z","updated_at":"2025-12-25T22:22:56.437Z","avatar_url":"https://github.com/ServiceStack.png","language":"Swift","readme":"# swiftref\n\n`swiftref` is an OSX command-line utility for quickly Adding or Updating a \n[Swift ServiceStack Reference](http://docs.servicestack.net/swift-add-servicestack-reference) \nfor consuming Typed Web Services in a Swift v3 Xcode project.\n\n## Install swiftref\n\nThe easiest way to install `swiftref` is to download the OSX binary and save it to your `/usr/local/bin`:\n\n     sudo curl https://raw.githubusercontent.com/ServiceStack/swiftref/master/dist/swiftref \u003e /usr/local/bin/swiftref\n     sudo chmod +x /usr/local/bin/swiftref\n\n## Usage\n\n### Add a new ServiceStack Reference:\n\nTo Add a new ServiceStack Reference you just need to provide the Base URL for the remote ServiceStack Service \nyou wish to generate Typed Swift DTOs for:\n\n    swiftref {BaseUrl}\n    swiftref {BaseUrl} {FileName}\n\nIf the FileName is not provided it's inferred from the host name of the remote URL, e.g:\n\n    swiftref http://techstacks.io\n\nWhich will download the Typed Swift DTOs for [techstacks.io](http://techstacks.io) and save them to `techstacks.dtos.swift` \nor if preferred, you can specify a different FileName to save to, e.g:\n\n    swiftref http://techstacks.io TechStacks\n\nWhich will save the Typed Swift DTOs to `TechStacks.dtos.swift`.\n\n`swiftref` also downloads [ServiceStack's Swift Client](https://github.com/ServiceStack/ServiceStack.Swift) \nand saves it to `JsonServiceClient.swift` which together with the Server DTOs contains all the dependencies required to \nconsume Typed Web Services in Swift.\n\n### Update an existing ServiceStack Reference:\n\nTo Update an existing ServiceStack Reference provide its Filename as the first argument:\n\n    swiftref {FileName.dtos.swift}\n\nAs an example you can Update the Server DTOs added in the previous command with:\n\n    swiftref TechStacks.dtos.swift\n\nThis will also include any \n[Customization Options](http://docs.servicestack.net/swift-add-servicestack-reference#swift-configuration) \nthat were manually added.\n\n## Learn\n\nTo learn more, see Documentation for [Swift Add ServiceStack Reference](http://docs.servicestack.net/swift-add-servicestack-reference).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fservicestack%2Fswiftref","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fservicestack%2Fswiftref","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fservicestack%2Fswiftref/lists"}