{"id":21834228,"url":"https://github.com/ezefranca/datamuse-swift","last_synced_at":"2025-07-06T10:32:39.626Z","repository":{"id":56931887,"uuid":"110348799","full_name":"ezefranca/datamuse-swift","owner":"ezefranca","description":"A datamuse api swift wrapper without dependencies","archived":false,"fork":false,"pushed_at":"2024-12-19T10:14:12.000Z","size":7594,"stargazers_count":24,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-17T14:02:28.747Z","etag":null,"topics":["datamuse","datamuse-api","datamuse-swift","ios","macos","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","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/ezefranca.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-11-11T13:47:10.000Z","updated_at":"2024-12-19T10:14:15.000Z","dependencies_parsed_at":"2025-04-11T23:40:45.686Z","dependency_job_id":null,"html_url":"https://github.com/ezefranca/datamuse-swift","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/ezefranca/datamuse-swift","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezefranca%2Fdatamuse-swift","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezefranca%2Fdatamuse-swift/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezefranca%2Fdatamuse-swift/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezefranca%2Fdatamuse-swift/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ezefranca","download_url":"https://codeload.github.com/ezefranca/datamuse-swift/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ezefranca%2Fdatamuse-swift/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263885161,"owners_count":23525036,"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":["datamuse","datamuse-api","datamuse-swift","ios","macos","swift"],"created_at":"2024-11-27T20:02:18.754Z","updated_at":"2025-07-06T10:32:39.561Z","avatar_url":"https://github.com/ezefranca.png","language":"Swift","funding_links":[],"categories":["Swift"],"sub_categories":[],"readme":"# datamuse-swift\n\n[![Platforms](https://img.shields.io/cocoapods/p/datamuse-swift.svg)](https://cocoapods.org/pods/datamuse-swift)\n[![License](https://img.shields.io/cocoapods/l/datamuse-swift.svg)](https://raw.githubusercontent.com/ezefranca/datamuse-swift/master/LICENSE)\n[![Swift Package Manager](https://img.shields.io/badge/Swift%20Package%20Manager-compatible-brightgreen.svg)](https://github.com/apple/swift-package-manager)\n[![CocoaPods compatible](https://img.shields.io/cocoapods/v/datamuse-swift.svg)](https://cocoapods.org/pods/datamuse-swift)\n\n[![logo](https://www.datamuse.com/api/datamuse-logo-rgb.png)](https://www.datamuse.com/api/)\n\nA Datamuse API Swift wrapper without external depedencies and support for async/await.\n\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Methods](#methods)\n- [License](#license)\n\n## Requirements\n\n- iOS 15+ / macOS 12+ / tvOS 15+ / watchOS 8+\n- Xcode 15.0+\n\n## Installation\n\n### Swift Package Manager\n\nTo integrate `datamuse-swift` into your Xcode project, open your project settings, navigate to the \"Package Dependencies\" section, and add the following URL:\n\n```\nhttps://github.com/ezefranca/datamuse-swift.git\n```\n\n### CocoaPods\n\nAdd the following to your `Podfile`:\n\n```ruby\nplatform :ios, '15.0'\nuse_frameworks!\n\npod 'datamuse-swift', '~\u003e 1.0.0'\n```\n\nRun the following command to install the dependency:\n\n```bash\n$ pod install\n```\n\n### Manual Installation\n\nClone the repository and drag the `Sources` folder into your Xcode project.\n\n## Usage\n\n### Getting Started\n\nFirst, import the library:\n\n```swift\nimport datamuse_swift\n```\n\nCreate an instance of `DataMuseClient`:\n\n```swift\nlet client = DataMuseClient()\n```\n\n### Fetching Words\n\nUse the `fetchWords` method with any of the predefined endpoints.\n\n#### Example: Fetch Similar Words\n\n```swift\nTask {\n    do {\n        let words = try await client.fetchWords(endpoint: .similarWords(to: \"ring\"))\n        words.forEach { print($0.word) }\n    } catch {\n        print(\"Error: \\(error.localizedDescription)\")\n    }\n}\n```\n\n## Methods\n\nThe following endpoints are available:\n\n| Description                                                   | Method                                                                                       |\n|---------------------------------------------------------------|----------------------------------------------------------------------------------------------|\n| Words with a meaning similar to a given word                 | `.similarWords(to: String)`                                                                 |\n| Words related to a word that start with a specific letter    | `.wordsRelated(to: String, startingWith: String)`                                           |\n| Words related to a word that end with a specific letter      | `.wordsEndingWith(to: String, endingWith: String)`                                          |\n| Words spelled similarly to a given word                     | `.wordsSpelledLike(String)`                                                                 |\n| Words that rhyme with a given word                          | `.wordsThatRhyme(with: String)`                                                             |\n| Words that rhyme with a given word and are related          | `.wordsThatRhymeWithRelated(with: String, related: String)`                                 |\n| Adjectives often used to describe a word                   | `.adjectivesOftenUsed(toDescribe: String)`                                                  |\n| Adjectives describing a word sorted by related topics       | `.adjectivesDescribing(this: String, related: String)`                                      |\n| Nouns often described by a given adjective                 | `.nounsOftenDescribed(byAdjective: String)`                                                 |\n| Words that often follow another word in a sentence          | `.wordsThatFollow(following: String, startingWith: String)`                                 |\n| Words triggered by (strongly associated with) another word | `.wordsTriggered(by: String)`                                                              |\n| Suggestions based on partial input                         | `.suggestions(for: String)`                                                                |\n| Words that start, finish, and have a specific pattern      | `.wordWithPattern(start: String, finish: String, lettersBetween: Int)`                     |\n\n### Word Model\n\nAll API responses return an array of `Word` objects:\n\n```swift\npublic struct Word: Codable {\n    public let word: String\n    public let score: Int?\n}\n```\n\n## License\n\n`datamuse-swift` is released under the MIT license. See [LICENSE](https://github.com/ezefranca/datamuse-swift/blob/master/LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezefranca%2Fdatamuse-swift","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fezefranca%2Fdatamuse-swift","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fezefranca%2Fdatamuse-swift/lists"}