Correct filter models #19

Original file line number	Diff line number	Diff line change
Expand Up		@@ -13,23 +13,54 @@
		## Installation

		.Net CLI

		```
		dotnet add package Notion.Net
		```

		## Usage

		> Before getting started, you need to [create an integration](https://www.notion.com/my-integrations) and find the token. You can learn more about authorization [here](https://developers.notion.com/docs/authorization).


		Import and initialize the client using the integration token created above.


		![image](https://user-images.githubusercontent.com/18693839/119268863-79925b00-bc12-11eb-92cb-d5a9a8c57fdc.png)

		Make A request to any Endpoint. For example you can call below to fetch the paginated list of users.


		![image](https://user-images.githubusercontent.com/18693839/119268924-ae9ead80-bc12-11eb-9d1a-925267896d9e.png)

	### Querying a database

	After you initialized your client and got an id of a database, you can query it for any contained pages. You can add filters and sorts to your request. Here is a simple example:

	```C#
	// Date filter for page property called "When"
	var dateFilter = new DateFilter("When", onOrAfter: DateTime.Now);

	var queryParams = new DatabasesQueryParameters { Filter = dateFilter };
	var pages = await client.Databases.QueryAsync(databaseId, queryParams);
	```

	Filters constructors contain all possible filter conditions, but you need to choose only condition per filter, all other should be `null`. So, for example this code would not filter by 2 conditions as one might expect:

	```C#
	var filter = new TextFilter("Name", startsWith: "Mr", contains: "John"); // WRONG FILTER USAGE

	```

	To use complex filters, use class `CompoundFilter`. It allows adding many filters and even nesting compound filters into each other (it works as filter group in Notion interface). Here is an example of filter that would return pages that were due in past month AND either had a certain assignee OR had high urgency:

	```C#
	var selectFilter = new SelectFilter("Urgency", equal: "High");
	var assigneeFilter = new PeopleFilter("Assignee", contains: "some-uuid");
	var dateFilter = new DateFilter("Due", pastMonth: new Dictionary<string, object>());

	var orGroup = new List<Filter> { assigneeFilter, selectFilter };
	var complexFiler = new CompoundFilter(
	and: new List<Filter> { dateFilter, new CompoundFilter(or: orGroup) }
	);
	```

		## Contribution Guideline

Expand Down

208 changes: 0 additions & 208 deletions Src/Notion.Client/Models/Filter.cs

Show comments View file Open in desktop

This file was deleted.

34 changes: 34 additions & 0 deletions Src/Notion.Client/Models/Filters/Checkbox.cs

Show comments View file Open in desktop

Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,34 @@
	using System;
	using Newtonsoft.Json;

	namespace Notion.Client
	{
	public class CheckboxFilter : SinglePropertyFilter
	{
	public Condition Checkbox { get; set; }

	public CheckboxFilter(
	string propertyName,
	bool? equal = null,
	bool? doesNotEqual = null)
	{
	Property = propertyName;
	Checkbox = new Condition(equal: equal, doesNotEqual: doesNotEqual);
	}

	public class Condition
	{
	[JsonProperty("equals")]
	public bool? Equal { get; set; }

	[JsonProperty("does_not_equal")]
	public bool? DoesNotEqual { get; set; }

	public Condition(Nullable<bool> equal = null, Nullable<bool> doesNotEqual = null)
	{
	Equal = equal;
	DoesNotEqual = doesNotEqual;
	}
	}
	}
	}

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Correct filter models #19

Uh oh!

Correct filter models #19

Filter by extension

Uh oh!

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!

Uh oh!