Skip to content

Commit d7ce98c

Browse files
committed
testdata: a case per response enum, carrying a value no list holds
The shared corpus gains a vocabulary section: an answer per response enum (the plan's tier, a database's standing, license type and format, a download's outcome and format) carrying a value no published list holds, plus the plan's name. A binding reads it back as served once it hands such a value back rather than failing the call.
1 parent 912b87e commit d7ce98c

1 file changed

Lines changed: 225 additions & 0 deletions

File tree

‎testdata/testdata.json‎

Lines changed: 225 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13794,6 +13794,231 @@
1379413794
]
1379513795
}
1379613796
},
13797+
"vocabulary": {
13798+
"why": "A closed vocabulary in an ANSWER (a plan's tier, a database's standing and license type, a format, a download's outcome) is the API's to extend. Each case serves a well-formed answer carrying a value no published list holds, and the call must hand that value back as served, a raw string or an unknown case that carries it, and never fail: a binding that refuses it breaks every installed copy of itself the day the API adds a value, and a release cannot reach the copies already installed. A wrong TYPE (a number, a null where the member is required) is still refused, and refusing an unpublished value in a REQUEST before the network is unchanged. Each `expect` key is a path through the answer's wire names, a number indexing a list; each suite reads it through its own typed result. A binding that still fails the call on one reads none of these cases until its release that hands the value back.",
13799+
"cases": [
13800+
{
13801+
"name": "entitlement-plan-name",
13802+
"why": "The plan's name is what a client shows, and key is what it compares: the free plan's key is free and its name Unlimited. A binding that drops name leaves a client building one from the key, which a renamed plan then gets wrong.",
13803+
"call": "myEntitlement",
13804+
"answer": {
13805+
"org_id": "85bb51e4-2eb6-4a31-8e4d-02ba8b98fe61",
13806+
"apikey": {
13807+
"id": "0ab424cc-7619-4dad-b027-afacdc2cedb0",
13808+
"expires": null,
13809+
"allowed_cidrs": []
13810+
},
13811+
"plan": {
13812+
"key": "free",
13813+
"name": "Unlimited",
13814+
"tier": "free"
13815+
},
13816+
"usage": {
13817+
"requests": 580,
13818+
"quota": 5000000,
13819+
"hard_limit": null,
13820+
"window_start": "2026-11-01T00:00:00Z",
13821+
"window_end": "2026-12-01T00:00:00Z"
13822+
}
13823+
},
13824+
"expect": {
13825+
"plan.key": "free",
13826+
"plan.name": "Unlimited",
13827+
"plan.tier": "free"
13828+
}
13829+
},
13830+
{
13831+
"name": "entitlement-tier-unknown",
13832+
"why": "A plan whose tier no published list holds: the answer reads, and the tier comes back as served.",
13833+
"call": "myEntitlement",
13834+
"answer": {
13835+
"org_id": "85bb51e4-2eb6-4a31-8e4d-02ba8b98fe61",
13836+
"apikey": {
13837+
"id": "0ab424cc-7619-4dad-b027-afacdc2cedb0",
13838+
"expires": null,
13839+
"allowed_cidrs": []
13840+
},
13841+
"plan": {
13842+
"key": "data",
13843+
"name": "Data",
13844+
"tier": "data"
13845+
},
13846+
"usage": {
13847+
"requests": 580,
13848+
"quota": 5000000,
13849+
"hard_limit": null,
13850+
"window_start": "2026-11-01T00:00:00Z",
13851+
"window_end": "2026-12-01T00:00:00Z"
13852+
}
13853+
},
13854+
"expect": {
13855+
"plan.key": "data",
13856+
"plan.name": "Data",
13857+
"plan.tier": "data"
13858+
}
13859+
},
13860+
{
13861+
"name": "database-standing-unknown",
13862+
"why": "A database whose standing no published list holds: the catalog reads, and the standing comes back as served.",
13863+
"call": "listDatabases",
13864+
"answer": {
13865+
"databases": [
13866+
{
13867+
"base": "bogon_asn",
13868+
"name": "Bogon ASN",
13869+
"summary": "Every reserved or unallocated AS number.",
13870+
"standing": "suspended",
13871+
"open": true,
13872+
"license_type": "standard",
13873+
"starts": "2026-01-01T00:00:00Z",
13874+
"expires": null,
13875+
"renews_at": null,
13876+
"notice_due_at": null,
13877+
"versions": [
13878+
{
13879+
"id": "bogon_asn_v1",
13880+
"version": 1,
13881+
"summary": "The ASN and its reason.",
13882+
"formats": [
13883+
"csvgz",
13884+
"mmdb"
13885+
]
13886+
}
13887+
]
13888+
}
13889+
]
13890+
},
13891+
"expect": {
13892+
"databases.0.base": "bogon_asn",
13893+
"databases.0.standing": "suspended"
13894+
}
13895+
},
13896+
{
13897+
"name": "database-license-type-unknown",
13898+
"why": "A license type no published list holds: the catalog reads, and the license type comes back as served.",
13899+
"call": "listDatabases",
13900+
"answer": {
13901+
"databases": [
13902+
{
13903+
"base": "bogon_asn",
13904+
"name": "Bogon ASN",
13905+
"summary": "Every reserved or unallocated AS number.",
13906+
"standing": "licensed",
13907+
"open": true,
13908+
"license_type": "oem",
13909+
"starts": "2026-01-01T00:00:00Z",
13910+
"expires": null,
13911+
"renews_at": null,
13912+
"notice_due_at": null,
13913+
"versions": [
13914+
{
13915+
"id": "bogon_asn_v1",
13916+
"version": 1,
13917+
"summary": "The ASN and its reason.",
13918+
"formats": [
13919+
"csvgz",
13920+
"mmdb"
13921+
]
13922+
}
13923+
]
13924+
}
13925+
]
13926+
},
13927+
"expect": {
13928+
"databases.0.base": "bogon_asn",
13929+
"databases.0.license_type": "oem"
13930+
}
13931+
},
13932+
{
13933+
"name": "database-format-unknown",
13934+
"why": "A version offered in a format no published list holds: the catalog reads, and the format comes back as served beside the known one. Asking for it is still refused before the network.",
13935+
"call": "listDatabases",
13936+
"answer": {
13937+
"databases": [
13938+
{
13939+
"base": "bogon_asn",
13940+
"name": "Bogon ASN",
13941+
"summary": "Every reserved or unallocated AS number.",
13942+
"standing": "licensed",
13943+
"open": true,
13944+
"license_type": "standard",
13945+
"starts": "2026-01-01T00:00:00Z",
13946+
"expires": null,
13947+
"renews_at": null,
13948+
"notice_due_at": null,
13949+
"versions": [
13950+
{
13951+
"id": "bogon_asn_v1",
13952+
"version": 1,
13953+
"summary": "The ASN and its reason.",
13954+
"formats": [
13955+
"csvgz",
13956+
"parquet"
13957+
]
13958+
}
13959+
]
13960+
}
13961+
]
13962+
},
13963+
"expect": {
13964+
"databases.0.versions.0.formats.0": "csvgz",
13965+
"databases.0.versions.0.formats.1": "parquet"
13966+
}
13967+
},
13968+
{
13969+
"name": "download-outcome-unknown",
13970+
"why": "A download whose outcome no published list holds: the log reads, and the outcome comes back as served.",
13971+
"call": "listDownloads",
13972+
"answer": {
13973+
"downloads": [
13974+
{
13975+
"dataset_id": "bogon_asn_v1",
13976+
"format": "csvgz",
13977+
"outcome": "throttled",
13978+
"sample": false,
13979+
"open": true,
13980+
"bytes": null,
13981+
"http_status": 429,
13982+
"apikey_id": null,
13983+
"client_ip": null,
13984+
"user_agent": null,
13985+
"created": "2026-11-17T10:00:00Z"
13986+
}
13987+
]
13988+
},
13989+
"expect": {
13990+
"downloads.0.dataset_id": "bogon_asn_v1",
13991+
"downloads.0.outcome": "throttled"
13992+
}
13993+
},
13994+
{
13995+
"name": "download-format-unknown",
13996+
"why": "A download in a format no published list holds: the log reads, and the format comes back as served.",
13997+
"call": "listDownloads",
13998+
"answer": {
13999+
"downloads": [
14000+
{
14001+
"dataset_id": "bogon_asn_v1",
14002+
"format": "parquet",
14003+
"outcome": "ok",
14004+
"sample": false,
14005+
"open": true,
14006+
"bytes": 760,
14007+
"http_status": 302,
14008+
"apikey_id": null,
14009+
"client_ip": null,
14010+
"user_agent": null,
14011+
"created": "2026-11-17T10:00:00Z"
14012+
}
14013+
]
14014+
},
14015+
"expect": {
14016+
"downloads.0.dataset_id": "bogon_asn_v1",
14017+
"downloads.0.format": "parquet"
14018+
}
14019+
}
14020+
]
14021+
},
1379714022
"bogons": {
1379814023
"v4": [
1379914024
"0.0.0.0/8",

0 commit comments

Comments
 (0)