Abseil Code Review · 64/79

Abseil ParseCommandLine 동작

2026년 6월 13일 · Hawk · 2분 읽기

#한 줄의 boilerplate

1
#include "absl/flags/parse.h"
2

3
int main(int argc, char** argv) {
4
    std::vector<char*> positional = absl::ParseCommandLine(argc, argv);
5
    // 이후 GetFlag로 flag 값 읽기
6
}

ParseCommandLine은 argv를 모두 소비해 flag로 인식되는 것은 registry에 적용하고, 인식 안 되는 positional 인자는 반환.

#flag 구문

지원되는 형식:

1
./app --port=8080
2
./app --port 8080
3
./app --no-verbose            # bool 부정
4
./app -p 8080                 # short form (드물게 사용)
5
./app -- positional_arg_only  # 이후 모두 positional

bool은 다음 모두 동등.

1
--verbose --verbose=true --verbose=1
2
--no-verbose --verbose=false --verbose=0

#—help / —helpfull / —helpshort

ParseCommandLine이 자동 처리. 발견 즉시 출력 후 exit.

1
./app --help        # 현재 모듈의 flag만
2
./app --helpfull    # 모든 flag (의존 lib 포함)
3
./app --helpshort   # 짧은 요약

--help 출력은 flag 등록 시 의 help 문자열을 자동 모음.

#—flagfile — 파일에서 읽기

1
./app --flagfile=/etc/myapp.flags

파일에 한 줄 한 flag.

1
--port=9090
2
--timeout=30s
3
--verbose

여러 환경별 설정 관리에 유용. CLI override:

1
./app --flagfile=/etc/myapp.flags --port=80   # 파일 + override

#환경 변수 — undocumented but supported

Abseil은 환경 변수 자동 읽기를 기본 지원하지 않는다. 환경 변수 기반이 필요하면 명시적으로:

1
const char* env = std::getenv("MYAPP_PORT");
2
if (env) absl::SetFlag(&FLAGS_port, std::stoi(env));

또는 ParseAbseilFlagsOnly 후 환경 변수 매핑 단계를 추가.

#알 수 없는 flag 처리

기본은 fatal error — 알 수 없는 flag면 exit.

1
./app --unknown_flag=x
2
# F0525 ...: ERROR: --unknown_flag=x: unknown flag

--undefok=foo,bar로 특정 flag를 허용할 수 있다(테스트·prototyping에서만).

#ParseAbseilFlagsOnly

ParseCommandLine이 abseil flag뿐 아니라 모든 등록 flag를 처리한다. 내가 등록한 것만 처리하려면 ParseAbseilFlagsOnly 변종. 라이브러리 차원에서 미세 통제가 필요한 드문 경우.

대부분 main에서는 ParseCommandLine 한 줄로 충분.

#main의 표준 패턴

1
int main(int argc, char** argv) {
2
    // 1. flag 파싱
3
    std::vector<char*> positional = absl::ParseCommandLine(argc, argv);
4

5
    // 2. 심볼라이저 + failure handler (Part 11-04)
6
    absl::InitializeSymbolizer(argv[0]);
7
    absl::InstallFailureSignalHandler({});
8

9
    // 3. log 초기화
10
    absl::InitializeLog();
11

12
    // 4. positional 처리
13
    if (positional.size() < 2) {
14
        std::cerr << "usage: " << positional[0] << " <input-file>\n";
15
        return 1;
16
    }
17
    std::string input_file = positional[1];
18

19
    // 5. 실제 작업
20
    return Run(input_file);
21
}

ParseCommandLine을 가장 먼저 부른다. 이후 코드가 flag·log 등을 자유롭게 쓸 수 있다.

#positional 인자

1
./app --port=8080 input.txt output.txt

positional 벡터:

1
positional[0] = "./app";
2
positional[1] = "input.txt";
3
positional[2] = "output.txt";

--로 명시적 구분도 가능.

1
./app --port=8080 -- --not-a-flag
2
# positional: ["./app", "--not-a-flag"]

#SetCommandLine* helper

테스트에서 argv 시뮬레이션:

1
const char* argv[] = {"test", "--port=9999", "in.txt", nullptr};
2
auto pos = absl::ParseCommandLine(3, const_cast<char**>(argv));
3
EXPECT_EQ(absl::GetFlag(FLAGS_port), 9999);
4
EXPECT_EQ(pos.size(), 2);   // {"test", "in.txt"}

ParseCommandLine은 한 프로세스에서 여러 번 호출 안전. 테스트 fixture에서 매번 다시 호출 가능.

#회피 패턴

1
// 회피 — argv 직접 파싱
2
for (int i = 1; i < argc; ++i) {
3
    if (std::strcmp(argv[i], "--port") == 0) { ... }   // ❌ boilerplate
4
}
5

6
// Good
7
absl::ParseCommandLine(argc, argv);
8
int p = absl::GetFlag(FLAGS_port);

1
// 회피 — ParseCommandLine 이전에 LOG
2
int main(int argc, char** argv) {
3
    LOG(INFO) << "boot";   // ❌ log 초기화 전, severity flag 미적용
4
    absl::ParseCommandLine(argc, argv);
5
}
6

7
// Good — 순서 지킴
8
int main(int argc, char** argv) {
9
    absl::ParseCommandLine(argc, argv);
10
    absl::InitializeLog();
11
    LOG(INFO) << "boot";
12
}

1
// 회피 — Parse 결과 무시
2
int main(int argc, char** argv) {
3
    absl::ParseCommandLine(argc, argv);
4
    // ... positional이 필요한데 ignore
5
}
6

7
// Good
8
auto positional = absl::ParseCommandLine(argc, argv);