Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(v1): update readme file #169

Merged
merged 2 commits into from
Nov 28, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 19 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,16 @@ PrivX is a lean and modern privileged access management solution to automate you
[![Coverage Status](https://coveralls.io/repos/github/SSHcom/privx-sdk-go/badge.svg?branch=master)](https://coveralls.io/github/SSHcom/privx-sdk-go?branch=master)
[![Go Report Card](https://goreportcard.com/badge/github.com/SSHcom/privx-sdk-go)](https://goreportcard.com/report/github.com/SSHcom/privx-sdk-go)


\
**Jump To**:
[PrivX REST API Reference](https://privx.docs.ssh.com/reference)

# Important Notice: Final Major Release of SDK Version 1

Version 1.37.0 will be the last major release of SDK Version 1.

Starting with the next release, we will intorudce Version 2 of the SDK, which will include significant changes, including breaking changes to backward compatibility.
We will continue to provide critical bug fixes for Version 1, there will be no new features or support for PrivX versions greater than 37 in this version.


## Getting Started

Expand All @@ -37,6 +42,8 @@ func authorize() restapi.Authorizer {
/* the options can be referred from SDK Configuration providers section below*/
restapi.UseConfigFile("config.toml"),
restapi.UseEnvironment(),
// Fallback method, in case base url is not defined in config or env
restapi.BaseURL(url),
)

return oauth.With(
Expand All @@ -55,6 +62,10 @@ func authorize() restapi.Authorizer {
func curl() restapi.Connector {
return restapi.New(
restapi.Auth(authorize())
restapi.UseConfigFile(config),
restapi.UseEnvironment(),
// Fallback method, in case base url is not defined in config or env
restapi.BaseURL(url),
)
}

Expand Down Expand Up @@ -165,15 +176,16 @@ If you experience any issues with the library, please let us know via [GitHub is
* **Reveal** the steps you took to reproduce the problem, include code snippet or links to your project.


## How To Contribute
## How To Contribute to SDK Version 1

The project is [Apache 2.0](LICENSE) licensed and accepts contributions via GitHub pull requests:

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Added some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request
2. Select the Appropriate Branch (`git switch v1`)
3. Create your feature branch (`git switch -c my-new-feature`)
4. Commit your changes (`git commit -am 'Added some feature'`)
5. Push to the branch (`git push origin my-new-feature`)
6. Create new Pull Request


## License
Expand Down