Chế độ giao diện
3.5. Độ Phức Tạp Phần Mềm và Quản Trị Mã Nguồn (Software Complexity & Code Smells)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: Độ phức tạp của phần mềm không đo bằng số dòng mã (LOC), mà đo bằng gánh nặng nhận thức đặt lên bộ nhớ làm việc của con người (
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
Ẩn dụ Đời sống: Nút Giao Thông Đa Tầng và Dung Lượng Bộ Nhớ Làm Việc
Hãy hình dung hệ thống mã nguồn như một mạng lưới giao thông đô thị:
- Đoạn đường thẳng (Mã tuần tự - Linear Code): Phương tiện di chuyển với vận tốc đều, không có điểm giao cắt, tài xế không cần xử lý nhiều tín hiệu. Độ phức tạp chu trình bằng
. - Bùng binh và Ngã năm lồng nhau (Nested Branching - Cyclomatic & Cognitive Complexity): Càng nhiều lối rẽ (
if-else,switch,for), người lái càng phải phanh gấp, quan sát 360 độ và tính toán rủi ro va chạm. Nếu có 4 ngã rẽ lồng nhau, não bộ tài xế bị quá tải (vượt quá giới hạn thông tin của George Miller), tai nạn (bugs) chắc chắn xảy ra. - Xe chở rác quá tải (God Class / Long Method): Một chiếc xe container chở mọi thứ từ xi măng, thực phẩm đến rác thải, đi qua mọi ngõ ngách, gây tắc nghẽn toàn bộ luồng lưu thông của cả thành phố.
- Thước đo Radar & Trạm cân tự động (Quality Gates & Complexity Budget): Các cảm biến đo mật độ phương tiện trên đường cao tốc. Nếu vượt quá ngưỡng an toàn cho phép, barie tự động hạ xuống chặn xe (Block Pull Request) để tránh sụp đổ mạng lưới.
flowchart TD
subgraph InputCode["Mã Nguồn Đầu Vào (Source Code AST)"]
CFG["Control Flow Graph (CFG)<br/>Đồ thị Nodes (N) & Edges (E)"]
Tokens["Lexical Tokens<br/>Operators (η1) & Operands (η2)"]
end
subgraph MetricsEngine["Hệ Thống Chỉ Số Định Lượng (Quantitative Metrics)"]
CFG --> M1["Cyclomatic Complexity (McCabe)<br/>M = E - N + 2P"]
CFG --> M2["Cognitive Complexity (SonarSource)<br/>Nesting Level Penalties"]
Tokens --> M3["Halstead Metrics<br/>Volume V, Effort E, Bugs B"]
M1 & M3 --> M4["Maintainability Index (MI)<br/>Thang điểm 0 - 100"]
end
subgraph Smells["Dấu Hiệu Mã Có Mùi (Code Smells Detection)"]
M1 --> S1["Long Method (> 50 LOC)"]
M4 --> S2["God Class / Large Class"]
AST_Scan["AST Pattern Scan"] --> S3["Feature Envy (Move Method)"]
AST_Scan --> S4["Primitive Obsession (Value Objects)"]
end
subgraph Governance["Kỹ Nghệ Quản Trị (CI/CD Governance)"]
M1 & M2 & M4 --> QG{"Quality Gate Rules<br/>M <= 10? MI >= 85?"}
QG -- "Passed" --> PASS["Merge Pull Request Thành Công"]
QG -- "Violated" --> FAIL["Block Merge: Yêu Cầu Refactor"]
end
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Cyclomatic Complexity (McCabe) và Đồ thị Luồng Điều khiển (CFG)
Được đề xuất bởi Thomas J. McCabe năm 1976, Cyclomatic Complexity (Độ phức tạp chu trình -
Về mặt lý thuyết đồ thị, mã nguồn được biểu diễn dưới dạng một Control Flow Graph (CFG) gồm tập các đỉnh
Trong đó:
: Số lượng cạnh kết nối trong đồ thị. : Số lượng nút (nút lệnh và nút rẽ nhánh). : Số lượng thành phần liên thông (Connected Components, đối với một hàm đơn lẻ, ).
Quy tắc tính nhanh: Một hàm bắt đầu với if, while, for, case, catch, &&, ||, ?:), giá trị
flowchart TD
Start([Node 1: Entry]) --> Cond1{Node 2: if score >= 80}
Cond1 -- "True" --> Cond2{Node 3: if hasBonus}
Cond1 -- "False" --> PathC[Node 5: grade = 'F']
Cond2 -- "True" --> PathA[Node 4a: grade = 'A+']
Cond2 -- "False" --> PathB[Node 4b: grade = 'A']
PathA --> Merge[Node 6: Return grade]
PathB --> Merge
PathC --> Merge
Merge --> ExitNode([Node 7: Exit])
Phân tích đồ thị trên:
Ngưỡng Chuẩn Kỹ Thuật:
: Cấu trúc tinh giản, rủi ro thấp, khả năng bảo trì cao. : Độ phức tạp trung bình, cần chú ý khi viết test. : Rất phức tạp, rủi ro cao, bắt buộc phải refactor. : Mã nguồn không thể kiểm thử hoàn chỉnh (Untestable), là quả bom nổ chậm trong hệ thống.
2.2. Cognitive Complexity (SonarSource) và Trọng số Nhận thức
Mặc dù Cyclomatic Complexity rất hữu ích cho việc tính toán số lượng Unit Tests, nó có một nhược điểm nghiêm trọng: Không phản ánh độ khó của não bộ khi đọc hiểu code.
Ví dụ: Một cấu trúc switch-case với 10 nhánh đơn giản có Cyclomatic Complexity bằng for lồng nhau sâu 4 tầng có cùng điểm Cyclomatic bằng
Để giải quyết vấn đề này, SonarSource phát triển Cognitive Complexity (Độ phức tạp nhận thức) dựa trên 3 nguyên tắc:
- Bỏ qua các cú pháp rút gọn: Các cấu trúc ngữ nghĩa đơn giản, quen thuộc không bị phạt điểm nặng.
- Phạt điểm lũy tiến theo độ sâu lồng nhau (Nesting Penalties): Một mệnh đề
ifở tầng thứ nhất chỉ nhận điểm. Nhưng nếu mệnh đềifđó nằm bên trong một vòngforvà một khốitry-catch, nó sẽ nhận điểm! - Phạt các cấu trúc làm gián đoạn luồng suy nghĩ: Đệ quy, nhảy nhãn (
goto,break label), toán tử logic kết hợp phức tạp (a && b || c && d).
2.3. Halstead Complexity Metrics & Maintainability Index (MI)
1. Các Đại lượng Halstead
Maurice Halstead (1977) phân tích mã nguồn dưới góc độ độ dài từ vựng dựa trên hai tập hợp nguyên tử:
: Số lượng toán tử phân biệt (Unique Operators:+,-,*,if,return...). : Số lượng toán hạng phân biệt (Unique Operands: tên biến, hằng số...). : Tổng số lần xuất hiện của các toán tử. : Tổng số lần xuất hiện của các toán hạng.
Từ các đại lượng trên, Halstead tính toán:
- Từ vựng chương trình (Program Vocabulary):
. - Chiều dài chương trình (Program Length):
. - Dung lượng chương trình (Program Volume):
(Đơn vị: bits). - Độ khó của chương trình (Difficulty):
. - Nỗ lực lập trình (Effort):
. - Số lỗi ước tính trong mã (Estimated Bugs):
.
2. Maintainability Index (Chỉ Số Khả Năng Bảo Trì - MI)
Được phát triển bởi Viện Công nghệ Phần mềm Đại học Idaho và chuẩn hóa bởi Microsoft Visual Studio, MI là chỉ số tổng hợp đánh giá độ "lành mạnh" của mã nguồn trên thang điểm
: Xanh lá (High Maintainability) - Mã sạch, module hóa tốt. : Vàng (Moderate Maintainability) - Bắt đầu xuất hiện nợ kỹ thuật, cần theo dõi. : Đỏ (Low Maintainability) - Mã di sản (Legacy code), rủi ro cao khi thay đổi.
2.4. Classic Code Smells: Long Method, Large Class & Feature Envy
Theo định nghĩa của Martin Fowler và Kent Beck trong cuốn sách kinh điển Refactoring, Code Smells (Mùi của mã) là những triệu chứng bề mặt cho thấy những khiếm khuyết sâu xa trong kiến trúc phần mềm:
Long Method (Phương thức Quá Dài):
- Một hàm kéo dài trên 50 dòng thực hiện cùng lúc nhiều cấp độ trừu tượng khác nhau (vừa phân tích JSON, vừa ghi cơ sở dữ liệu, vừa gửi email).
- Liều thuốc: Áp dụng kỹ thuật
Extract Methodđể đưa các khối lệnh con về đúng tên gọi ngữ nghĩa, giữ mỗi hàm chỉ làm một việc duy nhất (SRP).
Large Class / God Class (Lớp Thần Thánh):
- Một class nắm giữ hàng chục biến thành viên và hàng nghìn dòng lệnh, đóng vai trò điều khiển mọi thực thể khác trong hệ thống.
- Liều thuốc: Áp dụng
Extract Class, phân rã thành các Aggregate Roots và Domain Services nhỏ hơn.
Feature Envy (Ghen Tị Tính Năng):
- Xảy ra khi một phương thức của Class
liên tục truy vấn và thao tác trên các trường dữ liệu của Class nhiều hơn chính dữ liệu của Class . - Liều thuốc: Áp dụng
Move Method, chuyển logic tính toán sang chính Class để tuân thủ nguyên lý Information Expert (Dữ liệu ở đâu, hành vi ở đó).
- Xảy ra khi một phương thức của Class
2.5. Primitive Obsession và Giải pháp Domain Value Objects
Primitive Obsession (Ám ảnh kiểu nguyên thủy) là thói quen xấu phổ biến của các lập trình viên mới vào nghề: Sử dụng tràn lan các kiểu dữ liệu cơ bản (std::string, int, float, dict) để mô tả các khái niệm nghiệp vụ phức tạp:
- Dùng
std::stringđể lưu cả Email, Địa chỉ IP, Mã tiền tệ, UUID, Số điện thoại. - Dùng
doubleđể tính toán tiền tệ (gây sai số dấu phẩy động IEEE-754: ). - Truyền liên tiếp 5 tham số kiểu
std::stringvào hàm:createUser(name, email, address, phone, zip). Khi bên gọi truyền nhầm thứ tựnamevàemail, Compiler hoàn toàn bất lực không thể cảnh báo!
Giải pháp Chuẩn mực: Xây dựng Strongly-Typed Domain Value Objects:
- Đóng gói dữ liệu nguyên thủy vào một cấu trúc có kiểu định danh rõ ràng.
- Tự động kiểm tra tính hợp lệ (Self-Validation) ngay trong Constructor.
- Bất biến (Immutable): Một khi đã tạo ra thì không thể thay đổi giá trị.
- Bình đẳng theo giá trị (Value Equality), không bình đẳng theo con trỏ ID.
2.6. Complexity Budget & Governance trong Modern CI/CD
Để giữ cho hệ thống không bị mục ruỗng qua năm tháng, các đội ngũ kỹ thuật hàng đầu áp dụng Complexity Budget (Ngân sách Độ phức tạp) vào chu trình tích hợp liên tục (CI/CD):
- Static Quality Gates:
- Mọi Pull Request (PR) phải chạy qua các công cụ phân tích tĩnh (SonarQube, Clang-Tidy, ESLint, Lizard).
- Quy tắc Chặn (Block Merging):
- Không cho phép bất kỳ hàm mới nào có
hoặc Cognitive Complexity . - Maintainability Index tổng thể của repository không được giảm quá
sau mỗi đợt phát hành. - Tỷ lệ mã trùng lặp (Duplication Density) phải
.
- Không cho phép bất kỳ hàm mới nào có
- Boy Scout Rule trong Quản Trị:
- "Hãy luôn để khu cắm trại sạch hơn lúc bạn đến". Khi một kỹ sư sửa một dòng bug trong một hàm có
, họ được yêu cầu phải chiết xuất và hạ độ phức tạp của hàm đó xuống ít nhất .
- "Hãy luôn để khu cắm trại sạch hơn lúc bạn đến". Khi một kỹ sư sửa một dòng bug trong một hàm có
3. Thực thi Mã nguồn & Mô phỏng Chuyên sâu (Dual-Engine Implementation)
3.1. C++20 Implementation: Khắc Phục Primitive Obsession Bằng Strongly-Typed Value Objects
Đoạn mã C++20 dưới đây minh họa việc chuyển đổi từ mã nguồn "mắc mùi" Primitive Obsession sang kiến trúc Type-Safe chuẩn Domain-Driven Design sử dụng Value Objects bất biến.
cpp
#include <iostream>
#include <string>
#include <regex>
#include <stdexcept>
#include <compare>
#include <utility>
// ============================================================================
// 1. CÁCH LÀM KÉM (PRIMITIVE OBSESSION ANTIPATTERN)
// ============================================================================
// Hàm nhận các tham số thô: Rất dễ bị hoán đổi nhầm thứ tự giữa sender & receiver!
void unsafeTransfer(std::string senderEmail, std::string receiverEmail, double amount) {
// Trình biên dịch không thể bắt lỗi nếu lập trình viên gọi:
// unsafeTransfer("bob@example.com", "alice@example.com", -50.0);
std::cout << "[Unsafe] Transferring $" << amount << " from " << senderEmail << " to " << receiverEmail << "\n";
}
// ============================================================================
// 2. GIẢI PHÁP ENTERPRISE: DOMAIN VALUE OBJECTS CHUẨN C++20
// ============================================================================
// Value Object: EmailAddress (Bất biến, Tự kiểm tra, Type-Safe)
class EmailAddress {
private:
std::string value_;
static bool validate(const std::string& email) {
// Biểu thức chính quy kiểm tra định dạng email tiêu chuẩn
static const std::regex kEmailRegex(
R"(^[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+$)"
);
return std::regex_match(email, kEmailRegex);
}
public:
explicit EmailAddress(std::string email) : value_(std::move(email)) {
if (!validate(value_)) {
throw std::invalid_argument("Invalid Email Format: '" + value_ + "'");
}
}
[[nodiscard]] const std::string& str() const noexcept { return value_; }
// C++20 Spaceship Operator cho phép so sánh giá trị tự động
auto operator<=>(const EmailAddress&) const = default;
};
// Value Object: Money (Ngăn chặn sai số Floating-point bằng cách dùng Cents)
class Money {
private:
int64_t cents_{0};
public:
explicit constexpr Money(int64_t cents) : cents_(cents) {
if (cents < 0) {
throw std::invalid_argument("Money cannot be negative!");
}
}
[[nodiscard]] static constexpr Money fromDollars(int64_t dollars, int64_t cents) {
return Money(dollars * 100 + cents);
}
[[nodiscard]] int64_t cents() const noexcept { return cents_; }
[[nodiscard]] double toDollars() const noexcept { return static_cast<double>(cents_) / 100.0; }
constexpr Money operator+(const Money& other) const {
return Money(cents_ + other.cents_);
}
auto operator<=>(const Money&) const = default;
};
// Hàm có tính toàn vẹn tuyệt đối: Compiler phát hiện lỗi lập tức nếu sai kiểu!
void safeTransfer(const EmailAddress& from, const EmailAddress& to, Money amount) {
std::cout << "[Type-Safe Core Domain] Transferring $" << amount.toDollars()
<< " (" << amount.cents() << " cents) from "
<< from.str() << " to " << to.str() << " -> SUCCESS\n";
}
int main() {
std::cout << "=== C++20 Value Objects & Type-Safety Demo ===\n";
// Thử nghiệm cách làm nguy hiểm (Primitive Obsession)
unsafeTransfer("alice@corp.com", "bob@corp.com", 150.0);
// Thử nghiệm cách làm Type-Safe
try {
EmailAddress sender("alice@corp.com");
EmailAddress recipient("bob@corp.com");
Money transferAmount = Money::fromDollars(250, 75); // $250.75
safeTransfer(sender, recipient, transferAmount);
// Kiểm tra Equality theo giá trị
EmailAddress senderClone("alice@corp.com");
if (sender == senderClone) {
std::cout << "[Value Object Equality] Sender and Clone are strictly equal by value!\n";
}
// Test Case cố tình truyền sai định dạng email
std::cout << "\n[Validation Test] Attempting to construct invalid email...\n";
EmailAddress malformed("not-an-email-string");
} catch (const std::exception& ex) {
std::cout << " -> Compiler & Runtime Shield: Caught exception: " << ex.what() << "\n";
}
return 0;
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
Terminal Output Mẫu (C++20):
text
=== C++20 Value Objects & Type-Safety Demo ===
[Unsafe] Transferring $150 from alice@corp.com to bob@corp.com
[Type-Safe Core Domain] Transferring $250.75 (25075 cents) from alice@corp.com to bob@corp.com -> SUCCESS
[Value Object Equality] Sender and Clone are strictly equal by value!
[Validation Test] Attempting to construct invalid email...
-> Compiler & Runtime Shield: Caught exception: Invalid Email Format: 'not-an-email-string'1
2
3
4
5
6
7
2
3
4
5
6
7
3.2. Python 3.11+ Implementation: AST-Based Cyclomatic & Cognitive Complexity Analyzer
Script Python 3.11+ dưới đây phân tích cú pháp trừu tượng (Abstract Syntax Tree - AST) của mã nguồn Python để tự động tính toán Cyclomatic Complexity (
python
from __future__ import annotations
import ast
import inspect
from typing import Any
class ComplexityAnalyzer(ast.NodeVisitor):
def __init__(self):
self.cyclomatic_complexity: int = 1
self.cognitive_complexity: int = 0
self.current_nesting: int = 0
def _increase_cognitive(self, base_cost: int = 1):
"""Phạt điểm nhận thức: Phí gốc + Phí theo độ sâu lồng nhau."""
self.cognitive_complexity += (base_cost + self.current_nesting)
# 1. Đo lường rẽ nhánh If
def visit_If(self, node: ast.If):
self.cyclomatic_complexity += 1
self._increase_cognitive(1)
# Tăng nesting khi bước vào thân if
self.current_nesting += 1
self.generic_visit(node)
self.current_nesting -= 1
# 2. Đo lường vòng lặp For
def visit_For(self, node: ast.For):
self.cyclomatic_complexity += 1
self._increase_cognitive(1)
self.current_nesting += 1
self.generic_visit(node)
self.current_nesting -= 1
# 3. Đo lường vòng lặp While
def visit_While(self, node: ast.While):
self.cyclomatic_complexity += 1
self._increase_cognitive(1)
self.current_nesting += 1
self.generic_visit(node)
self.current_nesting -= 1
# 4. Đo lường khối Except (Try-Catch)
def visit_ExceptHandler(self, node: ast.ExceptHandler):
self.cyclomatic_complexity += 1
self._increase_cognitive(1)
self.current_nesting += 1
self.generic_visit(node)
self.current_nesting -= 1
# 5. Đo lường các toán tử logic Booleans (and, or)
def visit_BoolOp(self, node: ast.BoolOp):
# Mỗi toán tử and/or làm tăng 1 đường rẽ nhánh
self.cyclomatic_complexity += len(node.values) - 1
self.cognitive_complexity += len(node.values) - 1
self.generic_visit(node)
def audit_function(func: Any) -> tuple[int, int]:
source = inspect.getsource(func)
tree = ast.parse(source)
analyzer = ComplexityAnalyzer()
analyzer.visit(tree)
return analyzer.cyclomatic_complexity, analyzer.cognitive_complexity
# ============================================================================
# CÁC HÀM THỬ NGHIỆM ĐÁNH GIÁ ĐỘ PHỨC TẠP
# ============================================================================
def simple_function(x: int) -> int:
"""Mã tuần tự đơn giản: M = 1, Cognitive = 0"""
result = x * 2
return result + 10
def complex_nested_spaghetti(data: list[list[int]], threshold: int, flag: bool) -> int:
"""Hàm phức tạp với nhiều tầng lồng nhau: Sinh ra Cognitive Complexity rất cao"""
total = 0
if flag: # CC +1, Cog +1
for row in data: # CC +1, Cog +(1 + 1) = +2
for val in row: # CC +1, Cog +(1 + 2) = +3
if val > threshold and val % 2 == 0: # CC +2, Cog +(1 + 3) + 1 = +5
total += val
else:
total -= 1
return total
if __name__ == "__main__":
print("=== Python 3.11+ AST Software Complexity Scanner ===")
# Đánh giá hàm 1
m1, c1 = audit_function(simple_function)
print(f"\n[simple_function]")
print(f" -> Cyclomatic Complexity (McCabe) : {m1}")
print(f" -> Cognitive Complexity (Sonar) : {c1}")
print(f" -> Evaluation : Clean & Maintainable")
# Đánh giá hàm 2
m2, c2 = audit_function(complex_nested_spaghetti)
print(f"\n[complex_nested_spaghetti]")
print(f" -> Cyclomatic Complexity (McCabe) : {m2}")
print(f" -> Cognitive Complexity (Sonar) : {c2}")
print(f" -> Evaluation : CRITICAL WARNING! Exceeds mental budget (Nesting depth)")
# Quality Gate Assertion
COMPLEXITY_BUDGET = 5
print(f"\n[CI/CD Quality Gate Check (Max Allowed = {COMPLEXITY_BUDGET})]")
if m2 > COMPLEXITY_BUDGET or c2 > COMPLEXITY_BUDGET:
print(" ❌ QUALITY GATE FAILED: Pull Request rejected! Please refactor nested loops.")
else:
print(" ✅ QUALITY GATE PASSED.")1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
Terminal Output Mẫu (Python 3.11+):
text
=== Python 3.11+ AST Software Complexity Scanner ===
[simple_function]
-> Cyclomatic Complexity (McCabe) : 1
-> Cognitive Complexity (Sonar) : 0
-> Evaluation : Clean & Maintainable
[complex_nested_spaghetti]
-> Cyclomatic Complexity (McCabe) : 6
-> Cognitive Complexity (Sonar) : 12
-> Evaluation : CRITICAL WARNING! Exceeds mental budget (Nesting depth)
[CI/CD Quality Gate Check (Max Allowed = 5)]
❌ QUALITY GATE FAILED: Pull Request rejected! Please refactor nested loops.1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
4. Systems Engineering & Production Pitfalls
Các Cạm Bẫy Thực Chiến (Gotchas & Production Antipatterns)
Sự Bất Lực Của Cyclomatic Complexity Đối Với Bất Đồng Bộ (Async/Await & Concurrency):
- Bản chất: Cyclomatic Complexity tính toán dựa trên mã đồng bộ tuần tự (Sequential CFG). Khi xuất hiện các luồng bất đồng bộ (
async/await, Goroutines, Thread Pools), một hàm có thể có nhưng độ phức tạp về mặt Race Conditions, Deadlocks và Non-deterministic State lại là vô cực! - Khắc phục: Không chỉ dựa vào McCabe; kết hợp mô hình hóa hình thức (Formal Verification như TLA+ hoặc Petri Nets) và công cụ ThreadSanitizer cho các module đa luồng.
- Bản chất: Cyclomatic Complexity tính toán dựa trên mã đồng bộ tuần tự (Sequential CFG). Khi xuất hiện các luồng bất đồng bộ (
Hội Chứng Refactoring Hình Thức (Cheat Complexity Metrics):
- Bản chất: Để qua mặt Quality Gate trên CI (
), kỹ sư dùng mẹo chia nhỏ một hàm phức tạp thành 10 hàm con 3 dòng (helper1,helper2...) nhưng vẫn chia sẻ trạng thái toàn cục hoặc truyền tham số dày đặc. Việc này làm giảm Cyclomatic Complexity của từng hàm nhưng làm tăng tổng độ phức tạp toàn cục (Shotgun Surgery Smell) và làm mã khó đọc hơn trước! - Khắc phục: Refactor phải đi kèm việc cô lập trách nhiệm nghiệp vụ (Domain Boundaries) chứ không đơn thuần là cắt vụn dòng code.
- Bản chất: Để qua mặt Quality Gate trên CI (
Cơ Chế Bỏ Qua Cổng Chất Lượng Khi Hotfix Khẩn Cấp:
- Bản chất: Khi hệ thống Production bị sập, ban lãnh đạo thường cho phép gắn cờ
[skip ci]hoặc// NOSONARđể đẩy bản vá lỗi nhanh nhất có thể. Tuy nhiên, hơn các khoản nợ kỹ thuật độc hại nhất lại bắt nguồn từ các bản hotfix này và không bao giờ được trả lại. - Khắc phục: Thiết lập quy trình "Technical Debt Ticket": Mọi lệnh bypass Quality Gate trong trường hợp khẩn cấp phải tự động kích hoạt tạo một Jira Ticket mức P1 để đội ngũ tái cấu trúc lại trong sprint kế tiếp.
- Bản chất: Khi hệ thống Production bị sập, ban lãnh đạo thường cho phép gắn cờ
Kỹ Thuật Chẩn Đoán Độ Phức Tạp Bằng CLI:
bash# 1. Quét Cyclomatic Complexity toàn bộ dự án C++ / Python bằng Lizard CLI lizard src/ -C 10 -a 5 -w # 2. Quét Maintainability Index (MI) cho Python bằng Radon radon mi src/ -s # 3. Quét phát hiện Code Smells và Primitive Obsession bằng SonarScanner CLI sonar-scanner \ -Dsonar.projectKey=core-enterprise-engine \ -Dsonar.sources=src \ -Dsonar.qualitygate.wait=true # 4. Kiểm tra cảnh báo hàm quá dài trong C++ bằng Clang-Tidy clang-tidy src/main.cpp -checks="readability-function-size,readability-cognitive-complexity" -- -std=c++201
2
3
4
5
6
7
8
9
10
11
12
13
14
5. Bảng So sánh & Decision Matrix
5.1. So Sánh Các Thước Đo Độ Phức Tạp Mã Nguồn
| Thước Đo | Cơ Chế Đo Lường | Điểm Mạnh | Hạn Chế Cốt Lõi | Ngưỡng Khuyến Nghị |
|---|---|---|---|---|
| Cyclomatic Complexity (McCabe) | Đồ thị luồng điều khiển ( | Xác định chính xác số lượng ca kiểm thử Unit Test cần thiết | Coi các rẽ nhánh phẳng (switch-case) nặng bằng lồng sâu (nested if) | |
| Cognitive Complexity (SonarSource) | Phạt điểm gia tăng theo độ sâu lồng nhau (Nesting) | Phản ánh chân thực nỗ lực nhận thức của não bộ lập trình viên | Không trực tiếp ánh xạ ra số lượng ca kiểm thử cần viết | |
| Halstead Program Volume | Số lượng Toán tử ( | Đánh giá dung lượng thông tin và thời gian code dự kiến | Bị phụ thuộc vào phong cách đặt tên biến và độ dài biểu thức | |
| Maintainability Index (MI) | Kết hợp Logarit của Volume, McCabe và LOC | Cung cấp chỉ số tổng quan từ | Công thức thực nghiệm, đôi khi đánh giá quá cao số dòng mã |
5.2. Ma Trận Phát Hiện & Xử Lý Code Smells Kinh Điển
| Code Smell | Dấu Hiệu Nhận Biết | Hậu Quả Hệ Thống | Kỹ Thuật Refactoring Chuẩn Mực |
|---|---|---|---|
| Long Method | Hàm | Khó kiểm thử, độ phức tạp nhận thức cao | Extract Method, Replace Temp with Query |
| Large Class (God Class) | Class | Vi phạm SRP, xung đột Git khi merge liên tục | Extract Class, Extract Subclass, DDD Aggregates |
| Feature Envy | Class | Ghép nối chặt (Tight Coupling), phân tán logic | Move Method, Extract & Move Method |
| Primitive Obsession | Dùng string/int cho Email, Tiền, Phone | Dễ truyền nhầm thứ tự, thiếu xác thực giá trị | Replace Primitive with Value Object |
| Shotgun Surgery | Mỗi lần đổi 1 logic phải sửa ở 10 files khác nhau | Dễ bỏ sót file dẫn đến bug ngầm trên production | Move Field/Method, Inline Class gom logic lại |
IyAzLjUuIMSQ4buZIFBo4bupYyBU4bqhcCBQaOG6p24gTeG7gW0gdsOgIFF14bqjbiBUcuG7iyBNw6MgTmd14buTbiAoU29mdHdhcmUgQ29tcGxleGl0eSAmIENvZGUgU21lbGxzKQ0KDQo+IFshSU1QT1JUQU5UXQ0KPiAqKk7hur91IGLhuqFuIGNo4buJIMSRxrDhu6NjIG5o4bubIG3hu5l0IMSRaeG7gXUgZHV5IG5o4bqldDoqKiDEkOG7mSBwaOG7qWMgdOG6oXAgY+G7p2EgcGjhuqduIG3hu4FtIGtow7RuZyDEkW8gYuG6sW5nIHPhu5EgZMOybmcgbcOjIChMT0MpLCBtw6AgxJFvIGLhurFuZyBnw6FuaCBu4bq3bmcgbmjhuq1uIHRo4bupYyDEkeG6t3QgbMOqbiBi4buZIG5o4bubIGzDoG0gdmnhu4djIGPhu6dhIGNvbiBuZ8aw4budaSAoJDcgXHBtIDIkIGNodW5rcykgdsOgIHPhu5EgbMaw4bujbmcgxJHGsOG7nW5nIGThuqtuIHRo4buxYyB0aGkgxJHhu5ljIGzhuq1wIHh1ecOqbiBzdeG7kXQgxJHhu5MgdGjhu4sgbHXhu5NuZyDEkWnhu4F1IGtoaeG7g247IGtoaSDEkeG7mSBwaOG7qWMgdOG6oXAgdsaw4bujdCBuZ8aw4buhbmcga2nhu4NtIHNvw6F0LCB4w6FjIHN14bqldCBzaW5oIGzhu5dpIHPhur0gdMSDbmcgdGhlbyBow6BtIG3FqS4NCg0KLS0tDQoNCiMjIDEuIEtp4bq/biB0csO6YyBU4buVbmcgcXVhbiAmIE3DtCBow6xuaCBUxrAgZHV5IChNZW50YWwgTW9kZWwpDQoNCiMjIyDhuqhuIGThu6UgxJDhu51pIHPhu5FuZzogTsO6dCBHaWFvIFRow7RuZyDEkGEgVOG6p25nIHbDoCBEdW5nIEzGsOG7o25nIELhu5kgTmjhu5sgTMOgbSBWaeG7h2MNCkjDo3kgaMOsbmggZHVuZyBo4buHIHRo4buRbmcgbcOjIG5ndeG7k24gbmjGsCBt4buZdCBt4bqhbmcgbMaw4bubaSBnaWFvIHRow7RuZyDEkcO0IHRo4buLOg0KLSAqKsSQb+G6oW4gxJHGsOG7nW5nIHRo4bqzbmcgKE3DoyB0deG6p24gdOG7sSAtIExpbmVhciBDb2RlKSoqOiBQaMawxqFuZyB0aeG7h24gZGkgY2h1eeG7g24gduG7m2kgduG6rW4gdOG7kWMgxJHhu4F1LCBraMO0bmcgY8OzIMSRaeG7g20gZ2lhbyBj4bqvdCwgdMOgaSB44bq/IGtow7RuZyBj4bqnbiB44butIGzDvSBuaGnhu4F1IHTDrW4gaGnhu4d1LiDEkOG7mSBwaOG7qWMgdOG6oXAgY2h1IHRyw6xuaCBi4bqxbmcgJDEkLg0KLSAqKkLDuW5nIGJpbmggdsOgIE5nw6MgbsSDbSBs4buTbmcgbmhhdSAoTmVzdGVkIEJyYW5jaGluZyAtIEN5Y2xvbWF0aWMgJiBDb2duaXRpdmUgQ29tcGxleGl0eSkqKjogQ8Ogbmcgbmhp4buBdSBs4buRaSBy4bq9IChgaWYtZWxzZWAsIGBzd2l0Y2hgLCBgZm9yYCksIG5nxrDhu51pIGzDoWkgY8OgbmcgcGjhuqNpIHBoYW5oIGfhuqVwLCBxdWFuIHPDoXQgMzYwIMSR4buZIHbDoCB0w61uaCB0b8OhbiBy4bunaSBybyB2YSBjaOG6oW0uIE7hur91IGPDsyA0IG5nw6MgcuG6vSBs4buTbmcgbmhhdSwgbsOjbyBi4buZIHTDoGkgeOG6vyBi4buLIHF1w6EgdOG6o2kgKHbGsOG7o3QgcXXDoSBnaeG7m2kgaOG6oW4gJDcgXHBtIDIkIHRow7RuZyB0aW4gY+G7p2EgR2VvcmdlIE1pbGxlciksIHRhaSBu4bqhbiAoYnVncykgY2jhuq9jIGNo4bqvbiB44bqjeSByYS4NCi0gKipYZSBjaOG7nyByw6FjIHF1w6EgdOG6o2kgKEdvZCBDbGFzcyAvIExvbmcgTWV0aG9kKSoqOiBN4buZdCBjaGnhur9jIHhlIGNvbnRhaW5lciBjaOG7nyBt4buNaSB0aOG7qSB04burIHhpIG3Eg25nLCB0aOG7sWMgcGjhuqltIMSR4bq/biByw6FjIHRo4bqjaSwgxJFpIHF1YSBt4buNaSBuZ8O1IG5nw6FjaCwgZ8OieSB04bqvYyBuZ2jhur1uIHRvw6BuIGLhu5kgbHXhu5NuZyBsxrB1IHRow7RuZyBj4bunYSBj4bqjIHRow6BuaCBwaOG7kS4NCi0gKipUaMaw4bubYyDEkW8gUmFkYXIgJiBUcuG6oW0gY8OibiB04buxIMSR4buZbmcgKFF1YWxpdHkgR2F0ZXMgJiBDb21wbGV4aXR5IEJ1ZGdldCkqKjogQ8OhYyBj4bqjbSBiaeG6v24gxJFvIG3huq10IMSR4buZIHBoxrDGoW5nIHRp4buHbiB0csOqbiDEkcaw4budbmcgY2FvIHThu5FjLiBO4bq/dSB2xrDhu6N0IHF1w6EgbmfGsOG7oW5nIGFuIHRvw6BuIGNobyBwaMOpcCwgYmFyaWUgdOG7sSDEkeG7mW5nIGjhuqEgeHXhu5FuZyBjaOG6t24geGUgKEJsb2NrIFB1bGwgUmVxdWVzdCkgxJHhu4MgdHLDoW5oIHPhu6VwIMSR4buVIG3huqFuZyBsxrDhu5tpLg0KDQpgYGBtZXJtYWlkDQpmbG93Y2hhcnQgVEQNCiAgICBzdWJncmFwaCBJbnB1dENvZGVbIk3DoyBOZ3Xhu5NuIMSQ4bqndSBWw6BvIChTb3VyY2UgQ29kZSBBU1QpIl0NCiAgICAgICAgQ0ZHWyJDb250cm9sIEZsb3cgR3JhcGggKENGRyk8YnIvPsSQ4buTIHRo4buLIE5vZGVzIChOKSAmIEVkZ2VzIChFKSJdDQogICAgICAgIFRva2Vuc1siTGV4aWNhbCBUb2tlbnM8YnIvPk9wZXJhdG9ycyAozrcxKSAmIE9wZXJhbmRzICjOtzIpIl0NCiAgICBlbmQNCg0KICAgIHN1YmdyYXBoIE1ldHJpY3NFbmdpbmVbIkjhu4cgVGjhu5FuZyBDaOG7iSBT4buRIMSQ4buLbmggTMaw4bujbmcgKFF1YW50aXRhdGl2ZSBNZXRyaWNzKSJdDQogICAgICAgIENGRyAtLT4gTTFbIkN5Y2xvbWF0aWMgQ29tcGxleGl0eSAoTWNDYWJlKTxici8+TSA9IEUgLSBOICsgMlAiXQ0KICAgICAgICBDRkcgLS0+IE0yWyJDb2duaXRpdmUgQ29tcGxleGl0eSAoU29uYXJTb3VyY2UpPGJyLz5OZXN0aW5nIExldmVsIFBlbmFsdGllcyJdDQogICAgICAgIFRva2VucyAtLT4gTTNbIkhhbHN0ZWFkIE1ldHJpY3M8YnIvPlZvbHVtZSBWLCBFZmZvcnQgRSwgQnVncyBCIl0NCiAgICAgICAgTTEgJiBNMyAtLT4gTTRbIk1haW50YWluYWJpbGl0eSBJbmRleCAoTUkpPGJyLz5UaGFuZyDEkWnhu4NtIDAgLSAxMDAiXQ0KICAgIGVuZA0KDQogICAgc3ViZ3JhcGggU21lbGxzWyJE4bqldSBIaeG7h3UgTcOjIEPDsyBNw7lpIChDb2RlIFNtZWxscyBEZXRlY3Rpb24pIl0NCiAgICAgICAgTTEgLS0+IFMxWyJMb25nIE1ldGhvZCAoPiA1MCBMT0MpIl0NCiAgICAgICAgTTQgLS0+IFMyWyJHb2QgQ2xhc3MgLyBMYXJnZSBDbGFzcyJdDQogICAgICAgIEFTVF9TY2FuWyJBU1QgUGF0dGVybiBTY2FuIl0gLS0+IFMzWyJGZWF0dXJlIEVudnkgKE1vdmUgTWV0aG9kKSJdDQogICAgICAgIEFTVF9TY2FuIC0tPiBTNFsiUHJpbWl0aXZlIE9ic2Vzc2lvbiAoVmFsdWUgT2JqZWN0cykiXQ0KICAgIGVuZA0KDQogICAgc3ViZ3JhcGggR292ZXJuYW5jZVsiS+G7uSBOZ2jhu4cgUXXhuqNuIFRy4buLIChDSS9DRCBHb3Zlcm5hbmNlKSJdDQogICAgICAgIE0xICYgTTIgJiBNNCAtLT4gUUd7IlF1YWxpdHkgR2F0ZSBSdWxlczxici8+TSA8PSAxMD8gTUkgPj0gODU/In0NCiAgICAgICAgUUcgLS0gIlBhc3NlZCIgLS0+IFBBU1NbIk1lcmdlIFB1bGwgUmVxdWVzdCBUaMOgbmggQ8O0bmciXQ0KICAgICAgICBRRyAtLSAiVmlvbGF0ZWQiIC0tPiBGQUlMWyJCbG9jayBNZXJnZTogWcOqdSBD4bqndSBSZWZhY3RvciJdDQogICAgZW5kDQpgYGANCg0KLS0tDQoNCiMjIDIuIENoaSB0aeG6v3QgdOG7q25nIEtleXdvcmQgKFVuZGVyLXRoZS1Ib29kIERlZXAgRGl2ZSkNCg0KIyMjIDIuMS4gQ3ljbG9tYXRpYyBDb21wbGV4aXR5IChNY0NhYmUpIHbDoCDEkOG7kyB0aOG7iyBMdeG7k25nIMSQaeG7gXUga2hp4buDbiAoQ0ZHKQ0KxJDGsOG7o2MgxJHhu4EgeHXhuqV0IGLhu59pIFRob21hcyBKLiBNY0NhYmUgbsSDbSAxOTc2LCAqKkN5Y2xvbWF0aWMgQ29tcGxleGl0eSAoxJDhu5kgcGjhu6ljIHThuqFwIGNodSB0csOsbmggLSAkTSQpKiogbMOgIGNo4buJIHPhu5EgdG/DoW4gaOG7jWMgxJHhu4tuaCBsxrDhu6NuZyBz4buRIGzGsOG7o25nIMSRxrDhu51uZyBk4bqrbiB0aOG7sWMgdGhpIMSR4buZYyBs4bqtcCB0dXnhur9uIHTDrW5oIHh1ecOqbiBzdeG7kXQgbeG7mXQgbW9kdWxlIGNoxrDGoW5nIHRyw6xuaC4NCg0KVuG7gSBt4bq3dCBsw70gdGh1eeG6v3QgxJHhu5MgdGjhu4ssIG3DoyBuZ3Xhu5NuIMSRxrDhu6NjIGJp4buDdSBkaeG7hW4gZMaw4bubaSBk4bqhbmcgbeG7mXQgKipDb250cm9sIEZsb3cgR3JhcGggKENGRykqKiBn4buTbSB04bqtcCBjw6FjIMSR4buJbmggJE4kIChjw6FjIGto4buRaSBs4buHbmggdHXhuqduIHThu7EgY8ahIGLhuqNuKSB2w6AgdOG6rXAgY8OhYyBj4bqhbmggJEUkIChsdeG7k25nIGNodXnhu4NuIGjGsOG7m25nIHRo4buxYyB0aGkpOg0KDQokJE0gPSBFIC0gTiArIDJQJCQNCg0KVHJvbmcgxJHDszoNCi0gJEUkOiBT4buRIGzGsOG7o25nIGPhuqFuaCBr4bq/dCBu4buRaSB0cm9uZyDEkeG7kyB0aOG7iy4NCi0gJE4kOiBT4buRIGzGsOG7o25nIG7DunQgKG7DunQgbOG7h25oIHbDoCBuw7p0IHLhur0gbmjDoW5oKS4NCi0gJFAkOiBT4buRIGzGsOG7o25nIHRow6BuaCBwaOG6p24gbGnDqm4gdGjDtG5nIChDb25uZWN0ZWQgQ29tcG9uZW50cywgxJHhu5FpIHbhu5tpIG3hu5l0IGjDoG0gxJHGoW4gbOG6uywgJFAgPSAxJCkuDQoNCipRdXkgdOG6r2MgdMOtbmggbmhhbmgqOiBN4buZdCBow6BtIGLhuq90IMSR4bqndSB24bubaSAkTSA9IDEkLiBN4buXaSBraGkgeHXhuqV0IGhp4buHbiBt4buZdCDEkWnhu4NtIHLhur0gbmjDoW5oIGhv4bq3YyB0b8OhbiB04butIMSRaeG7gXUga2nhu4duIChgaWZgLCBgd2hpbGVgLCBgZm9yYCwgYGNhc2VgLCBgY2F0Y2hgLCBgJiZgLCBgfHxgLCBgPzpgKSwgZ2nDoSB0cuG7iyAkTSQgxJHGsOG7o2MgY+G7mW5nIHRow6ptICQxJC4NCg0KYGBgbWVybWFpZA0KZmxvd2NoYXJ0IFREDQogICAgU3RhcnQoW05vZGUgMTogRW50cnldKSAtLT4gQ29uZDF7Tm9kZSAyOiBpZiBzY29yZSA+PSA4MH0NCiAgICBDb25kMSAtLSAiVHJ1ZSIgLS0+IENvbmQye05vZGUgMzogaWYgaGFzQm9udXN9DQogICAgQ29uZDEgLS0gIkZhbHNlIiAtLT4gUGF0aENbTm9kZSA1OiBncmFkZSA9ICdGJ10NCiAgICBDb25kMiAtLSAiVHJ1ZSIgLS0+IFBhdGhBW05vZGUgNGE6IGdyYWRlID0gJ0ErJ10NCiAgICBDb25kMiAtLSAiRmFsc2UiIC0tPiBQYXRoQltOb2RlIDRiOiBncmFkZSA9ICdBJ10NCiAgICBQYXRoQSAtLT4gTWVyZ2VbTm9kZSA2OiBSZXR1cm4gZ3JhZGVdDQogICAgUGF0aEIgLS0+IE1lcmdlDQogICAgUGF0aEMgLS0+IE1lcmdlDQogICAgTWVyZ2UgLS0+IEV4aXROb2RlKFtOb2RlIDc6IEV4aXRdKQ0KYGBgDQoqUGjDom4gdMOtY2ggxJHhu5MgdGjhu4sgdHLDqm46ICROID0gNyQsICRFID0gOSQsICRQID0gMSBcaW1wbGllcyBNID0gOSAtIDcgKyAyKDEpID0gNCQuIEPhuqduIMOtdCBuaOG6pXQgNCBjYSBraeG7g20gdGjhu60gVW5pdCBUZXN0IMSR4buZYyBs4bqtcCDEkeG7gyBiYW8gcGjhu6cgJDEwMFwlJCBjw6FjIMSRxrDhu51uZyBy4bq9IG5ow6FuaCAoQnJhbmNoIENvdmVyYWdlKS4qDQoNCioqTmfGsOG7oW5nIENodeG6qW4gS+G7uSBUaHXhuq10Kio6DQotICQxIFxsZSBNIFxsZSAxMCQ6IEPhuqV1IHRyw7pjIHRpbmggZ2nhuqNuLCBy4bunaSBybyB0aOG6pXAsIGto4bqjIG7Eg25nIGLhuqNvIHRyw6wgY2FvLg0KLSAkMTEgXGxlIE0gXGxlIDIwJDogxJDhu5kgcGjhu6ljIHThuqFwIHRydW5nIGLDrG5oLCBj4bqnbiBjaMO6IMO9IGtoaSB2aeG6v3QgdGVzdC4NCi0gJDIxIFxsZSBNIFxsZSA1MCQ6IFLhuqV0IHBo4bupYyB04bqhcCwgcuG7p2kgcm8gY2FvLCBi4bqvdCBideG7mWMgcGjhuqNpIHJlZmFjdG9yLg0KLSAkTSA+IDUwJDogTcOjIG5ndeG7k24ga2jDtG5nIHRo4buDIGtp4buDbSB0aOG7rSBob8OgbiBjaOG7iW5oIChVbnRlc3RhYmxlKSwgbMOgIHF14bqjIGJvbSBu4buVIGNo4bqtbSB0cm9uZyBo4buHIHRo4buRbmcuDQoNCi0tLQ0KDQojIyMgMi4yLiBDb2duaXRpdmUgQ29tcGxleGl0eSAoU29uYXJTb3VyY2UpIHbDoCBUcuG7jW5nIHPhu5EgTmjhuq1uIHRo4bupYw0KTeG6t2MgZMO5IEN5Y2xvbWF0aWMgQ29tcGxleGl0eSBy4bqldCBo4buvdSDDrWNoIGNobyB2aeG7h2MgdMOtbmggdG/DoW4gc+G7kSBsxrDhu6NuZyBVbml0IFRlc3RzLCBuw7MgY8OzIG3hu5l0IG5oxrDhu6NjIMSRaeG7g20gbmdoacOqbSB0cuG7jW5nOiAqKktow7RuZyBwaOG6o24gw6FuaCDEkeG7mSBraMOzIGPhu6dhIG7Do28gYuG7mSBraGkgxJHhu41jIGhp4buDdSBjb2RlKiouDQoNClbDrSBk4bulOiBN4buZdCBj4bqldSB0csO6YyBgc3dpdGNoLWNhc2VgIHbhu5tpIDEwIG5ow6FuaCDEkcahbiBnaeG6o24gY8OzIEN5Y2xvbWF0aWMgQ29tcGxleGl0eSBi4bqxbmcgJDEwJCwgbmjGsG5nIHLhuqV0IGThu4UgxJHhu41jLiBOZ8aw4bujYyBs4bqhaSwgNCB2w7JuZyBs4bq3cCBgZm9yYCBs4buTbmcgbmhhdSBzw6J1IDQgdOG6p25nIGPDsyBjw7luZyDEkWnhu4NtIEN5Y2xvbWF0aWMgYuG6sW5nICQxMCQsIG5oxrBuZyBsw6BtIGPhuqFuIGtp4buHdCB0csOtIG5o4bubIGzDoG0gdmnhu4djIGPhu6dhIGzhuq1wIHRyw6xuaCB2acOqbi4NCg0KxJDhu4MgZ2nhuqNpIHF1eeG6v3QgduG6pW4gxJHhu4EgbsOgeSwgU29uYXJTb3VyY2UgcGjDoXQgdHJp4buDbiAqKkNvZ25pdGl2ZSBDb21wbGV4aXR5ICjEkOG7mSBwaOG7qWMgdOG6oXAgbmjhuq1uIHRo4bupYykqKiBk4buxYSB0csOqbiAzIG5ndXnDqm4gdOG6r2M6DQoxLiAqKkLhu48gcXVhIGPDoWMgY8O6IHBow6FwIHLDunQgZ+G7jW4qKjogQ8OhYyBj4bqldSB0csO6YyBuZ+G7ryBuZ2jEqWEgxJHGoW4gZ2nhuqNuLCBxdWVuIHRodeG7mWMga2jDtG5nIGLhu4sgcGjhuqF0IMSRaeG7g20gbuG6t25nLg0KMi4gKipQaOG6oXQgxJFp4buDbSBsxal5IHRp4bq/biB0aGVvIMSR4buZIHPDonUgbOG7k25nIG5oYXUgKE5lc3RpbmcgUGVuYWx0aWVzKSoqOiBN4buZdCBt4buHbmggxJHhu4EgYGlmYCDhu58gdOG6p25nIHRo4bupIG5o4bqldCBjaOG7iSBuaOG6rW4gJCsxJCDEkWnhu4NtLiBOaMawbmcgbuG6v3UgbeG7h25oIMSR4buBIGBpZmAgxJHDsyBu4bqxbSBiw6puIHRyb25nIG3hu5l0IHbDsm5nIGBmb3JgIHbDoCBt4buZdCBraOG7kWkgYHRyeS1jYXRjaGAsIG7DsyBz4bq9IG5o4bqtbiAkMSArIDIgPSAzJCDEkWnhu4NtIQ0KMy4gKipQaOG6oXQgY8OhYyBj4bqldSB0csO6YyBsw6BtIGdpw6FuIMSRb+G6oW4gbHXhu5NuZyBzdXkgbmdoxKkqKjogxJDhu4cgcXV5LCBuaOG6o3kgbmjDo24gKGBnb3RvYCwgYGJyZWFrIGxhYmVsYCksIHRvw6FuIHThu60gbG9naWMga+G6v3QgaOG7o3AgcGjhu6ljIHThuqFwIChgYSAmJiBiIHx8IGMgJiYgZGApLg0KDQotLS0NCg0KIyMjIDIuMy4gSGFsc3RlYWQgQ29tcGxleGl0eSBNZXRyaWNzICYgTWFpbnRhaW5hYmlsaXR5IEluZGV4IChNSSkNCg0KIyMjIyAxLiBDw6FjIMSQ4bqhaSBsxrDhu6NuZyBIYWxzdGVhZA0KTWF1cmljZSBIYWxzdGVhZCAoMTk3NykgcGjDom4gdMOtY2ggbcOjIG5ndeG7k24gZMaw4bubaSBnw7NjIMSR4buZIMSR4buZIGTDoGkgdOG7qyB24buxbmcgZOG7sWEgdHLDqm4gaGFpIHThuq1wIGjhu6NwIG5ndXnDqm4gdOG7rToNCi0gJFxldGFfMSQ6IFPhu5EgbMaw4bujbmcgdG/DoW4gdOG7rSBwaMOibiBiaeG7h3QgKFVuaXF1ZSBPcGVyYXRvcnM6IGArYCwgYC1gLCBgKmAsIGBpZmAsIGByZXR1cm5gLi4uKS4NCi0gJFxldGFfMiQ6IFPhu5EgbMaw4bujbmcgdG/DoW4gaOG6oW5nIHBow6JuIGJp4buHdCAoVW5pcXVlIE9wZXJhbmRzOiB0w6puIGJp4bq/biwgaOG6sW5nIHPhu5EuLi4pLg0KLSAkTl8xJDogVOG7lW5nIHPhu5EgbOG6p24geHXhuqV0IGhp4buHbiBj4bunYSBjw6FjIHRvw6FuIHThu60uDQotICROXzIkOiBU4buVbmcgc+G7kSBs4bqnbiB4deG6pXQgaGnhu4duIGPhu6dhIGPDoWMgdG/DoW4gaOG6oW5nLg0KDQpU4burIGPDoWMgxJHhuqFpIGzGsOG7o25nIHRyw6puLCBIYWxzdGVhZCB0w61uaCB0b8OhbjoNCi0gKipU4burIHbhu7FuZyBjaMawxqFuZyB0csOsbmggKFByb2dyYW0gVm9jYWJ1bGFyeSkqKjogJFxldGEgPSBcZXRhXzEgKyBcZXRhXzIkLg0KLSAqKkNoaeG7gXUgZMOgaSBjaMawxqFuZyB0csOsbmggKFByb2dyYW0gTGVuZ3RoKSoqOiAkTiA9IE5fMSArIE5fMiQuDQotICoqRHVuZyBsxrDhu6NuZyBjaMawxqFuZyB0csOsbmggKFByb2dyYW0gVm9sdW1lKSoqOiAkViA9IE4gXHRpbWVzIFxsb2dfMihcZXRhKSQgKMSQxqFuIHbhu4s6IGJpdHMpLg0KLSAqKsSQ4buZIGtow7MgY+G7p2EgY2jGsMahbmcgdHLDrG5oIChEaWZmaWN1bHR5KSoqOiAkRCA9IFxmcmFje1xldGFfMX17Mn0gXHRpbWVzIFxmcmFje05fMn17XGV0YV8yfSQuDQotICoqTuG7lyBs4buxYyBs4bqtcCB0csOsbmggKEVmZm9ydCkqKjogJEUgPSBEIFx0aW1lcyBWJC4NCi0gKipT4buRIGzhu5dpIMaw4bubYyB0w61uaCB0cm9uZyBtw6MgKEVzdGltYXRlZCBCdWdzKSoqOiAkQiA9IFxmcmFje1Z9ezMwMDB9JC4NCg0KIyMjIyAyLiBNYWludGFpbmFiaWxpdHkgSW5kZXggKENo4buJIFPhu5EgS2jhuqMgTsSDbmcgQuG6o28gVHLDrCAtIE1JKQ0KxJDGsOG7o2MgcGjDoXQgdHJp4buDbiBi4bufaSBWaeG7h24gQ8O0bmcgbmdo4buHIFBo4bqnbiBt4buBbSDEkOG6oWkgaOG7jWMgSWRhaG8gdsOgIGNodeG6qW4gaMOzYSBi4bufaSBNaWNyb3NvZnQgVmlzdWFsIFN0dWRpbywgTUkgbMOgIGNo4buJIHPhu5EgdOG7lW5nIGjhu6NwIMSRw6FuaCBnacOhIMSR4buZICJsw6BuaCBt4bqhbmgiIGPhu6dhIG3DoyBuZ3Xhu5NuIHRyw6puIHRoYW5nIMSRaeG7g20gJDAgLSAxMDAkOg0KDQokJFx0ZXh0e01JfSA9IFxtYXhcbGVmdCgwLCBcZnJhY3sxNzEgLSA1LjIgXGxuKFYpIC0gMC4yMyBNIC0gMTYuMiBcbG4oXHRleHR7TE9DfSl9ezE3MX1ccmlnaHQpIFx0aW1lcyAxMDAkJA0KDQotICRcdGV4dHtNSX0gXGdlIDg1JDogKipYYW5oIGzDoSAoSGlnaCBNYWludGFpbmFiaWxpdHkpKiogLSBNw6Mgc+G6oWNoLCBtb2R1bGUgaMOzYSB04buRdC4NCi0gJDY1IFxsZSBcdGV4dHtNSX0gPCA4NSQ6ICoqVsOgbmcgKE1vZGVyYXRlIE1haW50YWluYWJpbGl0eSkqKiAtIELhuq90IMSR4bqndSB4deG6pXQgaGnhu4duIG7hu6Mga+G7uSB0aHXhuq10LCBj4bqnbiB0aGVvIGTDtWkuDQotICRcdGV4dHtNSX0gPCA2NSQ6ICoqxJDhu48gKExvdyBNYWludGFpbmFiaWxpdHkpKiogLSBNw6MgZGkgc+G6o24gKExlZ2FjeSBjb2RlKSwgcuG7p2kgcm8gY2FvIGtoaSB0aGF5IMSR4buVaS4NCg0KLS0tDQoNCiMjIyAyLjQuIENsYXNzaWMgQ29kZSBTbWVsbHM6IExvbmcgTWV0aG9kLCBMYXJnZSBDbGFzcyAmIEZlYXR1cmUgRW52eQ0KVGhlbyDEkeG7i25oIG5naMSpYSBj4bunYSBNYXJ0aW4gRm93bGVyIHbDoCBLZW50IEJlY2sgdHJvbmcgY3Xhu5FuIHPDoWNoIGtpbmggxJFp4buDbiAqUmVmYWN0b3JpbmcqLCAqKkNvZGUgU21lbGxzIChNw7lpIGPhu6dhIG3DoykqKiBsw6Agbmjhu69uZyB0cmnhu4d1IGNo4bupbmcgYuG7gSBt4bq3dCBjaG8gdGjhuqV5IG5o4buvbmcga2hp4bq/bSBraHV54bq/dCBzw6J1IHhhIHRyb25nIGtp4bq/biB0csO6YyBwaOG6p24gbeG7gW06DQoNCjEuICoqTG9uZyBNZXRob2QgKFBoxrDGoW5nIHRo4bupYyBRdcOhIETDoGkpKio6DQogICAtIE3hu5l0IGjDoG0ga8OpbyBkw6BpIHRyw6puIDUwIGTDsm5nIHRo4buxYyBoaeG7h24gY8O5bmcgbMO6YyBuaGnhu4F1IGPhuqVwIMSR4buZIHRy4burdSB0xrDhu6NuZyBraMOhYyBuaGF1ICh24burYSBwaMOibiB0w61jaCBKU09OLCB24burYSBnaGkgY8ahIHPhu58gZOG7ryBsaeG7h3UsIHbhu6thIGfhu61pIGVtYWlsKS4NCiAgIC0gKkxp4buBdSB0aHXhu5FjKjogw4FwIGThu6VuZyBr4bu5IHRodeG6rXQgYEV4dHJhY3QgTWV0aG9kYCDEkeG7gyDEkcawYSBjw6FjIGto4buRaSBs4buHbmggY29uIHbhu4EgxJHDum5nIHTDqm4gZ+G7jWkgbmfhu68gbmdoxKlhLCBnaeG7ryBt4buXaSBow6BtIGNo4buJIGzDoG0gbeG7mXQgdmnhu4djIGR1eSBuaOG6pXQgKFNSUCkuDQoNCjIuICoqTGFyZ2UgQ2xhc3MgLyBHb2QgQ2xhc3MgKEzhu5twIFRo4bqnbiBUaMOhbmgpKio6DQogICAtIE3hu5l0IGNsYXNzIG7huq9tIGdp4buvIGjDoG5nIGNo4bulYyBiaeG6v24gdGjDoG5oIHZpw6puIHbDoCBow6BuZyBuZ2jDrG4gZMOybmcgbOG7h25oLCDEkcOzbmcgdmFpIHRyw7IgxJFp4buBdSBraGnhu4NuIG3hu41pIHRo4buxYyB0aOG7gyBraMOhYyB0cm9uZyBo4buHIHRo4buRbmcuDQogICAtICpMaeG7gXUgdGh14buRYyo6IMOBcCBk4bulbmcgYEV4dHJhY3QgQ2xhc3NgLCBwaMOibiByw6MgdGjDoG5oIGPDoWMgQWdncmVnYXRlIFJvb3RzIHbDoCBEb21haW4gU2VydmljZXMgbmjhu48gaMahbi4NCg0KMy4gKipGZWF0dXJlIEVudnkgKEdoZW4gVOG7iyBUw61uaCBOxINuZykqKjoNCiAgIC0gWOG6o3kgcmEga2hpIG3hu5l0IHBoxrDGoW5nIHRo4bupYyBj4bunYSBDbGFzcyAkQSQgbGnDqm4gdOG7pWMgdHJ1eSB24bqlbiB2w6AgdGhhbyB0w6FjIHRyw6puIGPDoWMgdHLGsOG7nW5nIGThu68gbGnhu4d1IGPhu6dhIENsYXNzICRCJCBuaGnhu4F1IGjGoW4gY2jDrW5oIGThu68gbGnhu4d1IGPhu6dhIENsYXNzICRBJC4NCiAgIC0gKkxp4buBdSB0aHXhu5FjKjogw4FwIGThu6VuZyBgTW92ZSBNZXRob2RgLCBjaHV54buDbiBsb2dpYyB0w61uaCB0b8OhbiBzYW5nIGNow61uaCBDbGFzcyAkQiQgxJHhu4MgdHXDom4gdGjhu6cgbmd1ecOqbiBsw70gKkluZm9ybWF0aW9uIEV4cGVydCogKEThu68gbGnhu4d1IOG7nyDEkcOidSwgaMOgbmggdmkg4bufIMSRw7MpLg0KDQotLS0NCg0KIyMjIDIuNS4gUHJpbWl0aXZlIE9ic2Vzc2lvbiB2w6AgR2nhuqNpIHBow6FwIERvbWFpbiBWYWx1ZSBPYmplY3RzDQoqKlByaW1pdGl2ZSBPYnNlc3Npb24gKMOBbSDhuqNuaCBraeG7g3Ugbmd1ecOqbiB0aOG7p3kpKiogbMOgIHRow7NpIHF1ZW4geOG6pXUgcGjhu5UgYmnhur9uIGPhu6dhIGPDoWMgbOG6rXAgdHLDrG5oIHZpw6puIG3hu5tpIHbDoG8gbmdo4buBOiBT4butIGThu6VuZyB0csOgbiBsYW4gY8OhYyBraeG7g3UgZOG7ryBsaeG7h3UgY8ahIGLhuqNuIChgc3RkOjpzdHJpbmdgLCBgaW50YCwgYGZsb2F0YCwgYGRpY3RgKSDEkeG7gyBtw7QgdOG6oyBjw6FjIGtow6FpIG5p4buHbSBuZ2hp4buHcCB24bulIHBo4bupYyB04bqhcDoNCi0gRMO5bmcgYHN0ZDo6c3RyaW5nYCDEkeG7gyBsxrB1IGPhuqMgRW1haWwsIMSQ4buLYSBjaOG7iSBJUCwgTcOjIHRp4buBbiB04buHLCBVVUlELCBT4buRIMSRaeG7h24gdGhv4bqhaS4NCi0gRMO5bmcgYGRvdWJsZWAgxJHhu4MgdMOtbmggdG/DoW4gdGnhu4FuIHThu4cgKGfDonkgc2FpIHPhu5EgZOG6pXUgcGjhuql5IMSR4buZbmcgSUVFRS03NTQ6ICQwLjEgKyAwLjIgXG5lIDAuMyQpLg0KLSBUcnV54buBbiBsacOqbiB0aeG6v3AgNSB0aGFtIHPhu5Ega2nhu4N1IGBzdGQ6OnN0cmluZ2AgdsOgbyBow6BtOiBgY3JlYXRlVXNlcihuYW1lLCBlbWFpbCwgYWRkcmVzcywgcGhvbmUsIHppcClgLiBLaGkgYsOqbiBn4buNaSB0cnV54buBbiBuaOG6p20gdGjhu6kgdOG7sSBgbmFtZWAgdsOgIGBlbWFpbGAsIENvbXBpbGVyIGhvw6BuIHRvw6BuIGLhuqV0IGzhu7FjIGtow7RuZyB0aOG7gyBj4bqjbmggYsOhbyENCg0KKipHaeG6o2kgcGjDoXAgQ2h14bqpbiBt4buxYyoqOiBYw6J5IGThu7FuZyAqKlN0cm9uZ2x5LVR5cGVkIERvbWFpbiBWYWx1ZSBPYmplY3RzKio6DQotIMSQw7NuZyBnw7NpIGThu68gbGnhu4d1IG5ndXnDqm4gdGjhu6d5IHbDoG8gbeG7mXQgY+G6pXUgdHLDumMgY8OzIGtp4buDdSDEkeG7i25oIGRhbmggcsO1IHLDoG5nLg0KLSBU4buxIMSR4buZbmcga2nhu4NtIHRyYSB0w61uaCBo4bujcCBs4buHIChTZWxmLVZhbGlkYXRpb24pIG5nYXkgdHJvbmcgQ29uc3RydWN0b3IuDQotIELhuqV0IGJp4bq/biAoSW1tdXRhYmxlKTogTeG7mXQga2hpIMSRw6MgdOG6oW8gcmEgdGjDrCBraMO0bmcgdGjhu4MgdGhheSDEkeG7lWkgZ2nDoSB0cuG7iy4NCi0gQsOsbmggxJHhurNuZyB0aGVvIGdpw6EgdHLhu4sgKFZhbHVlIEVxdWFsaXR5KSwga2jDtG5nIGLDrG5oIMSR4bqzbmcgdGhlbyBjb24gdHLhu48gSUQuDQoNCi0tLQ0KDQojIyMgMi42LiBDb21wbGV4aXR5IEJ1ZGdldCAmIEdvdmVybmFuY2UgdHJvbmcgTW9kZXJuIENJL0NEDQrEkOG7gyBnaeG7ryBjaG8gaOG7hyB0aOG7kW5nIGtow7RuZyBi4buLIG3hu6VjIHJ14buXbmcgcXVhIG7Eg20gdGjDoW5nLCBjw6FjIMSR4buZaSBuZ8WpIGvhu7kgdGh14bqtdCBow6BuZyDEkeG6p3Ugw6FwIGThu6VuZyAqKkNvbXBsZXhpdHkgQnVkZ2V0IChOZ8OibiBzw6FjaCDEkOG7mSBwaOG7qWMgdOG6oXApKiogdsOgbyBjaHUgdHLDrG5oIHTDrWNoIGjhu6NwIGxpw6puIHThu6VjIChDSS9DRCk6DQoNCjEuICoqU3RhdGljIFF1YWxpdHkgR2F0ZXMqKjoNCiAgIC0gTeG7jWkgUHVsbCBSZXF1ZXN0IChQUikgcGjhuqNpIGNo4bqheSBxdWEgY8OhYyBjw7RuZyBj4bulIHBow6JuIHTDrWNoIHTEqW5oIChTb25hclF1YmUsIENsYW5nLVRpZHksIEVTTGludCwgTGl6YXJkKS4NCiAgIC0gKipRdXkgdOG6r2MgQ2jhurduIChCbG9jayBNZXJnaW5nKSoqOg0KICAgICAtIEtow7RuZyBjaG8gcGjDqXAgYuG6pXQga+G7syBow6BtIG3hu5tpIG7DoG8gY8OzICRNID4gMTAkIGhv4bq3YyBDb2duaXRpdmUgQ29tcGxleGl0eSAkPiAxNSQuDQogICAgIC0gTWFpbnRhaW5hYmlsaXR5IEluZGV4IHThu5VuZyB0aOG7gyBj4bunYSByZXBvc2l0b3J5IGtow7RuZyDEkcaw4bujYyBnaeG6o20gcXXDoSAkMC41XCUkIHNhdSBt4buXaSDEkeG7o3QgcGjDoXQgaMOgbmguDQogICAgIC0gVOG7tyBs4buHIG3DoyB0csO5bmcgbOG6t3AgKER1cGxpY2F0aW9uIERlbnNpdHkpIHBo4bqjaSAkPCAzXCUkLg0KMi4gKipCb3kgU2NvdXQgUnVsZSB0cm9uZyBRdeG6o24gVHLhu4sqKjoNCiAgIC0gIkjDo3kgbHXDtG4gxJHhu4Mga2h1IGPhuq9tIHRy4bqhaSBz4bqhY2ggaMahbiBsw7pjIGLhuqFuIMSR4bq/biIuIEtoaSBt4buZdCBr4bu5IHPGsCBz4butYSBt4buZdCBkw7JuZyBidWcgdHJvbmcgbeG7mXQgaMOgbSBjw7MgJE0gPSAzMCQsIGjhu40gxJHGsOG7o2MgecOqdSBj4bqndSBwaOG6o2kgY2hp4bq/dCB4deG6pXQgdsOgIGjhuqEgxJHhu5kgcGjhu6ljIHThuqFwIGPhu6dhIGjDoG0gxJHDsyB4deG7kW5nIMOtdCBuaOG6pXQgJDIwXCUkLg0KDQotLS0NCg0KIyMgMy4gVGjhu7FjIHRoaSBNw6Mgbmd14buTbiAmIE3DtCBwaOG7j25nIENodXnDqm4gc8OidSAoRHVhbC1FbmdpbmUgSW1wbGVtZW50YXRpb24pDQoNCiMjIyAzLjEuIEMrKzIwIEltcGxlbWVudGF0aW9uOiBLaOG6r2MgUGjhu6VjIFByaW1pdGl2ZSBPYnNlc3Npb24gQuG6sW5nIFN0cm9uZ2x5LVR5cGVkIFZhbHVlIE9iamVjdHMNCsSQb+G6oW4gbcOjIEMrKzIwIGTGsOG7m2kgxJHDonkgbWluaCBo4buNYSB2aeG7h2MgY2h1eeG7g24gxJHhu5VpIHThu6sgbcOjIG5ndeG7k24gIm3huq9jIG3DuWkiIFByaW1pdGl2ZSBPYnNlc3Npb24gc2FuZyBraeG6v24gdHLDumMgVHlwZS1TYWZlIGNodeG6qW4gRG9tYWluLURyaXZlbiBEZXNpZ24gc+G7rSBk4bulbmcgVmFsdWUgT2JqZWN0cyBi4bqldCBiaeG6v24uDQoNCmBgYGNwcA0KI2luY2x1ZGUgPGlvc3RyZWFtPg0KI2luY2x1ZGUgPHN0cmluZz4NCiNpbmNsdWRlIDxyZWdleD4NCiNpbmNsdWRlIDxzdGRleGNlcHQ+DQojaW5jbHVkZSA8Y29tcGFyZT4NCiNpbmNsdWRlIDx1dGlsaXR5Pg0KDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQovLyAxLiBDw4FDSCBMw4BNIEvDiU0gKFBSSU1JVElWRSBPQlNFU1NJT04gQU5USVBBVFRFUk4pDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQovLyBIw6BtIG5o4bqtbiBjw6FjIHRoYW0gc+G7kSB0aMO0OiBS4bqldCBk4buFIGLhu4sgaG/DoW4gxJHhu5VpIG5o4bqnbSB0aOG7qSB04buxIGdp4buvYSBzZW5kZXIgJiByZWNlaXZlciENCnZvaWQgdW5zYWZlVHJhbnNmZXIoc3RkOjpzdHJpbmcgc2VuZGVyRW1haWwsIHN0ZDo6c3RyaW5nIHJlY2VpdmVyRW1haWwsIGRvdWJsZSBhbW91bnQpIHsNCiAgICAvLyBUcsOsbmggYmnDqm4gZOG7i2NoIGtow7RuZyB0aOG7gyBi4bqvdCBs4buXaSBu4bq/dSBs4bqtcCB0csOsbmggdmnDqm4gZ+G7jWk6DQogICAgLy8gdW5zYWZlVHJhbnNmZXIoImJvYkBleGFtcGxlLmNvbSIsICJhbGljZUBleGFtcGxlLmNvbSIsIC01MC4wKTsNCiAgICBzdGQ6OmNvdXQgPDwgIltVbnNhZmVdIFRyYW5zZmVycmluZyAkIiA8PCBhbW91bnQgPDwgIiBmcm9tICIgPDwgc2VuZGVyRW1haWwgPDwgIiB0byAiIDw8IHJlY2VpdmVyRW1haWwgPDwgIlxuIjsNCn0NCg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLy8gMi4gR0nhuqJJIFBIw4FQIEVOVEVSUFJJU0U6IERPTUFJTiBWQUxVRSBPQkpFQ1RTIENIVeG6qE4gQysrMjANCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCg0KLy8gVmFsdWUgT2JqZWN0OiBFbWFpbEFkZHJlc3MgKELhuqV0IGJp4bq/biwgVOG7sSBraeG7g20gdHJhLCBUeXBlLVNhZmUpDQpjbGFzcyBFbWFpbEFkZHJlc3Mgew0KcHJpdmF0ZToNCiAgICBzdGQ6OnN0cmluZyB2YWx1ZV87DQoNCiAgICBzdGF0aWMgYm9vbCB2YWxpZGF0ZShjb25zdCBzdGQ6OnN0cmluZyYgZW1haWwpIHsNCiAgICAgICAgLy8gQmnhu4N1IHRo4bupYyBjaMOtbmggcXV5IGtp4buDbSB0cmEgxJHhu4tuaCBk4bqhbmcgZW1haWwgdGnDqnUgY2h14bqpbg0KICAgICAgICBzdGF0aWMgY29uc3Qgc3RkOjpyZWdleCBrRW1haWxSZWdleCgNCiAgICAgICAgICAgIFIiKF5bYS16QS1aMC05Xy4rLV0rQFthLXpBLVowLTktXStcLlthLXpBLVowLTktLl0rJCkiDQogICAgICAgICk7DQogICAgICAgIHJldHVybiBzdGQ6OnJlZ2V4X21hdGNoKGVtYWlsLCBrRW1haWxSZWdleCk7DQogICAgfQ0KDQpwdWJsaWM6DQogICAgZXhwbGljaXQgRW1haWxBZGRyZXNzKHN0ZDo6c3RyaW5nIGVtYWlsKSA6IHZhbHVlXyhzdGQ6Om1vdmUoZW1haWwpKSB7DQogICAgICAgIGlmICghdmFsaWRhdGUodmFsdWVfKSkgew0KICAgICAgICAgICAgdGhyb3cgc3RkOjppbnZhbGlkX2FyZ3VtZW50KCJJbnZhbGlkIEVtYWlsIEZvcm1hdDogJyIgKyB2YWx1ZV8gKyAiJyIpOw0KICAgICAgICB9DQogICAgfQ0KDQogICAgW1tub2Rpc2NhcmRdXSBjb25zdCBzdGQ6OnN0cmluZyYgc3RyKCkgY29uc3Qgbm9leGNlcHQgeyByZXR1cm4gdmFsdWVfOyB9DQoNCiAgICAvLyBDKysyMCBTcGFjZXNoaXAgT3BlcmF0b3IgY2hvIHBow6lwIHNvIHPDoW5oIGdpw6EgdHLhu4sgdOG7sSDEkeG7mW5nDQogICAgYXV0byBvcGVyYXRvcjw9Pihjb25zdCBFbWFpbEFkZHJlc3MmKSBjb25zdCA9IGRlZmF1bHQ7DQp9Ow0KDQovLyBWYWx1ZSBPYmplY3Q6IE1vbmV5IChOZ8SDbiBjaOG6t24gc2FpIHPhu5EgRmxvYXRpbmctcG9pbnQgYuG6sW5nIGPDoWNoIGTDuW5nIENlbnRzKQ0KY2xhc3MgTW9uZXkgew0KcHJpdmF0ZToNCiAgICBpbnQ2NF90IGNlbnRzX3swfTsNCg0KcHVibGljOg0KICAgIGV4cGxpY2l0IGNvbnN0ZXhwciBNb25leShpbnQ2NF90IGNlbnRzKSA6IGNlbnRzXyhjZW50cykgew0KICAgICAgICBpZiAoY2VudHMgPCAwKSB7DQogICAgICAgICAgICB0aHJvdyBzdGQ6OmludmFsaWRfYXJndW1lbnQoIk1vbmV5IGNhbm5vdCBiZSBuZWdhdGl2ZSEiKTsNCiAgICAgICAgfQ0KICAgIH0NCg0KICAgIFtbbm9kaXNjYXJkXV0gc3RhdGljIGNvbnN0ZXhwciBNb25leSBmcm9tRG9sbGFycyhpbnQ2NF90IGRvbGxhcnMsIGludDY0X3QgY2VudHMpIHsNCiAgICAgICAgcmV0dXJuIE1vbmV5KGRvbGxhcnMgKiAxMDAgKyBjZW50cyk7DQogICAgfQ0KDQogICAgW1tub2Rpc2NhcmRdXSBpbnQ2NF90IGNlbnRzKCkgY29uc3Qgbm9leGNlcHQgeyByZXR1cm4gY2VudHNfOyB9DQogICAgW1tub2Rpc2NhcmRdXSBkb3VibGUgdG9Eb2xsYXJzKCkgY29uc3Qgbm9leGNlcHQgeyByZXR1cm4gc3RhdGljX2Nhc3Q8ZG91YmxlPihjZW50c18pIC8gMTAwLjA7IH0NCg0KICAgIGNvbnN0ZXhwciBNb25leSBvcGVyYXRvcisoY29uc3QgTW9uZXkmIG90aGVyKSBjb25zdCB7DQogICAgICAgIHJldHVybiBNb25leShjZW50c18gKyBvdGhlci5jZW50c18pOw0KICAgIH0NCg0KICAgIGF1dG8gb3BlcmF0b3I8PT4oY29uc3QgTW9uZXkmKSBjb25zdCA9IGRlZmF1bHQ7DQp9Ow0KDQovLyBIw6BtIGPDsyB0w61uaCB0b8OgbiB24bq5biB0dXnhu4d0IMSR4buRaTogQ29tcGlsZXIgcGjDoXQgaGnhu4duIGzhu5dpIGzhuq1wIHThu6ljIG7hur91IHNhaSBraeG7g3UhDQp2b2lkIHNhZmVUcmFuc2Zlcihjb25zdCBFbWFpbEFkZHJlc3MmIGZyb20sIGNvbnN0IEVtYWlsQWRkcmVzcyYgdG8sIE1vbmV5IGFtb3VudCkgew0KICAgIHN0ZDo6Y291dCA8PCAiW1R5cGUtU2FmZSBDb3JlIERvbWFpbl0gVHJhbnNmZXJyaW5nICQiIDw8IGFtb3VudC50b0RvbGxhcnMoKSANCiAgICAgICAgICAgICAgPDwgIiAoIiA8PCBhbW91bnQuY2VudHMoKSA8PCAiIGNlbnRzKSBmcm9tICIgDQogICAgICAgICAgICAgIDw8IGZyb20uc3RyKCkgPDwgIiB0byAiIDw8IHRvLnN0cigpIDw8ICIgLT4gU1VDQ0VTU1xuIjsNCn0NCg0KaW50IG1haW4oKSB7DQogICAgc3RkOjpjb3V0IDw8ICI9PT0gQysrMjAgVmFsdWUgT2JqZWN0cyAmIFR5cGUtU2FmZXR5IERlbW8gPT09XG4iOw0KDQogICAgLy8gVGjhu60gbmdoaeG7h20gY8OhY2ggbMOgbSBuZ3V5IGhp4buDbSAoUHJpbWl0aXZlIE9ic2Vzc2lvbikNCiAgICB1bnNhZmVUcmFuc2ZlcigiYWxpY2VAY29ycC5jb20iLCAiYm9iQGNvcnAuY29tIiwgMTUwLjApOw0KDQogICAgLy8gVGjhu60gbmdoaeG7h20gY8OhY2ggbMOgbSBUeXBlLVNhZmUNCiAgICB0cnkgew0KICAgICAgICBFbWFpbEFkZHJlc3Mgc2VuZGVyKCJhbGljZUBjb3JwLmNvbSIpOw0KICAgICAgICBFbWFpbEFkZHJlc3MgcmVjaXBpZW50KCJib2JAY29ycC5jb20iKTsNCiAgICAgICAgTW9uZXkgdHJhbnNmZXJBbW91bnQgPSBNb25leTo6ZnJvbURvbGxhcnMoMjUwLCA3NSk7IC8vICQyNTAuNzUNCg0KICAgICAgICBzYWZlVHJhbnNmZXIoc2VuZGVyLCByZWNpcGllbnQsIHRyYW5zZmVyQW1vdW50KTsNCg0KICAgICAgICAvLyBLaeG7g20gdHJhIEVxdWFsaXR5IHRoZW8gZ2nDoSB0cuG7iw0KICAgICAgICBFbWFpbEFkZHJlc3Mgc2VuZGVyQ2xvbmUoImFsaWNlQGNvcnAuY29tIik7DQogICAgICAgIGlmIChzZW5kZXIgPT0gc2VuZGVyQ2xvbmUpIHsNCiAgICAgICAgICAgIHN0ZDo6Y291dCA8PCAiW1ZhbHVlIE9iamVjdCBFcXVhbGl0eV0gU2VuZGVyIGFuZCBDbG9uZSBhcmUgc3RyaWN0bHkgZXF1YWwgYnkgdmFsdWUhXG4iOw0KICAgICAgICB9DQoNCiAgICAgICAgLy8gVGVzdCBDYXNlIGPhu5EgdMOsbmggdHJ1eeG7gW4gc2FpIMSR4buLbmggZOG6oW5nIGVtYWlsDQogICAgICAgIHN0ZDo6Y291dCA8PCAiXG5bVmFsaWRhdGlvbiBUZXN0XSBBdHRlbXB0aW5nIHRvIGNvbnN0cnVjdCBpbnZhbGlkIGVtYWlsLi4uXG4iOw0KICAgICAgICBFbWFpbEFkZHJlc3MgbWFsZm9ybWVkKCJub3QtYW4tZW1haWwtc3RyaW5nIik7DQoNCiAgICB9IGNhdGNoIChjb25zdCBzdGQ6OmV4Y2VwdGlvbiYgZXgpIHsNCiAgICAgICAgc3RkOjpjb3V0IDw8ICIgIC0+IENvbXBpbGVyICYgUnVudGltZSBTaGllbGQ6IENhdWdodCBleGNlcHRpb246ICIgPDwgZXgud2hhdCgpIDw8ICJcbiI7DQogICAgfQ0KDQogICAgcmV0dXJuIDA7DQp9DQpgYGANCg0KIyMjIyBUZXJtaW5hbCBPdXRwdXQgTeG6q3UgKEMrKzIwKToNCmBgYHRleHQNCj09PSBDKysyMCBWYWx1ZSBPYmplY3RzICYgVHlwZS1TYWZldHkgRGVtbyA9PT0NCltVbnNhZmVdIFRyYW5zZmVycmluZyAkMTUwIGZyb20gYWxpY2VAY29ycC5jb20gdG8gYm9iQGNvcnAuY29tDQpbVHlwZS1TYWZlIENvcmUgRG9tYWluXSBUcmFuc2ZlcnJpbmcgJDI1MC43NSAoMjUwNzUgY2VudHMpIGZyb20gYWxpY2VAY29ycC5jb20gdG8gYm9iQGNvcnAuY29tIC0+IFNVQ0NFU1MNCltWYWx1ZSBPYmplY3QgRXF1YWxpdHldIFNlbmRlciBhbmQgQ2xvbmUgYXJlIHN0cmljdGx5IGVxdWFsIGJ5IHZhbHVlIQ0KDQpbVmFsaWRhdGlvbiBUZXN0XSBBdHRlbXB0aW5nIHRvIGNvbnN0cnVjdCBpbnZhbGlkIGVtYWlsLi4uDQogIC0+IENvbXBpbGVyICYgUnVudGltZSBTaGllbGQ6IENhdWdodCBleGNlcHRpb246IEludmFsaWQgRW1haWwgRm9ybWF0OiAnbm90LWFuLWVtYWlsLXN0cmluZycNCmBgYA0KDQotLS0NCg0KIyMjIDMuMi4gUHl0aG9uIDMuMTErIEltcGxlbWVudGF0aW9uOiBBU1QtQmFzZWQgQ3ljbG9tYXRpYyAmIENvZ25pdGl2ZSBDb21wbGV4aXR5IEFuYWx5emVyDQpTY3JpcHQgUHl0aG9uIDMuMTErIGTGsOG7m2kgxJHDonkgcGjDom4gdMOtY2ggY8O6IHBow6FwIHRy4burdSB0xrDhu6NuZyAoQWJzdHJhY3QgU3ludGF4IFRyZWUgLSBBU1QpIGPhu6dhIG3DoyBuZ3Xhu5NuIFB5dGhvbiDEkeG7gyB04buxIMSR4buZbmcgdMOtbmggdG/DoW4gQ3ljbG9tYXRpYyBDb21wbGV4aXR5ICgkTSA9IEUgLSBOICsgMlAkKSB2w6AgcGjhuqF0IMSRaeG7g20gQ29nbml0aXZlIENvbXBsZXhpdHkgdGhlbyDEkeG7mSBzw6J1IGzhu5NuZyBuaGF1Lg0KDQpgYGBweXRob24NCmZyb20gX19mdXR1cmVfXyBpbXBvcnQgYW5ub3RhdGlvbnMNCmltcG9ydCBhc3QNCmltcG9ydCBpbnNwZWN0DQpmcm9tIHR5cGluZyBpbXBvcnQgQW55DQoNCmNsYXNzIENvbXBsZXhpdHlBbmFseXplcihhc3QuTm9kZVZpc2l0b3IpOg0KICAgIGRlZiBfX2luaXRfXyhzZWxmKToNCiAgICAgICAgc2VsZi5jeWNsb21hdGljX2NvbXBsZXhpdHk6IGludCA9IDENCiAgICAgICAgc2VsZi5jb2duaXRpdmVfY29tcGxleGl0eTogaW50ID0gMA0KICAgICAgICBzZWxmLmN1cnJlbnRfbmVzdGluZzogaW50ID0gMA0KDQogICAgZGVmIF9pbmNyZWFzZV9jb2duaXRpdmUoc2VsZiwgYmFzZV9jb3N0OiBpbnQgPSAxKToNCiAgICAgICAgIiIiUGjhuqF0IMSRaeG7g20gbmjhuq1uIHRo4bupYzogUGjDrSBn4buRYyArIFBow60gdGhlbyDEkeG7mSBzw6J1IGzhu5NuZyBuaGF1LiIiIg0KICAgICAgICBzZWxmLmNvZ25pdGl2ZV9jb21wbGV4aXR5ICs9IChiYXNlX2Nvc3QgKyBzZWxmLmN1cnJlbnRfbmVzdGluZykNCg0KICAgICMgMS4gxJBvIGzGsOG7nW5nIHLhur0gbmjDoW5oIElmDQogICAgZGVmIHZpc2l0X0lmKHNlbGYsIG5vZGU6IGFzdC5JZik6DQogICAgICAgIHNlbGYuY3ljbG9tYXRpY19jb21wbGV4aXR5ICs9IDENCiAgICAgICAgc2VsZi5faW5jcmVhc2VfY29nbml0aXZlKDEpDQogICAgICAgIA0KICAgICAgICAjIFTEg25nIG5lc3Rpbmcga2hpIGLGsOG7m2MgdsOgbyB0aMOibiBpZg0KICAgICAgICBzZWxmLmN1cnJlbnRfbmVzdGluZyArPSAxDQogICAgICAgIHNlbGYuZ2VuZXJpY192aXNpdChub2RlKQ0KICAgICAgICBzZWxmLmN1cnJlbnRfbmVzdGluZyAtPSAxDQoNCiAgICAjIDIuIMSQbyBsxrDhu51uZyB2w7JuZyBs4bq3cCBGb3INCiAgICBkZWYgdmlzaXRfRm9yKHNlbGYsIG5vZGU6IGFzdC5Gb3IpOg0KICAgICAgICBzZWxmLmN5Y2xvbWF0aWNfY29tcGxleGl0eSArPSAxDQogICAgICAgIHNlbGYuX2luY3JlYXNlX2NvZ25pdGl2ZSgxKQ0KICAgICAgICANCiAgICAgICAgc2VsZi5jdXJyZW50X25lc3RpbmcgKz0gMQ0KICAgICAgICBzZWxmLmdlbmVyaWNfdmlzaXQobm9kZSkNCiAgICAgICAgc2VsZi5jdXJyZW50X25lc3RpbmcgLT0gMQ0KDQogICAgIyAzLiDEkG8gbMaw4budbmcgdsOybmcgbOG6t3AgV2hpbGUNCiAgICBkZWYgdmlzaXRfV2hpbGUoc2VsZiwgbm9kZTogYXN0LldoaWxlKToNCiAgICAgICAgc2VsZi5jeWNsb21hdGljX2NvbXBsZXhpdHkgKz0gMQ0KICAgICAgICBzZWxmLl9pbmNyZWFzZV9jb2duaXRpdmUoMSkNCiAgICAgICAgDQogICAgICAgIHNlbGYuY3VycmVudF9uZXN0aW5nICs9IDENCiAgICAgICAgc2VsZi5nZW5lcmljX3Zpc2l0KG5vZGUpDQogICAgICAgIHNlbGYuY3VycmVudF9uZXN0aW5nIC09IDENCg0KICAgICMgNC4gxJBvIGzGsOG7nW5nIGto4buRaSBFeGNlcHQgKFRyeS1DYXRjaCkNCiAgICBkZWYgdmlzaXRfRXhjZXB0SGFuZGxlcihzZWxmLCBub2RlOiBhc3QuRXhjZXB0SGFuZGxlcik6DQogICAgICAgIHNlbGYuY3ljbG9tYXRpY19jb21wbGV4aXR5ICs9IDENCiAgICAgICAgc2VsZi5faW5jcmVhc2VfY29nbml0aXZlKDEpDQogICAgICAgIA0KICAgICAgICBzZWxmLmN1cnJlbnRfbmVzdGluZyArPSAxDQogICAgICAgIHNlbGYuZ2VuZXJpY192aXNpdChub2RlKQ0KICAgICAgICBzZWxmLmN1cnJlbnRfbmVzdGluZyAtPSAxDQoNCiAgICAjIDUuIMSQbyBsxrDhu51uZyBjw6FjIHRvw6FuIHThu60gbG9naWMgQm9vbGVhbnMgKGFuZCwgb3IpDQogICAgZGVmIHZpc2l0X0Jvb2xPcChzZWxmLCBub2RlOiBhc3QuQm9vbE9wKToNCiAgICAgICAgIyBN4buXaSB0b8OhbiB04butIGFuZC9vciBsw6BtIHTEg25nIDEgxJHGsOG7nW5nIHLhur0gbmjDoW5oDQogICAgICAgIHNlbGYuY3ljbG9tYXRpY19jb21wbGV4aXR5ICs9IGxlbihub2RlLnZhbHVlcykgLSAxDQogICAgICAgIHNlbGYuY29nbml0aXZlX2NvbXBsZXhpdHkgKz0gbGVuKG5vZGUudmFsdWVzKSAtIDENCiAgICAgICAgc2VsZi5nZW5lcmljX3Zpc2l0KG5vZGUpDQoNCg0KZGVmIGF1ZGl0X2Z1bmN0aW9uKGZ1bmM6IEFueSkgLT4gdHVwbGVbaW50LCBpbnRdOg0KICAgIHNvdXJjZSA9IGluc3BlY3QuZ2V0c291cmNlKGZ1bmMpDQogICAgdHJlZSA9IGFzdC5wYXJzZShzb3VyY2UpDQogICAgYW5hbHl6ZXIgPSBDb21wbGV4aXR5QW5hbHl6ZXIoKQ0KICAgIGFuYWx5emVyLnZpc2l0KHRyZWUpDQogICAgcmV0dXJuIGFuYWx5emVyLmN5Y2xvbWF0aWNfY29tcGxleGl0eSwgYW5hbHl6ZXIuY29nbml0aXZlX2NvbXBsZXhpdHkNCg0KDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCiMgQ8OBQyBIw4BNIFRI4busIE5HSEnhu4ZNIMSQw4FOSCBHScOBIMSQ4buYIFBI4buoQyBU4bqgUA0KIyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQoNCmRlZiBzaW1wbGVfZnVuY3Rpb24oeDogaW50KSAtPiBpbnQ6DQogICAgIiIiTcOjIHR14bqnbiB04buxIMSRxqFuIGdp4bqjbjogTSA9IDEsIENvZ25pdGl2ZSA9IDAiIiINCiAgICByZXN1bHQgPSB4ICogMg0KICAgIHJldHVybiByZXN1bHQgKyAxMA0KDQoNCmRlZiBjb21wbGV4X25lc3RlZF9zcGFnaGV0dGkoZGF0YTogbGlzdFtsaXN0W2ludF1dLCB0aHJlc2hvbGQ6IGludCwgZmxhZzogYm9vbCkgLT4gaW50Og0KICAgICIiIkjDoG0gcGjhu6ljIHThuqFwIHbhu5tpIG5oaeG7gXUgdOG6p25nIGzhu5NuZyBuaGF1OiBTaW5oIHJhIENvZ25pdGl2ZSBDb21wbGV4aXR5IHLhuqV0IGNhbyIiIg0KICAgIHRvdGFsID0gMA0KICAgIGlmIGZsYWc6ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAjIENDICsxLCBDb2cgKzENCiAgICAgICAgZm9yIHJvdyBpbiBkYXRhOiAgICAgICAgICAgICAgICAgICAgIyBDQyArMSwgQ29nICsoMSArIDEpID0gKzINCiAgICAgICAgICAgIGZvciB2YWwgaW4gcm93OiAgICAgICAgICAgICAgICAgIyBDQyArMSwgQ29nICsoMSArIDIpID0gKzMNCiAgICAgICAgICAgICAgICBpZiB2YWwgPiB0aHJlc2hvbGQgYW5kIHZhbCAlIDIgPT0gMDogICMgQ0MgKzIsIENvZyArKDEgKyAzKSArIDEgPSArNQ0KICAgICAgICAgICAgICAgICAgICB0b3RhbCArPSB2YWwNCiAgICAgICAgICAgICAgICBlbHNlOg0KICAgICAgICAgICAgICAgICAgICB0b3RhbCAtPSAxDQogICAgcmV0dXJuIHRvdGFsDQoNCg0KaWYgX19uYW1lX18gPT0gIl9fbWFpbl9fIjoNCiAgICBwcmludCgiPT09IFB5dGhvbiAzLjExKyBBU1QgU29mdHdhcmUgQ29tcGxleGl0eSBTY2FubmVyID09PSIpDQogICAgDQogICAgIyDEkMOhbmggZ2nDoSBow6BtIDENCiAgICBtMSwgYzEgPSBhdWRpdF9mdW5jdGlvbihzaW1wbGVfZnVuY3Rpb24pDQogICAgcHJpbnQoZiJcbltzaW1wbGVfZnVuY3Rpb25dIikNCiAgICBwcmludChmIiAgLT4gQ3ljbG9tYXRpYyBDb21wbGV4aXR5IChNY0NhYmUpIDoge20xfSIpDQogICAgcHJpbnQoZiIgIC0+IENvZ25pdGl2ZSBDb21wbGV4aXR5IChTb25hcikgICA6IHtjMX0iKQ0KICAgIHByaW50KGYiICAtPiBFdmFsdWF0aW9uICAgICAgICAgICAgICAgICAgICAgOiBDbGVhbiAmIE1haW50YWluYWJsZSIpDQoNCiAgICAjIMSQw6FuaCBnacOhIGjDoG0gMg0KICAgIG0yLCBjMiA9IGF1ZGl0X2Z1bmN0aW9uKGNvbXBsZXhfbmVzdGVkX3NwYWdoZXR0aSkNCiAgICBwcmludChmIlxuW2NvbXBsZXhfbmVzdGVkX3NwYWdoZXR0aV0iKQ0KICAgIHByaW50KGYiICAtPiBDeWNsb21hdGljIENvbXBsZXhpdHkgKE1jQ2FiZSkgOiB7bTJ9IikNCiAgICBwcmludChmIiAgLT4gQ29nbml0aXZlIENvbXBsZXhpdHkgKFNvbmFyKSAgIDoge2MyfSIpDQogICAgcHJpbnQoZiIgIC0+IEV2YWx1YXRpb24gICAgICAgICAgICAgICAgICAgICA6IENSSVRJQ0FMIFdBUk5JTkchIEV4Y2VlZHMgbWVudGFsIGJ1ZGdldCAoTmVzdGluZyBkZXB0aCkiKQ0KDQogICAgIyBRdWFsaXR5IEdhdGUgQXNzZXJ0aW9uDQogICAgQ09NUExFWElUWV9CVURHRVQgPSA1DQogICAgcHJpbnQoZiJcbltDSS9DRCBRdWFsaXR5IEdhdGUgQ2hlY2sgKE1heCBBbGxvd2VkID0ge0NPTVBMRVhJVFlfQlVER0VUfSldIikNCiAgICBpZiBtMiA+IENPTVBMRVhJVFlfQlVER0VUIG9yIGMyID4gQ09NUExFWElUWV9CVURHRVQ6DQogICAgICAgIHByaW50KCIgIOKdjCBRVUFMSVRZIEdBVEUgRkFJTEVEOiBQdWxsIFJlcXVlc3QgcmVqZWN0ZWQhIFBsZWFzZSByZWZhY3RvciBuZXN0ZWQgbG9vcHMuIikNCiAgICBlbHNlOg0KICAgICAgICBwcmludCgiICDinIUgUVVBTElUWSBHQVRFIFBBU1NFRC4iKQ0KYGBgDQoNCiMjIyMgVGVybWluYWwgT3V0cHV0IE3huqt1IChQeXRob24gMy4xMSspOg0KYGBgdGV4dA0KPT09IFB5dGhvbiAzLjExKyBBU1QgU29mdHdhcmUgQ29tcGxleGl0eSBTY2FubmVyID09PQ0KDQpbc2ltcGxlX2Z1bmN0aW9uXQ0KICAtPiBDeWNsb21hdGljIENvbXBsZXhpdHkgKE1jQ2FiZSkgOiAxDQogIC0+IENvZ25pdGl2ZSBDb21wbGV4aXR5IChTb25hcikgICA6IDANCiAgLT4gRXZhbHVhdGlvbiAgICAgICAgICAgICAgICAgICAgIDogQ2xlYW4gJiBNYWludGFpbmFibGUNCg0KW2NvbXBsZXhfbmVzdGVkX3NwYWdoZXR0aV0NCiAgLT4gQ3ljbG9tYXRpYyBDb21wbGV4aXR5IChNY0NhYmUpIDogNg0KICAtPiBDb2duaXRpdmUgQ29tcGxleGl0eSAoU29uYXIpICAgOiAxMg0KICAtPiBFdmFsdWF0aW9uICAgICAgICAgICAgICAgICAgICAgOiBDUklUSUNBTCBXQVJOSU5HISBFeGNlZWRzIG1lbnRhbCBidWRnZXQgKE5lc3RpbmcgZGVwdGgpDQoNCltDSS9DRCBRdWFsaXR5IEdhdGUgQ2hlY2sgKE1heCBBbGxvd2VkID0gNSldDQogIOKdjCBRVUFMSVRZIEdBVEUgRkFJTEVEOiBQdWxsIFJlcXVlc3QgcmVqZWN0ZWQhIFBsZWFzZSByZWZhY3RvciBuZXN0ZWQgbG9vcHMuDQpgYGANCg0KLS0tDQoNCiMjIDQuIFN5c3RlbXMgRW5naW5lZXJpbmcgJiBQcm9kdWN0aW9uIFBpdGZhbGxzDQoNCiMjIyBDw6FjIEPhuqFtIELhuqt5IFRo4buxYyBDaGnhur9uIChHb3RjaGFzICYgUHJvZHVjdGlvbiBBbnRpcGF0dGVybnMpDQoNCjEuICoqU+G7sSBC4bqldCBM4buxYyBD4bunYSBDeWNsb21hdGljIENvbXBsZXhpdHkgxJDhu5FpIFbhu5tpIELhuqV0IMSQ4buTbmcgQuG7mSAoQXN5bmMvQXdhaXQgJiBDb25jdXJyZW5jeSkqKjoNCiAgIC0gKkLhuqNuIGNo4bqldCo6IEN5Y2xvbWF0aWMgQ29tcGxleGl0eSB0w61uaCB0b8OhbiBk4buxYSB0csOqbiBtw6MgxJHhu5NuZyBi4buZIHR14bqnbiB04buxIChTZXF1ZW50aWFsIENGRykuIEtoaSB4deG6pXQgaGnhu4duIGPDoWMgbHXhu5NuZyBi4bqldCDEkeG7k25nIGLhu5kgKGBhc3luY2AvYGF3YWl0YCwgR29yb3V0aW5lcywgVGhyZWFkIFBvb2xzKSwgbeG7mXQgaMOgbSBjw7MgdGjhu4MgY8OzICRNID0gMiQgbmjGsG5nIMSR4buZIHBo4bupYyB04bqhcCB24buBIG3hurd0IFJhY2UgQ29uZGl0aW9ucywgRGVhZGxvY2tzIHbDoCBOb24tZGV0ZXJtaW5pc3RpYyBTdGF0ZSBs4bqhaSBsw6AgdsO0IGPhu7FjIQ0KICAgLSAqS2jhuq9jIHBo4bulYyo6IEtow7RuZyBjaOG7iSBk4buxYSB2w6BvIE1jQ2FiZTsga+G6v3QgaOG7o3AgbcO0IGjDrG5oIGjDs2EgaMOsbmggdGjhu6ljIChGb3JtYWwgVmVyaWZpY2F0aW9uIG5oxrAgVExBKyBob+G6t2MgUGV0cmkgTmV0cykgdsOgIGPDtG5nIGPhu6UgVGhyZWFkU2FuaXRpemVyIGNobyBjw6FjIG1vZHVsZSDEkWEgbHXhu5NuZy4NCg0KMi4gKipI4buZaSBDaOG7qW5nIFJlZmFjdG9yaW5nIEjDrG5oIFRo4bupYyAoQ2hlYXQgQ29tcGxleGl0eSBNZXRyaWNzKSoqOg0KICAgLSAqQuG6o24gY2jhuqV0KjogxJDhu4MgcXVhIG3hurd0IFF1YWxpdHkgR2F0ZSB0csOqbiBDSSAoJE0gXGxlIDEwJCksIGvhu7kgc8awIGTDuW5nIG3hurlvIGNoaWEgbmjhu48gbeG7mXQgaMOgbSBwaOG7qWMgdOG6oXAgdGjDoG5oIDEwIGjDoG0gY29uIDMgZMOybmcgKGBoZWxwZXIxYCwgYGhlbHBlcjJgLi4uKSBuaMawbmcgduG6q24gY2hpYSBz4bq7IHRy4bqhbmcgdGjDoWkgdG/DoG4gY+G7pWMgaG/hurdjIHRydXnhu4FuIHRoYW0gc+G7kSBkw6B5IMSR4bq3Yy4gVmnhu4djIG7DoHkgbMOgbSBnaeG6o20gQ3ljbG9tYXRpYyBDb21wbGV4aXR5IGPhu6dhIHThu6tuZyBow6BtIG5oxrBuZyBsw6BtIHTEg25nIHThu5VuZyDEkeG7mSBwaOG7qWMgdOG6oXAgdG/DoG4gY+G7pWMgKFNob3RndW4gU3VyZ2VyeSBTbWVsbCkgdsOgIGzDoG0gbcOjIGtow7MgxJHhu41jIGjGoW4gdHLGsOG7m2MhDQogICAtICpLaOG6r2MgcGjhu6VjKjogUmVmYWN0b3IgcGjhuqNpIMSRaSBrw6htIHZp4buHYyBjw7QgbOG6rXAgdHLDoWNoIG5oaeG7h20gbmdoaeG7h3AgduG7pSAoRG9tYWluIEJvdW5kYXJpZXMpIGNo4bupIGtow7RuZyDEkcahbiB0aHXhuqduIGzDoCBj4bqvdCB24bulbiBkw7JuZyBjb2RlLg0KDQozLiAqKkPGoSBDaOG6vyBC4buPIFF1YSBD4buVbmcgQ2jhuqV0IEzGsOG7o25nIEtoaSBIb3RmaXggS2jhuqluIEPhuqVwKio6DQogICAtICpC4bqjbiBjaOG6pXQqOiBLaGkgaOG7hyB0aOG7kW5nIFByb2R1Y3Rpb24gYuG7iyBz4bqtcCwgYmFuIGzDo25oIMSR4bqhbyB0aMaw4budbmcgY2hvIHBow6lwIGfhuq9uIGPhu50gYFtza2lwIGNpXWAgaG/hurdjIGAvLyBOT1NPTkFSYCDEkeG7gyDEkeG6qXkgYuG6o24gdsOhIGzhu5dpIG5oYW5oIG5o4bqldCBjw7MgdGjhu4MuIFR1eSBuaGnDqm4sIGjGoW4gJDcwXCUkIGPDoWMga2hv4bqjbiBu4bujIGvhu7kgdGh14bqtdCDEkeG7mWMgaOG6oWkgbmjhuqV0IGzhuqFpIGLhuq90IG5ndeG7k24gdOG7qyBjw6FjIGLhuqNuIGhvdGZpeCBuw6B5IHbDoCBraMO0bmcgYmFvIGdp4budIMSRxrDhu6NjIHRy4bqjIGzhuqFpLg0KICAgLSAqS2jhuq9jIHBo4bulYyo6IFRoaeG6v3QgbOG6rXAgcXV5IHRyw6xuaCAiVGVjaG5pY2FsIERlYnQgVGlja2V0IjogTeG7jWkgbOG7h25oIGJ5cGFzcyBRdWFsaXR5IEdhdGUgdHJvbmcgdHLGsOG7nW5nIGjhu6NwIGto4bqpbiBj4bqlcCBwaOG6o2kgdOG7sSDEkeG7mW5nIGvDrWNoIGhv4bqhdCB04bqhbyBt4buZdCBKaXJhIFRpY2tldCBt4bupYyBQMSDEkeG7gyDEkeG7mWkgbmfFqSB0w6FpIGPhuqV1IHRyw7pjIGzhuqFpIHRyb25nIHNwcmludCBr4bq/IHRp4bq/cC4NCg0KNC4gKipL4bu5IFRodeG6rXQgQ2jhuqluIMSQb8OhbiDEkOG7mSBQaOG7qWMgVOG6oXAgQuG6sW5nIENMSSoqOg0KICAgYGBgYmFzaA0KICAgIyAxLiBRdcOpdCBDeWNsb21hdGljIENvbXBsZXhpdHkgdG/DoG4gYuG7mSBk4buxIMOhbiBDKysgLyBQeXRob24gYuG6sW5nIExpemFyZCBDTEkNCiAgIGxpemFyZCBzcmMvIC1DIDEwIC1hIDUgLXcNCg0KICAgIyAyLiBRdcOpdCBNYWludGFpbmFiaWxpdHkgSW5kZXggKE1JKSBjaG8gUHl0aG9uIGLhurFuZyBSYWRvbg0KICAgcmFkb24gbWkgc3JjLyAtcw0KDQogICAjIDMuIFF1w6l0IHBow6F0IGhp4buHbiBDb2RlIFNtZWxscyB2w6AgUHJpbWl0aXZlIE9ic2Vzc2lvbiBi4bqxbmcgU29uYXJTY2FubmVyIENMSQ0KICAgc29uYXItc2Nhbm5lciBcDQogICAgIC1Ec29uYXIucHJvamVjdEtleT1jb3JlLWVudGVycHJpc2UtZW5naW5lIFwNCiAgICAgLURzb25hci5zb3VyY2VzPXNyYyBcDQogICAgIC1Ec29uYXIucXVhbGl0eWdhdGUud2FpdD10cnVlDQoNCiAgICMgNC4gS2nhu4NtIHRyYSBj4bqjbmggYsOhbyBow6BtIHF1w6EgZMOgaSB0cm9uZyBDKysgYuG6sW5nIENsYW5nLVRpZHkNCiAgIGNsYW5nLXRpZHkgc3JjL21haW4uY3BwIC1jaGVja3M9InJlYWRhYmlsaXR5LWZ1bmN0aW9uLXNpemUscmVhZGFiaWxpdHktY29nbml0aXZlLWNvbXBsZXhpdHkiIC0tIC1zdGQ9YysrMjANCiAgIGBgYA0KDQotLS0NCg0KIyMgNS4gQuG6o25nIFNvIHPDoW5oICYgRGVjaXNpb24gTWF0cml4DQoNCiMjIyA1LjEuIFNvIFPDoW5oIEPDoWMgVGjGsOG7m2MgxJBvIMSQ4buZIFBo4bupYyBU4bqhcCBNw6MgTmd14buTbg0KDQp8IFRoxrDhu5tjIMSQbyB8IEPGoSBDaOG6vyDEkG8gTMaw4budbmcgfCDEkGnhu4NtIE3huqFuaCB8IEjhuqFuIENo4bq/IEPhu5F0IEzDtWkgfCBOZ8aw4buhbmcgS2h1eeG6v24gTmdo4buLIHwNCnwgOi0tLSB8IDotLS0gfCA6LS0tIHwgOi0tLSB8IDotLS0gfA0KfCAqKkN5Y2xvbWF0aWMgQ29tcGxleGl0eSAoTWNDYWJlKSoqIHwgxJDhu5MgdGjhu4sgbHXhu5NuZyDEkWnhu4F1IGtoaeG7g24gKCRNID0gRSAtIE4gKyAyUCQpIHwgWMOhYyDEkeG7i25oIGNow61uaCB4w6FjIHPhu5EgbMaw4bujbmcgY2Ega2nhu4NtIHRo4butIFVuaXQgVGVzdCBj4bqnbiB0aGnhur90IHwgQ29pIGPDoWMgcuG6vSBuaMOhbmggcGjhurNuZyAoYHN3aXRjaC1jYXNlYCkgbuG6t25nIGLhurFuZyBs4buTbmcgc8OidSAoYG5lc3RlZCBpZmApIHwgJFxsZSAxMCQgcGVyIGZ1bmN0aW9uIHwNCnwgKipDb2duaXRpdmUgQ29tcGxleGl0eSAoU29uYXJTb3VyY2UpKiogfCBQaOG6oXQgxJFp4buDbSBnaWEgdMSDbmcgdGhlbyDEkeG7mSBzw6J1IGzhu5NuZyBuaGF1IChOZXN0aW5nKSB8IFBo4bqjbiDDoW5oIGNow6JuIHRo4buxYyBu4buXIGzhu7FjIG5o4bqtbiB0aOG7qWMgY+G7p2EgbsOjbyBi4buZIGzhuq1wIHRyw6xuaCB2acOqbiB8IEtow7RuZyB0cuG7sWMgdGnhur9wIMOhbmggeOG6oSByYSBz4buRIGzGsOG7o25nIGNhIGtp4buDbSB0aOG7rSBj4bqnbiB2aeG6v3QgfCAkXGxlIDE1JCBwZXIgZnVuY3Rpb24gfA0KfCAqKkhhbHN0ZWFkIFByb2dyYW0gVm9sdW1lKiogfCBT4buRIGzGsOG7o25nIFRvw6FuIHThu60gKCRcZXRhXzEkKSB2w6AgVG/DoW4gaOG6oW5nICgkXGV0YV8yJCkgfCDEkMOhbmggZ2nDoSBkdW5nIGzGsOG7o25nIHRow7RuZyB0aW4gdsOgIHRo4budaSBnaWFuIGNvZGUgZOG7sSBraeG6v24gfCBC4buLIHBo4bulIHRodeG7mWMgdsOgbyBwaG9uZyBjw6FjaCDEkeG6t3QgdMOqbiBiaeG6v24gdsOgIMSR4buZIGTDoGkgYmnhu4N1IHRo4bupYyB8ICRWIFxsZSAxMDAwJCBiaXRzIHwNCnwgKipNYWludGFpbmFiaWxpdHkgSW5kZXggKE1JKSoqIHwgS+G6v3QgaOG7o3AgTG9nYXJpdCBj4bunYSBWb2x1bWUsIE1jQ2FiZSB2w6AgTE9DIHwgQ3VuZyBj4bqlcCBjaOG7iSBz4buRIHThu5VuZyBxdWFuIHThu6sgJDAgLSAxMDAkIGNobyBj4bqlcCDEkeG7mSBxdeG6o24gbMO9IHwgQ8O0bmcgdGjhu6ljIHRo4buxYyBuZ2hp4buHbSwgxJHDtGkga2hpIMSRw6FuaCBnacOhIHF1w6EgY2FvIHPhu5EgZMOybmcgbcOjIHwgJFxnZSA4NSQgKEdyZWVuIFpvbmUpIHwNCg0KIyMjIDUuMi4gTWEgVHLhuq1uIFBow6F0IEhp4buHbiAmIFjhu60gTMO9IENvZGUgU21lbGxzIEtpbmggxJBp4buDbg0KDQp8IENvZGUgU21lbGwgfCBE4bqldSBIaeG7h3UgTmjhuq1uIEJp4bq/dCB8IEjhuq11IFF14bqjIEjhu4cgVGjhu5FuZyB8IEvhu7kgVGh14bqtdCBSZWZhY3RvcmluZyBDaHXhuqluIE3hu7FjIHwNCnwgOi0tLSB8IDotLS0gfCA6LS0tIHwgOi0tLSB8DQp8ICoqTG9uZyBNZXRob2QqKiB8IEjDoG0gJD4gNTAkIGTDsm5nLCBjdeG7mW4gY2h14buZdCBt4buPaSB0YXkgfCBLaMOzIGtp4buDbSB0aOG7rSwgxJHhu5kgcGjhu6ljIHThuqFwIG5o4bqtbiB0aOG7qWMgY2FvIHwgYEV4dHJhY3QgTWV0aG9kYCwgYFJlcGxhY2UgVGVtcCB3aXRoIFF1ZXJ5YCB8DQp8ICoqTGFyZ2UgQ2xhc3MgKEdvZCBDbGFzcykqKiB8IENsYXNzICQ+IDUwMCQgZMOybmcsIHF1w6Egbmhp4buBdSB0csOhY2ggbmhp4buHbSB8IFZpIHBo4bqhbSBTUlAsIHh1bmcgxJHhu5l0IEdpdCBraGkgbWVyZ2UgbGnDqm4gdOG7pWMgfCBgRXh0cmFjdCBDbGFzc2AsIGBFeHRyYWN0IFN1YmNsYXNzYCwgREREIEFnZ3JlZ2F0ZXMgfA0KfCAqKkZlYXR1cmUgRW52eSoqIHwgQ2xhc3MgJEEkIGfhu41pIG5oaeG7gXUgZ2V0dGVyIGPhu6dhIENsYXNzICRCJCB8IEdow6lwIG7hu5FpIGNo4bq3dCAoVGlnaHQgQ291cGxpbmcpLCBwaMOibiB0w6FuIGxvZ2ljIHwgYE1vdmUgTWV0aG9kYCwgYEV4dHJhY3QgJiBNb3ZlIE1ldGhvZGAgfA0KfCAqKlByaW1pdGl2ZSBPYnNlc3Npb24qKiB8IETDuW5nIGBzdHJpbmdgL2BpbnRgIGNobyBFbWFpbCwgVGnhu4FuLCBQaG9uZSB8IEThu4UgdHJ1eeG7gW4gbmjhuqdtIHRo4bupIHThu7EsIHRoaeG6v3UgeMOhYyB0aOG7sWMgZ2nDoSB0cuG7iyB8IGBSZXBsYWNlIFByaW1pdGl2ZSB3aXRoIFZhbHVlIE9iamVjdGAgfA0KfCAqKlNob3RndW4gU3VyZ2VyeSoqIHwgTeG7l2kgbOG6p24gxJHhu5VpIDEgbG9naWMgcGjhuqNpIHPhu61hIOG7nyAxMCBmaWxlcyBraMOhYyBuaGF1IHwgROG7hSBi4buPIHPDs3QgZmlsZSBk4bqrbiDEkeG6v24gYnVnIG5n4bqnbSB0csOqbiBwcm9kdWN0aW9uIHwgYE1vdmUgRmllbGQvTWV0aG9kYCwgYElubGluZSBDbGFzc2AgZ29tIGxvZ2ljIGzhuqFpIHwNCg==