Skip to content

xingzengliu/groupsharekit.net

 
 

Repository files navigation

GroupShareKit - GroupShare Rest API Client Library for .NET

NuGet Stats Build Status

GroupShareKit is a client library targeting .NET 4.6 and above that provides an easy way to interact with GroupShare Rest API

Usage examples

Get all users available in Groupshare.

var groupShareClient = await GroupShareClient.AuthenticateClient(userName,
                password,
                new Uri("http://yourgroupshareaddress"),
                GroupShareClient.AllScopes);

var users = await groupShareClient.User.GetAllUsers();

foreach (var user in users)
{
    Console.WriteLine(user.DisplayName +" loves Groupshare!");
}

Supported platforms

  • .NET 4.6.1 (Desktop / Server)
  • .NET Core 1.0
  • Mono 4.6
  • Windows 10 Store Apps
  • Xamarin.iOS 10
  • Xamarin.Android 7
  • GroupShare 2017

Getting started

GroupShareKit is available on NuGet.

Install-Package GroupShareKit

Documentation

Please see http://gs2017dev.sdl.com:41234/documentation/api/index#/ for details about the GroupShare Rest API. Please see http://gs2017dev.sdl.com:41235/docs/ui/index#/ for details about the Translation Memory Service.

Build

GroupShareKit is a single assembly designed to be easy to deploy anywhere. If you prefer to compile it yourself, you'll need:

*Visual Studio 2015 *Windows 8.1 or higher to build and test windows store projects

To clone it locally click the "Clone in Desktop" button above or run the following git commands:

http://gs2017dev.sdl.com:41234/documentation/api/index#/
cd groupsharekit.net
.\build.cmd

Contribute

You can clone this repository locally from GitHub using the "Clone in Desktop" button from the main project site, or run this command in the Git Shell:

git clone git@github.com:sdl/groupsharekit.net.git

If you want to make contributions to the project, forking the project is the easiest way to do this.

After doing that, run the .\build.cmd script at the root of the repository to ensure all the tests pass.

Running integration tests

GroupShareKit has integration tests that access the GroupShare Rest API, but they must be configured before they will be executed.

Note: To run the tests, we highly recommend you create a test GroupShare account (i.e., don't use your real GroupShare account) and a test organization owned by that account. Then set the following environment variables:

GROUPSHAREKIT_USERNAME (set this to the test account's username) GROUPSHAREKIT_PASSWORD (set this to the test account's password) GROUPSHAREKIT_TESTORGANIZATION (set this to the test account's organization) GROUPSHAREKIT_SERVERNAME (set this to your sql server name) GROUPSHAREKIT_BASEURI (set this to the url of your GroupShare instance) GROUPSHAREKIT_BEARERID (optional, set to additional BearerId added to requests. If not provided, default connection is used)

Once these are set, the integration tests will be executed both when running the IntegrationTests MSBuild target, and when running the Sdl.Community.GroupShareKit.Tests.Integration assembly through an xUnit.net-friendly test runner.

Problems?

If you find an issue please visit the issue tracker and report the issue.

Please be kind and search to see if the issue is already logged before creating a new one. If you're pressed for time, log it anyways.

When creating an issue, clearly explain

  • What you were trying to do.
  • What you expected to happen.
  • What actually happened.
  • Steps to reproduce the problem.

Also include any other information you think is relevant to reproduce the problem.

Copyright and License

Copyright 2018 SDL plc.

Licensed under the MIT License

About

A GroupShare API client library for .NET

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 100.0%