{"id":32420755,"url":"https://github.com/mynihongo/optional","last_synced_at":"2025-10-25T17:58:20.623Z","repository":{"id":37100708,"uuid":"346121825","full_name":"MyNihongo/Optional","owner":"MyNihongo","description":"Optional type and extensions","archived":false,"fork":false,"pushed_at":"2023-12-11T00:41:37.000Z","size":85,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-24T03:39:27.859Z","etag":null,"topics":["optional"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MyNihongo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-03-09T19:32:42.000Z","updated_at":"2024-01-12T18:18:32.000Z","dependencies_parsed_at":"2023-12-11T01:37:57.412Z","dependency_job_id":null,"html_url":"https://github.com/MyNihongo/Optional","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/MyNihongo/Optional","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MyNihongo%2FOptional","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MyNihongo%2FOptional/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MyNihongo%2FOptional/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MyNihongo%2FOptional/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MyNihongo","download_url":"https://codeload.github.com/MyNihongo/Optional/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MyNihongo%2FOptional/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280995962,"owners_count":26426667,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-25T02:00:06.499Z","response_time":81,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["optional"],"created_at":"2025-10-25T17:57:58.257Z","updated_at":"2025-10-25T17:58:20.617Z","avatar_url":"https://github.com/MyNihongo.png","language":"C#","readme":"[![Version](https://img.shields.io/nuget/v/MyNihongo.Option?style=plastic)](https://www.nuget.org/packages/MyNihongo.Option/)\n[![Nuget downloads](https://img.shields.io/nuget/dt/MyNihongo.Option?label=nuget%20downloads\u0026logo=nuget\u0026style=plastic)](https://www.nuget.org/packages/MyNihongo.Option/)  \nA very simple implementation of the optional pattern with a few extension methods.\n### Create an Optional\u0026#60;T\u0026#62;\n```cs\n// Explicitly\nvar optional = Optional\u003cint\u003e.Of(123);\n\n// Implicitly\nOptional\u003cint\u003e optional = 123;\n\n// Extension method\nvar optional = 123.AsOptional();\n\n// From Task/ValueTask\nvar optional = Task.FromResult(123).AsOptionalAsync();\nvar optional = new ValueTask(123).AsOptionalAsync();\n\n// None\nvar none = Optional\u003cint\u003e.None();\n```\n### Handle values of Optional\u0026#60;T\u0026#62;\n```cs\nvar value = Optional\u003cint\u003e.Of(123).ValueOr(321);\nvar convertOptional = Optional\u003cint\u003e.Of(123).Convert(x =\u003e (long)x);\nvar convertValue = Optional\u003cint\u003e.Of(123).ConvertOr(x =\u003e (long)x, 321L);\n```\n### Invoke functions if a value is present or not\nBoth synchronous (void) and asynchronous (Task and ValueTask) can be invoked.\n```cs\nOptional\u003cint\u003e.Of(123)\n    .IfHasValue(x =\u003e { /* do something with the value */ })\n    .OrElse(() =\u003e { /* do something if no value */ });\n\nawait Optional\u003cint\u003e.None()\n    .IfHasValueAsync(x =\u003e new ValueTask())\n    .OrElseAsync(() =\u003e new ValueTask());\n```\n### Create an Optional\u0026#60;T\u0026#62; from IEnumerable\u0026#60;T\u0026#62;\nFirstOrOptional\n```cs\nvar items = new [] { 1, 2, 3 };\n\nvar item = items.FirstOrOptional();\nvar item = items.FirstOrOptional(x =\u003e x % 2 == 0);\n```\nLastOrOptional\n```cs\nvar items = new [] { 1, 2, 3 };\n\nvar item = items.LastOrOptional();\nvar item = items.LastOrOptional(x =\u003e x % 2 == 0);\n```\nSingleOrOptional\n```cs\nvar items = new [] { 1, 2, 3 };\n\nvar item = items.SingleOrOptional();\nvar item = items.SingleOrOptional(x =\u003e x % 2 == 0);\n```\nElementAtOrOptional\n```cs\nvar items = new [] { 1, 2, 3 };\nvar item = items.SingleOrOptional(3);\n```\nMinOrOptional\n```cs\nvar items = new [] { 1, 2, 3 };\nvar item = items.MinOrOptional();\n```\n```cs\nvar items = new []\n{\n    new { Number = \"1\" },\n    new { Number = \"2\" }\n};\n\nvar item = items.MinOrOptional(x =\u003e x.Number);\n```\nMaxOrOptional\n```cs\nvar items = new [] { 1, 2, 3 };\nvar item = items.MaxOrOptional();\n```\n```cs\nvar items = new []\n{\n    new { Number = \"1\" },\n    new { Number = \"2\" }\n};\n\nvar item = items.MaxOrOptional(x =\u003e x.Number);\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmynihongo%2Foptional","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmynihongo%2Foptional","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmynihongo%2Foptional/lists"}