raml-spec | open-kun | |
---|---|---|
2 | 10 | |
3,862 | 3 | |
- | - | |
10.0 | 8.0 | |
about 2 years ago | about 1 year ago | |
JavaScript | ||
- | MIT License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
raml-spec
-
Sharing data types on a multi-language project
Taking this concept further one could model in RAML [0] to define both the types (flat or nested) and api definitions. It's based on YAML 1.2 with enough maturity to provide capabilities such as union types, extensions, includes, user-defined facets, etc.
The AMF project [1] can be used to parse and transform to/from RAML, OpenAPI, GraphQL, and json schema. Code generation to languages of choice can be bolted on from there.
I'm using this approach to define canonical data models. Subsequent code generation scaffolds internal application integration apis, master data management (MDM) entities, and SQL/OLAP artifacts for ETL / BI purposes.
This approach keeps overall end-to-end data architecture consistent, in sync, and versioned under source control. Additionally, flat types as required by relational systems are re-used and composed into nested complex types more appropriate for apis. Metadata is layered on as needed to refine the models for system-specific needs, for example to add user-facing field groups, descriptions, and formats for BI datasets, sensitivity levels and other data security controls, business rule definitions for MDM, etc.
[0] https://github.com/raml-org/raml-spec/blob/master/versions/r...
-
Ask HN: Do you use JSON Schema? Help us shape its future stability guarantees
> Do you use JSON Schema?
At one point I did, but then discovered RAML[0] and it subsumed the value of what JSON Schema provides as well as being easier to work with than OpenAPI[1]. Also, generating JSON Schema from RAML definitions has proven to be a fairly straightforward process.
The usual caveats apply... Your mileage may vary, my experiences do not speak for any others, my opinion does not detract from the value of JSON Schema, etc.
0 - https://github.com/raml-org/raml-spec/blob/master/versions/r...
1 - https://swagger.io/specification/
open-kun
-
A social media platform for muslims
Al-Kun - A Muslim Social Media
-
Al-Kun - An Open Muslim Social Media
Al-Kun is a new Social Media platform for Muslims. We branded this as an Open Platform, so what does this mean? Check list of al-Kun characteristics below:
-
Alkun.org, a Privacy First Muslim community platform.
Update 4: Small update (since I'm on a vacation now), last 2 days I been working on a new DSL to improve Bayan language. There are couple of reasons for that but most important one is it's becoming tedious, long JSON document is not fun to work with. So I created a more compact DSL on top of existing JSON schema, oh, I also did removed some troublesome features like enumerated Keys, wildcard keys and multiple types support. The parser and generator is done, only need to fix the validator function (remove the features mentioned). I'll explain more when I get back, in meantime you can check the documentation here. Jazakallah khair.
Certainly not what the cool kids are using. The server is in Typescript (Deno), libraries and APIs mostly in Javascript (ES6) using custom API specification. The plan is so anyone can quickly and easily create an API. It is open source for contribution in 2 stages, first is the open API services, second stage will be the engine that running the API (which anybody can implement themselves in any language of their choice tbh).
Al-Kun will try to serve most if not all APIs submitted to Open-Kun repo. Main benefits here is many will see and correct/validate data/algorithm on the public repo.
- Ask HN: Do you use JSON Schema? Help us shape its future stability guarantees
- Need an advice on my schema language.
-
Yet another schema definition language (experimental).
Specification (Readme)
-
Small Update for Al-Kun project.
https://github.com/alkun-org/open-kun => source codes
What are some alternatives?
alterschema - Convert between JSON Schema specification versions.
schema-dts - JSON-LD TypeScript types for Schema.org vocabulary
laminar - OpenApi backed REST APIs. Automatic validation of request / response based on the api schema.
library-recommendations - Evaluating Open Source libraries for particular purposes
alt-schema - Flat JSON Schema specification and basic utility methods
OpenMetadata - Open Standard for Metadata. A Single place to Discover, Collaborate and Get your data right.
surrealdb - A scalable, distributed, collaborative, document-graph database, for the realtime web
cue - The home of the CUE language! Validate and define text-based and dynamic configuration
open-kun-data - Al-Kun Open Data