From b65a0a3a8dc84a4b6082b3d1ff93a2d8b44ae614 Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Sun, 16 Sep 2018 21:59:00 -0300 Subject: [PATCH 01/14] Fix signal handling when --watch flag is given Closes #132 --- cmd/task/task.go | 7 ++++++- watch.go | 28 +++++++++++++++++++--------- 2 files changed, 25 insertions(+), 10 deletions(-) diff --git a/cmd/task/task.go b/cmd/task/task.go index 74c54697..40950ffe 100644 --- a/cmd/task/task.go +++ b/cmd/task/task.go @@ -87,6 +87,11 @@ func main() { return } + ctx := context.Background() + if !watch { + ctx = getSignalContext() + } + e := task.Executor{ Force: force, Watch: watch, @@ -95,7 +100,7 @@ func main() { Dir: dir, Dry: dry, - Context: getSignalContext(), + Context: ctx, Stdin: os.Stdin, Stdout: os.Stdout, diff --git a/watch.go b/watch.go index 43d346b2..9660c057 100644 --- a/watch.go +++ b/watch.go @@ -2,7 +2,10 @@ package task import ( "context" + "os" + "os/signal" "strings" + "syscall" "time" "github.com/go-task/task/internal/taskfile" @@ -40,6 +43,8 @@ func (e *Executor) watchTasks(calls ...taskfile.Call) error { return err } + closeOnInterrupt(w) + go func() { for { select { @@ -66,6 +71,7 @@ func (e *Executor) watchTasks(calls ...taskfile.Call) error { e.Logger.Errf("%v", err) } case <-w.Closed: + cancel() return } } @@ -84,6 +90,19 @@ func (e *Executor) watchTasks(calls ...taskfile.Call) error { return w.Start(time.Second) } +func isContextError(err error) bool { + return err == context.Canceled || err == context.DeadlineExceeded +} + +func closeOnInterrupt(w *watcher.Watcher) { + ch := make(chan os.Signal, 1) + signal.Notify(ch, os.Interrupt, os.Kill, syscall.SIGTERM) + go func() { + <-ch + w.Close() + }() +} + func (e *Executor) registerWatchedFiles(w *watcher.Watcher, calls ...taskfile.Call) error { oldWatchedFiles := make(map[string]struct{}) for f := range w.WatchedFiles() { @@ -140,12 +159,3 @@ func (e *Executor) registerWatchedFiles(w *watcher.Watcher, calls ...taskfile.Ca } return nil } - -func isContextError(err error) bool { - switch err { - case context.Canceled, context.DeadlineExceeded: - return true - default: - return false - } -} From 347fe87229079f3a46e190848b6778ba1be037a3 Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Sun, 16 Sep 2018 22:17:36 -0300 Subject: [PATCH 02/14] v2.1.1 From 08263c059743d87503b8004a951d2ec90bcc71ed Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Sat, 22 Sep 2018 17:29:18 -0300 Subject: [PATCH 03/14] Fix wrong error message beingg print when the file has a syntax error Fixes #137 --- internal/taskfile/read/taskfile.go | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/internal/taskfile/read/taskfile.go b/internal/taskfile/read/taskfile.go index 0c36380d..191d1415 100644 --- a/internal/taskfile/read/taskfile.go +++ b/internal/taskfile/read/taskfile.go @@ -14,9 +14,12 @@ import ( // Taskfile reads a Taskfile for a given directory func Taskfile(dir string) (*taskfile.Taskfile, error) { path := filepath.Join(dir, "Taskfile.yml") + if _, err := os.Stat(path); err != nil { + return nil, fmt.Errorf(`No Taskfile.yml found. Use "task --init" to create a new one`) + } t, err := readTaskfile(path) if err != nil { - return nil, fmt.Errorf(`No Taskfile.yml found. Use "task --init" to create a new one`) + return nil, err } path = filepath.Join(dir, fmt.Sprintf("Taskfile_%s.yml", runtime.GOOS)) From 9ee224c36b43bd6a1c7cdd5fe58e38e3f58ca7b2 Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Sat, 22 Sep 2018 18:44:24 -0300 Subject: [PATCH 04/14] Documentation site using docsify --- README.md | 780 +----------------- Taskfile.yml | 10 + docs/.nojekyll | 0 docs/README.md | 11 + docs/_sidebar.md | 36 + docs/alternative_task_runners.md | 17 + docs/examples.md | 7 + docs/index.html | 27 + docs/installation.md | 51 ++ RELEASING_TASK.md => docs/releasing_task.md | 0 docs/sponsors_and_backers.md | 16 + .../taskfile_versions.md | 18 +- docs/usage.md | 669 +++++++++++++++ 13 files changed, 855 insertions(+), 787 deletions(-) create mode 100644 docs/.nojekyll create mode 100644 docs/README.md create mode 100644 docs/_sidebar.md create mode 100644 docs/alternative_task_runners.md create mode 100644 docs/examples.md create mode 100644 docs/index.html create mode 100644 docs/installation.md rename RELEASING_TASK.md => docs/releasing_task.md (100%) create mode 100644 docs/sponsors_and_backers.md rename TASKFILE_VERSIONS.md => docs/taskfile_versions.md (94%) create mode 100644 docs/usage.md diff --git a/README.md b/README.md index f370f5db..0d06b02d 100644 --- a/README.md +++ b/README.md @@ -2,788 +2,12 @@ # Task - A task runner / simpler Make alternative written in Go -> We recently released version 2.0.0 of Task. The Taskfile changed a bit. -Please, check the [Taskfile versions](TASKFILE_VERSIONS.md) document to see -what changed and how to upgrade. - Task is a simple tool that allows you to easily run development and build tasks. Task is written in Golang, but can be used to develop any language. It aims to be simpler and easier to use then [GNU Make][make]. -- [Installation](#installation) - - [Go](#go) - - [Homebrew](#homebrew) - - [Snap](#snap) - - [Binary](#binary) -- [Usage](#usage) - - [Environment](#environment) - - [OS specific task](#os-specific-task) - - [Task directory](#task-directory) - - [Task dependencies](#task-dependencies) - - [Calling another task](#calling-another-task) - - [Prevent unnecessary work](#prevent-unnecessary-work) - - [Variables](#variables) - - [Dynamic variables](#dynamic-variables) - - [Go's template engine](#gos-template-engine) - - [Help](#help) - - [Silent mode](#silent-mode) - - [Dry run mode](#dry-run-mode) - - [Ignore errors](#ignore-errors) - - [Output syntax](#output-syntax) - - [Watch tasks](#watch-tasks-experimental) -- [Examples](#examples) -- [Alternative task runners](#alternative-task-runners) +--- -## Installation - -### Go - -If you have a [Golang][golang] environment setup, you can simply run: - -```bash -go get -u -v github.com/go-task/task/cmd/task -``` - -### Homebrew - -If you're on macOS and have [Homebrew][homebrew] installed, getting Task is -as simple as running: - -```bash -brew install go-task/tap/go-task -``` - -### Snap - -Task is available for [Snapcraft][snapcraft], but keep in mind that your -Linux distribution should allow classic confinement for Snaps to Task work -right: - -```bash -sudo snap install task -``` - -### Install script - -We also have a [install script][installscript], which is very useful on -scanarios like CIs. Many thanks to [godownloader][godownloader] for easily -generating this script. - -```bash -curl -s https://raw.githubusercontent.com/go-task/task/master/install-task.sh | sh -``` - -### Binary - -Or you can download the binary from the [releases][releases] page and add to -your `PATH`. DEB and RPM packages are also available. -The `task_checksums.txt` file contains the sha256 checksum for each file. - -## Usage - -Create a file called `Taskfile.yml` in the root of your project. -The `cmds` attribute should contain the commands of a task. -The example below allows compiling a Go app and uses [Minify][minify] to concat -and minify multiple CSS files into a single one. - -```yml -version: '2' - -tasks: - build: - cmds: - - go build -v -i main.go - - assets: - cmds: - - minify -o public/style.css src/css -``` - -Running the tasks is as simple as running: - -```bash -task assets build -``` - -Task uses [github.com/mvdan/sh](https://github.com/mvdan/sh), a native Go sh -interpreter. So you can write sh/bash commands and it will work even on -Windows, where `sh` or `bash` are usually not available. Just remember any -executable called must be available by the OS or in PATH. - -If you ommit a task name, "default" will be assumed. - -### Environment - -You can specify environment variables that are added when running a command: - -```yml -version: '2' - -tasks: - build: - cmds: - - echo $hallo - env: - hallo: welt -``` - -### OS specific task - -If you add a `Taskfile_{{GOOS}}.yml` you can override or amend your Taskfile -based on the operating system. - -Example: - -Taskfile.yml: - -```yml -version: '2' - -tasks: - build: - cmds: - - echo "default" -``` - -Taskfile_linux.yml: - -```yml -version: '2' - -tasks: - build: - cmds: - - echo "linux" -``` - -Will print out `linux` and not `default`. - -Keep in mind that the version of the files should match. Also, when redefining -a task the whole task is replaced, properties of the task are not merged. - -It's also possible to have an OS specific `Taskvars.yml` file, like -`Taskvars_windows.yml`, `Taskfile_linux.yml`, or `Taskvars_darwin.yml`. See the -[variables section](#variables) below. - -### Task directory - -By default, tasks will be executed in the directory where the Taskfile is -located. But you can easily make the task run in another folder informing -`dir`: - -```yml -version: '2' - -tasks: - serve: - dir: public/www - cmds: - # run http server - - caddy -``` - -### Task dependencies - -You may have tasks that depend on others. Just pointing them on `deps` will -make them run automatically before running the parent task: - -```yml -version: '2' - -tasks: - build: - deps: [assets] - cmds: - - go build -v -i main.go - - assets: - cmds: - - minify -o public/style.css src/css -``` - -In the above example, `assets` will always run right before `build` if you run -`task build`. - -A task can have only dependencies and no commands to group tasks together: - -```yml -version: '2' - -tasks: - assets: - deps: [js, css] - - js: - cmds: - - minify -o public/script.js src/js - - css: - cmds: - - minify -o public/style.css src/css -``` - -If there is more than one dependency, they always run in parallel for better -performance. - -If you want to pass information to dependencies, you can do that the same -manner as you would to [call another task](#calling-another-task): - -```yml -version: '2' - -tasks: - default: - deps: - - task: echo_sth - vars: {TEXT: "before 1"} - - task: echo_sth - vars: {TEXT: "before 2"} - cmds: - - echo "after" - - echo_sth: - cmds: - - echo {{.TEXT}} -``` - -### Calling another task - -When a task has many dependencies, they are executed concurrently. This will -often result in a faster build pipeline. But in some situations you may need -to call other tasks serially. In this case, just use the following syntax: - -```yml -version: '2' - -tasks: - main-task: - cmds: - - task: task-to-be-called - - task: another-task - - echo "Both done" - - task-to-be-called: - cmds: - - echo "Task to be called" - - another-task: - cmds: - - echo "Another task" -``` - -Overriding variables in the called task is as simple as informing `vars` -attribute: - -```yml -version: '2' - -tasks: - main-task: - cmds: - - task: write-file - vars: {FILE: "hello.txt", CONTENT: "Hello!"} - - task: write-file - vars: {FILE: "world.txt", CONTENT: "World!"} - - write-file: - cmds: - - echo "{{.CONTENT}}" > {{.FILE}} -``` - -The above syntax is also supported in `deps`. - -### Prevent unnecessary work - -If a task generates something, you can inform Task the source and generated -files, so Task will prevent to run them if not necessary. - -```yml -version: '2' - -tasks: - build: - deps: [js, css] - cmds: - - go build -v -i main.go - - js: - cmds: - - minify -o public/script.js src/js - sources: - - src/js/**/*.js - generates: - - public/script.js - - css: - cmds: - - minify -o public/style.css src/css - sources: - - src/css/**/*.css - generates: - - public/style.css -``` - -`sources` and `generates` can be files or file patterns. When both are given, -Task will compare the modification date/time of the files to determine if it's -necessary to run the task. If not, it will just print a message like -`Task "js" is up to date`. - -If you prefer this check to be made by the content of the files, instead of -its timestamp, just set the `method` property to `checksum`. -You will probably want to ignore the `.task` folder in your `.gitignore` file -(It's there that Task stores the last checksum). - -```yml -version: '2' - -tasks: - build: - cmds: - - go build . - sources: - - ./*.go - generates: - - app{{exeExt}} - method: checksum -``` - -> TIP: method `none` skips any validation and always run the task. - -Alternatively, you can inform a sequence of tests as `status`. If no error -is returned (exit status 0), the task is considered up-to-date: - -```yml -version: '2' - -tasks: - generate-files: - cmds: - - mkdir directory - - touch directory/file1.txt - - touch directory/file2.txt - # test existence of files - status: - - test -d directory - - test -f directory/file1.txt - - test -f directory/file2.txt -``` - -You can use `--force` or `-f` if you want to force a task to run even when -up-to-date. - -Also, `task --status [tasks]...` will exit with a non-zero exit code if any of -the tasks are not up-to-date. - -### Variables - -When doing interpolation of variables, Task will look for the below. -They are listed below in order of importance (e.g. most important first): - -- Variables declared locally in the task -- Variables given while calling a task from another. - (See [Calling another task](#calling-another-task) above) -- Variables declared in the `vars:` option in the `Taskfile` -- Variables available in the `Taskvars.yml` file -- Environment variables - -Example of sending parameters with environment variables: - -```bash -$ TASK_VARIABLE=a-value task do-something -``` - -Since some shells don't support above syntax to set environment variables -(Windows) tasks also accepts a similar style when not in the beginning of -the command. Variables given in this form are only visible to the task called -right before. - -```bash -$ task write-file FILE=file.txt "CONTENT=Hello, World!" print "MESSAGE=All done!" -``` - -Example of locally declared vars: - -```yml -version: '2' - -tasks: - print-var: - cmds: - echo "{{.VAR}}" - vars: - VAR: Hello! -``` - -Example of global vars in a `Taskfile.yml`: - -```yml -version: '2' - -vars: - GREETING: Hello from Taskfile! - -tasks: - greet: - cmds: - - echo "{{.GREETING}}" -``` - -Example of `Taskvars.yml` file: - -```yml -PROJECT_NAME: My Project -DEV_MODE: production -GIT_COMMIT: {sh: git log -n 1 --format=%h} -``` - -#### Variables expansion - -Variables are expanded 2 times by default. You can change that by setting the -`expansions:` option. Change that will be necessary if you compose many -variables together: - -```yml -version: '2' - -expansions: 3 - -vars: - FOO: foo - BAR: bar - BAZ: baz - FOOBAR: "{{.FOO}}{{.BAR}}" - FOOBARBAZ: "{{.FOOBAR}}{{.BAZ}}" - -tasks: - default: - cmds: - - echo "{{.FOOBARBAZ}}" -``` - -#### Dynamic variables - -The below syntax (`sh:` prop in a variable) is considered a dynamic variable. -The value will be treated as a command and the output assigned. If there is one -or more trailing newlines, the last newline will be trimmed. - -```yml -version: '2' - -tasks: - build: - cmds: - - go build -ldflags="-X main.Version={{.GIT_COMMIT}}" main.go - vars: - GIT_COMMIT: - sh: git log -n 1 --format=%h -``` - -This works for all types of variables. - -### Go's template engine - -Task parse commands as [Go's template engine][gotemplate] before executing -them. Variables are accessible through dot syntax (`.VARNAME`). - -All functions by the Go's [sprig lib](http://masterminds.github.io/sprig/) -are available. The following example gets the current date in a given format: - -```yml -version: '2' - -tasks: - print-date: - cmds: - - echo {{now | date "2006-01-02"}} -``` - -Task also adds the following functions: - -- `OS`: Returns operating system. Possible values are "windows", "linux", - "darwin" (macOS) and "freebsd". -- `ARCH`: return the architecture Task was compiled to: "386", "amd64", "arm" - or "s390x". -- `splitLines`: Splits Unix (\n) and Windows (\r\n) styled newlines. -- `catLines`: Replaces Unix (\n) and Windows (\r\n) styled newlines with a space. -- `toSlash`: Does nothing on Unix, but on Windows converts a string from `\` - path format to `/`. -- `fromSlash`: Oposite of `toSlash`. Does nothing on Unix, but on Windows - converts a string from `\` path format to `/`. -- `exeExt`: Returns the right executable extension for the current OS - (`".exe"` for Windows, `""` for others). - -Example: - -```yml -version: '2' - -tasks: - print-os: - cmds: - - echo '{{OS}} {{ARCH}}' - - echo '{{if eq OS "windows"}}windows-command{{else}}unix-command{{end}}' - # This will be path/to/file on Unix but path\to\file on Windows - - echo '{{fromSlash "path/to/file"}}' - enumerated-file: - vars: - CONTENT: | - foo - bar - cmds: - - | - cat << EOF > output.txt - {{range $i, $line := .CONTENT | splitLines -}} - {{printf "%3d" $i}}: {{$line}} - {{end}}EOF -``` - -### Help - -Running `task --list` (or `task -l`) lists all tasks with a description. -The following taskfile: - -```yml -version: '2' - -tasks: - build: - desc: Build the go binary. - cmds: - - go build -v -i main.go - - test: - desc: Run all the go tests. - cmds: - - go test -race ./... - - js: - cmds: - - minify -o public/script.js src/js - - css: - cmds: - - minify -o public/style.css src/css -``` - -would print the following output: - -```bash -* build: Build the go binary. -* test: Run all the go tests. -``` - -## Silent mode - -Silent mode disables echoing of commands before Task runs it. -For the following Taskfile: - -```yml -version: '2' - -tasks: - echo: - cmds: - - echo "Print something" -``` - -Normally this will be print: - -```sh -echo "Print something" -Print something -``` - -With silent mode on, the below will be print instead: - -```sh -Print something -``` - -There's three ways to enable silent mode: - -* At command level: - -```yml -version: '2' - -tasks: - echo: - cmds: - - cmd: echo "Print something" - silent: true -``` - -* At task level: - -```yml -version: '2' - -tasks: - echo: - cmds: - - echo "Print something" - silent: true -``` - -* Or globally with `--silent` or `-s` flag - -If you want to suppress stdout instead, just redirect a command to `/dev/null`: - -```yml -version: '2' - -tasks: - echo: - cmds: - - echo "This will print nothing" > /dev/null -``` - -## Dry run mode - -Dry run mode (`--dry`) compiles and steps through each task, printing the commands -that would be run without executing them. This is useful for debugging your Taskfiles. - -## Ignore errors - -You have the option to ignore errors during command execution. -Given the following Taskfile: - -```yml -version: '2' - -tasks: - echo: - cmds: - - exit 1 - - echo "Hello World" -``` - -Task will abort the execution after running `exit 1` because the status code `1` stands for `EXIT_FAILURE`. -However it is possible to continue with execution using `ignore_error`: - -```yml -version: '2' - -tasks: - echo: - cmds: - - cmd: exit 1 - ignore_error: true - - echo "Hello World" -``` - -`ignore_error` can also be set for a task, which mean errors will be supressed -for all commands. But keep in mind this option won't propagate to other tasks -called either by `deps` or `cmds`! - -## Output syntax - -By default, Task just redirect the STDOUT and STDERR of the running commands -to the shell in real time. This is good for having live feedback for log -printed by commands, but the output can become messy if you have multiple -commands running at the same time and printing lots of stuff. - -To make this more customizable, there are currently three different output -options you can choose: - -- `interleaved` (default) -- `group` -- `prefixed` - - To choose another one, just set it to root in the Taskfile: - - ```yml -version: '2' - -output: 'group' - -tasks: - # ... - ``` - - The `group` output will print the entire output of a command once, after it - finishes, so you won't have live feedback for commands that take a long time - to run. - - The `prefix` output will prefix every line printed by a command with - `[task-name] ` as the prefix, but you can customize the prefix for a command - with the `prefix:` attribute: - - ```yml -version: '2' - -output: prefixed - -tasks: - default: - deps: - - task: print - vars: {TEXT: foo} - - task: print - vars: {TEXT: bar} - - task: print - vars: {TEXT: baz} - - print: - cmds: - - echo "{{.TEXT}}" - prefix: "print-{{.TEXT}}" - silent: true -``` - -```bash -$ task default -[print-foo] foo -[print-bar] bar -[print-baz] baz -``` - -## Watch tasks - -If you give a `--watch` or `-w` argument, task will watch for file changes -and run the task again. This requires the `sources` attribute to be given, -so task know which files to watch. - -## Examples - -The [go-task/examples][examples] intends to be a collection of Taskfiles for -various use cases. -(It still lacks many examples, though. Contributions are welcome). - -## Alternative task runners - -- YAML based: - - [rliebz/tusk][tusk] -- Go based: - - [magefile/mage][mage] -- Make based or similar: - - [casey/just][just] - -### Sponsors - -[![Sponsors](https://opencollective.com/task/sponsors.svg?width=890)][opencollective] - -### Backers - -[![Backers](https://opencollective.com/task/backers.svg?width=890)][opencollective] - -### Contributors - -[![Contributors](https://opencollective.com/task/contributors.svg?width=890)][contributors] +See [Taskfile.org](https://taskfile.org) for documentation. [make]: https://www.gnu.org/software/make/ -[releases]: https://github.com/go-task/task/releases -[golang]: https://golang.org/ -[gotemplate]: https://golang.org/pkg/text/template/ -[tusk]: https://github.com/rliebz/tusk -[mage]: https://github.com/magefile/mage -[just]: https://github.com/casey/just -[sh]: https://github.com/mvdan/sh -[minify]: https://github.com/tdewolff/minify/tree/master/cmd/minify -[examples]: https://github.com/go-task/examples -[snapcraft]: https://snapcraft.io/ -[homebrew]: https://brew.sh/ -[installscript]: https://github.com/go-task/task/blob/master/install-task.sh -[godownloader]: https://github.com/goreleaser/godownloader -[opencollective]: https://opencollective.com/task -[contributors]: https://github.com/go-task/task/graphs/contributors diff --git a/Taskfile.yml b/Taskfile.yml index 90fa4869..b811cb66 100644 --- a/Taskfile.yml +++ b/Taskfile.yml @@ -79,3 +79,13 @@ tasks: cmds: - echo '{{.GO_PACKAGES}}' silent: true + + docs:install: + desc: Installs docsify to work the on the documentation site + cmds: + - npm install docsify-cli -g + + docs:serve: + desc: Serves the documentation site locally + cmds: + - docsify serve docs diff --git a/docs/.nojekyll b/docs/.nojekyll new file mode 100644 index 00000000..e69de29b diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 00000000..9fe456da --- /dev/null +++ b/docs/README.md @@ -0,0 +1,11 @@ +# Task - A task runner / simpler Make alternative written in Go + +Task is a simple tool that allows you to easily run development and build +tasks. Task is written in Golang, but can be used to develop any language. +It aims to be simpler and easier to use then [GNU Make][make]. + +--- + +See [Installation](INSTALLATION) and [Getting Started](USAGE#getting-started). + +[make]: https://www.gnu.org/software/make/ diff --git a/docs/_sidebar.md b/docs/_sidebar.md new file mode 100644 index 00000000..72d096eb --- /dev/null +++ b/docs/_sidebar.md @@ -0,0 +1,36 @@ +# [Installation](installation) + +- [Go](INSTALLATION#go) +- [Homebrew](INSTALLATION#homebrew) +- [Snap](INSTALLATION#snap) +- [Binary](INSTALLATION#binary) +- [Install script](INSTALLATION#install-script) + +# [Usage](usage) + +- [Getting started](USAGE#getting-started) +- [Environment](USAGE#environment) +- [OS specific task](USAGE#os-specific-task) +- [Task directory](USAGE#task-directory) +- [Task dependencies](USAGE#task-dependencies) +- [Calling another task](USAGE#calling-another-task) +- [Prevent unnecessary work](USAGE#prevent-unnecessary-work) +- [Variables](USAGE#variables) + - [Dynamic variables](USAGE#dynamic-variables) +- [Go's template engine](USAGE#gos-template-engine) +- [Help](USAGE#help) +- [Silent mode](USAGE#silent-mode) +- [Dry run mode](USAGE#dry-run-mode) +- [Ignore errors](USAGE#ignore-errors) +- [Output syntax](USAGE#output-syntax) +- [Watch tasks](USAGE#watch-tasks-experimental) + +# [Taskfile Versions](taskfile_versions) + +# [Examples](examples) + +# [Releasing Task](releasing_task) + +# [Alternative Task Runners](alternative_task_runners) + +# [Sponsors and Backers](sponsors_and_backers) diff --git a/docs/alternative_task_runners.md b/docs/alternative_task_runners.md new file mode 100644 index 00000000..a54283e2 --- /dev/null +++ b/docs/alternative_task_runners.md @@ -0,0 +1,17 @@ +# Alternative task runners + +## YAML based: + +- [rliebz/tusk][tusk] + +## Go based: + +- [magefile/mage][mage] + +## Make similar: + +- [casey/just][just] + +[tusk]: https://github.com/rliebz/tusk +[mage]: https://github.com/magefile/mage +[just]: https://github.com/casey/just diff --git a/docs/examples.md b/docs/examples.md new file mode 100644 index 00000000..f4bda2b5 --- /dev/null +++ b/docs/examples.md @@ -0,0 +1,7 @@ +# Examples + +The [go-task/examples][examples] intends to be a collection of Taskfiles for +various use cases. +(It still lacks many examples, though. Contributions are welcome). + +[examples]: https://github.com/go-task/examples diff --git a/docs/index.html b/docs/index.html new file mode 100644 index 00000000..0a56b64e --- /dev/null +++ b/docs/index.html @@ -0,0 +1,27 @@ + + + + + Document + + + + + + + + +
+ + + + + + diff --git a/docs/installation.md b/docs/installation.md new file mode 100644 index 00000000..5f814b4b --- /dev/null +++ b/docs/installation.md @@ -0,0 +1,51 @@ +# Installation + +## Go + +If you have a [Golang][golang] environment setup, you can simply run: + +```bash +go get -u -v github.com/go-task/task/cmd/task +``` + +## Homebrew + +If you're on macOS and have [Homebrew][homebrew] installed, getting Task is +as simple as running: + +```bash +brew install go-task/tap/go-task +``` + +## Snap + +Task is available for [Snapcraft][snapcraft], but keep in mind that your +Linux distribution should allow classic confinement for Snaps to Task work +right: + +```bash +sudo snap install task +``` + +## Install script + +We also have a [install script][installscript], which is very useful on +scanarios like CIs. Many thanks to [godownloader][godownloader] for easily +generating this script. + +```bash +curl -s https://raw.githubusercontent.com/go-task/task/master/install-task.sh | sh +``` + +## Binary + +Or you can download the binary from the [releases][releases] page and add to +your `PATH`. DEB and RPM packages are also available. +The `task_checksums.txt` file contains the sha256 checksum for each file. + +[golang]: https://golang.org/ +[snapcraft]: https://snapcraft.io/ +[homebrew]: https://brew.sh/ +[installscript]: https://github.com/go-task/task/blob/master/install-task.sh +[releases]: https://github.com/go-task/task/releases +[godownloader]: https://github.com/goreleaser/godownloader diff --git a/RELEASING_TASK.md b/docs/releasing_task.md similarity index 100% rename from RELEASING_TASK.md rename to docs/releasing_task.md diff --git a/docs/sponsors_and_backers.md b/docs/sponsors_and_backers.md new file mode 100644 index 00000000..6452b789 --- /dev/null +++ b/docs/sponsors_and_backers.md @@ -0,0 +1,16 @@ +# Sponsors and Backers + +## Sponsors + +[![Sponsors](https://opencollective.com/task/sponsors.svg?width=890)][opencollective] + +## Backers + +[![Backers](https://opencollective.com/task/backers.svg?width=890)][opencollective] + +## Contributors + +[![Contributors](https://opencollective.com/task/contributors.svg?width=890)][contributors] + +[opencollective]: https://opencollective.com/task +[contributors]: https://github.com/go-task/task/graphs/contributors diff --git a/TASKFILE_VERSIONS.md b/docs/taskfile_versions.md similarity index 94% rename from TASKFILE_VERSIONS.md rename to docs/taskfile_versions.md index 00ab3cd1..997334a7 100644 --- a/TASKFILE_VERSIONS.md +++ b/docs/taskfile_versions.md @@ -1,9 +1,9 @@ -# Taskfile version +# Taskfile Versions The Taskfile syntax and features changed with time. This document explains what changed on each version and how to upgrade your Taskfile. -# What the Taskfile version mean +## What the Taskfile version mean The Taskfile version follows the Task version. E.g. the change to Taskfile version `2` means that Task `v2.0.0` should be release to support it. @@ -18,7 +18,7 @@ available, but not `3.0.0+`. In the first version of the `Taskfile`, the `version:` key was not available, because the tasks was in the root of the YAML document. Like this: -```yml +```yaml echo: cmds: - echo "Hello, World!" @@ -37,7 +37,7 @@ At version 2, we introduced the `version:` key, to allow us to envolve Task with new features without breaking existing Taskfiles. The new syntax is as follows: -```yml +```yaml version: '2' tasks: @@ -49,7 +49,7 @@ tasks: Version 2 allows you to write global variables directly in the Taskfile, if you don't want to create a `Taskvars.yml`: -```yml +```yaml version: '2' vars: @@ -72,7 +72,7 @@ The variable priority order changed to the following: A new global option was added to configure the number of variables expansions (which default to 2): -```yml +```yaml version: '2' expansions: 3 @@ -96,7 +96,7 @@ Version 2.1 includes a global `output` option, to allow having more control over how commands output are printed to the console (see [documentation][output] for more info): -```yml +```yaml version: '2' output: prefixed @@ -109,9 +109,9 @@ tasks: ``` From this version it's not also possible to ignore errors of a command or task -(check documentatio [here][ignore_errors]): +(check documentation [here][ignore_errors]): -```yml +```yaml version: '2' tasks: diff --git a/docs/usage.md b/docs/usage.md new file mode 100644 index 00000000..c5b2c0ea --- /dev/null +++ b/docs/usage.md @@ -0,0 +1,669 @@ +# Usage + +## Getting started + +Create a file called `Taskfile.yml` in the root of your project. +The `cmds` attribute should contain the commands of a task. +The example below allows compiling a Go app and uses [Minify][minify] to concat +and minify multiple CSS files into a single one. + +```yaml +version: '2' + +tasks: + build: + cmds: + - go build -v -i main.go + + assets: + cmds: + - minify -o public/style.css src/css +``` + +Running the tasks is as simple as running: + +```bash +task assets build +``` + +Task uses [github.com/mvdan/sh](https://github.com/mvdan/sh), a native Go sh +interpreter. So you can write sh/bash commands and it will work even on +Windows, where `sh` or `bash` are usually not available. Just remember any +executable called must be available by the OS or in PATH. + +If you ommit a task name, "default" will be assumed. + +### Environment + +You can specify environment variables that are added when running a command: + +```yaml +version: '2' + +tasks: + build: + cmds: + - echo $hallo + env: + hallo: welt +``` + +### OS specific task + +If you add a `Taskfile_{{GOOS}}.yml` you can override or amend your Taskfile +based on the operating system. + +Example: + +Taskfile.yml: + +```yaml +version: '2' + +tasks: + build: + cmds: + - echo "default" +``` + +Taskfile_linux.yml: + +```yaml +version: '2' + +tasks: + build: + cmds: + - echo "linux" +``` + +Will print out `linux` and not `default`. + +Keep in mind that the version of the files should match. Also, when redefining +a task the whole task is replaced, properties of the task are not merged. + +It's also possible to have an OS specific `Taskvars.yml` file, like +`Taskvars_windows.yml`, `Taskfile_linux.yml`, or `Taskvars_darwin.yml`. See the +[variables section](#variables) below. + +### Task directory + +By default, tasks will be executed in the directory where the Taskfile is +located. But you can easily make the task run in another folder informing +`dir`: + +```yaml +version: '2' + +tasks: + serve: + dir: public/www + cmds: + # run http server + - caddy +``` + +### Task dependencies + +You may have tasks that depend on others. Just pointing them on `deps` will +make them run automatically before running the parent task: + +```yaml +version: '2' + +tasks: + build: + deps: [assets] + cmds: + - go build -v -i main.go + + assets: + cmds: + - minify -o public/style.css src/css +``` + +In the above example, `assets` will always run right before `build` if you run +`task build`. + +A task can have only dependencies and no commands to group tasks together: + +```yaml +version: '2' + +tasks: + assets: + deps: [js, css] + + js: + cmds: + - minify -o public/script.js src/js + + css: + cmds: + - minify -o public/style.css src/css +``` + +If there is more than one dependency, they always run in parallel for better +performance. + +If you want to pass information to dependencies, you can do that the same +manner as you would to [call another task](#calling-another-task): + +```yaml +version: '2' + +tasks: + default: + deps: + - task: echo_sth + vars: {TEXT: "before 1"} + - task: echo_sth + vars: {TEXT: "before 2"} + cmds: + - echo "after" + + echo_sth: + cmds: + - echo {{.TEXT}} +``` + +### Calling another task + +When a task has many dependencies, they are executed concurrently. This will +often result in a faster build pipeline. But in some situations you may need +to call other tasks serially. In this case, just use the following syntax: + +```yaml +version: '2' + +tasks: + main-task: + cmds: + - task: task-to-be-called + - task: another-task + - echo "Both done" + + task-to-be-called: + cmds: + - echo "Task to be called" + + another-task: + cmds: + - echo "Another task" +``` + +Overriding variables in the called task is as simple as informing `vars` +attribute: + +```yaml +version: '2' + +tasks: + main-task: + cmds: + - task: write-file + vars: {FILE: "hello.txt", CONTENT: "Hello!"} + - task: write-file + vars: {FILE: "world.txt", CONTENT: "World!"} + + write-file: + cmds: + - echo "{{.CONTENT}}" > {{.FILE}} +``` + +The above syntax is also supported in `deps`. + +### Prevent unnecessary work + +If a task generates something, you can inform Task the source and generated +files, so Task will prevent to run them if not necessary. + +```yaml +version: '2' + +tasks: + build: + deps: [js, css] + cmds: + - go build -v -i main.go + + js: + cmds: + - minify -o public/script.js src/js + sources: + - src/js/**/*.js + generates: + - public/script.js + + css: + cmds: + - minify -o public/style.css src/css + sources: + - src/css/**/*.css + generates: + - public/style.css +``` + +`sources` and `generates` can be files or file patterns. When both are given, +Task will compare the modification date/time of the files to determine if it's +necessary to run the task. If not, it will just print a message like +`Task "js" is up to date`. + +If you prefer this check to be made by the content of the files, instead of +its timestamp, just set the `method` property to `checksum`. +You will probably want to ignore the `.task` folder in your `.gitignore` file +(It's there that Task stores the last checksum). + +```yaml +version: '2' + +tasks: + build: + cmds: + - go build . + sources: + - ./*.go + generates: + - app{{exeExt}} + method: checksum +``` + +> TIP: method `none` skips any validation and always run the task. + +Alternatively, you can inform a sequence of tests as `status`. If no error +is returned (exit status 0), the task is considered up-to-date: + +```yaml +version: '2' + +tasks: + generate-files: + cmds: + - mkdir directory + - touch directory/file1.txt + - touch directory/file2.txt + # test existence of files + status: + - test -d directory + - test -f directory/file1.txt + - test -f directory/file2.txt +``` + +You can use `--force` or `-f` if you want to force a task to run even when +up-to-date. + +Also, `task --status [tasks]...` will exit with a non-zero exit code if any of +the tasks are not up-to-date. + +### Variables + +When doing interpolation of variables, Task will look for the below. +They are listed below in order of importance (e.g. most important first): + +- Variables declared locally in the task +- Variables given while calling a task from another. + (See [Calling another task](#calling-another-task) above) +- Variables declared in the `vars:` option in the `Taskfile` +- Variables available in the `Taskvars.yml` file +- Environment variables + +Example of sending parameters with environment variables: + +```bash +$ TASK_VARIABLE=a-value task do-something +``` + +Since some shells don't support above syntax to set environment variables +(Windows) tasks also accepts a similar style when not in the beginning of +the command. Variables given in this form are only visible to the task called +right before. + +```bash +$ task write-file FILE=file.txt "CONTENT=Hello, World!" print "MESSAGE=All done!" +``` + +Example of locally declared vars: + +```yaml +version: '2' + +tasks: + print-var: + cmds: + echo "{{.VAR}}" + vars: + VAR: Hello! +``` + +Example of global vars in a `Taskfile.yml`: + +```yaml +version: '2' + +vars: + GREETING: Hello from Taskfile! + +tasks: + greet: + cmds: + - echo "{{.GREETING}}" +``` + +Example of `Taskvars.yml` file: + +```yaml +PROJECT_NAME: My Project +DEV_MODE: production +GIT_COMMIT: {sh: git log -n 1 --format=%h} +``` + +#### Variables expansion + +Variables are expanded 2 times by default. You can change that by setting the +`expansions:` option. Change that will be necessary if you compose many +variables together: + +```yaml +version: '2' + +expansions: 3 + +vars: + FOO: foo + BAR: bar + BAZ: baz + FOOBAR: "{{.FOO}}{{.BAR}}" + FOOBARBAZ: "{{.FOOBAR}}{{.BAZ}}" + +tasks: + default: + cmds: + - echo "{{.FOOBARBAZ}}" +``` + +#### Dynamic variables + +The below syntax (`sh:` prop in a variable) is considered a dynamic variable. +The value will be treated as a command and the output assigned. If there is one +or more trailing newlines, the last newline will be trimmed. + +```yaml +version: '2' + +tasks: + build: + cmds: + - go build -ldflags="-X main.Version={{.GIT_COMMIT}}" main.go + vars: + GIT_COMMIT: + sh: git log -n 1 --format=%h +``` + +This works for all types of variables. + +### Go's template engine + +Task parse commands as [Go's template engine][gotemplate] before executing +them. Variables are accessible through dot syntax (`.VARNAME`). + +All functions by the Go's [sprig lib](http://masterminds.github.io/sprig/) +are available. The following example gets the current date in a given format: + +```yaml +version: '2' + +tasks: + print-date: + cmds: + - echo {{now | date "2006-01-02"}} +``` + +Task also adds the following functions: + +- `OS`: Returns operating system. Possible values are "windows", "linux", + "darwin" (macOS) and "freebsd". +- `ARCH`: return the architecture Task was compiled to: "386", "amd64", "arm" + or "s390x". +- `splitLines`: Splits Unix (\n) and Windows (\r\n) styled newlines. +- `catLines`: Replaces Unix (\n) and Windows (\r\n) styled newlines with a space. +- `toSlash`: Does nothing on Unix, but on Windows converts a string from `\` + path format to `/`. +- `fromSlash`: Oposite of `toSlash`. Does nothing on Unix, but on Windows + converts a string from `\` path format to `/`. +- `exeExt`: Returns the right executable extension for the current OS + (`".exe"` for Windows, `""` for others). + +Example: + +```yaml +version: '2' + +tasks: + print-os: + cmds: + - echo '{{OS}} {{ARCH}}' + - echo '{{if eq OS "windows"}}windows-command{{else}}unix-command{{end}}' + # This will be path/to/file on Unix but path\to\file on Windows + - echo '{{fromSlash "path/to/file"}}' + enumerated-file: + vars: + CONTENT: | + foo + bar + cmds: + - | + cat << EOF > output.txt + {{range $i, $line := .CONTENT | splitLines -}} + {{printf "%3d" $i}}: {{$line}} + {{end}}EOF +``` + +### Help + +Running `task --list` (or `task -l`) lists all tasks with a description. +The following taskfile: + +```yaml +version: '2' + +tasks: + build: + desc: Build the go binary. + cmds: + - go build -v -i main.go + + test: + desc: Run all the go tests. + cmds: + - go test -race ./... + + js: + cmds: + - minify -o public/script.js src/js + + css: + cmds: + - minify -o public/style.css src/css +``` + +would print the following output: + +```bash +* build: Build the go binary. +* test: Run all the go tests. +``` + +## Silent mode + +Silent mode disables echoing of commands before Task runs it. +For the following Taskfile: + +```yaml +version: '2' + +tasks: + echo: + cmds: + - echo "Print something" +``` + +Normally this will be print: + +```sh +echo "Print something" +Print something +``` + +With silent mode on, the below will be print instead: + +```sh +Print something +``` + +There's three ways to enable silent mode: + +* At command level: + +```yaml +version: '2' + +tasks: + echo: + cmds: + - cmd: echo "Print something" + silent: true +``` + +* At task level: + +```yaml +version: '2' + +tasks: + echo: + cmds: + - echo "Print something" + silent: true +``` + +* Or globally with `--silent` or `-s` flag + +If you want to suppress stdout instead, just redirect a command to `/dev/null`: + +```yaml +version: '2' + +tasks: + echo: + cmds: + - echo "This will print nothing" > /dev/null +``` + +## Dry run mode + +Dry run mode (`--dry`) compiles and steps through each task, printing the commands +that would be run without executing them. This is useful for debugging your Taskfiles. + +## Ignore errors + +You have the option to ignore errors during command execution. +Given the following Taskfile: + +```yaml +version: '2' + +tasks: + echo: + cmds: + - exit 1 + - echo "Hello World" +``` + +Task will abort the execution after running `exit 1` because the status code `1` stands for `EXIT_FAILURE`. +However it is possible to continue with execution using `ignore_error`: + +```yaml +version: '2' + +tasks: + echo: + cmds: + - cmd: exit 1 + ignore_error: true + - echo "Hello World" +``` + +`ignore_error` can also be set for a task, which mean errors will be supressed +for all commands. But keep in mind this option won't propagate to other tasks +called either by `deps` or `cmds`! + +## Output syntax + +By default, Task just redirect the STDOUT and STDERR of the running commands +to the shell in real time. This is good for having live feedback for log +printed by commands, but the output can become messy if you have multiple +commands running at the same time and printing lots of stuff. + +To make this more customizable, there are currently three different output +options you can choose: + +- `interleaved` (default) +- `group` +- `prefixed` + +To choose another one, just set it to root in the Taskfile: + +```yaml +version: '2' + +output: 'group' + +tasks: + # ... +``` + + The `group` output will print the entire output of a command once, after it + finishes, so you won't have live feedback for commands that take a long time + to run. + + The `prefix` output will prefix every line printed by a command with + `[task-name] ` as the prefix, but you can customize the prefix for a command + with the `prefix:` attribute: + + ```yaml +version: '2' + +output: prefixed + +tasks: + default: + deps: + - task: print + vars: {TEXT: foo} + - task: print + vars: {TEXT: bar} + - task: print + vars: {TEXT: baz} + + print: + cmds: + - echo "{{.TEXT}}" + prefix: "print-{{.TEXT}}" + silent: true +``` + +```bash +$ task default +[print-foo] foo +[print-bar] bar +[print-baz] baz +``` + +## Watch tasks + +If you give a `--watch` or `-w` argument, task will watch for file changes +and run the task again. This requires the `sources` attribute to be given, +so task know which files to watch. + +[gotemplate]: https://golang.org/pkg/text/template/ +[minify]: https://github.com/tdewolff/minify/tree/master/cmd/minify From 4aa1e8b0936fd66f7a6fe4e867a458b7dbcf093f Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Sun, 23 Sep 2018 15:06:43 -0300 Subject: [PATCH 05/14] Documentation improvements --- README.md | 2 +- docs/README.md | 10 +++---- docs/_sidebar.md | 44 ++++++------------------------- docs/alternative_task_runners.md | 6 ++--- docs/favicon.ico | Bin 0 -> 139513 bytes docs/index.html | 12 +++++---- docs/usage.md | 22 ++++++++-------- 7 files changed, 34 insertions(+), 62 deletions(-) create mode 100644 docs/favicon.ico diff --git a/README.md b/README.md index 0d06b02d..1d7e0dd8 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ # Task - A task runner / simpler Make alternative written in Go Task is a simple tool that allows you to easily run development and build -tasks. Task is written in Golang, but can be used to develop any language. +tasks. Task is written in Go, but can be used to develop any language. It aims to be simpler and easier to use then [GNU Make][make]. --- diff --git a/docs/README.md b/docs/README.md index 9fe456da..aea5dc9b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,11 +1,9 @@ -# Task - A task runner / simpler Make alternative written in Go +# Task + +A task runner / simpler Make alternative written in Go Task is a simple tool that allows you to easily run development and build -tasks. Task is written in Golang, but can be used to develop any language. +tasks. Task is written in Go, but can be used to develop any language. It aims to be simpler and easier to use then [GNU Make][make]. ---- - -See [Installation](INSTALLATION) and [Getting Started](USAGE#getting-started). - [make]: https://www.gnu.org/software/make/ diff --git a/docs/_sidebar.md b/docs/_sidebar.md index 72d096eb..f2426430 100644 --- a/docs/_sidebar.md +++ b/docs/_sidebar.md @@ -1,36 +1,8 @@ -# [Installation](installation) - -- [Go](INSTALLATION#go) -- [Homebrew](INSTALLATION#homebrew) -- [Snap](INSTALLATION#snap) -- [Binary](INSTALLATION#binary) -- [Install script](INSTALLATION#install-script) - -# [Usage](usage) - -- [Getting started](USAGE#getting-started) -- [Environment](USAGE#environment) -- [OS specific task](USAGE#os-specific-task) -- [Task directory](USAGE#task-directory) -- [Task dependencies](USAGE#task-dependencies) -- [Calling another task](USAGE#calling-another-task) -- [Prevent unnecessary work](USAGE#prevent-unnecessary-work) -- [Variables](USAGE#variables) - - [Dynamic variables](USAGE#dynamic-variables) -- [Go's template engine](USAGE#gos-template-engine) -- [Help](USAGE#help) -- [Silent mode](USAGE#silent-mode) -- [Dry run mode](USAGE#dry-run-mode) -- [Ignore errors](USAGE#ignore-errors) -- [Output syntax](USAGE#output-syntax) -- [Watch tasks](USAGE#watch-tasks-experimental) - -# [Taskfile Versions](taskfile_versions) - -# [Examples](examples) - -# [Releasing Task](releasing_task) - -# [Alternative Task Runners](alternative_task_runners) - -# [Sponsors and Backers](sponsors_and_backers) +- [Installation](installation) +- [Usage](usage) +- [Taskfile Versions](taskfile_versions) +- [Examples](examples) +- [Releasing Task](releasing_task) +- [Alternative Task Runners](alternative_task_runners) +- [Sponsors and Backers](sponsors_and_backers) +- [![Github](https://icongram.jgog.in/simple/github.svg?color=808080&size=16)Github](https://github.com/go-task/task) diff --git a/docs/alternative_task_runners.md b/docs/alternative_task_runners.md index a54283e2..750bebb7 100644 --- a/docs/alternative_task_runners.md +++ b/docs/alternative_task_runners.md @@ -1,14 +1,14 @@ # Alternative task runners -## YAML based: +## YAML based - [rliebz/tusk][tusk] -## Go based: +## Go based - [magefile/mage][mage] -## Make similar: +## Make similar - [casey/just][just] diff --git a/docs/favicon.ico b/docs/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..25d2a12e64a9c1d831a7a6c4ac1bee1b4a380a7d GIT binary patch literal 139513 zcmY(rcRbbq`#)|c*_*5+yzISaA%wEY-XkG|?2&{JLiWnuRFWOCcam(f_ul9HuJitU z|M_*hyU#EAXlQYC7-$hsG#(P* z(c;0S2~?C7v{2tg{fCQsX=Aq{c+DU*6$N=6@4s73UVg?CuU4;{PBnG~i$Vp~(B!Lv z%w0CfZC)DHICUzeYv=!qPSJnUje|wujd}c%p3=EWt znnyQ7s_vzz?T}!h8z#x3cM#w_C}oe#@M)6KF*Z(5+0}Sz9vsVgXo=?IhV0>7SicU>U zO+31OL||fK5-7&U=ZZYpp30AjAuK2?)Fj8w&@?@gX2)AzUd9b+EzvCv5f&D{ z-Expv=`rYK$6eLh70v04h7laZCoF7pGrT=^d#Y|1F=6UU&@%U!g|y9D;0`WESeW9U zZBIH4wrcy=)z$p{wt{-4i3J6$meqgy2Sn$t>^vK;8;GR#f<)#rzQUbRdFWrDrxrXH zdv)-SQTAdj@AO8fywbymBkLYz#$O^IPrJ)frqS!m^M|nK{AakhK>Uz!XSF-H$-36? zeh#sfmDSD@_M^a;5*c`YF3pn9gRy0JjQKH%aj_0G(#1y37NdA&nx0R6jXyc@Jo1q~ zo%Ll@w2`6Ye*V+?OP&L5E>pH6ZTzgVsV09GVyj&&LxXU4F0{?u+|e`w_p(FmQ=G+q!$G?*X}DK|ujK7gvAUE};=TO|s7pAoswIL_O0CD3M0TsJlF zTXNU3r{own_jO4L72OqDWQhPp%o1ak?PRa;uZaowvptKMh4ye{*N=JRaqI4>XusEO znH^&hOk%?D7SDg(aRWnAhxj*$7!)+gQ&UsV{yiWXtFoj|bzP4g6^gc&cp#LrP}*`W z3{Rdi%4R%M+P7r2VTtnF!I@ukSl%3GzYRYcCMM=_obtcJ$5Q)PlAc?r)sBqBW4QQ{ zTx?RacsDRWEQu*6@^!n#tly!!J`?d-&)8$x=c&7cux^|5>v;iku=u9Wo^9Sn?hzq} z{jSblBqPZ;NB^xA zV?vP80UMUzI3put?tJ#NdE(FS-)~Av&irH;&bC&&d5h)Fi2D%k%x|Tx!gv=>yx%G? zQ%C=NJm9qoC*gQ7oFV6744ng<-T=STotdnijg9-nSS6*Uum05qr2RPH5R!}M$wGgk zOQAWM$AM>KV^dT@`w`y3{PfZ3DKFim=?%X%5=W6VD%hRdU!{Fdi1ES<8a%mM4zmy+ zzuz06Ch+lyf6e0mk6wvTp4j#K3^@hG{zhr#=v^GbVDxxUq8Vzsol+l5j2hCQC1}Q$ zI9h8UuPuj#2n@;CPm-8$F;WZ0*%DN4@Cnalc-Pa=()K>i*Xs0akTx(jZmb$LoR56b zgEPN2k|(^|e7R%9+jJD)Tv~cdlicvT$A7}dQNuyr?A@+`yt>hSe6$3gn8#S+9m+&* zDdOe9S-(GOHm$(J$#H!A(&J_3;-6}(&!0a}<4Q@w%ZgLe(~pPU z&$-_+hYV!!KN|5BQm@t5*Joo0yxOOt^wrdHt z*yy^@`T04Q$@dSwj2CnjA&a+UjELnZj;#e~I5;`^squHtcUt=t0|Svip&~fRdaMz{ z_WkhT!`{i1i_whp>1v}X@3Y@!Dn}&h0yg_oJn z`n`k0L+Ax+8XC+hS`~Ai+kb5woD6*+f{~Yp_3)bf!g27@Po8-ACap*sK|+s$rsl{f<_$vX-(`mGGre!5p|leW z$y{#Loor2NQ^$5ef$#6{e`0L>4qn2XugZ3SmX7d7S1e;8Jjk`jh<}d}4(8_OuWW3V zMOPZGZyC=S$DrnFrs$B|VV}`>4*p*I)N)qqxxC*;$Dg z>*C_#Y(=!i@VMu3z`?1nukZ6*_JEd>6308%p20+&inq~P=FAEm{!Wl98tNMwsyujr zIb#3e>dNnTxluS*->>m;O;gi~KTaZwWw>=UaZ1`BLCF6%w?4s z)$vHrWxOgz)dB7yS>#nYbe7Jg{U=_1(w{}0^5qK6*@>SBv!5@yXia>f@<;N=_pk)C zWQ~kyn)>Z`Ub%{09UD2<+bjLwyU_b^scOI%Qygtk`3hVb&vKCrjC~qCWS02Ny;p4c^ZY65lpz4PzI4V%$=OJ zJ`^}S#FjsMC{K)VwzYjTIH)0W$4*Y-G9t+1sbs6H(CYzPtJT2_z#(gEYm7Sj`o5@2 zz(z|;J6lmyq>MU$#)qR8Blbr)p>0g$6a%Wc`FN!-)^)BX4b9%-C`-^+ch+e&cwjb9 z#dGcW#m3E49{#w+>k8fN&6_vQ7aRI57Z3CD@{qNkK7F!lo^uG^jC$mWQBv}~^xHS@ zM-~;a@ZdRtA#x>wQ_k~L4GR~d2kTN(#A#EXO&to^D<|XG@@gIi}F$O+-{%|xuP8x z<>gjS0vqyMUERd^*jOlgBp~3&kBPd7w(X#hrlimaskg6tkVY#(VMF^g<^Z@V&L+h} zB3h%cec6o!A4mM<201{Z1N|*e-`jiT=R4DfIVBuROG~%0n%2WT) zE_e(xC*{pI|9qxPW{Z8|8lrC+5a%`L zpDelCsNH}>T#C-R4@vv3HiQmAr)#NtHc=7k(sca0H$&2^#(Uo~3DJ3a^KYa|(W=Hs z)lIxqCUbplayC})T^FQa&J*@JZlC$!8{TIN;lddjr`BAQz9zckk#bC~c>}f$o%TY_ zus7; zJZ~Kp6_r3k!^saUD!iY@)-}T0NuVv?PT7?)nIElp%FTvDd|@qMSnTjOX?=a2H(#sx zr&U)>3R%Q!>)J^)5yaK1tleC*zZf0i&#o?@SD|e|1Gez={0kB+=N08^4fH$6{yH`p%B+<;gY_ zXxx$##2Xfs7Jfm&2ND@Sw>_6!#dcma%$&maT=(YNjG6QU0-Aw_1JVdX+lVbFexZ% zswF2TnjC6Onmy!+LSI{7|8Eu!YTbjJVYaTWE^*g+v>SwUa>Q5wo^^F~VQ(5|zb`2f z5*5|f*MIoj1asX3uVF^sP>~>iS@+`rt2M=u&t0^Vk~Fq6QCT6ihYxSKPZb$(DM>M`7Rp|)I}Lx(2xpIU*K+)jloX$pHT35X^`ujh z9FrVt!X0XSsJ7|?DGKC@QVc{TB?3}X@20kGEiEy!h91I>hXVcU*Dt0%f&Bb@<@kcox9SvY1TC$0HF;(&!)zjU`F2A1jT3adYJ5CDaI?HlEZ|CP-GjDtJaTOPQ$fL-g9A4;RzgIxlB<|**rDamB4ZXDN>E@t}!e0JtDhGXqYWCG?268pY$XR93i!BSVb0}q0 zn75P$6LI!`BzN;}e!Ca;p4oy}=->l2XTf6uN_>8b$a%q%tr-L*w7LW`vZLeUxE^ch zi*iXe_&AuU1=UWI0zVe`N=meh4Ii{GvZiBqp7}NuJ5{tkoxdj|{6?KEyN}iIs}oH^ zLIQ4x9IW-1FJC^Yu?nQ94XXG8d3vXGmyC>T%|ik@2&$7)<6C}tN}?DCfcJ@siMkk_ zEp)9IbG|irn^%>uUcD+ati?(0ds$Up{=8voJK(YIcpZQ*QvHUx@bGXdI{}&u_Q(h) zk=u1s+Y8WKN@ru91;;v}9r-j-c+6BBQiuvAi3p1kYR=~to!p`Gjx;5&=TguEc%B9a1 zfz4Jt@!-c|j=Wx6yF6Zo=WA>70rUGh*7rkax{I+QbLUSlRq}29`Q2aA$1+Gqc3R#^ zRE17cTvqleI~z?`HzhT7F+bUqnU1jX~OW;?0<*nMGUSPAQl0_>a7aq!9kc1O4nD-IPDAN%1{X&aH9?h+< zt(m*I#RF)D69D_6sH8VqboOm|8BP?_Qqy`sfgk4+51a!mlF)1t3Z}=yA2kp5*T|J> zNV~LsJ`tr0U{w!4!VW16N#B&mzq!rpINMDx5$f8O>mNpj60 z!{i)JE@(FZxzyCuK!tFyw{Kl=oj>;J>Fcwas4#)^Al}f>kfB$4d4wxZ}M!qp%()MLpq~Ni(0%pE=Fv zu+bIJ-`tRRwRxiGR3&?AZkTauNSa-m=@Nq|k1N#J} zOHok~Xa?Y+&Ev(>%k_rM)-q}qUy^D_K7Z&c^tZdmyO-VWb&0ROmjE?l|lzfp{Pd7)}(6vP4 zDn^D!}0e^V=zC&o+9;Qk>E07^8M!%nb{(Lml)zvpMn+x<=iWc4R+o@j_ z^E=~%(&$zXH)>F>_uGG^PI(4_9a%;xq@Hay!XNSDLrLhf;n>VkEUnbco_7p}ev~LyH8LehG6c_I>(D&A1vyWeSXHVc**uUI8v%RSuk6orzeE_;pBX zDhLT(k)VDr#lTyctEi}ukrENH<>ldt!NEWe`YAf=y;Sj#(f{al3ecRedR}4Sjo24)}_ z;{H3m0WDDFOQZ7G4)r_d5k)Vq!)0oERp=kp^w0j; z58{m~V0K+ysGWdme*Cx(GIJuJZ6jpkr%(T~M4YFKjCLAq}VVw?ySWlh<^n3Yz!X zg798b@Ow>vmnYa;L0(CNsIHV3H;34svu%GvFjrntfyg-DspK56F=V^&YwlQzm1T%$ zDHclT;TxV(d8JO4>}Yl*5v;?kVeb=fVEyLgL=Wfk5*JIU$65fi)&w=yh^{3#9=f^| zX(G>a0hd12)~+41t-bC{;x>vg-8ux=!!0N%xC2~x8F*DoVabLGJw5&Bx;hlv&?+YP zY@m?E9)&R#6ea!OOc_$;QeG{K59{xxm|tsPFou z*tt3Xc{VjfFLlN6Nl2)2Bm$t(e)6Psc$gUW^u+~=kpOo2r1hU(g>et8v&1btykC2W|{(ATFb)X1d?;^X6OdDf zWwp6Lid&m-!Pvb)Z24?pT#8YY{Nmz0IS<0&wif>NBs9WCYdji#RQB}C#v{>bS4?hh z?m1L>=z#Mc3YOXQHE=zh31M^pz1a7SHlJ+hml$h<19=2eTR+*FYYAsl2~AU^Ij|cl zytKuDUIs83Tn^9|fxMn0PFsfl{bPasvv|ImRmUjh{T>9{r1Gba5RvMCI5*Y?o+-Sy zz2r61x@m_k&|A-z_nL!QXiiOifRjBkWZY4mBl6&xX3$9ubr6V(hoFr7{q?J3Z;x-m zm0CRQzFlJ#`g?`oy$@Mk0S9+IcW2dENPDnrKO`nv2&C1YCS>J)`x8}JLR;I`Dtk49 z%x!7O0`CtW=fURB=-VygA|iTt=@V!GA~Gg66Nwn4>_JDmzJ%)c*hYYcG~$0I%bfpUt1qdrYh zJ(wZ6zP-In)p8d0XLeRYj1J^a*tho1hAP(uQ^X_rRc^QBJQ>jhj8IfmG!KkWo*0Y4cZ(l%Mn!VPg@QC^%VRd#$9^NMqq#Bi83giV z%Fk*`qvdrwn2T6GyRYj1TGv(%!G98@xU;>eOAC`cY#_%19G z{f#kYHWO|rT4!hHs=5-&^1%E@FX?H38QeO=9M}C*ndL_?<_&Ov-o?h&I*hSGb?&aQ z>4SQk9^?P8aLhsoaUkcn;{m#Dj>A))XZ+C1UBz7MjfI4Tf#bIuxil$)Yy)LQyz9fn zW`2ErO5{E6Zc*v}Zw>gB8Wvpc%hIR%x2~~kXote_-f>E>_P?BV8}t80N0_d`20*{w zFC3O1p2xR^F*EDH_L+L$mnBLom_yQY^Ed1VJ{AxDT;JO2aIO;+5@O*o`nt84R5>A@ zynI{V)HGB4#bQU@M491XmRZ30a*efs3K!|mL^Gc@UtxkWz1z@CfKM3X?&o$ss;a-G z+)ev;z0;K|kBLdE#hxUbaBFEe=K&T*@BoNWIMz+3yW)A@SlQSLm-f#vC!J1OG&D3S zZen3bU2fHa7**r3u7v=6n7*=NTc*dUlt)rH2CDDc@kM&5bIe$n%Aj|+;jvXh&xgKk zQEGgA0s?+9lnVodK9?O2z?9@peQaZaE`GUB5NT70ruO=PUt_aNa=S$_`tF}(*S>*s zI_(UD)J2`rISa60L8v$!cDW{;iE{4bDSG|b?uo4sIyzqzZQ=#~3=O7)P!f%HzxADx zbzH{_Gk(&=Pg&-C%I@xhP#ONyB(F5e=y|kIqb{ydcqmzIur&ruiYr5dEH=z8cAKXv zPFFZu!0euFEsaY28m#ZShrkx&CkqF`cy^|&IC?hR`Oi~Dm6dj&I;f8&5#Zyq{H`=Z zHq(6v)8lPwK}2Ex7fx8J763{5fKp#V^F=KaP?){*p}uaa9-Hy0a7?$H+uo}6Nslj;7BlBdg?A-9#6 zCCmO?6qFewqWX@Nbt3T1*DcR<^a+#WzR>GYqOnOPyYErRP@Cz+|nnhcu%{!-Vg z?JpC`tO-&F-FK(`4hO)QwyK>3`{(08?M+p?+h>edhtnM9gY2N{!YZFn1YYZdDxkd0_T9Pg)__XLlu*zyJM z*wY%yD`1SK$|*H`jiuJ7CAIdF?(Au=9c%@@oxE4W{YgQZ|2(tE&YXjT0UAY4F=aG(F`z81!A$Q`_LtQz!HsP5ZSRjxW{(VD|O) zE+UT}BYy?{>n1@dTI)I(89gs%!QgCP@L2SafPVvEAB;GMXV2Of{4%PmUkIe&^TdX? zHOsttWBWjYEJC4T^gVmz0hFXq`eyzwmtq62me{Nfc_tgYD*2?P2c}$F)Irt+s1G>% z>+`8MTz%92r!&*8?F7Gm|6bhphBXA0-dKK2(C+LOh}|h_ZPkMmDsJxuK7j+c5N@f7OhDS9kAgPAc>Sq4*ehl^>If+8YH z0LT(g10po6NcII^Yxjq!-n}zj?s5=Xn8`wozoM0G=6|gF)p?347CW~>t6jtcGlqhiLz zh)_WBf*3|w4PReL*l^u7?*?q|GQ_Sn?zm%)TUPgPk0l;z80?Bc$U*^IAg7`l z8y&sB{ruFb(yaY`Ie9J1`zLMO#cDmHHvGoPArEwhxBcQD+#p&!JTGeAbf@EXO1XZO zzSD)*^saoD*w-xJjlGa60LPLNH^5m-``$&x#qz8DOEbMwaV$4W3zqdn2{rTc1KA!A z^*=E*>;X|p!^C6;$-~V(6PRfBa`xL6PBxIWI!F}>tB*y;M#rnNyvJX0H?4FCV%O3% z>}df7HgJ(F%e*h+^u3vJZ^s{YP_Y&AG*M_9G%mwh+W~ixwCz(+OFAJf zl2-S8O3BdBkmtX3=;)vnq*p1*%eQSMH-1GCQ0Ugsgf!DL)D<+Z65C|F`n^_KN=qUO z93W>!NGH}hhrFJHw*xknMNj;_bcvUdfNK)JH^_#I@GJb*zOO}g^S@QunD4}<8EXEX zAzw{gsyFMih*MKLY-{&HaB!dVKLt4l2tJgQ)cBnrq-*xt)=mc^uTgCd zR1V+|m5m2@l3qL3(BZ+yjw#PN#~4$LdYfkQNtph>k^8D-ft|hq_x{5t+W&cLC|;SR z$kE=q$oB3F^>EL>q|47#l1_I1)n{D=<>cg~%in+|0)aHsfODIJTX-*IKjYR{#aEA6 zjEiXI^GLKx^2$CGNclGevKDOKi&{{?%+hqszhU5H12EdWoI@fafIsBf?9Mh#drz5s zI~Z71CnUwPfBLsy`>{+6d!*C!x45JvO1-kFcOyF(tx(6^>H#gH?mQ_e>A%{^D=%=< zqGk6x$aIzRG}EUTSV(W8wp>RC79gYse-VbZ)x&D&A9%NJy%3{=kkKjqe#Y|x*);he z!@GP`|3JNy$%+M@2l+9Bh5*bM?v^%#0D4V3ZuFiQb#2+BW(l*xDwfgqw!*+}FR$i- z{(gMmmViHBTyEECo0@8X1z3^9)Sqd|9vLs_?0$YrB7@K{2|@!xA|e>X(Mk>u4hzuQ z=_EbhY3Lq zihuE&5z^^WRg%etclrb%GAJJA0Jv}5(Zq2#_ha~svz?MIPD?9k zE(PGGr`gt?U+OP+R@|vj{-?s4u>N^!n>**p+l64~gIkY!GVQiG`)GB)M8i$Go$Wb= zl|pU;OOr)N{HKEXM?{4-NU<}{Sy2>$mLL-p0_E)+$$N3Qwum48TYq&tAKhY&dO56~P160X()5u&IL|Fm3cuNBj2vIaYAD163wDD1zX zFt*izZ{N)j-m716+)20G-&krypJ)2+EI?R@ElwHCf%B2rfDWjY?o$;ZAsC>djp=@m zEMqcBOl(!Nkj}dPLB*f=8{R(!$$9d39I|+NGpT+DO)We;JRti7M1hGqH2+X^~|UUz?C&P zsqG*E z;;0a=ix$-xGGY%s9m=NbEaKHgRI=u?_cYxbHv_wES`>fnt=C#h5*;qaB2tPoJ)Il( zm3F>w^3dMC{U4+yY4}3h-lwe(9W&TTh{<|?0^!&FO~r%bSf`doM z3=%7u29Ko4vABcdvyrpcW4#=);iBc(^}0nMHE&&sW6(xX@fK86?AYXucppSI_Y3z@ z@Pk72V(#e3V@FMvGNWyUOUmWRdwI5l;_yJSCR6KE-(5{(<9=`R4+SfUT&6YTg;Nja zibW7hU9$i77TSTgxJY=c4ae%2Kh3{hU_>l*8@CPj^r*0??@`#T+2 z;5>hrK@eNT2*j5tuXy;{>a$}ErKRraj`Nj&e4<+J<|8VxeTJ~7GtpZ9S28GoVbpUsFEhc-J1y)Be)ogX}aqdo*g%mjG{QjkBIuB%Y&n_$A$5Iy2sLL5OdifQKzFTUAl@?8$2QaZ3VGxh6t;h3%DKH z*7}CvHnC#d)yq0T>l*En1o1e50}K9}v|kdo8?U?qdm&$E@Y$Zk?DFq~y^|Ag=arN5 z)u)45yYwsgtzq~Oj^4d=f>xrgPJsFuP)n{Vk;g6G%Zd61g8XfN)!rO^zoE%8r8{Jf zZ#Dn=OXQ3GdPAgfe|;8RNdMY1q`Z+4C&Zn{Ce z7$Kc&;pBv`*c0M`j+yQ7>$m8^Mjvms11+b11&AdHW(Ke2E0(dzrTMyS+Fuo$bfC$r%zb5lka-0dleBGo9_a5P6gWoAgtB1 zzf^lC58PHLfWO{+Ioou}eNs4_!M|rQa*H;x7vJT&Pt}$vqr2BX(P4TCwiFc(GICR(encn5|@+c_bfMg?t zKWbg(WPnB1gPz^(rxj~=~(NKw_)w$$~}SmVV;>Cw@V>rgUjQCeUqRzXz2;P`zu zd#(|-{g}*u#oLvKDMNm5z(Pl9!YK9NYQO9JVxk3+4FO$@w3UV?{j^xh6gP%`TleG< zd#3?w0Z^YvV&CwnvVZ>E2mv@tc-EeeWm1dMxY3g|h_f=Y3%A84J>tK96#+T+IkDn? zDGXyYygFPlt(#I043ve90Z&dyJrB+*h}F~1qVRpTjXQm{H+tRs76tA6b#)r=)HqQ^b|e!N<($qLUfT#wTTd1kUf)kb5c;wH=`K zc4ur4ZJ*2HQ{7(lYbL{jJnp1ZK}}6O_%$eE3=|czYVW?#7uarLbxJJv`sc`CNyxWz z_N)=QEENVKlTo3f`Brqur30;p2@O<+X&-`+d?F%W3rb5jWrw`dDt#DDiivnQIUg~K zxy}!OC&>$OKN}y%^!Ug(w`T2xX!%oZTaLPjwroa5DPD&pG}gJ_Xm5W2#>L;MDL|1B z#>}4Bv|*~Os;WBvI_2D;uB&VMYMBBG3mj08ZnO;y-m<9FUkmo*^!7*i4H6s)611f! zJQ))Lc_TD5bZe?E7OeNGt%7oo50$Ks3**^}>8^1v1Elc?UdYDEUOWd+2?;6g_J#f>%tRfr*ZH|lN`Joh%n%W1abAT zcaB?oD5b|M`Chc|UZT_G{`_-7wYIxk2&r*cRPI70p}JMstgJ;x0WSpz>llK_6&)Ro zimqp7GQ==SDp_P_{L+;n5wkNwx0{nk9J?THpga#fUCr+oIE24vHM}};5Eo|6114TG zVWyRAw9z%sr%?NwyJKlz77$%?5~YCt2hI|C8}PH?tRw7&HYCBjJq>UpZ7BTLs3_>8N z8oHKVnbiy#vzM_)vLvWLwAR?11Ox*W(#YI@7-2P&T&TekuoM-OY=8>UcekxG;N~U zkQEZ9J=S2qI*CMa^+77w*wajk0TksBaCk%7m`X}U|Ne~}vA4c1H;SO4(^;$aD3DD} zjny1h-tvpt-+$rUuq^^MH=&=5ne%!e&mi5r-38C!$)?t~Kbwl09gbfHox_v3QGF|_ z^9SSyV)9R!Y%LJuSif}WnmPv`%w35qBCosD#w*y0@#?$#A2{5qR30z8K5}szl0F59 z2Dw?Mx#kQ5u9GidVe)mlbgpeD)C1p?2*^*ijpho-aXckT-a}3 zDz7KDP)s4bACY31am$eRPodzd*Lw8IG_hYDXm3}l_FLwScG z0k$l^co=%Sm7=x+;=*ZZh^~%~-gCH8;gA)iP!-{}ou?;15)(^R_n zM%xSZ%DGTU&ITl$oQObh|Wb2?x;wN z1p&RCt3cKV`b%oO@gfHl zdf*y>zyIl}Z$B^p?7`Stf3-uDapQ$Jb>eXlB4kv_P<>u!L4d(~9vwB91u-VnB!oe; z-#Hs-zX6PAzZ;u6bmt>)qcxezHbbl2>gaeK;OCdFz#P+=>18S#l{zN3r#@rlDB_8N}A2)Ip=ht-W z6V#+4C^r2BnP4JhzFMJyaS)hngglOi1U*y}f;gb(f(Z!g#uS^jHvJK5Ok-I`B;z+@(E5Tooqllz`F#<;sOJK6eCbo z+$Pi5x!o@3x>|7lQq$6kVFc^*XQ4WQZ`079V4X}WsUSB2bgS!hCwKYH=Sm6ha8Ey zn>vypS-3U771teqf5ZyFaj?4^7b30h4wafwod>6kFwMC6yS%R%k^sR!e*8fB8ba!K zQ`B-Do;uq~k5Tc7i$~ zrP9S-gqZJDPF5|Gz5X4TYH264bkMonWAp?!=FGiU%FdQOfbW;rAR6>C$d61m`HEIH zUvL1Lar#pg3~WkAw{zQ*j4&J(_=Ils`u-gd7nNB^A;q4~(3*ZniYocL&3l%cKq)#c zb1Eugpoz1xvhuOm5|>j|+Ty7((Kke<(ZEoYkUv0 z%5l8pG=6?&Q-($h@0NZ%3xxRG#>27#L6*6^ga^3%mD|Ww%w+9IX>o)PW_O`bg3S+23XE`~ zz_SOSn2)C;!0*Vl=#ISa4nBU5RuV0D{02wWr)3UnnU zdg$eL4X~YWh(7=Od1<~awC?oeWOQVt4d^aA2S=}B^*~0>>FMd%+}vY`Izn{WY36%k zV~ykcBe618gvyuENwkKC3$&tNGEWaHKUAm z0M(#dKyoV_(n{$HlSfBFkSF|MS&cG9277%|cw8D0(~%r7U(3NrKuEYqNRV?{{*xI` zUsz==kLm8bX>%M(TR=^JK&}8RLafS(%c>b?B*U=q-1Ek1V`0&9CS2qa^ru!Zy@$Ol zvcLyeJ9=YGZf0uA0Lu(x2JQ@ZKu$UKh==zs+xBRA1?tADek%2mHw^tkdlhaD|Vj!dV89t1F?$D=c z!1rX!qMe{FZns>@?oD<iz>+23e>PCJ!cIzJBTZV>)T1FOJr)S5;+85fx zp&NBr3oI{Qs8ZOOR8$hur}57!%lb>MC@KFX z4A{~zGTM1qV`*!(Wls#QUw^f;WKS_X7l0D$PMl<~-8A8C*;p_zl$4J9V8t}Yo`2T_Ke-$_M(n{}0c|uNS zK7Z8oPydGGPT|+WM7B)t5XP(d8*mubQQ7m;)~3Um=Dr?XBXlTsT7Y6~K;{yoE2z69 zU&L+>^~sA~q2R99nFUx2C`KC6ZX6PG{(vV`A%2fU^y)X0el_4iNkISmPzCTm$)Y;N zAjLDiS`C9(FzGuO=(lTx)n%L4VteD?*6zN}8#O&8Y3b6Ek~gNL4w9df?}igWAOkn- zzSxYj)98829zlUq#o}JN`@Ylcc|CXV|3-NujyER&1VwaO*0(u-c?!}iD{b`XlhX3S5KuoM#a7d~h_UOmdR7-%j2t)v6FQ@8UR*jISjIWOEWbX-yWT++g(RLW-9)Z$Evpkd(GMLQ^9{B5cN4*5%(^x<%Eb6NpXl z^x;80vF0cwcV);ZNY|gSY`f z-bnZSJk#B~cgZO!5Au2aBcKAoxB{f_?vcbE9z^l(%?{Gnnx0T_vU61a*!Hxl`?ybZ zG$tzDnJ0_jhvQjq;|-H#PYv!XCl23yFViO(fuUU3_ZOT+JbwmSc`C;H$ zJ0na3?AW9hjQA|_ZMyu4^od!L(;eRUx*p4e zocBGur(@&eiU2xbbc@%2{SnG_h2a9`5x%b24D-_+X((2(SHN=uPXv`J>#=4|QG+DH zeLx0art5Gdx|fL45sEzj`})b#$4}F^*GOdhG|lzMl-Jb6=wi~lVN%)d7(Jbaw2WPq zXJ09v1wLs7%r1ccBQrA@eVFhe3AK}I5Vzj;%wxxcLIQKd#$g$PQDJ^MD<{avTt0q& zc`-UxfSVJW`?@;B2|5s}I!hhB`CV)@wbf$Usp;^}_ot6tkJdDS0YZAN8HOr$b@lWJ z;S)A^Z|IMsp+OOsI&H-y;_}_^q?&B-WqT$vjrF5m+ssC>-SUeYWRcMze)ty7Ec?yO z{r&y#pm^59NH64yVXwHs2uqDcI}R=FhU@n-F*+O}sb9a7UM#8KPNB}q0V)ml9;B{F z6kmK5G0~+!sV%VBa5P}@1hz9)s61qLAsfSG!pOQl$}ZCTnxeh3qb&+8lpeqccrEU1 zr0#xv#P&O<^^-=0V13Rq1m?WXEEybc2 zTvog=lqpND2&6#Cj^TwaiyJ*QhX4CA*1ec|!q~3R9&1bR`%zJ^R}fnenZJQ5qiwpP zXwaR97{uNFK~|A5v`vmnAawkdX%@qmsHEzEYn<7DOKxC*FarHlkdKc^M^7))J+$6^ zb#PZ9Z=^v|Lc-0W#cSpz6$DOr^Yichp;w|CoNQx$OUqjOnr%+~xj#ec?_Y7Mj#6jq zlGL=cisbl5$LGamSCv8{zn5Gko=^bn?KeXn&ke(L32dd=x=f{uX-lXGP1$h>IfJT) zTEtzp$9My_?mU7J{rra!yn?fr5`eA}k22d}hA!)R%Z^UmjiqivX3V~y=7achZX*n1 zEAMTLm(CS(_=$gf<|2`SD!w3GK`OVoIn!QVc>F?0utetnqv^W?v2NSH5fTkbc1S|9 zGBT1CN<~>22_d6|jO-m5Aqv?=QHYGPcS1JF$jB~=kZgXR>wez%`Rjh}yRPf{j`KW^ z)%r>iitHe2_#9*wC01G>Un-qr99{LZKxv?el z-TJ?6LP9EvhvrJGWf}sK#~r11Qj3aKDod_@D=(KmZQbY7E`DZ}{~C?_QyLkeE1{_& zO?<|}#D4po4axk7!Y*BGG_STKQ9VRW-C_49!+YImZKG;uH#XJ!@ZaD1XWae1w?-KE z2EUYj>~F}IE|i?3jkiDY33Gx7X|-OGFA;vzAPP*pl!U92V3~@uNN&=Wg?|b$1wb_f zWMFZ73jTYpa>E7?hC?k+?30qTFOu5F^O`#;(VKNqMWE(6i1`qtmSwuQZG z`+%W4m;qCm<76RizGNZw6J3@N!*R|9dq$gmDjIsFEe-UQe2Y+HU5?X^ZQ1=n?%8P{5^vt-bU z?*}x4V)x_pl4t+)(pGnWPAf`IIQ|MVx_`!F8T@tI${viV3u1qr;ov0D+w$`0Ptnhx zLug2S@dFR-B|pK$EXT{IV0NGJ&3RMxd#t;gW1o20?nVWUP91HST86_vhJ`}6&XQ*$ zByu^w`tKGE1+r5RNQx46Hg#I~3nh)}qMyPtO$^&Cusi$3UFOQpatKabn#Mz1OjDsu?oM2QPK`R<#bq`ZXWaC&z=M(ABY7`U#A2(NaYy!HW+v7rp1_N%h^~-t9bi_W zAm<4A^Md#Ijb@6_uW+Y<0hwCvH9~ZjhfU?Tzv^*CDUW++hvuNn?YG|h_kLPgP|TOF zVgSZLe>&d3e{e6kZ1>R6-80|bb3Hln<9^xB0OBTs74i8WP4o&+7IH>^?B6PB7>|1^ z`Ml_{2HD;*!QD%53L~Fdn&nTj>g((O=bs!k_&5COqHD@qg+Fn`im@8X`UHR2XWkDF57(~Q^q#*tytf)e<7yuW zp7&)S3gwJxRm=XgSbrFBIGUT`Z=KTj4mfFF((bby=8^afuN#61SZ03e*!zId(pLqHSLGQOpjomNz~iIo)BEITfH+%sL?_7#75`9tcJS5fSX7KEt zXRbHWAf-KbR31u}LZqA9bGpNA5VXb_`PC>XCgpR9b zn7Z~nZMtuxg?7WzMBh<25{pPi>69;QTqnH80j^>M&BU3#YGd%1l}F!@R^BsGs$Csz8`M{&VjZ!2Rgod5xrUT zZO88SK)=3!ZpA+)*_}0q!lE$hFw2)wBq4k+-f&pf{xo9CxuoTEE$0l&{_#9LyXI5* z6cRFa6AV}Xe(a3QZ#9oc6S7z_?|A^NAV;J`23NI*L%Mo=a&mfESwdS|TjH1oprOOF zHa9>0FfrKHO?;db&Eu9iL(olqoL@=HoI!GuDt`5riXLCgF(io`B)!?Q?OCSRRZbo{ zzS$FdEnB}myvVx-KpfO0Q@*=db-(uXyhjnToh{{yqG>(>w5u$=(n2Mglv#Kt)zN|0 zKuc_H`ZbK)`aTtF(L?KN>6w{P1M4P^Qp745$@?`*|HwU3(k2{jr|)vaw?!#D+<(EV z`Z>>l_0^8T&eruZR!-K40{0agSYXL2*L!lOLgLy~9;8^23fzjRIw(dmeVZ3cwY03v zfr(1!IuV!l)!_37wjTxQT~)c$d;W&crK5hylXq-i{L*5E>h+_^sqV(c3+ku`Ry~S- z*9qm4KSw-6tf8BgwLrK*8z+s#j-5z+3nV&&HY*0Vvxy!h&#nXbRfXns=S8deAz+}a zeFYW=2$?GT_D!}8Wu&LutH=-;Z7;?`oJ>s2a$lr=Si0pJb=y(XbSsj#Z-;Q+z{jj> zr0&ldTzowG#jo7^d6a#ezPk>K=WRYIcvAxb@-(zw1oMl2M}S5^d;OsBmi-!0+vRmo z@uNtvA_&G`Wo4brFfVsozMX!z{-avPHgE5}gB<}s+HF5t3ZFVFBqtnK_&QVn03U&Rzc>4;1ytD=yZ1$jkc*0Y%M=oN1C7WADRAs zkfN2R{Lkje63%2s3(3ry+DEl|uWHOx+0$B?{1kt3pm4LYwVi$_yLlAFCjkmYMMo;% z_?A>4KxAL_`O%ioiVniFP~yBODiXJlxTR+f@i(n@Z+BKvl!WJB=TplxIXa3esjjV3 z1p4~=b!MzC?|p-!Bfr;$TFQ`~C&n0B-)LS?Sj1|&kl&NYEl8p2|LOQiA*K|hbA%$y zgbruQ4&9&LY4e-Ub>Psp#eRfdn$xns{=|h>DLur3mR^)~CnSO^TQG0?oE0bwu`P zSBHEmeoH&gZ#41A?io6;g}1hzq1a{?8jnSEbah2FGbLuxd7KhikE8Kt3n=M14@eNK z9inu)hKIxXnhW2*hn^CWtKDAXOM3;Y5}ukpJFHl7-+*3+G>uo}i%1s#y+7aOZHh<9 zovf`d^9cx4&fS+@vLOP5vRwt^&?dZz5A%vLm?aZRjXSB+nh1es)rkrnT|i7gGPJpm zAQUpcn(g;U)y|85|Ndn_e}9!W0Qy<{S0Sdb%^ssIZ8gQEGb3yJ;lL3ju$CjMpTr@T zBS_#oIuP=eR#B0JO`U+sKu>NVo0aX?v}i7zAKpauvgQ-nE>`);rzKBs6?un$a$y0+ z1-6OsQI9zZmUxsg!#cv73d-Np0=K-brh%RVf&q;$V%QR;B2grHwx4}zyDlxlbs+!W zLh{-)#U5pSI>D(X?i5a1N>mnKoAS$PC1ghKmT6555g{RDrMlWjLT6ARvisR1^Zdn< z3>yE=sI0+__1Ro#_U*4YI4tQK@6=0o&##O?`WygT8K89pEbztjx03>+!e>C2bb{yE zVKz!qlD#c+YiQ{+x{(>ssNIO_#DzKb$qgs&b-%7qfxuIqrG7RR!zR~;+yqOH21>&1N*$b^4 zy{_|lx^DrCAn}MsiKc4A_O^}92g8;nL+>r8A>d?l|2DROZ5Q0`;f2OgjsLth0pvuQ zUWWY=yvJh;F`e|$!B@zFF7IyQrL-3g?=&-MsxV?#H@Gw~b=1Gn?wZv6=_&sUB$j@S zzL^PDG@P72#qirU!VI|9w4wrN+p@I33EbW?K z4txO{7(qA&Du6#>+0CXDhLKb6pTJ(lq6{$AU&1WPZFE__<$&er@=bgl>DwlWP)wTVPf3OeG=W z8RY-zD9Rq*9NtG%jeku(0@9pFSvl~EH;v@HmE65I5%ekEfgoXi_HTZ`d7g@bWQnx_ zaMY*ncoIO$lNTMB!#*WSMeu|GpF0+3nF;Ld!0Z8JjNnjjSIV=4#1IeCEF$*^0xvG=K%CJ!(DUk48s8lvOT&$I4)(0X2D z4D2qDaD}7sLIio%PO;0vm|zuhBMyT^_4cOUcj?-T#0C5lwFP02xFnO+v;GY|pDy1gY}1Iss>**EbBhsX#B?i2>|*%zYG2j_U(yJAGj@2R zt2y4sup=lftyfRAK1!SCkk{9o8<(*Ep*fmPb`Q5m@r)^(uS`J93r;nj6DMkJzn_xc zaoAWXxR*Z1-ogZtdjMZEUe=0i zX?nXEt=-UG0t`ctnbEi3|K@j1f7t*fB@BTP0`VN2)}|c)Lbm|e62>G*4sa;IK!hYH zu2b?IQzkQ%?Jf=^Oi$dn7rV-=C_bd!@r(##78e#4R)A88`%3b}wCs-L*|TRY<3C|N z=t2pHpeZoFB8I6vQ)boECcE(ID9&2VRX7hSa?lW9f?m@E30!Rn7CbCa95;hD&T8h?Hny@lT5yN`K}s&L(l-X9k8hOSr`i7y z)~nd&`T=Gelb`-ZM@uYsl_{M)(e&VkM%?39m;T-JU}1c^?-&k~1=&@#c*c|DVN@ zWCvL6w^o3YCj*Dx+9;~py4(4m4ec7i)&La|E(9#t2ip-f1eHN)-L$Fi$f4u(r!L#U zPCv3y|MS&ZD*4DaeAyg7a@ZXmxz&nxYbW)nc%VfCvv3n95MoVXq7SYy{*KfG#1%u# zf!JFlvxW**Hi8bt+etvmAcVoQZ%)v8XFYkF(zf{Fg&`^BFty7UnY1nBBJS7g$o4WX zY*M21MR*5M?<=iUF;gORr2o7&zKslD*V8L`Q&8|^uI=>2thSMi$>;)&UZ8qF7@<*k ze9QIN^eH0nqcb>#{GvGbp+*IA+zK)pu=3@(y#`U7c-Iing#5+Sj|#=d4-+#?&m8c3 z&1=u$sc#_aeSDq&@&RdBAuoICi^TA`P|ubxo&vk+)J-R6#5l)K znd!A{{77+GE-~LrL_pT~r?0Tce&)YEFF!iyI_YOtZT7*W)r<)A8Yv>ltG{kSIk0_DKn!7F?@Twic=LSWb6uREyBG?o4~B=~$R77saWptPD}7#pHU} z7l9k{T{AWM-(O9vWH#y!DJqGCypB{S)5w$yJ6dOV?fk_)Tkk77RYs_-c506}59Yn8s`9>8dy=VstntkBJwyl=X6x5=U)kIZ zq^d3NmJV(GzQpdM4&AEauY8NjN=unU;x2cixT`9`%bITMIeT4!BNE0=?NDiDPT5*b>ul##Fu{D7)Yv{tq=N8gwW$6)RQ{-<`Thm9)MSUfN0zMKc zD?Y!T_qem2ciCKYG`sTAo%-qR5rT?Z zOR2=T=lR${Ht|81V@O5D0>lZEb%2y)XRy25p;KE3L1SaUYWhoP^%J^Puk>&YDjzXj ze1CRTkUZLm>!(4m*^yYsyMM1Ha~kzbpGbXB^Rq3f1@_<#kCmEN_Nt6NU0q$q$OhDe zZ5wi;a5hPzi~q`3e(a@NT%^RZKZ+0%$^gjR>>#~h7F_7}XN|D9U@Z^j?;KBJE-Mrd)N2&fQ zZ??K^8P0`4|EoQsi=oyT7l-MZF8D?ELT zj!iui zeu9z&(tNl(aps_;yJGO#=SSRyDB8y8_OGHQneV=D8h+1iS-Y5;8C2%+p%_dEXF}^m zpF5S`oKF}ykQ0GG{qY`oxzs)`d?7r^-W=lJ4892Jw*bY0RtxYdQbe=z`+u#6dYX$e zEeF)y1RZGN!t&cR+p4H~Ql5;Y{?hB59InUSkmw| ze0sp0E+X_qQ_~>qaG)&Y(FnYwsviB!o%@{PNfYGPFR*pPPgXnnXQ#ZQz)bH0a*&Qu zko?qj{9sDQS4~3Co~c3+MM&I%7J`;ik4(P!$KC1o)na#uz~6`43>2O~DrRf2>BG)1 zODPMPOnkO_m+(jFLSe8_f%_pORTL)RnM2cM;;a!PVj?2`^(IG8p8TN|M@Ijhgx;Tr zLSoRBAiG(dP=U^2zRfv7;LX<3kdFggXKIi}EIx+*oP{z{?UkTQM8ofwh($r54o)mo zGiahzkiPs7AV$?tXJ_8atgK5|>}218G~7H6)mY;Tw6c(Sx+Oh0e_-m)2MfC5m}eSJ zqGGw#x8Fn25|C~s=2hjr=20|jQj)IV+x~HOIUTV~Z;I+h|B%a5Kid zzYT>kq5nmJU-;p};;({su*PFI@=WTTXJ=;#K5Dht=4DIdzmH>g*hM(>l*sF>b1Kv_ z&SjWg{hNNt@;6CU&g=MUOXEkV;_!;+>GBmj{_Gk@(yc3s=$bW~k$__JeME9VX0qx= zpX1?}K3ut1Rz&i#KwM8#?62~XyqA|nnUK#7U(X2v0SLnv2OZksTLqF=esla&SOS~t zMC8aBrKkH4FdnnXEU=xawN`)_cS*NeE zQ|TZaVEv-`=H-D0$6HwVq#)3IoW32T}{2paZA$QF+V@BbuRt&YX-3D zoCh(i;S;kB=M$Yvql@4A)_=;%xlZpH_WI>c2mnc~H_6MrUeqQ7HvzIp9gL~vBkwUP zndd|@tdQm0C@1@Oq*1Xvc*6O_4EIh@+0I-8U%%tYPTfSL^Z8-{A(&0+TVC1( zH`lumDt8|;fy)m)m=u~ z`w+^E_#wzjKmC!2NXFY~;n`8+@5-X)q{{Q;M&$pl(na&$7qtLo8{ z-pnaCV5vvHcM!TX%j zc!h1$xn58{`@*LoC4cQukmbQ+Qyd|eF2WyGZ7FIJMOrwUc8Bhn1%SzPmEy$xFgxMQ zl-KS#LWDl+C!WemyEAipgVO@PARpi0;fRJZMfJqxUq;{ElzN^~24ZFaOrj*mj!9@9 zl{=QT=dzVD?YQ-cKT_uc8Iz8@eH{Yb1OW0+X3r+xzp%$98Lo0wZ~h>VE{J?OIy>cg zqt^%e`ud!X?zO+cfaJ1)W5^$?Yimsq@BY@U#K%(pobCC$*Dj~u>tr0Grufb(t)NKP zX!-an>E8@n**M`;vu;`nLN+;8{wKedFWND&`rp^jk#b~yjC>G|x6n-Q6WVslw}uA{ z=*fwUp^O3v(*a`r{I`1@ZL&%Ud@55>@;s8fKJx7RnR|CsG@)fgTn3RD1))@l1QvT;$<%Qw-E6o1nCA($fd(d3m#wEtC$SL$&Ht$ zT1T#9APF4#$9AtAH8A#}jPe~Qbz|9oeoo>~p7%Pl;a1Wa#?5cJ97-8NsnnWed(BVk zX&++>8-sDAFNE$dwj~}#_B-zgKNavG3=~?thiOSiOaE{fiO(984as;wvcifyWM}=& zZF#O;UW*ml)7eKTI=+<0I1hVKVT^>55*hZDs*(1x+{(tqQQ{Es!SJX@rmuPGtc9W7 zbRE|C^y?Mh(|Xtrim<+3OmTHvY?kuXPD& zucGW=zI-9-LAn(bKG^Ij(LaB}-iM5gnr{=dWM}@s_vux98@o= zsf4mfJOqM^A8~!p(}O0U4mqmm$E8`FU8IxUOM=Ekms*`niHMLv8H$NCJAzQ>^13aQ zq%6Fb&8{_bN?g+Ixb2|P+tFC#zZ)_C5e?^%d4BR*_H)p6XxacHfE2}soSMlCm4hgc zO19tO$k{5MMiRE9rJv`n&2$y7N8H1?iUSaT0P%kCn*U0gzi+g+H=0Bme~0G1 zdY#cb>mA5RecYkQyKJ?dPk+PM(%0x*;Ne~2c78Z`L4AV*M~Xf>MF87B5r}Lq`+V)| zbGdmqF{06_=+nLcg`Le$%(jgc6&2-c>sdVgODpPDddG445u^a9E=%lG`^|*4<1eS% zKD(Tri=cv2>a>i^%nAGlk{?k&J-$v)zC%L)Tp?B|3|0tVd}oXK(%`A*<8@x?sXT5< zB~sHJy*-pf-vI%5O#;pEZoU0}_zYNLUhdA>N3W-K$@*B-z#l>021^q1O zSnzt?yee{mD)l*)0qIfghp(TYM#kA~rl%Zpi&VZ?U}l#=Ecx?_immAX#h*96*y23Y z>7Yz*E^-1mI&`+!?^}Pj+w<1o$4{b{OEb(RMB3wKQr!JP%g*}KfX8hZBqbi_D$&Za+RF?*faH5)d1`Bi zos?E{9Xt|u6qWlQ?#k%ib6Q+p$v}4(K3tf|j9&oBv=De8hmY$C@#;F5Q!%!EE;pEb zfbZT#3+KHMX6xY(GzMpUtNC_PJ^5>w`QQbQ!IZq}a+1x&KXg2TH%0Vh2-~>FRqND@dDbpyDlilwNo^Nr&hA^^XTK6z50|gWfkwzfAqrz_91F9u_ovgw z0*booVo$A^9-7`i4AqdZANwz|C>eIb2er`u=RQLz)fzTpm36)8BNWcNQbCGB&c5<_j;hG&(8 zNfYVG1$OFZp+t(b_1=Q~{9DoN`;ZLvGLtu-Z~O$GdDjoFf_J-gzf1oh z+n4+FxMW|GfzwYQ{2Fhx5KEi(zo#HhB$JZsF!?$93|vcM^3*|reg$_#LRi=5@cW0wMlh)_djfmta9KLvo!{H)b|fxuYaV{=4RJRv>mZx5Ci& zm&Xckh>3mK&?^wcphED@Bhy#6!Tr?NQu@8sB-1askE17nbq|CAw8rSb_|f2pPMYE* zMwS4#PjF;pj^kBYUkKf0)k&CHj9te-g@Fz zz>d34U9ab?j}pX>{j$f$h>A?lg}gKv++6eg*$}5AeOHtTAM-mQJ|1c6?Q@g0z7ZC? zx8fa2Zp-v39xmCS04)xL7RwG7{k>w%t0DB(=!R!JHml2UW;Wh_4?q(;u;s416PKvC ziP^-v1|}tk!?HNWBMJ6HELn_ZfL97zIkWZ}*)BWs8sm3m5H~;*W2T4EJf;UlFOMlG zc92wssC8V8x`+J{OBR$55QF&i8{!*aYVF7&p6o|MsHL5B|59+`C)Ze#Ed5Jqb??Oo0nTFvW{>G=}+qT(~i=@m^6%+hF7z_?)`ze@u@`D}1 zh60BfjH(x+zDR=C)ur28&GmRBw)#CaPMHIoYNKufqsHNak|#$i68slR%}o)gj<@y@6!0w(IijznM}z6 z{wK8@hFcZy_lL#*;xx>Sg*BCrM^X50i2rGS_dAp|e)ORPOnMeVAbRA;ieWBf|a987{$8is5 zJN-L5O1lccDZ;nk>mPvH6*%tCpL1L?UqV&OOOu_-;?0oGo7)>YGJihtPulr9c1(6C ziRSDIekr>5u)H=QQlJhyj6~QZQpPGO(~4c3#$^iM%2%Px@83$$h@^9Bg>x{=}iJ zzPuCvlvW25wsX!VO)gtqeEX$^AJ7>|&Zz zS|5+bJ8DV~?WQ3qj$zzmN)HnRZq=wAr> zM>Gc{csV*kNy4*=iv)U_vkgBWXVRx>v^GAh!nTA?Lora~AnI4}Uf5bYXO|!3Go>xo z*3R8FrWI{59U>UD^kQJy1ffhSuPZ#FD#Eb$6}`hK;SIqveUEyp0lMI?(2(N9dZ0|6 z_ewA^+PQ=w#%ba(ZC6K!+>KWeuRDX)I_zbIXc$r$8m5;fLo_DnW2t-Nrpq?GJgM2| z1WZw16G6WQ-3W5n657rA^$U4Q!M1OQmfXh$p^FsB?wze;jc8yBQ^pB^TYZ&K()`IL9z ziorujow1;LKvX6B|Mnt1u<0tqH-0*r$B#Gzf&6m%r*|Ev(o^~M@%q?MzV)RKeAn~eCpyfr z5tmBeJ$S+7mSoCw6Wc=CMEUuzuFKa)*c_Tpq%!)hBxL-#KzU0cX3*{cE(Mz*D$+Fj zJryMm=7(ooZz{g48k)zO_7Fz_tx_iy=Flj-xLRIXs(=0cZSC#1{;cm>k3U{qq7tqY zAc|HKLHyzXB7RO&MVUROTrG-T{;3Sh;WAXX;bWL z+S;+_)6~BOZ~ulk(euT4@1g2@uwb2gqs41390x(tF}pe0{$EB8JA`b!IQD z3KWYq;p9G*94oOpMh86zL6!(o6mUdozT1-bixNdL3w0XoJvighh=-)MWM;b6l46oA zrJ;o46`}?j3Q`T5qOvow&8MWL0V*qLFZR(Jn?5H0$ZzxL9|xz(*aaPKvAVJo3BS^A z{@7=}QmM#8JGR&?IE`@D+VbLn%JSh&BTIE9^ESha(yZJm?Nw(F|DY#5s{5l)El|eD zkpy>i_w>|M4oXsx8U?(==e`#C^@}8)A(QLUQjW1P?(gHteP7vsi^C$NkFJt!cd{)g8OY)qv>!+qhuq;@PQlHXu&=SI=EvjR)b zTj;#%F(aqjJlHCnEYx(bNc-2}pbYuZnLFd8uUIr29kcd(MTtFW`!TW^kV;IWvyZKE zTy1;l{DGq(9OzPU_Gr^deR%RBf;iEq$&3jS^Gv<9={|Us_v4wqb+;rgQRy zCGouY@8}*TJ*ArYm17|s|HZ1@B&V$4Tz!BGJxD6w z$GHEYHV}`yclqN=M5o@+WT&QA`AXTx%Q>AphH@0C|2Q&nq)ynEEC+=DR{YyOukx7F zst7R?%&e^DJKI}0!}&UowY>2&bicA&F302qnih-#fztx^P$DN>zs2%kb~2G#E%Z(Y zF4G* z13)GLMGR0^bPGKXlk1L8EuWKcl-S3cl^}SOngX3KQXkBOhuHrP7{v$qHWt!;1qCQca8)yh{5j=l}m*9@>l0 z>itNIy>Xw>&U$_YK~lk{UNesbD7uoEKP?J>xD`9TvVoHu*FQBqO+z}`gZD?;jl_i> zmo5eR_Y)v<0K#a#HtbF=gO^FC7j*&dJ0L zfnH4vW}U=L2@BlbUz@FTByrDVxN}Wgeqc~Z2z=@&O{mtyri@kb>@kz*O; zEWUN72E)%6&^1Dxf-OOGA6sg1KMYau()i{V){bj^lUNE&av)n#Yjj<1arPB)v z4t>uarhUon<80L$FIEw2VBcg46cF_+D9iZ^2j=nwE~kDfP8H7-&|=hP$1o5$eA=ha z#oY3_6%an_^7qQDJC29#g7oyMHf*~{9ENneuthOA_2wZljdk)Qswm2dY4 zRsBa%mz90WW$5f`I*A@WhuI!yA;eLeo13?h#GYMa?1H>}Nr#fbNxVX0XB*xETVhsL zQIyy6xd}+EEJnVg=_PvmpIgNe_l6rT<-B2T zQ5itSS%mJgq5OdyIM!>6B`eK+4iv-o_yBM|wz0cSx117qDn`@# zJfh8xyt0gnyj6GB(QCF~6A7YE<{^RbMgsd*bo+F3q6x+POx#xsVznByN>!GkOjQIV z3#}w5+-LV?d=u83)&6we&^0Gx1g4JxK&KPJm~FSIa<&?5HU7zZ`P}hX-z4^%@e_f8#bVfeKZR}t?ow4jT02^v##|`+t)0z50s3U zJml?f>)DsE;K`!t_7fjIXEdZw+TWPX6{WTBqgL?C+j4ZGE%8WlJa#bnxz&JQE@Q`` z>J#=7EW40eycKKYCAt6MxUP2Jh>d(pilg{t=VYNhOyR*YsI4*95z1dny|cGW!XNOS z%01#f$SGPI8+R}7c&Q`n?S`+| z2VU|uo-!#dIIrjS2>%UeP8hv-8Y4gF`w^$+Fuy<^AHfv4&35najlO3AR5-u|T*ajl zl}ywoh7ts)8>E`cp;&Y1&B6QU7;WwjZ+by?MpakGh2K6Ze9IjH-I8BPbjw*nIlohT z6-i5H?V+{Eko?=uc5`+-0!dIsb{H2rb?MTjDnQw;nY(=EvteZ3o+G~6 z*C6xhq0C=G%1x!=_3Il3N5{S%sWHSYpByf(FV!Yxij53Dp+2li$nf zsYM)FrRAXfN2dqH=MO%41+;+-9gn%rGj6OmNOY{<`A>(8VblS@5^*=?PHGLhkw~b* zeUNcoUth)$5}+q=`mCWugXZIRLY2Rh%|Q%+8z-JV<-U_pzBx!J-$~`GL9f#)X@tnB zpAP=nN-yC!lJsl1#2;oq2UHl4r&iuA=;!jQ`OenDC^(Tfx~}lNn}?c0dY`l>=CXS4 z4^SvOu3~SCJhc3VN|k=qlxi&&&a^!(nQp^pjVOGywbb4J5eAd~hbCRs)U2Bbt@8Q7 zgCS#B*!c2y_LCQfceYm$>GBoBFDrj9ttoG>?ie(h)(Hj)z5`;c_{Z{^cnZ#Pio}Q${b&vxAyesS%S?(HHt_S9 zzO(nh0aS3*n0=~_g9NZuPUZS-n~LRY$RyQ8=Cn9aO3j$bYbou{*Z2;fbsuh8YV7E^ z`i7n2l(u%&0Fq=T-(D}mSRFe2Y}6FYvW~kC^===D?|g(IRTa?`j?;8y!smaiZLG~z zc|TF)AVzxGCo^F}Bwqo{GkE8K#OJVGiu!`E5Bh8??|gwEx@rZg0EN5@oMS*rymx-v zdM6;w6Cp5|R}C~wKjoXkUCt1Tp|=xvu9=*E)-==bD9NGLB)+Y!Zeqz5-~&o1a2te> zJveh8|8tQ(lFzquhn?Cbzawv367S%-v4zzgx4)g|RgtcR5WgDZ>i@tdG(m+nt}MMD zbSz6I1*8*XY7_gL5;G4_Ctvb7eJpO~Hb@aD){swwJc5tludcwm)D3i!O~COHcPh7! zh%x*Gw+_f|{xL!V5#afyHsg-;s#T&Tk#1lBxQ2f81y!CCM{`2{jTx;Fr-lmD-F^H_ zeR-yKnxy&a8A$6n{n#<95cVYt9N38H+`JI=vP#g=gZtc0sbniha=bB0LvnY6c zy4l0}DH5XKIsh4g$=~q^r{QZpu(7rMMxnulP+`ZbUb!Ovp{Qsi`Z5>%m}pz*1PveU z)TNlFOUN1ZAKYZyqNFQ3gv20C%|kGZ;UG0!?=e@N-*NxU@w<xdqzKj3cMm5SMG+}2bfqxN2kGPcu9Rs zJ66a-D6(E|V5;`R*v0G;N$Y+_NVrflfxQ7lQhPx>npn_0D~uy_kM<$zzY1wowI|J< zot1Ad?tjX)J(gzeI-`Pi3*w(ar`{XDE6t!!y(GktDDc-akq>pNGSp+`I9CQ&0LBl% zBnMT%*uMzxkj`lFCy%XPYSEBgrG9oOOt(sO!YaV4I{8U8v6R5D^`Y^VZqyfCaJ9* zYVRWfl@FcIT_MV7LbF7I=?R}hfjlS?qT_JP3U0P<1br9`wEiFz6Z@Lp;)2~T`O|xt zj+-QFHQ4NRX!v{~EAt}kEP&pziXC2-h5q>PcH&>f1*Ky0_a7f#3S{(5f6o5MPuc%y z{dS6X#Lzb*3zXPMqM9pTQX{lY>8Yt>IsxGeLtQ8U{IQMoL3DV!!Q>RIp4>3!PHNwY zD_teGS3bE=9z_1v^8RAHT(JDjVCjd2TlbP(mwOxYTM)3-AsTivr`QjA2ZX}nGrOdpKY5<#RI{VGnP_-LC)0OY?HJC8j_qz+f*6dKmxG$Z z4pjk)>*Y%ct^Zu*;(^p-=uHYN{6=dnBJC2G_8+oQ^n z>&sJJ?j_o9b(ARoc^;Q|W3|YErMmgEP#KwGlOUvT7~Jo_RREHu7b)14!y_X`M$kil z7B5hauY37BD-q3nWK48VeoaP{?y~i5fy_c7Bu_r) z)kr10j?z$~i&Pw5yn!eK;9M_YEPy0fRW=Ib_1tc6ek9wB4qRW_F&x(oodv} zxzbXp;|GHc-tvTWk1q@wLEE2RRWJSVvESCF&c04AIVD!-*_%NM3zx!Cb3 zLA829X@uH;-g=q8w~Ix|bndNJ@%6^8Ct_VfJ*}4J$%wx~V~emhLV7WN-tYK3Ij(|I_Vv^j$D7Z|#}j83i*stwoCY!jPDz6Y=J5E~_=WSCFkLFeMY^JBj{X5VQ)JtA~h;FDfAMVkg~4JaDnT*@H3nlHyGD3%^sno9>t&uc0_ z>tCUi-Re9CQ#C<5d|1bz2Eca=P(mXNl`6x%o&F`hm6C=Q?#sZy`Wj-bHemGlnF>D) zp~iYzAKPicqfEW;a#dx(P=rScVh{M}sDK5SV1NPKS))Cu@~PJ9Jo>M4i6h*n3}N=X6s#W>A(0utjOez{$+j9D2)hyahZ`a3UcDTugi^+ z&Ai%|Hh;JufP4?k=BL?ZdqO3Nr{0eyBLd&yU=uLX)P??~1Ah4Y_wSunFhz+>B?|6Y zOx*>hNtjXu&%8O#!UUVrU=)fuB~$S(?9{~)414z{ulHQBMiF9!bh@1hOey{BJU`qD zJPT|Q`Zpe0!njl;qboK;Loa{5dX{}!^mkv>xSsY$PRnT}8cly9rBpxS;>&76u9o5l zyl0Itfe=g_N_92hY0x1XIQ3{hY&BmRz$}Lag$7Tqq>ZYc0t6s7+yH>NwE$brUO-)V zh|m=>vapyTxdx%}sF`xXlb+QDLNR11YO|k|gz7^`QCeD^jEKlmG*;N~w~>)~3<@KN zl;I1MW<5`<1mCfxK`E_f&%x}_gy2{$llQuEQE{D|8kxoHL;gkds!5qe&X*;W$h5n8 zx~AU5A5n;lGnweIaG8ia|2jK+0zv8M)c=bzvy+gvDdG*d%h3OBhHV{6^A z;hX;?9w>GE30Z2%Y#{hH;%<6YSwc?TL!<+m z;$hoKAcz8?bHd zn}de|juJXEbHb?W0eeXC$=k)*19c8xm1)xgR9b_SuI^Z$ls_mM({i4n&_(4ncM)&i ziB8|b9oHFw+hgzZFFm8>lTeH<EXmix)p|9Hks90pDy@2W#%4&zGJE@6}i=5XR5y;OW>g+0g!lYSz?&sL@d2aG$< z4pwV7xfD*rEa4}0>QN8UQ1AO}9~*+%0ID(nAsghkYC^&DPn?7}o$!mGE9e_kB;AK5h)J5P+Y!l$7(` zqHxJ!;lrjm&-88uJF6v zTG`XfZXnb5x%j_{sjzs+ z2AHy?jZHcVPTbF(lg*3bVyX#9k7|12k=1q*zkdtqWE{5&`a@0f`gR++|9&rsGO!sr z>mD)@-+m*Ib<|M`WXJ!M7sQxF2mhcC42!8eFvG*2hekN{ApIdzbr4O6P#gP{>k*rF z{C&gFb50`hQ88RpcJ_$l>`_MN{t^gGj0~Pb?8zdor2F1voEQYXq40;z{elpOZ~^) zu*YjBNK~bRAyN98t{5$4=a(;vm{OL?1J98P3V9GG7=S}x^bHd`k)6T}%K<80^tKpU ziw3M@Eac?s1h?!Pl=>cZHbu6Pw@QYlmy$%BHrhDP693rFM&0X80&Hd5Lx`dLoOaJ0 zcv{5NGP+mqpSlba&FKW_?;&_-oL;&R_3_s)KCnvYxWO!A)A}`7@&w%y*R9=gvYned zTlME9RoP|EG$7s-R!uNcc0f9b2yZF=A}S&{?@_7fBAp!bXzHy`Yhq3yY)Cl%b@^iM zXLQHGLz{At^hH`~s>z3r`PqKZL#2l($^GwrFZ1{Jm&K?Oj6;qE-V=cRr5KHcySDZX zF-b|+B}gT#@%myD#$bjcM_5_+$HvAoqj`t#7+px-on8U`_}p{y5_29^s#*&wu8`mT zuGfZ`%?w&O00GEa`gcC9^LAP%50WE;M&?IyGH+uHn2cbv{dH~aXziFuiHX`NmYw-Ckvl(h3_ z0d)eWxu&M9r!mGIB~IPc?7gT@Lf!lteIoWK+z3J$W7ZUPEv<8vQJr?qP#FGR#8 zPaV!OEwmqFn?(MSK0m_`Scs!qeEUa(QJ8X?(R*FKSGX%hh@hOGvX@jWh;}744=-Q^ zD*S2u37QC;8t{@ms2jcaq{*>pWS-4!_SQp6&yi`Vips*dM~iM1h~;|5*Svv+$)%*O z*k-}db|g#pZw7_Wx97q%8$*8$p%ue8;n5NIRi_N!WFki@@EC?l>U*K#QqdHmXqfr6 z)6`2c9zuLKI|WP^;#hzkLxD!+$@bsPq6@*!&w>W-sd>hQY3;<+kc9{?QUI--mK5>I z(!!4*)cfg(p@)w-n{NC_kQhm%-(zfS{QXgEIUeU%S&xirV1l60>! zG~ed&gC=!Plj~lRM$2dFjmmB+iVv~6AkvX$y`n~2pA=9Tf!xJNBBJTI%IfQyH%nJ8 zs6Pz@qBCJHS?aza6uy$ShdfcA&eQD&v#<-KWjncUfRrK(X-g=j{CI%)FU5ufHcBjRdNL zn?uln6PNz;O}Cjj6HH8M?3^Z@s+Mi&`S*u6FRwWlQm|&t<@r~ydPBzl@5!G$XSDhc zJ-bbt`}zKh|F`$!x;Of9?icVUhKTnFE$rWSUi5i1sJBfxaA)K#>uWlDKt$l5pZ(y)A%FizsqcsSA6)nUH#4lE{q>--gZ)d^(xnwks9X=z z_|LKbnw<6C5zp%0Uo037C*hkndri-=d-}`ObNg3@)|{VbGk=@?+L2?&Zi91n#_Prf zzA+$M`bAEy3ta5dYyW?iB7ep&P%+%t2Peh~_G6wsYs7}%Mp_>~{+$06KVVD9zS6R@ zopTo~_@Nr!Z!d$!4@{qi4=1GC<rXkL&v|6pqS88TB=_wT!M zNrjv7!&oiS1R+K!C<^*hfGk97a*U;p~npFjK^ zY=*1h8qY;?5u$}$ITEztv7^-MbVBzzDK7tgR1bdx2Mql(`*YKSQa5i!dkHR1u`4 zdw~;P*Zxfp?z|gE0QmkB7{J#>g?iA93TryI$Da~nyy(j>zoep~qGP}Vz3#?-bw-=9 z9vPP`2ZTL=pb)aVlkMYg*VNQ>3Em3u z2M5}=KgO?Zd*b%q4WV_qtBW(;ta7CKDia*$R99s|386y?c4Gu9m6Y4tq6c5Qog)BY zZ)|j!8`bS~Aga_?92*u`5MrY+{MX*j_B{Aj=Z?VP!-rplX~BP??|cEjJrGp)pv>2T zZX5_yz@Fzp#ad^A%9dcPb`yB-bKtSxBSFkx5d7_)+XFjy#P8hOdGA4*pl`8;p+R51 z4N;f2z^=V^`t<3w(b3UYoSmHsE<3b*K{)WfsS5nR%l9CJh$T3b5$>%Ap12Bsz#FSq zudc>B;kdgpF+V@w0ekb4cdmyIzN~2kjvYJp1WX}9v37s<_4OsB2qT$HM$kABl+ZMA z;6VEH(@*J@SN=s%nS$Q;r21;h2KXC@@`sW@dimv-Y1pt~^!n?sQ$M7o<74R1p@KJn z?To0y^5=)LvNCV*2@h*(%Y$>bZv>cE!$unzMzqcHDr6yiRDtc(WI;DKMzJ8%Dw z5bKNHfB${4M}U7M;FsgrSH|7G-rk*GLWsA278e&MvY99J=H zyKSjrV+_?+Sqa=wUu}Vs?=_{9+nlIyu_a9ov84X}`_Z${K1(mW@B$ea7}UWpZ4L~p z9>@$d0Q39rzkdQ&ar=;RP2l2p-+h;Oonn7pkG;Ch_;dUA?R}xfO|`YPt^MGG55#(O zu^meVOI+!Q)Q?TaQ zf)wV#=}J6znb-Q)Uw%k3 zk72ZDjWgD(brW3PUN~#>d@W=KKbD4*hl{148$d7CBH^_o_N3OjbkASMzW6BONS9p;u(2XWcm>^_rpxJ_(8w|{i$Kjt40^6<{&|q~Ry#FpaSq-BV z$u4wlk1g=Bi3(oV24)?557Q3@V!tR}6Hl+b_HXj`_9pC2e%RaY`~3j;@JSyZpPT*r z_a~;U>#NP_=3aL?T;xe1At8jln{sk;PGhVdm*xPXBeLxC8CV{MdU$yJ1~&lu`m4`r z$xKT+zuO&hI!nOa><+`dQD!8~Czc;3&WI$WC=;dOsX-ZpH1_1|HLEpk_ z*pybMM+x4X@c^v+DiFw!kPQ+v{D)MO;YQahoiJaFy4+fq;H|kdq{Ev-#9qL27{R`> z7^mIOe~_0Lz%ut{zfV7=nk_+etD0$aBhc#h{IkzKqY)#9(}mq`bh+GtW=7ixdWrdV zTZ=LDYpEyIRoh~{tIB1%225L?b9I%fvgF!o8w&7oCb%;ac%VAaG@snha{xN`HzAv= zeeJc^$ira_1^GD%Ir~Q+eMqw>8Uxom3Y>5^z*^fje!qDlz4+pb#4-=WWX`?c^++pL ztXRx@B3yTb+{ARkH*}}~I(W$0v>nsC>Aq{#K9CjmCpb+|aBwj119QRa+?O_n2=J{W;95y$g{nf|mUaqIj@**Uap$I=?*c)0= zUeZ{4|GoDpFE8&nWCMTX@x;Dx&&mkE|80S{BZc}g-+!lNwk^}~oiPtj?G7bg`!;67 zsaEhe22_<}CTIi5KWku99Gkv=#QotTV7S9!MD(8A-Z~ZC8H=x;+Qh^^Y4n2J#;8_t2GTyJqgS z`|>ko0{(16G-A+)G$U**#rS8smliErv?U-Q;0*L!r=TM;>ugxuiT6YQ`Ju6~F|q#k@Fv(< z-)A(xD*iH{#JEu6@qi4(339-m&+%-40q@^m{J#3!zEa^L?9Y)O zfxzz%>g@5q)9;6^-e+vz#rW<@#r?_iDbIoG0-5kDW1j@bd0x2F@agRDgWu0#c~9C* zulpMBOLJiB%3xue4!h+GunD`TeTSgq`V;WnRkr0hy4mNx=J_P}$3%M58*jY9_F($~ zf1P|DI(yA_)cX-XVJxDXlbef!u-lWypsl6c#`9i~7Z{MWmASA7gbpmZqsF-_z6bWc zJ>W07fc@vzE(Xu1gS?0BXv)`xP)^o7D%p@s7pfz%hp77Rv~@1s$@?$wai>o{{+QVB z6mtH4T@h{_*(S&}_KqAmg3jz>+}}37j%~Xa&W$7|dvoZ`?MPpL0`%nz=-U3!HovQ_ z-|npY_ipeJeq!_H&8xfDX+Q8bPlknsU3YhLgpAv&%`iJ(?nCg+rvrts5#8rbQzPui z#l?m8l`d-YyE+S=ZGCTkW{~hlh3ym5ek%TM_ma*RGN0}{ckZ0PGM}kY?mFS@s{A0~ z7j&Z3hi>firIKt{VIx?uE(`B7zbofJc50xobpu^=xFhjwS9=%y-X4KmJA?hAH)jXv z1gjr*Orz=3r$T1HG9!IDRq9G#fBiL0iH)JF`$BYjXIs~6N8ZnLOHzD*ko_QDz^eAZ z4184S_7AMJTxM?ZVuz=2-i`z~;-g~~i{onW8j~cEDpM~ zKUSxAb|gI8{w@Pro)!(8_YqWHUcOj)%t0%+N%jx;cSp?1F3US22E$8?`#JW;*>YXh zzaix;3gTFt^lO=1Zg6d{9}O8Y7=Gh+bZL(qC$t>~ZKFXu^8LL2XTszguK$hrIHnALB*cJ?lWJToZO3%|(qIDpNEPb>#C~79*PeVl97Mc;GrM%d zDcXL!Gwx#>pYULJ5pM{-jguJ2pppL!``LTW)(?K0GdPxRX>yBmb$y z8$M!?A62^}#)6kvKYKTZ1OMM$@*viEMuY_u5-bw-?t9k8>*&#=deHZ6u(dJ<%yifH z9N!iw_`NM_r#IL~S?t9B3LW3xNb6tN{LlvGHx)N15p$S7%%L=9_O=_gAFFPyp6LqEYbON?`c19Y4oygDm0& z#N-lB!Y=tC#JyU|I^Pw^uAtHGKmVSV=55OC2x0e&xQF`@0tRb8jQF`EaL;u_l?w0=zMENLFap=^8U8*Z#rKLsBBG;SpUG0b%6ih zr7^o3O2~BIgiP;J{L~maT3JR%E4EXhuNT?a*swfv3ipBWKV-HiS@v^&r~QMyUyb(J zzDn-*!D|Mxzy5av+@&_ccQ2S@_UzhPC}4lIvXtg0CI~tJwoDm(AL1B10lW5Fu1*&1 z;{BVhox7igtcSefKw%*9+VJx7B8-)>G`3y6giJ>dF&axe-QB3BYKI*DSpTas7mFMz zkZ0`RK7jsr0)JB<=mDSBdo+$qd*%p@RS8^$+-e*&IA!KhvF$=C0q)^Wgc%ag3s!n+p`{p4b20vQ5H|h3y&GrsdNQ z-=YzNKcjEH{*rRjSoZrs_NT6+KDXOT?3Y+iw}3C7znyT@^;?KxzGlMsadf1C=aX>% z^2H12AOH9Vz4q#h6fYY=m%;CI9QLmV^rzXe&cbFxeg5C?_4B(uMNDJJ|E>c5Pv{Dh z+w~lL6dp$o%p)xCQ>OcP4$PP~g*cY~Pg`9CtT~_LFpM|}j^IfISLF`Vz|GRaTG-~h%f*#-)$IItBVg2iF z`_q;&y_@d+t~f&2uYsnX-P!PK@B4w9`f{$0j74cGxW8uaF7oyA5IK<gLAGz_&#_ zgK5*I6>rusl`wry0i+qyc?E~8jpU!?B@!CeS9=~dPu?qYTR+N#2 zxw+tDkx%mma-%K+oiK38k|mFT|9_KnX0J^3ZIVyqxcg2rPTPuKuODbGXXz55@>bYGe5fc4*YpU=)3_pb8Z^%)@| z&kJfq^7+**Nb=3^veeXI-Eym@niGVG<_kQM$K zqaOazf0f3oE0)Mlk^1SUpHOw#W)=7sGCw@PoJGD7v-3?J*y^3ZCxxb{IfLW=!tRmV_L5w*dbx%l82{^)@pzyW-~T2-vIc z{nKJ53H{al`SYtG8*HMVKn{Z*@X`Kd@Zdr4+w{LpIDl=hwetmI7_=9*y4tjIJQH&> z69SD?tZChJm2-$oHk4%)!p^Hf-Xqa}&Q6ZP<`aCLt8#mh&$~P5ff3l-w!Zr6tJJ%9 zZ~6ea(Tg%YFbA6YaOeVqdc?oe|uN4edA|LfTI zuX1iH&T+@FEjhPWxG(bh?Qe%37(Np>_qx${1)j7Z&X!_>5l7Nsl!znDdl2xHus>v* z1J+Ug^Pm4DNArPHnq^0~D$J3K7yc(Y`k(4DM_YR4YLzEwe;WeLY^ywWUFkP?((bV5 zEFLuITRN;J^UGe6CUjSz4Q|0-T_v9}VDUZMG{Fv#PM$nTc#p{CId04dy10kwfY$wE z)W@#2!i35jkW%YmuQLP4s=y5usvi zA>&EL_$xoA2Yc3P))T>2M8M_JrAs2GGy6JS*u}D7))6vZ*2ZTOv{I!B9s zV4Q;7A@tjCztOE*x2UeJj_T{{iT}9dgU{W(c~i^<*eVM-8_$CQUw%QGSB9Yt9EU(V zIzfFdc0_&2Y!_nNIKbaTW$?OC1v$Aa`}OMwKZT_#bU)L9Hr7^zyshlJ+Qe=NvY=R& z`(K`6y)kWEE)(&wdA#6b zB;LnxmtZac-^_n}Pi<|jmib zCr*rFo&NXbs&xN8@PRDXhhP7%*!zF4K4o)rb3fwPOpqCJ|HJ{CL3;AZCyC>Jvn*lU zxN*W>z~0u9cCCecSc80k>AQ`Y{zAUMc4hFB75H5nxGPTw2_Kw3eHt;Orqg@Kul39` z&(Nl2oOkB-%Oz`(+t9+?lzIO;*nRd_scK8EPP$d4}M4ce>+9{&zz=>JIjRLI7;Tygf6VDG^45wfr#-l zM8y4pjFhflzpio3OYl{Oxu)NY2cX9i`8J<>?m6UQf0K?O4sl2Dfo<6nZdM^~jjfBoxU1>DA9 z4%k9pJZF9~mF?e4l|LV+eHYHsUZukgz7N4czI3$`Yf%xy!-!6oxs#Ro1Y+Mf-a}f$ z_uAqFo&!vmax6N|yO%n{6}X3UjhcWS&`x&S-uuq&a-}hd`vRSRyz=;UrQbzGMX#_O z=eEN2P2g_{+{N+xK_3p0+6?=Z-(i2QVqP&fe*^75^(*Z=e@4Js9p=jL_m7Mq2YXx4 z0dl)B9$U_jojlb>>=D3^V*l2(o^?IPcm(nZVV^K|^bopMrF&c&UFJe=nv0b0Wvn!Q zU9H646m13?{-~0F56gWH?k*8@oJ=OW3cl|tsojWS`zr74$tfwc|C}7|%5ZM(cR+ZU z;Nwp1@NHOwhIG0-jD`;zEO@wU*RE;A`4a4V~Jm&MH{XyG#z|S%cc>ek4 zsU*u0_6fJgKlQ{GJ0Y)vJw>}>ekzZBNB;)D{4~QP0r6JVW&T0%@ntz1bp3YHccCBd z4m$5RxwWOK!%D8R8k``!#@GaSA^7 zWN2szyXCJ$Ou^2U2VI6fV*I$V+|IKc5523wU1|^DpUHka2X>XHz<)>4dSS1+aN)x3 zXuov3C}Hd2!SWsE3$Qm()se&W-ESwU;>TlDu&spB0P9JyvE&BXT}Y^m0s-H@|NZae z>S#jOt2s7=TqewPxP|Eig6u)8XNIK&Po4`5W9Ba&dgvkQ(W3|T>eY*S_UtKgsPngB zLo4{@~t1@_9sDju%y&${25a8>r zw)dA(>fG64UxvQ7$=(Gy;ET4lwl^3CtallNSRhltyD|U%uYdhZ#5uRMv7(Tm0LTr^ z=`Vlzi^zEzH_3x)_bK}Z7?8}zm||jL6!2#d@_x-YpZy8{_{TqrIly{FhCR;(wln7a z2fj4KaBc06=M>Woz-6K>yViJjs*Mu!{9bN0g60J7@3Jyqw)Gh`Y80(*BJp; z&!(iLOjVziIv~}ZZ+Poo)wiK+Oq&YJM{7sC; zi&(CW>&}2;!)(R6Jay`nV(l~h8SgWmfBf;s1j_f1V$V zPav}pZCpCXU4erd+tP8kpeQ?(`u6S1w90YNHC;BwFZj3+hU31STUBsB?*%Nk<@E=- zpCY~w&jaYN`#?{4hU4=h_7kz3m4EY^jGs1{wic`e+_R~qaE4n#f_E28H6$Y=Bk?Y#>-mr2k9j9-4S5_{x6Jx8-oJVMGd^MZ1GzM`#{c}z%*;$; zS>U3XkUw-%jEW1p9LU&kyukgylWW!2PFJc!X202k<9ew1cW#26FOM(lETG?iR%$b1 zJUk4XyOMS8Oi#0}k9DyO|F_kA(RuYPJ=AP{ z@>XRD-3@dC*TMTK{L~=t{{*yRor#GF)j-$7doRxc%yS|CXPR(M;%o{>>~`iUCA$o^ z3yKM4xnI*9us5q5X~giM0^XARhhfOHKg;hSdlGR5c>S{ulIb^&qYb*MS$Tm3bLEnG zOTa`t|I;>K6&%!2d%%rKI~p_mD}k?oCuhReuS?4NdG2LpWqC2~FD=@j3V+0S3HJ9D zIy1fw{Z1VEBH~d%J|E8eJm>b1;Lmm#yaymID6t->PoF*lKQo{9$}6vswYffRUgiov zL6*B}(!m>&%-2%D_{^CzDzY8M11!74T%}2qCW)K?k&%%E{zHXcREBeNzxmy4oAl)u zpCPY^Zg~k>nUsr=(DfQ&>m<6|Bvm zRm;+Z+zj&5d6)y=^O|OT8vNJ<{23l>hsAS2vd3au9p0~5-nw>y6X4H0zoxY>?Y)NN z=V2jozA;{r@CpKIj%RwJ$(^Mr1$&cfGg^r#Vn z4*b=z*_?L^QLp|i015%w4V#-%4})$$YJDQYfgu@M3S|oiQp?DA|hDU+b+DX zD@@z+9NHP$54K)=wyFAeG7gwJDT;i3yl8X5YTB?iiz35A*zUg$HkJb*^ZAAMf2N_C zmSUMbk1roQ*8ImM<7$QFmIhL8q`j_CqCGQDryUY77?>Bol zc+<`OfI|zk;EhUKiu4{Le9hRFm*v3x9!;=T{uck1<^fn>YxFmCqgV-OzCnvTx_FdsR^gZ7&9lSa#LzV8w+E0O; zmgVZQ-~h60j~fF01F0 z<{oq{fh^nIw_}S6{A&=`$;8-5#C9)0pi0!SjM`{8(PdbCvzqCWpJy`pi)Jd9xj0uZ`b<>Kr^(>P-DWA64YZW}rbhyY9``p(o2kX*&AI|~UBjgIc5Ac?FJ}wWIZx^s; zJuTySmb{GfcO2vr1BFbQ?FHBejO`M6E;Bx38De;lBmJ<&OW^62 z=9cnW*Yum$eMF!&*;^aZ`CamSqo>Qmu`l`vITg>dh;SJl-pKZ(w)mbAB}{S>{R2(p zBCWNqR>B6N2WYXgsY!EGV9)R`EnFvPCDyar+u73OiQyC-87k&A>tNv+jR=gukkKneC-O8YX?bMPY|rXzVTnH2-s0P?%Hv=_+XV<>RN ztqN1B&U2yFi$Z8=QV^vjIMbFacRINv0D2|Folw{mtFC8FFmCPKsh$3?eKJ8VJJ>8# z%HvtxtahgKlo&zp@%)=IC6<0Jk;@ZKZ1)m+P~f4Qt_F9hJ@DO)5w<=BO>KR0S7Zvk z1=GuEDRYGmkM*}JmMs)`54oK@LEj3$Z{)Df5F;S!gqsdeCF3; zCq>Zmr3)xb79{9*(9=WVzo61D)@{Rv-~;FcPcv@kxdmR4peIz!1E&9&9_NzxYS@wq z8$QH}5qr$D&pr#8d_P*7Y6sgO#%a4GM)aVNKX-Z3QW&f4>qeqWEb0=Zl+_&LFTg~*>5x`q{?-#$J_t~;x4Ml~) z{|4HyCLWwPUPj~EyI1^G0n!`akU*yr+2b{*zJ!WSqEB_W7wAF#Ul6UG@*OuwZQ(T z=vyuGF4pGbX;FeB{8fOjs+b>SJ%W5L@!k`Syobo|Q3rYR-s!k5WS_!RwG>M7<7^Ep`m1C__6EBppoGJx0K{5i9b$3>O)ZvuZ6{7@?5z~!%6 zPWq4u@>&HAm!eIdARE-fT6he6n}~VC_2&M7CyE%?vTlLtf^nk;Qn1HZN{Mrzlcnw= zr-0mVlxab^>_uDL&$yb8Uw6u=BqxH>=7iCdXg|b{uom>96tJ&@tgB$<%9U>5 zcbzfMUr}x^=4wyKyhdRjR6{0S&v=pdF=PFaH0av_f)Bx7xF7KEtNdJ7_>Fbx&igal zS|!a+0IpvP-S4(G&4nGC@`WrNxH}Ut6*{ht=o@^Cx*FXjF^py<6@fxwhk^&3#4iKLkHXkwLZsmoj~IW|t@J-{6ioLY_1+$Xv*rnMU~2 zpZ+9lEdKrKzsN{`G?^HUAyeoKtSrrieGuCnajX#bGXYFQj2QMOXZPAA4nAfq@Y0{PX{V-pfD<0YzV|eaM>JjUO6P!=9!1X9;jpKfh5hVT*r%T6y^i_u zr=NaW?D4FxaRC3%u^!_P=YRF`49Z%%h;||lc-s7Vf)_v>mj85Qzu;pqfo(;mhZzI6 ztLkTORXfs;rBT8bo%da)D`EFrjItatD}KXKfHioC?Sj}wh~*2wPwZ1rhvO=I8;^q) zDZqVGvB%glyupL~6Lv*SVwiPgpSse!(BHpcp1!EuCY<{R=6zrAYA>x@w{8{V1Geo6 z2mNnrZ3!8WHFSSALjS{Z!2kQd{}Zx6_~NMefh)gL*WZYXX3jn+xeM7Z+(gJ!6?;2m zYuSm$Le>me-opHyAbm$!-v&D4NgU6^F6m{^YkxuCo&$f{1IK*>XK7rNOZaM!gYJGW z_N)0=|3k5FKZkL97%~bMjMF>d>3d);e93sg)!Cjl!FHSFKEifCKN~dP7$LI-UicOG zbRu*y8fky!Z?^R}=HDl5)0rCQsN|Pn2)UahZCdU_Z@u|n_7VFPIQFx)zPr8mV{E#l z4Uabc!kYgtY_<+EUCnem^RO7lI?y{8($doEK&u=?{{paXcC*b-QevC}_6+}$jjPBK z{yU(LZ$ZxUZ*9J*%RS&tpTORH)<}O8{kYYSek$=G_S3X5Hxcv(^oK`4BYvgJyYJ^` zu-4hmuY&0&=4ao6-i7tHth?cJyq_{Zz_b$oUI(3@wDzUa%F=>$E+@eUcPbu*TwomZ z3O6{`8|xUE9%NY+ZAk`m~ z?H>Wiem;Tk+$omfMn}p3??xI=8Q$u@H>_PQY&I~5zG#0dy3QLwN8YtGovxz@UCWn{ zQ(a(P)|5%%8rQoD{4qyluy+7mb{=vqMeHA4zyIL5J3j)TvtyaAV!w>Yu%H&_z|N9< zVdD$C505+F^4r@2@I+nKXS+Qk!S);Q=N$ol zAFF${|BwszfPF?F^dYBs9jN$rY@bU=3a%(?d%uiz)!;8$`|sN zMTn2H1hO`mduP}|CM$ftZ)aN`eCxpoJQ#roBk*7Z+CBnoX3w_vt^U>bQ@y3Ow`%=* zFSU9PsU9MJT<5y*%?`Q6Cq!Lbk^iS&m+AFWx=QEu^b{}T^Tp_@@^$Wch;%|m*SX$D zs_XINdU}c$>xIa;F1@f;FPN)(-5Tz%*ZZ%iD_$tC=_y*IUY9kT=-2Rq;)Z%3wYt=R zV-44(A(QTxH{gQkoVcaod0E5#dM5G{ih4hJUAinaP_16ySg+v+Y8CYmt}4|!o4c=o7RFb-&iz%s z&UMA;H^4)wF5s_TKi2rYKKy(Obd{$lldZ<+K)`E|9rtTFy|KYWg4&q=q- zr@MMxPwje>`p2rz>#5g$Rj$|Txhm=*_oxod{B^x?dWrgZ^}3!+y1y4)YYOgT(p5dZ$GE*p^*(C#ewymVjn9Yhb)|a0R_cBD zx~%c}hI(J=jF>)pdhe^$WqO~g)G=#i56RCo+~50p5!ZXj8tT0OGyL^CFW%3yT-2#H z1fR$E<@E+!SMQ2dT(9?6X)mZ{tW(c3O&(X|I&U-eik*R16JFD}72$roG!%#YPhQ_6 zRr%BM-{%@mNp5oH(qnln|{Exr> zdU{)sv4@Y2_=8-u5r=ie3m?2gWdsmk?Hhl8|8)4*y`gg9KB&NM?@4Dz>r*>d+LNcd z<7N1W4Co5oh7FCzIS;!8jpuc3Gh}gN(-Ul{w$hwd%r<1-lTEt5OL`7^&JJy(^xlpv zA%A)V`u?XOfATKMa1pkjKNgy??&&nf{%P26Hqsd#`QbbGF8EUZ18aQ>`g{mB`RCwI zQu`TXu6x$V`+v5~PS|6yKMHJNF2YBl9DbFvVT0B84mMlkr(uu#2y6)r;5Rd}C0kqA z<93Hk@qe(-o(((1n-fM4qzK>fv}%qa)f8CJu|g}lP-Z6Jf3@6(mdv!JqJ@UEY{qB` z_Z&ilzWI!G64xQ03}8K$#>U)%lYmRc(s{l#Va&G#8}qrC%PMOQ_AK4u6Z8RKoTWeZ z+xq0m6X;|Ka!?^|h{DFXg_uavJ)9fy@J1){bR18}xw##-n~J!+cc9zilZe^-1nhQi zaEz6zbsoZ(20o%jd=a?kcd)xRo-kqjfoT7+_1iMdM6494Kf0Fe$CVmq$9YMPAm+|X zz{7WRF2G)G*}NFePi;#18NQsu>^R^ZX>Mlv)0CjmbauNX;LJYFE%_X`EnWeSK~AzI z`zfABe5JSU6#V(Shzs%zVn&_Zo@Gxz6j{@#k;BQ=dMF)Q&-1&pe7WWCoioXV}kZ{&*=14Qws4myAHpu&sy4tHT9uA=fJNNzSw^t1HmqI;i)dxpk|4 zUt8)-&%viMCuK@!;(0CR6#T<{Je@h_$bTW9xNSOX(6WDkU&OUjpylq|+}EdzyX-`) zeeg=Rl^%qBzRP48&->2W*^JodB6g^DebHqeEsir_pV&OzdZOD?;Bg*ub#cCQqe3&@zg1~TiPL;UUe~|=;&BbwGJ_5o9X}2jdqlk8id@&_J|Q~M(1}nk0+XYhc@S# z4|KG*=2-lnac&-M+TPxKFwPITIN6=8tqx!qTGTT^CAxbWqkGufQ>ub0Qq)22^t zyT_1h;KzpepWn8(U)nwo9^+*jOO8`u(JcJA4-6Z5Uo_*0w)Io z?QiRS@cnoRJa#&K$lrr3OAj*3(f%Io&!N#V{nsZOiwOiCtkYs{Iy*UK7uwhCm)2v=ni8 znzp66Iog@$4QNu33CEXSqD_C=dJp2r_~d3S6|wR>kPidC5N43YuP9D$9{1huafy|g zvCMH#Kjb2g+nyaOZcqMfZN@Uv-7-&3}4 zl*fr(ow;zJ2RDi=NZI-_rP}Ot<6QP7c6L?S{EDMxb%@;1_X(V<0m8 zJzX4W+cIk^U1m&!2D~SDPU-u1x||qb#PRt@!l$RhXngGTe~XR?6@5Q~{7{1t|Ix>nC2+j;($smP|6A6tW?ghWaG!_;h&UQ? zdvk5O$oe;+SyO%MA@}M~e|f}ETU)uUNc4YFgp6axtd_=kY??KKh;sPQ*#h(z9WSPmhFX(KkjTUpjkZLPTi1P_> z-146{S;M{qw6lUYV0_maf6)AO)(J;OgddV%(-9@;+u@NRfdck>wiIxlgL?3nLca#S zzX&l8ImR)qPUik=ZX4@m4i*Oy@6ED6H{PFk3`M?XV}mgi<@qI@+6Ee;g*-6Y%&E)e z4jh{zyCeE7y#sMlQZ}y17X4qAmdr7Wa}g^|Tt=*%1CTLrPF#wQFrn|(+t9f(mj5ct zKn-cl0#^|?7&t@3y_WJJaLKW-IVLjamspa(>qz1g+rIaeud-&Hdxz4#h6Vk;yMO(7$<3nlgwzot~RQ*NCi30Z3+lx4M=1I)=o`@mzy0fbb?K^))^qKoD9ZNT? zqttk3^xupog;mT%zh&{?N@iqO;m@$LaCbfP37p7Yi;%QH9FU+Oq*-pvP!Qq#~d*u6`zqcpnGBD=r zz;`bpCRd$*P#~pdW{@LtU-(_uEEh(Y>#%tYjG1m5E@7>?Luuxopl`;WXQ zCP_(2VjuhXqYsf2H5D8OQsFK?-%GhI*jJWKIgMGYl-Op?#%_9%cKr`#UqFn`v=$|p2oLCo^N9# z16sN`Rpf>lK6EhR^kMEc?Bnw$8&M7Nw{rg({yYY}UvR!3hO?%>l9Cb%a2cxg9#99^ z8;$##bv_*$mjpEa)&o1`Ik6Vbn?*y04B|WnGZF9Goa1Ighc4DO_XGQ&i1l5Z=_2r+ zG*9=gF%voQq}(T6ZThHnb`8)uS_o%FLmH}eaA4)Pw?Dq?ho+N zTIYdv^tii=^Hpiz3rGGpe_sy~e-X0Pg`8gr-xK(n^LTKcU)UMYj+Kn}IR`>x`-8pB zMQ&hC_+GvLpsUDW{0O>U-ZDS&Td6I@g`3c>91pC^A*}Bj+?-u@bK}v{dC)7vr$o!w zK97N`lOx4VnTYtecBe2e=5TBT&RHX^ZN}}umt<}C zwBbBwOF*M7WjxM#4`6Gl03r7WwtwVcIf~BgV0l0z4P29NOhG<2#JEj8S2wQ%*bF1C zs2NqPVL4LMy^rb0t9xweP@y~Gy;~yBvOS&H=0S;3;|cl~OI`Zd(lgdpR=W=G*(Ulw zJ1!P^PhO=lqlR(r(o>Lm%;lKaoRa|ip-O+aFCifzWH^2Z9mrSBD}8yV87-bZo~BL? z6?7hK^u${C@p2=UpP$&uGQ_5R=XrE<58HAX(Uo#r3iG!Tx#kwncB8Ait;pZo`3J>wE0m(#MwWh3%%pwCG3ydme+u^XJfnabrdP%YOYnWg1{SKhL%W znD3(y3-=huAO{W-xh9#$gAE+VN&D%`FTc1lHE1N=sLt#IOBa!DS8+6T% z;`M_5lg8q}&aIs1bTjswR^yO@PJYbZ*8IxPTbwA`Zv<&LbP-gy1|uwpJEogS-l3#*ArVQ>dwpm_6eg=Nirm2d15I4#mxbQmgWHo4& z4wcI*KGH!ykjLb!!GpfNxi))|0_IW-Opb#O{I)`uPiccIl-~=Ssx_^y{9H%;#u{+_ zcHlRZvwVR{Jji*or*jN2;mgwz-)YM`Fz>ZmZ*6&JbN9k-R1Y|H^tiEOe&d|y#p{>T z{JHTgzx@sR{(H{%u(@$S4vxOq=ab-5RE71s6} zA(ZEs!8_j&dO)TpY6yMMkIy20Mjw>N`pW~#a6A#dkxPzUfCvhDhJ zGz6pwXb3EU>&3XtF%qOwhC088%kB+jk6R6aB^pY;AD6{_4W)QJo|DRB4dX8Gq9cG{Mb){w^D(R^g_tLy2EC30Q{#m+1gmw zhWMD%wBS*+aiLr`k`!Y^Znne7&U_^2wZ94fmNfLG!(={EJDMw}#zrrg7;JqVa?$DV z^-$b~Infik|FJffM%6PT#@Fx8GN5a_OqAqU212&OHV-V@VmaQq?WVML-UM=YGW!*M z9toH!-q#sFF!sH?-EFR1fo;H)C~ty4`gq7I{^a0b?-TB4^lQNaeY(Dz+t(!k z3Ny&$Om1OJoY033)4OOI1L$^SE9aWiuO;^6=xBe@%W1-eU0IyNv{A;YO`BEkF@PxZRMshQ${)jnU3bfU*yVG&x%TLC-r4*MvN0QRani)FXx6*7MOULupZ)#)7L>0r zYx5k}wlCkWx2Dv|BWTAmBZ`U)bJV6y+TH^@q1Qrvjc+LHKD2F@w)b7$Wkse&V{fL# zSznHd2r-x1)?PnZo=1q8AGax8I~ljO?Nz_;r%g7T<8lGd9jWadQDTpI#Le02r&|Jl zH?BGL@3*(UZoUyg7ASo7I-=duJAj)9ER1g|d#|f7g8m43x+^S{LX65V9+r7JD zNm`v~zptIJeVh?#DqQrqjKD`~)x5TMlXMyu{iq{0WLbq^P@FpJnj0H(-d$0<&aF3Z7j?U)TksZ~>mfn+; z5K@Kqw`tBx@PWPC^YO8hu5Ny4N(HNzbL_NP+GR+sie&-g<6{5kakZ^GsZ`o*VVR~MX>zk$k6{H(AopSf@W zY~meh`*QdkmX>l;oBaa~PfnIYo7iDW^F_T}5NBJ9Ir}GF+7ErW^R|Mu#Pi3~!@U5w zNDnqjn|IY5RkWRL;=?9IL3U+FaT6Vc%_KLT=NI}<;4y`5ymE(v0(|J2(wtLovsAwd z-Xbi-Tjy9eUY;I#?9ZGFJ7@4(;XDSAwI#W^yOV#Y3_NLwh}Yt6KSbED%%AQk<~rN{ zvJL1Xk30g~z<<-JQ>T=h&-0KfS2wO1slDpuO2j&ajg+-6V-LH>#}j8vKhJY#VrVe8 ze>D86{sNn!Q=p}=7M&Nf7xrA=u3VBP?CczDt;od0I00)f7`8#8jXZ|z3liZw zj;`#IkLCWg#svFwF<%(p!2eF*9p$$3@5sn-`mLln-d>KIGJvNLdp4B$Z1q2F_+Vor zqu9Nr#hCkB5Npki9PF$)M)NwxJB&xz&J{cb&54Gb7O_C3@rw<25VpYTZI15MsP{!v9X4g%y*=Fb^4!^!x038^EMePhyBGQ1ayjoi zx10YMH%^%nLz|Y`D)7mPO~w>I*;k`IGyB3t1>4c(9VUwY%KL3V=gX`RlhBx$rserq zR8%xrQ`@vT2S1l*662=|8`ZENKN>e?BvG=IG`_8!gYIWz zba)7@UA7oBf05`1_hm`ST!MY~1m)*>eMvY1_ME>953s&CD|{4rI}D*9=dWndl##S$ z3Gh<7y|7tbG2fk{LY&Ck%l#_Gpa5fF0$<4|nI{BY-UD`U{l@y68Afs+G3M_<*4HAx2OQk)@ouiaSW8|Wt`4_~*DVum&tJ0)^WM_8x%=CD zz9Z(2avOkm^CI?_>Pz#1l^+(9isf++x;7BxEF9`ALzJL*4piEhc@4X zZP5+3wE|giU6kwTe8@FXM?M~u^`FA(iOc_kJrYVba1wQ;G6bi}QAhLuVJOw7;l5{4 zvH?`ThLZ2&I+tw6#pk*FK&{T#WexX9C92{%E{Eyq341K5#Qma`)7)qWrwl2`u zB@X@`?Xro(-rgf|vh~U0OjnMV;2z{{5uZ2T@XGn^&H3dt%05nPGNB-E^8(oZwCHcz zw8yGvK!X`g2^>lDCXS`6JGGY=G3|1^(3Jh?=eL#qhP+6zr$$DET2`)Vna6FUM;rSu zo%6OINDJZ}w!+7wO?GiS3c&Y&Oi!>pE4@pXGH32MT9;;XJ<#7v@KKOSs19%oHOTi| ze%xrH#-lauV@vH?IoEjUgwa;xw zJk)$o%ARY}26z~N<_}r~K0u+{22N<^i>jwxo$aEOWzx04FPwko(E8@&C7R}i0d&4T znW}GYxi)=DOfq}}hffZ*&u-4owY4!u=aDXgAgS}l&ZsA}!q+FVag2#jxpaPz;c zEG^s*m6uSUzh5!rg+09;M{H-giRw2XZzwmVGgyn7>^)TP<@JC#V-rJtoBwL#l_}AY z`MWo5V7-DH@UAudYH0g1bJ#%2+wfb7DJ_{FMI~D|bKGiLl9oVg=E=X&^tuKbaP-&7no}Lm*=}p_Q3QP2v-=Z+cPM zIJGg7f1BG>u?l*tWy@Nnh0xzm%L?--dG?HBmy%RCnvap4lj4XlKSx`gd$QobNS5z=xVbKZoc-_Yn;#6n-kI^Sv~UV!kc%yZ zoEAC@dghsD2zDFd`~2U$S(DKJrgX{q?Z)hLuke4?Jo56h3+Bx(-&wSdW5=W;R@iLl zNJTs-PbVWfzR`#dturL#yA!_S>@&}DKIt!Yc8J>e%h&CKsfO1epXsaoUFL_?|Ck?M zk-ngA`NCx6!*II^*=RX`i{;Yk^J5@ilgreXB!#HNFyQa++O?CmXDF``1IQhXY2IYe zet`kL%Cx-tccnUHgyZ)?J|5`fN&4f*{)D&@6&xpyVG9`#O$oJxT;GhY?KGeb89`LO zdxx0+8}l*{TeHz_qpre`DiJFnWvV4@TW(9!VkeH5zR^-SIVvKJWqKZn)oEkJI?|}m zATtQSyuHTy8-}&3&9JLK6v$zGZMQLO(|He6h56-OmK5%XSR*TK>6b0`l$GqUv8C@y z*8+UKD+_@4SU*sX^)CzXt;V=@hs^3J=$Jl)4Cqzp4S(+$PwQJz57*EfXT98f0q#H8_kt~{X6hsHiIwqG}tzgEXbG4 zO-;Pi?}v=}$u&tP^;?#h)!n)MroOjsYdtcmSUdwDwGeYd$Yr`%k>I-MfILK2#5YisA*BfEmX>>C&h zYsmY5-`aON>Uuq$pt_>tw;)3x+6u=p8Jx?C^?KJALo6ZF>xqNKHGDkLaP)yJq|bHv z@eJe|y>axBj$`=UaP&j@Q8A=3I6|Z&^w?t*dZ~uC&^0;^+`)1Rh$Zy;;!wyb;Jen6 zoPy_L3 zMfQ@k;LN1(@Al>xURJ(W)9>Vj01S9x{#PtHl8D(4enjJG~|2nqK zZKPRl?J=Z?@R0v0KMP&klPl6wFUQP?4_Lo@ClxO9pr3v`Dq>Z#PXEB##yt@H@-@Kt zapmU|rcW6Iol#YCa&mTLSOAq~8j84PkRS0jO66-BdCI(0tEK#`@?O0vW8u7z0H15X ze46rnGlU0-eDASiLisE^IfTOFN7~rh$&1PUw1GUI={_kw0EubwdHf{mgg_DE|@#b4N}m?Kj5Z5k>Mfv(F_1^H};RdkcIuOCEO3alTAY0~iI7?fQxmpEj6KvN>ay?i{}M^7)MMo;hm0jb$_fB*mh literal 0 HcmV?d00001 diff --git a/docs/index.html b/docs/index.html index 0a56b64e..240a7141 100644 --- a/docs/index.html +++ b/docs/index.html @@ -2,13 +2,11 @@ - Document + Task - - - +
@@ -17,10 +15,14 @@ name: 'Task', repo: 'go-task/task', themeColor: '#83d0f2', - loadSidebar: true + loadSidebar: true, + auto2top: true, + maxLevel: 3, + subMaxLevel: 3 } + diff --git a/docs/usage.md b/docs/usage.md index c5b2c0ea..1c5087cc 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -33,7 +33,7 @@ executable called must be available by the OS or in PATH. If you ommit a task name, "default" will be assumed. -### Environment +## Environment You can specify environment variables that are added when running a command: @@ -48,7 +48,7 @@ tasks: hallo: welt ``` -### OS specific task +## OS specific task If you add a `Taskfile_{{GOOS}}.yml` you can override or amend your Taskfile based on the operating system. @@ -86,7 +86,7 @@ It's also possible to have an OS specific `Taskvars.yml` file, like `Taskvars_windows.yml`, `Taskfile_linux.yml`, or `Taskvars_darwin.yml`. See the [variables section](#variables) below. -### Task directory +## Task directory By default, tasks will be executed in the directory where the Taskfile is located. But you can easily make the task run in another folder informing @@ -103,7 +103,7 @@ tasks: - caddy ``` -### Task dependencies +## Task dependencies You may have tasks that depend on others. Just pointing them on `deps` will make them run automatically before running the parent task: @@ -167,7 +167,7 @@ tasks: - echo {{.TEXT}} ``` -### Calling another task +## Calling another task When a task has many dependencies, they are executed concurrently. This will often result in a faster build pipeline. But in some situations you may need @@ -213,7 +213,7 @@ tasks: The above syntax is also supported in `deps`. -### Prevent unnecessary work +## Prevent unnecessary work If a task generates something, you can inform Task the source and generated files, so Task will prevent to run them if not necessary. @@ -295,7 +295,7 @@ up-to-date. Also, `task --status [tasks]...` will exit with a non-zero exit code if any of the tasks are not up-to-date. -### Variables +## Variables When doing interpolation of variables, Task will look for the below. They are listed below in order of importance (e.g. most important first): @@ -357,7 +357,7 @@ DEV_MODE: production GIT_COMMIT: {sh: git log -n 1 --format=%h} ``` -#### Variables expansion +### Variables expansion Variables are expanded 2 times by default. You can change that by setting the `expansions:` option. Change that will be necessary if you compose many @@ -381,7 +381,7 @@ tasks: - echo "{{.FOOBARBAZ}}" ``` -#### Dynamic variables +### Dynamic variables The below syntax (`sh:` prop in a variable) is considered a dynamic variable. The value will be treated as a command and the output assigned. If there is one @@ -401,7 +401,7 @@ tasks: This works for all types of variables. -### Go's template engine +## Go's template engine Task parse commands as [Go's template engine][gotemplate] before executing them. Variables are accessible through dot syntax (`.VARNAME`). @@ -458,7 +458,7 @@ tasks: {{end}}EOF ``` -### Help +## Help Running `task --list` (or `task -l`) lists all tasks with a description. The following taskfile: From 787e5b2e29df4f12447b3059cc67f656dadd31c6 Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Sun, 23 Sep 2018 15:08:03 -0300 Subject: [PATCH 06/14] Create CNAME --- docs/CNAME | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/CNAME diff --git a/docs/CNAME b/docs/CNAME new file mode 100644 index 00000000..8354e11f --- /dev/null +++ b/docs/CNAME @@ -0,0 +1 @@ +taskfile.org \ No newline at end of file From e298256b82882acf5b87d36ad7847499e60221db Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Sun, 23 Sep 2018 15:15:42 -0300 Subject: [PATCH 07/14] Use HTTP for now GitHub Pages can take up to 1 hour to enable HTTPS on the site --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1d7e0dd8..3c7783fe 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,6 @@ It aims to be simpler and easier to use then [GNU Make][make]. --- -See [Taskfile.org](https://taskfile.org) for documentation. +See [taskfile.org](http://taskfile.org) for documentation. [make]: https://www.gnu.org/software/make/ From 6ccf1f2a3c67226f85105df1880995ae79e935f3 Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Sun, 23 Sep 2018 15:31:00 -0300 Subject: [PATCH 08/14] Documentation: GA --- .editorconfig | 2 +- docs/index.html | 10 ++++++---- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/.editorconfig b/.editorconfig index 3cf19174..f60a8b79 100644 --- a/.editorconfig +++ b/.editorconfig @@ -9,6 +9,6 @@ trim_trailing_whitespace = true indent_style = tab indent_size = 8 -[*.{md,yml,yaml,json,toml}] +[*.{md,yml,yaml,json,toml,htm,html}] indent_style = space indent_size = 2 diff --git a/docs/index.html b/docs/index.html index 240a7141..054051f8 100644 --- a/docs/index.html +++ b/docs/index.html @@ -14,14 +14,16 @@ window.$docsify = { name: 'Task', repo: 'go-task/task', + ga: 'UA-126286662-1', themeColor: '#83d0f2', - loadSidebar: true, - auto2top: true, - maxLevel: 3, - subMaxLevel: 3 + loadSidebar: true, + auto2top: true, + maxLevel: 3, + subMaxLevel: 3 } + From 2e63a62e088bdf1766d596daf67422dcc91673fb Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Mon, 24 Sep 2018 21:20:58 -0300 Subject: [PATCH 09/14] Delete CNAME --- docs/CNAME | 1 - 1 file changed, 1 deletion(-) delete mode 100644 docs/CNAME diff --git a/docs/CNAME b/docs/CNAME deleted file mode 100644 index 8354e11f..00000000 --- a/docs/CNAME +++ /dev/null @@ -1 +0,0 @@ -taskfile.org \ No newline at end of file From 849a418273b33c70e7f5597bcdc5a80085557a01 Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Mon, 24 Sep 2018 21:21:23 -0300 Subject: [PATCH 10/14] Create CNAME --- docs/CNAME | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/CNAME diff --git a/docs/CNAME b/docs/CNAME new file mode 100644 index 00000000..8354e11f --- /dev/null +++ b/docs/CNAME @@ -0,0 +1 @@ +taskfile.org \ No newline at end of file From 61247a0b2ab32ce58546739fa6a0806d78c283a6 Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Mon, 24 Sep 2018 21:34:10 -0300 Subject: [PATCH 11/14] Cosmetic changes --- README.md | 2 +- Taskfile.yml | 1 + docs/index.html | 2 +- docs/install.sh | 390 +++++++++++++++++++++++++++++++++++++++++++ docs/installation.md | 2 +- 5 files changed, 394 insertions(+), 3 deletions(-) create mode 100755 docs/install.sh diff --git a/README.md b/README.md index 3c7783fe..0c82d8df 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,6 @@ It aims to be simpler and easier to use then [GNU Make][make]. --- -See [taskfile.org](http://taskfile.org) for documentation. +See [taskfile.org](https://taskfile.org) for documentation. [make]: https://www.gnu.org/software/make/ diff --git a/Taskfile.yml b/Taskfile.yml index b811cb66..46a326ba 100644 --- a/Taskfile.yml +++ b/Taskfile.yml @@ -63,6 +63,7 @@ tasks: desc: Generate install script using https://githbub.com/goreleaser/godownloader cmds: - godownloader --repo go-task/task -o install-task.sh + - cp ./install-task.sh ./docs/install.sh ci: cmds: diff --git a/docs/index.html b/docs/index.html index 054051f8..3042fe74 100644 --- a/docs/index.html +++ b/docs/index.html @@ -4,7 +4,7 @@ Task - + diff --git a/docs/install.sh b/docs/install.sh new file mode 100755 index 00000000..c101ee5d --- /dev/null +++ b/docs/install.sh @@ -0,0 +1,390 @@ +#!/bin/sh +set -e +# Code generated by godownloader on 2018-04-07T17:47:38Z. DO NOT EDIT. +# + +usage() { + this=$1 + cat </dev/null +} +echoerr() { + echo "$@" 1>&2 +} +log_prefix() { + echo "$0" +} +_logp=6 +log_set_priority() { + _logp="$1" +} +log_priority() { + if test -z "$1"; then + echo "$_logp" + return + fi + [ "$1" -le "$_logp" ] +} +log_tag() { + case $1 in + 0) echo "emerg" ;; + 1) echo "alert" ;; + 2) echo "crit" ;; + 3) echo "err" ;; + 4) echo "warning" ;; + 5) echo "notice" ;; + 6) echo "info" ;; + 7) echo "debug" ;; + *) echo "$1" ;; + esac +} +log_debug() { + log_priority 7 || return 0 + echoerr "$(log_prefix)" "$(log_tag 7)" "$@" +} +log_info() { + log_priority 6 || return 0 + echoerr "$(log_prefix)" "$(log_tag 6)" "$@" +} +log_err() { + log_priority 3 || return 0 + echoerr "$(log_prefix)" "$(log_tag 3)" "$@" +} +log_crit() { + log_priority 2 || return 0 + echoerr "$(log_prefix)" "$(log_tag 2)" "$@" +} +uname_os() { + os=$(uname -s | tr '[:upper:]' '[:lower:]') + case "$os" in + msys_nt) os="windows" ;; + esac + echo "$os" +} +uname_arch() { + arch=$(uname -m) + case $arch in + x86_64) arch="amd64" ;; + x86) arch="386" ;; + i686) arch="386" ;; + i386) arch="386" ;; + aarch64) arch="arm64" ;; + armv5*) arch="arm5" ;; + armv6*) arch="arm6" ;; + armv7*) arch="arm7" ;; + esac + echo ${arch} +} +uname_os_check() { + os=$(uname_os) + case "$os" in + darwin) return 0 ;; + dragonfly) return 0 ;; + freebsd) return 0 ;; + linux) return 0 ;; + android) return 0 ;; + nacl) return 0 ;; + netbsd) return 0 ;; + openbsd) return 0 ;; + plan9) return 0 ;; + solaris) return 0 ;; + windows) return 0 ;; + esac + log_crit "uname_os_check '$(uname -s)' got converted to '$os' which is not a GOOS value. Please file bug at https://github.com/client9/shlib" + return 1 +} +uname_arch_check() { + arch=$(uname_arch) + case "$arch" in + 386) return 0 ;; + amd64) return 0 ;; + arm64) return 0 ;; + armv5) return 0 ;; + armv6) return 0 ;; + armv7) return 0 ;; + ppc64) return 0 ;; + ppc64le) return 0 ;; + mips) return 0 ;; + mipsle) return 0 ;; + mips64) return 0 ;; + mips64le) return 0 ;; + s390x) return 0 ;; + amd64p32) return 0 ;; + esac + log_crit "uname_arch_check '$(uname -m)' got converted to '$arch' which is not a GOARCH value. Please file bug report at https://github.com/client9/shlib" + return 1 +} +untar() { + tarball=$1 + case "${tarball}" in + *.tar.gz | *.tgz) tar -xzf "${tarball}" ;; + *.tar) tar -xf "${tarball}" ;; + *.zip) unzip "${tarball}" ;; + *) + log_err "untar unknown archive format for ${tarball}" + return 1 + ;; + esac +} +mktmpdir() { + test -z "$TMPDIR" && TMPDIR="$(mktemp -d)" + mkdir -p "${TMPDIR}" + echo "${TMPDIR}" +} +http_download_curl() { + local_file=$1 + source_url=$2 + header=$3 + if [ -z "$header" ]; then + code=$(curl -w '%{http_code}' -sL -o "$local_file" "$source_url") + else + code=$(curl -w '%{http_code}' -sL -H "$header" -o "$local_file" "$source_url") + fi + if [ "$code" != "200" ]; then + log_debug "http_download_curl received HTTP status $code" + return 1 + fi + return 0 +} +http_download_wget() { + local_file=$1 + source_url=$2 + header=$3 + if [ -z "$header" ]; then + wget -q -O "$local_file" "$source_url" + else + wget -q --header "$header" -O "$local_file" "$source_url" + fi +} +http_download() { + log_debug "http_download $2" + if is_command curl; then + http_download_curl "$@" + return + elif is_command wget; then + http_download_wget "$@" + return + fi + log_crit "http_download unable to find wget or curl" + return 1 +} +http_copy() { + tmp=$(mktemp) + http_download "${tmp}" "$1" "$2" || return 1 + body=$(cat "$tmp") + rm -f "${tmp}" + echo "$body" +} +github_release() { + owner_repo=$1 + version=$2 + test -z "$version" && version="latest" + giturl="https://github.com/${owner_repo}/releases/${version}" + json=$(http_copy "$giturl" "Accept:application/json") + test -z "$json" && return 1 + version=$(echo "$json" | tr -s '\n' ' ' | sed 's/.*"tag_name":"//' | sed 's/".*//') + test -z "$version" && return 1 + echo "$version" +} +hash_sha256() { + TARGET=${1:-/dev/stdin} + if is_command gsha256sum; then + hash=$(gsha256sum "$TARGET") || return 1 + echo "$hash" | cut -d ' ' -f 1 + elif is_command sha256sum; then + hash=$(sha256sum "$TARGET") || return 1 + echo "$hash" | cut -d ' ' -f 1 + elif is_command shasum; then + hash=$(shasum -a 256 "$TARGET" 2>/dev/null) || return 1 + echo "$hash" | cut -d ' ' -f 1 + elif is_command openssl; then + hash=$(openssl -dst openssl dgst -sha256 "$TARGET") || return 1 + echo "$hash" | cut -d ' ' -f a + else + log_crit "hash_sha256 unable to find command to compute sha-256 hash" + return 1 + fi +} +hash_sha256_verify() { + TARGET=$1 + checksums=$2 + if [ -z "$checksums" ]; then + log_err "hash_sha256_verify checksum file not specified in arg2" + return 1 + fi + BASENAME=${TARGET##*/} + want=$(grep "${BASENAME}" "${checksums}" 2>/dev/null | tr '\t' ' ' | cut -d ' ' -f 1) + if [ -z "$want" ]; then + log_err "hash_sha256_verify unable to find checksum for '${TARGET}' in '${checksums}'" + return 1 + fi + got=$(hash_sha256 "$TARGET") + if [ "$want" != "$got" ]; then + log_err "hash_sha256_verify checksum for '$TARGET' did not verify ${want} vs $got" + return 1 + fi +} +cat /dev/null < Date: Mon, 24 Sep 2018 21:52:14 -0300 Subject: [PATCH 12/14] Fix typo --- Taskfile.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Taskfile.yml b/Taskfile.yml index 46a326ba..91621a54 100644 --- a/Taskfile.yml +++ b/Taskfile.yml @@ -60,7 +60,7 @@ tasks: - goreleaser --snapshot --rm-dist generate-install-script: - desc: Generate install script using https://githbub.com/goreleaser/godownloader + desc: Generate install script using https://github.com/goreleaser/godownloader cmds: - godownloader --repo go-task/task -o install-task.sh - cp ./install-task.sh ./docs/install.sh From b5b2649283391fb9a00ddc1cc1d866bd6785c3cb Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Sat, 6 Oct 2018 17:55:23 -0300 Subject: [PATCH 13/14] Fix broken --status flag Fixes #139 --- status.go | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/status.go b/status.go index 853ae246..0459efee 100644 --- a/status.go +++ b/status.go @@ -12,9 +12,9 @@ import ( // Status returns an error if any the of given tasks is not up-to-date func (e *Executor) Status(calls ...taskfile.Call) error { for _, call := range calls { - t, ok := e.Taskfile.Tasks[call.Task] - if !ok { - return &taskNotFoundError{taskName: call.Task} + t, err := e.CompiledTask(call) + if err != nil { + return err } isUpToDate, err := isTaskUpToDate(e.Context, t) if err != nil { From b77fcd6c8a9c11da89a348c4df3049c1ad4d522e Mon Sep 17 00:00:00 2001 From: Andrey Nering Date: Sun, 7 Oct 2018 18:34:03 -0300 Subject: [PATCH 14/14] Documentation improvements --- README.md | 7 +++---- docs/README.md | 45 ++++++++++++++++++++++++++++++++++++++++---- docs/installation.md | 30 +++++++++++++++-------------- 3 files changed, 60 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index 0c82d8df..8e01e183 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,9 @@ [![Build Status](https://travis-ci.org/go-task/task.svg?branch=master)](https://travis-ci.org/go-task/task) -# Task - A task runner / simpler Make alternative written in Go +# Task -Task is a simple tool that allows you to easily run development and build -tasks. Task is written in Go, but can be used to develop any language. -It aims to be simpler and easier to use then [GNU Make][make]. +Task is a task runner / build tool that aims to be simpler and easier to use +than, for example, [GNU Make][make]. --- diff --git a/docs/README.md b/docs/README.md index aea5dc9b..ed06d7d1 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,9 +1,46 @@ # Task -A task runner / simpler Make alternative written in Go +Task is a task runner / build tool that aims to be simpler and easier to use +than, for example, [GNU Make][make]. -Task is a simple tool that allows you to easily run development and build -tasks. Task is written in Go, but can be used to develop any language. -It aims to be simpler and easier to use then [GNU Make][make]. +Since it's written in [Go][go], Task is just a single binary and has no other +dependencies, which means you don't need to mess with any complicated install +setups just to use a build tool. + +Once [installed](installation), you just need to describe your build tasks +using a simple [YAML][yaml] schema in a file called `Taskfile.yml`: + +```yaml +version: '2' + +tasks: + hello: + cmds: + - echo 'Hello World from Task!' + silent: true +``` + +And call it by running `task hello` from you terminal. + +The above example is just the start, you can take a look at the [usage](usage) +guide to check the full schema documentation and Task features. + +## Features + +- [Easy installation](installation): just download a single binary, add to + $PATH and you're done! Or you can also install using [Homebrew][homebrew] or + [Snapcraft][snapcraft] if you want; +- Available on CIs: by adding [this simple command](installation#install-script) + to install on your CI script and you're done to use Task as part of your CI pipeline; +- Truly cross-platform: while most build tools only work well on Linux or macOS, + Task also supports Windows thanks to [this awesome shell interpreter for Go][sh]; +- Great for code generation: you can easily [prevent a task from running](usage#prevent-unnecessary-work) + if a given set of files haven't changed since last run (based either on its + timestamp or content). [make]: https://www.gnu.org/software/make/ +[go]: https://golang.org/ +[yaml]: http://yaml.org/ +[homebrew]: https://brew.sh/ +[snapcraft]: https://snapcraft.io/ +[sh]: https://mvdan.cc/sh diff --git a/docs/installation.md b/docs/installation.md index b71cd4d4..93b1f715 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -1,12 +1,10 @@ # Installation -## Go +## Binary -If you have a [Golang][golang] environment setup, you can simply run: - -```bash -go get -u -v github.com/go-task/task/cmd/task -``` +Or you can download the binary from the [releases][releases] page and add to +your $PATH. DEB and RPM packages are also available. +The `task_checksums.txt` file contains the sha256 checksum for each file. ## Homebrew @@ -27,23 +25,27 @@ right: sudo snap install task ``` +## Go + +If you have a [Go][go] environment setup, you can simply run: + +```bash +go get -u -v github.com/go-task/task/cmd/task +``` + ## Install script We also have a [install script][installscript], which is very useful on -scanarios like CIs. Many thanks to [godownloader][godownloader] for easily -generating this script. +scanarios like CIs. Many thanks to [godownloader][godownloader] for allowing +easily generating this script. ```bash curl -s https://taskfile.org/install.sh | sh ``` -## Binary +> This method will download the binary on the local `./bin` directory by default. -Or you can download the binary from the [releases][releases] page and add to -your `PATH`. DEB and RPM packages are also available. -The `task_checksums.txt` file contains the sha256 checksum for each file. - -[golang]: https://golang.org/ +[go]: https://golang.org/ [snapcraft]: https://snapcraft.io/ [homebrew]: https://brew.sh/ [installscript]: https://github.com/go-task/task/blob/master/install-task.sh