From 193527bd2dea4ee6902c70143a679f452df653b9 Mon Sep 17 00:00:00 2001 From: Nigel Tao Date: Wed, 26 Feb 2020 21:55:01 +1100 Subject: [PATCH] Add script/print-json-token-debug-format.c --- script/print-json-token-debug-format.c | 210 ++++++++++++++++++ test/c/std/json.c | 46 ++-- test/c/testlib/testlib.c | 66 ++++-- test/data/README.md | 104 ++++----- .../data/australian-abc-local-stations.tokens | Bin 0 -> 28384 bytes test/data/json-things.unformatted.tokens | Bin 0 -> 384 bytes 6 files changed, 346 insertions(+), 80 deletions(-) create mode 100644 script/print-json-token-debug-format.c create mode 100644 test/data/australian-abc-local-stations.tokens create mode 100644 test/data/json-things.unformatted.tokens diff --git a/script/print-json-token-debug-format.c b/script/print-json-token-debug-format.c new file mode 100644 index 00000000..851e513f --- /dev/null +++ b/script/print-json-token-debug-format.c @@ -0,0 +1,210 @@ +// Copyright 2020 The Wuffs Authors. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// https://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// ---------------- + +// print-json-token-debug-format.c parses JSON from stdin and prints the +// resulting token stream, eliding any non-essential (e.g. whitespace) tokens. +// +// The output format is only for debugging, and certainly not for long term +// storage. It isn't guaranteed to be stable between versions of this program +// and of the Wuffs standard library. +// +// It prints 16 bytes (4 big-endian uint32's) per token: the token's position +// (total length of all previous tokens), length, major value and minor value. +// Together with the hexadecimal WUFFS_BASE__TOKEN__ETC constants defined in +// token-public.h, this format is somewhat human-readable when piped through a +// hex-dump program (e.g. /usr/bin/hd). +// +// If the input or output is larger than the program's buffers (64 MiB and +// 131072 tokens by default), there may be multiple valid tokenizations of any +// given input. For example, if a source string "abcde" straddles an I/O +// boundary, it may be tokenized as a 5-length complete string or as a 3-length +// incomplete string followed by a 2-length complete string. +// +// A Wuffs token stream, in general, can support inputs more than (1 << 32) +// bytes long, but this program can not, as it tracks the tokens' cumulative +// position as a uint32. + +#include +#include +#include +#include + +// Wuffs ships as a "single file C library" or "header file library" as per +// https://github.com/nothings/stb/blob/master/docs/stb_howto.txt +// +// To use that single file as a "foo.c"-like implementation, instead of a +// "foo.h"-like header, #define WUFFS_IMPLEMENTATION before #include'ing or +// compiling it. +#define WUFFS_IMPLEMENTATION + +// Defining the WUFFS_CONFIG__MODULE* macros are optional, but it lets users of +// release/c/etc.c whitelist which parts of Wuffs to build. That file contains +// the entire Wuffs standard library, implementing a variety of codecs and file +// formats. Without this macro definition, an optimizing compiler or linker may +// very well discard Wuffs code for unused codecs, but listing the Wuffs +// modules we use makes that process explicit. Preprocessing means that such +// code simply isn't compiled. +#define WUFFS_CONFIG__MODULES +#define WUFFS_CONFIG__MODULE__BASE +#define WUFFS_CONFIG__MODULE__JSON + +// If building this program in an environment that doesn't easily accommodate +// relative includes, you can use the script/inline-c-relative-includes.go +// program to generate a stand-alone C++ file. +#include "../release/c/wuffs-unsupported-snapshot.c" + +#ifndef SRC_BUFFER_SIZE +#define SRC_BUFFER_SIZE (64 * 1024 * 1024) +#endif +#ifndef TOKEN_BUFFER_SIZE +#define TOKEN_BUFFER_SIZE (128 * 1024) +#endif + +uint8_t src_buffer[SRC_BUFFER_SIZE]; +wuffs_base__token tok_buffer[TOKEN_BUFFER_SIZE]; + +wuffs_base__io_buffer src; +wuffs_base__token_buffer tok; + +wuffs_json__decoder dec; +wuffs_base__status dec_status; + +static inline void // +store_u32be(uint8_t* p, uint32_t x) { + p[0] = (uint8_t)(x >> 24); + p[1] = (uint8_t)(x >> 16); + p[2] = (uint8_t)(x >> 8); + p[3] = (uint8_t)(x >> 0); +} + +#define TRY(error_msg) \ + do { \ + const char* z = error_msg; \ + if (z) { \ + return z; \ + } \ + } while (false) + +const char* // +read_src() { + if (src.meta.closed) { + return "main: internal error: read requested on a closed source"; + } + wuffs_base__io_buffer__compact(&src); + if (src.meta.wi >= src.data.len) { + return "main: src buffer is full"; + } + size_t n = fread(src.data.ptr + src.meta.wi, sizeof(uint8_t), + src.data.len - src.meta.wi, stdin); + src.meta.wi += n; + src.meta.closed = feof(stdin); + if ((n == 0) && !src.meta.closed) { + return "main: read error"; + } + return NULL; +} + +// ---- + +const char* // +main1(int argc, char** argv) { + src = wuffs_base__make_io_buffer( + wuffs_base__make_slice_u8(src_buffer, SRC_BUFFER_SIZE), + wuffs_base__empty_io_buffer_meta()); + + tok = wuffs_base__make_token_buffer( + wuffs_base__make_slice_token(tok_buffer, TOKEN_BUFFER_SIZE), + wuffs_base__empty_token_buffer_meta()); + + wuffs_base__status init_status = wuffs_json__decoder__initialize( + &dec, sizeof__wuffs_json__decoder(), WUFFS_VERSION, 0); + if (!wuffs_base__status__is_ok(&init_status)) { + return wuffs_base__status__message(&init_status); + } + + uint64_t pos = 0; + while (true) { + wuffs_base__status status = + wuffs_json__decoder__decode_tokens(&dec, &tok, &src); + + while (tok.meta.ri < tok.meta.wi) { + wuffs_base__token* t = &tok.data.ptr[tok.meta.ri++]; + uint64_t len = wuffs_base__token__length(t); + + if (wuffs_base__token__value(t) != 0) { + uint64_t major = wuffs_base__token__value_major(t); + uint64_t minor = wuffs_base__token__value_minor(t); + + uint8_t buf[16]; + store_u32be(&buf[0 * 4], (uint32_t)(pos)); + store_u32be(&buf[1 * 4], (uint32_t)(len)); + store_u32be(&buf[2 * 4], (uint32_t)(major)); + store_u32be(&buf[3 * 4], (uint32_t)(minor)); + const int stdout_fd = 1; + write(stdout_fd, &buf[0], 16); + } + + pos += len; + if (pos > 0xFFFFFFFF) { + return "main: input is too long"; + } + } + + if (status.repr == NULL) { + return NULL; + } else if (status.repr == wuffs_base__suspension__short_read) { + TRY(read_src()); + } else if (status.repr == wuffs_base__suspension__short_write) { + wuffs_base__token_buffer__compact(&tok); + } else { + return wuffs_base__status__message(&status); + } + } +} + +// ---- + +int // +compute_exit_code(const char* status_msg) { + if (!status_msg) { + return 0; + } + size_t n = strnlen(status_msg, 2047); + if (n >= 2047) { + status_msg = "main: internal error: error message is too long"; + n = strnlen(status_msg, 2047); + } + fprintf(stderr, "%s\n", status_msg); + // Return an exit code of 1 for regular (forseen) errors, e.g. badly + // formatted or unsupported input. + // + // Return an exit code of 2 for internal (exceptional) errors, e.g. defensive + // run-time checks found that an internal invariant did not hold. + // + // Automated testing, including badly formatted inputs, can therefore + // discriminate between expected failure (exit code 1) and unexpected failure + // (other non-zero exit codes). Specifically, exit code 2 for internal + // invariant violation, exit code 139 (which is 128 + SIGSEGV on x86_64 + // linux) for a segmentation fault (e.g. null pointer dereference). + return strstr(status_msg, "internal error:") ? 2 : 1; +} + +int // +main(int argc, char** argv) { + const char* z = main1(argc, argv); + int exit_code = compute_exit_code(z); + return exit_code; +} diff --git a/test/c/std/json.c b/test/c/std/json.c index d913d119..f9263713 100644 --- a/test/c/std/json.c +++ b/test/c/std/json.c @@ -201,7 +201,8 @@ test_strconv_parse_number_u64() { // ---------------- Golden Tests golden_test json_australian_abc_gt = { - .src_filename = "test/data/australian-abc-local-stations.json", // + .want_filename = "test/data/australian-abc-local-stations.tokens", // + .src_filename = "test/data/australian-abc-local-stations.json", // }; golden_test json_file_sizes_gt = { @@ -212,6 +213,11 @@ golden_test json_github_tags_gt = { .src_filename = "test/data/github-tags.json", // }; +golden_test json_json_things_unformatted_gt = { + .want_filename = "test/data/json-things.unformatted.tokens", // + .src_filename = "test/data/json-things.unformatted.json", // +}; + golden_test json_nobel_prizes_gt = { .src_filename = "test/data/nobel-prizes.json", // }; @@ -221,24 +227,30 @@ golden_test json_nobel_prizes_gt = { const char* // test_wuffs_json_decode_interface() { CHECK_FOCUS(__func__); - wuffs_json__decoder dec; - CHECK_STATUS("initialize", - wuffs_json__decoder__initialize( - &dec, sizeof dec, WUFFS_VERSION, - WUFFS_INITIALIZE__LEAVE_INTERNAL_BUFFERS_UNINITIALIZED)); - const uint64_t vbc = WUFFS_BASE__TOKEN__VBC__STRUCTURE; - const uint64_t vbd = WUFFS_BASE__TOKEN__VBD__STRUCTURE__POP | - WUFFS_BASE__TOKEN__VBD__STRUCTURE__FROM_LIST | - WUFFS_BASE__TOKEN__VBD__STRUCTURE__TO_NONE; - const uint64_t len = 1; + { + wuffs_json__decoder dec; + CHECK_STATUS("initialize", + wuffs_json__decoder__initialize( + &dec, sizeof dec, WUFFS_VERSION, + WUFFS_INITIALIZE__LEAVE_INTERNAL_BUFFERS_UNINITIALIZED)); + CHECK_STRING(do_test__wuffs_base__token_decoder( + wuffs_json__decoder__upcast_as__wuffs_base__token_decoder(&dec), + &json_json_things_unformatted_gt)); + } - return do_test__wuffs_base__token_decoder( - wuffs_json__decoder__upcast_as__wuffs_base__token_decoder(&dec), - "test/data/github-tags.json", 0, SIZE_MAX, - (vbc << WUFFS_BASE__TOKEN__VALUE_BASE_CATEGORY__SHIFT) | - (vbd << WUFFS_BASE__TOKEN__VALUE_BASE_DETAIL__SHIFT) | - (len << WUFFS_BASE__TOKEN__LENGTH__SHIFT)); + { + wuffs_json__decoder dec; + CHECK_STATUS("initialize", + wuffs_json__decoder__initialize( + &dec, sizeof dec, WUFFS_VERSION, + WUFFS_INITIALIZE__LEAVE_INTERNAL_BUFFERS_UNINITIALIZED)); + CHECK_STRING(do_test__wuffs_base__token_decoder( + wuffs_json__decoder__upcast_as__wuffs_base__token_decoder(&dec), + &json_australian_abc_gt)); + } + + return NULL; } const char* // diff --git a/test/c/testlib/testlib.c b/test/c/testlib/testlib.c index 018ec23a..47755efb 100644 --- a/test/c/testlib/testlib.c +++ b/test/c/testlib/testlib.c @@ -1061,23 +1061,63 @@ do_test__wuffs_base__io_transformer(wuffs_base__io_transformer* b, const char* // do_test__wuffs_base__token_decoder(wuffs_base__token_decoder* b, - const char* src_filename, - size_t src_ri, - size_t src_wi, - uint64_t want_final_token_repr) { - wuffs_base__token_buffer have = ((wuffs_base__token_buffer){ + golden_test* gt) { + wuffs_base__io_buffer have = ((wuffs_base__io_buffer){ + .data = global_have_slice, + }); + wuffs_base__io_buffer want = ((wuffs_base__io_buffer){ + .data = global_want_slice, + }); + wuffs_base__token_buffer tok = ((wuffs_base__token_buffer){ .data = global_have_token_slice, }); wuffs_base__io_buffer src = ((wuffs_base__io_buffer){ .data = global_src_slice, }); - CHECK_STRING(read_file_fragment(&src, src_filename, src_ri, src_wi)); - CHECK_STATUS("decode_tokens", - wuffs_base__token_decoder__decode_tokens(b, &have, &src)); - if ((have.meta.wi > 0) && - (have.data.ptr[have.meta.wi - 1].repr != want_final_token_repr)) { - RETURN_FAIL("final token: have 0x%" PRIX64 ", want 0x%" PRIX64, - have.data.ptr[have.meta.wi - 1].repr, want_final_token_repr); + + if (gt->src_filename) { + CHECK_STRING( + read_file_fragment(&src, gt->src_filename, gt->src_offset0, + gt->src_offset1 ? gt->src_offset1 : UINT64_MAX)); + } else { + src.meta.closed = true; } - return NULL; + + CHECK_STATUS("decode_tokens", + wuffs_base__token_decoder__decode_tokens(b, &tok, &src)); + + uint64_t pos = 0; + while (tok.meta.ri < tok.meta.wi) { + wuffs_base__token* t = &tok.data.ptr[tok.meta.ri++]; + uint64_t len = wuffs_base__token__length(t); + + if (wuffs_base__token__value(t) != 0) { + uint64_t major = wuffs_base__token__value_major(t); + uint64_t minor = wuffs_base__token__value_minor(t); + + if ((have.data.len - have.meta.wi) < 16) { + return "testlib: output is too long"; + } + // This 16-bytes-per-token debug format is the same one used by + // `script/print-json-token-debug-format.c`. + uint8_t* ptr = have.data.ptr + have.meta.wi; + wuffs_base__store_u32be(ptr + (0 * 4), (uint32_t)(pos)); + wuffs_base__store_u32be(ptr + (1 * 4), (uint32_t)(len)); + wuffs_base__store_u32be(ptr + (2 * 4), (uint32_t)(major)); + wuffs_base__store_u32be(ptr + (3 * 4), (uint32_t)(minor)); + have.meta.wi += 16; + } + + pos += len; + if (pos > 0xFFFFFFFF) { + return "testlib: input is too long"; + } + } + + if (gt->want_filename) { + CHECK_STRING(read_file(&want, gt->want_filename)); + } else { + want.meta.closed = true; + } + return check_io_buffers_equal("", &have, &want); } diff --git a/test/data/README.md b/test/data/README.md index 07673c21..d76d3f9a 100644 --- a/test/data/README.md +++ b/test/data/README.md @@ -1,13 +1,14 @@ -Unless otherwise noted, the \*.gz files were generated by the gzip command line -tool and the \*.deflate and \*.zlib versions were then generated by -script/extract-deflate-offsets.go. Similarly, the \*.giflzw files were -generated by script/extract-giflzw.go and the \*.palette and \*.indexes files -were generated by script/extract-palette-indexes.go +Unless otherwise noted, the `*.gz`files were generated by the `gzip` command +line tool and the `*.deflate` and `*.zlib` versions were then generated by +`script/extract-deflate-offsets.go`. Similarly, the `*.giflzw` files were +generated by `script/extract-giflzw.go` and the `*.palette` and `*.indexes` +files were generated by `script/extract-palette-indexes.go`. The `*.tokens` +files were generated by `script/print-json-token-debug-format.c`. -The \*.jpeg files are usually the canonical versions of the test/data images, -and other versions (\*.bmp, \*.gif, \*.png, \*.tiff) were generated by -ImageMagick's convert command line tool. The \*.wbmp versions were generated by -the `script/convert-png-to-wbmp.go` command line tool. The \*.webp versions +The `*.jpeg` files are usually the canonical versions of the test/data images, +and other versions (`*.bmp`, `*.gif`, `*.png`, `*.tiff`) were generated by +ImageMagick's `convert` command line tool. The `*.wbmp` versions were generated +by the `script/convert-png-to-wbmp.go` command line tool. The `*.webp` versions were generated by the cwebp command line tool. --- @@ -15,7 +16,7 @@ were generated by the cwebp command line tool. The artificial directory holds artificially generated test data, often to explicitly test corner cases of various file formats. The files there usually come in families whose names have a common prefix, such as three files -"foo.bar", "foo.bar.qux", "foo.bar.commentary.txt" all prefixed by "foo.bar". +`foo.bar`, `foo.bar.qux`, `foo.bar.commentary.txt` all prefixed by `foo.bar`. The file whose name is that prefix is usually the canonical (typically hand-crafted) file, and the other files are then derived from that. Outside of the artificial directory, the other files in this directory are typically real @@ -23,81 +24,84 @@ world examples of various file formats, or deriviations of them. --- -animated-red-blue.gif is an original animation by Nigel Tao +`animated-red-blue.gif` is an original animation by Nigel Tao . -australian-abc-local-stations.json was crawled from -`http://data.gov.au/geoserver/abc-local-stations/wfs?request=GetFeature&typeName=ckan_d534c0e9_a9bf_487b_ac8f_b7877a09d162&outputFormat=json` +`australian-abc-local-stations.json` was crawled from +[data.gov.au](http://data.gov.au/geoserver/abc-local-stations/wfs?request=GetFeature&typeName=ckan_d534c0e9_a9bf_487b_ac8f_b7877a09d162&outputFormat=json). -bricks-\* are various encodings of an original photo by Nigel Tao +`bricks-*` are various encodings of an original photo by Nigel Tao . -crude-flag.\* is an original animation by Nigel Tao +`crude-flag.*` is an original animation by Nigel Tao . See the `lib/nie` documentation. -file-sizes.json was created by running `script/print-file-sizes-json.go` in +`file-sizes.json` was created by running `script/print-file-sizes-json.go` in this repository's root directory. -gifplayer-muybridge.gif is an original animation by Nigel Tao +`gifplayer-muybridge.gif` is an original animation by Nigel Tao . -harvesters.\* are various encodings of a photo of "The Harvesters" by Pieter +`harvesters.*` are various encodings of a photo of "The Harvesters" by Pieter Bruegel the Elder, held by the Metropolitan Museum of Art. -`http://www.metmuseum.org/art/collection/search/435809` lists that image as in -the public domain. +[www.metmuseum.org](http://www.metmuseum.org/art/collection/search/435809) +lists that image as in the public domain. -github-tags.json was crawled from -`https://api.github.com/repos/google/wuffs/tags` +`github-tags.json` was crawled from +[api.github.com](https://api.github.com/repos/google/wuffs/tags). -hat.\* are various encodings of a photo of "Self-Portrait with a Straw Hat +`hat.*` are various encodings of a photo of "Self-Portrait with a Straw Hat (obverse: The Potato Peeler)" by Vincent van Gogh, held by the Metropolitan -Museum of art. `http://www.metmuseum.org/art/collection/search/436532` lists +Museum of art. +[www.metmuseum.org](http://www.metmuseum.org/art/collection/search/436532) +lists that image as in the public domain. + +`hibiscus.regular.*` are various encodings of a photo of "Hibiscus and Parrots" +by Louis Comfort Tiffany, held by the Metropolitan Museum of Art. +[www.metmuseum.org](http://www.metmuseum.org/art/collection/search/13503) lists that image as in the public domain. -hibiscus.regular.\* are various encodings of a photo of "Hibiscus and Parrots" -by Louis Comfort Tiffany, held by the Metropolitan Museum of Art. -`http://www.metmuseum.org/art/collection/search/13503` lists that image as in -the public domain. - -hibiscus.primitive.\* is the result of running the hibiscus.regular.png image -through `github.com/fogleman/primitive` and other programs: +`hibiscus.primitive.*` is the result of running the `hibiscus.regular.png` +image through `github.com/fogleman/primitive` and other programs: - `primitive -i hibiscus.regular.png -o hibiscus.primitive.svg -s 442 -n 32` - `inkscape -z -e hibiscus.primitive.png hibiscus.primitive.svg` - Various invocations of `convert` and `cwebp` -hippopotamus.\* are various encodings of a cropping of a photo of "Hippopotamus -(William)", held by the Metropolitan Museum of Art. -`http://www.metmuseum.org/art/collection/search/544227` lists that image as in -the public domain. +`hippopotamus.*` are various encodings of a cropping of a photo of +"Hippopotamus (William)", held by the Metropolitan Museum of Art. +[www.metmuseum.org](http://www.metmuseum.org/art/collection/search/544227) +lists that image as in the public domain. -`http://www.metmuseum.org/about-the-met/policies-and-documents/image-resources` +[www.metmuseum.org](http://www.metmuseum.org/about-the-met/policies-and-documents/image-resources) says that "You are welcome to use images of artworks in The Met collection that the Museum believes to be in the public domain, or those to which the Museum waives any copyright it might have, for any purpose, including commercial and noncommercial use, free of charge and without requiring permission from the Museum." -json-things.\* are original JSON objects by Nigel Tao . +`json-things.*` are original JSON objects by Nigel Tao . -midsummer.txt is an excerpt of Shakespeare's "A Midsummer Night's Dream", -copied from `http://shakespeare.mit.edu/midsummer/midsummer.1.1.html` +`midsummer.txt` is an excerpt of Shakespeare's "A Midsummer Night's Dream", +copied from +[shakespeare.mit.edu](http://shakespeare.mit.edu/midsummer/midsummer.1.1.html). -muybridge.gif is derived from -`https://en.wikipedia.org/wiki/File:Muybridge_race_horse_animated.gif` which is -in the public domain. +`muybridge.gif` is derived from +[en.wikipedia.org](https://en.wikipedia.org/wiki/File:Muybridge_race_horse_animated.gif) +which is in the public domain. -nobel-prizes.json was crawled from `http://api.nobelprize.org/v1/prize.json` +`nobel-prizes.json` was crawled from +[api.nobelprize.org](http://api.nobelprize.org/v1/prize.json). -pi.txt contains the digits of pi. +`pi.txt` contains the digits of pi. -pjw-thumbnail.\* are various encodings of an image derived from an iconic, +`pjw-thumbnail.*` are various encodings of an image derived from an iconic, original photo of Peter J. Weinberger by Rob Pike . -romeo.txt is an excerpt of Shakespeare's "Romeo and Juliet", copied from -`http://shakespeare.mit.edu/romeo_juliet/romeo_juliet.2.2.html` +`romeo.txt` is an excerpt of Shakespeare's "Romeo and Juliet", copied from +[shakespeare.mit.edu](http://shakespeare.mit.edu/romeo_juliet/romeo_juliet.2.2.html). -romeo.txt.fixed-huff.deflate was derived from romeo.txt by a custom program to -use fixed (not dynamic) Huffman tables for the deflate encoding. +`romeo.txt.fixed-huff.deflate` was derived from `romeo.txt` by a custom program +to use fixed (not dynamic) Huffman tables for the deflate encoding. -sheep-more.rac is a RAC-compression of original text by Nigel Tao +`sheep-more.rac` is a RAC-compression of original text by Nigel Tao . diff --git a/test/data/australian-abc-local-stations.tokens b/test/data/australian-abc-local-stations.tokens new file mode 100644 index 0000000000000000000000000000000000000000..97ffa61e245e29794d61b1a3939edb7e54ceb1be GIT binary patch literal 28384 zcmZR807fv?;2_Arz`(@7z`z3LD=;ZAFfed3Fff3`85kgZSq26M4kUSX1_lPGeg#Jc z1_liT-$9Xqfk6w+JVOQs26iO<)=)cP<~uMjFlZym=b_nGfn+|&zA7~H8yOfFSdsL1 zGB7Z3Bk`vp^n=|yoq>UY3oM@i_WL3<{u+dO2PFmuhP6n1Ck6(F4GatnykPy1@Hv3y zp5t)yAo7=y^n=`g6;1se1_lNpB=bI^n$HLdYfug7#Pfvrdu=D{+ z4@_w3iwTszkkSK_Flu^Wl0Z!lOm3*@fhhoCpMxU<15*%ccrrzzrU#}()bL>fr7uvJ zGB7lN(gRaIJifr`feDnpkkSVeD7>KRLFs|170G^(e>+g)i)jX$d*;K<2d4+7)kyk5 z?gynWr2NOUg@J)V6cOG`XVA^_(*sK`YIE7#LV4BJn}~pMn}+EKAVb1B!o87{UCv9Z5gP{+(#*LFEf5 z3}NceqnUr7fq_925nrsJvJVu-Q1z@bsQzUImCs1&ffbY%jF9vfqLvS=pzr|23Cz5? zsOf=q6KeUu`U=TEP7DmJuMvDudSHEv;DgEs*7vCXW&MU~KO4wtNa=wMRMsP<2R38W z@_`Lh9zx?2R6elTqnghKDo;RWK>fq!hZ;U?(Fpf}$_F-3`hui4aC%?^r6*)QC_TaK zQ(|CXLn>b!oER9`K;em0U$BAdE2Q+#2Fia(>46QDeqiP~GBB`#>MvyVXyMNW3V&qt z522<9ws)xI1KWR8|FVPhBBcj*P+Y5l0v%HSvwNV%2RkVLfz&|5kG%vnJ+Oo7Ur?C? zlRt5=WME)Fh8kb&pz;Q(d|svnddI6&zQWCsHSI6ZLKp_UIE zpzwmK2h|rGpz;>RcVb}R@IlSL9H8`t6u%tFaPuJU2h~q7{f-O_9H8`stRB=pLW)0* zE;RFJLEC6B|A6Xqr1F8|8k+iNsPzZO4+aJXP`d@HpA%GGAjJnKC_jPPeK7ef)bzkv z&%nT7iAYbJpz;moA14L|&RvN32c-wjJqSLieBj)N8eg0s_aoa6Di4v$2hJ;~?FTN9 z98!AV0+ppO`yCk=xIkfn6rNn5`UojKaDmbXQhMM5m7h@kp!C26N_$A@fy)dYf8g}N z1!~_y)q~Ol7bq-Yd?yA5E*I4B=L$jfFBhmhf|w6Z4_xU;;RAAiCYt&J)bQs5wO2rS z92!4dQyCZ-ED-U*bpf?};ChH!K5&7`XQcGS4RSkD`+ytNA3%x^Zcuw4seIrLMs*K& z25No5y#UESP7Dm(3lV%!df;A+;Dgcw_fk~468-R|16zv^~iKYCA*X3mpGEp!9>x2Za|@Jt#f!fZFyj zz7qoj4=6n$#TO5#tp&0Z8h<>XJ_y7-aC+bY)n73EjtmSup!PAc`f$|z%mYd<$mUlv zFfbsM_dKBf5GYT;?Awf*K6pUoHBx%u0hJ%f`a$&zQhe}&+J~Ti6x2LkJ=FBT>&(Ew zV1-DJymd(N;l#ke3o1XL{sW~4UQqoB<%7}#Z!>Cq@q)@fWcxw&DX0v9**_CCJ@A71 zYe?k-??oj09T^ySLH#$R@Z`OPnjUx`q2?D}P=0~B4^%$zen2e`cz>hv`9Nh2R6Qs? z@PQgUFuoH510N{-km8F^64k$apgucNdf)@~4`KQp85sCL;f>^eK2YC591-4p{;1^- zUp#95B5B#9=2APl4 zp9ZA|eo%gb+3&=_AOH$Kr1T&F3OgkC2!PTDQhE>owP#@Z9T^w|Kyibt9+W;nZ6v7s z1zb_ngFqkH)KL~=#3Xq?m z>IFe6JAgKKV^N$k)gJ2ON{z2t~AgDbGlUHP55G+H@FM_qG_6xS7rU$_u1_lOD z9)j5qsy~p@gCMB=0W;r`fk6;dejtUXASitxr3XP!`G{0s2tGz~FG&9r=$IQcJqUu@ z>yY>Z*B^qQ`~$O3iGe}zCqh4{JuL{TpODgn5U72FJs+(cvIWjN^ zfx;eHJt#j4Aj$_JP+mkfA2hxMDs!OWBLwR2Af*Q(P0@)9$pODmxfXW+Cm_y@3 z1XNZanJ)qwpFtXb5COG6km6qiH2wxoPLTejND6BGAp**upfU<(J}5kq%4?Ao3=9mQ zGzyakmB&csg9xa-ic~&`N+X4j69a=NX#4{jKA`jCeG#PeB?ijRNbLhLP=5v~ zKEy!vKd4O&jSn$U{}w4dh=KAKsEq@Ye~RQECk6&Fkb9xw14<8KFOcLF85qPs^)-@z z#X#fn$o7Ns2U2E&+g4!ppkJ`Tw2c=D@eW39NaZq`RWWG44ZbV8C;voMcl@H>e z_B&KRsQn-wfm$AjBgPBB=|dcCJW3o?K120`(t|iCJtD=IIH*01>>jl7C~;7E2h;D! zz#xt`9wiQ{?~%;|jb|hCLFE}zc`ptMf28yv{vEY{Apy!uNa;aBih+Rv)JK4ZuLP)k zMv4y!(0BtV55wd^`3EUINPy}aP#S~D-$sgWCk6%y(D)J5f1varaSusek%2+t0c!g} z;yG%4ApuGsNa;ZWl>U*@gCwYI1NjMRza%JqK)=e_)ZKAlA!Sfr1+97NA<5Hs67oa z51d~mLH#S3en$odNl<$U+5MAI+l!K*@f~FILFEf5%|pXO3KZ8!=|Kt4<7b!hRbu%z9fXW=0{7TgJgA}N|1C8Oq%y(p9kOqw( zBAG7@YOf%r2We1wfRrAjk>V4S9;89_5hT9A=|LJ)ej@WhkC=X_&p^4!0AI4H2w^;Pl#u$G9NUa zhZLW(p!P0OdXNS6pFn*aSa^W)FH(At1KEX?p5#E~1yX#-f$|rqjDhNx%SJ69LP`(vps@|8eo%Ul2iXOQFL3$b-gvVfq~z8010qHL`k8dj!-+g@%_rD1U3Lv+D`Y13yDE}bEhXSZQhLj!@K=a2) z<%2>o>Ug;VD1E~GSb|D1y=lR6i&^D1ypHP#8hS z9~4354Km*ZseV*qU{C~=w^03{^q>gJD@gIB2+Ci`?g7S9Pew`)N}%x(nE8$j3`(H!ASCmZLFEZjdQb+X1rUasuMApm z1Jw^o56Xz~LvZ<^49Yu@_=E64kh7*c#FgU0(oZFp#Sses}JDLtrwI)I=tYnVK;f1DT?R6yfPQ2&9_g9@ns z2IYg&gGv-?`Je(CFF~?j1ynzQ?1Y&Qs(+Evg9>PU5mI_kK~8Uu3=Ar0=}iTc-jLFR z3aCCqN)IZa@(1cZPOtv2 z4Q>2I4K&_@6klqf_(ygRXubnt9ymRygWLi$&yj&a9i$gYy*g+-5@|e29W;IiQUeWt zbx`{TslHGLwP%sigF2}F0je`$>Ou1ZNa;ZxG+zWtV=#Hp`aGogPzSa5kjA6bLFpeU zJ*b2Flb|{is$TTLFqvYlvY7{VERF6 zAEXAx2aT5@r3Wogd4!Z6v_RuUNa;Zfxju4aV9-LVkF-GL5y(w2^FiwekkW$|X#5`P zK2Unl0+mOQ_yVT~ttQm|rxvLH2UQO$AGAQ@bud22|DgFIr1;W8n@`a~q%UxK&;qSb zfawRhAC#Vu!w1x!LN*VSo{;&V@js;etqn2@seI4|#T~>yVEeQ|;fa(Uv_bs|r1>aq z(0D6Sd}xE}7o_x{4az?tGoj(B4Jx0J(t|drKLc_D149F-eXR`|KY;Q<=|TGqBL9KX zgEnZs5XryVpz$hX`$6R?QhLwaQX5LH!4$_|gHb??6fqI-v3# zslTZU3R|S~pbM&xkjfWbQ2!DsK6F9-XC(7=LG?RQde8-x&q(P(7gT=0{Nu#HpbMJ6 zf$~A=K^IhiL;0ZepbKi>B887GsDFuUKPdf!+zgFRT~PlBDLsIy8|3{SdZ4g{neWKJ zpa=3hlKFa|wmDLI&;yOVBBcjCr130Jde8&ae;_lV?FT(j{}P!GDt}@2DKRkUfzlt0 z@5I2M2kK8C#g`svJPX-9i1BZ5de8%bl<^`QD5)Te{S zrvYfZ3fX+n_&F#I!{kBjZKU$S0F*zG`Jnz2QhG1|wO2rS0;=B-6jn&_VF*$S@)JxR zG~bMr9t=V28<6@JhM@U6n17rY7z{z}5hx#&9t=VAAy7UjJs5)OTO|J)g3>p#{h;}G zr1W428qY^c4~C%eSfun|2&z9}<~uSl7=qfr$mWCE{~$lY`~zBl0E%-MA8GsolpYL0 z^Q(~f0@n{lp!OOvAJpD~*{8(7U<4Z9g7KXg7>q#WFH(FNfx;5WJw~AMP>6Zp^k4+) zAHeiGGB6l{#?z72gXWq*a}ZGX8iCqN$mWB}Z%~?q$%EQANbzq3%736Zg~@~J8)QDH zzXj?8z~n*s2`N5|K>Z`6{);ilE~NBe3`!rMG83xb7&Kl6^N$k)gE4aZ48#YuM_}@b z3=GDg^o-4+V^I1*N)N`M_8C%oFb36^Na?}&BvSjtk%7S&)ZRrlAC!KO(t|N5 zKOm(CW6=C6)P11zU<~RnLgEXY9*jZtFQ^R+Eia5g<6Thopz^^ORNlb&P7Dm7;sANS zo(U-ZAi2i`l-D8VgVTcvXzl@~-;sgA1XOk-s|WcVDf~@9wj59Xlp1t=es9?U`IBU1R7gUT8t`^`b) z{YdG-9JD?GDLt5j){7#g2XoN)0?d3z1_pCb{e^5kXuJg}J(z>$e~{9HIjH>t)elM! z=AiThi7#+^FbDOgkolnTO{jWM`CtxeAH(<{|AWSFkiy>_G~R{m9?<+R#5{0%Fb9n< z!1ROM4+?K&^`QP5C=Wuz+X6KHj%2Guc(t`zP{Vk|X1l4b8fK*;PF)&zy`m<2~fzpE|Qu+X; z2TM@;K=Q98s4aqIza^-Dh?E{ILHA@0I-az6DoE|Je?OUY!!V=UzgQ^Fm2TRcW0E`dvKPY`5#g`>o z{bdQNzaZv=(}N|bJcj9aWMHra&Hp32A5@A@O#`~c*C zP<;jp6KH<12Fr59xLLGyb^?L8Y% zc!J^ps@?|FRz&iz4XCb1N)I-m{v#;NVd_ESDM;~Q1ImA(F)WxoX#5rwhcG^9ycSgE z!}w_9Q8u9R4eCEodayz64=OS+*nrxvNdC0}^#_sdM;ni_1*t_!54NE41}Qz*g33Cm zeW3Ee7Bn6J(gSs$Ehv8=r3YKI@hDqR`vs~WlpbtB<55WQZwnd^K<0zy1EA_b>A@D1 zzF>SO1_oPD`x+^}Y(ewU$nF8P{~_jq(}OK?f8CLR!4{Msk=29NPa*X$Y(eEWviYF) zG*W!pg4Pcqr3X-TjC|gO9Y_u-J=lTTil9CWG`#FU`3WgL>_F>9k2ep4;d?yA5drNjNdp#C^0 z&qL$O9#p;{n-4k<0I9yP2jxFdoWsVah!0A?FnL7=1_!kI)B#kVBHIs2Ur6b} z0hE4_(t{(Y{y|C)j-a+T%zQ@%21n3(f28nq1mzv1^xz2U|0AUbN048j`a$Wz5tM#F zbuzSn=?GdY0*OCx`fvobZ=vcz>A?{xJ%PsS9YOs+r1)|K)n~}=0i_p+dEoTm2wKko zGY{l`P=6g+J!m`_G{yl9Z%5F16UgR+$`7Rc>xec!=?LmSBBc*U(0B||dT<2gH;|v9 z<~xDPU!?eO0+qi=^CM26`7fmO-~^iQ0kvUa`qAe1oIvA=Q2&9-2PaVf1?`AaCXKJs{h5(9$^sJ#Q#4=NvA zL2d_yA=JIDps+)7k1MF`hnNRW53Zo}2h;D!z~Bm+FF;lgny^8de{comS7h@+0cWhl(OXzQa~LF0Ew<&P^UKZ5)ORqqBWyO7!s zZlLjYn17rY7~DYZRVW{n9^61{Z=ifodT>L_FK(dxf|MTIK=UJ@FooF%s;`mKgBxf* z9w|MzfyQHD<~uSlxPj&ak;2mrG@g%?9^63vN2Ks^1N9G~`a$Wz4bQhd3A%4cNvfa-UMdEoTm1{%+S=?A$VG=7ex-W?=| z6#nj@u?Qsd-9hasr25?*6dy?G!5!58K}t{Vp!t5J^xzK4pP(`h8s6@p_9{|*xP$5+ zWb;A$eURM)8s7)ixlsKcpt1twX6X2&2dMuG<%80L2Po}8`JnXR0jjHz{ObW~+alTT z0ZLCu>A?fkzC%h69-#dVNa?`?H2wrL-;sgA1C$?-%?Fh)Na?`?)E`7j4<4ZO0@V*n z4<4ZP2}tb+4^a6Fi9c}q@IXpGp!DDYN#va2gT^*^~s^};R!0gk1xh z&j7xDL#Bb<8w&uRbS9}K2mz{1&!Z>@;FRC zXgmq#A14L|U(otKC?Av_e39!%MFs|6wEEExq!!73KTupDr3XJydP7PNexUItr1ani zsxLuifa)tp1_nP+`GORlexULaDLwds(i6xIsQdju<4sWgp!DE}=nsP9-w(9j2@-!0 zKB)f(RS!xJexUjb#&=?1@B_`)BBcjEP<@5$9#DG@Vjeg>_<_cAVERGs2i0H5>OuQi zKz$;ZdqM3PWb;AuYoI<7OdeEzAjQ8wDDIK`>knG*0uqC&_Xq740Ij)%@j>l3r1zASGLFpj?xxeVdzz_f`uaM#^08~FCy9d;MgO~?S z4*{V4RxtBG?g!O>$m&7m6HA)q~PQ5NLf0jPJz25Cj_kMvAW> z(0ntpdqCscNa-O6xqNYCUq4+ewEU!?d529>{{JP5Tv7_@#5DLn*(>Q|)tA{ebb6%1-`K*I-= z9)gkUM@0sPV6^%%7*szZ+Yd@VNa-OMRNf$^hY(O&0AZ;6LO^bV+6QV+hJe;5A%$lM zDE%O%hY(O&M@kPNp!OG3KPWwffaYf*@dYj)LO}Dc$b8Uz2vj{NJ%k{ycXMK32mzHh zNbwZ{%3sLt0hK2Z^T6dp2&jDnGtZHMAp|u4jI171pCgqIA)xXC*?drWjZ{8_fW}{t z;y(nG-;n(a>aQTBhY-+sHd6m26vRe~k5EwAfmC0Fg4VBq!WV8mq2m_@jr1BsPw7(M)f8g{H1`02zdQf@@1H}c5 z@5I0m268J>e1(D16OwzvK;;p{JaBpl1NEn2`W+bpk?ao#m7hrIAskd5 zfx;MOA833WDLsUP(hJOdM+Sy)PPKG9Z2|r z<3AiUo&2i0##^+g0IK9JHw1Zcbx$-fbx`UfdJM1cB}$ofJ3X{7jw z0JUF1X#nP4P<@W<9?*CtQhJC4r4N{YoER7)LGvL{J}5mzg49C!p!5(4DqE2J8wnck zN3uT>ZGBWEs6T|19wI^G_ekj>614sWX1*f>LnLT?3fX*6e;O%0M53*aibN{EKAJtD zA8mb9BxwBrQuz=G%CAV~M}gR&HWM_yqCnw`lpdl$;fc%#t@lSt4^g1}iqyY|0<}+& z;v)(a9!TwnC{X>5lpdl$^B+j6kpMx zzAuvf(V+SqseFhAr6;8H5DjX-Bc+FEQ2PdEz9R!eG-y2sviYF-6jtyCW^njNgT}Lv z@=G*mz67ctlpdl%^S6-r0;h*)ME?-NN2(7&TdF9a4D3fYJ+6 zdWZqF7eRF()V(oi<#i0Gyhf@|VnFEw$vrWk`~j*HVfsPtK?;u;r11t&dWZpyH^Af- z85m+f}fjtmU3pz;LSd{Fy` z6_FldLF-+R(nBnA{RYwxnooqp7dZZ7LE~4*d{BCV*{8(75DV%L!1zuK46&g44de%y zdqMLp$nF7+XF<#Zr-xWj`hn>O*$)~YMOF`5&j@PMz{~@!FF-aQ)L#RQIYH&)K;em$ z9^ycHk<`b5;ua}A#DV%-pgtN*Kj?e`r1*#f)jvq-Ee@1_Kyd<74{ARm^-tnJ^)1Xl zP7Dljp!Ew-J}5oJA+HZqWMGH`^?#838wX17$o7N!LrCc%4m7@nlpf+iZbwQF@u2Y( zsC}URMLei~fMk9=XuKRLJ;a0NOOVn-JShD@^@GZXcu@Zm5?|o-5DzL}k@=wcXsCKn z`4A5(uV8#928MXh_!d(5$AiizWcPsb8^khANC1^DNd8R#^+%D?LjtJ0L`n|{ zp!rv1_k!k^kF*4b=UKpt={TACw*vL1iZ- z{J`lU5!4<+=7Ywwpz1;CArTaQFuoH5Ln5gBLW-|MwEjXOsJ{R)51bwnk<$~%{b=Lu ziJ9`ja3xz|05DA0fL3G#&vl4;(+q zp!kRBcVu8l29?jq>OtcXNb#8r3V&qtLFX5M+FUUEK=}(PJtTv|57|CY`GJ%kl0oG$ z()eNusJumrj}%Z{fK)!DfZPwtV^I52K<+~-A5xI(KPLu;6y*6r5Fb<@!u+emz>oqO zPebxg3Mjom;y(ej43=9fP3JeSkYzzzxP~02z1SXJs92giFn33e& z!E6u#F(1SSg$c-fkUKo#?sH&>VPIhJM&g6Q!WSB5AoU=AFvut{hS(p1@UMUq02l@l AD*ylh literal 0 HcmV?d00001