July update 2018 - Add Activity API PUT functionality (#288)

* Fixed typo and broken link (#275)
* Fixes issue #274
* Fixed link to the Graph authorization docs. Also fixed some code formatting issues.
* Update MSAL to 1.1.2-preview (#235)
* removing Windows.Forms referencee
* Updated System.Net.Http from 4.3.1 to 4.3.3 (#279)
* Adding PUT support and functional tests for Activity Feed Service API (#281) (#284)
* Moving files under Requests/Extensions
* Fixing namespace in tests
* Turning off signing in repo, adding public key file  (#283)
* Make public key accessible for automation

Author: MIchaelMainer

.gitignore

@@ -3,7 +3,7 @@
 *.user
 *.userosscache
 *.sln.ide
-*.snk
+#*.snk
 TestResults/*
 .vs/*
 

docs/overview.md

@@ -26,21 +26,20 @@ To begin making requests with the library, you will need to initialize a **Graph
 
 ## IAuthenticationProvider
 
-The authentication provider is responsible for authenticating requests before sending them to the service. The Microsoft Graph .NET Client Library doesn't implement any authentication by default. Instead, you will need to retrieve access tokens for the service via the authentication library of your choice or by coding against one of the authentication endpoints directly. Please [read here](https://graph.microsoft.io/en-us/docs/authorization/app_authorization) for more details about authenticating the Microsoft Graph service.
+The authentication provider is responsible for authenticating requests before sending them to the service. The Microsoft Graph .NET Client Library doesn't implement any authentication by default. Instead, you will need to retrieve access tokens for the service via the authentication library of your choice or by coding against one of the authentication endpoints directly. Please [read here](https://developer.microsoft.com/en-us/graph/docs/concepts/auth_overview) for more details about authenticating the Microsoft Graph service.
 
 ### DelegateAuthenticationProvider
 
 The `DelegateAuthenticationProvider` is an implementation of `IAuthenticationProvider` that accepts a delegate to call during `AuthenticateRequestAsync`. This is the simplest way to append a retrieved access token to a request message:
 
-```csharp
-    var graphserviceClient = new GraphServiceClient(
-        new DelegateAuthenticationProvider(
-            (requestMessage) =>
-            {
-                requestMessage.Headers.Authorization = new AuthenticationHeaderValue("bearer", accessToken);
+``` csharp
+var graphServiceClient = new GraphServiceClient(new DelegateAuthenticationProvider((requestMessage) => {
+    requestMessage
+        .Headers
+        .Authorization = new AuthenticationHeaderValue("bearer", accessToken);
 
-                return Task.FromResult(0);
-            }));
+    return Task.FromResult(0);
+}));
 ```
 
 
@@ -77,21 +76,21 @@ After you build the request you call the `Request` method on the request builder
 
 For /me/calendar you call:
 
-```csharp
+``` csharp
 var calendarRequest = graphServiceClient
-                      .Me
-					  .Calendar
-					  .Request();
+    .Me
+    .Calendar
+    .Request();
 ```
 
 All request builders have a `Request` method that can generate a request object. Request objects may have different methods on them depending on the type of request. To get /me/calendar you call:
 
-```csharp
+``` csharp
 var calendar = await graphServiceClient
-                     .Me
-					 .Calendar
-					 .Request()
-					 .GetAsync();
+    .Me
+    .Calendar
+    .Request()
+    .GetAsync();
 ```
 
 Any errors while building or sending a request will bubble up as a `ServiceException`. See [errors](/docs/errors.md) for more information on errors.
@@ -100,12 +99,12 @@ Any errors while building or sending a request will bubble up as a `ServiceExcep
 
 If you only want to retrieve certain properties of a resource you can select them. Here's how to get only the ID of the me object:
 
-```csharp
+``` csharp
 var user = await graphServiceClient
-                     .Me
-					 .Request()
-					 .Select("id")
-					 .GetAsync();
+    .Me
+    .Request()
+    .Select("id")
+    .GetAsync();
 ```
 
 All properties other than `Id` will be null on the returned user object.
@@ -116,7 +115,7 @@ Expand, Skip, Top, OrderBy, and Filter are also supported via the client library
 
 If you need to include more specific behavior during a request that is not supported by the library, you can create a custom queryOptions List that you can add when calling ```Request```:
 
-```chsarp
+``` chsarp
 List<QueryOption> options = new List<QueryOption>
 {
      new QueryOption("$search", "lunch")
@@ -134,7 +133,7 @@ Please see [collections](/docs/collections.md) for details on collections and pa
 
 Sometimes, the functionality that you want to use isn't a part of the .NET client library. In this case, you can still use the client library to make your life easier. The client library can authenticate your requests and provide you the serializers. Here's an example of using the client library to create a OneNote page and deserialize the response object. 
 
-```csharp
+``` csharp
 
 public async Task OneNoteAddPageHtml()
 {

src/Microsoft.Graph.Core/35MSSharedLib1024.snk

@@ -3,22 +3,21 @@
     <Description>Microsoft Graph Core Client Library implements core functionality used by Microsoft Graph Client Libraries.</Description>
     <Copyright>Copyright (c) Microsoft Corporation</Copyright>
     <AssemblyTitle>Microsoft Graph Core Client Library</AssemblyTitle>
-    <VersionPrefix>1.9.0</VersionPrefix>
-    <FileVersion>1.9.0</FileVersion>
-    <AssemblyVersion>1.9.0</AssemblyVersion>
+    <VersionPrefix>1.10.0</VersionPrefix>
+    <FileVersion>1.10.0</FileVersion>
+    <AssemblyVersion>1.10.0</AssemblyVersion>
     <Authors>Microsoft</Authors>
     <TargetFrameworks>netstandard1.1;net45</TargetFrameworks>
     <PreserveCompilationContext>false</PreserveCompilationContext>
     <AssemblyName>Microsoft.Graph.Core</AssemblyName>
     <PackageId>Microsoft.Graph.Core</PackageId>
     <PackageTags>Microsoft Office365;Graph;GraphServiceClient;Outlook;OneDrive;AzureAD;GraphAPI;Productivity;SharePoint;Intune;SDK</PackageTags>
     <PackageReleaseNotes>
-May 2018 Release Summary (version 1.9.0)
+July 2018 Release Summary (version 1.10.0)
 
 New features
-- Added more comments.
-- Added response headers and status to all calls that return a non-stream object.
-- Added SerializeObject method to MockSerializer.
+- Added the ability to append an arbitrary URL segment to a request. This will support the creation of custom requests.
+- Set signing properties in .csproj to be 'false' by default.
     </PackageReleaseNotes>
     <PackageProjectUrl>https://developer.microsoft.com/graph</PackageProjectUrl>
     <PackageLicenseUrl>http://aka.ms/devservicesagreement</PackageLicenseUrl>
@@ -34,11 +33,11 @@ New features
     <GenerateAssemblyVersionAttribute>false</GenerateAssemblyVersionAttribute>
     <GenerateAssemblyFileVersionAttribute>false</GenerateAssemblyFileVersionAttribute>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
-    <SignAssembly>False</SignAssembly>
-    <DelaySign>True</DelaySign>
+    <SignAssembly>false</SignAssembly>
+    <DelaySign>false</DelaySign>
     <AssemblyOriginatorKeyFile>35MSSharedLib1024.snk</AssemblyOriginatorKeyFile>
     <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
-    <Version>1.9.0</Version>
+    <Version>1.10.0</Version>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|netstandard1.1|AnyCPU'">
     <DocumentationFile>bin\Release\netstandard1.1\Microsoft.Graph.Core.xml</DocumentationFile>

src/Microsoft.Graph.Core/Microsoft.Graph.Core.csproj

@@ -24,8 +24,8 @@
 //
 // You can specify all the values or you can default the Build and Revision Numbers
 // by using the '*' as shown below:
-[assembly: AssemblyVersion("1.9.0")]
-[assembly: AssemblyFileVersion("1.9.0.0")]
+[assembly: AssemblyVersion("1.10.0")]
+[assembly: AssemblyFileVersion("1.10.0.0")]
 
 #if DEBUG
 [assembly: InternalsVisibleTo("Microsoft.Graph.Core.Test")]

src/Microsoft.Graph.Core/Properties/AssemblyInfo.cs

@@ -302,6 +302,16 @@ public HttpRequestMessage GetHttpRequestMessage()
             return request;
         }
 
+        /// <summary>
+        /// Gets a URL that is the request builder's request URL with the segment appended.
+        /// </summary>
+        /// <param name="urlSegment">The segment to append to the request URL.</param>
+        /// <returns>A URL that is the request builder's request URL with the segment appended.</returns>
+        public void AppendSegmentToRequestUrl(string urlSegment)
+        {
+            this.RequestUrl = string.Format("{0}/{1}", this.RequestUrl, urlSegment);
+        }
+
         /// <summary>
         /// Builds the query string for the request from the query option collection.
         /// </summary>

src/Microsoft.Graph.Core/Requests/BaseRequest.cs

@@ -3,28 +3,21 @@
     <Description>Microsoft Graph Client Library allows you to call Office 365, Azure AD and other Microsoft services through a single unified developer experience.</Description>
     <Copyright>Copyright (c) Microsoft Corporation</Copyright>
     <AssemblyTitle>Microsoft Graph Client Library</AssemblyTitle>
-    <VersionPrefix>1.9.0</VersionPrefix>
-    <FileVersion>1.9.0</FileVersion>
-    <AssemblyVersion>1.9.0</AssemblyVersion>
+    <VersionPrefix>1.10.0</VersionPrefix>
+    <FileVersion>1.10.0</FileVersion>
+    <AssemblyVersion>1.10.0</AssemblyVersion>
     <Authors>Microsoft</Authors>
     <TargetFrameworks>netstandard1.1;net45</TargetFrameworks>
     <PreserveCompilationContext>false</PreserveCompilationContext>
     <AssemblyName>Microsoft.Graph</AssemblyName>
     <PackageId>Microsoft.Graph</PackageId>
     <PackageTags>Microsoft Office365;Graph;GraphServiceClient;Outlook;OneDrive;AzureAD;GraphAPI;Productivity;SharePoint;Intune;SDK</PackageTags>
     <PackageReleaseNotes>
-May 2018 Release Summary (version 1.9.0)
+July 2018 Release Summary (version 1.10.0)
 
-New features
-- Added more comments.
-- UserActivity - apps can push information to the user's timeline.
-- Updated timezone information.
-- Updates to Intune functionality.
-- New Outlook functionality which includes an OutlookUser object, categories, coordinates, message rules, and working hours.
-- New OneNote functionality which includes a notebook's site collection.
-
-Bug fixes
-- Fixed Site GetByPath
+- Updated reference to System.Net.Http to address a vulnerability and issue with .Net &gt;=4.7.2.
+- Set signing properties in .csproj to be 'false' by default.
+- Added custom request builders that help add user activity and history.
     </PackageReleaseNotes>
     <PackageProjectUrl>https://developer.microsoft.com/graph</PackageProjectUrl>
     <PackageLicenseUrl>http://aka.ms/devservicesagreement</PackageLicenseUrl>
@@ -40,11 +33,11 @@ Bug fixes
     <GenerateAssemblyVersionAttribute>false</GenerateAssemblyVersionAttribute>
     <GenerateAssemblyFileVersionAttribute>false</GenerateAssemblyFileVersionAttribute>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
-    <SignAssembly>False</SignAssembly>
-    <DelaySign>True</DelaySign>
+    <SignAssembly>false</SignAssembly>
+    <DelaySign>false</DelaySign>
     <AssemblyOriginatorKeyFile>35MSSharedLib1024.snk</AssemblyOriginatorKeyFile>
     <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>
-    <Version>1.9.0</Version>
+    <Version>1.10.0</Version>
   </PropertyGroup>
   <PropertyGroup Condition="'$(Configuration)|$(TargetFramework)|$(Platform)'=='Debug|netstandard1.1|AnyCPU'">
     <DocumentationFile>bin\Release\Microsoft.Graph.xml</DocumentationFile>
@@ -54,10 +47,13 @@ Bug fixes
     <ProjectReference Include="..\Microsoft.Graph.Core\Microsoft.Graph.Core.csproj" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="System.Net.Http" Version="4.3.1" />
+    <PackageReference Include="System.Net.Http" Version="4.3.3">
+      <!--<ExcludeAssets>All</ExcludeAssets>-->
+    </PackageReference>
   </ItemGroup>
   <ItemGroup Condition=" '$(TargetFramework)' == 'net45' ">
     <Reference Include="System" />
+    <Reference Include="System.Net.Http" />
     <Reference Include="Microsoft.CSharp" />
     <PackageReference Include="Newtonsoft.Json" Version="[6.0.1,12)" />
   </ItemGroup>

src/Microsoft.Graph/35MSSharedLib1024.snk

@@ -24,8 +24,8 @@
 //
 // You can specify all the values or you can default the Build and Revision Numbers
 // by using the '*' as shown below:
-[assembly: AssemblyVersion("1.9.0")]
-[assembly: AssemblyFileVersion("1.9.0.0")]
+[assembly: AssemblyVersion("1.10.0")]
+[assembly: AssemblyFileVersion("1.10.0.0")]
 
 #if DEBUG
 [assembly: InternalsVisibleTo("Microsoft.Graph.Test")]

src/Microsoft.Graph/Microsoft.Graph.csproj

@@ -0,0 +1,22 @@
+namespace Microsoft.Graph
+{
+    using System.Threading;
+
+    public partial interface IUserActivitiesCollectionRequest
+    {
+        /// <summary>
+        /// Adds the specified UserActivity to the collection via PUT.
+        /// </summary>
+        /// <param name="userActivity">The UserActivity to add.</param>
+        /// <returns>The created UserActivity.</returns>
+        System.Threading.Tasks.Task<UserActivity> AddUserActivityAsync(UserActivity userActivity);
+
+        /// <summary>
+        /// Adds or replaces the specified UserActivity to the collection via PUT.
+        /// </summary>
+        /// <param name="userActivity">The UserActivity to add.</param>
+        /// <param name="cancellationToken">The <see cref="CancellationToken"/> for the request.</param>
+        /// <returns>The created UserActivity.</returns>
+        System.Threading.Tasks.Task<UserActivity> AddUserActivityAsync(UserActivity userActivity, CancellationToken cancellationToken);
+    }
+}