raml-spec

RAML Specification (by raml-org)

Raml-spec Alternatives

Similar projects and alternatives to raml-spec

NOTE: The number of mentions on this list indicates mentions on common posts plus user suggested alternatives. Hence, a higher number means a better raml-spec alternative or higher similarity.

raml-spec reviews and mentions

Posts with mentions or reviews of raml-spec. We have used some of these posts to build our list of alternatives and similar projects. The last one was on 2023-08-16.
  • Sharing data types on a multi-language project
    3 projects | news.ycombinator.com | 16 Aug 2023
    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
    15 projects | news.ycombinator.com | 30 Jan 2023
    > 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/

Stats

Basic raml-spec repo stats
2
3,862
10.0
about 2 years ago

Sponsored
SaaSHub - Software Alternatives and Reviews
SaaSHub helps you find the best software and product alternatives
www.saashub.com