amf-client-js 0.0.1-oidc-test-SNAPSHOT.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +95 -0
- package/amf.js +11867 -0
- package/bin/amf +5 -0
- package/package.json +23 -0
- package/typings/amf-client-js.d.ts +9857 -0
package/README.md
ADDED
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
[](https://github.com/aml-org/amf/blob/master/LICENSE) [](https://jenkins.build.msap.io/job/application/job/AMF/job/amf/job/master/) [](https://github.com/aml-org/amf/releases)
|
|
2
|
+
|
|
3
|
+
# AML Modeling Framework
|
|
4
|
+
AMF (AML Modeling Framework) is an open-source programming framework, capable of parsing, generating and validating metadata documents defined using [AML](https://a.ml/aml-spec). It can be used as a library in Scala, Java, or JavaScript projects. The modular design of AMF facilitates creating plugins capable of parsing other metadata syntaxes not defined by AML.
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
# 📃 Documentation
|
|
8
|
+
- [The AML Project](https://a.ml)
|
|
9
|
+
- [AMF Documentation website](https://a.ml/docs)
|
|
10
|
+
- [AMF model documentation](./documentation/model.md)
|
|
11
|
+
- [GitHub repository of AMF code examples](https://github.com/aml-org/examples)
|
|
12
|
+
|
|
13
|
+
# 📦 Artifacts
|
|
14
|
+
[](https://www.npmjs.com/package/amf-client-js)
|
|
15
|
+
[](https://repository-master.mulesoft.org/nexus/content/repositories/releases/com/github/amlorg/amf-api-contract_2.12)
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
## Gradle
|
|
19
|
+
```groovy
|
|
20
|
+
// add mulesoft repository
|
|
21
|
+
repositories {
|
|
22
|
+
maven {
|
|
23
|
+
url 'https://repository-master.mulesoft.org/nexus/content/repositories/releases'
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
dependencies {
|
|
27
|
+
compile 'com.github.amlorg:amf-api-contract_2.12:x.y.z'
|
|
28
|
+
}
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## Maven
|
|
32
|
+
```xml
|
|
33
|
+
<dependency>
|
|
34
|
+
<groupId>com.github.amlorg</groupId>
|
|
35
|
+
<artifactId>amf-api-contract_2.12</artifactId>
|
|
36
|
+
<version>x.y.z</version>
|
|
37
|
+
</dependency>
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
NOTE: you may use the `-SNAPSHOT` versions of the artifacts at your own risk since those snapshot versions may contain breaking changes.
|
|
41
|
+
|
|
42
|
+
## JavaScript
|
|
43
|
+
```bash
|
|
44
|
+
$ npm install --save amf-client-js
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Generate artifacts directly from cloned repository
|
|
48
|
+
|
|
49
|
+
To build into a JVM jar:
|
|
50
|
+
```sh
|
|
51
|
+
sbt package
|
|
52
|
+
```
|
|
53
|
+
To build into a JS bundle:
|
|
54
|
+
```sh
|
|
55
|
+
sh js-build.sh
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
More info on how to add AMF to your project [here](https://a.ml/docs/amf/using-amf/amf_setup).
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
# AMF Native support
|
|
62
|
+
|
|
63
|
+
AMF natively supports the following formats:
|
|
64
|
+
- YAML
|
|
65
|
+
- JSON
|
|
66
|
+
|
|
67
|
+
the following semantic models:
|
|
68
|
+
- WebApi (or "Web APIs" as in "APIs accessible over the network")
|
|
69
|
+
- AsyncApi
|
|
70
|
+
|
|
71
|
+
and the following syntactic models:
|
|
72
|
+
- JSON-LD "AMF model"
|
|
73
|
+
- RAML 0.8 / 1.0 (mapped to "WebApi")
|
|
74
|
+
- OpenAPI (OAS) 2.0 / 3.0 (mapped to "WebApi")
|
|
75
|
+
- AsyncAPI 2.0 (mapped to "AsyncApi")
|
|
76
|
+
|
|
77
|
+
The models above and any other models may be extended and supported via custom [AML-defined models](https://a.ml/aml-spec). Other formats and models that cannot be expressed with AML may also be supported via plugins.
|
|
78
|
+
|
|
79
|
+
## Guaranteed output
|
|
80
|
+
|
|
81
|
+
The **only** guaranteed output of AMF is the JSON-LD "AMF model". Any other output such as any output provided natively by the models listed under the section above may change at any time. This means that while the semantic representation of those outputs may remain unchanged, the syntactical expression such as the order in which the outputted metadata is expressed and any other syntax-related constructs may change from one version of AMF to another. If this is an issue for your use-case, you may consider using a custom resolution/generation pipeline.
|
|
82
|
+
|
|
83
|
+
# AMF ecosystem modules
|
|
84
|
+
The following image shows each module in the AMF ecosystem as a dependency graph.
|
|
85
|
+
|
|
86
|
+
For AMF adopters it is recommended to use the `amf-api-contract` module which contains transitive dependencies with every
|
|
87
|
+
module in the ecosystem except the CLI. For AML adopters (with no Web API nor Custom validation features usage) it is recommended to
|
|
88
|
+
adopt the `amf-aml` module which includes parsing, validation & resolution for AML documents only. For more details on
|
|
89
|
+
AML visit the [AML repository]("https://github.com/aml-org/amf-aml").
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
The `amf-api-contract` and `amf-aml` are the recommended modules for AMF and AML adopters respectively.
|
|
93
|
+
|
|
94
|
+
## Contributing
|
|
95
|
+
If you are interested in contributing to this project, please make sure to read our [contributing guidelines](./CONTRIBUTING.md).
|