feat: add Deal/GetByName

Author: DavidRouyer

src/Pipedrive.net.Tests.Integration/Clients/DealsClientTests.cs

@@ -66,14 +66,27 @@ public async Task ReturnsDistinctInfosBasedOnStartPage()
             }
         }
 
+        public class TheGetByNameMethod
+        {
+            [IntegrationTest]
+            public async Task CanRetrieveDeals()
+            {
+                var pipedrive = Helper.GetAuthenticatedClient();
+
+                var deals = await pipedrive.Deal.GetByName("mon deal");
+
+                Assert.Equal(1, deals.Count);
+            }
+        }
+
         public class TheGetMethod
         {
             [IntegrationTest]
             public async Task CanRetrieveDeal()
             {
                 var pipedrive = Helper.GetAuthenticatedClient();
 
-                var deal = await pipedrive.Deal.Get(1);
+                var deal = await pipedrive.Deal.Get(135);
 
                 Assert.True(deal.Active);
             }

src/Pipedrive.net.Tests/Clients/DealsClientTests.cs

@@ -135,6 +135,25 @@ await connection.GetAll<Deal>(
             }
         }
 
+        public class TheGetByNameMethod
+        {
+            [Fact]
+            public async Task RequestsCorrectUrl()
+            {
+                var connection = Substitute.For<IApiConnection>();
+                var client = new DealsClient(connection);
+
+                await client.GetByName("name");
+
+                Received.InOrder(async () =>
+                {
+                    await connection.GetAll<SimpleDeal>(Arg.Is<Uri>(u => u.ToString() == "deals/find"),
+                        Arg.Is<Dictionary<string, string>>(d => d.Count == 1
+                            && d["term"] == "name"));
+                });
+            }
+        }
+
         public class TheGetMethod
         {
             [Fact]

src/Pipedrive.net/Clients/DealsClient.cs

@@ -67,6 +67,14 @@ public Task<IReadOnlyList<Deal>> GetAllForUserId(int userId, DealFilters filters
             return ApiConnection.GetAll<Deal>(ApiUrls.Deals(), parameters, options);
         }
 
+        public Task<IReadOnlyList<SimpleDeal>> GetByName(string name)
+        {
+            var parameters = new Dictionary<string, string>();
+            parameters.Add("term", name);
+
+            return ApiConnection.GetAll<SimpleDeal>(ApiUrls.DealsFind(), parameters);
+        }
+
         public Task<Deal> Get(long id)
         {
             return ApiConnection.Get<Deal>(ApiUrls.Deal(id));

src/Pipedrive.net/Clients/IDealsClient.cs

@@ -16,6 +16,8 @@ public interface IDealsClient
 
         Task<IReadOnlyList<Deal>> GetAllForUserId(int userId, DealFilters filters);
 
+        Task<IReadOnlyList<SimpleDeal>> GetByName(string name);
+
         Task<Deal> Get(long id);
 
         Task<Deal> Create(NewDeal data);

src/Pipedrive.net/Helpers/ApiUrls.cs

@@ -96,6 +96,15 @@ public static Uri Deals()
             return _dealsUrl;
         }
 
+        /// <summary>
+        /// return the <see cref="Uri"/> that return all the finded deals.
+        /// </summary>
+        /// <returns></returns>
+        public static Uri DealsFind()
+        {
+            return new Uri("deals/find", UriKind.Relative);
+        }
+
         /// <summary>
         /// Returns the <see cref="Uri"/> for the specified deal.
         /// </summary>

src/Pipedrive.net/Models/Response/SimpleDeal.cs

@@ -0,0 +1,42 @@
+using Newtonsoft.Json;
+
+namespace Pipedrive
+{
+    public class SimpleDeal
+    {
+        public long Id { get; set; }
+
+        [JsonProperty("title")]
+        public string Title { get; set; }
+
+        [JsonProperty("user_id")]
+        public long UserId { get; set; }
+
+        [JsonProperty("visible_to")]
+        public Visibility VisibleTo { get; set; }
+
+        [JsonProperty("status")]
+        public DealStatus Status { get; set; }
+
+        [JsonProperty("value")]
+        public long Value { get; set; }
+
+        [JsonProperty("currency")]
+        public string Currency { get; set; }
+
+        [JsonProperty("person_name")]
+        public string PersonName { get; set; }
+
+        [JsonProperty("person_id")]
+        public long? PersonId { get; set; }
+
+        [JsonProperty("organization_name")]
+        public string OrganizationName { get; set; }
+
+        [JsonProperty("organization_id")]
+        public long? OrganizationId { get; set; }
+
+        [JsonProperty("formatted_value")]
+        public string FormattedValue { get; set; }
+    }
+}