@ondewo/sip-client-angular 4.0.0 → 5.1.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.
@@ -1,86 +0,0 @@
1
- ![Logo](https://raw.githubusercontent.com/ondewo/ondewo-logos/master/github/ondewo_logo_github_2.png)
2
-
3
- # ONDEWO SIP APIs
4
-
5
- This repository contains the original interface definitions of public ONDEWO APIs that support gRPC protocols. Reading the original interface definitions can provide a better understanding of ONDEWO APIs and help you to utilize them more efficiently. You can also use these definitions with open source tools to generate client libraries, documentation, and other artifacts.
6
-
7
- The core componenets of all the client libraries are built directly from files in this repo using [the proto compiler.](https://github.com/ondewo/ondewo-proto-compiler)
8
-
9
- For an end-user, the APIS in this repo function mostly as documentation for the endpoints. For specific implementations, look in the following repos for working implementations:
10
- * [Python](https://github.com/ondewo/ondewo-sip-client-python)
11
-
12
- Please note that some of these implementations are works-in-progress. The repo will make clear the status of the implementation.
13
-
14
- ## Overview
15
-
16
- ONDEWO APIs use [Protocol Buffers](https://github.com/google/protobuf) version 3 (proto3) as their Interface Definition Language (IDL) to define the API interface and the structure of the payload messages. The same interface definition is used for gRPC versions of the API in all languages.
17
-
18
- There are several ways of accessing APIs:
19
-
20
- 1. Protocol Buffers over gRPC: You can access APIs published in this repository through [GRPC](https://github.com/grpc), which is a high-performance binary RPC protocol over HTTP/2. It offers many useful features, including request/response multiplex and full-duplex streaming.
21
-
22
- 2. ONDEWO Client Libraries:
23
- You can use these libraries to access ONDEWO Cloud APIs. They are based on gRPC for better performance and provide idiomatic client surface for better developer experience.
24
-
25
- ## Discussions
26
-
27
- Please use the issue tracker in this repo for discussions about this API, or the issue tracker in the relevant client if it is language-specific.
28
-
29
- ## Repository Structure
30
-
31
- ```
32
- .
33
- ├── CONTRIBUTING.md
34
- ├── LICENSE
35
- ├── ondewo
36
- │   └── sip
37
- │   └── sip.proto
38
- ├── README.md
39
- └── RELEASE.md
40
- ```
41
-
42
- ## Generate gRPC Source Code
43
-
44
- API client libraries can be built directly from files in this repo using [the proto compiler.](https://github.com/ondewo/ondewo-proto-compiler)
45
-
46
- Automatic Release Process
47
- ------------------
48
- The entire process is automated to make development easier. The actual steps are simple:
49
-
50
- TODOs in Pull Request before the release:
51
-
52
- - Update the Version number inside the Makefile
53
-
54
- - Check if RELEASE.md is up-to-date
55
-
56
- TODOs after Pull Request was merged in:
57
-
58
- - Checkout master:
59
- ```bash
60
- git checkout master
61
- ```
62
- - Pull the new stuff:
63
- ```bash
64
- git pull
65
- ```
66
- - Release:
67
- ```bash
68
- make ondewo_release
69
- ```
70
-
71
- The ``` make ondewo_release``` command can be divided into 5 steps:
72
-
73
- - cloning the devops-accounts repository and extracting the credentials
74
- - creating and pushing the release branch
75
- - creating and pushing the release tag
76
- - creating the GitHub release
77
-
78
- The variable for the GitHub Access Token is inside the Makefile,
79
- but the value is overwritten during ``` make ondewo_release```, because
80
- it is passed from the devops-accounts repo as an argument to the actual ```release``` command.
81
-
82
- Proto Documentation
83
- -------------------
84
-
85
- Documentation for the .proto files is generated automatically when there is a pullrequest or push
86
- to master. It is located in the branch [gh-pages](https://github.com/ondewo/ondewo-sip-api/tree/gh-pages).