Chế độ giao diện
8.2. Kỹ Nghệ Tái Cấu Trúc Mã Nguồn (Refactoring Engineering & Catalog)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: Tái cấu trúc mã nguồn (Refactoring) là quá trình thay đổi cấu trúc bên trong của phần mềm nhằm làm sạch thiết kế và giảm chi phí bảo trì mà TUYỆT ĐỐI KHÔNG làm thay đổi hành vi quan sát được từ bên ngoài; điều kiện tiên quyết không thể thương lượng là phải có một lưới an toàn kiểm thử tự động (Characterization Tests) bao phủ trước khi chạm vào mã nguồn.
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
Phép loại suy kỹ thuật: Bảo dưỡng Động cơ Phản lực vs Đập đi Xây lại
Hãy hình dung hệ thống phần mềm giống như một cỗ động cơ phản lực thương mại:
- Viết lại từ đầu (Rewriting / Big Bang Rebuild): Giống như việc bạn vứt bỏ toàn bộ cỗ máy động cơ đã bay an toàn 10 năm qua để thiết kế một động cơ mới toanh từ con số không. Kết quả là chi phí bùng nổ, thời gian trễ hạn hàng năm trời, và toàn bộ những bài học kinh nghiệm xử lý rung lắc, nhiệt độ cao trong quá khứ bị xóa sạch.
- Sửa lỗi (Bug Fixing) & Thêm tính năng (Feature Development): Thay đổi lực đẩy của động cơ hoặc gắn thêm cảm biến mới. Hành vi bên ngoài của hệ thống bị biến đổi.
- Tái cấu trúc mã nguồn (Refactoring): Là công tác kỹ thuật đỉnh cao trong xưởng bảo dưỡng định kỳ. Các kỹ sư sắp xếp lại các bó dây điện cho gọn gàng, thay thế các van thủy lực rườm rà bằng các module tiêu chuẩn, làm sạch cặn dầu ở các ống dẫn (khử Code Smells) nhằm giúp việc kiểm tra lần sau nhanh hơn gấp 5 lần. Tuy nhiên, khi đưa lên bệ thử tải, công suất lực đẩy, mức tiêu hao nhiên liệu và phản hồi buồng lái hoàn toàn không đổi dù chỉ một mili-giây.
Martin Fowler (Refactoring: Improving the Design of Existing Code) nhấn mạnh: Refactoring là một chuỗi các vi biến đổi (Micro-transformations) có kỷ luật, mỗi bước nhỏ đều được bảo vệ bởi bộ kiểm thử tự động.
flowchart TD
subgraph SafeLoop ["Vòng Lặp Tái Cấu Trúc An Toàn (Safe Refactoring Loop)"]
A["1. Kiểm Tra Bộ Test Suite Hiện Có<br/>(Must be 100% GREEN)"] --> B{"Test Suite<br/>Đã Đủ Bao Phủ?"}
B -- "Chưa có / Thiếu" --> C["Viết Characterization Tests<br/>(Golden Master Locking)"]
C --> A
B -- "Đã Xanh (Green)" --> D["2. Áp Dụng DUY NHẤT 1 Vi Biến Đổi<br/>(Ví dụ: Extract Method hoặc Rename)"]
D --> E["3. Chạy Lại Bộ Kiểm Thử Tự Động<br/>(Run Fast Unit Tests)"]
E --> F{"Tests Có Pass<br/>(Green) Không?"}
F -- "FAILED (Đỏ)" --> G["Hủy Bỏ Ngay Lập Tức<br/>(git restore / revert)"]
G --> D
F -- "PASSED (Xanh)" --> H["4. Tạo Micro-Commit Vào Git<br/>(git commit -m 'refactor: ...')"]
H --> I{"Còn Code Smell<br/>Cần Xử Lý?"}
I -- "Còn" --> D
I -- "Hoàn Tất" --> J["Mã Nguồn Sạch, Thiết Kế Linh Hoạt"]
end
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Bản chất của Refactoring & Sự khác biệt với Rewriting/Bug Fixing
- Bản chất kỹ thuật:
- Refactoring (Tái cấu trúc):
sao cho . Hệ thống giữ nguyên tính tương đương ngữ nghĩa (Semantic Equivalence). Không sửa bug, không thêm tính năng mới, không thay đổi API hợp đồng công khai. - Rewriting (Viết lại): Đập bỏ codebase cũ để viết lại từ đầu. Thường dẫn đến "Second-System Effect" do đánh giá thấp độ phức tạp của hàng nghìn trường hợp biên (Edge Cases) ẩn sâu trong code cũ.
- Bug Fixing (Vá lỗi): Thay đổi hành vi quan sát được từ sai sang đúng.
- Refactoring (Tái cấu trúc):
2.2. Composing Methods: Extract Method, Inline Method, Extract Variable & Inline Variable
- Bản chất kỹ thuật:
- Extract Method / Function: Nhận diện một khối lệnh thực thi một nhiệm vụ con mạch lạc bên trong một hàm dài, đưa khối lệnh đó ra thành một hàm mới độc lập và đặt tên theo ý định nghiệp vụ (Intention-Revealing Name). Trình biên dịch hiện đại sẽ tự động inline ngược lại hàm này nếu cần tối ưu hiệu năng CPU, do đó chi phí runtime bằng 0.
- Inline Method: Biến đổi ngược chiều của Extract Method. Khi thân hàm quá ngắn, quá hiển nhiên (ví dụ chỉ gọi 1 hàm khác không biến đổi gì) hoặc việc chia nhỏ hàm bị lạm dụng dẫn đến hiện tượng phân mảnh mã nguồn quá mức (Over-fragmentation).
- Extract Variable (Introduce Explaining Variable): Tách các biểu thức điều kiện boolean phức tạp hoặc các phép tính toán lồng nhau thành các biến bất biến cục bộ có tên mang tính giải thích. Ví dụ:cpp
// Trước: if (platform.contains("MAC") && browser.contains("SAFARI") && resizeCount > 0) // Sau: const bool isMacSafari = platform.contains("MAC") && browser.contains("SAFARI"); const bool isWindowResized = resizeCount > 0; if (isMacSafari && isWindowResized) { ... }1
2
3
4
5 - Inline Variable: Loại bỏ các biến tạm trung gian vô bổ chỉ được dùng một lần duy nhất ngay dòng tiếp theo mà không bổ sung thêm giá trị ngữ nghĩa nào.
2.3. The Power of Renaming (Symbol Table & AST-Aware Renaming)
- Bản chất kỹ thuật:
- Kỹ thuật đơn giản nhất nhưng có sức mạnh tái thiết nhận thức cao nhất. Đổi tên biến, hàm, tham số, lớp để phản ánh chính xác mô hình miền (Ubiquitous Language trong Domain-Driven Design).
- Cơ chế tầng sâu: Không bao giờ sử dụng "Find and Replace" văn bản thô hoặc Regex, vì nó sẽ thay thế nhầm các chuỗi trùng tên trong comment, file cấu hình hoặc biến của scope khác. Các công cụ Refactoring hiện đại phân tích Cây cú pháp trừu tượng (AST) và Bảng ký hiệu (Symbol Table) của Compiler/Language Server để chỉ thay thế các Node tham chiếu chính xác đến ký hiệu đó.
2.4. Moving Features: Move Method & Move Field
- Bản chất kỹ thuật:
- Move Method / Move Field: Giải pháp trực tiếp để triệt tiêu Code Smell Feature Envy. Khi Class
chứa một phương thức hoặc thuộc tính nhưng Class lại truy cập nó với tần suất gấp nhiều lần Class . - Kỹ thuật viên sẽ sao chép phương thức sang Class
, điều chỉnh tham chiếu, biến phương thức ở Class thành một hàm ủy quyền (Delegating Method) để duy trì khả năng tương thích ngược, sau đó dần dần deprecate nó.
- Move Method / Move Field: Giải pháp trực tiếp để triệt tiêu Code Smell Feature Envy. Khi Class
2.5. OOP Hierarchy Refactoring: Pull Up Method & Push Down Method
- Bản chất kỹ thuật:
- Pull Up Method (Đẩy phương thức lên lớp cha): Khi phát hiện hai hoặc nhiều lớp con kế thừa cùng sở hữu các phương thức có logic xử lý giống hệt nhau hoặc tương đương. Kỹ sư đẩy phương thức này lên lớp cha chung (Superclass) để tập trung hóa tri thức, tuân thủ nguyên lý DRY.
- Push Down Method (Đẩy phương thức xuống lớp con): Ngược lại, khi một phương thức nằm trên lớp cha nhưng chỉ có một hoặc hai lớp con sử dụng, trong khi các lớp con khác phải để trống hoặc ném
NotSupportedException. Đẩy phương thức đó xuống chính xác các lớp con có nhu cầu sử dụng nhằm làm sạch giao diện lớp cha.
2.6. Simplifying Conditionals: Decompose Conditional
- Bản chất kỹ thuật:
- Các cấu trúc
if-then-elsephức tạp thường chứa đựng 3 vấn đề: Điều kiện kiểm tra khó hiểu, khối lệnhthenquá dài, và khối lệnhelsechứa nhiều chi tiết tầng thấp. - Kỹ thuật Decompose Conditional tách toàn bộ biểu thức điều kiện thành một hàm boolean riêng, tách khối
thenthành một hàm hành động riêng, và tách khốielsethành một hàm hành động khác. Khi đọc lại, hàm chính sẽ giống như một câu văn xuôi:cppif (isSummerSeason(date)) { chargeSummerRate(quantity); } else { chargeWinterRate(quantity); }1
2
3
4
5
- Các cấu trúc
2.7. Replace Conditional with Polymorphism (Khử Switch-Case vi phạm OCP)
- Bản chất kỹ thuật:
- Khi một đoạn mã xuất hiện cấu trúc
switch-casehoặc chuỗiif-else ifdài dằng dặc dựa trên các mã kiểu loại (Type Codes / Enums), mỗi khi doanh nghiệp sinh ra một loại hình mới, kỹ sư buộc phải tìm tất cả các lệnhswitchkhắp hệ thống để thêmcase. Điều này vi phạm nghiêm trọng nguyên lý Open/Closed Principle (OCP). - Cơ chế giải quyết: Định nghĩa một Interface/Abstract Class chứa phương thức hành vi chung. Mỗi
casetrongswitchđược biến thành một lớp con cụ thể cài đặt (implement/override) phương thức đó. Lời gọi hàm phân nhánh được thay thế bằng một lời gọi đa hình động (Dynamic Dispatch qua vtable trong C++ hoặc Virtual Call trong Java/Python). Khi cần thêm loại mới, chỉ cần tạo lớp con mới mà không cần sửa bất kỳ dòng code cũ nào.
- Khi một đoạn mã xuất hiện cấu trúc
classDiagram
class EmployeeRole {
<<abstract>>
+calculateBonus(baseSalary: double) double*
}
class EngineerRole {
+calculateBonus(baseSalary: double) double
}
class ManagerRole {
+calculateBonus(baseSalary: double) double
}
class SalesRole {
+calculateBonus(baseSalary: double) double
}
class Employee {
-name: string
-baseSalary: double
-role: EmployeeRole
+getBonus() double
}
EmployeeRole <|-- EngineerRole
EmployeeRole <|-- ManagerRole
EmployeeRole <|-- SalesRole
Employee *--> EmployeeRole : delegates to
2.8. Refactoring to Patterns (Joshua Kerievsky)
- Bản chất kỹ thuật:
- Thay vì áp đặt các Design Patterns phức tạp (Over-engineering) ngay từ ngày đầu khi bài toán còn chưa rõ ràng, kỹ sư áp dụng tư duy Refactoring to Patterns: Bắt đầu bằng đoạn code đơn giản nhất chạy được. Khi hệ thống tiến hóa và bộc lộ các áp lực thiết kế (Design Pressures), ta tái cấu trúc từng bước nhỏ hướng tới các Pattern chuẩn mực (như Strategy, State, Composite, Factory Method).
2.9. Safe Refactoring Workflow, Characterization Tests (Golden Master) & Test Guardrails
- Bản chất kỹ thuật:
- Characterization Tests (Golden Master): Khi phải tái cấu trúc một hệ thống mã nguồn cũ (Legacy Code) hoàn toàn không có Unit Tests và tài liệu nghiệp vụ đã thất lạc. Kỹ sư không thể đoán trước hệ thống "nên" chạy như thế nào.
- Giải pháp: Viết một chương trình cấp nạp hàng nghìn bộ dữ liệu đầu vào khác nhau vào hệ thống cũ, ghi lại toàn bộ kết quả đầu ra (Snapshot / Golden Master). Bộ kết quả này trở thành "bản tuyên ngôn hành vi" hiện tại. Sau khi tái cấu trúc, bộ test Golden Master này sẽ kiểm tra xem đầu ra có khớp 100% từng bit với kết quả cũ hay không.
- Micro-commits: Mỗi bước tái cấu trúc chỉ thực hiện từ 1 đến 5 phút và commit ngay vào Git. Nếu làm vỡ code, chỉ cần 1 phím tắt để hoàn tác mà không tốn công gỡ lỗi.
3. Thực thi Mã nguồn & Mô phỏng Chuyên sâu (Dual-Engine Implementation)
3.1. Engine C++20: Replace Conditional with Polymorphic Hierarchy
Minh họa việc triệt tiêu switch-case vi phạm OCP bằng cấu trúc Đa hình hiện đại với std::unique_ptr, constexpr, và cơ chế kiểm thử tích hợp.
cpp
#include <iostream>
#include <memory>
#include <string>
#include <string_view>
#include <vector>
#include <cassert>
// ============================================================================
// GIAI ĐOẠN 1: MÃ NGUỒN CŨ (CHƯA REFACTOR - CODE SMELL SWITCH-CASE)
// ============================================================================
enum class LegacyEmployeeType {
ENGINEER,
SALES,
MANAGER
};
// Vi phạm Open/Closed Principle: Mỗi khi thêm loại nhân viên mới, phải sửa hàm này!
[[nodiscard]] double legacyCalculateBonus(LegacyEmployeeType type, double baseSalary) noexcept {
switch (type) {
case LegacyEmployeeType::ENGINEER: return baseSalary * 0.15;
case LegacyEmployeeType::SALES: return baseSalary * 0.20;
case LegacyEmployeeType::MANAGER: return baseSalary * 0.25;
default: return 0.0;
}
}
// ============================================================================
// GIAI ĐOẠN 2: MÃ NGUỒN ĐÃ REFACTOR BẰNG ĐA HÌNH (REPLACE CONDITIONAL WITH POLYMORPHISM)
// ============================================================================
// Interface chiến lược trừu tượng cho vai trò nhân viên
class EmployeeRole {
public:
virtual ~EmployeeRole() = default;
[[nodiscard]] virtual double calculateBonus(double baseSalary) const noexcept = 0;
[[nodiscard]] virtual std::string_view getRoleTitle() const noexcept = 0;
};
class EngineerRole final : public EmployeeRole {
public:
[[nodiscard]] double calculateBonus(double baseSalary) const noexcept override {
return baseSalary * 0.15; // 15% thưởng kỹ sư
}
[[nodiscard]] std::string_view getRoleTitle() const noexcept override {
return "Software Engineer";
}
};
class SalesRole final : public EmployeeRole {
private:
double commissionRate_{0.20};
public:
explicit SalesRole(double commission = 0.20) noexcept : commissionRate_(commission) {}
[[nodiscard]] double calculateBonus(double baseSalary) const noexcept override {
return baseSalary * commissionRate_;
}
[[nodiscard]] std::string_view getRoleTitle() const noexcept override {
return "Sales Specialist";
}
};
class ManagerRole final : public EmployeeRole {
public:
[[nodiscard]] double calculateBonus(double baseSalary) const noexcept override {
return baseSalary * 0.25; // 25% thưởng quản lý
}
[[nodiscard]] std::string_view getRoleTitle() const noexcept override {
return "Engineering Manager";
}
};
// Context Class: Ủy quyền tính toán thưởng cho Interface đa hình
class Employee {
private:
std::string name_;
double baseSalary_;
std::unique_ptr<EmployeeRole> role_;
public:
Employee(std::string name, double baseSalary, std::unique_ptr<EmployeeRole> role)
: name_(std::move(name)), baseSalary_(baseSalary), role_(std::move(role)) {
assert(role_ != nullptr && "EmployeeRole must not be null");
}
// Cho phép thay đổi vai trò động ở Runtime mà không cần tạo object mới (State/Strategy Pattern)
void changeRole(std::unique_ptr<EmployeeRole> newRole) noexcept {
assert(newRole != nullptr);
role_ = std::move(newRole);
}
[[nodiscard]] double getBonus() const noexcept {
return role_->calculateBonus(baseSalary_);
}
[[nodiscard]] std::string_view getRoleTitle() const noexcept {
return role_->getRoleTitle();
}
[[nodiscard]] const std::string& getName() const noexcept {
return name_;
}
};
// ============================================================================
// MAIN TEST DRIVER: XÁC THỰC TÍNH TƯƠNG ĐƯƠNG NGỮ NGHĨA (BEHAVIOR PRESERVATION)
// ============================================================================
int main() {
std::cout << "=== C++20 REFACTORING TO POLYMORPHISM BENCHMARK ===\n\n";
constexpr double kBaseSalary = 100'000.0;
// 1. Kiểm tra tính tương đương ngữ nghĩa giữa hàm cũ và đối tượng đa hình mới
double oldEngBonus = legacyCalculateBonus(LegacyEmployeeType::ENGINEER, kBaseSalary);
Employee engineer("Alice", kBaseSalary, std::make_unique<EngineerRole>());
double newEngBonus = engineer.getBonus();
std::cout << "[Test 1: Verification] Old Bonus: $" << oldEngBonus
<< " | Refactored Bonus: $" << newEngBonus << "\n";
assert(oldEngBonus == newEngBonus && "Refactoring broken: Behavior changed!");
std::cout << "-> Verification Passed: Behavior is 100% Identical.\n\n";
// 2. Minh họa khả năng mở rộng tuân thủ Open/Closed Principle
std::cout << "[Test 2: Dynamic Role Promotion]\n";
std::cout << "Employee " << engineer.getName() << " is currently a "
<< engineer.getRoleTitle() << " with Bonus: $" << engineer.getBonus() << "\n";
std::cout << "Promoting " << engineer.getName() << " to Manager...\n";
engineer.changeRole(std::make_unique<ManagerRole>());
std::cout << "Employee " << engineer.getName() << " is now an "
<< engineer.getRoleTitle() << " with Bonus: $" << engineer.getBonus() << "\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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
3.2. Engine Python 3.11+: Characterization Test Harness (Golden Master)
Mô phỏng quy trình tạo Golden Master snapshot để tái cấu trúc an toàn mã nguồn legacy chưa hề có tài liệu.
python
"""
Python 3.11+ Characterization Test (Golden Master) Harness
Mô phỏng việc khóa chặt hành vi legacy trước khi tiến hành tái cấu trúc an toàn.
"""
from typing import NamedTuple, Protocol
import hashlib
import json
# ============================================================================
# 1. LEGACY SYSTEM (MÃ NGUỒN CŨ RỐI RẮM, CHƯA RÕ QUY TẮC NGHIỆP VỤ)
# ============================================================================
def legacy_tax_calculator(gross_income: float, dependents: int, is_resident: bool) -> float:
"""Mã nguồn cũ chứa đựng hàng loạt logic lồng nhau và magic numbers."""
if not is_resident:
return round(gross_income * 0.25, 2)
taxable = gross_income - (dependents * 4400.0)
if taxable <= 0:
return 0.0
if taxable <= 50_000.0:
res = taxable * 0.10
elif taxable <= 100_000.0:
res = 5000.0 + (taxable - 50_000.0) * 0.20
else:
res = 15000.0 + (taxable - 100_000.0) * 0.30
return round(res, 2)
# ============================================================================
# 2. REFACTORED SYSTEM (MÃ NGUỒN ĐÃ QUA EXTRACT METHOD & GUARD CLAUSES)
# ============================================================================
class TaxBracket(NamedTuple):
lower_bound: float
upper_bound: float
base_tax: float
rate: float
class ModernTaxCalculator:
NON_RESIDENT_FLAT_RATE: float = 0.25
DEPENDENT_DEDUCTION_AMOUNT: float = 4400.0
BRACKETS: tuple[TaxBracket, ...] = (
TaxBracket(0.0, 50_000.0, 0.0, 0.10),
TaxBracket(50_000.0, 100_000.0, 5000.0, 0.20),
TaxBracket(100_000.0, float("inf"), 15000.0, 0.30),
)
@classmethod
def calculate_tax(cls, gross_income: float, dependents: int, is_resident: bool) -> float:
# Guard clause: Người không cư trú áp dụng thuế suất cố định
if not is_resident:
return round(gross_income * cls.NON_RESIDENT_FLAT_RATE, 2)
taxable_income = gross_income - (dependents * cls.DEPENDENT_DEDUCTION_AMOUNT)
if taxable_income <= 0:
return 0.0
for bracket in cls.BRACKETS:
if taxable_income <= bracket.upper_bound:
marginal = taxable_income - bracket.lower_bound
total_tax = bracket.base_tax + (marginal * bracket.rate)
return round(total_tax, 2)
return 0.0
# ============================================================================
# 3. GOLDEN MASTER TEST HARNESS (BẢO ĐẢM KHÔNG LÀM VỠ HÀNH VI CŨ)
# ============================================================================
def generate_test_inputs() -> list[tuple[float, int, bool]]:
"""Tạo không gian mẫu dữ liệu đa chiều bao phủ các trường hợp biên."""
incomes = [0.0, 20_000.0, 50_000.0, 75_000.0, 100_000.0, 250_000.0]
dependents = [0, 1, 2, 5]
residencies = [True, False]
return [(inc, dep, res) for inc in incomes for dep in dependents for res in residencies]
def run_golden_master_verification() -> None:
print("=== RUNNING GOLDEN MASTER REFACTORING VERIFICATION ===")
test_cases = generate_test_inputs()
print(f"Executing {len(test_cases)} automated test vectors...")
mismatches = 0
for gross, dep, res in test_cases:
expected = legacy_tax_calculator(gross, dep, res)
actual = ModernTaxCalculator.calculate_tax(gross, dep, res)
if expected != actual:
print(f"[REGRESSION DETECTED] Input: ({gross}, {dep}, {res}) | Expected: {expected} | Actual: {actual}")
mismatches += 1
if mismatches == 0:
print(f"[SUCCESS] 100% of {len(test_cases)} test vectors matched bit-for-bit.")
print("Refactoring safety confirmed: Zero behavioral alterations.")
else:
print(f"[FAILURE] {mismatches} regressions discovered. Rollback immediately!")
if __name__ == "__main__":
run_golden_master_verification()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
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
3.3. Giả lập Terminal Output
text
=== C++20 REFACTORING TO POLYMORPHISM BENCHMARK ===
[Test 1: Verification] Old Bonus: $15000 | Refactored Bonus: $15000
-> Verification Passed: Behavior is 100% Identical.
[Test 2: Dynamic Role Promotion]
Employee Alice is currently a Software Engineer with Bonus: $15000
Promoting Alice to Manager...
Employee Alice is now an Engineering Manager with Bonus: $25000
=== RUNNING GOLDEN MASTER REFACTORING VERIFICATION ===
Executing 48 automated test vectors...
[SUCCESS] 100% of 48 test vectors matched bit-for-bit.
Refactoring safety confirmed: Zero behavioral alterations.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
4.1. Production Failure Modes
- The "Big Bang" Refactoring Merge Disaster:
- Kịch bản: Một lập trình viên tạo nhánh riêng
refactor-entire-corevà làm việc liên tục trong 3 tuần mà không merge code vào nhánh chính. Trong thời gian này, các đồng nghiệp đã đẩy thêm 50 tính năng mới. Khi merge, xảy ra hàng trăm Git Conflicts semantic phức tạp không thể giải quyết nổi, buộc toàn bộ công sức refactor phải vứt bỏ. - Biện pháp: Refactor theo từng vi bước nhỏ (Micro-commits), mỗi PR chỉ giải quyết 1 hoặc 2 file và merge vào Main ngay trong ngày.
- Kịch bản: Một lập trình viên tạo nhánh riêng
- Refactoring Without Characterization Tests (The Blind Walk):
- Kịch bản: Kỹ sư tự tin dọn dẹp một hàm 1000 dòng trong hệ thống tính tiền giỏ hàng vì thấy code quá rối. Vô tình, một điều kiện kiểm tra biên (Edge Case) xử lý mã giảm giá cho khách hàng VIP bị xóa nhầm. Khi lên production, toàn bộ khách VIP bị tính giá gốc, gây khủng hoảng truyền thông.
- Class Explosion do Lạm Dụng Pattern:
- Kịch bản: Áp dụng Replace Conditional with Polymorphism cho một cấu trúc
switchchỉ có 2 nhánh và vĩnh viễn không bao giờ mở rộng thêm nhánh thứ 3. Kết quả là tạo thêm 5 files interface và class mới, làm tăng độ phức tạp kiến trúc một cách vô ích.
- Kịch bản: Áp dụng Replace Conditional with Polymorphism cho một cấu trúc
4.2. Diagnostic Recipes & Tooling Suite
- IDE Semantic Refactoring (Clangd / Clang-Tidy):
- Tận dụng
clang-tidy -fixđể tự động hóa việc inline hoặc modernize code:bashclang-tidy src/LegacyEngine.cpp -checks='modernize-use-override,readability-redundant-smartptr-get' -fix -- -std=c++201
- Tận dụng
- Rope & Bowler (Python Semantic Refactoring):
- Sử dụng thư viện
ropehoặcbowlerđể thực hiện Rename, Move Method thông qua phân tích AST cây cú pháp, an toàn hơn 100% so với Regex Find-and-Replace.
- Sử dụng thư viện
5. Bảng So sánh & Decision Matrix
| Kỹ Thuật Refactoring | Mục Tiêu Chính | Rủi Ro Hồi Quy | Đòi Hỏi Kiểm Thử | Khi Nào Nên Áp Dụng? |
|---|---|---|---|---|
| Extract Method | Tách hàm nhỏ, tự diễn giải ngữ nghĩa | Thấp | Unit Test của hàm gọi | Khi một khối lệnh có thể tóm tắt bằng một cái tên |
| Inline Method | Xóa phân mảnh, gom logic trực quan | Rất thấp | Unit Test hiện hữu | Khi tên hàm không cung cấp thêm giá trị nào |
| Replace Conditional with Polymorphism | Triệt tiêu switch-case, tuân thủ OCP | Trung bình | Comprehensive Test Suite | Khi các nhánh switch có xu hướng liên tục phát sinh mới |
| Decompose Conditional | Làm phẳng logic phức tạp trong if-else | Thấp | Test case cho từng nhánh | Khi biểu thức điều kiện quá dài và khó hiểu |
| Move Method / Field | Khử Feature Envy, gắn kết logic đúng chỗ | Trung bình | Cần kiểm tra coupling các module | Khi một hàm sử dụng dữ liệu của class khác nhiều hơn |
| Golden Master Harness | Khóa chặt hành vi của Legacy Code | Cực thấp (Bảo vệ an toàn) | Tự sinh không gian mẫu | Bắt buộc thực hiện trước khi đụng vào code cũ không có test |
IyA4LjIuIEvhu7kgTmdo4buHIFTDoWkgQ+G6pXUgVHLDumMgTcOjIE5ndeG7k24gKFJlZmFjdG9yaW5nIEVuZ2luZWVyaW5nICYgQ2F0YWxvZykNCg0KPiBbIUlNUE9SVEFOVF0NCj4gKipO4bq/dSBi4bqhbiBjaOG7iSDEkcaw4bujYyBuaOG7myBt4buZdCDEkWnhu4F1IGR1eSBuaOG6pXQ6KiogVMOhaSBj4bqldSB0csO6YyBtw6Mgbmd14buTbiAoUmVmYWN0b3JpbmcpIGzDoCBxdcOhIHRyw6xuaCB0aGF5IMSR4buVaSBj4bqldSB0csO6YyBiw6puIHRyb25nIGPhu6dhIHBo4bqnbiBt4buBbSBuaOG6sW0gbMOgbSBz4bqhY2ggdGhp4bq/dCBr4bq/IHbDoCBnaeG6o20gY2hpIHBow60gYuG6o28gdHLDrCBtw6AgKipUVVnhu4ZUIMSQ4buQSSBLSMOUTkcqKiBsw6BtIHRoYXkgxJHhu5VpIGjDoG5oIHZpIHF1YW4gc8OhdCDEkcaw4bujYyB04burIGLDqm4gbmdvw6BpOyDEkWnhu4F1IGtp4buHbiB0acOqbiBxdXnhur90IGtow7RuZyB0aOG7gyB0aMawxqFuZyBsxrDhu6NuZyBsw6AgcGjhuqNpIGPDsyBt4buZdCBsxrDhu5tpIGFuIHRvw6BuIGtp4buDbSB0aOG7rSB04buxIMSR4buZbmcgKENoYXJhY3Rlcml6YXRpb24gVGVzdHMpIGJhbyBwaOG7pyB0csaw4bubYyBraGkgY2jhuqFtIHbDoG8gbcOjIG5ndeG7k24uDQoNCi0tLQ0KDQojIyAxLiBLaeG6v24gdHLDumMgVOG7lW5nIHF1YW4gJiBNw7QgaMOsbmggVMawIGR1eSAoTWVudGFsIE1vZGVsKQ0KDQojIyMgUGjDqXAgbG/huqFpIHN1eSBr4bu5IHRodeG6rXQ6IELhuqNvIGTGsOG7oW5nIMSQ4buZbmcgY8ahIFBo4bqjbiBs4buxYyB2cyDEkOG6rXAgxJFpIFjDonkgbOG6oWkNCkjDo3kgaMOsbmggZHVuZyBo4buHIHRo4buRbmcgcGjhuqduIG3hu4FtIGdp4buRbmcgbmjGsCBt4buZdCBj4buXIMSR4buZbmcgY8ahIHBo4bqjbiBs4buxYyB0aMawxqFuZyBt4bqhaToNCi0gKipWaeG6v3QgbOG6oWkgdOG7qyDEkeG6p3UgKFJld3JpdGluZyAvIEJpZyBCYW5nIFJlYnVpbGQpKio6IEdp4buRbmcgbmjGsCB2aeG7h2MgYuG6oW4gduG7qXQgYuG7jyB0b8OgbiBi4buZIGPhu5cgbcOheSDEkeG7mW5nIGPGoSDEkcOjIGJheSBhbiB0b8OgbiAxMCBuxINtIHF1YSDEkeG7gyB0aGnhur90IGvhur8gbeG7mXQgxJHhu5luZyBjxqEgbeG7m2kgdG9hbmggdOG7qyBjb24gc+G7kSBraMO0bmcuIEvhur90IHF14bqjIGzDoCBjaGkgcGjDrSBiw7luZyBu4buVLCB0aOG7nWkgZ2lhbiB0cuG7hSBo4bqhbiBow6BuZyBuxINtIHRy4budaSwgdsOgIHRvw6BuIGLhu5kgbmjhu69uZyBiw6BpIGjhu41jIGtpbmggbmdoaeG7h20geOG7rSBsw70gcnVuZyBs4bqvYywgbmhp4buHdCDEkeG7mSBjYW8gdHJvbmcgcXXDoSBraOG7qSBi4buLIHjDs2Egc+G6oWNoLg0KLSAqKlPhu61hIGzhu5dpIChCdWcgRml4aW5nKSAmIFRow6ptIHTDrW5oIG7Eg25nIChGZWF0dXJlIERldmVsb3BtZW50KSoqOiBUaGF5IMSR4buVaSBs4buxYyDEkeG6qXkgY+G7p2EgxJHhu5luZyBjxqEgaG/hurdjIGfhuq9uIHRow6ptIGPhuqNtIGJp4bq/biBt4bubaS4gSMOgbmggdmkgYsOqbiBuZ2/DoGkgY+G7p2EgaOG7hyB0aOG7kW5nIGLhu4sgYmnhur9uIMSR4buVaS4NCi0gKipUw6FpIGPhuqV1IHRyw7pjIG3DoyBuZ3Xhu5NuIChSZWZhY3RvcmluZykqKjogTMOgIGPDtG5nIHTDoWMga+G7uSB0aHXhuq10IMSR4buJbmggY2FvIHRyb25nIHjGsOG7n25nIGLhuqNvIGTGsOG7oW5nIMSR4buLbmgga+G7sy4gQ8OhYyBr4bu5IHPGsCBz4bqvcCB44bq/cCBs4bqhaSBjw6FjIGLDsyBkw6J5IMSRaeG7h24gY2hvIGfhu41uIGfDoG5nLCB0aGF5IHRo4bq/IGPDoWMgdmFuIHRo4buneSBs4buxYyByxrDhu51tIHLDoCBi4bqxbmcgY8OhYyBtb2R1bGUgdGnDqnUgY2h14bqpbiwgbMOgbSBz4bqhY2ggY+G6t24gZOG6p3Ug4bufIGPDoWMg4buRbmcgZOG6q24gKGto4butIENvZGUgU21lbGxzKSBuaOG6sW0gZ2nDunAgdmnhu4djIGtp4buDbSB0cmEgbOG6p24gc2F1IG5oYW5oIGjGoW4gZ+G6pXAgNSBs4bqnbi4gVHV5IG5oacOqbiwga2hpIMSRxrBhIGzDqm4gYuG7hyB0aOG7rSB04bqjaSwgKipjw7RuZyBzdeG6pXQgbOG7sWMgxJHhuql5LCBt4bupYyB0acOqdSBoYW8gbmhpw6puIGxp4buHdSB2w6AgcGjhuqNuIGjhu5NpIGJ14buTbmcgbMOhaSBob8OgbiB0b8OgbiBraMO0bmcgxJHhu5VpIGTDuSBjaOG7iSBt4buZdCBtaWxpLWdpw6J5KiouDQoNCk1hcnRpbiBGb3dsZXIgKCpSZWZhY3RvcmluZzogSW1wcm92aW5nIHRoZSBEZXNpZ24gb2YgRXhpc3RpbmcgQ29kZSopIG5o4bqlbiBt4bqhbmg6IFJlZmFjdG9yaW5nIGzDoCBt4buZdCBjaHXhu5dpIGPDoWMgKip2aSBiaeG6v24gxJHhu5VpIChNaWNyby10cmFuc2Zvcm1hdGlvbnMpKiogY8OzIGvhu7cgbHXhuq10LCBt4buXaSBixrDhu5tjIG5o4buPIMSR4buBdSDEkcaw4bujYyBi4bqjbyB24buHIGLhu59pIGLhu5kga2nhu4NtIHRo4butIHThu7EgxJHhu5luZy4NCg0KYGBgbWVybWFpZA0KZmxvd2NoYXJ0IFREDQogICAgc3ViZ3JhcGggU2FmZUxvb3AgWyJWw7JuZyBM4bq3cCBUw6FpIEPhuqV1IFRyw7pjIEFuIFRvw6BuIChTYWZlIFJlZmFjdG9yaW5nIExvb3ApIl0NCiAgICAgICAgQVsiMS4gS2nhu4NtIFRyYSBC4buZIFRlc3QgU3VpdGUgSGnhu4duIEPDszxici8+KE11c3QgYmUgMTAwJSBHUkVFTikiXSAtLT4gQnsiVGVzdCBTdWl0ZTxici8+xJDDoyDEkOG7pyBCYW8gUGjhu6c/In0NCiAgICAgICAgQiAtLSAiQ2jGsGEgY8OzIC8gVGhp4bq/dSIgLS0+IENbIlZp4bq/dCBDaGFyYWN0ZXJpemF0aW9uIFRlc3RzPGJyLz4oR29sZGVuIE1hc3RlciBMb2NraW5nKSJdDQogICAgICAgIEMgLS0+IEENCiAgICAgICAgQiAtLSAixJDDoyBYYW5oIChHcmVlbikiIC0tPiBEWyIyLiDDgXAgROG7pW5nIERVWSBOSOG6pFQgMSBWaSBCaeG6v24gxJDhu5VpPGJyLz4oVsOtIGThu6U6IEV4dHJhY3QgTWV0aG9kIGhv4bq3YyBSZW5hbWUpIl0NCiAgICAgICAgRCAtLT4gRVsiMy4gQ2jhuqF5IEzhuqFpIELhu5kgS2nhu4NtIFRo4butIFThu7EgxJDhu5luZzxici8+KFJ1biBGYXN0IFVuaXQgVGVzdHMpIl0NCiAgICAgICAgRSAtLT4gRnsiVGVzdHMgQ8OzIFBhc3M8YnIvPihHcmVlbikgS2jDtG5nPyJ9DQogICAgICAgIEYgLS0gIkZBSUxFRCAoxJDhu48pIiAtLT4gR1siSOG7p3kgQuG7jyBOZ2F5IEzhuq1wIFThu6ljPGJyLz4oZ2l0IHJlc3RvcmUgLyByZXZlcnQpIl0NCiAgICAgICAgRyAtLT4gRA0KICAgICAgICBGIC0tICJQQVNTRUQgKFhhbmgpIiAtLT4gSFsiNC4gVOG6oW8gTWljcm8tQ29tbWl0IFbDoG8gR2l0PGJyLz4oZ2l0IGNvbW1pdCAtbSAncmVmYWN0b3I6IC4uLicpIl0NCiAgICAgICAgSCAtLT4gSXsiQ8OybiBDb2RlIFNtZWxsPGJyLz5D4bqnbiBY4butIEzDvT8ifQ0KICAgICAgICBJIC0tICJDw7JuIiAtLT4gRA0KICAgICAgICBJIC0tICJIb8OgbiBU4bqldCIgLS0+IEpbIk3DoyBOZ3Xhu5NuIFPhuqFjaCwgVGhp4bq/dCBL4bq/IExpbmggSG/huqF0Il0NCiAgICBlbmQNCmBgYA0KDQotLS0NCg0KIyMgMi4gQ2hpIHRp4bq/dCB04burbmcgS2V5d29yZCAoVW5kZXItdGhlLUhvb2QgRGVlcCBEaXZlKQ0KDQojIyMgMi4xLiBC4bqjbiBjaOG6pXQgY+G7p2EgUmVmYWN0b3JpbmcgJiBT4buxIGtow6FjIGJp4buHdCB24bubaSBSZXdyaXRpbmcvQnVnIEZpeGluZw0KLSAqKkLhuqNuIGNo4bqldCBr4bu5IHRodeG6rXQqKjoNCiAgLSAqKlJlZmFjdG9yaW5nIChUw6FpIGPhuqV1IHRyw7pjKSoqOiAkZl97aW50ZXJuYWx9KFNfe259KSBccmlnaHRhcnJvdyBTX3tuKzF9JCBzYW8gY2hvICRCZWhhdmlvcihTX3tuKzF9KSBcZXF1aXYgQmVoYXZpb3IoU197bn0pJC4gSOG7hyB0aOG7kW5nIGdp4buvIG5ndXnDqm4gdMOtbmggdMawxqFuZyDEkcawxqFuZyBuZ+G7ryBuZ2jEqWEgKFNlbWFudGljIEVxdWl2YWxlbmNlKS4gS2jDtG5nIHPhu61hIGJ1Zywga2jDtG5nIHRow6ptIHTDrW5oIG7Eg25nIG3hu5tpLCBraMO0bmcgdGhheSDEkeG7lWkgQVBJIGjhu6NwIMSR4buTbmcgY8O0bmcga2hhaS4NCiAgLSAqKlJld3JpdGluZyAoVmnhur90IGzhuqFpKSoqOiDEkOG6rXAgYuG7jyBjb2RlYmFzZSBjxakgxJHhu4Mgdmnhur90IGzhuqFpIHThu6sgxJHhuqd1LiBUaMaw4budbmcgZOG6q24gxJHhur9uICJTZWNvbmQtU3lzdGVtIEVmZmVjdCIgZG8gxJHDoW5oIGdpw6EgdGjhuqVwIMSR4buZIHBo4bupYyB04bqhcCBj4bunYSBow6BuZyBuZ2jDrG4gdHLGsOG7nW5nIGjhu6NwIGJpw6puIChFZGdlIENhc2VzKSDhuqluIHPDonUgdHJvbmcgY29kZSBjxakuDQogIC0gKipCdWcgRml4aW5nIChWw6EgbOG7l2kpKio6IFRoYXkgxJHhu5VpIGjDoG5oIHZpIHF1YW4gc8OhdCDEkcaw4bujYyB04burIHNhaSBzYW5nIMSRw7puZy4NCg0KIyMjIDIuMi4gQ29tcG9zaW5nIE1ldGhvZHM6IEV4dHJhY3QgTWV0aG9kLCBJbmxpbmUgTWV0aG9kLCBFeHRyYWN0IFZhcmlhYmxlICYgSW5saW5lIFZhcmlhYmxlDQotICoqQuG6o24gY2jhuqV0IGvhu7kgdGh14bqtdCoqOg0KICAtICoqRXh0cmFjdCBNZXRob2QgLyBGdW5jdGlvbioqOiBOaOG6rW4gZGnhu4duIG3hu5l0IGto4buRaSBs4buHbmggdGjhu7FjIHRoaSBt4buZdCBuaGnhu4dtIHbhu6UgY29uIG3huqFjaCBs4bqhYyBiw6puIHRyb25nIG3hu5l0IGjDoG0gZMOgaSwgxJHGsGEga2jhu5FpIGzhu4duaCDEkcOzIHJhIHRow6BuaCBt4buZdCBow6BtIG3hu5tpIMSR4buZYyBs4bqtcCB2w6AgxJHhurd0IHTDqm4gdGhlbyDDvSDEkeG7i25oIG5naGnhu4dwIHbhu6UgKEludGVudGlvbi1SZXZlYWxpbmcgTmFtZSkuIFRyw6xuaCBiacOqbiBk4buLY2ggaGnhu4duIMSR4bqhaSBz4bq9IHThu7EgxJHhu5luZyBpbmxpbmUgbmfGsOG7o2MgbOG6oWkgaMOgbSBuw6B5IG7hur91IGPhuqduIHThu5FpIMawdSBoaeG7h3UgbsSDbmcgQ1BVLCBkbyDEkcOzIGNoaSBwaMOtIHJ1bnRpbWUgYuG6sW5nIDAuDQogIC0gKipJbmxpbmUgTWV0aG9kKio6IEJp4bq/biDEkeG7lWkgbmfGsOG7o2MgY2hp4buBdSBj4bunYSBFeHRyYWN0IE1ldGhvZC4gS2hpIHRow6JuIGjDoG0gcXXDoSBuZ+G6r24sIHF1w6EgaGnhu4NuIG5oacOqbiAodsOtIGThu6UgY2jhu4kgZ+G7jWkgMSBow6BtIGtow6FjIGtow7RuZyBiaeG6v24gxJHhu5VpIGfDrCkgaG/hurdjIHZp4buHYyBjaGlhIG5o4buPIGjDoG0gYuG7iyBs4bqhbSBk4bulbmcgZOG6q24gxJHhur9uIGhp4buHbiB0xrDhu6NuZyBwaMOibiBt4bqjbmggbcOjIG5ndeG7k24gcXXDoSBt4bupYyAoT3Zlci1mcmFnbWVudGF0aW9uKS4NCiAgLSAqKkV4dHJhY3QgVmFyaWFibGUgKEludHJvZHVjZSBFeHBsYWluaW5nIFZhcmlhYmxlKSoqOiBUw6FjaCBjw6FjIGJp4buDdSB0aOG7qWMgxJFp4buBdSBraeG7h24gYm9vbGVhbiBwaOG7qWMgdOG6oXAgaG/hurdjIGPDoWMgcGjDqXAgdMOtbmggdG/DoW4gbOG7k25nIG5oYXUgdGjDoG5oIGPDoWMgYmnhur9uIGLhuqV0IGJp4bq/biBj4bulYyBi4buZIGPDsyB0w6puIG1hbmcgdMOtbmggZ2nhuqNpIHRow61jaC4gVsOtIGThu6U6DQogICAgYGBgY3BwDQogICAgLy8gVHLGsOG7m2M6IGlmIChwbGF0Zm9ybS5jb250YWlucygiTUFDIikgJiYgYnJvd3Nlci5jb250YWlucygiU0FGQVJJIikgJiYgcmVzaXplQ291bnQgPiAwKQ0KICAgIC8vIFNhdToNCiAgICBjb25zdCBib29sIGlzTWFjU2FmYXJpID0gcGxhdGZvcm0uY29udGFpbnMoIk1BQyIpICYmIGJyb3dzZXIuY29udGFpbnMoIlNBRkFSSSIpOw0KICAgIGNvbnN0IGJvb2wgaXNXaW5kb3dSZXNpemVkID0gcmVzaXplQ291bnQgPiAwOw0KICAgIGlmIChpc01hY1NhZmFyaSAmJiBpc1dpbmRvd1Jlc2l6ZWQpIHsgLi4uIH0NCiAgICBgYGANCiAgLSAqKklubGluZSBWYXJpYWJsZSoqOiBMb+G6oWkgYuG7jyBjw6FjIGJp4bq/biB04bqhbSB0cnVuZyBnaWFuIHbDtCBi4buVIGNo4buJIMSRxrDhu6NjIGTDuW5nIG3hu5l0IGzhuqduIGR1eSBuaOG6pXQgbmdheSBkw7JuZyB0aeG6v3AgdGhlbyBtw6Aga2jDtG5nIGLhu5Ugc3VuZyB0aMOqbSBnacOhIHRy4buLIG5n4buvIG5naMSpYSBuw6BvLg0KDQojIyMgMi4zLiBUaGUgUG93ZXIgb2YgUmVuYW1pbmcgKFN5bWJvbCBUYWJsZSAmIEFTVC1Bd2FyZSBSZW5hbWluZykNCi0gKipC4bqjbiBjaOG6pXQga+G7uSB0aHXhuq10Kio6DQogIC0gS+G7uSB0aHXhuq10IMSRxqFuIGdp4bqjbiBuaOG6pXQgbmjGsG5nIGPDsyBz4bupYyBt4bqhbmggdMOhaSB0aGnhur90IG5o4bqtbiB0aOG7qWMgY2FvIG5o4bqldC4gxJDhu5VpIHTDqm4gYmnhur9uLCBow6BtLCB0aGFtIHPhu5EsIGzhu5twIMSR4buDIHBo4bqjbiDDoW5oIGNow61uaCB4w6FjIG3DtCBow6xuaCBtaeG7gW4gKFViaXF1aXRvdXMgTGFuZ3VhZ2UgdHJvbmcgRG9tYWluLURyaXZlbiBEZXNpZ24pLg0KICAtICpDxqEgY2jhur8gdOG6p25nIHPDonUqOiBLaMO0bmcgYmFvIGdp4budIHPhu60gZOG7pW5nICJGaW5kIGFuZCBSZXBsYWNlIiB2xINuIGLhuqNuIHRow7QgaG/hurdjIFJlZ2V4LCB2w6wgbsOzIHPhur0gdGhheSB0aOG6vyBuaOG6p20gY8OhYyBjaHXhu5dpIHRyw7luZyB0w6puIHRyb25nIGNvbW1lbnQsIGZpbGUgY+G6pXUgaMOsbmggaG/hurdjIGJp4bq/biBj4bunYSBzY29wZSBraMOhYy4gQ8OhYyBjw7RuZyBj4bulIFJlZmFjdG9yaW5nIGhp4buHbiDEkeG6oWkgcGjDom4gdMOtY2ggQ8OieSBjw7ogcGjDoXAgdHLhu6t1IHTGsOG7o25nIChBU1QpIHbDoCBC4bqjbmcga8O9IGhp4buHdSAoU3ltYm9sIFRhYmxlKSBj4bunYSBDb21waWxlci9MYW5ndWFnZSBTZXJ2ZXIgxJHhu4MgY2jhu4kgdGhheSB0aOG6vyBjw6FjIE5vZGUgdGhhbSBjaGnhur91IGNow61uaCB4w6FjIMSR4bq/biBrw70gaGnhu4d1IMSRw7MuDQoNCiMjIyAyLjQuIE1vdmluZyBGZWF0dXJlczogTW92ZSBNZXRob2QgJiBNb3ZlIEZpZWxkDQotICoqQuG6o24gY2jhuqV0IGvhu7kgdGh14bqtdCoqOg0KICAtICoqTW92ZSBNZXRob2QgLyBNb3ZlIEZpZWxkKio6IEdp4bqjaSBwaMOhcCB0cuG7sWMgdGnhur9wIMSR4buDIHRyaeG7h3QgdGnDqnUgQ29kZSBTbWVsbCAqKkZlYXR1cmUgRW52eSoqLiBLaGkgQ2xhc3MgJEEkIGNo4bupYSBt4buZdCBwaMawxqFuZyB0aOG7qWMgaG/hurdjIHRodeG7mWMgdMOtbmggbmjGsG5nIENsYXNzICRCJCBs4bqhaSB0cnV5IGPhuq1wIG7DsyB24bubaSB04bqnbiBzdeG6pXQgZ+G6pXAgbmhp4buBdSBs4bqnbiBDbGFzcyAkQSQuDQogIC0gS+G7uSB0aHXhuq10IHZpw6puIHPhur0gc2FvIGNow6lwIHBoxrDGoW5nIHRo4bupYyBzYW5nIENsYXNzICRCJCwgxJFp4buBdSBjaOG7iW5oIHRoYW0gY2hp4bq/dSwgYmnhur9uIHBoxrDGoW5nIHRo4bupYyDhu58gQ2xhc3MgJEEkIHRow6BuaCBt4buZdCBow6BtIOG7p3kgcXV54buBbiAoRGVsZWdhdGluZyBNZXRob2QpIMSR4buDIGR1eSB0csOsIGto4bqjIG7Eg25nIHTGsMahbmcgdGjDrWNoIG5nxrDhu6NjLCBzYXUgxJHDsyBk4bqnbiBk4bqnbiBkZXByZWNhdGUgbsOzLg0KDQojIyMgMi41LiBPT1AgSGllcmFyY2h5IFJlZmFjdG9yaW5nOiBQdWxsIFVwIE1ldGhvZCAmIFB1c2ggRG93biBNZXRob2QNCi0gKipC4bqjbiBjaOG6pXQga+G7uSB0aHXhuq10Kio6DQogIC0gKipQdWxsIFVwIE1ldGhvZCAoxJDhuql5IHBoxrDGoW5nIHRo4bupYyBsw6puIGzhu5twIGNoYSkqKjogS2hpIHBow6F0IGhp4buHbiBoYWkgaG/hurdjIG5oaeG7gXUgbOG7m3AgY29uIGvhur8gdGjhu6thIGPDuW5nIHPhu58gaOG7r3UgY8OhYyBwaMawxqFuZyB0aOG7qWMgY8OzIGxvZ2ljIHjhu60gbMO9IGdp4buRbmcgaOG7h3QgbmhhdSBob+G6t2MgdMawxqFuZyDEkcawxqFuZy4gS+G7uSBzxrAgxJHhuql5IHBoxrDGoW5nIHRo4bupYyBuw6B5IGzDqm4gbOG7m3AgY2hhIGNodW5nIChTdXBlcmNsYXNzKSDEkeG7gyB04bqtcCB0cnVuZyBow7NhIHRyaSB0aOG7qWMsIHR1w6JuIHRo4bunIG5ndXnDqm4gbMO9IERSWS4NCiAgLSAqKlB1c2ggRG93biBNZXRob2QgKMSQ4bqpeSBwaMawxqFuZyB0aOG7qWMgeHXhu5FuZyBs4bubcCBjb24pKio6IE5nxrDhu6NjIGzhuqFpLCBraGkgbeG7mXQgcGjGsMahbmcgdGjhu6ljIG7hurFtIHRyw6puIGzhu5twIGNoYSBuaMawbmcgY2jhu4kgY8OzIG3hu5l0IGhv4bq3YyBoYWkgbOG7m3AgY29uIHPhu60gZOG7pW5nLCB0cm9uZyBraGkgY8OhYyBs4bubcCBjb24ga2jDoWMgcGjhuqNpIMSR4buDIHRy4buRbmcgaG/hurdjIG7DqW0gYE5vdFN1cHBvcnRlZEV4Y2VwdGlvbmAuIMSQ4bqpeSBwaMawxqFuZyB0aOG7qWMgxJHDsyB4deG7kW5nIGNow61uaCB4w6FjIGPDoWMgbOG7m3AgY29uIGPDsyBuaHUgY+G6p3Ugc+G7rSBk4bulbmcgbmjhurFtIGzDoG0gc+G6oWNoIGdpYW8gZGnhu4duIGzhu5twIGNoYS4NCg0KIyMjIDIuNi4gU2ltcGxpZnlpbmcgQ29uZGl0aW9uYWxzOiBEZWNvbXBvc2UgQ29uZGl0aW9uYWwNCi0gKipC4bqjbiBjaOG6pXQga+G7uSB0aHXhuq10Kio6DQogIC0gQ8OhYyBj4bqldSB0csO6YyBgaWYtdGhlbi1lbHNlYCBwaOG7qWMgdOG6oXAgdGjGsOG7nW5nIGNo4bupYSDEkeG7sW5nIDMgduG6pW4gxJHhu4E6IMSQaeG7gXUga2nhu4duIGtp4buDbSB0cmEga2jDsyBoaeG7g3UsIGto4buRaSBs4buHbmggYHRoZW5gIHF1w6EgZMOgaSwgdsOgIGto4buRaSBs4buHbmggYGVsc2VgIGNo4bupYSBuaGnhu4F1IGNoaSB0aeG6v3QgdOG6p25nIHRo4bqlcC4NCiAgLSBL4bu5IHRodeG6rXQgKipEZWNvbXBvc2UgQ29uZGl0aW9uYWwqKiB0w6FjaCB0b8OgbiBi4buZIGJp4buDdSB0aOG7qWMgxJFp4buBdSBraeG7h24gdGjDoG5oIG3hu5l0IGjDoG0gYm9vbGVhbiByacOqbmcsIHTDoWNoIGto4buRaSBgdGhlbmAgdGjDoG5oIG3hu5l0IGjDoG0gaMOgbmggxJHhu5luZyByacOqbmcsIHbDoCB0w6FjaCBraOG7kWkgYGVsc2VgIHRow6BuaCBt4buZdCBow6BtIGjDoG5oIMSR4buZbmcga2jDoWMuIEtoaSDEkeG7jWMgbOG6oWksIGjDoG0gY2jDrW5oIHPhur0gZ2nhu5FuZyBuaMawIG3hu5l0IGPDonUgdsSDbiB4dcO0aToNCiAgICBgYGBjcHANCiAgICBpZiAoaXNTdW1tZXJTZWFzb24oZGF0ZSkpIHsNCiAgICAgICAgY2hhcmdlU3VtbWVyUmF0ZShxdWFudGl0eSk7DQogICAgfSBlbHNlIHsNCiAgICAgICAgY2hhcmdlV2ludGVyUmF0ZShxdWFudGl0eSk7DQogICAgfQ0KICAgIGBgYA0KDQojIyMgMi43LiBSZXBsYWNlIENvbmRpdGlvbmFsIHdpdGggUG9seW1vcnBoaXNtIChLaOG7rSBTd2l0Y2gtQ2FzZSB2aSBwaOG6oW0gT0NQKQ0KLSAqKkLhuqNuIGNo4bqldCBr4bu5IHRodeG6rXQqKjoNCiAgLSBLaGkgbeG7mXQgxJFv4bqhbiBtw6MgeHXhuqV0IGhp4buHbiBj4bqldSB0csO6YyBgc3dpdGNoLWNhc2VgIGhv4bq3YyBjaHXhu5dpIGBpZi1lbHNlIGlmYCBkw6BpIGThurFuZyBk4bq3YyBk4buxYSB0csOqbiBjw6FjIG3DoyBraeG7g3UgbG/huqFpIChUeXBlIENvZGVzIC8gRW51bXMpLCBt4buXaSBraGkgZG9hbmggbmdoaeG7h3Agc2luaCByYSBt4buZdCBsb+G6oWkgaMOsbmggbeG7m2ksIGvhu7kgc8awIGJ14buZYyBwaOG6o2kgdMOsbSB04bqldCBj4bqjIGPDoWMgbOG7h25oIGBzd2l0Y2hgIGto4bqvcCBo4buHIHRo4buRbmcgxJHhu4MgdGjDqm0gYGNhc2VgLiDEkGnhu4F1IG7DoHkgdmkgcGjhuqFtIG5naGnDqm0gdHLhu41uZyBuZ3V5w6puIGzDvSBPcGVuL0Nsb3NlZCBQcmluY2lwbGUgKE9DUCkuDQogIC0gKkPGoSBjaOG6vyBnaeG6o2kgcXV54bq/dCo6IMSQ4buLbmggbmdoxKlhIG3hu5l0IEludGVyZmFjZS9BYnN0cmFjdCBDbGFzcyBjaOG7qWEgcGjGsMahbmcgdGjhu6ljIGjDoG5oIHZpIGNodW5nLiBN4buXaSBgY2FzZWAgdHJvbmcgYHN3aXRjaGAgxJHGsOG7o2MgYmnhur9uIHRow6BuaCBt4buZdCBs4bubcCBjb24gY+G7pSB0aOG7gyBjw6BpIMSR4bq3dCAoaW1wbGVtZW50L292ZXJyaWRlKSBwaMawxqFuZyB0aOG7qWMgxJHDsy4gTOG7nWkgZ+G7jWkgaMOgbSBwaMOibiBuaMOhbmggxJHGsOG7o2MgdGhheSB0aOG6vyBi4bqxbmcgbeG7mXQgbOG7nWkgZ+G7jWkgxJFhIGjDrG5oIMSR4buZbmcgKER5bmFtaWMgRGlzcGF0Y2ggcXVhIHZ0YWJsZSB0cm9uZyBDKysgaG/hurdjIFZpcnR1YWwgQ2FsbCB0cm9uZyBKYXZhL1B5dGhvbikuIEtoaSBj4bqnbiB0aMOqbSBsb+G6oWkgbeG7m2ksIGNo4buJIGPhuqduIHThuqFvIGzhu5twIGNvbiBt4bubaSBtw6Aga2jDtG5nIGPhuqduIHPhu61hIGLhuqV0IGvhu7MgZMOybmcgY29kZSBjxakgbsOgby4NCg0KYGBgbWVybWFpZA0KY2xhc3NEaWFncmFtDQogICAgY2xhc3MgRW1wbG95ZWVSb2xlIHsNCiAgICAgICAgPDxhYnN0cmFjdD4+DQogICAgICAgICtjYWxjdWxhdGVCb251cyhiYXNlU2FsYXJ5OiBkb3VibGUpIGRvdWJsZSoNCiAgICB9DQogICAgY2xhc3MgRW5naW5lZXJSb2xlIHsNCiAgICAgICAgK2NhbGN1bGF0ZUJvbnVzKGJhc2VTYWxhcnk6IGRvdWJsZSkgZG91YmxlDQogICAgfQ0KICAgIGNsYXNzIE1hbmFnZXJSb2xlIHsNCiAgICAgICAgK2NhbGN1bGF0ZUJvbnVzKGJhc2VTYWxhcnk6IGRvdWJsZSkgZG91YmxlDQogICAgfQ0KICAgIGNsYXNzIFNhbGVzUm9sZSB7DQogICAgICAgICtjYWxjdWxhdGVCb251cyhiYXNlU2FsYXJ5OiBkb3VibGUpIGRvdWJsZQ0KICAgIH0NCiAgICBjbGFzcyBFbXBsb3llZSB7DQogICAgICAgIC1uYW1lOiBzdHJpbmcNCiAgICAgICAgLWJhc2VTYWxhcnk6IGRvdWJsZQ0KICAgICAgICAtcm9sZTogRW1wbG95ZWVSb2xlDQogICAgICAgICtnZXRCb251cygpIGRvdWJsZQ0KICAgIH0NCg0KICAgIEVtcGxveWVlUm9sZSA8fC0tIEVuZ2luZWVyUm9sZQ0KICAgIEVtcGxveWVlUm9sZSA8fC0tIE1hbmFnZXJSb2xlDQogICAgRW1wbG95ZWVSb2xlIDx8LS0gU2FsZXNSb2xlDQogICAgRW1wbG95ZWUgKi0tPiBFbXBsb3llZVJvbGUgOiBkZWxlZ2F0ZXMgdG8NCmBgYA0KDQojIyMgMi44LiBSZWZhY3RvcmluZyB0byBQYXR0ZXJucyAoSm9zaHVhIEtlcmlldnNreSkNCi0gKipC4bqjbiBjaOG6pXQga+G7uSB0aHXhuq10Kio6DQogIC0gVGhheSB2w6wgw6FwIMSR4bq3dCBjw6FjIERlc2lnbiBQYXR0ZXJucyBwaOG7qWMgdOG6oXAgKE92ZXItZW5naW5lZXJpbmcpIG5nYXkgdOG7qyBuZ8OgeSDEkeG6p3Uga2hpIGLDoGkgdG/DoW4gY8OybiBjaMawYSByw7UgcsOgbmcsIGvhu7kgc8awIMOhcCBk4bulbmcgdMawIGR1eSAqKlJlZmFjdG9yaW5nIHRvIFBhdHRlcm5zKio6IELhuq90IMSR4bqndSBi4bqxbmcgxJFv4bqhbiBjb2RlIMSRxqFuIGdp4bqjbiBuaOG6pXQgY2jhuqF5IMSRxrDhu6NjLiBLaGkgaOG7hyB0aOG7kW5nIHRp4bq/biBow7NhIHbDoCBi4buZYyBs4buZIGPDoWMgw6FwIGzhu7FjIHRoaeG6v3Qga+G6vyAoRGVzaWduIFByZXNzdXJlcyksIHRhIHTDoWkgY+G6pXUgdHLDumMgdOG7q25nIGLGsOG7m2Mgbmjhu48gaMaw4bubbmcgdOG7m2kgY8OhYyBQYXR0ZXJuIGNodeG6qW4gbeG7sWMgKG5oxrAgU3RyYXRlZ3ksIFN0YXRlLCBDb21wb3NpdGUsIEZhY3RvcnkgTWV0aG9kKS4NCg0KIyMjIDIuOS4gU2FmZSBSZWZhY3RvcmluZyBXb3JrZmxvdywgQ2hhcmFjdGVyaXphdGlvbiBUZXN0cyAoR29sZGVuIE1hc3RlcikgJiBUZXN0IEd1YXJkcmFpbHMNCi0gKipC4bqjbiBjaOG6pXQga+G7uSB0aHXhuq10Kio6DQogIC0gKipDaGFyYWN0ZXJpemF0aW9uIFRlc3RzIChHb2xkZW4gTWFzdGVyKSoqOiBLaGkgcGjhuqNpIHTDoWkgY+G6pXUgdHLDumMgbeG7mXQgaOG7hyB0aOG7kW5nIG3DoyBuZ3Xhu5NuIGPFqSAoTGVnYWN5IENvZGUpIGhvw6BuIHRvw6BuIGtow7RuZyBjw7MgVW5pdCBUZXN0cyB2w6AgdMOgaSBsaeG7h3UgbmdoaeG7h3AgduG7pSDEkcOjIHRo4bqldCBs4bqhYy4gS+G7uSBzxrAga2jDtG5nIHRo4buDIMSRb8OhbiB0csaw4bubYyBo4buHIHRo4buRbmcgIm7Dqm4iIGNo4bqheSBuaMawIHRo4bq/IG7DoG8uDQogIC0gKkdp4bqjaSBwaMOhcCo6IFZp4bq/dCBt4buZdCBjaMawxqFuZyB0csOsbmggY+G6pXAgbuG6oXAgaMOgbmcgbmdow6xuIGLhu5kgZOG7ryBsaeG7h3UgxJHhuqd1IHbDoG8ga2jDoWMgbmhhdSB2w6BvIGjhu4cgdGjhu5FuZyBjxaksIGdoaSBs4bqhaSB0b8OgbiBi4buZIGvhur90IHF14bqjIMSR4bqndSByYSAoU25hcHNob3QgLyBHb2xkZW4gTWFzdGVyKS4gQuG7mSBr4bq/dCBxdeG6oyBuw6B5IHRy4bufIHRow6BuaCAiYuG6o24gdHV5w6puIG5nw7RuIGjDoG5oIHZpIiBoaeG7h24gdOG6oWkuIFNhdSBraGkgdMOhaSBj4bqldSB0csO6YywgYuG7mSB0ZXN0IEdvbGRlbiBNYXN0ZXIgbsOgeSBz4bq9IGtp4buDbSB0cmEgeGVtIMSR4bqndSByYSBjw7Mga2jhu5twIDEwMCUgdOG7q25nIGJpdCB24bubaSBr4bq/dCBxdeG6oyBjxakgaGF5IGtow7RuZy4NCiAgLSAqKk1pY3JvLWNvbW1pdHMqKjogTeG7l2kgYsaw4bubYyB0w6FpIGPhuqV1IHRyw7pjIGNo4buJIHRo4buxYyBoaeG7h24gdOG7qyAxIMSR4bq/biA1IHBow7p0IHbDoCBjb21taXQgbmdheSB2w6BvIEdpdC4gTuG6v3UgbMOgbSB24buhIGNvZGUsIGNo4buJIGPhuqduIDEgcGjDrW0gdOG6r3QgxJHhu4MgaG/DoG4gdMOhYyBtw6Aga2jDtG5nIHThu5FuIGPDtG5nIGfhu6EgbOG7l2kuDQoNCi0tLQ0KDQojIyAzLiBUaOG7sWMgdGhpIE3DoyBuZ3Xhu5NuICYgTcO0IHBo4buPbmcgQ2h1ecOqbiBzw6J1IChEdWFsLUVuZ2luZSBJbXBsZW1lbnRhdGlvbikNCg0KIyMjIDMuMS4gRW5naW5lIEMrKzIwOiBSZXBsYWNlIENvbmRpdGlvbmFsIHdpdGggUG9seW1vcnBoaWMgSGllcmFyY2h5DQpNaW5oIGjhu41hIHZp4buHYyB0cmnhu4d0IHRpw6p1IGBzd2l0Y2gtY2FzZWAgdmkgcGjhuqFtIE9DUCBi4bqxbmcgY+G6pXUgdHLDumMgxJBhIGjDrG5oIGhp4buHbiDEkeG6oWkgduG7m2kgYHN0ZDo6dW5pcXVlX3B0cmAsIGBjb25zdGV4cHJgLCB2w6AgY8ahIGNo4bq/IGtp4buDbSB0aOG7rSB0w61jaCBo4bujcC4NCg0KYGBgY3BwDQojaW5jbHVkZSA8aW9zdHJlYW0+DQojaW5jbHVkZSA8bWVtb3J5Pg0KI2luY2x1ZGUgPHN0cmluZz4NCiNpbmNsdWRlIDxzdHJpbmdfdmlldz4NCiNpbmNsdWRlIDx2ZWN0b3I+DQojaW5jbHVkZSA8Y2Fzc2VydD4NCg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLy8gR0lBSSDEkE/huqBOIDE6IE3DgyBOR1Xhu5JOIEPFqCAoQ0jGr0EgUkVGQUNUT1IgLSBDT0RFIFNNRUxMIFNXSVRDSC1DQVNFKQ0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KZW51bSBjbGFzcyBMZWdhY3lFbXBsb3llZVR5cGUgew0KICAgIEVOR0lORUVSLA0KICAgIFNBTEVTLA0KICAgIE1BTkFHRVINCn07DQoNCi8vIFZpIHBo4bqhbSBPcGVuL0Nsb3NlZCBQcmluY2lwbGU6IE3hu5dpIGtoaSB0aMOqbSBsb+G6oWkgbmjDom4gdmnDqm4gbeG7m2ksIHBo4bqjaSBz4butYSBow6BtIG7DoHkhDQpbW25vZGlzY2FyZF1dIGRvdWJsZSBsZWdhY3lDYWxjdWxhdGVCb251cyhMZWdhY3lFbXBsb3llZVR5cGUgdHlwZSwgZG91YmxlIGJhc2VTYWxhcnkpIG5vZXhjZXB0IHsNCiAgICBzd2l0Y2ggKHR5cGUpIHsNCiAgICAgICAgY2FzZSBMZWdhY3lFbXBsb3llZVR5cGU6OkVOR0lORUVSOiByZXR1cm4gYmFzZVNhbGFyeSAqIDAuMTU7DQogICAgICAgIGNhc2UgTGVnYWN5RW1wbG95ZWVUeXBlOjpTQUxFUzogICAgcmV0dXJuIGJhc2VTYWxhcnkgKiAwLjIwOw0KICAgICAgICBjYXNlIExlZ2FjeUVtcGxveWVlVHlwZTo6TUFOQUdFUjogIHJldHVybiBiYXNlU2FsYXJ5ICogMC4yNTsNCiAgICAgICAgZGVmYXVsdDogcmV0dXJuIDAuMDsNCiAgICB9DQp9DQoNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCi8vIEdJQUkgxJBP4bqgTiAyOiBNw4MgTkdV4buSTiDEkMODIFJFRkFDVE9SIELhurBORyDEkEEgSMOMTkggKFJFUExBQ0UgQ09ORElUSU9OQUwgV0lUSCBQT0xZTU9SUEhJU00pDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQoNCi8vIEludGVyZmFjZSBjaGnhur9uIGzGsOG7o2MgdHLhu6t1IHTGsOG7o25nIGNobyB2YWkgdHLDsiBuaMOibiB2acOqbg0KY2xhc3MgRW1wbG95ZWVSb2xlIHsNCnB1YmxpYzoNCiAgICB2aXJ0dWFsIH5FbXBsb3llZVJvbGUoKSA9IGRlZmF1bHQ7DQogICAgW1tub2Rpc2NhcmRdXSB2aXJ0dWFsIGRvdWJsZSBjYWxjdWxhdGVCb251cyhkb3VibGUgYmFzZVNhbGFyeSkgY29uc3Qgbm9leGNlcHQgPSAwOw0KICAgIFtbbm9kaXNjYXJkXV0gdmlydHVhbCBzdGQ6OnN0cmluZ192aWV3IGdldFJvbGVUaXRsZSgpIGNvbnN0IG5vZXhjZXB0ID0gMDsNCn07DQoNCmNsYXNzIEVuZ2luZWVyUm9sZSBmaW5hbCA6IHB1YmxpYyBFbXBsb3llZVJvbGUgew0KcHVibGljOg0KICAgIFtbbm9kaXNjYXJkXV0gZG91YmxlIGNhbGN1bGF0ZUJvbnVzKGRvdWJsZSBiYXNlU2FsYXJ5KSBjb25zdCBub2V4Y2VwdCBvdmVycmlkZSB7DQogICAgICAgIHJldHVybiBiYXNlU2FsYXJ5ICogMC4xNTsgLy8gMTUlIHRoxrDhu59uZyBr4bu5IHPGsA0KICAgIH0NCiAgICBbW25vZGlzY2FyZF1dIHN0ZDo6c3RyaW5nX3ZpZXcgZ2V0Um9sZVRpdGxlKCkgY29uc3Qgbm9leGNlcHQgb3ZlcnJpZGUgew0KICAgICAgICByZXR1cm4gIlNvZnR3YXJlIEVuZ2luZWVyIjsNCiAgICB9DQp9Ow0KDQpjbGFzcyBTYWxlc1JvbGUgZmluYWwgOiBwdWJsaWMgRW1wbG95ZWVSb2xlIHsNCnByaXZhdGU6DQogICAgZG91YmxlIGNvbW1pc3Npb25SYXRlX3swLjIwfTsNCnB1YmxpYzoNCiAgICBleHBsaWNpdCBTYWxlc1JvbGUoZG91YmxlIGNvbW1pc3Npb24gPSAwLjIwKSBub2V4Y2VwdCA6IGNvbW1pc3Npb25SYXRlXyhjb21taXNzaW9uKSB7fQ0KDQogICAgW1tub2Rpc2NhcmRdXSBkb3VibGUgY2FsY3VsYXRlQm9udXMoZG91YmxlIGJhc2VTYWxhcnkpIGNvbnN0IG5vZXhjZXB0IG92ZXJyaWRlIHsNCiAgICAgICAgcmV0dXJuIGJhc2VTYWxhcnkgKiBjb21taXNzaW9uUmF0ZV87DQogICAgfQ0KICAgIFtbbm9kaXNjYXJkXV0gc3RkOjpzdHJpbmdfdmlldyBnZXRSb2xlVGl0bGUoKSBjb25zdCBub2V4Y2VwdCBvdmVycmlkZSB7DQogICAgICAgIHJldHVybiAiU2FsZXMgU3BlY2lhbGlzdCI7DQogICAgfQ0KfTsNCg0KY2xhc3MgTWFuYWdlclJvbGUgZmluYWwgOiBwdWJsaWMgRW1wbG95ZWVSb2xlIHsNCnB1YmxpYzoNCiAgICBbW25vZGlzY2FyZF1dIGRvdWJsZSBjYWxjdWxhdGVCb251cyhkb3VibGUgYmFzZVNhbGFyeSkgY29uc3Qgbm9leGNlcHQgb3ZlcnJpZGUgew0KICAgICAgICByZXR1cm4gYmFzZVNhbGFyeSAqIDAuMjU7IC8vIDI1JSB0aMaw4bufbmcgcXXhuqNuIGzDvQ0KICAgIH0NCiAgICBbW25vZGlzY2FyZF1dIHN0ZDo6c3RyaW5nX3ZpZXcgZ2V0Um9sZVRpdGxlKCkgY29uc3Qgbm9leGNlcHQgb3ZlcnJpZGUgew0KICAgICAgICByZXR1cm4gIkVuZ2luZWVyaW5nIE1hbmFnZXIiOw0KICAgIH0NCn07DQoNCi8vIENvbnRleHQgQ2xhc3M6IOG7pnkgcXV54buBbiB0w61uaCB0b8OhbiB0aMaw4bufbmcgY2hvIEludGVyZmFjZSDEkWEgaMOsbmgNCmNsYXNzIEVtcGxveWVlIHsNCnByaXZhdGU6DQogICAgc3RkOjpzdHJpbmcgbmFtZV87DQogICAgZG91YmxlIGJhc2VTYWxhcnlfOw0KICAgIHN0ZDo6dW5pcXVlX3B0cjxFbXBsb3llZVJvbGU+IHJvbGVfOw0KDQpwdWJsaWM6DQogICAgRW1wbG95ZWUoc3RkOjpzdHJpbmcgbmFtZSwgZG91YmxlIGJhc2VTYWxhcnksIHN0ZDo6dW5pcXVlX3B0cjxFbXBsb3llZVJvbGU+IHJvbGUpDQogICAgICAgIDogbmFtZV8oc3RkOjptb3ZlKG5hbWUpKSwgYmFzZVNhbGFyeV8oYmFzZVNhbGFyeSksIHJvbGVfKHN0ZDo6bW92ZShyb2xlKSkgew0KICAgICAgICBhc3NlcnQocm9sZV8gIT0gbnVsbHB0ciAmJiAiRW1wbG95ZWVSb2xlIG11c3Qgbm90IGJlIG51bGwiKTsNCiAgICB9DQoNCiAgICAvLyBDaG8gcGjDqXAgdGhheSDEkeG7lWkgdmFpIHRyw7IgxJHhu5luZyDhu58gUnVudGltZSBtw6Aga2jDtG5nIGPhuqduIHThuqFvIG9iamVjdCBt4bubaSAoU3RhdGUvU3RyYXRlZ3kgUGF0dGVybikNCiAgICB2b2lkIGNoYW5nZVJvbGUoc3RkOjp1bmlxdWVfcHRyPEVtcGxveWVlUm9sZT4gbmV3Um9sZSkgbm9leGNlcHQgew0KICAgICAgICBhc3NlcnQobmV3Um9sZSAhPSBudWxscHRyKTsNCiAgICAgICAgcm9sZV8gPSBzdGQ6Om1vdmUobmV3Um9sZSk7DQogICAgfQ0KDQogICAgW1tub2Rpc2NhcmRdXSBkb3VibGUgZ2V0Qm9udXMoKSBjb25zdCBub2V4Y2VwdCB7DQogICAgICAgIHJldHVybiByb2xlXy0+Y2FsY3VsYXRlQm9udXMoYmFzZVNhbGFyeV8pOw0KICAgIH0NCg0KICAgIFtbbm9kaXNjYXJkXV0gc3RkOjpzdHJpbmdfdmlldyBnZXRSb2xlVGl0bGUoKSBjb25zdCBub2V4Y2VwdCB7DQogICAgICAgIHJldHVybiByb2xlXy0+Z2V0Um9sZVRpdGxlKCk7DQogICAgfQ0KDQogICAgW1tub2Rpc2NhcmRdXSBjb25zdCBzdGQ6OnN0cmluZyYgZ2V0TmFtZSgpIGNvbnN0IG5vZXhjZXB0IHsNCiAgICAgICAgcmV0dXJuIG5hbWVfOw0KICAgIH0NCn07DQoNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCi8vIE1BSU4gVEVTVCBEUklWRVI6IFjDgUMgVEjhu7BDIFTDjU5IIFTGr8agTkcgxJDGr8agTkcgTkfhu64gTkdIxKhBIChCRUhBVklPUiBQUkVTRVJWQVRJT04pDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQppbnQgbWFpbigpIHsNCiAgICBzdGQ6OmNvdXQgPDwgIj09PSBDKysyMCBSRUZBQ1RPUklORyBUTyBQT0xZTU9SUEhJU00gQkVOQ0hNQVJLID09PVxuXG4iOw0KDQogICAgY29uc3RleHByIGRvdWJsZSBrQmFzZVNhbGFyeSA9IDEwMCcwMDAuMDsNCg0KICAgIC8vIDEuIEtp4buDbSB0cmEgdMOtbmggdMawxqFuZyDEkcawxqFuZyBuZ+G7ryBuZ2jEqWEgZ2nhu69hIGjDoG0gY8WpIHbDoCDEkeG7kWkgdMaw4bujbmcgxJFhIGjDrG5oIG3hu5tpDQogICAgZG91YmxlIG9sZEVuZ0JvbnVzID0gbGVnYWN5Q2FsY3VsYXRlQm9udXMoTGVnYWN5RW1wbG95ZWVUeXBlOjpFTkdJTkVFUiwga0Jhc2VTYWxhcnkpOw0KICAgIEVtcGxveWVlIGVuZ2luZWVyKCJBbGljZSIsIGtCYXNlU2FsYXJ5LCBzdGQ6Om1ha2VfdW5pcXVlPEVuZ2luZWVyUm9sZT4oKSk7DQogICAgZG91YmxlIG5ld0VuZ0JvbnVzID0gZW5naW5lZXIuZ2V0Qm9udXMoKTsNCg0KICAgIHN0ZDo6Y291dCA8PCAiW1Rlc3QgMTogVmVyaWZpY2F0aW9uXSBPbGQgQm9udXM6ICQiIDw8IG9sZEVuZ0JvbnVzIA0KICAgICAgICAgICAgICA8PCAiIHwgUmVmYWN0b3JlZCBCb251czogJCIgPDwgbmV3RW5nQm9udXMgPDwgIlxuIjsNCiAgICBhc3NlcnQob2xkRW5nQm9udXMgPT0gbmV3RW5nQm9udXMgJiYgIlJlZmFjdG9yaW5nIGJyb2tlbjogQmVoYXZpb3IgY2hhbmdlZCEiKTsNCiAgICBzdGQ6OmNvdXQgPDwgIi0+IFZlcmlmaWNhdGlvbiBQYXNzZWQ6IEJlaGF2aW9yIGlzIDEwMCUgSWRlbnRpY2FsLlxuXG4iOw0KDQogICAgLy8gMi4gTWluaCBo4buNYSBraOG6oyBuxINuZyBt4bufIHLhu5luZyB0dcOibiB0aOG7pyBPcGVuL0Nsb3NlZCBQcmluY2lwbGUNCiAgICBzdGQ6OmNvdXQgPDwgIltUZXN0IDI6IER5bmFtaWMgUm9sZSBQcm9tb3Rpb25dXG4iOw0KICAgIHN0ZDo6Y291dCA8PCAiRW1wbG95ZWUgIiA8PCBlbmdpbmVlci5nZXROYW1lKCkgPDwgIiBpcyBjdXJyZW50bHkgYSAiIA0KICAgICAgICAgICAgICA8PCBlbmdpbmVlci5nZXRSb2xlVGl0bGUoKSA8PCAiIHdpdGggQm9udXM6ICQiIDw8IGVuZ2luZWVyLmdldEJvbnVzKCkgPDwgIlxuIjsNCg0KICAgIHN0ZDo6Y291dCA8PCAiUHJvbW90aW5nICIgPDwgZW5naW5lZXIuZ2V0TmFtZSgpIDw8ICIgdG8gTWFuYWdlci4uLlxuIjsNCiAgICBlbmdpbmVlci5jaGFuZ2VSb2xlKHN0ZDo6bWFrZV91bmlxdWU8TWFuYWdlclJvbGU+KCkpOw0KICAgIHN0ZDo6Y291dCA8PCAiRW1wbG95ZWUgIiA8PCBlbmdpbmVlci5nZXROYW1lKCkgPDwgIiBpcyBub3cgYW4gIiANCiAgICAgICAgICAgICAgPDwgZW5naW5lZXIuZ2V0Um9sZVRpdGxlKCkgPDwgIiB3aXRoIEJvbnVzOiAkIiA8PCBlbmdpbmVlci5nZXRCb251cygpIDw8ICJcbiI7DQoNCiAgICByZXR1cm4gMDsNCn0NCmBgYA0KDQotLS0NCg0KIyMjIDMuMi4gRW5naW5lIFB5dGhvbiAzLjExKzogQ2hhcmFjdGVyaXphdGlvbiBUZXN0IEhhcm5lc3MgKEdvbGRlbiBNYXN0ZXIpDQpNw7QgcGjhu49uZyBxdXkgdHLDrG5oIHThuqFvIEdvbGRlbiBNYXN0ZXIgc25hcHNob3QgxJHhu4MgdMOhaSBj4bqldSB0csO6YyBhbiB0b8OgbiBtw6Mgbmd14buTbiBsZWdhY3kgY2jGsGEgaOG7gSBjw7MgdMOgaSBsaeG7h3UuDQoNCmBgYHB5dGhvbg0KIiIiDQpQeXRob24gMy4xMSsgQ2hhcmFjdGVyaXphdGlvbiBUZXN0IChHb2xkZW4gTWFzdGVyKSBIYXJuZXNzDQpNw7QgcGjhu49uZyB2aeG7h2Mga2jDs2EgY2jhurd0IGjDoG5oIHZpIGxlZ2FjeSB0csaw4bubYyBraGkgdGnhur9uIGjDoG5oIHTDoWkgY+G6pXUgdHLDumMgYW4gdG/DoG4uDQoiIiINCmZyb20gdHlwaW5nIGltcG9ydCBOYW1lZFR1cGxlLCBQcm90b2NvbA0KaW1wb3J0IGhhc2hsaWINCmltcG9ydCBqc29uDQoNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KIyAxLiBMRUdBQ1kgU1lTVEVNIChNw4MgTkdV4buSTiBDxaggUuG7kEkgUuG6rk0sIENIxq9BIFLDlSBRVVkgVOG6rkMgTkdISeG7hlAgVuG7pCkNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KZGVmIGxlZ2FjeV90YXhfY2FsY3VsYXRvcihncm9zc19pbmNvbWU6IGZsb2F0LCBkZXBlbmRlbnRzOiBpbnQsIGlzX3Jlc2lkZW50OiBib29sKSAtPiBmbG9hdDoNCiAgICAiIiJNw6Mgbmd14buTbiBjxakgY2jhu6lhIMSR4buxbmcgaMOgbmcgbG/huqF0IGxvZ2ljIGzhu5NuZyBuaGF1IHbDoCBtYWdpYyBudW1iZXJzLiIiIg0KICAgIGlmIG5vdCBpc19yZXNpZGVudDoNCiAgICAgICAgcmV0dXJuIHJvdW5kKGdyb3NzX2luY29tZSAqIDAuMjUsIDIpDQogICAgDQogICAgdGF4YWJsZSA9IGdyb3NzX2luY29tZSAtIChkZXBlbmRlbnRzICogNDQwMC4wKQ0KICAgIGlmIHRheGFibGUgPD0gMDoNCiAgICAgICAgcmV0dXJuIDAuMA0KICAgIA0KICAgIGlmIHRheGFibGUgPD0gNTBfMDAwLjA6DQogICAgICAgIHJlcyA9IHRheGFibGUgKiAwLjEwDQogICAgZWxpZiB0YXhhYmxlIDw9IDEwMF8wMDAuMDoNCiAgICAgICAgcmVzID0gNTAwMC4wICsgKHRheGFibGUgLSA1MF8wMDAuMCkgKiAwLjIwDQogICAgZWxzZToNCiAgICAgICAgcmVzID0gMTUwMDAuMCArICh0YXhhYmxlIC0gMTAwXzAwMC4wKSAqIDAuMzANCiAgICAgICAgDQogICAgcmV0dXJuIHJvdW5kKHJlcywgMikNCg0KIyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQojIDIuIFJFRkFDVE9SRUQgU1lTVEVNIChNw4MgTkdV4buSTiDEkMODIFFVQSBFWFRSQUNUIE1FVEhPRCAmIEdVQVJEIENMQVVTRVMpDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCmNsYXNzIFRheEJyYWNrZXQoTmFtZWRUdXBsZSk6DQogICAgbG93ZXJfYm91bmQ6IGZsb2F0DQogICAgdXBwZXJfYm91bmQ6IGZsb2F0DQogICAgYmFzZV90YXg6IGZsb2F0DQogICAgcmF0ZTogZmxvYXQNCg0KY2xhc3MgTW9kZXJuVGF4Q2FsY3VsYXRvcjoNCiAgICBOT05fUkVTSURFTlRfRkxBVF9SQVRFOiBmbG9hdCA9IDAuMjUNCiAgICBERVBFTkRFTlRfREVEVUNUSU9OX0FNT1VOVDogZmxvYXQgPSA0NDAwLjANCg0KICAgIEJSQUNLRVRTOiB0dXBsZVtUYXhCcmFja2V0LCAuLi5dID0gKA0KICAgICAgICBUYXhCcmFja2V0KDAuMCwgNTBfMDAwLjAsIDAuMCwgMC4xMCksDQogICAgICAgIFRheEJyYWNrZXQoNTBfMDAwLjAsIDEwMF8wMDAuMCwgNTAwMC4wLCAwLjIwKSwNCiAgICAgICAgVGF4QnJhY2tldCgxMDBfMDAwLjAsIGZsb2F0KCJpbmYiKSwgMTUwMDAuMCwgMC4zMCksDQogICAgKQ0KDQogICAgQGNsYXNzbWV0aG9kDQogICAgZGVmIGNhbGN1bGF0ZV90YXgoY2xzLCBncm9zc19pbmNvbWU6IGZsb2F0LCBkZXBlbmRlbnRzOiBpbnQsIGlzX3Jlc2lkZW50OiBib29sKSAtPiBmbG9hdDoNCiAgICAgICAgIyBHdWFyZCBjbGF1c2U6IE5nxrDhu51pIGtow7RuZyBjxrAgdHLDuiDDoXAgZOG7pW5nIHRodeG6vyBzdeG6pXQgY+G7kSDEkeG7i25oDQogICAgICAgIGlmIG5vdCBpc19yZXNpZGVudDoNCiAgICAgICAgICAgIHJldHVybiByb3VuZChncm9zc19pbmNvbWUgKiBjbHMuTk9OX1JFU0lERU5UX0ZMQVRfUkFURSwgMikNCg0KICAgICAgICB0YXhhYmxlX2luY29tZSA9IGdyb3NzX2luY29tZSAtIChkZXBlbmRlbnRzICogY2xzLkRFUEVOREVOVF9ERURVQ1RJT05fQU1PVU5UKQ0KICAgICAgICBpZiB0YXhhYmxlX2luY29tZSA8PSAwOg0KICAgICAgICAgICAgcmV0dXJuIDAuMA0KDQogICAgICAgIGZvciBicmFja2V0IGluIGNscy5CUkFDS0VUUzoNCiAgICAgICAgICAgIGlmIHRheGFibGVfaW5jb21lIDw9IGJyYWNrZXQudXBwZXJfYm91bmQ6DQogICAgICAgICAgICAgICAgbWFyZ2luYWwgPSB0YXhhYmxlX2luY29tZSAtIGJyYWNrZXQubG93ZXJfYm91bmQNCiAgICAgICAgICAgICAgICB0b3RhbF90YXggPSBicmFja2V0LmJhc2VfdGF4ICsgKG1hcmdpbmFsICogYnJhY2tldC5yYXRlKQ0KICAgICAgICAgICAgICAgIHJldHVybiByb3VuZCh0b3RhbF90YXgsIDIpDQoNCiAgICAgICAgcmV0dXJuIDAuMA0KDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCiMgMy4gR09MREVOIE1BU1RFUiBURVNUIEhBUk5FU1MgKELhuqJPIMSQ4bqiTSBLSMOUTkcgTMOATSBW4bugIEjDgE5IIFZJIEPFqCkNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KZGVmIGdlbmVyYXRlX3Rlc3RfaW5wdXRzKCkgLT4gbGlzdFt0dXBsZVtmbG9hdCwgaW50LCBib29sXV06DQogICAgIiIiVOG6oW8ga2jDtG5nIGdpYW4gbeG6q3UgZOG7ryBsaeG7h3UgxJFhIGNoaeG7gXUgYmFvIHBo4bunIGPDoWMgdHLGsOG7nW5nIGjhu6NwIGJpw6puLiIiIg0KICAgIGluY29tZXMgPSBbMC4wLCAyMF8wMDAuMCwgNTBfMDAwLjAsIDc1XzAwMC4wLCAxMDBfMDAwLjAsIDI1MF8wMDAuMF0NCiAgICBkZXBlbmRlbnRzID0gWzAsIDEsIDIsIDVdDQogICAgcmVzaWRlbmNpZXMgPSBbVHJ1ZSwgRmFsc2VdDQogICAgcmV0dXJuIFsoaW5jLCBkZXAsIHJlcykgZm9yIGluYyBpbiBpbmNvbWVzIGZvciBkZXAgaW4gZGVwZW5kZW50cyBmb3IgcmVzIGluIHJlc2lkZW5jaWVzXQ0KDQpkZWYgcnVuX2dvbGRlbl9tYXN0ZXJfdmVyaWZpY2F0aW9uKCkgLT4gTm9uZToNCiAgICBwcmludCgiPT09IFJVTk5JTkcgR09MREVOIE1BU1RFUiBSRUZBQ1RPUklORyBWRVJJRklDQVRJT04gPT09IikNCiAgICB0ZXN0X2Nhc2VzID0gZ2VuZXJhdGVfdGVzdF9pbnB1dHMoKQ0KICAgIHByaW50KGYiRXhlY3V0aW5nIHtsZW4odGVzdF9jYXNlcyl9IGF1dG9tYXRlZCB0ZXN0IHZlY3RvcnMuLi4iKQ0KDQogICAgbWlzbWF0Y2hlcyA9IDANCiAgICBmb3IgZ3Jvc3MsIGRlcCwgcmVzIGluIHRlc3RfY2FzZXM6DQogICAgICAgIGV4cGVjdGVkID0gbGVnYWN5X3RheF9jYWxjdWxhdG9yKGdyb3NzLCBkZXAsIHJlcykNCiAgICAgICAgYWN0dWFsID0gTW9kZXJuVGF4Q2FsY3VsYXRvci5jYWxjdWxhdGVfdGF4KGdyb3NzLCBkZXAsIHJlcykNCg0KICAgICAgICBpZiBleHBlY3RlZCAhPSBhY3R1YWw6DQogICAgICAgICAgICBwcmludChmIltSRUdSRVNTSU9OIERFVEVDVEVEXSBJbnB1dDogKHtncm9zc30sIHtkZXB9LCB7cmVzfSkgfCBFeHBlY3RlZDoge2V4cGVjdGVkfSB8IEFjdHVhbDoge2FjdHVhbH0iKQ0KICAgICAgICAgICAgbWlzbWF0Y2hlcyArPSAxDQoNCiAgICBpZiBtaXNtYXRjaGVzID09IDA6DQogICAgICAgIHByaW50KGYiW1NVQ0NFU1NdIDEwMCUgb2Yge2xlbih0ZXN0X2Nhc2VzKX0gdGVzdCB2ZWN0b3JzIG1hdGNoZWQgYml0LWZvci1iaXQuIikNCiAgICAgICAgcHJpbnQoIlJlZmFjdG9yaW5nIHNhZmV0eSBjb25maXJtZWQ6IFplcm8gYmVoYXZpb3JhbCBhbHRlcmF0aW9ucy4iKQ0KICAgIGVsc2U6DQogICAgICAgIHByaW50KGYiW0ZBSUxVUkVdIHttaXNtYXRjaGVzfSByZWdyZXNzaW9ucyBkaXNjb3ZlcmVkLiBSb2xsYmFjayBpbW1lZGlhdGVseSEiKQ0KDQppZiBfX25hbWVfXyA9PSAiX19tYWluX18iOg0KICAgIHJ1bl9nb2xkZW5fbWFzdGVyX3ZlcmlmaWNhdGlvbigpDQpgYGANCg0KIyMjIDMuMy4gR2nhuqMgbOG6rXAgVGVybWluYWwgT3V0cHV0DQpgYGB0ZXh0DQo9PT0gQysrMjAgUkVGQUNUT1JJTkcgVE8gUE9MWU1PUlBISVNNIEJFTkNITUFSSyA9PT0NCg0KW1Rlc3QgMTogVmVyaWZpY2F0aW9uXSBPbGQgQm9udXM6ICQxNTAwMCB8IFJlZmFjdG9yZWQgQm9udXM6ICQxNTAwMA0KLT4gVmVyaWZpY2F0aW9uIFBhc3NlZDogQmVoYXZpb3IgaXMgMTAwJSBJZGVudGljYWwuDQoNCltUZXN0IDI6IER5bmFtaWMgUm9sZSBQcm9tb3Rpb25dDQpFbXBsb3llZSBBbGljZSBpcyBjdXJyZW50bHkgYSBTb2Z0d2FyZSBFbmdpbmVlciB3aXRoIEJvbnVzOiAkMTUwMDANClByb21vdGluZyBBbGljZSB0byBNYW5hZ2VyLi4uDQpFbXBsb3llZSBBbGljZSBpcyBub3cgYW4gRW5naW5lZXJpbmcgTWFuYWdlciB3aXRoIEJvbnVzOiAkMjUwMDANCg0KPT09IFJVTk5JTkcgR09MREVOIE1BU1RFUiBSRUZBQ1RPUklORyBWRVJJRklDQVRJT04gPT09DQpFeGVjdXRpbmcgNDggYXV0b21hdGVkIHRlc3QgdmVjdG9ycy4uLg0KW1NVQ0NFU1NdIDEwMCUgb2YgNDggdGVzdCB2ZWN0b3JzIG1hdGNoZWQgYml0LWZvci1iaXQuDQpSZWZhY3RvcmluZyBzYWZldHkgY29uZmlybWVkOiBaZXJvIGJlaGF2aW9yYWwgYWx0ZXJhdGlvbnMuDQpgYGANCg0KLS0tDQoNCiMjIDQuIFN5c3RlbXMgRW5naW5lZXJpbmcgJiBQcm9kdWN0aW9uIFBpdGZhbGxzDQoNCiMjIyA0LjEuIFByb2R1Y3Rpb24gRmFpbHVyZSBNb2Rlcw0KMS4gKipUaGUgIkJpZyBCYW5nIiBSZWZhY3RvcmluZyBNZXJnZSBEaXNhc3RlcioqOg0KICAgLSAqS+G7i2NoIGLhuqNuKjogTeG7mXQgbOG6rXAgdHLDrG5oIHZpw6puIHThuqFvIG5ow6FuaCByacOqbmcgYHJlZmFjdG9yLWVudGlyZS1jb3JlYCB2w6AgbMOgbSB2aeG7h2MgbGnDqm4gdOG7pWMgdHJvbmcgMyB0deG6p24gbcOgIGtow7RuZyBtZXJnZSBjb2RlIHbDoG8gbmjDoW5oIGNow61uaC4gVHJvbmcgdGjhu51pIGdpYW4gbsOgeSwgY8OhYyDEkeG7k25nIG5naGnhu4dwIMSRw6MgxJHhuql5IHRow6ptIDUwIHTDrW5oIG7Eg25nIG3hu5tpLiBLaGkgbWVyZ2UsIHjhuqN5IHJhIGjDoG5nIHRyxINtIEdpdCBDb25mbGljdHMgc2VtYW50aWMgcGjhu6ljIHThuqFwIGtow7RuZyB0aOG7gyBnaeG6o2kgcXV54bq/dCBu4buVaSwgYnXhu5ljIHRvw6BuIGLhu5kgY8O0bmcgc+G7qWMgcmVmYWN0b3IgcGjhuqNpIHbhu6l0IGLhu48uDQogICAtICpCaeG7h24gcGjDoXAqOiBSZWZhY3RvciB0aGVvIHThu6tuZyB2aSBixrDhu5tjIG5o4buPIChNaWNyby1jb21taXRzKSwgbeG7l2kgUFIgY2jhu4kgZ2nhuqNpIHF1eeG6v3QgMSBob+G6t2MgMiBmaWxlIHbDoCBtZXJnZSB2w6BvIE1haW4gbmdheSB0cm9uZyBuZ8OgeS4NCjIuICoqUmVmYWN0b3JpbmcgV2l0aG91dCBDaGFyYWN0ZXJpemF0aW9uIFRlc3RzIChUaGUgQmxpbmQgV2FsaykqKjoNCiAgIC0gKkvhu4tjaCBi4bqjbio6IEvhu7kgc8awIHThu7EgdGluIGThu41uIGThurlwIG3hu5l0IGjDoG0gMTAwMCBkw7JuZyB0cm9uZyBo4buHIHRo4buRbmcgdMOtbmggdGnhu4FuIGdp4buPIGjDoG5nIHbDrCB0aOG6pXkgY29kZSBxdcOhIHLhu5FpLiBWw7QgdMOsbmgsIG3hu5l0IMSRaeG7gXUga2nhu4duIGtp4buDbSB0cmEgYmnDqm4gKEVkZ2UgQ2FzZSkgeOG7rSBsw70gbcOjIGdp4bqjbSBnacOhIGNobyBraMOhY2ggaMOgbmcgVklQIGLhu4sgeMOzYSBuaOG6p20uIEtoaSBsw6puIHByb2R1Y3Rpb24sIHRvw6BuIGLhu5kga2jDoWNoIFZJUCBi4buLIHTDrW5oIGdpw6EgZ+G7kWMsIGfDonkga2jhu6duZyBob+G6o25nIHRydXnhu4FuIHRow7RuZy4NCjMuICoqQ2xhc3MgRXhwbG9zaW9uIGRvIEzhuqFtIEThu6VuZyBQYXR0ZXJuKio6DQogICAtICpL4buLY2ggYuG6o24qOiDDgXAgZOG7pW5nIFJlcGxhY2UgQ29uZGl0aW9uYWwgd2l0aCBQb2x5bW9ycGhpc20gY2hvIG3hu5l0IGPhuqV1IHRyw7pjIGBzd2l0Y2hgIGNo4buJIGPDsyAyIG5ow6FuaCB2w6AgdsSpbmggdmnhu4VuIGtow7RuZyBiYW8gZ2nhu50gbeG7nyBy4buZbmcgdGjDqm0gbmjDoW5oIHRo4bupIDMuIEvhur90IHF14bqjIGzDoCB04bqhbyB0aMOqbSA1IGZpbGVzIGludGVyZmFjZSB2w6AgY2xhc3MgbeG7m2ksIGzDoG0gdMSDbmcgxJHhu5kgcGjhu6ljIHThuqFwIGtp4bq/biB0csO6YyBt4buZdCBjw6FjaCB2w7Qgw61jaC4NCg0KIyMjIDQuMi4gRGlhZ25vc3RpYyBSZWNpcGVzICYgVG9vbGluZyBTdWl0ZQ0KLSAqKklERSBTZW1hbnRpYyBSZWZhY3RvcmluZyAoQ2xhbmdkIC8gQ2xhbmctVGlkeSkqKjoNCiAgLSBU4bqtbiBk4bulbmcgYGNsYW5nLXRpZHkgLWZpeGAgxJHhu4MgdOG7sSDEkeG7mW5nIGjDs2Egdmnhu4djIGlubGluZSBob+G6t2MgbW9kZXJuaXplIGNvZGU6DQogICAgYGBgYmFzaA0KICAgIGNsYW5nLXRpZHkgc3JjL0xlZ2FjeUVuZ2luZS5jcHAgLWNoZWNrcz0nbW9kZXJuaXplLXVzZS1vdmVycmlkZSxyZWFkYWJpbGl0eS1yZWR1bmRhbnQtc21hcnRwdHItZ2V0JyAtZml4IC0tIC1zdGQ9YysrMjANCiAgICBgYGANCi0gKipSb3BlICYgQm93bGVyIChQeXRob24gU2VtYW50aWMgUmVmYWN0b3JpbmcpKio6DQogIC0gU+G7rSBk4bulbmcgdGjGsCB2aeG7h24gYHJvcGVgIGhv4bq3YyBgYm93bGVyYCDEkeG7gyB0aOG7sWMgaGnhu4duIFJlbmFtZSwgTW92ZSBNZXRob2QgdGjDtG5nIHF1YSBwaMOibiB0w61jaCBBU1QgY8OieSBjw7ogcGjDoXAsIGFuIHRvw6BuIGjGoW4gMTAwJSBzbyB24bubaSBSZWdleCBGaW5kLWFuZC1SZXBsYWNlLg0KDQotLS0NCg0KIyMgNS4gQuG6o25nIFNvIHPDoW5oICYgRGVjaXNpb24gTWF0cml4DQoNCnwgS+G7uSBUaHXhuq10IFJlZmFjdG9yaW5nIHwgTeG7pWMgVGnDqnUgQ2jDrW5oIHwgUuG7p2kgUm8gSOG7k2kgUXV5IHwgxJDDsmkgSOG7j2kgS2nhu4NtIFRo4butIHwgS2hpIE7DoG8gTsOqbiDDgXAgROG7pW5nPyB8DQp8IDotLS0gfCA6LS0tIHwgOi0tLSB8IDotLS0gfCA6LS0tIHwNCnwgKipFeHRyYWN0IE1ldGhvZCoqIHwgVMOhY2ggaMOgbSBuaOG7jywgdOG7sSBkaeG7hW4gZ2nhuqNpIG5n4buvIG5naMSpYSB8IFRo4bqlcCB8IFVuaXQgVGVzdCBj4bunYSBow6BtIGfhu41pIHwgS2hpIG3hu5l0IGto4buRaSBs4buHbmggY8OzIHRo4buDIHTDs20gdOG6r3QgYuG6sW5nIG3hu5l0IGPDoWkgdMOqbiB8DQp8ICoqSW5saW5lIE1ldGhvZCoqIHwgWMOzYSBwaMOibiBt4bqjbmgsIGdvbSBsb2dpYyB0cuG7sWMgcXVhbiB8IFLhuqV0IHRo4bqlcCB8IFVuaXQgVGVzdCBoaeG7h24gaOG7r3UgfCBLaGkgdMOqbiBow6BtIGtow7RuZyBjdW5nIGPhuqVwIHRow6ptIGdpw6EgdHLhu4sgbsOgbyB8DQp8ICoqUmVwbGFjZSBDb25kaXRpb25hbCB3aXRoIFBvbHltb3JwaGlzbSoqIHwgVHJp4buHdCB0acOqdSBgc3dpdGNoLWNhc2VgLCB0dcOibiB0aOG7pyBPQ1AgfCBUcnVuZyBiw6xuaCB8IENvbXByZWhlbnNpdmUgVGVzdCBTdWl0ZSB8IEtoaSBjw6FjIG5ow6FuaCBgc3dpdGNoYCBjw7MgeHUgaMaw4bubbmcgbGnDqm4gdOG7pWMgcGjDoXQgc2luaCBt4bubaSB8DQp8ICoqRGVjb21wb3NlIENvbmRpdGlvbmFsKiogfCBMw6BtIHBo4bqzbmcgbG9naWMgcGjhu6ljIHThuqFwIHRyb25nIGBpZi1lbHNlYCB8IFRo4bqlcCB8IFRlc3QgY2FzZSBjaG8gdOG7q25nIG5ow6FuaCB8IEtoaSBiaeG7g3UgdGjhu6ljIMSRaeG7gXUga2nhu4duIHF1w6EgZMOgaSB2w6Aga2jDsyBoaeG7g3UgfA0KfCAqKk1vdmUgTWV0aG9kIC8gRmllbGQqKiB8IEto4butIEZlYXR1cmUgRW52eSwgZ+G6r24ga+G6v3QgbG9naWMgxJHDum5nIGNo4buXIHwgVHJ1bmcgYsOsbmggfCBD4bqnbiBraeG7g20gdHJhIGNvdXBsaW5nIGPDoWMgbW9kdWxlIHwgS2hpIG3hu5l0IGjDoG0gc+G7rSBk4bulbmcgZOG7ryBsaeG7h3UgY+G7p2EgY2xhc3Mga2jDoWMgbmhp4buBdSBoxqFuIHwNCnwgKipHb2xkZW4gTWFzdGVyIEhhcm5lc3MqKiB8IEtow7NhIGNo4bq3dCBow6BuaCB2aSBj4bunYSBMZWdhY3kgQ29kZSB8IEPhu7FjIHRo4bqlcCAoQuG6o28gduG7hyBhbiB0b8OgbikgfCBU4buxIHNpbmgga2jDtG5nIGdpYW4gbeG6q3UgfCBC4bqvdCBideG7mWMgdGjhu7FjIGhp4buHbiB0csaw4bubYyBraGkgxJHhu6VuZyB2w6BvIGNvZGUgY8WpIGtow7RuZyBjw7MgdGVzdCB8DQo=