Umgebungsvariablen
Teil des Abschnitts C#- und .NET-Grundlagen der ASP.NET Core-Journey von Coddy. Lektion 20 von 20.
Eine Umgebungsvariable ist ein benannter Textwert, den die Shell oder der Server jedem gestarteten Programm übergibt. Einstellungen, die sich von einem Computer zum anderen ändern, werden dort gespeichert: ein Dateipfad, eine Datenbankadresse, ein geheimer Schlüssel. Environment.GetEnvironmentVariable(name) liest einen solchen Wert und gibt string? zurück: null, wenn er nicht festgelegt ist.
var name = Environment.GetEnvironmentVariable("GREETING_NAME") ?? "world";
Console.WriteLine($"Hello, {name}!");
Console.WriteLine(Environment.CurrentDirectory);In einer macOS- oder Linux-Shell legt GREETING_NAME=Ada dotnet run die Variable für einen einzelnen Lauf fest und gibt Hello, Ada! aus; in PowerShell verwendet man $env:GREETING_NAME = "Ada". Environment enthält außerdem CurrentDirectory, NewLine, ProcessorCount und Exit(code). Auch ASP.NET Core liest seine Einstellungen aus Umgebungsvariablen.
Aufgabe
EinfachLass den Benutzer auswählen, welche Datei der Tracker verwendet. Für diese Lektion setzt „Prüfen“ EXPENSES_FILE auf trip.json, die neue Datei in deinem Projekt. „Ausführen“ im Terminal setzt die Variable nicht.
- Ändere die erste Zeile nach den
using-Zeilen so, dassfileden Wert der UmgebungsvariablenEXPENSES_FILEerhält oder"expenses.json", wenn sie nicht gesetzt ist. - Jeder Befehl verwendet bereits
file, daher ändert sich sonst nichts.
Mit EXPENSES_FILE=trip.json gibt dotnet run Folgendes aus:
Expense Tracker
2 expenses
Total: 253.50und add speichert in trip.json, während expenses.json unverändert bleibt.
Probier es aus: Drücke auf „Ausführen“. „Ausführen“ im Terminal setzt keine Umgebungsvariablen, daher ist EXPENSES_FILE dort null, und der Tracker verwendet ersatzweise expenses.json: wie zuvor 3 expenses und Total: 48.50. Das ist das ?? in Aktion. „Prüfen“ setzt EXPENSES_FILE=trip.json und erwartet die drei Zeilen oben.
Probier es selbst
using System.Globalization;
using System.Text.Json;
var file = "expenses.json";
var expenses = new List<Expense>();
if (File.Exists(file))
{
expenses = JsonSerializer.Deserialize<List<Expense>>(File.ReadAllText(file)) ?? new List<Expense>();
}
var budgets = new Dictionary<string, decimal>();
if (File.Exists("budgets.json"))
{
budgets = JsonSerializer.Deserialize<Dictionary<string, decimal>>(File.ReadAllText("budgets.json")) ?? new Dictionary<string, decimal>();
}
var count = expenses.Count;
var total = expenses.Sum(e => e.Amount);
if (args.Length == 0)
{
Console.WriteLine("Expense Tracker");
Console.WriteLine($"{count} expenses");
Console.WriteLine($"Total: {total:F2}");
}
else
{
switch (args[0])
{
case "add":
if (args.Length < 3)
{
Console.Error.WriteLine("Usage: add <name> <amount> [category]");
return 1;
}
if (!decimal.TryParse(args[2], CultureInfo.InvariantCulture, out var amount))
{
Console.Error.WriteLine($"Invalid amount: {args[2]}");
return 1;
}
if (amount is <= 0 or > 10000)
{
Console.Error.WriteLine("The amount must be more than 0 and at most 10000.");
return 1;
}
var category = args.Length > 3 ? args[3] : "other";
var expense = new Expense(args[1], amount, category);
expenses.Add(expense);
File.WriteAllText(file, JsonSerializer.Serialize(expenses));
Console.WriteLine($"Added {expense.Name}: {expense.Amount:F2} ({expense.Category})");
if (budgets.TryGetValue(category, out var limit))
{
var spent = expenses.Where(e => e.Category == category).Sum(e => e.Amount);
if (spent > limit)
{
Console.WriteLine($"Over budget for {category}: {spent:F2} of {limit:F2}");
}
}
break;
case "remove":
if (args.Length < 2)
{
Console.Error.WriteLine("Usage: remove <name>");
return 1;
}
Expense? match = expenses.Find(e => e.Name == args[1]);
if (match is null)
{
Console.Error.WriteLine($"No expense named {args[1]}.");
return 1;
}
expenses.Remove(match);
File.WriteAllText(file, JsonSerializer.Serialize(expenses));
Console.WriteLine($"Removed {match.Name}: {match.Amount:F2}");
break;
case "list":
var shown = args.Length > 1 ? expenses.Where(e => e.Category == args[1]).ToList() : expenses;
if (shown.Count == 0)
{
Console.WriteLine("No expenses.");
break;
}
foreach (var line in shown.Select(e => $"{e.Name}: {e.Amount:F2} ({e.Category})"))
{
Console.WriteLine(line);
}
break;
case "top":
var howMany = 3;
if (args.Length > 1 && !int.TryParse(args[1], out howMany))
{
Console.Error.WriteLine($"Invalid number: {args[1]}");
return 1;
}
var biggest = expenses.OrderByDescending(e => e.Amount).Take(howMany);
foreach (var line in biggest.Select((e, i) => $"{i + 1}. {e.Name}: {e.Amount:F2} ({e.Category})"))
{
Console.WriteLine(line);
}
break;
case "categories":
var groups = expenses.GroupBy(e => e.Category).OrderByDescending(g => g.Sum(e => e.Amount));
foreach (var g in groups)
{
Console.WriteLine($"{g.Key}: {g.Sum(e => e.Amount):F2} ({g.Count()})");
}
break;
case "help":
var topic = args.Length > 1 ? args[1] : "";
var help = topic switch
{
"" => "Type help <command>, such as help add.",
"add" => "add <name> <amount> [category]: saves an expense",
"remove" => "remove <name>: deletes the first expense with that name",
"list" => "list [category]: shows the saved expenses",
"top" => "top [n]: shows the n biggest expenses, 3 by default",
"categories" => "categories: shows the total of each category",
"import" => "import <file>: adds the expenses in a CSV file",
"export" => "export: writes every expense to exports/expenses.csv",
_ => $"No help for {topic}.",
};
Console.WriteLine(help);
break;
case "import":
if (args.Length < 2)
{
Console.Error.WriteLine("Usage: import <file>");
return 1;
}
if (!File.Exists(args[1]))
{
Console.Error.WriteLine($"No file named {args[1]}.");
return 1;
}
var imported = 0;
var lineNumber = 0;
foreach (var row in File.ReadAllLines(args[1]))
{
lineNumber++;
try
{
var parts = row.Split(',');
if (parts.Length != 3)
{
throw new FormatException("A line needs a name, an amount and a category.");
}
expenses.Add(new Expense(parts[0], decimal.Parse(parts[1], CultureInfo.InvariantCulture), parts[2]));
imported++;
}
catch (FormatException ex)
{
Console.Error.WriteLine($"Line {lineNumber} skipped: {ex.Message}");
}
}
File.WriteAllText(file, JsonSerializer.Serialize(expenses));
Console.WriteLine($"Imported {imported} expenses from {args[1]}.");
break;
case "export":
var folder = "exports";
Directory.CreateDirectory(folder);
var csvPath = Path.Combine(folder, "expenses.csv");
File.WriteAllLines(csvPath, expenses.Select(e => $"{e.Name},{e.Amount.ToString("F2", CultureInfo.InvariantCulture)},{e.Category}"));
Console.WriteLine($"Exported {expenses.Count} expenses to {csvPath}.");
foreach (var g in expenses.GroupBy(e => e.Category))
{
var categoryPath = Path.Combine(folder, $"{g.Key}.csv");
await File.WriteAllLinesAsync(categoryPath, g.Select(e => $"{e.Name},{e.Amount.ToString("F2", CultureInfo.InvariantCulture)},{e.Category}"));
Console.WriteLine($"Wrote {categoryPath}");
}
break;
default:
Console.Error.WriteLine($"Unknown command: {args[0]}");
return 1;
}
}
return 0;