# alibaba/HandyJSON

A handy swift json-object serialization/deserialization library

Repository: https://github.com/alibaba/HandyJSON
Canonical: https://ross.abutalabs.com/products/handyjson
Language: Swift
License: NOASSERTION
License Family: other
Topics: swift, json, serialization, json-fields, deserialization, mapping
Last push: 2024-03-08T11:30:52+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3635, "days_push": 908, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4256, forks 677 (observed 2026-08-28T04:08:40.527792+00:00)

## What it is
HandyJSON is a Swift library for serializing and deserializing JSON to and from model objects (pure classes and structs) on iOS. It uses runtime memory layout reflection instead of KVC or manual mapping functions, so models don't need to inherit from NSObject.

## Use cases
- deserialize  into swift structs and classes
- convert model objects to  strings
- map  fields to swift properties without NSObject inheritance
- parse  api responses into typed models
- serialize swift objects with optional and enum properties to

## When to choose
- you want  mapping without NSObject subclasses or boilerplate mapping code
- you need to serialize/deserialize pure Swift classes and structs on iOS
- you work with legacy Swift codebases already using HandyJSON

## When to avoid
- you want a library guaranteed safe against future Swift runtime memory layout changes
- you prefer Codable, the standard Swift approach
- you target platforms other than iOS/macOS with Swift

## Facets
- artifact type: library
- maturity: maintenance
- function: serialization
- domain: mobile-development, developer-tools
- platform: -
- tags: -mapping, reflection, model-serialization, cocoapods, carthage, ios, swift, mobile

## Member repositories
- alibaba/HandyJSON (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:40.527792+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:22:07.897418+00:00, confidence not recorded.
  - readme: https://github.com/alibaba/HandyJSON (fetched 2026-08-28T04:08:40.527792+00:00, sha 6e07691e93f0)
- Data as of 2026-08-30T08:39:29.467469+00:00.