{"id":15066080,"url":"https://github.com/zeytdev/zeyt.exceldocument","last_synced_at":"2026-02-16T20:35:16.092Z","repository":{"id":256475915,"uuid":"854692075","full_name":"zeytdev/Zeyt.ExcelDocument","owner":"zeytdev","description":"Zeyt.ExcelDocument is a C# library that simplifies the creation of Excel documents from object lists. It provides an intuitive API to map object properties to Excel columns, allowing for custom column names, widths, and default values for null fields.","archived":false,"fork":false,"pushed_at":"2024-09-22T17:33:04.000Z","size":2764,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-03T12:39:05.274Z","etag":null,"topics":["csharp","dotnet","excel","exceldocument","xslx"],"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/zeytdev.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-09-09T16:03:51.000Z","updated_at":"2024-09-22T17:33:07.000Z","dependencies_parsed_at":"2025-10-03T12:31:24.726Z","dependency_job_id":null,"html_url":"https://github.com/zeytdev/Zeyt.ExcelDocument","commit_stats":null,"previous_names":["zeytdev/zeyt.exceldocument"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zeytdev/Zeyt.ExcelDocument","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeytdev%2FZeyt.ExcelDocument","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeytdev%2FZeyt.ExcelDocument/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeytdev%2FZeyt.ExcelDocument/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeytdev%2FZeyt.ExcelDocument/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zeytdev","download_url":"https://codeload.github.com/zeytdev/Zeyt.ExcelDocument/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeytdev%2FZeyt.ExcelDocument/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279017673,"owners_count":26086125,"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-14T02:00:06.444Z","response_time":60,"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":["csharp","dotnet","excel","exceldocument","xslx"],"created_at":"2024-09-25T01:01:16.573Z","updated_at":"2025-10-14T02:17:41.419Z","avatar_url":"https://github.com/zeytdev.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zeyt.ExcelDocument\n\n[![Nuget](https://img.shields.io/nuget/v/Zeyt.ExcelDocument?logo=nuget)](https://www.nuget.org/packages/Zeyt.ExcelDocument)\n\n**Zeyt.ExcelDocument** is a powerful and easy-to-use C# library designed for generating Excel documents from object lists. The library allows you to map object properties to Excel columns with custom names, widths, and even default values for fields with missing data. It also provides an easy way to export this data to `.xlsx` format.\n\n## Features\n\n- **Customizable Mappings**: Easily map object properties to Excel columns.\n- **Fluent API**: Set column names, widths, and default values for null fields.\n- **Quick Export**: Convert object lists into Excel files in just a few lines of code.\n- **Null Field Handling**: Define default values for fields with missing data.\n\n## Installation\n\nYou can install the package via NuGet Package Manager:\n\n```bash\nInstall-Package Zeyt.ExcelDocument\n```\n\nOr via .NET CLI:\n\n```bash\ndotnet add package Zeyt.ExcelDocument\n```\n\n## Example Usage\n\nHere is a basic example of how to use the **Zeyt.ExcelDocument** library:\n\n```csharp\nusing Zeyt.ExcelDocument;\n\nvar customerList = new List\u003cCustomer\u003e\n{\n    new Customer { FirstName = \"James\", LastName = \"Butt\", Age = 23, Email = \"james@james.com\" },\n    new Customer { FirstName = \"Art\", LastName = \"Venere\", Age = 33, Email = \"art@venere.com\" },\n    new Customer { FirstName = \"Sage\", LastName = \"Wieser\", Age = 57, Email = null },\n    new Customer { FirstName = \"Minna\", LastName = \"Amigon\", Age = 45, Email = \"minna@amigon.com\" },\n    new Customer { FirstName = \"Blair\", LastName = \"Malet\", Age = 66, Email = null },\n};\n\n// Map customer data to Excel and export it to a file\nvar customerExcelData = new ExcelDocumentWriter\u003cCustomer, CustomerExcelMap\u003e(\"Customer Information\").Write(customerList);\nFile.WriteAllBytes(Path.Combine(AppDomain.CurrentDomain.BaseDirectory, \"Customer.xlsx\"), customerExcelData);\n```\n\n### Mapping Configuration\n\nThe mapping is done using a separate `ExcelDocumentMap\u003cT\u003e` class. In this example, we create a custom mapping for the `Customer` class:\n\n```csharp\npublic class CustomerExcelMap : ExcelDocumentMap\u003cCustomer\u003e\n{\n    public CustomerExcelMap()\n    {\n        Map(x =\u003e x.FirstName).Name(\"Full Name\").Width(30).WriteUsing(x =\u003e $\"{x.FirstName} {x.LastName}\");\n        Map(x =\u003e x.Age).Name(\"Age\").Width(10);\n        Map(x =\u003e x.Email).Name(\"Email\").Width(50).Default(\"EMPTY\");\n    }\n}\n```\n\n### The `Customer` Class\n\nThis is the class we are mapping to Excel columns:\n\n```csharp\npublic class Customer\n{\n    public string? FirstName { get; set; }\n    public string? LastName { get; set; }\n    public int? Age { get; set; } = 0;\n    public string? Email { get; set; }\n}\n```\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeytdev%2Fzeyt.exceldocument","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzeytdev%2Fzeyt.exceldocument","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeytdev%2Fzeyt.exceldocument/lists"}