Menu
CoddyTech

متغيرات البيئة

جزء من قسم أساسيات C# و.NET في رحلة ASP.NET Core على Coddy. الدرس 20 من 20.

متغير البيئة هو قيمة نصية ذات اسم يمررها الصدَفة أو الخادم إلى كل برنامج يبدأه. توجد فيه الإعدادات التي تتغير من حاسوب إلى آخر: موقع ملف، أو عنوان قاعدة بيانات، أو مفتاح سري. تقرأ Environment.GetEnvironmentVariable(name) أحدها وتُعيد string?: القيمة null عندما لا يكون مضبوطًا.

var name = Environment.GetEnvironmentVariable("GREETING_NAME") ?? "world";
Console.WriteLine($"Hello, {name}!");
Console.WriteLine(Environment.CurrentDirectory);

في صدَفة macOS أو Linux، تضبط GREETING_NAME=Ada dotnet run المتغير لتشغيل واحد وتطبع Hello, Ada!؛ ويستخدم PowerShell $env:GREETING_NAME = "Ada". تحتوي Environment أيضًا على CurrentDirectory وNewLine وProcessorCount وExit(code). كما يقرأ ASP.NET Core إعداداته من متغيرات البيئة.

challenge icon

التحدي

سهل

دع المستخدم يختار الملف الذي يستخدمه متعقّب المصروفات. في هذا الدرس، يعيّن «تحقق» EXPENSES_FILE إلى trip.json، وهو الملف الجديد في مشروعك. أما «تشغيل» في الطرفية فلا يعيّنه.

  1. غيّر السطر الأول بعد أسطر using بحيث تكون قيمة file هي قيمة متغير البيئة EXPENSES_FILE، أو "expenses.json" عندما لا يكون معيّنًا.
  2. تستخدم كل الأوامر file بالفعل، لذلك لا يتغير أي شيء آخر.

مع EXPENSES_FILE=trip.json، تطبع dotnet run:

Expense Tracker
2 expenses
Total: 253.50

ويحفظ add في trip.json، مع إبقاء expenses.json كما هو.

جرّب ذلك: اضغط على «تشغيل». لا يعيّن «تشغيل» في الطرفية أي متغيرات بيئة، لذا تكون قيمة EXPENSES_FILE هي null هناك، ويعود متعقّب المصروفات إلى استخدام expenses.json: 3 expenses وTotal: 48.50، كما كان من قبل. هذا هو عمل ??. يعيّن «تحقق» EXPENSES_FILE=trip.json ويتوقع الأسطر الثلاثة أعلاه.

جرّب بنفسك

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;

جميع دروس أساسيات C# و.NET