{"id":28308594,"url":"https://github.com/vsanthanam/jbird","last_synced_at":"2026-04-10T18:04:43.526Z","repository":{"id":293729865,"uuid":"984955414","full_name":"vsanthanam/JBird","owner":"vsanthanam","description":"A blazing fast, type-safe library for working with JSON in Swift","archived":false,"fork":false,"pushed_at":"2026-01-21T23:33:18.000Z","size":3248,"stargazers_count":10,"open_issues_count":9,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-22T10:17:11.929Z","etag":null,"topics":["c","ios","json","maccatalyst","macos","macros","resultbuilders","swift","tvos","visionos","watchos"],"latest_commit_sha":null,"homepage":"https://www.usejbird.com/","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/vsanthanam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-16T19:54:49.000Z","updated_at":"2026-01-21T23:14:10.000Z","dependencies_parsed_at":"2025-11-29T21:04:06.988Z","dependency_job_id":null,"html_url":"https://github.com/vsanthanam/JBird","commit_stats":null,"previous_names":["vsanthanam/jbird"],"tags_count":40,"template":false,"template_full_name":null,"purl":"pkg:github/vsanthanam/JBird","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsanthanam%2FJBird","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsanthanam%2FJBird/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsanthanam%2FJBird/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsanthanam%2FJBird/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vsanthanam","download_url":"https://codeload.github.com/vsanthanam/JBird/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vsanthanam%2FJBird/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30233432,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T19:01:10.287Z","status":"ssl_error","status_checked_at":"2026-03-07T18:59:58.103Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["c","ios","json","maccatalyst","macos","macros","resultbuilders","swift","tvos","visionos","watchos"],"created_at":"2025-05-24T08:08:34.048Z","updated_at":"2026-04-10T18:04:43.508Z","avatar_url":"https://github.com/vsanthanam.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# JBird\n\n[![MIT License](https://img.shields.io/github/license/vsanthanam/JBird)](https://github.com/vsanthanam/JBird/blob/main/LICENSE)\n[![GitHub Release](https://img.shields.io/github/v/release/vsanthanam/JBird?include_prereleases)](https://github.com/vsanthanam/JBird/releases)\n[![Build Status](https://img.shields.io/github/check-runs/vsanthanam/JBird/main)](https://github.com/vsanthanam/JBird/actions)\n[![Swift Version](https://img.shields.io/badge/swift-%206.1%20%7C%206.2%20%7C%206.3-critical)](https://swift.org)\n[![Xcode](https://img.shields.io/badge/xcode-26.4-blue)](https://developer.apple.com/xcode/)\n[![Documentation](https://img.shields.io/badge/documentation-GitHub-8A2BE2)](https://usejbird.com/docs/documentation/jbird)\n[![Test Coverage](https://codecov.io/gh/vsanthanam/JBird/graph/badge.svg?token=11GDRKPRLF)](https://codecov.io/gh/vsanthanam/JBird)\n\nA blazing fast, type-safe library for working with JSON in Swift\n\n## Why JBird?\n\nJBird brings type safety to unstructured JSON with an elegant, ergonomic API that dramatically improves developer experience compared to Foundation's JSONSerialization:\n\n```swift\n// With Foundation, you need to cast and unwrap repeatedly\nif let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],\n   let user = json[\"user\"] as? [String: Any],\n   let name = user[\"name\"] as? String,\n   let isActive = user[\"isActive\"] as? Bool {\n   // Finally use the values after multiple casts\n}\n\n// With JBird, you get natural, type-safe accessor syntax\nlet json = try JSON(data)\nlet name = try json[\"user\"][\"name\"].stringValue\nlet isActive = try json[\"user\"][\"isActive\"].boolValue\nlet user = try json[\"user\"].convert(into: User.self)\n```\n\nJBird also simplifies mutation, which is cumbersome with Foundation:\n\n```swift\n// With Foundation, you must re-create and re-assign \nvar jsonDict = json as? [String: Any] ?? [:]\nif var user = jsonDict[\"user\"] as? [String: Any] {\n    user[\"status\"] = \"active\" \n    jsonDict[\"user\"] = user\n}\n\n// With JBird, you can traverse and mutate in a single expression\nvar mutableJSON = try JSON(data)\ntry mutableJSON[\"user\"].setValue(true, forKey: \"isActive\")\n```\n\nJBird eliminates the verbosity of type casting chains and nested optional unwrapping, providing a statically typed interface for efficient JSON traversal and modification. For more information see [the documentation](https://www.usejbird.com/docs/documentation/jbird/whyjbird)\n\n## Features\n\n- **Blazing fast performance**: Built with a [C11](https://en.wikipedia.org/wiki/C11_(C_standard_revision)) core for optimized parsing with SIMD acceleration where appropriate.\n- **Ergonomic, type-safe APIs**: Rich, Swift-first API with proper type checking and error handling. Easily and safely convert between serialized JSON, type-safe JSON, and native Swift types.\n- **Thoroughly tested**: Comprehensive test suite ensures thorough correctness and strict adherence to the [JSON RFC 8259](https://datatracker.ietf.org/doc/html/rfc8259).\n\n## Installation\n\nJBird is primarily distributed through the [Swift Package Manager](https://www.swift.org/package-manager/). \n\nTo add JBird as a dependency to an existing Swift package, add the following line of code to the `dependencies` parameter of your `Package.swift` file:\n\n```swift\ndependencies: [\n    .package(url: \"https://github.com/vsanthanam/JBird.git\", from: \"2.0.6\")\n]\n```\n\nThen, add the `JBird` dependency to your target or targets of choice:\n\n```swift\n.target(\n    name: \"YourTarget\",\n    dependencies: [\n        .product(name: \"JBird\", package: \"JBird\")\n    ]\n)\n```\n\n### Xcode\n\nJBird supports the full range of Apple platforms when working with Xcode, whether you build from source or use an XCFramework:\n\n| Platform | Minimum Version | Status |\n|----------|-----------------|--------|\n| macOS | 13.0+ | ✅ Supported |\n| Mac Catalyst | 16.0+ | ✅ Supported |\n| iOS | 16.0+ | ✅ Supported |\n| watchOS | 9.0+ | ✅ Supported |\n| tvOS | 16.0+ | ✅ Supported |\n| visionOS | 1.0+ | ✅ Supported |\n\n### Swift Package Manager\n\nJBird has been tested to work with the following platforms and Swift toolchains:\n\n| Platform | Swift Versions | Status |\n|----------|----------------|--------|\n| macOS | 6.1, 6.2, and 6.3 | ✅ Supported \u0026 Tested |\n| Linux (Ubuntu) | 6.1, 6.2, and 6.3 | ✅ Supported \u0026 Tested |\n| Windows | 6.1, 6.2, and 6.3 | ✅ Supported \u0026 Tested |\n| WebAssembly | 6.1, 6.2, and 6.3 | ⚠️ Supported (No Tests) |\n| Android | 6.1, 6.2, and 6.3 | ⚠️ Supported (No Tests) |\n\nAll supported platforms undergo continuous integration testing to ensure compatibility across different environments. Other platforms such as FreeBSD may also work, but are not validated in the built-in GitHub Actions powered CI environment.\n\nFor additional installation instructions, see [the documentation](https://www.usejbird.com/docs/documentation/jbird/setup).\n\n## Performance\n\nJBird is designed with performance and memory efficiency in mind, with benchmarks showing it to be one of the fastest JSON parsers available for Swift. The core parsing engine is written in C and is heavily optimized, making it significantly faster than pure Swift alternatives.\n\nJBird demonstrates exceptional performance compared to other popular JSON parsing libraries:\n\n- **Speed**: JBird parses JSON 2-5x faster than SwiftyJSON and about 25% faster than Foundation\n- **Memory Efficiency**: JBird uses significantly less memory than other parsers (up to a 95% reduction)\n- **Resource Usage**: JBird requires dramatically fewer CPU instructions and memory allocations for equivelent payloads\n- **Consistent Performance**: JBird maintains its performance advantage across different JSON file sizes and formats\n\nThese benchmarks were run on a variety of JSON files ranging from 64KB to 5MB, in both minified and pretty-printed formats. You can explore the comparisons with common Swift JSON libraries (Foundation, SwiftyJSON, etc.) in the `/Benchmarks` directory.\n\n## Usage \u0026 Documentation\n\nJBird's documentation is built with [DocC](https://developer.apple.com/documentation/docc) and included wich each release as a DocC archive. The latest version is hosted on [GitHub Pages](https://pages.github.com) and is available [here](https://usejbird.com/docs/documentation/jbird).\n\nAdditional information is available on the [Swift Package Index](https://swiftpackageindex.com/vsanthanam/JBird)\n\n[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fvsanthanam%2FJBird%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/vsanthanam/JBird)\n[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fvsanthanam%2FJBird%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/vsanthanam/JBird)\n\nExplore [the documentation](https://usejbird.com/docs/documentation/jbird) for more details.\n\n## License\n\n**JBird** is available under the [MIT license](https://en.wikipedia.org/wiki/MIT_License). See the [LICENSE](https://github.com/vsanthanam/JBird/blob/main/LICENSE) file for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvsanthanam%2Fjbird","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvsanthanam%2Fjbird","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvsanthanam%2Fjbird/lists"}