Chế độ giao diện
8.1. Chất Lượng Mã Nguồn và Tính Dễ Bảo Trì (Code Quality & Maintainability)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: Mã nguồn được viết cho con người đọc nhiều gấp 10 lần máy tính thực thi; chất lượng mã nguồn không phải là sự phô diễn cú pháp hóc búa, mà là nghệ thuật triệt tiêu tải trọng nhận thức (Cognitive Load Reduction) thông qua định danh tường minh, hàm thuần túy không tác dụng phụ ngầm, và cấu trúc luồng phẳng bằng Guard Clauses.
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
Phép loại suy kỹ thuật: Bản vẽ Hàng không vs Bản nháp Viết tay
Hãy tưởng tượng mã nguồn của một hệ thống phần mềm giống như tài liệu hướng dẫn vận hành buồng lái máy bay phản lực thương mại:
- Mã nguồn chất lượng kém: Giống như một tập ghi chép nguệch ngoạc bằng mực nhòe, các nút bấm chỉ được dán nhãn
btn1,temp_val, công tắc áp suất dầu ghi số thô104mà không có đơn vị đo, và phi công phải lật qua 6 trang phụ chú lồng nhau chỉ để tìm cách kích hoạt phanh khẩn cấp. Khi có biến cố động cơ giữa không trung, thời gian đọc hiểu tài liệu tăng vọt khiến tai nạn xảy ra. - Mã nguồn chất lượng cao (High Quality & Maintainable): Giống như buồng lái chuẩn hóa của Boeing hay Airbus. Mỗi nút bấm đều mang tên tự giải thích (
deployEmergencyLandingGear()), các giá trị giới hạn đều là hằng số định danh rõ ràng (MAX_HYDRAULIC_PRESSURE_PSI = 3000), hệ thống kiểm tra an toàn chạy theo các bước phẳng độc lập (Guard Clauses), và việc bảo dưỡng chỉ đòi hỏi kiểm tra từng module độc lập không làm rò rỉ điện sang hệ thống radar (No Side Effects).
Theo Robert C. Martin (Clean Code), tỷ lệ thời gian giữa việc đọc mã cũ và viết mã mới thực tế vượt ngưỡng
flowchart TD
subgraph Pillars ["Trụ Cột Cốt Lõi của Code Quality"]
P1["1. Tính Tự Diễn Giải<br/>(Self-Documenting & Semantics)"]
P2["2. Luồng Điều Khiển Thuần Khiết<br/>(Purity & Flat Flow Control)"]
P3["3. Đóng Gói & Tách Rời Ghép Nối<br/>(Decoupling & Smell Elimination)"]
end
subgraph Semantics ["Tự Diễn Giải & Ngữ Nghĩa"]
S1["Intention-Revealing Naming"]
S2["Eliminate Magic Numbers & Strings"]
S3["Self-Documenting over Comments"]
end
subgraph ControlFlow ["Kiểm Soát Luồng & Tác Dụng Phụ"]
C1["Pure Functions & Referential Transparency"]
C2["No Hidden Side Effects"]
C3["Flatten Arrow Anti-Pattern via Guard Clauses"]
C4["Purge Dead & Unreachable Code"]
end
subgraph Smells ["Khử Mùi Mã Nguồn (Code Smells)"]
M1["Long Parameter List -> Parameter Object"]
M2["Feature Envy -> Move Method"]
M3["Inappropriate Intimacy -> Encapsulation"]
M4["Duplicated Code -> DRY Principle"]
end
P1 --> Semantics
P2 --> ControlFlow
P3 --> Smells
Semantics --> Target["Mục Tiêu Tối Thượng: Minimal Cognitive Load & Zero Regression"]
ControlFlow --> Target
Smells --> Target
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Code Readability vs Code Clarity & Cognitive Load
- Bản chất kỹ thuật:
- Readability (Tính dễ đọc bề mặt): Khả năng hệ thống thị giác và vỏ não xử lý văn bản (Scanning speed) có thể đọc lướt qua cú pháp, thụt lề, định dạng mã nguồn một cách trơn tru mà không bị vấp.
- Clarity (Tính minh bạch ngữ nghĩa): Mức độ không nhập nhằng (Absence of Ambiguity) về mặt ý định nghiệp vụ (Intent). Mã có thể rất dễ đọc về mặt cú pháp (ví dụ:
a = b + c;) nhưng hoàn toàn mù mờ về ngữ nghĩa (a, b, clà gì?). - Cognitive Load (Tải trọng nhận thức): Não người chỉ có thể duy trì trung bình
mẩu thông tin trong bộ nhớ ngắn hạn (Working Memory) tại một thời điểm. Mã nguồn chất lượng cao là mã giảm thiểu số lượng biến trạng thái tạm thời mà lập trình viên phải "nhớ trong đầu" khi duyệt qua một hàm.
- Ưu & Nhược điểm / Cạm bẫy:
- Sai lầm phổ biến: Đánh đồng "ngắn gọn" (One-liner, Clever code) với "chất lượng". Việc lạm dụng các toán tử ternary lồng nhau (
a ? b : c ? d : e) hay macro phức tạp trong C++ có thể giảm số dòng code nhưng làm bùng nổ tải trọng nhận thức.
- Sai lầm phổ biến: Đánh đồng "ngắn gọn" (One-liner, Clever code) với "chất lượng". Việc lạm dụng các toán tử ternary lồng nhau (
2.2. Intention-Revealing & Meaningful Names & Self-Documenting Code
- Bản chất kỹ thuật:
- Mỗi định danh (biến, hàm, lớp, module) phải trả lời được 3 câu hỏi cốt lõi mà không cần tài liệu đi kèm: Nó đại diện cho cái gì? Nó làm gì? Và nó được sử dụng trong ngữ cảnh nào?
- Tránh các ký tự đơn vô nghĩa (
d,x,tmp,val,data,item). Ví dụ: thay vìint d; // elapsed time in days, bắt buộc đặt làint elapsedTimeInDays;hoặcstd::chrono::days elapsedDays;. - Self-Documenting Code: Mã nguồn thể hiện trực tiếp tư duy thiết kế thông qua tên hàm nhỏ mang tính hành động (
canUserAccessResource(),calculateMonthlyDepreciation()). - Bản chất của Comments: "Comments are often lies waiting to happen" (Robert C. Martin). Mã nguồn biến đổi liên tục qua các commit, nhưng các chú thích hiếm khi được cập nhật đồng bộ, nhanh chóng thoái hóa thành "thông tin giả" làm sai lạc phán đoán của kỹ sư bảo trì. Chỉ sử dụng comment để giải thích TẠI SAO (Why - quyết định nghiệp vụ kỳ lạ, workaround phần cứng, link tới CVE/RFC) chứ không bao giờ giải thích CÁI GÌ (What - việc mà bản thân code phải tự nói lên).
2.3. Magic Numbers & Magic Strings (Anti-Patterns)
- Bản chất kỹ thuật:
- Magic Numbers / Strings: Sự xuất hiện của các con số hoặc chuỗi ký tự thô (Hardcoded literals) nằm rải rác trong các biểu thức điều kiện hoặc tính toán mà không có tên định danh giải thích ngữ nghĩa (ví dụ:
if (userRole == 4),bufferSize = 8192;,timeout = 86400;). - Cơ chế giải quyết: Định nghĩa các hằng số bất biến (
constexpr,const,final) hoặcenum classcó phạm vi rõ ràng. Trình biên dịch hiện đại sẽ thay thế trực tiếp các hằng số này trong quá trình tối ưu hóa (Constant Folding / Inlining) mà không gây tốn thêm một byte bộ nhớ hay chu kỳ CPU nào trong runtime.
- Magic Numbers / Strings: Sự xuất hiện của các con số hoặc chuỗi ký tự thô (Hardcoded literals) nằm rải rác trong các biểu thức điều kiện hoặc tính toán mà không có tên định danh giải thích ngữ nghĩa (ví dụ:
- Tác hại thực tế: Khi tỷ lệ thuế suất
0.08hoặc mã trạng thái4xuất hiện ở 20 vị trí trong mã nguồn, việc sửa đổi yêu cầu kinh doanh đòi hỏi tìm kiếm thủ công toàn codebase, chắc chắn gây ra lỗi sót (Omission Bug) dẫn đến thảm họa dữ liệu.
2.4. Pure Functions, Referential Transparency & Side Effects
- Bản chất kỹ thuật:
- Pure Function (Hàm thuần túy): Một hàm toán học thỏa mãn hai tiêu chuẩn bất biến:
- Referential Transparency (Tính minh bạch tham chiếu): Với cùng một bộ tham số đầu vào, hàm luôn trả về cùng một kết quả duy nhất ở mọi thời điểm, cho phép thay thế lời gọi hàm bằng giá trị trả về của nó mà không làm đổi tính đúng đắn của chương trình.
- No Side Effects (Không có tác dụng phụ ngầm): Hàm không đột biến (mutate) bất kỳ trạng thái nào bên ngoài phạm vi cục bộ của nó: không sửa biến toàn cục, không ghi đè tham số truyền vào qua con trỏ/reference, không thực hiện I/O (ghi disk, gọi mạng, log console, lấy thời gian thực từ clock hệ thống).
- Side Effects (Tác dụng phụ ngầm): Việc một hàm làm thay đổi ngầm trạng thái của chương trình (ví dụ hàm
bool isValidUser(User& u)nhưng bên trong lại cập nhậtu.lastChecked = now()).
- Pure Function (Hàm thuần túy): Một hàm toán học thỏa mãn hai tiêu chuẩn bất biến:
- Lợi ích kiến trúc: Hàm thuần túy cực kỳ dễ viết Unit Test (không cần mock/stub DB hay Network), an toàn tuyệt đối trước Race Condition trong lập trình đa luồng (Thread-safe by design), và dễ dàng áp dụng cơ chế Caching (Memoization).
2.5. Deep Nesting & Arrow Anti-Pattern vs Guard Clauses
- Bản chất kỹ thuật:
- Arrow Anti-Pattern (Hiện tượng mũi tên rẽ nhánh): Xảy ra khi các cấu trúc rẽ nhánh (
if-else), vòng lặp (for,while), và bắt lỗi (try-catch) bị lồng sâu vào nhau từ 4 đến 7 tầng. Mã nguồn thụt lề dồn dập về phía bên phải tạo thành hình mũi tên (>). - Cognitive Complexity: Khi thụt lề sâu, não bộ lập trình viên phải duy trì một "Call Stack ảo" trong đầu để ghi nhớ: "Nếu user không null VÀ user active VÀ user có quyền VÀ tài khoản đủ tiền...".
- Guard Clauses (Mệnh đề bảo vệ / Early Exit): Kỹ thuật đảo ngược điều kiện kiểm tra (Invert Conditions). Ngay đầu hàm, kiểm tra ngay các trường hợp biên, giá trị bất hợp lệ hoặc lỗi tiềm ẩn để
returnhoặcthrowngay lập tức. Luồng xử lý chính (Happy Path) được giữ phẳng hoàn toàn ở mức thụt lề thấp nhất (Indent Level 0 hoặc 1).
- Arrow Anti-Pattern (Hiện tượng mũi tên rẽ nhánh): Xảy ra khi các cấu trúc rẽ nhánh (
flowchart TD
subgraph BadArrowPattern ["Arrow Anti-Pattern (Deep Nesting)"]
direction TB
B1["if (request != nullptr)"] --> B2["if (request->isValid())"]
B2 --> B3["if (authService->verify(request->token))"]
B3 --> B4["if (wallet->hasBalance(request->amount))"]
B4 --> B5["executeTransaction(); // Indent Level 4!"]
end
subgraph CleanGuardClauses ["Guard Clauses (Flattened Flow)"]
direction TB
G1["if (!request) return Status::InvalidRequest;"]
G2["if (!request->isValid()) return Status::Malformed;"]
G3["if (!authService->verify(request->token)) return Status::Unauthorized;"]
G4["if (!wallet->hasBalance(request->amount)) return Status::InsufficientFunds;"]
G5["executeTransaction(); // Indent Level 0 (Happy Path)"]
G1 --> G2 --> G3 --> G4 --> G5
end
2.6. Dead Code & Unreachable Code
- Bản chất kỹ thuật:
- Unreachable Code: Các khối lệnh không bao giờ có luồng điều khiển nào chạm tới được (ví dụ code nằm sau lệnh
return,throw, hoặc nằm trong nhánhif (false)). Trình biên dịch hiện đại (gcc -Wunreachable-code,clang) có thể phát hiện và loại bỏ khối này qua phân tích Control Flow Graph (Dead Code Elimination - DCE). - Dead Code (Zombie Code): Các biến, hàm, tham số hoặc lớp vẫn được biên dịch hợp lệ nhưng không còn bất kỳ nơi nào trong toàn bộ dự án triệu gọi tới nó. Nó tồn tại như một di tích lịch sử gây hiểu lầm rằng tính năng đó vẫn đang vận hành.
- Unreachable Code: Các khối lệnh không bao giờ có luồng điều khiển nào chạm tới được (ví dụ code nằm sau lệnh
- Nguy cơ hệ thống: Tạo ra ảo tưởng bảo mật hoặc logic, làm chậm tốc độ build, và khiến các công cụ refactoring tốn chi phí phân tích vô ích.
2.7. Coupling Smells: Long Parameter List & Introduce Parameter Object
- Bản chất kỹ thuật:
- Long Parameter List: Một hàm nhận từ 5 đến 10 tham số rời rạc. Vấn đề trở nên cực kỳ nghiêm trọng khi các tham số có cùng kiểu dữ liệu (ví dụ:
createUser(string firstName, string lastName, string email, string address, string city, string zip)). Chỉ cần đổi chỗ nhầm hai chuỗi, trình biên dịch hoàn toàn bất lực trong việc cảnh báo. - Introduce Parameter Object: Gom nhóm các tham số có quan hệ mật thiết về mặt ngữ nghĩa thành một đối tượng bất biến hoặc DTO (
UserRegistrationRequest,GeoCoordinate,DateRange).
- Long Parameter List: Một hàm nhận từ 5 đến 10 tham số rời rạc. Vấn đề trở nên cực kỳ nghiêm trọng khi các tham số có cùng kiểu dữ liệu (ví dụ:
- Lợi ích: Giảm số lượng tham số xuống còn 1 đối tượng duy nhất, tạo tiền đề để thêm các phương thức validation ngay trong đối tượng đó, và giúp API dễ mở rộng mà không làm vỡ chữ ký hàm (Backward Compatibility).
2.8. Feature Envy & Inappropriate Intimacy
- Bản chất kỹ thuật:
- Feature Envy (Ghen tị tính năng): Một phương thức thuộc lớp A nhưng liên tục gọi hàng loạt getters của lớp B để lấy dữ liệu tính toán. Điều này chứng minh rằng phương thức đó đang đặt nhầm chỗ và "ghen tị" với dữ liệu của lớp B. Giải pháp: Dùng kỹ thuật
Move Methodđể chuyển toàn bộ hoặc một phần logic sang lớp B (Tuân thủ nguyên lý Information Expert). - Inappropriate Intimacy (Thân mật thái quá): Lớp A biết quá sâu và phụ thuộc trực tiếp vào các trường riêng tư, chi tiết triển khai nội tại của lớp B (vi phạm nghiêm trọng Law of Demeter - "Chỉ nói chuyện với bạn bè gần nhất"). Khi lớp B thay đổi cấu trúc bên trong, lớp A vỡ vụn. Giải pháp: Thiết lập các giao diện đóng gói (Encapsulation Interfaces), áp dụng Mediator hoặc Delegation.
- Feature Envy (Ghen tị tính năng): Một phương thức thuộc lớp A nhưng liên tục gọi hàng loạt getters của lớp B để lấy dữ liệu tính toán. Điều này chứng minh rằng phương thức đó đang đặt nhầm chỗ và "ghen tị" với dữ liệu của lớp B. Giải pháp: Dùng kỹ thuật
2.9. Duplicated Code (DRY Principle) & Small Functions / Single Responsibility
- Bản chất kỹ thuật:
- Duplicated Code (Mã trùng lặp): Được Martin Fowler xếp là "ông tổ của mọi Code Smell". Trùng lặp có thể ở mức bề mặt (copy-paste nguyên khối lệnh) hoặc trùng lặp ngữ nghĩa (nhiều thuật toán khác nhau cùng giải quyết một quy tắc nghiệp vụ theo những cách phân tán).
- DRY (Don't Repeat Yourself): Không chỉ là việc tránh copy-paste mã nguồn, mà là: "Every piece of knowledge must have a single, unambiguous, authoritative representation within a system".
- Small Functions & Single Responsibility Principle (SRP): Mỗi hàm chỉ nên làm một việc duy nhất và làm nó thật xuất sắc (Functions should do one thing. They should do it well. They should do it only). Chiều dài lý tưởng của một hàm trong các hệ thống hiện đại thường dưới 20-30 dòng, giúp toàn bộ nội dung hàm nằm trọn vẹn trong màn hình của lập trình viên mà không cần cuộn trang.
3. Thực thi Mã nguồn & Mô phỏng Chuyên sâu (Dual-Engine Implementation)
3.1. Engine C++20: Clean Refactoring, Guard Clauses & Parameter Objects
Chương trình minh họa việc biến đổi mã nguồn từ vi phạm Arrow Anti-Pattern, Long Parameter List và Side Effects sang chuẩn mực C++20 hiện đại (sử dụng std::optional, std::string_view, Struct Packing, và Guard Clauses).
cpp
#include <iostream>
#include <string>
#include <string_view>
#include <optional>
#include <vector>
#include <chrono>
// ============================================================================
// 1. DOMAIN MODELS & PARAMETER OBJECTS (Khử Long Parameter List & Magic Types)
// ============================================================================
enum class FlightClass : uint8_t {
Economy,
PremiumEconomy,
Business,
FirstClass
};
struct FlightDate {
uint16_t year;
uint8_t month;
uint8_t day;
[[nodiscard]] constexpr bool isValid() const noexcept {
return (year >= 2026 && month >= 1 && month <= 12 && day >= 1 && day <= 31);
}
};
// Parameter Object thay thế cho danh sách tham số rời rạc 7 phần tử
struct BookingRequest {
std::string originAirport;
std::string destinationAirport;
FlightDate departureDate;
uint8_t requestedSeats{1};
FlightClass seatClass{FlightClass::Economy};
bool isVipMember{false};
};
struct BookingConfirmation {
std::string bookingReference;
double finalPriceUsd;
bool isConfirmed;
};
// ============================================================================
// 2. PRODUCTION ENGINE: REFACTORED FLIGHT BOOKING SERVICE (Guard Clauses)
// ============================================================================
class FlightBookingService {
private:
static constexpr uint8_t kMaxSeatsPerBooking = 9;
static constexpr double kBasePriceUsd = 250.0;
static constexpr double kVipDiscountRate = 0.15; // 15% discount for VIP
// Pure helper: Tính toán giá vé hoàn toàn không có side effects
[[nodiscard]] static double calculatePrice(uint8_t seats, FlightClass seatClass, bool isVip) noexcept {
double multiplier = 1.0;
switch (seatClass) {
case FlightClass::Economy: multiplier = 1.0; break;
case FlightClass::PremiumEconomy: multiplier = 1.4; break;
case FlightClass::Business: multiplier = 2.5; break;
case FlightClass::FirstClass: multiplier = 4.0; break;
}
double total = kBasePriceUsd * multiplier * seats;
if (isVip) {
total *= (1.0 - kVipDiscountRate);
}
return total;
}
public:
// Áp dụng Guard Clauses: Làm phẳng hoàn toàn luồng rẽ nhánh, return sớm khi gặp lỗi
[[nodiscard]] std::optional<BookingConfirmation> processBooking(const BookingRequest& req) const {
// Guard 1: Kiểm tra tính hợp lệ của sân bay
if (req.originAirport.empty() || req.destinationAirport.empty()) {
std::cerr << "[Guard Fail] Mã sân bay xuất phát hoặc hạ cánh không được để trống.\n";
return std::nullopt;
}
// Guard 2: Kiểm tra sân bay trùng lặp
if (req.originAirport == req.destinationAirport) {
std::cerr << "[Guard Fail] Điểm khởi hành và điểm đến không được trùng nhau ("
<< req.originAirport << ").\n";
return std::nullopt;
}
// Guard 3: Kiểm tra ngày bay hợp lệ
if (!req.departureDate.isValid()) {
std::cerr << "[Guard Fail] Ngày bay không hợp lệ hoặc nằm trong quá khứ.\n";
return std::nullopt;
}
// Guard 4: Kiểm tra giới hạn số ghế đặt
if (req.requestedSeats == 0 || req.requestedSeats > kMaxSeatsPerBooking) {
std::cerr << "[Guard Fail] Số ghế đặt (" << static_cast<int>(req.requestedSeats)
<< ") vượt quá phạm vi cho phép (1 - " << static_cast<int>(kMaxSeatsPerBooking) << ").\n";
return std::nullopt;
}
// HAPPY PATH: Nằm ở cấp thụt lề thấp nhất (Indent Level 0)
double price = calculatePrice(req.requestedSeats, req.seatClass, req.isVipMember);
std::string refCode = "VN-" + req.originAirport + req.destinationAirport + "-9928";
std::cout << "[Booking Success] Vé được xuất thành công cho " << static_cast<int>(req.requestedSeats)
<< " hành khách. Mã đặt vé: " << refCode << " | Tổng tiền: $" << price << "\n";
return BookingConfirmation{
.bookingReference = std::move(refCode),
.finalPriceUsd = price,
.isConfirmed = true
};
}
};
// ============================================================================
// 3. MAIN DRIVER TEST
// ============================================================================
int main() {
std::cout << "=== C++20 CODE QUALITY & REFACTORING DEMONSTRATION ===\n\n";
FlightBookingService bookingService;
// Kịch bản 1: Thất bại ở Guard Clause do cùng sân bay
std::cout << "--- Test 1: Cố tình vi phạm điều kiện Guard Clause ---\n";
BookingRequest invalidReq{
.originAirport = "HAN",
.destinationAirport = "HAN",
.departureDate = {2026, 12, 1},
.requestedSeats = 2,
.seatClass = FlightClass::Economy,
.isVipMember = false
};
auto res1 = bookingService.processBooking(invalidReq);
std::cout << "Result: " << (res1.has_value() ? "Approved" : "Rejected") << "\n\n";
// Kịch bản 2: Thành công với Happy Path phẳng và sạch sẽ
std::cout << "--- Test 2: Đặt vé hợp lệ với Parameter Object ---\n";
BookingRequest validReq{
.originAirport = "SGN",
.destinationAirport = "NRT",
.departureDate = {2026, 12, 15},
.requestedSeats = 2,
.seatClass = FlightClass::Business,
.isVipMember = true
};
auto res2 = bookingService.processBooking(validReq);
std::cout << "Result: " << (res2.has_value() ? "Approved" : "Rejected") << "\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
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
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
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
3.2. Engine Python 3.11+: Pure Functions vs Side Effects & Anti-Pattern Detection
Mô phỏng cơ chế phát hiện side effects ngầm, phân biệt giữa hàm thuần túy và hàm đột biến trạng thái, kết hợp kỹ thuật Dataclasses và Guard Clauses.
python
"""
Python 3.11+ Code Quality & Architecture Enforcement Demo
Minh họa triệt tiêu Side Effects, Refactoring Arrow Anti-Pattern và Tự Diễn Giải Mã Nguồn.
"""
from dataclasses import dataclass, field
from enum import Enum, auto
from typing import Optional, Final
import copy
class AccountTier(Enum):
STANDARD = auto()
GOLD = auto()
PLATINUM = auto()
@dataclass(frozen=True)
class TransactionContext:
"""Parameter Object bất biến (Immutable) chống đột biến tham số ngoài ý muốn."""
transaction_id: str
account_id: str
amount_cents: int
account_tier: AccountTier
is_active: bool
is_fraud_flagged: bool
@dataclass
class TransactionResult:
success: bool
fee_cents: int
message: str
# ============================================================================
# 1. BAD IMPLEMENTATION: ARROW PATTERN & IMPURE SIDE EFFECTS (Anti-pattern)
# ============================================================================
class BadTransactionProcessor:
def __init__(self) -> None:
self.audit_log: list[str] = []
def execute_bad(self, ctx: TransactionContext, global_state_dict: dict) -> bool:
# Arrow Anti-pattern: Thụt lề 4 tầng lồng nhau
if ctx.is_active:
if not ctx.is_fraud_flagged:
if ctx.amount_cents > 0:
if ctx.amount_cents <= 1_000_000:
# HIDDEN SIDE EFFECT: Đột biến dictionary toàn cục truyền từ ngoài vào!
global_state_dict["last_processed_account"] = ctx.account_id
self.audit_log.append(f"Processed {ctx.transaction_id}")
return True
else:
return False
else:
return False
else:
return False
else:
return False
# ============================================================================
# 2. CLEAN IMPLEMENTATION: PURE LOGIC & GUARD CLAUSES (Production Grade)
# ============================================================================
class CleanTransactionProcessor:
MAX_TRANSACTION_CENTS: Final[int] = 1_000_000 # Hằng số định danh thay cho Magic Number
@staticmethod
def calculate_fee_pure(amount_cents: int, tier: AccountTier) -> int:
"""
Pure Function: Hoàn toàn không phụ thuộc trạng thái ngoài, không có Side Effect.
Referential Transparency: Luôn trả về cùng kết quả với cùng đối số.
"""
fee_multipliers = {
AccountTier.STANDARD: 0.02, # 2.0%
AccountTier.GOLD: 0.01, # 1.0%
AccountTier.PLATINUM: 0.005 # 0.5%
}
return int(amount_cents * fee_multipliers[tier])
def process_transaction(self, ctx: TransactionContext) -> TransactionResult:
"""
Xử lý giao dịch phẳng bằng Guard Clauses (Early Exit).
Happy Path duy trì ở mức Indent 0.
"""
# Guard 1: Trạng thái tài khoản
if not ctx.is_active:
return TransactionResult(success=False, fee_cents=0, message="Account is suspended or inactive")
# Guard 2: Cảnh báo gian lận
if ctx.is_fraud_flagged:
return TransactionResult(success=False, fee_cents=0, message="Transaction blocked by Fraud Detection Engine")
# Guard 3: Giá trị thanh toán bất hợp lệ
if ctx.amount_cents <= 0:
return TransactionResult(success=False, fee_cents=0, message="Amount must be strictly positive")
# Guard 4: Vượt trần giao dịch
if ctx.amount_cents > self.MAX_TRANSACTION_CENTS:
return TransactionResult(
success=False,
fee_cents=0,
message=f"Amount exceeds maximum single transfer limit ({self.MAX_TRANSACTION_CENTS} cents)"
)
# HAPPY PATH (Flattened, không còn bất kỳ tầng lồng nhau nào)
fee = self.calculate_fee_pure(ctx.amount_cents, ctx.account_tier)
return TransactionResult(
success=True,
fee_cents=fee,
message=f"Transaction {ctx.transaction_id} approved. Fee applied: {fee} cents."
)
# ============================================================================
# 3. VERIFICATION & TEST HARNESS
# ============================================================================
if __name__ == "__main__":
print("=== PYTHON 3.11+ CODE QUALITY & PURITY BENCHMARK ===\n")
clean_engine = CleanTransactionProcessor()
# Kịch bản 1: Vi phạm gian lận (Kích hoạt Guard Clause 2)
fraud_tx = TransactionContext(
transaction_id="TX-FAIL-01",
account_id="ACC-883",
amount_cents=50_000,
account_tier=AccountTier.GOLD,
is_active=True,
is_fraud_flagged=True
)
result1 = clean_engine.process_transaction(fraud_tx)
print(f"[Test 1 Guard Test] Success: {result1.success} | Msg: {result1.message}")
# Kịch bản 2: Giao dịch thành công (Happy Path)
valid_tx = TransactionContext(
transaction_id="TX-OK-99",
account_id="ACC-104",
amount_cents=200_000,
account_tier=AccountTier.PLATINUM,
is_active=True,
is_fraud_flagged=False
)
result2 = clean_engine.process_transaction(valid_tx)
print(f"[Test 2 Happy Path] Success: {result2.success} | Fee: {result2.fee_cents} cents | Msg: {result2.message}")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
135
136
137
138
139
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
135
136
137
138
139
3.3. Giả lập Terminal Output
text
=== C++20 CODE QUALITY & REFACTORING DEMONSTRATION ===
--- Test 1: Cố tình vi phạm điều kiện Guard Clause ---
[Guard Fail] Điểm khởi hành và điểm đến không được trùng nhau (HAN).
Result: Rejected
--- Test 2: Đặt vé hợp lệ với Parameter Object ---
[Booking Success] Vé được xuất thành công cho 2 hành khách. Mã đặt vé: VN-SGNNRT-9928 | Tổng tiền: $1062.5
Result: Approved
=== PYTHON 3.11+ CODE QUALITY & PURITY BENCHMARK ===
[Test 1 Guard Test] Success: False | Msg: Transaction blocked by Fraud Detection Engine
[Test 2 Happy Path] Success: True | Fee: 1000 cents | Msg: Transaction TX-OK-99 approved. Fee applied: 1000 cents.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
- Lỗi Rò Rỉ Trạng Thái do Side Effects ngầm (Hidden State Mutation):
- Kịch bản: Trong hệ thống Backend xử lý đồng thời (Concurrent Requests), việc một hàm nghiệp vụ sửa đổi trực tiếp các thuộc tính của một object được dùng chung hoặc biến toàn cục mà không có cơ chế khóa (Lock) sẽ dẫn đến Race Condition, gây sai lệch dữ liệu tài khoản người dùng nghiêm trọng.
- "Tê liệt Nhận thức" trong Incident Response do Arrow Anti-Pattern:
- Kịch bản: Khi xảy ra sự cố production vào 3 giờ sáng, kỹ sư On-call phải đọc hiểu một hàm dài 400 dòng với 6 tầng lồng
if-elselắt léo. Do không thể nắm bắt được biến số ở tầng rẽ nhánh thứ 5, kỹ sư đưa ra bản vá sai sót, biến lỗi cục bộ thành thảm họa sập toàn hệ thống.
- Kịch bản: Khi xảy ra sự cố production vào 3 giờ sáng, kỹ sư On-call phải đọc hiểu một hàm dài 400 dòng với 6 tầng lồng
- Lỗi Sót Khi Sửa Magic Numbers / Strings (The Omission Defect):
- Kịch bản: Khi cổng thanh toán cập nhật phí giao dịch từ
2.5%lên3.0%, lập trình viên tìm và thay thế0.025ở 10 vị trí, nhưng bỏ sót 2 vị trí khác được viết dưới dạngamount * 25 / 1000. Doanh nghiệp bị thất thoát doanh thu hàng tháng trời trước khi bị kiểm toán phát hiện.
- Kịch bản: Khi cổng thanh toán cập nhật phí giao dịch từ
4.2. Diagnostic Recipes & Tooling Suite
- Kiểm soát Cognitive Complexity tự động: Tích hợp quy tắc SonarQube
csharpsquid:S3776hoặccpp:S3776với ngưỡng giới hạn Cognitive Complexity cho mỗi phương thức trong CI pipeline. Bất kỳ PR nào vi phạm đều bị chặn merge tự động. - Clang-Tidy (C++):bash
# Quét mã nguồn C++ phát hiện các vấn đề về Magic Numbers và Readability clang-tidy src/FlightBooking.cpp -checks='readability-*,bugprone-*,modernize-*' -- -std=c++201
2 - Flake8 & Bugbear (Python):bash
# Phát hiện các lỗi lồng nhau sâu, biến mutable làm mặc định và code smell flake8 --max-complexity=10 --select=C,E,F,W,B src/1
2
5. Bảng So sánh & Decision Matrix
| Chiều Kỹ Thuật | Arrow Anti-Pattern (Lồng Sâu) | Guard Clauses (Return Sớm) | Parameter Object Pattern | Micro-functions (Single Responsibility) |
|---|---|---|---|---|
| Cognitive Load | Cực kỳ cao (Thang điểm não bộ: 9/10) | Cực kỳ thấp (Thang điểm não bộ: 2/10) | Thấp (Gom nhóm thông tin liền mạch) | Rất thấp (Hiểu logic trong 5 giây) |
| Độ Khó Kiểm Thử | Khó viết Unit Test (Tổ hợp nhánh bùng nổ) | Rất dễ (Mỗi Guard Clause tương ứng 1 test case) | Dễ dàng tạo fixture giả lập dữ liệu | Dễ dàng viết Unit Test độc lập hoàn toàn |
| Chi Phí Bảo Trì | Rủi ro hồi quy (Regression) rất cao | Dễ bảo trì và bổ sung điều kiện mới | Dễ mở rộng trường dữ liệu không vỡ API | Chi phí bảo trì thấp, tái sử dụng cao |
| Hiệu Năng Runtime | Tương đương (Trình biên dịch tối ưu) | Tương đương (Có thể hỗ trợ Branch Prediction tốt hơn) | Không đáng kể (Trình biên dịch tối ưu hóa pass-by-reference) | Tối ưu hóa inlining bởi compiler |
| Khuyến Nghị Sử Dụng | ❌ Tuyệt đối cấm trong Production | ✅ Bắt buộc áp dụng cho mọi hàm xác thực | ✅ Áp dụng khi hàm có | ✅ Áp dụng cho mọi khối lệnh nghiệp vụ |
IyA4LjEuIENo4bqldCBMxrDhu6NuZyBNw6MgTmd14buTbiB2w6AgVMOtbmggROG7hSBC4bqjbyBUcsOsIChDb2RlIFF1YWxpdHkgJiBNYWludGFpbmFiaWxpdHkpDQoNCj4gWyFJTVBPUlRBTlRdDQo+ICoqTuG6v3UgYuG6oW4gY2jhu4kgxJHGsOG7o2Mgbmjhu5sgbeG7mXQgxJFp4buBdSBkdXkgbmjhuqV0OioqIE3DoyBuZ3Xhu5NuIMSRxrDhu6NjIHZp4bq/dCBjaG8gY29uIG5nxrDhu51pIMSR4buNYyBuaGnhu4F1IGfhuqVwIDEwIGzhuqduIG3DoXkgdMOtbmggdGjhu7FjIHRoaTsgY2jhuqV0IGzGsOG7o25nIG3DoyBuZ3Xhu5NuIGtow7RuZyBwaOG6o2kgbMOgIHPhu7EgcGjDtCBkaeG7hW4gY8O6IHBow6FwIGjDs2MgYsO6YSwgbcOgIGzDoCBuZ2jhu4cgdGh14bqtdCB0cmnhu4d0IHRpw6p1IHThuqNpIHRy4buNbmcgbmjhuq1uIHRo4bupYyAoQ29nbml0aXZlIExvYWQgUmVkdWN0aW9uKSB0aMO0bmcgcXVhIMSR4buLbmggZGFuaCB0xrDhu51uZyBtaW5oLCBow6BtIHRodeG6p24gdMO6eSBraMO0bmcgdMOhYyBk4bulbmcgcGjhu6UgbmfhuqdtLCB2w6AgY+G6pXUgdHLDumMgbHXhu5NuZyBwaOG6s25nIGLhurFuZyBHdWFyZCBDbGF1c2VzLg0KDQotLS0NCg0KIyMgMS4gS2nhur9uIHRyw7pjIFThu5VuZyBxdWFuICYgTcO0IGjDrG5oIFTGsCBkdXkgKE1lbnRhbCBNb2RlbCkNCg0KIyMjIFBow6lwIGxv4bqhaSBzdXkga+G7uSB0aHXhuq10OiBC4bqjbiB24bq9IEjDoG5nIGtow7RuZyB2cyBC4bqjbiBuaMOhcCBWaeG6v3QgdGF5DQpIw6N5IHTGsOG7n25nIHTGsOG7o25nIG3DoyBuZ3Xhu5NuIGPhu6dhIG3hu5l0IGjhu4cgdGjhu5FuZyBwaOG6p24gbeG7gW0gZ2nhu5FuZyBuaMawIHTDoGkgbGnhu4d1IGjGsOG7m25nIGThuqtuIHbhuq1uIGjDoG5oIGJ14buTbmcgbMOhaSBtw6F5IGJheSBwaOG6o24gbOG7sWMgdGjGsMahbmcgbeG6oWk6DQotICoqTcOjIG5ndeG7k24gY2jhuqV0IGzGsOG7o25nIGvDqW0qKjogR2nhu5FuZyBuaMawIG3hu5l0IHThuq1wIGdoaSBjaMOpcCBuZ3Xhu4djaCBuZ2/huqFjIGLhurFuZyBt4buxYyBuaMOyZSwgY8OhYyBuw7p0IGLhuqVtIGNo4buJIMSRxrDhu6NjIGTDoW4gbmjDo24gYGJ0bjFgLCBgdGVtcF92YWxgLCBjw7RuZyB04bqvYyDDoXAgc3XhuqV0IGThuqd1IGdoaSBz4buRIHRow7QgYDEwNGAgbcOgIGtow7RuZyBjw7MgxJHGoW4gduG7iyDEkW8sIHbDoCBwaGkgY8O0bmcgcGjhuqNpIGzhuq10IHF1YSA2IHRyYW5nIHBo4bulIGNow7ogbOG7k25nIG5oYXUgY2jhu4kgxJHhu4MgdMOsbSBjw6FjaCBrw61jaCBob+G6oXQgcGhhbmgga2jhuqluIGPhuqVwLiBLaGkgY8OzIGJp4bq/biBj4buRIMSR4buZbmcgY8ahIGdp4buvYSBraMO0bmcgdHJ1bmcsIHRo4budaSBnaWFuIMSR4buNYyBoaeG7g3UgdMOgaSBsaeG7h3UgdMSDbmcgduG7jXQga2hp4bq/biB0YWkgbuG6oW4geOG6o3kgcmEuDQotICoqTcOjIG5ndeG7k24gY2jhuqV0IGzGsOG7o25nIGNhbyAoSGlnaCBRdWFsaXR5ICYgTWFpbnRhaW5hYmxlKSoqOiBHaeG7kW5nIG5oxrAgYnXhu5NuZyBsw6FpIGNodeG6qW4gaMOzYSBj4bunYSBCb2VpbmcgaGF5IEFpcmJ1cy4gTeG7l2kgbsO6dCBi4bqlbSDEkeG7gXUgbWFuZyB0w6puIHThu7EgZ2nhuqNpIHRow61jaCAoYGRlcGxveUVtZXJnZW5jeUxhbmRpbmdHZWFyKClgKSwgY8OhYyBnacOhIHRy4buLIGdp4bubaSBo4bqhbiDEkeG7gXUgbMOgIGjhurFuZyBz4buRIMSR4buLbmggZGFuaCByw7UgcsOgbmcgKGBNQVhfSFlEUkFVTElDX1BSRVNTVVJFX1BTSSA9IDMwMDBgKSwgaOG7hyB0aOG7kW5nIGtp4buDbSB0cmEgYW4gdG/DoG4gY2jhuqF5IHRoZW8gY8OhYyBixrDhu5tjIHBo4bqzbmcgxJHhu5ljIGzhuq1wIChHdWFyZCBDbGF1c2VzKSwgdsOgIHZp4buHYyBi4bqjbyBkxrDhu6FuZyBjaOG7iSDEkcOyaSBo4buPaSBraeG7g20gdHJhIHThu6tuZyBtb2R1bGUgxJHhu5ljIGzhuq1wIGtow7RuZyBsw6BtIHLDsiBy4buJIMSRaeG7h24gc2FuZyBo4buHIHRo4buRbmcgcmFkYXIgKE5vIFNpZGUgRWZmZWN0cykuDQoNClRoZW8gUm9iZXJ0IEMuIE1hcnRpbiAoKkNsZWFuIENvZGUqKSwgdOG7tyBs4buHIHRo4budaSBnaWFuIGdp4buvYSB2aeG7h2MgxJHhu41jIG3DoyBjxakgdsOgIHZp4bq/dCBtw6MgbeG7m2kgdGjhu7FjIHThur8gdsaw4bujdCBuZ8aw4buhbmcgKiokMTA6MSQqKi4gQuG6pXQga+G7syBz4buxIGPhuql1IHRo4bqjIG7DoG8ga2hpIHZp4bq/dCBtw6MgYmFuIMSR4bqndSBz4bq9IGLhu4sgbmjDom4gbMOqbiBn4bqlcCAxMCBs4bqnbiBjaGkgcGjDrSBi4bqjbyB0csOsLCBn4buhIGzhu5dpIHbDoCBjaHV54buDbiBnaWFvIHRyb25nIHTGsMahbmcgbGFpLg0KDQpgYGBtZXJtYWlkDQpmbG93Y2hhcnQgVEQNCiAgICBzdWJncmFwaCBQaWxsYXJzIFsiVHLhu6UgQ+G7mXQgQ+G7kXQgTMO1aSBj4bunYSBDb2RlIFF1YWxpdHkiXQ0KICAgICAgICBQMVsiMS4gVMOtbmggVOG7sSBEaeG7hW4gR2nhuqNpPGJyLz4oU2VsZi1Eb2N1bWVudGluZyAmIFNlbWFudGljcykiXQ0KICAgICAgICBQMlsiMi4gTHXhu5NuZyDEkGnhu4F1IEtoaeG7g24gVGh14bqnbiBLaGnhur90PGJyLz4oUHVyaXR5ICYgRmxhdCBGbG93IENvbnRyb2wpIl0NCiAgICAgICAgUDNbIjMuIMSQw7NuZyBHw7NpICYgVMOhY2ggUuG7nWkgR2jDqXAgTuG7kWk8YnIvPihEZWNvdXBsaW5nICYgU21lbGwgRWxpbWluYXRpb24pIl0NCiAgICBlbmQNCg0KICAgIHN1YmdyYXBoIFNlbWFudGljcyBbIlThu7EgRGnhu4VuIEdp4bqjaSAmIE5n4buvIE5naMSpYSJdDQogICAgICAgIFMxWyJJbnRlbnRpb24tUmV2ZWFsaW5nIE5hbWluZyJdDQogICAgICAgIFMyWyJFbGltaW5hdGUgTWFnaWMgTnVtYmVycyAmIFN0cmluZ3MiXQ0KICAgICAgICBTM1siU2VsZi1Eb2N1bWVudGluZyBvdmVyIENvbW1lbnRzIl0NCiAgICBlbmQNCg0KICAgIHN1YmdyYXBoIENvbnRyb2xGbG93IFsiS2nhu4NtIFNvw6F0IEx14buTbmcgJiBUw6FjIEThu6VuZyBQaOG7pSJdDQogICAgICAgIEMxWyJQdXJlIEZ1bmN0aW9ucyAmIFJlZmVyZW50aWFsIFRyYW5zcGFyZW5jeSJdDQogICAgICAgIEMyWyJObyBIaWRkZW4gU2lkZSBFZmZlY3RzIl0NCiAgICAgICAgQzNbIkZsYXR0ZW4gQXJyb3cgQW50aS1QYXR0ZXJuIHZpYSBHdWFyZCBDbGF1c2VzIl0NCiAgICAgICAgQzRbIlB1cmdlIERlYWQgJiBVbnJlYWNoYWJsZSBDb2RlIl0NCiAgICBlbmQNCg0KICAgIHN1YmdyYXBoIFNtZWxscyBbIkto4butIE3DuWkgTcOjIE5ndeG7k24gKENvZGUgU21lbGxzKSJdDQogICAgICAgIE0xWyJMb25nIFBhcmFtZXRlciBMaXN0IC0+IFBhcmFtZXRlciBPYmplY3QiXQ0KICAgICAgICBNMlsiRmVhdHVyZSBFbnZ5IC0+IE1vdmUgTWV0aG9kIl0NCiAgICAgICAgTTNbIkluYXBwcm9wcmlhdGUgSW50aW1hY3kgLT4gRW5jYXBzdWxhdGlvbiJdDQogICAgICAgIE00WyJEdXBsaWNhdGVkIENvZGUgLT4gRFJZIFByaW5jaXBsZSJdDQogICAgZW5kDQoNCiAgICBQMSAtLT4gU2VtYW50aWNzDQogICAgUDIgLS0+IENvbnRyb2xGbG93DQogICAgUDMgLS0+IFNtZWxscw0KDQogICAgU2VtYW50aWNzIC0tPiBUYXJnZXRbIk3hu6VjIFRpw6p1IFThu5FpIFRoxrDhu6NuZzogTWluaW1hbCBDb2duaXRpdmUgTG9hZCAmIFplcm8gUmVncmVzc2lvbiJdDQogICAgQ29udHJvbEZsb3cgLS0+IFRhcmdldA0KICAgIFNtZWxscyAtLT4gVGFyZ2V0DQpgYGANCg0KLS0tDQoNCiMjIDIuIENoaSB0aeG6v3QgdOG7q25nIEtleXdvcmQgKFVuZGVyLXRoZS1Ib29kIERlZXAgRGl2ZSkNCg0KIyMjIDIuMS4gQ29kZSBSZWFkYWJpbGl0eSB2cyBDb2RlIENsYXJpdHkgJiBDb2duaXRpdmUgTG9hZA0KLSAqKkLhuqNuIGNo4bqldCBr4bu5IHRodeG6rXQqKjoNCiAgLSAqKlJlYWRhYmlsaXR5IChUw61uaCBk4buFIMSR4buNYyBi4buBIG3hurd0KSoqOiBLaOG6oyBuxINuZyBo4buHIHRo4buRbmcgdGjhu4sgZ2nDoWMgdsOgIHbhu48gbsOjbyB44butIGzDvSB2xINuIGLhuqNuIChTY2FubmluZyBzcGVlZCkgY8OzIHRo4buDIMSR4buNYyBsxrDhu5t0IHF1YSBjw7ogcGjDoXAsIHRo4buldCBs4buBLCDEkeG7i25oIGThuqFuZyBtw6Mgbmd14buTbiBt4buZdCBjw6FjaCB0csahbiB0cnUgbcOgIGtow7RuZyBi4buLIHbhuqVwLg0KICAtICoqQ2xhcml0eSAoVMOtbmggbWluaCBi4bqhY2ggbmfhu68gbmdoxKlhKSoqOiBN4bupYyDEkeG7mSBraMO0bmcgbmjhuq1wIG5o4bqxbmcgKEFic2VuY2Ugb2YgQW1iaWd1aXR5KSB24buBIG3hurd0IMO9IMSR4buLbmggbmdoaeG7h3AgduG7pSAoSW50ZW50KS4gTcOjIGPDsyB0aOG7gyBy4bqldCBk4buFIMSR4buNYyB24buBIG3hurd0IGPDuiBwaMOhcCAodsOtIGThu6U6IGBhID0gYiArIGM7YCkgbmjGsG5nIGhvw6BuIHRvw6BuIG3DuSBt4budIHbhu4Egbmfhu68gbmdoxKlhIChgYSwgYiwgY2AgbMOgIGfDrD8pLg0KICAtICoqQ29nbml0aXZlIExvYWQgKFThuqNpIHRy4buNbmcgbmjhuq1uIHRo4bupYykqKjogTsOjbyBuZ8aw4budaSBjaOG7iSBjw7MgdGjhu4MgZHV5IHRyw6wgdHJ1bmcgYsOsbmggJDQgXHBtIDEkIG3huql1IHRow7RuZyB0aW4gdHJvbmcgYuG7mSBuaOG7myBuZ+G6r24gaOG6oW4gKFdvcmtpbmcgTWVtb3J5KSB04bqhaSBt4buZdCB0aOG7nWkgxJFp4buDbS4gTcOjIG5ndeG7k24gY2jhuqV0IGzGsOG7o25nIGNhbyBsw6AgbcOjIGdp4bqjbSB0aGnhu4N1IHPhu5EgbMaw4bujbmcgYmnhur9uIHRy4bqhbmcgdGjDoWkgdOG6oW0gdGjhu51pIG3DoCBs4bqtcCB0csOsbmggdmnDqm4gcGjhuqNpICJuaOG7myB0cm9uZyDEkeG6p3UiIGtoaSBkdXnhu4d0IHF1YSBt4buZdCBow6BtLg0KLSAqKsavdSAmIE5oxrDhu6NjIMSRaeG7g20gLyBD4bqhbSBi4bqreSoqOg0KICAtICpTYWkgbOG6p20gcGjhu5UgYmnhur9uKjogxJDDoW5oIMSR4buTbmcgIm5n4bqvbiBn4buNbiIgKE9uZS1saW5lciwgQ2xldmVyIGNvZGUpIHbhu5tpICJjaOG6pXQgbMaw4bujbmciLiBWaeG7h2MgbOG6oW0gZOG7pW5nIGPDoWMgdG/DoW4gdOG7rSB0ZXJuYXJ5IGzhu5NuZyBuaGF1IChgYSA/IGIgOiBjID8gZCA6IGVgKSBoYXkgbWFjcm8gcGjhu6ljIHThuqFwIHRyb25nIEMrKyBjw7MgdGjhu4MgZ2nhuqNtIHPhu5EgZMOybmcgY29kZSBuaMawbmcgbMOgbSBiw7luZyBu4buVIHThuqNpIHRy4buNbmcgbmjhuq1uIHRo4bupYy4NCg0KIyMjIDIuMi4gSW50ZW50aW9uLVJldmVhbGluZyAmIE1lYW5pbmdmdWwgTmFtZXMgJiBTZWxmLURvY3VtZW50aW5nIENvZGUNCi0gKipC4bqjbiBjaOG6pXQga+G7uSB0aHXhuq10Kio6DQogIC0gTeG7l2kgxJHhu4tuaCBkYW5oIChiaeG6v24sIGjDoG0sIGzhu5twLCBtb2R1bGUpIHBo4bqjaSB0cuG6oyBs4budaSDEkcaw4bujYyAzIGPDonUgaOG7j2kgY+G7kXQgbMO1aSBtw6Aga2jDtG5nIGPhuqduIHTDoGkgbGnhu4d1IMSRaSBrw6htOiAqKk7DsyDEkeG6oWkgZGnhu4duIGNobyBjw6FpIGfDrD8gTsOzIGzDoG0gZ8OsPyBWw6AgbsOzIMSRxrDhu6NjIHPhu60gZOG7pW5nIHRyb25nIG5n4buvIGPhuqNuaCBuw6BvPyoqDQogIC0gVHLDoW5oIGPDoWMga8O9IHThu7EgxJHGoW4gdsO0IG5naMSpYSAoYGRgLCBgeGAsIGB0bXBgLCBgdmFsYCwgYGRhdGFgLCBgaXRlbWApLiBWw60gZOG7pTogdGhheSB2w6wgYGludCBkOyAvLyBlbGFwc2VkIHRpbWUgaW4gZGF5c2AsIGLhuq90IGJ14buZYyDEkeG6t3QgbMOgIGBpbnQgZWxhcHNlZFRpbWVJbkRheXM7YCBob+G6t2MgYHN0ZDo6Y2hyb25vOjpkYXlzIGVsYXBzZWREYXlzO2AuDQogIC0gKipTZWxmLURvY3VtZW50aW5nIENvZGUqKjogTcOjIG5ndeG7k24gdGjhu4MgaGnhu4duIHRy4buxYyB0aeG6v3AgdMawIGR1eSB0aGnhur90IGvhur8gdGjDtG5nIHF1YSB0w6puIGjDoG0gbmjhu48gbWFuZyB0w61uaCBow6BuaCDEkeG7mW5nIChgY2FuVXNlckFjY2Vzc1Jlc291cmNlKClgLCBgY2FsY3VsYXRlTW9udGhseURlcHJlY2lhdGlvbigpYCkuDQogIC0gKkLhuqNuIGNo4bqldCBj4bunYSBDb21tZW50cyo6ICoiQ29tbWVudHMgYXJlIG9mdGVuIGxpZXMgd2FpdGluZyB0byBoYXBwZW4iKiAoUm9iZXJ0IEMuIE1hcnRpbikuIE3DoyBuZ3Xhu5NuIGJp4bq/biDEkeG7lWkgbGnDqm4gdOG7pWMgcXVhIGPDoWMgY29tbWl0LCBuaMawbmcgY8OhYyBjaMO6IHRow61jaCBoaeG6v20ga2hpIMSRxrDhu6NjIGPhuq1wIG5o4bqtdCDEkeG7k25nIGLhu5ksIG5oYW5oIGNow7NuZyB0aG/DoWkgaMOzYSB0aMOgbmggInRow7RuZyB0aW4gZ2nhuqMiIGzDoG0gc2FpIGzhuqFjIHBow6FuIMSRb8OhbiBj4bunYSBr4bu5IHPGsCBi4bqjbyB0csOsLiBDaOG7iSBz4butIGThu6VuZyBjb21tZW50IMSR4buDIGdp4bqjaSB0aMOtY2ggKipU4bqgSSBTQU8qKiAoV2h5IC0gcXV54bq/dCDEkeG7i25oIG5naGnhu4dwIHbhu6Uga+G7syBs4bqhLCB3b3JrYXJvdW5kIHBo4bqnbiBj4bupbmcsIGxpbmsgdOG7m2kgQ1ZFL1JGQykgY2jhu6kga2jDtG5nIGJhbyBnaeG7nSBnaeG6o2kgdGjDrWNoICoqQ8OBSSBHw4wqKiAoV2hhdCAtIHZp4buHYyBtw6AgYuG6o24gdGjDom4gY29kZSBwaOG6o2kgdOG7sSBuw7NpIGzDqm4pLg0KDQojIyMgMi4zLiBNYWdpYyBOdW1iZXJzICYgTWFnaWMgU3RyaW5ncyAoQW50aS1QYXR0ZXJucykNCi0gKipC4bqjbiBjaOG6pXQga+G7uSB0aHXhuq10Kio6DQogIC0gKipNYWdpYyBOdW1iZXJzIC8gU3RyaW5ncyoqOiBT4buxIHh14bqldCBoaeG7h24gY+G7p2EgY8OhYyBjb24gc+G7kSBob+G6t2MgY2h14buXaSBrw70gdOG7sSB0aMO0IChIYXJkY29kZWQgbGl0ZXJhbHMpIG7hurFtIHLhuqNpIHLDoWMgdHJvbmcgY8OhYyBiaeG7g3UgdGjhu6ljIMSRaeG7gXUga2nhu4duIGhv4bq3YyB0w61uaCB0b8OhbiBtw6Aga2jDtG5nIGPDsyB0w6puIMSR4buLbmggZGFuaCBnaeG6o2kgdGjDrWNoIG5n4buvIG5naMSpYSAodsOtIGThu6U6IGBpZiAodXNlclJvbGUgPT0gNClgLCBgYnVmZmVyU2l6ZSA9IDgxOTI7YCwgYHRpbWVvdXQgPSA4NjQwMDtgKS4NCiAgLSAqQ8ahIGNo4bq/IGdp4bqjaSBxdXnhur90KjogxJDhu4tuaCBuZ2jEqWEgY8OhYyBo4bqxbmcgc+G7kSBi4bqldCBiaeG6v24gKGBjb25zdGV4cHJgLCBgY29uc3RgLCBgZmluYWxgKSBob+G6t2MgYGVudW0gY2xhc3NgIGPDsyBwaOG6oW0gdmkgcsO1IHLDoG5nLiBUcsOsbmggYmnDqm4gZOG7i2NoIGhp4buHbiDEkeG6oWkgc+G6vSB0aGF5IHRo4bq/IHRy4buxYyB0aeG6v3AgY8OhYyBo4bqxbmcgc+G7kSBuw6B5IHRyb25nIHF1w6EgdHLDrG5oIHThu5FpIMawdSBow7NhIChDb25zdGFudCBGb2xkaW5nIC8gSW5saW5pbmcpIG3DoCBraMO0bmcgZ8OieSB04buRbiB0aMOqbSBt4buZdCBieXRlIGLhu5kgbmjhu5sgaGF5IGNodSBr4buzIENQVSBuw6BvIHRyb25nIHJ1bnRpbWUuDQotICoqVMOhYyBo4bqhaSB0aOG7sWMgdOG6vyoqOiBLaGkgdOG7tyBs4buHIHRodeG6vyBzdeG6pXQgYDAuMDhgIGhv4bq3YyBtw6MgdHLhuqFuZyB0aMOhaSBgNGAgeHXhuqV0IGhp4buHbiDhu58gMjAgduG7iyB0csOtIHRyb25nIG3DoyBuZ3Xhu5NuLCB2aeG7h2Mgc+G7rWEgxJHhu5VpIHnDqnUgY+G6p3Uga2luaCBkb2FuaCDEkcOyaSBo4buPaSB0w6xtIGtp4bq/bSB0aOG7pyBjw7RuZyB0b8OgbiBjb2RlYmFzZSwgY2jhuq9jIGNo4bqvbiBnw6J5IHJhIGzhu5dpIHPDs3QgKE9taXNzaW9uIEJ1ZykgZOG6q24gxJHhur9uIHRo4bqjbSBo4buNYSBk4buvIGxp4buHdS4NCg0KIyMjIDIuNC4gUHVyZSBGdW5jdGlvbnMsIFJlZmVyZW50aWFsIFRyYW5zcGFyZW5jeSAmIFNpZGUgRWZmZWN0cw0KLSAqKkLhuqNuIGNo4bqldCBr4bu5IHRodeG6rXQqKjoNCiAgLSAqKlB1cmUgRnVuY3Rpb24gKEjDoG0gdGh14bqnbiB0w7p5KSoqOiBN4buZdCBow6BtIHRvw6FuIGjhu41jIHRo4buPYSBtw6NuIGhhaSB0acOqdSBjaHXhuqluIGLhuqV0IGJp4bq/bjoNCiAgICAxLiAqKlJlZmVyZW50aWFsIFRyYW5zcGFyZW5jeSAoVMOtbmggbWluaCBi4bqhY2ggdGhhbSBjaGnhur91KSoqOiBW4bubaSBjw7luZyBt4buZdCBi4buZIHRoYW0gc+G7kSDEkeG6p3UgdsOgbywgaMOgbSBsdcO0biB0cuG6oyB24buBIGPDuW5nIG3hu5l0IGvhur90IHF14bqjIGR1eSBuaOG6pXQg4bufIG3hu41pIHRo4budaSDEkWnhu4NtLCBjaG8gcGjDqXAgdGhheSB0aOG6vyBs4budaSBn4buNaSBow6BtIGLhurFuZyBnacOhIHRy4buLIHRy4bqjIHbhu4EgY+G7p2EgbsOzIG3DoCBraMO0bmcgbMOgbSDEkeG7lWkgdMOtbmggxJHDum5nIMSR4bqvbiBj4bunYSBjaMawxqFuZyB0csOsbmguDQogICAgMi4gKipObyBTaWRlIEVmZmVjdHMgKEtow7RuZyBjw7MgdMOhYyBk4bulbmcgcGjhu6UgbmfhuqdtKSoqOiBIw6BtIGtow7RuZyDEkeG7mXQgYmnhur9uIChtdXRhdGUpIGLhuqV0IGvhu7MgdHLhuqFuZyB0aMOhaSBuw6BvIGLDqm4gbmdvw6BpIHBo4bqhbSB2aSBj4bulYyBi4buZIGPhu6dhIG7Dszoga2jDtG5nIHPhu61hIGJp4bq/biB0b8OgbiBj4bulYywga2jDtG5nIGdoaSDEkcOoIHRoYW0gc+G7kSB0cnV54buBbiB2w6BvIHF1YSBjb24gdHLhu48vcmVmZXJlbmNlLCBraMO0bmcgdGjhu7FjIGhp4buHbiBJL08gKGdoaSBkaXNrLCBn4buNaSBt4bqhbmcsIGxvZyBjb25zb2xlLCBs4bqleSB0aOG7nWkgZ2lhbiB0aOG7sWMgdOG7qyBjbG9jayBo4buHIHRo4buRbmcpLg0KICAtICoqU2lkZSBFZmZlY3RzIChUw6FjIGThu6VuZyBwaOG7pSBuZ+G6p20pKio6IFZp4buHYyBt4buZdCBow6BtIGzDoG0gdGhheSDEkeG7lWkgbmfhuqdtIHRy4bqhbmcgdGjDoWkgY+G7p2EgY2jGsMahbmcgdHLDrG5oICh2w60gZOG7pSBow6BtIGBib29sIGlzVmFsaWRVc2VyKFVzZXImIHUpYCBuaMawbmcgYsOqbiB0cm9uZyBs4bqhaSBj4bqtcCBuaOG6rXQgYHUubGFzdENoZWNrZWQgPSBub3coKWApLg0KLSAqKkzhu6NpIMOtY2gga2nhur9uIHRyw7pjKio6IEjDoG0gdGh14bqnbiB0w7p5IGPhu7FjIGvhu7MgZOG7hSB2aeG6v3QgVW5pdCBUZXN0IChraMO0bmcgY+G6p24gbW9jay9zdHViIERCIGhheSBOZXR3b3JrKSwgYW4gdG/DoG4gdHV54buHdCDEkeG7kWkgdHLGsOG7m2MgUmFjZSBDb25kaXRpb24gdHJvbmcgbOG6rXAgdHLDrG5oIMSRYSBsdeG7k25nIChUaHJlYWQtc2FmZSBieSBkZXNpZ24pLCB2w6AgZOG7hSBkw6BuZyDDoXAgZOG7pW5nIGPGoSBjaOG6vyBDYWNoaW5nIChNZW1vaXphdGlvbikuDQoNCiMjIyAyLjUuIERlZXAgTmVzdGluZyAmIEFycm93IEFudGktUGF0dGVybiB2cyBHdWFyZCBDbGF1c2VzDQotICoqQuG6o24gY2jhuqV0IGvhu7kgdGh14bqtdCoqOg0KICAtICoqQXJyb3cgQW50aS1QYXR0ZXJuIChIaeG7h24gdMaw4bujbmcgbcWpaSB0w6puIHLhur0gbmjDoW5oKSoqOiBY4bqjeSByYSBraGkgY8OhYyBj4bqldSB0csO6YyBy4bq9IG5ow6FuaCAoYGlmLWVsc2VgKSwgdsOybmcgbOG6t3AgKGBmb3JgLCBgd2hpbGVgKSwgdsOgIGLhuq90IGzhu5dpIChgdHJ5LWNhdGNoYCkgYuG7iyBs4buTbmcgc8OidSB2w6BvIG5oYXUgdOG7qyA0IMSR4bq/biA3IHThuqduZy4gTcOjIG5ndeG7k24gdGjhu6V0IGzhu4EgZOG7k24gZOG6rXAgduG7gSBwaMOtYSBiw6puIHBo4bqjaSB04bqhbyB0aMOgbmggaMOsbmggbcWpaSB0w6puIChgPmApLg0KICAtICoqQ29nbml0aXZlIENvbXBsZXhpdHkqKjogS2hpIHRo4buldCBs4buBIHPDonUsIG7Do28gYuG7mSBs4bqtcCB0csOsbmggdmnDqm4gcGjhuqNpIGR1eSB0csOsIG3hu5l0ICJDYWxsIFN0YWNrIOG6o28iIHRyb25nIMSR4bqndSDEkeG7gyBnaGkgbmjhu5s6ICoiTuG6v3UgdXNlciBraMO0bmcgbnVsbCBWw4AgdXNlciBhY3RpdmUgVsOAIHVzZXIgY8OzIHF1eeG7gW4gVsOAIHTDoGkga2hv4bqjbiDEkeG7pyB0aeG7gW4uLi4iKi4NCiAgLSAqKkd1YXJkIENsYXVzZXMgKE3hu4duaCDEkeG7gSBi4bqjbyB24buHIC8gRWFybHkgRXhpdCkqKjogS+G7uSB0aHXhuq10IMSR4bqjbyBuZ8aw4bujYyDEkWnhu4F1IGtp4buHbiBraeG7g20gdHJhIChJbnZlcnQgQ29uZGl0aW9ucykuIE5nYXkgxJHhuqd1IGjDoG0sIGtp4buDbSB0cmEgbmdheSBjw6FjIHRyxrDhu51uZyBo4bujcCBiacOqbiwgZ2nDoSB0cuG7iyBi4bqldCBo4bujcCBs4buHIGhv4bq3YyBs4buXaSB0aeG7gW0g4bqpbiDEkeG7gyBgcmV0dXJuYCBob+G6t2MgYHRocm93YCBuZ2F5IGzhuq1wIHThu6ljLiBMdeG7k25nIHjhu60gbMO9IGNow61uaCAoSGFwcHkgUGF0aCkgxJHGsOG7o2MgZ2nhu68gcGjhurNuZyBob8OgbiB0b8OgbiDhu58gbeG7qWMgdGjhu6V0IGzhu4EgdGjhuqVwIG5o4bqldCAoSW5kZW50IExldmVsIDAgaG/hurdjIDEpLg0KDQpgYGBtZXJtYWlkDQpmbG93Y2hhcnQgVEQNCiAgICBzdWJncmFwaCBCYWRBcnJvd1BhdHRlcm4gWyJBcnJvdyBBbnRpLVBhdHRlcm4gKERlZXAgTmVzdGluZykiXQ0KICAgICAgICBkaXJlY3Rpb24gVEINCiAgICAgICAgQjFbImlmIChyZXF1ZXN0ICE9IG51bGxwdHIpIl0gLS0+IEIyWyJpZiAocmVxdWVzdC0+aXNWYWxpZCgpKSJdDQogICAgICAgIEIyIC0tPiBCM1siaWYgKGF1dGhTZXJ2aWNlLT52ZXJpZnkocmVxdWVzdC0+dG9rZW4pKSJdDQogICAgICAgIEIzIC0tPiBCNFsiaWYgKHdhbGxldC0+aGFzQmFsYW5jZShyZXF1ZXN0LT5hbW91bnQpKSJdDQogICAgICAgIEI0IC0tPiBCNVsiZXhlY3V0ZVRyYW5zYWN0aW9uKCk7IC8vIEluZGVudCBMZXZlbCA0ISJdDQogICAgZW5kDQoNCiAgICBzdWJncmFwaCBDbGVhbkd1YXJkQ2xhdXNlcyBbIkd1YXJkIENsYXVzZXMgKEZsYXR0ZW5lZCBGbG93KSJdDQogICAgICAgIGRpcmVjdGlvbiBUQg0KICAgICAgICBHMVsiaWYgKCFyZXF1ZXN0KSByZXR1cm4gU3RhdHVzOjpJbnZhbGlkUmVxdWVzdDsiXQ0KICAgICAgICBHMlsiaWYgKCFyZXF1ZXN0LT5pc1ZhbGlkKCkpIHJldHVybiBTdGF0dXM6Ok1hbGZvcm1lZDsiXQ0KICAgICAgICBHM1siaWYgKCFhdXRoU2VydmljZS0+dmVyaWZ5KHJlcXVlc3QtPnRva2VuKSkgcmV0dXJuIFN0YXR1czo6VW5hdXRob3JpemVkOyJdDQogICAgICAgIEc0WyJpZiAoIXdhbGxldC0+aGFzQmFsYW5jZShyZXF1ZXN0LT5hbW91bnQpKSByZXR1cm4gU3RhdHVzOjpJbnN1ZmZpY2llbnRGdW5kczsiXQ0KICAgICAgICBHNVsiZXhlY3V0ZVRyYW5zYWN0aW9uKCk7IC8vIEluZGVudCBMZXZlbCAwIChIYXBweSBQYXRoKSJdDQogICAgICAgIEcxIC0tPiBHMiAtLT4gRzMgLS0+IEc0IC0tPiBHNQ0KICAgIGVuZA0KYGBgDQoNCiMjIyAyLjYuIERlYWQgQ29kZSAmIFVucmVhY2hhYmxlIENvZGUNCi0gKipC4bqjbiBjaOG6pXQga+G7uSB0aHXhuq10Kio6DQogIC0gKipVbnJlYWNoYWJsZSBDb2RlKio6IEPDoWMga2jhu5FpIGzhu4duaCBraMO0bmcgYmFvIGdp4budIGPDsyBsdeG7k25nIMSRaeG7gXUga2hp4buDbiBuw6BvIGNo4bqhbSB04bubaSDEkcaw4bujYyAodsOtIGThu6UgY29kZSBu4bqxbSBzYXUgbOG7h25oIGByZXR1cm5gLCBgdGhyb3dgLCBob+G6t2MgbuG6sW0gdHJvbmcgbmjDoW5oIGBpZiAoZmFsc2UpYCkuIFRyw6xuaCBiacOqbiBk4buLY2ggaGnhu4duIMSR4bqhaSAoYGdjYyAtV3VucmVhY2hhYmxlLWNvZGVgLCBgY2xhbmdgKSBjw7MgdGjhu4MgcGjDoXQgaGnhu4duIHbDoCBsb+G6oWkgYuG7jyBraOG7kWkgbsOgeSBxdWEgcGjDom4gdMOtY2ggQ29udHJvbCBGbG93IEdyYXBoIChEZWFkIENvZGUgRWxpbWluYXRpb24gLSBEQ0UpLg0KICAtICoqRGVhZCBDb2RlIChab21iaWUgQ29kZSkqKjogQ8OhYyBiaeG6v24sIGjDoG0sIHRoYW0gc+G7kSBob+G6t2MgbOG7m3AgduG6q24gxJHGsOG7o2MgYmnDqm4gZOG7i2NoIGjhu6NwIGzhu4cgbmjGsG5nIGtow7RuZyBjw7JuIGLhuqV0IGvhu7MgbsahaSBuw6BvIHRyb25nIHRvw6BuIGLhu5kgZOG7sSDDoW4gdHJp4buHdSBn4buNaSB04bubaSBuw7MuIE7DsyB04buTbiB04bqhaSBuaMawIG3hu5l0IGRpIHTDrWNoIGzhu4tjaCBz4butIGfDonkgaGnhu4N1IGzhuqdtIHLhurFuZyB0w61uaCBuxINuZyDEkcOzIHbhuqtuIMSRYW5nIHbhuq1uIGjDoG5oLg0KLSAqKk5ndXkgY8ahIGjhu4cgdGjhu5FuZyoqOiBU4bqhbyByYSDhuqNvIHTGsOG7n25nIGLhuqNvIG3huq10IGhv4bq3YyBsb2dpYywgbMOgbSBjaOG6rW0gdOG7kWMgxJHhu5kgYnVpbGQsIHbDoCBraGnhur9uIGPDoWMgY8O0bmcgY+G7pSByZWZhY3RvcmluZyB04buRbiBjaGkgcGjDrSBwaMOibiB0w61jaCB2w7Qgw61jaC4NCg0KIyMjIDIuNy4gQ291cGxpbmcgU21lbGxzOiBMb25nIFBhcmFtZXRlciBMaXN0ICYgSW50cm9kdWNlIFBhcmFtZXRlciBPYmplY3QNCi0gKipC4bqjbiBjaOG6pXQga+G7uSB0aHXhuq10Kio6DQogIC0gKipMb25nIFBhcmFtZXRlciBMaXN0Kio6IE3hu5l0IGjDoG0gbmjhuq1uIHThu6sgNSDEkeG6v24gMTAgdGhhbSBz4buRIHLhu51pIHLhuqFjLiBW4bqlbiDEkeG7gSB0cuG7nyBuw6puIGPhu7FjIGvhu7MgbmdoacOqbSB0cuG7jW5nIGtoaSBjw6FjIHRoYW0gc+G7kSBjw7MgY8O5bmcga2nhu4N1IGThu68gbGnhu4d1ICh2w60gZOG7pTogYGNyZWF0ZVVzZXIoc3RyaW5nIGZpcnN0TmFtZSwgc3RyaW5nIGxhc3ROYW1lLCBzdHJpbmcgZW1haWwsIHN0cmluZyBhZGRyZXNzLCBzdHJpbmcgY2l0eSwgc3RyaW5nIHppcClgKS4gQ2jhu4kgY+G6p24gxJHhu5VpIGNo4buXIG5o4bqnbSBoYWkgY2h14buXaSwgdHLDrG5oIGJpw6puIGThu4tjaCBob8OgbiB0b8OgbiBi4bqldCBs4buxYyB0cm9uZyB2aeG7h2MgY+G6o25oIGLDoW8uDQogIC0gKipJbnRyb2R1Y2UgUGFyYW1ldGVyIE9iamVjdCoqOiBHb20gbmjDs20gY8OhYyB0aGFtIHPhu5EgY8OzIHF1YW4gaOG7hyBt4bqtdCB0aGnhur90IHbhu4EgbeG6t3Qgbmfhu68gbmdoxKlhIHRow6BuaCBt4buZdCDEkeG7kWkgdMaw4bujbmcgYuG6pXQgYmnhur9uIGhv4bq3YyBEVE8gKGBVc2VyUmVnaXN0cmF0aW9uUmVxdWVzdGAsIGBHZW9Db29yZGluYXRlYCwgYERhdGVSYW5nZWApLg0KLSAqKkzhu6NpIMOtY2gqKjogR2nhuqNtIHPhu5EgbMaw4bujbmcgdGhhbSBz4buRIHh14buRbmcgY8OybiAxIMSR4buRaSB0xrDhu6NuZyBkdXkgbmjhuqV0LCB04bqhbyB0aeG7gW4gxJHhu4EgxJHhu4MgdGjDqm0gY8OhYyBwaMawxqFuZyB0aOG7qWMgdmFsaWRhdGlvbiBuZ2F5IHRyb25nIMSR4buRaSB0xrDhu6NuZyDEkcOzLCB2w6AgZ2nDunAgQVBJIGThu4UgbeG7nyBy4buZbmcgbcOgIGtow7RuZyBsw6BtIHbhu6EgY2jhu68ga8O9IGjDoG0gKEJhY2t3YXJkIENvbXBhdGliaWxpdHkpLg0KDQojIyMgMi44LiBGZWF0dXJlIEVudnkgJiBJbmFwcHJvcHJpYXRlIEludGltYWN5DQotICoqQuG6o24gY2jhuqV0IGvhu7kgdGh14bqtdCoqOg0KICAtICoqRmVhdHVyZSBFbnZ5IChHaGVuIHThu4sgdMOtbmggbsSDbmcpKio6IE3hu5l0IHBoxrDGoW5nIHRo4bupYyB0aHXhu5ljIGzhu5twIEEgbmjGsG5nIGxpw6puIHThu6VjIGfhu41pIGjDoG5nIGxv4bqhdCBnZXR0ZXJzIGPhu6dhIGzhu5twIEIgxJHhu4MgbOG6pXkgZOG7ryBsaeG7h3UgdMOtbmggdG/DoW4uIMSQaeG7gXUgbsOgeSBjaOG7qW5nIG1pbmggcuG6sW5nIHBoxrDGoW5nIHRo4bupYyDEkcOzIMSRYW5nIMSR4bq3dCBuaOG6p20gY2jhu5cgdsOgICJnaGVuIHThu4siIHbhu5tpIGThu68gbGnhu4d1IGPhu6dhIGzhu5twIEIuICpHaeG6o2kgcGjDoXAqOiBEw7luZyBr4bu5IHRodeG6rXQgYE1vdmUgTWV0aG9kYCDEkeG7gyBjaHV54buDbiB0b8OgbiBi4buZIGhv4bq3YyBt4buZdCBwaOG6p24gbG9naWMgc2FuZyBs4bubcCBCIChUdcOibiB0aOG7pyBuZ3V5w6puIGzDvSAqSW5mb3JtYXRpb24gRXhwZXJ0KikuDQogIC0gKipJbmFwcHJvcHJpYXRlIEludGltYWN5IChUaMOibiBt4bqtdCB0aMOhaSBxdcOhKSoqOiBM4bubcCBBIGJp4bq/dCBxdcOhIHPDonUgdsOgIHBo4bulIHRodeG7mWMgdHLhu7FjIHRp4bq/cCB2w6BvIGPDoWMgdHLGsOG7nW5nIHJpw6puZyB0xrAsIGNoaSB0aeG6v3QgdHJp4buDbiBraGFpIG7hu5lpIHThuqFpIGPhu6dhIGzhu5twIEIgKHZpIHBo4bqhbSBuZ2hpw6ptIHRy4buNbmcgTGF3IG9mIERlbWV0ZXIgLSAqIkNo4buJIG7Ds2kgY2h1eeG7h24gduG7m2kgYuG6oW4gYsOoIGfhuqduIG5o4bqldCIqKS4gS2hpIGzhu5twIEIgdGhheSDEkeG7lWkgY+G6pXUgdHLDumMgYsOqbiB0cm9uZywgbOG7m3AgQSB24buhIHbhu6VuLiAqR2nhuqNpIHBow6FwKjogVGhp4bq/dCBs4bqtcCBjw6FjIGdpYW8gZGnhu4duIMSRw7NuZyBnw7NpIChFbmNhcHN1bGF0aW9uIEludGVyZmFjZXMpLCDDoXAgZOG7pW5nIE1lZGlhdG9yIGhv4bq3YyBEZWxlZ2F0aW9uLg0KDQojIyMgMi45LiBEdXBsaWNhdGVkIENvZGUgKERSWSBQcmluY2lwbGUpICYgU21hbGwgRnVuY3Rpb25zIC8gU2luZ2xlIFJlc3BvbnNpYmlsaXR5DQotICoqQuG6o24gY2jhuqV0IGvhu7kgdGh14bqtdCoqOg0KICAtICoqRHVwbGljYXRlZCBDb2RlIChNw6MgdHLDuW5nIGzhurdwKSoqOiDEkMaw4bujYyBNYXJ0aW4gRm93bGVyIHjhur9wIGzDoCAiw7RuZyB04buVIGPhu6dhIG3hu41pIENvZGUgU21lbGwiLiBUcsO5bmcgbOG6t3AgY8OzIHRo4buDIOG7nyBt4bupYyBi4buBIG3hurd0IChjb3B5LXBhc3RlIG5ndXnDqm4ga2jhu5FpIGzhu4duaCkgaG/hurdjIHRyw7luZyBs4bq3cCBuZ+G7ryBuZ2jEqWEgKG5oaeG7gXUgdGh14bqtdCB0b8OhbiBraMOhYyBuaGF1IGPDuW5nIGdp4bqjaSBxdXnhur90IG3hu5l0IHF1eSB04bqvYyBuZ2hp4buHcCB24bulIHRoZW8gbmjhu69uZyBjw6FjaCBwaMOibiB0w6FuKS4NCiAgLSAqKkRSWSAoRG9uJ3QgUmVwZWF0IFlvdXJzZWxmKSoqOiBLaMO0bmcgY2jhu4kgbMOgIHZp4buHYyB0csOhbmggY29weS1wYXN0ZSBtw6Mgbmd14buTbiwgbcOgIGzDoDogKiJFdmVyeSBwaWVjZSBvZiBrbm93bGVkZ2UgbXVzdCBoYXZlIGEgc2luZ2xlLCB1bmFtYmlndW91cywgYXV0aG9yaXRhdGl2ZSByZXByZXNlbnRhdGlvbiB3aXRoaW4gYSBzeXN0ZW0iKi4NCiAgLSAqKlNtYWxsIEZ1bmN0aW9ucyAmIFNpbmdsZSBSZXNwb25zaWJpbGl0eSBQcmluY2lwbGUgKFNSUCkqKjogTeG7l2kgaMOgbSBjaOG7iSBuw6puIGzDoG0gbeG7mXQgdmnhu4djIGR1eSBuaOG6pXQgdsOgIGzDoG0gbsOzIHRo4bqtdCB4deG6pXQgc+G6r2MgKEZ1bmN0aW9ucyBzaG91bGQgZG8gb25lIHRoaW5nLiBUaGV5IHNob3VsZCBkbyBpdCB3ZWxsLiBUaGV5IHNob3VsZCBkbyBpdCBvbmx5KS4gQ2hp4buBdSBkw6BpIGzDvSB0xrDhu59uZyBj4bunYSBt4buZdCBow6BtIHRyb25nIGPDoWMgaOG7hyB0aOG7kW5nIGhp4buHbiDEkeG6oWkgdGjGsOG7nW5nIGTGsOG7m2kgMjAtMzAgZMOybmcsIGdpw7pwIHRvw6BuIGLhu5kgbuG7mWkgZHVuZyBow6BtIG7hurFtIHRy4buNbiB24bq5biB0cm9uZyBtw6BuIGjDrG5oIGPhu6dhIGzhuq1wIHRyw6xuaCB2acOqbiBtw6Aga2jDtG5nIGPhuqduIGN14buZbiB0cmFuZy4NCg0KLS0tDQoNCiMjIDMuIFRo4buxYyB0aGkgTcOjIG5ndeG7k24gJiBNw7QgcGjhu49uZyBDaHV5w6puIHPDonUgKER1YWwtRW5naW5lIEltcGxlbWVudGF0aW9uKQ0KDQojIyMgMy4xLiBFbmdpbmUgQysrMjA6IENsZWFuIFJlZmFjdG9yaW5nLCBHdWFyZCBDbGF1c2VzICYgUGFyYW1ldGVyIE9iamVjdHMNCkNoxrDGoW5nIHRyw6xuaCBtaW5oIGjhu41hIHZp4buHYyBiaeG6v24gxJHhu5VpIG3DoyBuZ3Xhu5NuIHThu6sgdmkgcGjhuqFtIEFycm93IEFudGktUGF0dGVybiwgTG9uZyBQYXJhbWV0ZXIgTGlzdCB2w6AgU2lkZSBFZmZlY3RzIHNhbmcgY2h14bqpbiBt4buxYyBDKysyMCBoaeG7h24gxJHhuqFpIChz4butIGThu6VuZyBgc3RkOjpvcHRpb25hbGAsIGBzdGQ6OnN0cmluZ192aWV3YCwgU3RydWN0IFBhY2tpbmcsIHbDoCBHdWFyZCBDbGF1c2VzKS4NCg0KYGBgY3BwDQojaW5jbHVkZSA8aW9zdHJlYW0+DQojaW5jbHVkZSA8c3RyaW5nPg0KI2luY2x1ZGUgPHN0cmluZ192aWV3Pg0KI2luY2x1ZGUgPG9wdGlvbmFsPg0KI2luY2x1ZGUgPHZlY3Rvcj4NCiNpbmNsdWRlIDxjaHJvbm8+DQoNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCi8vIDEuIERPTUFJTiBNT0RFTFMgJiBQQVJBTUVURVIgT0JKRUNUUyAoS2jhu60gTG9uZyBQYXJhbWV0ZXIgTGlzdCAmIE1hZ2ljIFR5cGVzKQ0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KDQplbnVtIGNsYXNzIEZsaWdodENsYXNzIDogdWludDhfdCB7DQogICAgRWNvbm9teSwNCiAgICBQcmVtaXVtRWNvbm9teSwNCiAgICBCdXNpbmVzcywNCiAgICBGaXJzdENsYXNzDQp9Ow0KDQpzdHJ1Y3QgRmxpZ2h0RGF0ZSB7DQogICAgdWludDE2X3QgeWVhcjsNCiAgICB1aW50OF90IG1vbnRoOw0KICAgIHVpbnQ4X3QgZGF5Ow0KDQogICAgW1tub2Rpc2NhcmRdXSBjb25zdGV4cHIgYm9vbCBpc1ZhbGlkKCkgY29uc3Qgbm9leGNlcHQgew0KICAgICAgICByZXR1cm4gKHllYXIgPj0gMjAyNiAmJiBtb250aCA+PSAxICYmIG1vbnRoIDw9IDEyICYmIGRheSA+PSAxICYmIGRheSA8PSAzMSk7DQogICAgfQ0KfTsNCg0KLy8gUGFyYW1ldGVyIE9iamVjdCB0aGF5IHRo4bq/IGNobyBkYW5oIHPDoWNoIHRoYW0gc+G7kSBy4budaSBy4bqhYyA3IHBo4bqnbiB04butDQpzdHJ1Y3QgQm9va2luZ1JlcXVlc3Qgew0KICAgIHN0ZDo6c3RyaW5nIG9yaWdpbkFpcnBvcnQ7DQogICAgc3RkOjpzdHJpbmcgZGVzdGluYXRpb25BaXJwb3J0Ow0KICAgIEZsaWdodERhdGUgZGVwYXJ0dXJlRGF0ZTsNCiAgICB1aW50OF90IHJlcXVlc3RlZFNlYXRzezF9Ow0KICAgIEZsaWdodENsYXNzIHNlYXRDbGFzc3tGbGlnaHRDbGFzczo6RWNvbm9teX07DQogICAgYm9vbCBpc1ZpcE1lbWJlcntmYWxzZX07DQp9Ow0KDQpzdHJ1Y3QgQm9va2luZ0NvbmZpcm1hdGlvbiB7DQogICAgc3RkOjpzdHJpbmcgYm9va2luZ1JlZmVyZW5jZTsNCiAgICBkb3VibGUgZmluYWxQcmljZVVzZDsNCiAgICBib29sIGlzQ29uZmlybWVkOw0KfTsNCg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLy8gMi4gUFJPRFVDVElPTiBFTkdJTkU6IFJFRkFDVE9SRUQgRkxJR0hUIEJPT0tJTkcgU0VSVklDRSAoR3VhcmQgQ2xhdXNlcykNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCg0KY2xhc3MgRmxpZ2h0Qm9va2luZ1NlcnZpY2Ugew0KcHJpdmF0ZToNCiAgICBzdGF0aWMgY29uc3RleHByIHVpbnQ4X3Qga01heFNlYXRzUGVyQm9va2luZyA9IDk7DQogICAgc3RhdGljIGNvbnN0ZXhwciBkb3VibGUga0Jhc2VQcmljZVVzZCA9IDI1MC4wOw0KICAgIHN0YXRpYyBjb25zdGV4cHIgZG91YmxlIGtWaXBEaXNjb3VudFJhdGUgPSAwLjE1OyAvLyAxNSUgZGlzY291bnQgZm9yIFZJUA0KDQogICAgLy8gUHVyZSBoZWxwZXI6IFTDrW5oIHRvw6FuIGdpw6EgdsOpIGhvw6BuIHRvw6BuIGtow7RuZyBjw7Mgc2lkZSBlZmZlY3RzDQogICAgW1tub2Rpc2NhcmRdXSBzdGF0aWMgZG91YmxlIGNhbGN1bGF0ZVByaWNlKHVpbnQ4X3Qgc2VhdHMsIEZsaWdodENsYXNzIHNlYXRDbGFzcywgYm9vbCBpc1ZpcCkgbm9leGNlcHQgew0KICAgICAgICBkb3VibGUgbXVsdGlwbGllciA9IDEuMDsNCiAgICAgICAgc3dpdGNoIChzZWF0Q2xhc3MpIHsNCiAgICAgICAgICAgIGNhc2UgRmxpZ2h0Q2xhc3M6OkVjb25vbXk6IG11bHRpcGxpZXIgPSAxLjA7IGJyZWFrOw0KICAgICAgICAgICAgY2FzZSBGbGlnaHRDbGFzczo6UHJlbWl1bUVjb25vbXk6IG11bHRpcGxpZXIgPSAxLjQ7IGJyZWFrOw0KICAgICAgICAgICAgY2FzZSBGbGlnaHRDbGFzczo6QnVzaW5lc3M6IG11bHRpcGxpZXIgPSAyLjU7IGJyZWFrOw0KICAgICAgICAgICAgY2FzZSBGbGlnaHRDbGFzczo6Rmlyc3RDbGFzczogbXVsdGlwbGllciA9IDQuMDsgYnJlYWs7DQogICAgICAgIH0NCg0KICAgICAgICBkb3VibGUgdG90YWwgPSBrQmFzZVByaWNlVXNkICogbXVsdGlwbGllciAqIHNlYXRzOw0KICAgICAgICBpZiAoaXNWaXApIHsNCiAgICAgICAgICAgIHRvdGFsICo9ICgxLjAgLSBrVmlwRGlzY291bnRSYXRlKTsNCiAgICAgICAgfQ0KICAgICAgICByZXR1cm4gdG90YWw7DQogICAgfQ0KDQpwdWJsaWM6DQogICAgLy8gw4FwIGThu6VuZyBHdWFyZCBDbGF1c2VzOiBMw6BtIHBo4bqzbmcgaG/DoG4gdG/DoG4gbHXhu5NuZyBy4bq9IG5ow6FuaCwgcmV0dXJuIHPhu5ttIGtoaSBn4bq3cCBs4buXaQ0KICAgIFtbbm9kaXNjYXJkXV0gc3RkOjpvcHRpb25hbDxCb29raW5nQ29uZmlybWF0aW9uPiBwcm9jZXNzQm9va2luZyhjb25zdCBCb29raW5nUmVxdWVzdCYgcmVxKSBjb25zdCB7DQogICAgICAgIC8vIEd1YXJkIDE6IEtp4buDbSB0cmEgdMOtbmggaOG7o3AgbOG7hyBj4bunYSBzw6JuIGJheQ0KICAgICAgICBpZiAocmVxLm9yaWdpbkFpcnBvcnQuZW1wdHkoKSB8fCByZXEuZGVzdGluYXRpb25BaXJwb3J0LmVtcHR5KCkpIHsNCiAgICAgICAgICAgIHN0ZDo6Y2VyciA8PCAiW0d1YXJkIEZhaWxdIE3DoyBzw6JuIGJheSB4deG6pXQgcGjDoXQgaG/hurdjIGjhuqEgY8Ohbmgga2jDtG5nIMSRxrDhu6NjIMSR4buDIHRy4buRbmcuXG4iOw0KICAgICAgICAgICAgcmV0dXJuIHN0ZDo6bnVsbG9wdDsNCiAgICAgICAgfQ0KDQogICAgICAgIC8vIEd1YXJkIDI6IEtp4buDbSB0cmEgc8OibiBiYXkgdHLDuW5nIGzhurdwDQogICAgICAgIGlmIChyZXEub3JpZ2luQWlycG9ydCA9PSByZXEuZGVzdGluYXRpb25BaXJwb3J0KSB7DQogICAgICAgICAgICBzdGQ6OmNlcnIgPDwgIltHdWFyZCBGYWlsXSDEkGnhu4NtIGto4bufaSBow6BuaCB2w6AgxJFp4buDbSDEkeG6v24ga2jDtG5nIMSRxrDhu6NjIHRyw7luZyBuaGF1ICgiIA0KICAgICAgICAgICAgICAgICAgICAgIDw8IHJlcS5vcmlnaW5BaXJwb3J0IDw8ICIpLlxuIjsNCiAgICAgICAgICAgIHJldHVybiBzdGQ6Om51bGxvcHQ7DQogICAgICAgIH0NCg0KICAgICAgICAvLyBHdWFyZCAzOiBLaeG7g20gdHJhIG5nw6B5IGJheSBo4bujcCBs4buHDQogICAgICAgIGlmICghcmVxLmRlcGFydHVyZURhdGUuaXNWYWxpZCgpKSB7DQogICAgICAgICAgICBzdGQ6OmNlcnIgPDwgIltHdWFyZCBGYWlsXSBOZ8OgeSBiYXkga2jDtG5nIGjhu6NwIGzhu4cgaG/hurdjIG7hurFtIHRyb25nIHF1w6Ega2jhu6kuXG4iOw0KICAgICAgICAgICAgcmV0dXJuIHN0ZDo6bnVsbG9wdDsNCiAgICAgICAgfQ0KDQogICAgICAgIC8vIEd1YXJkIDQ6IEtp4buDbSB0cmEgZ2nhu5tpIGjhuqFuIHPhu5EgZ2jhur8gxJHhurd0DQogICAgICAgIGlmIChyZXEucmVxdWVzdGVkU2VhdHMgPT0gMCB8fCByZXEucmVxdWVzdGVkU2VhdHMgPiBrTWF4U2VhdHNQZXJCb29raW5nKSB7DQogICAgICAgICAgICBzdGQ6OmNlcnIgPDwgIltHdWFyZCBGYWlsXSBT4buRIGdo4bq/IMSR4bq3dCAoIiA8PCBzdGF0aWNfY2FzdDxpbnQ+KHJlcS5yZXF1ZXN0ZWRTZWF0cykgDQogICAgICAgICAgICAgICAgICAgICAgPDwgIikgdsaw4bujdCBxdcOhIHBo4bqhbSB2aSBjaG8gcGjDqXAgKDEgLSAiIDw8IHN0YXRpY19jYXN0PGludD4oa01heFNlYXRzUGVyQm9va2luZykgPDwgIikuXG4iOw0KICAgICAgICAgICAgcmV0dXJuIHN0ZDo6bnVsbG9wdDsNCiAgICAgICAgfQ0KDQogICAgICAgIC8vIEhBUFBZIFBBVEg6IE7hurFtIOG7nyBj4bqlcCB0aOG7pXQgbOG7gSB0aOG6pXAgbmjhuqV0IChJbmRlbnQgTGV2ZWwgMCkNCiAgICAgICAgZG91YmxlIHByaWNlID0gY2FsY3VsYXRlUHJpY2UocmVxLnJlcXVlc3RlZFNlYXRzLCByZXEuc2VhdENsYXNzLCByZXEuaXNWaXBNZW1iZXIpOw0KICAgICAgICBzdGQ6OnN0cmluZyByZWZDb2RlID0gIlZOLSIgKyByZXEub3JpZ2luQWlycG9ydCArIHJlcS5kZXN0aW5hdGlvbkFpcnBvcnQgKyAiLTk5MjgiOw0KDQogICAgICAgIHN0ZDo6Y291dCA8PCAiW0Jvb2tpbmcgU3VjY2Vzc10gVsOpIMSRxrDhu6NjIHh14bqldCB0aMOgbmggY8O0bmcgY2hvICIgPDwgc3RhdGljX2Nhc3Q8aW50PihyZXEucmVxdWVzdGVkU2VhdHMpDQogICAgICAgICAgICAgICAgICA8PCAiIGjDoG5oIGtow6FjaC4gTcOjIMSR4bq3dCB2w6k6ICIgPDwgcmVmQ29kZSA8PCAiIHwgVOG7lW5nIHRp4buBbjogJCIgPDwgcHJpY2UgPDwgIlxuIjsNCg0KICAgICAgICByZXR1cm4gQm9va2luZ0NvbmZpcm1hdGlvbnsNCiAgICAgICAgICAgIC5ib29raW5nUmVmZXJlbmNlID0gc3RkOjptb3ZlKHJlZkNvZGUpLA0KICAgICAgICAgICAgLmZpbmFsUHJpY2VVc2QgPSBwcmljZSwNCiAgICAgICAgICAgIC5pc0NvbmZpcm1lZCA9IHRydWUNCiAgICAgICAgfTsNCiAgICB9DQp9Ow0KDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQovLyAzLiBNQUlOIERSSVZFUiBURVNUDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQppbnQgbWFpbigpIHsNCiAgICBzdGQ6OmNvdXQgPDwgIj09PSBDKysyMCBDT0RFIFFVQUxJVFkgJiBSRUZBQ1RPUklORyBERU1PTlNUUkFUSU9OID09PVxuXG4iOw0KDQogICAgRmxpZ2h0Qm9va2luZ1NlcnZpY2UgYm9va2luZ1NlcnZpY2U7DQoNCiAgICAvLyBL4buLY2ggYuG6o24gMTogVGjhuqV0IGLhuqFpIOG7nyBHdWFyZCBDbGF1c2UgZG8gY8O5bmcgc8OibiBiYXkNCiAgICBzdGQ6OmNvdXQgPDwgIi0tLSBUZXN0IDE6IEPhu5EgdMOsbmggdmkgcGjhuqFtIMSRaeG7gXUga2nhu4duIEd1YXJkIENsYXVzZSAtLS1cbiI7DQogICAgQm9va2luZ1JlcXVlc3QgaW52YWxpZFJlcXsNCiAgICAgICAgLm9yaWdpbkFpcnBvcnQgPSAiSEFOIiwNCiAgICAgICAgLmRlc3RpbmF0aW9uQWlycG9ydCA9ICJIQU4iLA0KICAgICAgICAuZGVwYXJ0dXJlRGF0ZSA9IHsyMDI2LCAxMiwgMX0sDQogICAgICAgIC5yZXF1ZXN0ZWRTZWF0cyA9IDIsDQogICAgICAgIC5zZWF0Q2xhc3MgPSBGbGlnaHRDbGFzczo6RWNvbm9teSwNCiAgICAgICAgLmlzVmlwTWVtYmVyID0gZmFsc2UNCiAgICB9Ow0KICAgIGF1dG8gcmVzMSA9IGJvb2tpbmdTZXJ2aWNlLnByb2Nlc3NCb29raW5nKGludmFsaWRSZXEpOw0KICAgIHN0ZDo6Y291dCA8PCAiUmVzdWx0OiAiIDw8IChyZXMxLmhhc192YWx1ZSgpID8gIkFwcHJvdmVkIiA6ICJSZWplY3RlZCIpIDw8ICJcblxuIjsNCg0KICAgIC8vIEvhu4tjaCBi4bqjbiAyOiBUaMOgbmggY8O0bmcgduG7m2kgSGFwcHkgUGF0aCBwaOG6s25nIHbDoCBz4bqhY2ggc+G6vQ0KICAgIHN0ZDo6Y291dCA8PCAiLS0tIFRlc3QgMjogxJDhurd0IHbDqSBo4bujcCBs4buHIHbhu5tpIFBhcmFtZXRlciBPYmplY3QgLS0tXG4iOw0KICAgIEJvb2tpbmdSZXF1ZXN0IHZhbGlkUmVxew0KICAgICAgICAub3JpZ2luQWlycG9ydCA9ICJTR04iLA0KICAgICAgICAuZGVzdGluYXRpb25BaXJwb3J0ID0gIk5SVCIsDQogICAgICAgIC5kZXBhcnR1cmVEYXRlID0gezIwMjYsIDEyLCAxNX0sDQogICAgICAgIC5yZXF1ZXN0ZWRTZWF0cyA9IDIsDQogICAgICAgIC5zZWF0Q2xhc3MgPSBGbGlnaHRDbGFzczo6QnVzaW5lc3MsDQogICAgICAgIC5pc1ZpcE1lbWJlciA9IHRydWUNCiAgICB9Ow0KICAgIGF1dG8gcmVzMiA9IGJvb2tpbmdTZXJ2aWNlLnByb2Nlc3NCb29raW5nKHZhbGlkUmVxKTsNCiAgICBzdGQ6OmNvdXQgPDwgIlJlc3VsdDogIiA8PCAocmVzMi5oYXNfdmFsdWUoKSA/ICJBcHByb3ZlZCIgOiAiUmVqZWN0ZWQiKSA8PCAiXG4iOw0KDQogICAgcmV0dXJuIDA7DQp9DQpgYGANCg0KLS0tDQoNCiMjIyAzLjIuIEVuZ2luZSBQeXRob24gMy4xMSs6IFB1cmUgRnVuY3Rpb25zIHZzIFNpZGUgRWZmZWN0cyAmIEFudGktUGF0dGVybiBEZXRlY3Rpb24NCk3DtCBwaOG7j25nIGPGoSBjaOG6vyBwaMOhdCBoaeG7h24gc2lkZSBlZmZlY3RzIG5n4bqnbSwgcGjDom4gYmnhu4d0IGdp4buvYSBow6BtIHRodeG6p24gdMO6eSB2w6AgaMOgbSDEkeG7mXQgYmnhur9uIHRy4bqhbmcgdGjDoWksIGvhur90IGjhu6NwIGvhu7kgdGh14bqtdCBEYXRhY2xhc3NlcyB2w6AgR3VhcmQgQ2xhdXNlcy4NCg0KYGBgcHl0aG9uDQoiIiINClB5dGhvbiAzLjExKyBDb2RlIFF1YWxpdHkgJiBBcmNoaXRlY3R1cmUgRW5mb3JjZW1lbnQgRGVtbw0KTWluaCBo4buNYSB0cmnhu4d0IHRpw6p1IFNpZGUgRWZmZWN0cywgUmVmYWN0b3JpbmcgQXJyb3cgQW50aS1QYXR0ZXJuIHbDoCBU4buxIERp4buFbiBHaeG6o2kgTcOjIE5ndeG7k24uDQoiIiINCmZyb20gZGF0YWNsYXNzZXMgaW1wb3J0IGRhdGFjbGFzcywgZmllbGQNCmZyb20gZW51bSBpbXBvcnQgRW51bSwgYXV0bw0KZnJvbSB0eXBpbmcgaW1wb3J0IE9wdGlvbmFsLCBGaW5hbA0KaW1wb3J0IGNvcHkNCg0KY2xhc3MgQWNjb3VudFRpZXIoRW51bSk6DQogICAgU1RBTkRBUkQgPSBhdXRvKCkNCiAgICBHT0xEID0gYXV0bygpDQogICAgUExBVElOVU0gPSBhdXRvKCkNCg0KQGRhdGFjbGFzcyhmcm96ZW49VHJ1ZSkNCmNsYXNzIFRyYW5zYWN0aW9uQ29udGV4dDoNCiAgICAiIiJQYXJhbWV0ZXIgT2JqZWN0IGLhuqV0IGJp4bq/biAoSW1tdXRhYmxlKSBjaOG7kW5nIMSR4buZdCBiaeG6v24gdGhhbSBz4buRIG5nb8OgaSDDvSBtdeG7kW4uIiIiDQogICAgdHJhbnNhY3Rpb25faWQ6IHN0cg0KICAgIGFjY291bnRfaWQ6IHN0cg0KICAgIGFtb3VudF9jZW50czogaW50DQogICAgYWNjb3VudF90aWVyOiBBY2NvdW50VGllcg0KICAgIGlzX2FjdGl2ZTogYm9vbA0KICAgIGlzX2ZyYXVkX2ZsYWdnZWQ6IGJvb2wNCg0KQGRhdGFjbGFzcw0KY2xhc3MgVHJhbnNhY3Rpb25SZXN1bHQ6DQogICAgc3VjY2VzczogYm9vbA0KICAgIGZlZV9jZW50czogaW50DQogICAgbWVzc2FnZTogc3RyDQoNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KIyAxLiBCQUQgSU1QTEVNRU5UQVRJT046IEFSUk9XIFBBVFRFUk4gJiBJTVBVUkUgU0lERSBFRkZFQ1RTIChBbnRpLXBhdHRlcm4pDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCmNsYXNzIEJhZFRyYW5zYWN0aW9uUHJvY2Vzc29yOg0KICAgIGRlZiBfX2luaXRfXyhzZWxmKSAtPiBOb25lOg0KICAgICAgICBzZWxmLmF1ZGl0X2xvZzogbGlzdFtzdHJdID0gW10NCg0KICAgIGRlZiBleGVjdXRlX2JhZChzZWxmLCBjdHg6IFRyYW5zYWN0aW9uQ29udGV4dCwgZ2xvYmFsX3N0YXRlX2RpY3Q6IGRpY3QpIC0+IGJvb2w6DQogICAgICAgICMgQXJyb3cgQW50aS1wYXR0ZXJuOiBUaOG7pXQgbOG7gSA0IHThuqduZyBs4buTbmcgbmhhdQ0KICAgICAgICBpZiBjdHguaXNfYWN0aXZlOg0KICAgICAgICAgICAgaWYgbm90IGN0eC5pc19mcmF1ZF9mbGFnZ2VkOg0KICAgICAgICAgICAgICAgIGlmIGN0eC5hbW91bnRfY2VudHMgPiAwOg0KICAgICAgICAgICAgICAgICAgICBpZiBjdHguYW1vdW50X2NlbnRzIDw9IDFfMDAwXzAwMDoNCiAgICAgICAgICAgICAgICAgICAgICAgICMgSElEREVOIFNJREUgRUZGRUNUOiDEkOG7mXQgYmnhur9uIGRpY3Rpb25hcnkgdG/DoG4gY+G7pWMgdHJ1eeG7gW4gdOG7qyBuZ2/DoGkgdsOgbyENCiAgICAgICAgICAgICAgICAgICAgICAgIGdsb2JhbF9zdGF0ZV9kaWN0WyJsYXN0X3Byb2Nlc3NlZF9hY2NvdW50Il0gPSBjdHguYWNjb3VudF9pZA0KICAgICAgICAgICAgICAgICAgICAgICAgc2VsZi5hdWRpdF9sb2cuYXBwZW5kKGYiUHJvY2Vzc2VkIHtjdHgudHJhbnNhY3Rpb25faWR9IikNCiAgICAgICAgICAgICAgICAgICAgICAgIHJldHVybiBUcnVlDQogICAgICAgICAgICAgICAgICAgIGVsc2U6DQogICAgICAgICAgICAgICAgICAgICAgICByZXR1cm4gRmFsc2UNCiAgICAgICAgICAgICAgICBlbHNlOg0KICAgICAgICAgICAgICAgICAgICByZXR1cm4gRmFsc2UNCiAgICAgICAgICAgIGVsc2U6DQogICAgICAgICAgICAgICAgcmV0dXJuIEZhbHNlDQogICAgICAgIGVsc2U6DQogICAgICAgICAgICByZXR1cm4gRmFsc2UNCg0KIyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQojIDIuIENMRUFOIElNUExFTUVOVEFUSU9OOiBQVVJFIExPR0lDICYgR1VBUkQgQ0xBVVNFUyAoUHJvZHVjdGlvbiBHcmFkZSkNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KY2xhc3MgQ2xlYW5UcmFuc2FjdGlvblByb2Nlc3NvcjoNCiAgICBNQVhfVFJBTlNBQ1RJT05fQ0VOVFM6IEZpbmFsW2ludF0gPSAxXzAwMF8wMDAgIyBI4bqxbmcgc+G7kSDEkeG7i25oIGRhbmggdGhheSBjaG8gTWFnaWMgTnVtYmVyDQoNCiAgICBAc3RhdGljbWV0aG9kDQogICAgZGVmIGNhbGN1bGF0ZV9mZWVfcHVyZShhbW91bnRfY2VudHM6IGludCwgdGllcjogQWNjb3VudFRpZXIpIC0+IGludDoNCiAgICAgICAgIiIiDQogICAgICAgIFB1cmUgRnVuY3Rpb246IEhvw6BuIHRvw6BuIGtow7RuZyBwaOG7pSB0aHXhu5ljIHRy4bqhbmcgdGjDoWkgbmdvw6BpLCBraMO0bmcgY8OzIFNpZGUgRWZmZWN0Lg0KICAgICAgICBSZWZlcmVudGlhbCBUcmFuc3BhcmVuY3k6IEx1w7RuIHRy4bqjIHbhu4EgY8O5bmcga+G6v3QgcXXhuqMgduG7m2kgY8O5bmcgxJHhu5FpIHPhu5EuDQogICAgICAgICIiIg0KICAgICAgICBmZWVfbXVsdGlwbGllcnMgPSB7DQogICAgICAgICAgICBBY2NvdW50VGllci5TVEFOREFSRDogMC4wMiwgIyAyLjAlDQogICAgICAgICAgICBBY2NvdW50VGllci5HT0xEOiAwLjAxLCAgICAgIyAxLjAlDQogICAgICAgICAgICBBY2NvdW50VGllci5QTEFUSU5VTTogMC4wMDUgIyAwLjUlDQogICAgICAgIH0NCiAgICAgICAgcmV0dXJuIGludChhbW91bnRfY2VudHMgKiBmZWVfbXVsdGlwbGllcnNbdGllcl0pDQoNCiAgICBkZWYgcHJvY2Vzc190cmFuc2FjdGlvbihzZWxmLCBjdHg6IFRyYW5zYWN0aW9uQ29udGV4dCkgLT4gVHJhbnNhY3Rpb25SZXN1bHQ6DQogICAgICAgICIiIg0KICAgICAgICBY4butIGzDvSBnaWFvIGThu4tjaCBwaOG6s25nIGLhurFuZyBHdWFyZCBDbGF1c2VzIChFYXJseSBFeGl0KS4NCiAgICAgICAgSGFwcHkgUGF0aCBkdXkgdHLDrCDhu58gbeG7qWMgSW5kZW50IDAuDQogICAgICAgICIiIg0KICAgICAgICAjIEd1YXJkIDE6IFRy4bqhbmcgdGjDoWkgdMOgaSBraG/huqNuDQogICAgICAgIGlmIG5vdCBjdHguaXNfYWN0aXZlOg0KICAgICAgICAgICAgcmV0dXJuIFRyYW5zYWN0aW9uUmVzdWx0KHN1Y2Nlc3M9RmFsc2UsIGZlZV9jZW50cz0wLCBtZXNzYWdlPSJBY2NvdW50IGlzIHN1c3BlbmRlZCBvciBpbmFjdGl2ZSIpDQoNCiAgICAgICAgIyBHdWFyZCAyOiBD4bqjbmggYsOhbyBnaWFuIGzhuq1uDQogICAgICAgIGlmIGN0eC5pc19mcmF1ZF9mbGFnZ2VkOg0KICAgICAgICAgICAgcmV0dXJuIFRyYW5zYWN0aW9uUmVzdWx0KHN1Y2Nlc3M9RmFsc2UsIGZlZV9jZW50cz0wLCBtZXNzYWdlPSJUcmFuc2FjdGlvbiBibG9ja2VkIGJ5IEZyYXVkIERldGVjdGlvbiBFbmdpbmUiKQ0KDQogICAgICAgICMgR3VhcmQgMzogR2nDoSB0cuG7iyB0aGFuaCB0b8OhbiBi4bqldCBo4bujcCBs4buHDQogICAgICAgIGlmIGN0eC5hbW91bnRfY2VudHMgPD0gMDoNCiAgICAgICAgICAgIHJldHVybiBUcmFuc2FjdGlvblJlc3VsdChzdWNjZXNzPUZhbHNlLCBmZWVfY2VudHM9MCwgbWVzc2FnZT0iQW1vdW50IG11c3QgYmUgc3RyaWN0bHkgcG9zaXRpdmUiKQ0KDQogICAgICAgICMgR3VhcmQgNDogVsaw4bujdCB0cuG6p24gZ2lhbyBk4buLY2gNCiAgICAgICAgaWYgY3R4LmFtb3VudF9jZW50cyA+IHNlbGYuTUFYX1RSQU5TQUNUSU9OX0NFTlRTOg0KICAgICAgICAgICAgcmV0dXJuIFRyYW5zYWN0aW9uUmVzdWx0KA0KICAgICAgICAgICAgICAgIHN1Y2Nlc3M9RmFsc2UsIA0KICAgICAgICAgICAgICAgIGZlZV9jZW50cz0wLCANCiAgICAgICAgICAgICAgICBtZXNzYWdlPWYiQW1vdW50IGV4Y2VlZHMgbWF4aW11bSBzaW5nbGUgdHJhbnNmZXIgbGltaXQgKHtzZWxmLk1BWF9UUkFOU0FDVElPTl9DRU5UU30gY2VudHMpIg0KICAgICAgICAgICAgKQ0KDQogICAgICAgICMgSEFQUFkgUEFUSCAoRmxhdHRlbmVkLCBraMO0bmcgY8OybiBi4bqldCBr4buzIHThuqduZyBs4buTbmcgbmhhdSBuw6BvKQ0KICAgICAgICBmZWUgPSBzZWxmLmNhbGN1bGF0ZV9mZWVfcHVyZShjdHguYW1vdW50X2NlbnRzLCBjdHguYWNjb3VudF90aWVyKQ0KICAgICAgICByZXR1cm4gVHJhbnNhY3Rpb25SZXN1bHQoDQogICAgICAgICAgICBzdWNjZXNzPVRydWUsIA0KICAgICAgICAgICAgZmVlX2NlbnRzPWZlZSwgDQogICAgICAgICAgICBtZXNzYWdlPWYiVHJhbnNhY3Rpb24ge2N0eC50cmFuc2FjdGlvbl9pZH0gYXBwcm92ZWQuIEZlZSBhcHBsaWVkOiB7ZmVlfSBjZW50cy4iDQogICAgICAgICkNCg0KIyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQojIDMuIFZFUklGSUNBVElPTiAmIFRFU1QgSEFSTkVTUw0KIyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQppZiBfX25hbWVfXyA9PSAiX19tYWluX18iOg0KICAgIHByaW50KCI9PT0gUFlUSE9OIDMuMTErIENPREUgUVVBTElUWSAmIFBVUklUWSBCRU5DSE1BUksgPT09XG4iKQ0KICAgIA0KICAgIGNsZWFuX2VuZ2luZSA9IENsZWFuVHJhbnNhY3Rpb25Qcm9jZXNzb3IoKQ0KDQogICAgIyBL4buLY2ggYuG6o24gMTogVmkgcGjhuqFtIGdpYW4gbOG6rW4gKEvDrWNoIGhv4bqhdCBHdWFyZCBDbGF1c2UgMikNCiAgICBmcmF1ZF90eCA9IFRyYW5zYWN0aW9uQ29udGV4dCgNCiAgICAgICAgdHJhbnNhY3Rpb25faWQ9IlRYLUZBSUwtMDEiLA0KICAgICAgICBhY2NvdW50X2lkPSJBQ0MtODgzIiwNCiAgICAgICAgYW1vdW50X2NlbnRzPTUwXzAwMCwNCiAgICAgICAgYWNjb3VudF90aWVyPUFjY291bnRUaWVyLkdPTEQsDQogICAgICAgIGlzX2FjdGl2ZT1UcnVlLA0KICAgICAgICBpc19mcmF1ZF9mbGFnZ2VkPVRydWUNCiAgICApDQogICAgcmVzdWx0MSA9IGNsZWFuX2VuZ2luZS5wcm9jZXNzX3RyYW5zYWN0aW9uKGZyYXVkX3R4KQ0KICAgIHByaW50KGYiW1Rlc3QgMSBHdWFyZCBUZXN0XSBTdWNjZXNzOiB7cmVzdWx0MS5zdWNjZXNzfSB8IE1zZzoge3Jlc3VsdDEubWVzc2FnZX0iKQ0KDQogICAgIyBL4buLY2ggYuG6o24gMjogR2lhbyBk4buLY2ggdGjDoG5oIGPDtG5nIChIYXBweSBQYXRoKQ0KICAgIHZhbGlkX3R4ID0gVHJhbnNhY3Rpb25Db250ZXh0KA0KICAgICAgICB0cmFuc2FjdGlvbl9pZD0iVFgtT0stOTkiLA0KICAgICAgICBhY2NvdW50X2lkPSJBQ0MtMTA0IiwNCiAgICAgICAgYW1vdW50X2NlbnRzPTIwMF8wMDAsDQogICAgICAgIGFjY291bnRfdGllcj1BY2NvdW50VGllci5QTEFUSU5VTSwNCiAgICAgICAgaXNfYWN0aXZlPVRydWUsDQogICAgICAgIGlzX2ZyYXVkX2ZsYWdnZWQ9RmFsc2UNCiAgICApDQogICAgcmVzdWx0MiA9IGNsZWFuX2VuZ2luZS5wcm9jZXNzX3RyYW5zYWN0aW9uKHZhbGlkX3R4KQ0KICAgIHByaW50KGYiW1Rlc3QgMiBIYXBweSBQYXRoXSBTdWNjZXNzOiB7cmVzdWx0Mi5zdWNjZXNzfSB8IEZlZToge3Jlc3VsdDIuZmVlX2NlbnRzfSBjZW50cyB8IE1zZzoge3Jlc3VsdDIubWVzc2FnZX0iKQ0KYGBgDQoNCiMjIyAzLjMuIEdp4bqjIGzhuq1wIFRlcm1pbmFsIE91dHB1dA0KYGBgdGV4dA0KPT09IEMrKzIwIENPREUgUVVBTElUWSAmIFJFRkFDVE9SSU5HIERFTU9OU1RSQVRJT04gPT09DQoNCi0tLSBUZXN0IDE6IEPhu5EgdMOsbmggdmkgcGjhuqFtIMSRaeG7gXUga2nhu4duIEd1YXJkIENsYXVzZSAtLS0NCltHdWFyZCBGYWlsXSDEkGnhu4NtIGto4bufaSBow6BuaCB2w6AgxJFp4buDbSDEkeG6v24ga2jDtG5nIMSRxrDhu6NjIHRyw7luZyBuaGF1IChIQU4pLg0KUmVzdWx0OiBSZWplY3RlZA0KDQotLS0gVGVzdCAyOiDEkOG6t3QgdsOpIGjhu6NwIGzhu4cgduG7m2kgUGFyYW1ldGVyIE9iamVjdCAtLS0NCltCb29raW5nIFN1Y2Nlc3NdIFbDqSDEkcaw4bujYyB4deG6pXQgdGjDoG5oIGPDtG5nIGNobyAyIGjDoG5oIGtow6FjaC4gTcOjIMSR4bq3dCB2w6k6IFZOLVNHTk5SVC05OTI4IHwgVOG7lW5nIHRp4buBbjogJDEwNjIuNQ0KUmVzdWx0OiBBcHByb3ZlZA0KDQo9PT0gUFlUSE9OIDMuMTErIENPREUgUVVBTElUWSAmIFBVUklUWSBCRU5DSE1BUksgPT09DQoNCltUZXN0IDEgR3VhcmQgVGVzdF0gU3VjY2VzczogRmFsc2UgfCBNc2c6IFRyYW5zYWN0aW9uIGJsb2NrZWQgYnkgRnJhdWQgRGV0ZWN0aW9uIEVuZ2luZQ0KW1Rlc3QgMiBIYXBweSBQYXRoXSBTdWNjZXNzOiBUcnVlIHwgRmVlOiAxMDAwIGNlbnRzIHwgTXNnOiBUcmFuc2FjdGlvbiBUWC1PSy05OSBhcHByb3ZlZC4gRmVlIGFwcGxpZWQ6IDEwMDAgY2VudHMuDQpgYGANCg0KLS0tDQoNCiMjIDQuIFN5c3RlbXMgRW5naW5lZXJpbmcgJiBQcm9kdWN0aW9uIFBpdGZhbGxzDQoNCiMjIyA0LjEuIFByb2R1Y3Rpb24gRmFpbHVyZSBNb2Rlcw0KMS4gKipM4buXaSBSw7IgUuG7iSBUcuG6oW5nIFRow6FpIGRvIFNpZGUgRWZmZWN0cyBuZ+G6p20gKEhpZGRlbiBTdGF0ZSBNdXRhdGlvbikqKjoNCiAgIC0gKkvhu4tjaCBi4bqjbio6IFRyb25nIGjhu4cgdGjhu5FuZyBCYWNrZW5kIHjhu60gbMO9IMSR4buTbmcgdGjhu51pIChDb25jdXJyZW50IFJlcXVlc3RzKSwgdmnhu4djIG3hu5l0IGjDoG0gbmdoaeG7h3AgduG7pSBz4butYSDEkeG7lWkgdHLhu7FjIHRp4bq/cCBjw6FjIHRodeG7mWMgdMOtbmggY+G7p2EgbeG7mXQgb2JqZWN0IMSRxrDhu6NjIGTDuW5nIGNodW5nIGhv4bq3YyBiaeG6v24gdG/DoG4gY+G7pWMgbcOgIGtow7RuZyBjw7MgY8ahIGNo4bq/IGtow7NhIChMb2NrKSBz4bq9IGThuqtuIMSR4bq/biBSYWNlIENvbmRpdGlvbiwgZ8OieSBzYWkgbOG7h2NoIGThu68gbGnhu4d1IHTDoGkga2hv4bqjbiBuZ8aw4budaSBkw7luZyBuZ2hpw6ptIHRy4buNbmcuDQoyLiAqKiJUw6ogbGnhu4d0IE5o4bqtbiB0aOG7qWMiIHRyb25nIEluY2lkZW50IFJlc3BvbnNlIGRvIEFycm93IEFudGktUGF0dGVybioqOg0KICAgLSAqS+G7i2NoIGLhuqNuKjogS2hpIHjhuqN5IHJhIHPhu7EgY+G7kSBwcm9kdWN0aW9uIHbDoG8gMyBnaeG7nSBzw6FuZywga+G7uSBzxrAgT24tY2FsbCBwaOG6o2kgxJHhu41jIGhp4buDdSBt4buZdCBow6BtIGTDoGkgNDAwIGTDsm5nIHbhu5tpIDYgdOG6p25nIGzhu5NuZyBgaWYtZWxzZWAgbOG6r3QgbMOpby4gRG8ga2jDtG5nIHRo4buDIG7huq9tIGLhuq90IMSRxrDhu6NjIGJp4bq/biBz4buRIOG7nyB04bqnbmcgcuG6vSBuaMOhbmggdGjhu6kgNSwga+G7uSBzxrAgxJHGsGEgcmEgYuG6o24gdsOhIHNhaSBzw7N0LCBiaeG6v24gbOG7l2kgY+G7pWMgYuG7mSB0aMOgbmggdGjhuqNtIGjhu41hIHPhuq1wIHRvw6BuIGjhu4cgdGjhu5FuZy4NCjMuICoqTOG7l2kgU8OzdCBLaGkgU+G7rWEgTWFnaWMgTnVtYmVycyAvIFN0cmluZ3MgKFRoZSBPbWlzc2lvbiBEZWZlY3QpKio6DQogICAtICpL4buLY2ggYuG6o24qOiBLaGkgY+G7lW5nIHRoYW5oIHRvw6FuIGPhuq1wIG5o4bqtdCBwaMOtIGdpYW8gZOG7i2NoIHThu6sgYDIuNSVgIGzDqm4gYDMuMCVgLCBs4bqtcCB0csOsbmggdmnDqm4gdMOsbSB2w6AgdGhheSB0aOG6vyBgMC4wMjVgIOG7nyAxMCB24buLIHRyw60sIG5oxrBuZyBi4buPIHPDs3QgMiB24buLIHRyw60ga2jDoWMgxJHGsOG7o2Mgdmnhur90IGTGsOG7m2kgZOG6oW5nIGBhbW91bnQgKiAyNSAvIDEwMDBgLiBEb2FuaCBuZ2hp4buHcCBi4buLIHRo4bqldCB0aG/DoXQgZG9hbmggdGh1IGjDoG5nIHRow6FuZyB0cuG7nWkgdHLGsOG7m2Mga2hpIGLhu4sga2nhu4NtIHRvw6FuIHBow6F0IGhp4buHbi4NCg0KIyMjIDQuMi4gRGlhZ25vc3RpYyBSZWNpcGVzICYgVG9vbGluZyBTdWl0ZQ0KLSAqKktp4buDbSBzb8OhdCBDb2duaXRpdmUgQ29tcGxleGl0eSB04buxIMSR4buZbmcqKjogVMOtY2ggaOG7o3AgcXV5IHThuq9jIFNvbmFyUXViZSBgY3NoYXJwc3F1aWQ6UzM3NzZgIGhv4bq3YyBgY3BwOlMzNzc2YCB24bubaSBuZ8aw4buhbmcgZ2nhu5tpIGjhuqFuIENvZ25pdGl2ZSBDb21wbGV4aXR5ICRcbGUgMTUkIGNobyBt4buXaSBwaMawxqFuZyB0aOG7qWMgdHJvbmcgQ0kgcGlwZWxpbmUuIELhuqV0IGvhu7MgUFIgbsOgbyB2aSBwaOG6oW0gxJHhu4F1IGLhu4sgY2jhurduIG1lcmdlIHThu7EgxJHhu5luZy4NCi0gKipDbGFuZy1UaWR5IChDKyspKio6DQogIGBgYGJhc2gNCiAgIyBRdcOpdCBtw6Mgbmd14buTbiBDKysgcGjDoXQgaGnhu4duIGPDoWMgduG6pW4gxJHhu4EgduG7gSBNYWdpYyBOdW1iZXJzIHbDoCBSZWFkYWJpbGl0eQ0KICBjbGFuZy10aWR5IHNyYy9GbGlnaHRCb29raW5nLmNwcCAtY2hlY2tzPSdyZWFkYWJpbGl0eS0qLGJ1Z3Byb25lLSosbW9kZXJuaXplLSonIC0tIC1zdGQ9YysrMjANCiAgYGBgDQotICoqRmxha2U4ICYgQnVnYmVhciAoUHl0aG9uKSoqOg0KICBgYGBiYXNoDQogICMgUGjDoXQgaGnhu4duIGPDoWMgbOG7l2kgbOG7k25nIG5oYXUgc8OidSwgYmnhur9uIG11dGFibGUgbMOgbSBt4bq3YyDEkeG7i25oIHbDoCBjb2RlIHNtZWxsDQogIGZsYWtlOCAtLW1heC1jb21wbGV4aXR5PTEwIC0tc2VsZWN0PUMsRSxGLFcsQiBzcmMvDQogIGBgYA0KDQotLS0NCg0KIyMgNS4gQuG6o25nIFNvIHPDoW5oICYgRGVjaXNpb24gTWF0cml4DQoNCnwgQ2hp4buBdSBL4bu5IFRodeG6rXQgfCBBcnJvdyBBbnRpLVBhdHRlcm4gKEzhu5NuZyBTw6J1KSB8IEd1YXJkIENsYXVzZXMgKFJldHVybiBT4bubbSkgfCBQYXJhbWV0ZXIgT2JqZWN0IFBhdHRlcm4gfCBNaWNyby1mdW5jdGlvbnMgKFNpbmdsZSBSZXNwb25zaWJpbGl0eSkgfA0KfCA6LS0tIHwgOi0tLSB8IDotLS0gfCA6LS0tIHwgOi0tLSB8DQp8ICoqQ29nbml0aXZlIExvYWQqKiB8IEPhu7FjIGvhu7MgY2FvIChUaGFuZyDEkWnhu4NtIG7Do28gYuG7mTogOS8xMCkgfCBD4buxYyBr4buzIHRo4bqlcCAoVGhhbmcgxJFp4buDbSBuw6NvIGLhu5k6IDIvMTApIHwgVGjhuqVwIChHb20gbmjDs20gdGjDtG5nIHRpbiBsaeG7gW4gbeG6oWNoKSB8IFLhuqV0IHRo4bqlcCAoSGnhu4N1IGxvZ2ljIHRyb25nIDUgZ2nDonkpIHwNCnwgKirEkOG7mSBLaMOzIEtp4buDbSBUaOG7rSoqIHwgS2jDsyB2aeG6v3QgVW5pdCBUZXN0IChU4buVIGjhu6NwIG5ow6FuaCBiw7luZyBu4buVKSB8IFLhuqV0IGThu4UgKE3hu5dpIEd1YXJkIENsYXVzZSB0xrDGoW5nIOG7qW5nIDEgdGVzdCBjYXNlKSB8IEThu4UgZMOgbmcgdOG6oW8gZml4dHVyZSBnaeG6oyBs4bqtcCBk4buvIGxp4buHdSB8IEThu4UgZMOgbmcgdmnhur90IFVuaXQgVGVzdCDEkeG7mWMgbOG6rXAgaG/DoG4gdG/DoG4gfA0KfCAqKkNoaSBQaMOtIELhuqNvIFRyw6wqKiB8IFLhu6dpIHJvIGjhu5NpIHF1eSAoUmVncmVzc2lvbikgcuG6pXQgY2FvIHwgROG7hSBi4bqjbyB0csOsIHbDoCBi4buVIHN1bmcgxJFp4buBdSBraeG7h24gbeG7m2kgfCBE4buFIG3hu58gcuG7mW5nIHRyxrDhu51uZyBk4buvIGxp4buHdSBraMO0bmcgduG7oSBBUEkgfCBDaGkgcGjDrSBi4bqjbyB0csOsIHRo4bqlcCwgdMOhaSBz4butIGThu6VuZyBjYW8gfA0KfCAqKkhp4buHdSBOxINuZyBSdW50aW1lKiogfCBUxrDGoW5nIMSRxrDGoW5nIChUcsOsbmggYmnDqm4gZOG7i2NoIHThu5FpIMawdSkgfCBUxrDGoW5nIMSRxrDGoW5nIChDw7MgdGjhu4MgaOG7lyB0cuG7oyBCcmFuY2ggUHJlZGljdGlvbiB04buRdCBoxqFuKSB8IEtow7RuZyDEkcOhbmcga+G7gyAoVHLDrG5oIGJpw6puIGThu4tjaCB04buRaSDGsHUgaMOzYSBwYXNzLWJ5LXJlZmVyZW5jZSkgfCBU4buRaSDGsHUgaMOzYSBpbmxpbmluZyBi4bufaSBjb21waWxlciB8DQp8ICoqS2h1eeG6v24gTmdo4buLIFPhu60gROG7pW5nKiogfCDinYwgKipUdXnhu4d0IMSR4buRaSBj4bqlbSB0cm9uZyBQcm9kdWN0aW9uKiogfCDinIUgKipC4bqvdCBideG7mWMgw6FwIGThu6VuZyBjaG8gbeG7jWkgaMOgbSB4w6FjIHRo4buxYyoqIHwg4pyFICoqw4FwIGThu6VuZyBraGkgaMOgbSBjw7MgJFxnZSA0JCB0aGFtIHPhu5EqKiB8IOKchSAqKsOBcCBk4bulbmcgY2hvIG3hu41pIGto4buRaSBs4buHbmggbmdoaeG7h3AgduG7pSoqIHwNCg==