{"id":2012,"url":"https://github.com/nvzqz/Roman","last_synced_at":"2025-08-02T05:33:23.106Z","repository":{"id":62452978,"uuid":"49930939","full_name":"nvzqz/Roman","owner":"nvzqz","description":"Seamless Roman numeral conversion in Swift","archived":false,"fork":false,"pushed_at":"2017-11-02T06:27:06.000Z","size":652,"stargazers_count":36,"open_issues_count":2,"forks_count":7,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-07-22T17:26:59.563Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nvzqz.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}},"created_at":"2016-01-19T06:15:52.000Z","updated_at":"2019-07-02T08:47:22.000Z","dependencies_parsed_at":"2022-11-01T22:46:31.897Z","dependency_job_id":null,"html_url":"https://github.com/nvzqz/Roman","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/nvzqz/Roman","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nvzqz%2FRoman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nvzqz%2FRoman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nvzqz%2FRoman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nvzqz%2FRoman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nvzqz","download_url":"https://codeload.github.com/nvzqz/Roman/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nvzqz%2FRoman/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268339405,"owners_count":24234544,"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","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-01-05T20:16:01.225Z","updated_at":"2025-08-02T05:33:22.690Z","avatar_url":"https://github.com/nvzqz.png","language":"Swift","funding_links":[],"categories":["Libs","UI","Text"],"sub_categories":["Text","Layout","Other free courses","Other Testing","Keychain"],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg\n    src=\"https://raw.githubusercontent.com/nvzqz/Roman/master/Assets/banner.png\"\n    alt=\"Roman Banner\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/platform-osx%20%7C%20ios%20%7C%20watchos%20%7C%20tvos%20%7C%20linux-lightgrey.svg?style=flat-square\"\n         alt=\"Platform\"\u003e\n    \u003ca href=\"https://swift.org/package-manager\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/SPM-compatible-orange.svg?style=flat-square\"\n             alt=\"Swift Package Manager\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://cocoapods.org/pods/Roman\"\u003e\n        \u003cimg src=\"https://img.shields.io/cocoapods/v/Roman.svg?style=flat-square\"\n             alt=\"CocoaPods\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/Carthage/Carthage\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat-square\"\n             alt=\"Carthage\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/license-MIT-000000.svg?style=flat-square\"\n             alt=\"MIT License\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\n  • \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\n  • \u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\n  • \u003ca href=\"https://nvzqz.github.io/Roman/docs/\"\u003eDocumentation\u003c/a\u003e\n\u003c/p\u003e\n\nRoman is a Swift framework that allows for seamless Roman numeral conversion.\n\n## Installation\n\n### Compatibility:\n\n- Platforms:\n    - OS X\n    - iOS\n    - watchOS\n    - tvOS\n    - Linux\n- Language:\n    - Swift 2.1+\n\n### Install Using Swift Package Manager\nThe [Swift Package Manager](https://swift.org/package-manager/) is a\ndecentralized dependency manager for Swift.\n\n1. Add the project to your `Package.swift`.\n\n    ```swift\n    import PackageDescription\n\n    let package = Package(\n        name: \"MyAwesomeProject\",\n        dependencies: [\n            .Package(url: \"https://github.com/nvzqz/Roman.git\",\n                     majorVersion: 1)\n        ]\n    )\n    ```\n\n2. Import the Roman module.\n\n    ```swift\n    import Roman\n    ```\n\n### Install Using CocoaPods\n[CocoaPods](https://cocoapods.org/) is a centralized dependency manager for\nObjective-C and Swift. Go [here](https://guides.cocoapods.org/using/index.html)\nto learn more.\n\n1. Add the project to your [Podfile](https://guides.cocoapods.org/using/the-podfile.html).\n\n    ```ruby\n    use_frameworks!\n\n    pod 'Roman', '~\u003e 1.1.0'\n    ```\n\n2. Run `pod install` and open the `.xcworkspace` file to launch Xcode.\n\n3. Import the Roman framework.\n\n    ```swift\n    import Roman\n    ```\n\n### Install Using Carthage\n[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency\nmanager for Objective-C and Swift.\n\n1. Add the project to your [Cartfile](https://github.com/Carthage/Carthage/blob/master/Documentation/Artifacts.md#cartfile).\n\n    ```\n    github \"nvzqz/Roman\"\n    ```\n\n2. Run `carthage update` and follow [the additional steps](https://github.com/Carthage/Carthage#getting-started)\n   in order to add Roman to your project.\n\n3. Import the Roman framework.\n\n    ```swift\n    import Roman\n    ```\n\n### Install Manually\n\nSimply add the `Roman.swift` file into your project.\n\n## Usage\n\n### String\n\nA Roman numeral string can be created from an instance of a type that conforms\nto `IntegerType`.\n\n```swift\nString(roman: 1478)  // \"MCDLXXVIII\"\nString(roman: 2743)  // \"MMDCCXLIII\"\nString(roman: 1226)  // \"MCCXXVI\"\nString(roman: 0)     // nil\nString(roman: -42)   // nil\n```\n\n### IntegerType\n\nAll types that conform to `IntegerType` can be initialized from a Roman numeral\nstring.\n\nThe input string is case insensitive.\n\n```swift\nInt(roman: \"III\")  // 3\nInt(roman: \"MIV\")  // 1004\nInt(roman: \"CdV\")  // 405\n```\n\nRoman even supports irregular numerals that don't use a short form.\n\nEach of the following evaluates to `true`:\n\n```swift\nInt(roman: \"IV\") == Int(roman: \"IIII\")\nInt(roman: \"XX\") == Int(roman: \"VVVV\")\nInt(roman: \"CD\") == Int(roman: \"CCCC\")\n```\n\nInvalid strings return `nil`.\n\n```swift\nInt(roman: \"hello\") == nil\nInt(roman: \"IIIXX\") == nil\nInt(roman: \"XYZ\")   == nil\n```\n\n### FloatingPointType\n\nAll types that conform to `FloatingPointType` can be initialized from a Roman\nnumeral string.\n\nCreating instances from Roman numerals works the same way as with `IntegerType`.\n\n## License\n\nRoman is released under the [MIT License](https://opensource.org/licenses/MIT).\n\nAll assets are released under the Creative Commons [Attribution-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-sa/4.0/)\nand can be found in the [Assets](https://github.com/nvzqz/Roman/tree/master/Assets)\nfolder.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnvzqz%2FRoman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnvzqz%2FRoman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnvzqz%2FRoman/lists"}