{"id":26649022,"url":"https://github.com/sottey/shon","last_synced_at":"2026-05-18T03:11:34.762Z","repository":{"id":283889671,"uuid":"953204312","full_name":"sottey/shon","owner":"sottey","description":"SHON (Structured Human-Optimized Notation) is a data serialization format designed for readability, schema support, and practical use in modern systems. Version 0.6 introduces advanced types and syntax improvements.","archived":false,"fork":false,"pushed_at":"2025-03-25T02:14:57.000Z","size":6430,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-06T22:03:34.298Z","etag":null,"topics":["data","golang","json","spec","specification"],"latest_commit_sha":null,"homepage":"","language":"Go","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/sottey.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":"docs/ROADMAP.md","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-03-22T20:05:26.000Z","updated_at":"2025-03-25T02:15:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"e6d93c06-b235-4da8-bc1a-0276b6033a19","html_url":"https://github.com/sottey/shon","commit_stats":null,"previous_names":["sottey/shon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sottey/shon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sottey%2Fshon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sottey%2Fshon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sottey%2Fshon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sottey%2Fshon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sottey","download_url":"https://codeload.github.com/sottey/shon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sottey%2Fshon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33163444,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"online","status_checked_at":"2026-05-18T02:00:06.436Z","response_time":71,"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":["data","golang","json","spec","specification"],"created_at":"2025-03-25T00:47:44.171Z","updated_at":"2026-05-18T03:11:34.753Z","avatar_url":"https://github.com/sottey.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SHON Specification v0.6\n\nSHON (Structured Human-Optimized Notation) is a data serialization format designed for readability, schema support, and practical use in modern systems. Version 0.6 introduces advanced types and syntax improvements.\n\n---\n\n## 🔧 Syntax Features\n\n### ✅ Comments\n- **Single-line**: `// comment here`\n- **Multi-line**: `/* this is a\n   multi-line comment */`\n\n### ✅ Namespaces\n```shon\n@users {\n  ...\n}\n```\n\n### ✅ Field Assignment\n```shon\nkey: value\n```\n\n---\n\n## 📦 Supported Types\n\n| SHON Syntax              | Description                      |\n|--------------------------|----------------------------------|\n| `\"string\"`               | String                           |\n| `42`, `true`, `false`    | Number and boolean               |\n| `$decimal(\"12.34\")`      | Decimal with precision           |\n| `$timestamp(\"2024-01-01T00:00:00Z\")` | ISO 8601 timestamp      |\n| `$tuple(1, \"a\", true)`   | Anonymous tuple                  |\n| `Vec3(1.0, 2.0, 3.0)`    | Named tuple                      |\n| `[1, 2, 3]`              | Array                            |\n| `{ key: value }`         | Map or Struct (based on schema)  |\n| `\u0026ref.to.path`           | Reference                        |\n\n---\n\n## 🧱 Data Structures\n\n### 🔹 Arrays\n```shon\nnumbers: [1, 2, 3]\n```\n\n### 🔹 Maps\n```shon\ntranslations: {\n    en: \"Hello\",\n    es: \"Hola\"\n}\n```\n\n### 🔹 Structs\nStructs look like maps but are validated against a schema with fixed fields.\n```shon\nuser: {\n    name: \"Sean\",\n    active: true\n}\n```\n\n### 🔹 Tuples\n```shon\n$tuple(1, \"a\", true)\nVec3(1.0, 2.0, 3.0) // Named tuple\n```\n\n---\n\n## 🔗 References\n```shon\nmanager: \u0026people.sean\n```\n\n---\n\n## 🕓 Timestamps\n```shon\ncreated: $timestamp(\"2025-03-22T14:30:00Z\")\n```\n\n---\n\n## 💵 Decimals\n```shon\nprice: $decimal(\"19.95\")\n```\n\n---\n\n## 🔄 Example\n```shon\n@invoice {\n    id: \"INV001\",\n    total: $decimal(\"1042.75\"),\n    created: $timestamp(\"2025-03-22T10:00:00Z\"),\n    items: [\n        $tuple(\"Widget\", 3, $decimal(\"9.99\"))\n    ],\n    paid: false\n}\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsottey%2Fshon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsottey%2Fshon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsottey%2Fshon/lists"}