Odczyt argumentów wiersza poleceń

import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;

/**
 * Parser argumentów wiersza poleceń — skryptyJAVA.pl
 * Zapisz jako: ArgumentyPolecen.java
 */
public class ArgumentyPolecen {

    private final Map<String, String> wartosci = new LinkedHashMap<>();
    private final Set<String> flagi = new LinkedHashSet<>();
    private final List<String> pozycyjne = new ArrayList<>();

    /** W zWartoscia podaj nazwy opcji bez myślników (np. "wyjscie", "o"), które biorą wartość. */
    public ArgumentyPolecen(String[] args, String... zWartoscia) {
        Set<String> zWartosciami = Set.of(zWartoscia);
        boolean koniecOpcji = false;
        for (int i = 0; i < args.length; i++) {
            String argument = args[i];
            if (!koniecOpcji && argument.equals("--")) {
                koniecOpcji = true;                  // od tego miejsca wszystko jest pozycyjne
            } else if (koniecOpcji || argument.length() < 2 || !argument.startsWith("-")) {
                pozycyjne.add(argument);             // samotny "-" to zwykle strumień, nie opcja
            } else if (argument.startsWith("--")) {
                i = czytajDluga(argument.substring(2), args, i, zWartosciami);
            } else {
                i = czytajKrotkie(argument.substring(1), args, i, zWartosciami);
            }
        }
    }

    /** Obsługuje --nazwa=wartosc i --nazwa wartosc; zwraca indeks ostatniego zużytego argumentu. */
    private int czytajDluga(String tresc, String[] args, int i, Set<String> zWartosciami) {
        int rownosc = tresc.indexOf('=');
        if (rownosc >= 0) {
            wartosci.put(tresc.substring(0, rownosc), tresc.substring(rownosc + 1));
        } else if (!zWartosciami.contains(tresc)) {
            flagi.add(tresc);
        } else if (i + 1 < args.length && !args[i + 1].equals("--")) {
            wartosci.put(tresc, args[i + 1]);
            i++;                                     // wartość zabrana z kolejnego argumentu
        } else {
            throw new IllegalArgumentException("Opcja --" + tresc + " wymaga wartości.");
        }
        return i;
    }

    /** Obsługuje -v, sklejone flagi -vf oraz krótką opcję z wartością: -o plik i -oplik. */
    private int czytajKrotkie(String litery, String[] args, int i, Set<String> zWartosciami) {
        for (int k = 0; k < litery.length(); k++) {
            String nazwa = String.valueOf(litery.charAt(k));
            if (!zWartosciami.contains(nazwa)) {
                flagi.add(nazwa);
            } else if (k + 1 < litery.length()) {
                wartosci.put(nazwa, litery.substring(k + 1));   // reszta sklejki jest wartością
                return i;
            } else if (i + 1 < args.length && !args[i + 1].equals("--")) {
                wartosci.put(nazwa, args[i + 1]);
                return i + 1;
            } else {
                throw new IllegalArgumentException("Opcja -" + nazwa + " wymaga wartości.");
            }
        }
        return i;
    }

    // Odczyt: tekst() i liczba() mają wartość domyślną, wymagany() przerywa działanie programu.
    public boolean flaga(String nazwa) { return flagi.contains(nazwa); }

    public String tekst(String nazwa, String domyslna) { return wartosci.getOrDefault(nazwa, domyslna); }

    public List<String> pozycyjne() { return List.copyOf(pozycyjne); }

    public int liczba(String nazwa, int domyslna) {
        String wartosc = wartosci.get(nazwa);
        if (wartosc == null) { return domyslna; }
        try {
            return Integer.parseInt(wartosc.trim());
        } catch (NumberFormatException blad) {   // literówka ma dać komunikat, a nie ciche zero
            throw new IllegalArgumentException("Opcja --" + nazwa + " oczekuje liczby: " + wartosc);
        }
    }

    public String wymagany(String nazwa) {
        String wartosc = wartosci.get(nazwa);
        if (wartosc == null || wartosc.isBlank()) {
            throw new IllegalArgumentException("Brak wymaganej opcji --" + nazwa + ". Zobacz --pomoc.");
        }
        return wartosc;
    }

    public static String pomoc() {
        return """
                Użycie: java ArgumentyPolecen [opcje] [--] plik...
                  --wyjscie=PLIK | --wyjscie PLIK   plik wynikowy (wymagany)
                  --szerokosc N                     szerokość kolumny (domyślnie 72)
                  -o PLIK | -oPLIK                  krótka opcja z wartością
                  --tryb-cichy, -v, -f              flagi logiczne, można łączyć: -vf
                  --pomoc                           ten opis
                Wszystko po samotnym -- jest nazwą pliku, nawet gdy zaczyna się od myślnika.""";
    }

    private static void pokaz(String opis, String... args) {
        System.out.println("== " + opis);
        try {
            ArgumentyPolecen opcje = new ArgumentyPolecen(args, "wyjscie", "szerokosc", "o");
            if (opcje.flaga("pomoc")) { System.out.println(pomoc()); return; }
            System.out.println("  wyjście=" + opcje.wymagany("wyjscie") + ", szerokość="
                    + opcje.liczba("szerokosc", 72) + ", -o=" + opcje.tekst("o", "brak"));
            System.out.println("  cichy/v/f=" + opcje.flaga("tryb-cichy") + "/" + opcje.flaga("v")
                    + "/" + opcje.flaga("f") + ", pliki=" + opcje.pozycyjne());
        } catch (IllegalArgumentException blad) {
            System.out.println("  Błąd: " + blad.getMessage());   // tak reaguje program konsolowy
        }
    }

    // ── PRZYKŁADY ───────────────────────────────────────────
    public static void main(String[] args) {
        if (args.length > 0) { pokaz("argumenty z konsoli", args); return; }
        pokaz("pełne wywołanie", "--wyjscie=raport.txt", "--szerokosc", "100", "-owynik.txt",
                "--tryb-cichy", "-vf", "dane.csv", "--", "--plik-z-myslnikiem.csv");
        pokaz("pusta tablica args");
        pokaz("zła liczba", "-o", "wynik.txt", "--wyjscie", "raport.txt", "--szerokosc=sto");
        pokaz("prośba o pomoc", "--pomoc");
    }
}