Skip to content

Commit

Permalink
Retract the agreementmanagement module (#352)
Browse files Browse the repository at this point in the history
* Retract the agreementmanagement module

* changelog

* removal of agreement managemnt from config, tests, CI and docs

* version uplift
  • Loading branch information
patrickcping authored Jun 4, 2024
1 parent ee1ba97 commit a02bb96
Show file tree
Hide file tree
Showing 27 changed files with 60 additions and 934 deletions.
1 change: 0 additions & 1 deletion .github/workflows/acceptance-test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,6 @@ jobs:
# Dummy values follow to test the env var defaulting behaviours
PINGONE_REGION_TESTACC: Europe
PINGONE_API_ACCESS_TOKEN: DummyAccessToken
PINGONE_AGREEMENT_MGMT_SERVICE_HOSTNAME: agreement-mgmt.ping-eng.com
PINGONE_API_SERVICE_HOSTNAME: api.ping-eng.com
PINGONE_AUTH_SERVICE_HOSTNAME: auth.ping-eng.com
PINGONE_CLIENT_ID: 7682a4d9-15d6-405a-9fd2-d9e08d3adfbe
Expand Down
1 change: 0 additions & 1 deletion .github/workflows/code-check.yml
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,6 @@ jobs:
matrix:
module:
- '.'
- 'agreementmanagement'
- 'authorize'
- 'credentials'
- 'management'
Expand Down
1 change: 0 additions & 1 deletion .github/workflows/unit-test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,6 @@ jobs:
PINGONE_ENVIRONMENT_ID_TESTACC: ${{ secrets.EU_PINGONE_ENVIRONMENT_ID }}
PINGONE_REGION_TESTACC: Europe
PINGONE_API_ACCESS_TOKEN: testtest
PINGONE_AGREEMENT_MGMT_SERVICE_HOSTNAME: agreement-mgmt.ping-eng.com
PINGONE_API_SERVICE_HOSTNAME: api.ping-eng.com
PINGONE_AUTH_SERVICE_HOSTNAME: auth.ping-eng.com
PINGONE_CLIENT_ID: 9c052a8a-14be-44e4-8f07-2662569994ce
Expand Down
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
# Release (Unreleased)

* `github.com/patrickcping/pingone-go-sdk-v2` : v0.12.0
* **Note** Removal of retracted module `github.com/patrickcping/pingone-go-sdk-v2/agreementmanagement`. [#352](https://github.com/patrickcping/pingone-go-sdk-v2/pull/352)
* `github.com/patrickcping/pingone-go-sdk-v2/agreementmanagement` : [v0.3.2](./agreementmanagement/CHANGELOG.md)
* **MODULE RETRACTION** The API endpoint in this module suffers major loss of function. The module has been retracted but is retained in the source repo for the purpose of retration. [#352](https://github.com/patrickcping/pingone-go-sdk-v2/pull/352)
* `github.com/patrickcping/pingone-go-sdk-v2/authorize` : [v0.5.0](./authorize/CHANGELOG.md)
* **Feature** Add support for Application Resource Permissions API. [#344](https://github.com/patrickcping/pingone-go-sdk-v2/pull/344)
* **Feature** Add support for Application Resources API. [#344](https://github.com/patrickcping/pingone-go-sdk-v2/pull/344)
Expand Down
2 changes: 1 addition & 1 deletion GNUmakefile
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
TEST?=$$(go list ./...)
OWNER=patrickcping
REPO=pingone-go-sdk-v2
VERSION=0.11.9
VERSION=0.12.0

default: build

Expand Down
5 changes: 1 addition & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,6 @@ Code for each service is generated with the help of the [OpenAPI Generator](http

The SDK provides a core package, and a package per PingOne service, each with their own directory off the root of the project:

* **agreementmanagement** - [Documentation](https://pkg.go.dev/github.com/patrickcping/pingone-go-sdk-v2/agreementmanagement) - for the PingOne end-user agreements managements service
* **authorize** - [Documentation](https://pkg.go.dev/github.com/patrickcping/pingone-go-sdk-v2/authorize) - for the PingOne Authorize service
* **credentials** - [Documentation](https://pkg.go.dev/github.com/patrickcping/pingone-go-sdk-v2/credentials) - for the PingOne Credentials service, part of PingOne Neo
* **management** - [Documentation](https://pkg.go.dev/github.com/patrickcping/pingone-go-sdk-v2/management) - for the PingOne platform common and SSO services
Expand Down Expand Up @@ -49,7 +48,6 @@ if err != nil {
```

The result is an object with clients initialised for each service:
* `client.AgreementManagementAPIClient`
* `client.AuthorizeAPIClient`
* `client.CredentialsAPIClient`
* `client.ManagementAPIClient`
Expand All @@ -59,7 +57,7 @@ The result is an object with clients initialised for each service:

In the above, if an `AccessToken` is provided, this will be verified and used. If the `AccessToken` is not provided, the SDK will retrieve an access token from the provided `ClientID`, `ClientSecret`, `EnvironmentID` and `Region` parameters.

The client SDK defaults to production hostnames, and the `Region` is used to add the relevant suffix to the hostname. For example, `Europe` as a `Region` value with suffix the service hostname with `.eu`. Hostnames can be overridden with the optional `APIHostnameOverride`, `AgreementMgmtHostnameOverride`, and `AuthHostnameOverride` parameters.
The client SDK defaults to production hostnames, and the `Region` is used to add the relevant suffix to the hostname. For example, `Europe` as a `Region` value with suffix the service hostname with `.eu`. Hostnames can be overridden with the optional `APIHostnameOverride`, and `AuthHostnameOverride` parameters.

An API call can be made against the API objects, as in the following example to get all environments in a tenant:

Expand All @@ -77,7 +75,6 @@ if err != nil {

Each package is generated from an underlying OpenAPI 3 specification. Currently the OpenAPI 3 specification is stored in the `./<<module>>/generate/pingone-<<module>>.yml` file, although this will be subject to change in the future.

* [**agreementmanagement** OpenAPI 3 Specification file](./authorize/generate/pingone-authorize.yml)
* [**authorize** OpenAPI 3 Specification file](./authorize/generate/pingone-authorize.yml)
* [**credentials** OpenAPI 3 Specification file](./credentials/generate/pingone-credentials.yml)
* [**management** OpenAPI 3 Specification file](./management/generate/pingone-management.yml)
Expand Down
34 changes: 0 additions & 34 deletions agreementmanagement/.openapi-generator-ignore

This file was deleted.

17 changes: 0 additions & 17 deletions agreementmanagement/.openapi-generator/FILES

This file was deleted.

1 change: 0 additions & 1 deletion agreementmanagement/.openapi-generator/VERSION

This file was deleted.

2 changes: 1 addition & 1 deletion agreementmanagement/.version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.3.1
0.3.2
4 changes: 4 additions & 0 deletions agreementmanagement/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
# v0.3.2 (Unreleased)

* **MODULE RETRACTION** The API endpoint in this module suffers major loss of function. The module has been retracted but is retained in the source repo for the purpose of retration. [#352](https://github.com/patrickcping/pingone-go-sdk-v2/pull/352)

# v0.3.1 (2024-01-12)

* **Note** Upgrade GO to `v1.21` [#306](https://github.com/patrickcping/pingone-go-sdk-v2/pull/306)
Expand Down
49 changes: 0 additions & 49 deletions agreementmanagement/GNUmakefile

This file was deleted.

126 changes: 3 additions & 123 deletions agreementmanagement/README.md
Original file line number Diff line number Diff line change
@@ -1,126 +1,6 @@
|![](https://upload.wikimedia.org/wikipedia/commons/thumb/1/17/Warning.svg/156px-Warning.svg.png) | This module contains major loss of function and has been retracted.
|---|---|

# Go API client for agreementmanagement

The PingOne Platform API covering the PingOne Agreement Management service

## Overview
This API client was generated by the [OpenAPI Generator](https://openapi-generator.tech) project. By using the [OpenAPI-spec](https://www.openapis.org/) from a remote server, you can easily generate an API client.

- API version: 2023-06-29
- Package version: 0.3.1
- Build package: org.openapitools.codegen.languages.GoClientCodegen

## Installation

Install the following dependencies:

```shell
go get github.com/stretchr/testify/assert
go get golang.org/x/net/context
```

Put the package under your project folder and add the following in import:

```golang
import agreementmanagement "github.com/patrickcping/pingone-go-sdk-v2/agreementmanagement"
```

To use a proxy, set the environment variable `HTTP_PROXY`:

```golang
os.Setenv("HTTP_PROXY", "http://proxy_name:proxy_port")
```

## Configuration of Server URL

Default configuration comes with `Servers` field that contains server objects as defined in the OpenAPI specification.

### Select Server Configuration

For using other server than the one defined on index 0 set context value `sw.ContextServerIndex` of type `int`.

```golang
ctx := context.WithValue(context.Background(), agreementmanagement.ContextServerIndex, 1)
```

### Templated Server URL

Templated server URL is formatted using default variables from configuration or from context value `sw.ContextServerVariables` of type `map[string]string`.

```golang
ctx := context.WithValue(context.Background(), agreementmanagement.ContextServerVariables, map[string]string{
"basePath": "v2",
})
```

Note, enum values are always validated and all unused variables are silently ignored.

### URLs Configuration per Operation

Each operation can use different server URL defined using `OperationServers` map in the `Configuration`.
An operation is uniquely identified by `"{classname}Service.{nickname}"` string.
Similar rules for overriding default operation server index and variables applies by using `sw.ContextOperationServerIndices` and `sw.ContextOperationServerVariables` context maps.

```golang
ctx := context.WithValue(context.Background(), agreementmanagement.ContextOperationServerIndices, map[string]int{
"{classname}Service.{nickname}": 2,
})
ctx = context.WithValue(context.Background(), agreementmanagement.ContextOperationServerVariables, map[string]map[string]string{
"{classname}Service.{nickname}": {
"port": "8443",
},
})
```

## Documentation for API Endpoints

All URIs are relative to *https://agreement-mgmt.pingone.com*

Class | Method | HTTP request | Description
------------ | ------------- | ------------- | -------------
*AgreementRevisionsResourcesApi* | [**ReadOneAgreementLanguageRevision**](docs/AgreementRevisionsResourcesApi.md#readoneagreementlanguagerevision) | **Get** /environments/{environmentID}/agreements/{agreementID}/languages/{languageID}/revisions/{revisionID}.json | READ One Agreement Language Revision


## Documentation For Models

- [AgreementRevisionText](docs/AgreementRevisionText.md)
- [P1Error](docs/P1Error.md)
- [P1ErrorDetailsInner](docs/P1ErrorDetailsInner.md)
- [P1ErrorDetailsInnerInnerError](docs/P1ErrorDetailsInnerInnerError.md)


## Documentation For Authorization


Authentication schemes defined for the API:
### bearer

- **Type**: HTTP Bearer token authentication

Example

```golang
auth := context.WithValue(context.Background(), sw.ContextAccessToken, "BEARER_TOKEN_STRING")
r, err := client.Service.Operation(auth, args)
```


## Documentation for Utility Methods

Due to the fact that model structure members are all pointers, this package contains
a number of utility functions to easily obtain pointers to values of basic types.
Each of these functions takes a value of the given basic type and returns a pointer to it:

* `PtrBool`
* `PtrInt`
* `PtrInt32`
* `PtrInt64`
* `PtrFloat`
* `PtrFloat32`
* `PtrFloat64`
* `PtrString`
* `PtrTime`

## Author



Loading

0 comments on commit a02bb96

Please sign in to comment.