initial commit

Author: nanotaboada

.gitignore

@@ -0,0 +1,28 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Debug: Minimal API (Swagger)",
+            "type": "coreclr",
+            "request": "launch",
+            "program": "${workspaceFolder}/src/backend/Players.API/bin/Debug/net8.0/Players.API.dll",
+            "serverReadyAction": {
+                "action": "openExternally",
+                "pattern": "\\bNow listening on:\\s+https://localhost:([0-9]+)",
+                "uriFormat": "https://localhost:%s/swagger"
+            },
+            "env": {
+                "ASPNETCORE_ENVIRONMENT": "Development",
+                "ASPNETCORE_URLS": "https://localhost:9000",
+                "ASPNETCORE_DETAILEDERRORS": "1",
+                "ASPNETCORE_SHUTDOWNTIMEOUTSECONDS": "3"
+            }
+        },
+        {
+            "name": "Attach: Minimal API",
+            "type": "coreclr",
+            "request": "attach",
+            "processId": "${command:pickProcess}"
+        }
+    ]
+}

.vscode/launch.json

@@ -0,0 +1,73 @@
+{
+  "workbench.editor.decorations.colors": true,
+  "workbench.editor.wrapTabs": true,
+  "workbench.editor.pinnedTabsOnSeparateRow": true,
+  "workbench.editor.pinnedTabSizing": "shrink",
+  "workbench.startupEditor": "none",
+  "workbench.tree.indent": 11,
+  "workbench.tree.renderIndentGuides": "always",
+  "workbench.colorTheme": "GitHub Dark",
+  "workbench.iconTheme": "material-icon-theme",
+  "workbench.colorCustomizations": {
+    "tree.indentGuidesStroke": "#999999",
+    "[Material Theme Darker High Contrast]": {}
+  },
+  "workbench.tree.enableStickyScroll": true,
+
+  "editor.rulers": [{ "column": 127 }],
+  "editor.tabSize": 4,
+  "editor.insertSpaces": true,
+  "editor.trimAutoWhitespace": true,
+  "editor.renderWhitespace": "boundary",
+  "editor.wordWrap": "off",
+  "editor.bracketPairColorization.enabled": true,
+  "editor.guides.bracketPairs": "active",
+  "editor.largeFileOptimizations": false,
+  "editor.stickyScroll.enabled": true,
+  "editor.minimap.enabled": true,
+  "editor.minimap.showSlider": "always",
+  "editor.minimap.maxColumn": 127,
+  "editor.minimap.renderCharacters": false,
+  "editor.minimap.size": "fill",
+  "editor.cursorStyle": "block",
+  "editor.cursorBlinking": "smooth",
+  "editor.cursorSmoothCaretAnimation": "on",
+
+  "files.trimTrailingWhitespace": true,
+  "files.insertFinalNewline": true,
+  "files.trimFinalNewlines": true,
+  "files.autoGuessEncoding": true,
+
+  "breadcrumbs.enabled": true,
+  "explorer.autoReveal": true,
+  "explorer.compactFolders": false,
+  "window.density.editorTabHeight": "compact",
+  "vsintellicode.modify.editor.suggestSelection": "automaticallyOverrodeDefaultValue",
+  "markdown-preview-github-styles.darkTheme": "light",
+  "terminal.integrated.fontFamily": "Menlo for Powerline",
+  "debug.toolBarLocation": "commandCenter",
+
+  "git.autofetch": true,
+  "git.autoStash": true,
+  "git.mergeEditor": true,
+  "git.defaultBranchName": "master",
+  "git.branchProtection": ["master"],
+  "git.pruneOnFetch": false,
+  "github.branchProtection": true,
+  "githubPullRequests.pullBranch": "never",
+  "diffEditor.ignoreTrimWhitespace": false,
+
+  "[csharp]": {
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "ms-dotnettools.csharp"
+  },
+
+  "[json]": {
+    "editor.formatOnSave": true,
+    "editor.tabSize": 2,
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "json.maxItemsComputed": 99999,
+
+  "testing.alwaysRevealTestOnStateChange": true
+}

.vscode/settings.json

@@ -0,0 +1,27 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.0.31903.59
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{3236F42E-2310-44BA-B786-90F0B6069153}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "PlayersApi", "src\PlayersApi\PlayersApi.csproj", "{805FA9B9-3D63-4AAD-9633-DC07CC2135AD}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{805FA9B9-3D63-4AAD-9633-DC07CC2135AD}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{805FA9B9-3D63-4AAD-9633-DC07CC2135AD}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{805FA9B9-3D63-4AAD-9633-DC07CC2135AD}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{805FA9B9-3D63-4AAD-9633-DC07CC2135AD}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(NestedProjects) = preSolution
+		{805FA9B9-3D63-4AAD-9633-DC07CC2135AD} = {3236F42E-2310-44BA-B786-90F0B6069153}
+	EndGlobalSection
+EndGlobal

Dotnet.Samples.AspNetCore.MinimalApi.sln

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Nano Taboada
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

LICENSE

@@ -0,0 +1,18 @@
+# 🧪 Minimal API with ASP.NET Core
+
+## Manifesto
+
+> "Nobody should start to undertake a large project. You start with a small _trivial_ project, and you should never expect it to get large. If you do, you'll just overdesign and generally think it is more important than it likely is at that stage. Or worse, you might be scared away by the sheer size of the work you envision. So start small, and think about the details. Don't think about some big picture and fancy design. If it doesn't solve some fairly immediate need, it's almost certainly over-designed. And don't expect people to jump in and help you. That's not how these things work. You need to get something half-way _useful_ first, and then others will say "hey, that _almost_ works for me", and they'll get involved in the project." — Linus Torvalds
+
+## About
+
+Proof of Concept for a [Minimal API](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/minimal-apis?view=aspnetcore-8.0), made with [ASP.NET Core 8.0](https://learn.microsoft.com/en-us/aspnet/core/release-notes/aspnetcore-8.0?view=aspnetcore-8.0), targeting [.NET 8](https://learn.microsoft.com/en-us/dotnet/core/whats-new/dotnet-8), inspired by the official [Tutorial: Create a minimal web API with ASP.NET Core](https://learn.microsoft.com/en-us/aspnet/core/tutorials/min-web-api?view=aspnetcore-8.0&tabs=visual-studio-code).
+
+## Credits
+
+- The solution has been coded using [Visual Studio Code](https://code.visualstudio.com/).
+- AI assistance provided by [Gemini](https://gemini.google.com/) and [Copilot](https://copilot.microsoft.com/).
+
+## Terms
+
+All trademarks, registered trademarks, service marks, product names, company names, or logos mentioned on this repository are the property of their respective owners. All usage of such terms herein is for identification purposes only and constitutes neither an endorsement nor a recommendation of those items. Furthermore, the use of such terms is intended to be for educational and informational purposes only.

README.md

@@ -0,0 +1,162 @@
+namespace Dotnet.Samples.AspNetCore.MinimalApi;
+
+public static class PlayerData
+{
+    public static List<Player> CreateStarting11()
+    {
+        return
+        [
+            new()
+            {
+                Id = 1,
+                FirstName = "Damián",
+                MiddleName = "Emiliano",
+                LastName = "Martínez",
+                DateOfBirth = new DateTime(1992, 9, 1, 0, 0, 0, DateTimeKind.Utc),
+                SquadNumber = 23,
+                Position = "Goalkeeper",
+                AbbrPosition = "GK",
+                Team = "Aston Villa FC",
+                League = "Premier League",
+                Starting11 = true,
+            },
+            new()
+            {
+                Id = 2,
+                FirstName = "Nahuel",
+                LastName = "Molina",
+                DateOfBirth = new DateTime(1998, 4, 5, 0, 0, 0, DateTimeKind.Utc),
+                SquadNumber = 26,
+                Position = "Right-Back",
+                AbbrPosition = "RB",
+                Team = "Altético Madrid",
+                League = "La Liga",
+                Starting11 = true,
+            },
+            new()
+            {
+                Id = 3,
+                FirstName = "Cristian",
+                MiddleName = "Gabriel",
+                LastName = "Romero",
+                DateOfBirth = new DateTime(1998, 4, 26, 0, 0, 0, DateTimeKind.Utc),
+                SquadNumber = 13,
+                Position = "Centre-Back",
+                AbbrPosition = "CB",
+                Team = "Tottenham Hotspur",
+                League = "Premier League",
+                Starting11 = true,
+            },
+            new()
+            {
+                Id = 4,
+                FirstName = "Nicolás",
+                MiddleName = "Hernán Gonzalo",
+                LastName = "Otamendi",
+                DateOfBirth = new DateTime(1988, 2, 11, 0, 0, 0, DateTimeKind.Utc),
+                SquadNumber = 19,
+                Position = "Centre-Back",
+                AbbrPosition = "CB",
+                Team = "SL Benfica",
+                League = "Liga Portugal",
+                Starting11 = true,
+            },
+            new()
+            {
+                Id = 5,
+                FirstName = "Nicolás",
+                MiddleName = "Alejandro",
+                LastName = "Tagliafico",
+                DateOfBirth = new DateTime(1992, 8, 30, 0, 0, 0, DateTimeKind.Utc),
+                SquadNumber = 3,
+                Position = "Left-Back",
+                AbbrPosition = "LB",
+                Team = "Olympique Lyon",
+                League = "Ligue 1",
+                Starting11 = true,
+            },
+            new()
+            {
+                Id = 6,
+                FirstName = "Ángel",
+                MiddleName = "Fabián",
+                LastName = "Di María",
+                DateOfBirth = new DateTime(1988, 2, 13, 0, 0, 0, DateTimeKind.Utc),
+                SquadNumber = 11,
+                Position = "Right Winger",
+                AbbrPosition = "RW",
+                Team = "SL Benfica",
+                League = "Liga Portugal",
+                Starting11 = true,
+            },
+            new()
+            {
+                Id = 7,
+                FirstName = "Rodrigo",
+                MiddleName = "Javier",
+                LastName = "de Paul",
+                DateOfBirth = new DateTime(1994, 5, 23, 0, 0, 0, DateTimeKind.Utc),
+                SquadNumber = 7,
+                Position = "Central Midfield",
+                AbbrPosition = "CM",
+                Team = "Altético Madrid",
+                League = "La Liga",
+                Starting11 = true,
+            },
+            new()
+            {
+                Id = 8,
+                FirstName = "Enzo",
+                MiddleName = "Jeremías",
+                LastName = "Fernández",
+                DateOfBirth = new DateTime(2001, 1, 16, 0, 0, 0, DateTimeKind.Utc),
+                SquadNumber = 24,
+                Position = "Central Midfield",
+                AbbrPosition = "CM",
+                Team = "Chelsea FC",
+                League = "Premier League",
+                Starting11 = true,
+            },
+            new()
+            {
+                Id = 9,
+                FirstName = "Alexis",
+                LastName = "Mac Allister",
+                DateOfBirth = new DateTime(1998, 12, 23, 0, 0, 0, DateTimeKind.Utc),
+                SquadNumber = 20,
+                Position = "Central Midfield",
+                AbbrPosition = "CM",
+                Team = "Liverpool FC",
+                League = "Premier League",
+                Starting11 = true,
+            },
+            new()
+            {
+                Id = 10,
+                FirstName = "Lionel",
+                MiddleName = "Andrés",
+                LastName = "Messi",
+                DateOfBirth = new DateTime(1987, 6, 23, 0, 0, 0, DateTimeKind.Utc),
+                SquadNumber = 10,
+                Position = "Right Winger",
+                AbbrPosition = "RW",
+                Team = "Inter Miami CF",
+                League = "Major League Soccer",
+                Starting11 = true,
+            },
+            new()
+            {
+                Id = 11,
+                FirstName = "Julián",
+                LastName = "Álvarez",
+                DateOfBirth = new DateTime(2000, 1, 30, 0, 0, 0, DateTimeKind.Utc),
+                SquadNumber = 9,
+                Position = "Centre-Forward",
+                AbbrPosition = "CF",
+                Team = "Manchester City",
+                League = "Premier League",
+                Starting11 = true,
+            }
+        ];
+    }
+}

src/PlayersApi/Data/PlayerData.cs

@@ -0,0 +1,18 @@
+namespace Dotnet.Samples.AspNetCore.MinimalApi;
+
+public static class PlayerDataExtensions
+{
+    public static void MapFrom(this Player target, Player source)
+    {
+        target.FirstName = source.FirstName;
+        target.MiddleName = source.MiddleName;
+        target.LastName = source.LastName;
+        target.DateOfBirth = source.DateOfBirth;
+        target.SquadNumber = source.SquadNumber;
+        target.Position = source.Position;
+        target.AbbrPosition = source.AbbrPosition;
+        target.Team = source.Team;
+        target.League = source.League;
+        target.Starting11 = source.Starting11;
+    }
+}

src/PlayersApi/Data/PlayerDataExtensions.cs

@@ -0,0 +1,11 @@
+namespace Dotnet.Samples.AspNetCore.MinimalApi;
+
+using Microsoft.EntityFrameworkCore;
+
+public class PlayerDbContext : DbContext
+{
+    public PlayerDbContext(DbContextOptions<PlayerDbContext> options)
+        : base(options) { }
+
+    public DbSet<Player> Players => Set<Player>();
+}

src/PlayersApi/Data/PlayerDbContext.cs

@@ -0,0 +1,14 @@
+namespace Dotnet.Samples.AspNetCore.MinimalApi;
+
+public static class PlayerDbContextExtensions
+{
+    public static void Seed(this PlayerDbContext context)
+    {
+        if (!context.Players.Any())
+        {
+            context.Players.AddRange(PlayerData.CreateStarting11());
+
+            context.SaveChanges();
+        }
+    }
+}