New Preview

Build.ps1

@@ -0,0 +1,70 @@
+$ErrorActionPreference = 'Stop'
+
+function Clean-Output
+{
+	if(Test-Path ./artifacts) { rm ./artifacts -Force -Recurse }
+}
+
+function Restore-Packages
+{
+	& dotnet restore
+}
+
+function Execute-Tests
+{
+ & dotnet test ./test/SeqCli.Tests/SeqCli.Tests.csproj -c Release /p:Configuration=Release /p:Platform=x64 /p:VersionPrefix=$version
+ if($LASTEXITCODE -ne 0) { exit 3 }
+}
+
+function Create-ArtifactDir
+{
+	mkdir ./artifacts
+}
+
+function Publish-Gzips($version)
+{
+	$rids = @("linux-x64", "osx-x64")
+	foreach ($rid in $rids) {
+ & dotnet publish src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r $rid /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+ if($LASTEXITCODE -ne 0) { exit 4 }
+
+ # Make sure the archive contains a reasonable root filename
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+
+ & ./build/7-zip/7za.exe a -ttar seqcli-$version-$rid.tar ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+ if($LASTEXITCODE -ne 0) { exit 5 }
+
+ # Back to the original directory name
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/
+
+ & ./build/7-zip/7za.exe a -tgzip ./artifacts/seqcli-$version-$rid.tar.gz seqcli-$version-$rid.tar
+ if($LASTEXITCODE -ne 0) { exit 6 }
+
+ rm seqcli-$version-$rid.tar
+	}
+}
+
+function Publish-Msi($version)
+{
+	& dotnet publish ./src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r win-x64 /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+	if($LASTEXITCODE -ne 0) { exit 7 }
+
+	& msbuild ./setup/SeqCli.Setup/SeqCli.Setup.wixproj /t:Build /p:Configuration=Release /p:Platform=x64 /p:Version=$version /p:BuildProjectReferences=false
+	if($LASTEXITCODE -ne 0) { exit 8 }
+
+	mv ./setup/SeqCli.Setup/bin/Release/seqcli.msi ./artifacts/seqcli-$version.msi
+}
+
+Push-Location $PSScriptRoot
+
+$version = @{ $true = $env:APPVEYOR_BUILD_VERSION; $false = "99.99.99" }[$env:APPVEYOR_BUILD_VERSION -ne $NULL];
+Write-Output "Building version $version"
+
+Clean-Output
+Create-ArtifactDir
+Restore-Packages
+Publish-Msi($version)
+Publish-Gzips($version)
+Execute-Tests
+
+Pop-Location

LICENSE

@@ -178,15 +178,15 @@
  APPENDIX: How to apply the Apache License to your work.
 
  To apply the Apache License to your work, attach the following
- boilerplate notice, with the fields enclosed by brackets "[]"
+ boilerplate notice, with the fields enclosed by brackets "{}"
  replaced with your own identifying information. (Don't include
  the brackets!) The text should be enclosed in the appropriate
  comment syntax for the file format. We also recommend that a
  file or class name and description of purpose be included on the
  same "printed page" as the copyright notice for easier
  identification within third-party archives.
 
- Copyright [yyyy] [name of copyright owner]
+ Copyright {yyyy} {name of copyright owner}
 
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.

README.md

@@ -1,2 +1,141 @@
-# seqcli
-Seq client command-line
+# `seqcli` [![Build status](https://ci.appveyor.com/api/projects/status/sc3iacxwxqqfjgdh?svg=true)](https://ci.appveyor.com/project/datalust/seqcli) [![GitHub release](https://img.shields.io/github/release/datalust/seqcli.svg)](https://github.com/datalust/seqcli/releases)
+
+The [Seq](https://getseq.net) client command-line app. Supports logging (`seqcli log`), searching (`search`), tailing (`tail`), querying (`query`) and [JSON log file](https://github.com/serilog/serilog-formatting-compact) ingestion (`ingest`).
+
+![SeqCli Screenshot](https://raw.githubusercontent.com/datalust/seqcli/dev/asset/SeqCli.png)
+
+## Getting started
+
+Install or unzip the [release for your operating system](https://github.com/datalust/seqcli/releases).
+
+To set a default server URL, run:
+
+```
+seqcli config -k connection.serverUrl -v https://your-seq-server
+```
+
+This will create `SeqConfig.json` in your home directory. A default API key can also be set by providing the `connection.apiKey` setting name.
+
+## Commands
+
+Usage:
+
+```
+seqcli <command> [<args>]
+```
+
+### `config`
+
+View and set fields in the `SeqCli.json` file; run with no arguments to list all fields.
+
+| Option | Description |
+| ------ | ----------- |
+| `-k`, `--key=VALUE` | The field, for example `connection.serverUrl` |
+| `-v`, `--value=VALUE` | The field value; if not specified, the command will print the current value |
+| `-c`, `--clear` | Clear the field |
+
+### `help`
+
+Show information about available commands.
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--markdown` | Generate markdown for use in documentation |
+
+### `ingest`
+
+Send JSON log events from a file or `STDIN`.
+
+Example:
+
+```
+seqcli ingest -i events.clef --filter="@Level <> 'Debug'" -p Environment=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-i`, `--input=VALUE` | CLEF file to ingest; if not specified, `STDIN` will be used |
+| `--invalid-data=VALUE` | Specify how invalid data is handled: fail (default) or ignore |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-f`, `--filter=VALUE` | Filter expression to select a subset of events |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `log`
+
+Send a structured log event to the server.
+
+Example:
+
+```
+seqcli log -m 'Hello, {Name}!' -p Name=World -p App=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--message=VALUE` | A message to associate with the event (the default is to send no message); https://messagetemplates.org syntax is supported |
+| `-l`, `--level=VALUE` | The level or severity of the event (the default is `Information`) |
+| `-t`, `--timestamp=VALUE` | The event timestamp as ISO-8601 (the current UTC timestamp will be used by default) |
+| `-x`, `--exception=VALUE` | Additional exception or error information to send, if any |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `query`
+
+Execute an SQL query and receive results in CSV format.
+
+Example:
+
+```
+seqcli query -q "select count(*) from stream group by @Level" --start="2018-02-28T13:00Z"
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-q`, `--query=VALUE` | The query to execute |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `--timeout=VALUE` | The query execution timeout in milliseconds |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `search`
+
+Retrieve log events that match a given filter.
+
+Example:
+
+```
+seqcli search -f "@Exception like '%TimeoutException%'" -c 30
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | A filter to apply to the search, for example `Host = 'xmpweb-01.example.com'` |
+| `-c`, `--count=VALUE` | The maximum number of events to retrieve; the default is 1 |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `tail`
+
+Stream log events matching a filter.
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | An optional server-side filter to apply to the stream, for example `@Level = 'Error'` |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `version`
+
+Print the current executable version.

appveyor.yml

@@ -0,0 +1,17 @@
+version: 0.1.{build}
+skip_tags: true
+image: Visual Studio 2017
+build_script:
+- ps: ./Build.ps1
+test: off
+artifacts:
+- path: artifacts/seqcli-*.msi
+- path: artifacts/seqcli-*.tar.gz
+deploy:
+- provider: GitHub
+ auth_token:
+ secure: Bo3ypKpKFxinjR9ShkNekNvkob2iklHJU+UlYyfHtcFFIAa58SV2TkEd0xWxz633
+ artifact: /seqcli-.*\.(msi|tar\.gz)/
+ tag: v$(appveyor_build_version)
+ on:
+ branch: master

Build.ps1

@@ -0,0 +1,70 @@
+$ErrorActionPreference = 'Stop'
+
+function Clean-Output
+{
+	if(Test-Path ./artifacts) { rm ./artifacts -Force -Recurse }
+}
+
+function Restore-Packages
+{
+	& dotnet restore
+}
+
+function Execute-Tests
+{
+ & dotnet test ./test/SeqCli.Tests/SeqCli.Tests.csproj -c Release /p:Configuration=Release /p:Platform=x64 /p:VersionPrefix=$version
+ if($LASTEXITCODE -ne 0) { exit 3 }
+}
+
+function Create-ArtifactDir
+{
+	mkdir ./artifacts
+}
+
+function Publish-Gzips($version)
+{
+	$rids = @("linux-x64", "osx-x64")
+	foreach ($rid in $rids) {
+ & dotnet publish src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r $rid /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+ if($LASTEXITCODE -ne 0) { exit 4 }
+
+ # Make sure the archive contains a reasonable root filename
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+
+ & ./build/7-zip/7za.exe a -ttar seqcli-$version-$rid.tar ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+ if($LASTEXITCODE -ne 0) { exit 5 }
+
+ # Back to the original directory name
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/
+
+ & ./build/7-zip/7za.exe a -tgzip ./artifacts/seqcli-$version-$rid.tar.gz seqcli-$version-$rid.tar
+ if($LASTEXITCODE -ne 0) { exit 6 }
+
+ rm seqcli-$version-$rid.tar
+	}
+}
+
+function Publish-Msi($version)
+{
+	& dotnet publish ./src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r win-x64 /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+	if($LASTEXITCODE -ne 0) { exit 7 }
+
+	& msbuild ./setup/SeqCli.Setup/SeqCli.Setup.wixproj /t:Build /p:Configuration=Release /p:Platform=x64 /p:Version=$version /p:BuildProjectReferences=false
+	if($LASTEXITCODE -ne 0) { exit 8 }
+
+	mv ./setup/SeqCli.Setup/bin/Release/seqcli.msi ./artifacts/seqcli-$version.msi
+}
+
+Push-Location $PSScriptRoot
+
+$version = @{ $true = $env:APPVEYOR_BUILD_VERSION; $false = "99.99.99" }[$env:APPVEYOR_BUILD_VERSION -ne $NULL];
+Write-Output "Building version $version"
+
+Clean-Output
+Create-ArtifactDir
+Restore-Packages
+Publish-Msi($version)
+Publish-Gzips($version)
+Execute-Tests
+
+Pop-Location

LICENSE

@@ -178,15 +178,15 @@
  APPENDIX: How to apply the Apache License to your work.
 
  To apply the Apache License to your work, attach the following
- boilerplate notice, with the fields enclosed by brackets "[]"
+ boilerplate notice, with the fields enclosed by brackets "{}"
  replaced with your own identifying information. (Don't include
  the brackets!) The text should be enclosed in the appropriate
  comment syntax for the file format. We also recommend that a
  file or class name and description of purpose be included on the
  same "printed page" as the copyright notice for easier
  identification within third-party archives.
 
- Copyright [yyyy] [name of copyright owner]
+ Copyright {yyyy} {name of copyright owner}
 
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.

README.md

@@ -1,2 +1,141 @@
-# seqcli
-Seq client command-line
+# `seqcli` [![Build status](https://ci.appveyor.com/api/projects/status/sc3iacxwxqqfjgdh?svg=true)](https://ci.appveyor.com/project/datalust/seqcli) [![GitHub release](https://img.shields.io/github/release/datalust/seqcli.svg)](https://github.com/datalust/seqcli/releases)
+
+The [Seq](https://getseq.net) client command-line app. Supports logging (`seqcli log`), searching (`search`), tailing (`tail`), querying (`query`) and [JSON log file](https://github.com/serilog/serilog-formatting-compact) ingestion (`ingest`).
+
+![SeqCli Screenshot](https://raw.githubusercontent.com/datalust/seqcli/dev/asset/SeqCli.png)
+
+## Getting started
+
+Install or unzip the [release for your operating system](https://github.com/datalust/seqcli/releases).
+
+To set a default server URL, run:
+
+```
+seqcli config -k connection.serverUrl -v https://your-seq-server
+```
+
+This will create `SeqConfig.json` in your home directory. A default API key can also be set by providing the `connection.apiKey` setting name.
+
+## Commands
+
+Usage:
+
+```
+seqcli <command> [<args>]
+```
+
+### `config`
+
+View and set fields in the `SeqCli.json` file; run with no arguments to list all fields.
+
+| Option | Description |
+| ------ | ----------- |
+| `-k`, `--key=VALUE` | The field, for example `connection.serverUrl` |
+| `-v`, `--value=VALUE` | The field value; if not specified, the command will print the current value |
+| `-c`, `--clear` | Clear the field |
+
+### `help`
+
+Show information about available commands.
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--markdown` | Generate markdown for use in documentation |
+
+### `ingest`
+
+Send JSON log events from a file or `STDIN`.
+
+Example:
+
+```
+seqcli ingest -i events.clef --filter="@Level <> 'Debug'" -p Environment=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-i`, `--input=VALUE` | CLEF file to ingest; if not specified, `STDIN` will be used |
+| `--invalid-data=VALUE` | Specify how invalid data is handled: fail (default) or ignore |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-f`, `--filter=VALUE` | Filter expression to select a subset of events |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `log`
+
+Send a structured log event to the server.
+
+Example:
+
+```
+seqcli log -m 'Hello, {Name}!' -p Name=World -p App=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--message=VALUE` | A message to associate with the event (the default is to send no message); https://messagetemplates.org syntax is supported |
+| `-l`, `--level=VALUE` | The level or severity of the event (the default is `Information`) |
+| `-t`, `--timestamp=VALUE` | The event timestamp as ISO-8601 (the current UTC timestamp will be used by default) |
+| `-x`, `--exception=VALUE` | Additional exception or error information to send, if any |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `query`
+
+Execute an SQL query and receive results in CSV format.
+
+Example:
+
+```
+seqcli query -q "select count(*) from stream group by @Level" --start="2018-02-28T13:00Z"
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-q`, `--query=VALUE` | The query to execute |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `--timeout=VALUE` | The query execution timeout in milliseconds |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `search`
+
+Retrieve log events that match a given filter.
+
+Example:
+
+```
+seqcli search -f "@Exception like '%TimeoutException%'" -c 30
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | A filter to apply to the search, for example `Host = 'xmpweb-01.example.com'` |
+| `-c`, `--count=VALUE` | The maximum number of events to retrieve; the default is 1 |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `tail`
+
+Stream log events matching a filter.
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | An optional server-side filter to apply to the stream, for example `@Level = 'Error'` |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `version`
+
+Print the current executable version.

appveyor.yml

@@ -0,0 +1,17 @@
+version: 0.1.{build}
+skip_tags: true
+image: Visual Studio 2017
+build_script:
+- ps: ./Build.ps1
+test: off
+artifacts:
+- path: artifacts/seqcli-*.msi
+- path: artifacts/seqcli-*.tar.gz
+deploy:
+- provider: GitHub
+ auth_token:
+ secure: Bo3ypKpKFxinjR9ShkNekNvkob2iklHJU+UlYyfHtcFFIAa58SV2TkEd0xWxz633
+ artifact: /seqcli-.*\.(msi|tar\.gz)/
+ tag: v$(appveyor_build_version)
+ on:
+ branch: master

Build.ps1

@@ -0,0 +1,70 @@
+$ErrorActionPreference = 'Stop'
+
+function Clean-Output
+{
+	if(Test-Path ./artifacts) { rm ./artifacts -Force -Recurse }
+}
+
+function Restore-Packages
+{
+	& dotnet restore
+}
+
+function Execute-Tests
+{
+ & dotnet test ./test/SeqCli.Tests/SeqCli.Tests.csproj -c Release /p:Configuration=Release /p:Platform=x64 /p:VersionPrefix=$version
+ if($LASTEXITCODE -ne 0) { exit 3 }
+}
+
+function Create-ArtifactDir
+{
+	mkdir ./artifacts
+}
+
+function Publish-Gzips($version)
+{
+	$rids = @("linux-x64", "osx-x64")
+	foreach ($rid in $rids) {
+ & dotnet publish src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r $rid /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+ if($LASTEXITCODE -ne 0) { exit 4 }
+
+ # Make sure the archive contains a reasonable root filename
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+
+ & ./build/7-zip/7za.exe a -ttar seqcli-$version-$rid.tar ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+ if($LASTEXITCODE -ne 0) { exit 5 }
+
+ # Back to the original directory name
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/
+
+ & ./build/7-zip/7za.exe a -tgzip ./artifacts/seqcli-$version-$rid.tar.gz seqcli-$version-$rid.tar
+ if($LASTEXITCODE -ne 0) { exit 6 }
+
+ rm seqcli-$version-$rid.tar
+	}
+}
+
+function Publish-Msi($version)
+{
+	& dotnet publish ./src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r win-x64 /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+	if($LASTEXITCODE -ne 0) { exit 7 }
+
+	& msbuild ./setup/SeqCli.Setup/SeqCli.Setup.wixproj /t:Build /p:Configuration=Release /p:Platform=x64 /p:Version=$version /p:BuildProjectReferences=false
+	if($LASTEXITCODE -ne 0) { exit 8 }
+
+	mv ./setup/SeqCli.Setup/bin/Release/seqcli.msi ./artifacts/seqcli-$version.msi
+}
+
+Push-Location $PSScriptRoot
+
+$version = @{ $true = $env:APPVEYOR_BUILD_VERSION; $false = "99.99.99" }[$env:APPVEYOR_BUILD_VERSION -ne $NULL];
+Write-Output "Building version $version"
+
+Clean-Output
+Create-ArtifactDir
+Restore-Packages
+Publish-Msi($version)
+Publish-Gzips($version)
+Execute-Tests
+
+Pop-Location

LICENSE

@@ -178,15 +178,15 @@
  APPENDIX: How to apply the Apache License to your work.
 
  To apply the Apache License to your work, attach the following
- boilerplate notice, with the fields enclosed by brackets "[]"
+ boilerplate notice, with the fields enclosed by brackets "{}"
  replaced with your own identifying information. (Don't include
  the brackets!) The text should be enclosed in the appropriate
  comment syntax for the file format. We also recommend that a
  file or class name and description of purpose be included on the
  same "printed page" as the copyright notice for easier
  identification within third-party archives.
 
- Copyright [yyyy] [name of copyright owner]
+ Copyright {yyyy} {name of copyright owner}
 
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.

README.md

@@ -1,2 +1,141 @@
-# seqcli
-Seq client command-line
+# `seqcli` [![Build status](https://ci.appveyor.com/api/projects/status/sc3iacxwxqqfjgdh?svg=true)](https://ci.appveyor.com/project/datalust/seqcli) [![GitHub release](https://img.shields.io/github/release/datalust/seqcli.svg)](https://github.com/datalust/seqcli/releases)
+
+The [Seq](https://getseq.net) client command-line app. Supports logging (`seqcli log`), searching (`search`), tailing (`tail`), querying (`query`) and [JSON log file](https://github.com/serilog/serilog-formatting-compact) ingestion (`ingest`).
+
+![SeqCli Screenshot](https://raw.githubusercontent.com/datalust/seqcli/dev/asset/SeqCli.png)
+
+## Getting started
+
+Install or unzip the [release for your operating system](https://github.com/datalust/seqcli/releases).
+
+To set a default server URL, run:
+
+```
+seqcli config -k connection.serverUrl -v https://your-seq-server
+```
+
+This will create `SeqConfig.json` in your home directory. A default API key can also be set by providing the `connection.apiKey` setting name.
+
+## Commands
+
+Usage:
+
+```
+seqcli <command> [<args>]
+```
+
+### `config`
+
+View and set fields in the `SeqCli.json` file; run with no arguments to list all fields.
+
+| Option | Description |
+| ------ | ----------- |
+| `-k`, `--key=VALUE` | The field, for example `connection.serverUrl` |
+| `-v`, `--value=VALUE` | The field value; if not specified, the command will print the current value |
+| `-c`, `--clear` | Clear the field |
+
+### `help`
+
+Show information about available commands.
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--markdown` | Generate markdown for use in documentation |
+
+### `ingest`
+
+Send JSON log events from a file or `STDIN`.
+
+Example:
+
+```
+seqcli ingest -i events.clef --filter="@Level <> 'Debug'" -p Environment=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-i`, `--input=VALUE` | CLEF file to ingest; if not specified, `STDIN` will be used |
+| `--invalid-data=VALUE` | Specify how invalid data is handled: fail (default) or ignore |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-f`, `--filter=VALUE` | Filter expression to select a subset of events |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `log`
+
+Send a structured log event to the server.
+
+Example:
+
+```
+seqcli log -m 'Hello, {Name}!' -p Name=World -p App=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--message=VALUE` | A message to associate with the event (the default is to send no message); https://messagetemplates.org syntax is supported |
+| `-l`, `--level=VALUE` | The level or severity of the event (the default is `Information`) |
+| `-t`, `--timestamp=VALUE` | The event timestamp as ISO-8601 (the current UTC timestamp will be used by default) |
+| `-x`, `--exception=VALUE` | Additional exception or error information to send, if any |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `query`
+
+Execute an SQL query and receive results in CSV format.
+
+Example:
+
+```
+seqcli query -q "select count(*) from stream group by @Level" --start="2018-02-28T13:00Z"
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-q`, `--query=VALUE` | The query to execute |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `--timeout=VALUE` | The query execution timeout in milliseconds |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `search`
+
+Retrieve log events that match a given filter.
+
+Example:
+
+```
+seqcli search -f "@Exception like '%TimeoutException%'" -c 30
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | A filter to apply to the search, for example `Host = 'xmpweb-01.example.com'` |
+| `-c`, `--count=VALUE` | The maximum number of events to retrieve; the default is 1 |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `tail`
+
+Stream log events matching a filter.
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | An optional server-side filter to apply to the stream, for example `@Level = 'Error'` |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `version`
+
+Print the current executable version.

appveyor.yml

@@ -0,0 +1,17 @@
+version: 0.1.{build}
+skip_tags: true
+image: Visual Studio 2017
+build_script:
+- ps: ./Build.ps1
+test: off
+artifacts:
+- path: artifacts/seqcli-*.msi
+- path: artifacts/seqcli-*.tar.gz
+deploy:
+- provider: GitHub
+ auth_token:
+ secure: Bo3ypKpKFxinjR9ShkNekNvkob2iklHJU+UlYyfHtcFFIAa58SV2TkEd0xWxz633
+ artifact: /seqcli-.*\.(msi|tar\.gz)/
+ tag: v$(appveyor_build_version)
+ on:
+ branch: master

Build.ps1

@@ -0,0 +1,70 @@
+$ErrorActionPreference = 'Stop'
+
+function Clean-Output
+{
+	if(Test-Path ./artifacts) { rm ./artifacts -Force -Recurse }
+}
+
+function Restore-Packages
+{
+	& dotnet restore
+}
+
+function Execute-Tests
+{
+ & dotnet test ./test/SeqCli.Tests/SeqCli.Tests.csproj -c Release /p:Configuration=Release /p:Platform=x64 /p:VersionPrefix=$version
+ if($LASTEXITCODE -ne 0) { exit 3 }
+}
+
+function Create-ArtifactDir
+{
+	mkdir ./artifacts
+}
+
+function Publish-Gzips($version)
+{
+	$rids = @("linux-x64", "osx-x64")
+	foreach ($rid in $rids) {
+ & dotnet publish src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r $rid /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+ if($LASTEXITCODE -ne 0) { exit 4 }
+
+ # Make sure the archive contains a reasonable root filename
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+
+ & ./build/7-zip/7za.exe a -ttar seqcli-$version-$rid.tar ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+ if($LASTEXITCODE -ne 0) { exit 5 }
+
+ # Back to the original directory name
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/
+
+ & ./build/7-zip/7za.exe a -tgzip ./artifacts/seqcli-$version-$rid.tar.gz seqcli-$version-$rid.tar
+ if($LASTEXITCODE -ne 0) { exit 6 }
+
+ rm seqcli-$version-$rid.tar
+	}
+}
+
+function Publish-Msi($version)
+{
+	& dotnet publish ./src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r win-x64 /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+	if($LASTEXITCODE -ne 0) { exit 7 }
+
+	& msbuild ./setup/SeqCli.Setup/SeqCli.Setup.wixproj /t:Build /p:Configuration=Release /p:Platform=x64 /p:Version=$version /p:BuildProjectReferences=false
+	if($LASTEXITCODE -ne 0) { exit 8 }
+
+	mv ./setup/SeqCli.Setup/bin/Release/seqcli.msi ./artifacts/seqcli-$version.msi
+}
+
+Push-Location $PSScriptRoot
+
+$version = @{ $true = $env:APPVEYOR_BUILD_VERSION; $false = "99.99.99" }[$env:APPVEYOR_BUILD_VERSION -ne $NULL];
+Write-Output "Building version $version"
+
+Clean-Output
+Create-ArtifactDir
+Restore-Packages
+Publish-Msi($version)
+Publish-Gzips($version)
+Execute-Tests
+
+Pop-Location

LICENSE

@@ -178,15 +178,15 @@
  APPENDIX: How to apply the Apache License to your work.
 
  To apply the Apache License to your work, attach the following
- boilerplate notice, with the fields enclosed by brackets "[]"
+ boilerplate notice, with the fields enclosed by brackets "{}"
  replaced with your own identifying information. (Don't include
  the brackets!) The text should be enclosed in the appropriate
  comment syntax for the file format. We also recommend that a
  file or class name and description of purpose be included on the
  same "printed page" as the copyright notice for easier
  identification within third-party archives.
 
- Copyright [yyyy] [name of copyright owner]
+ Copyright {yyyy} {name of copyright owner}
 
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.

README.md

@@ -1,2 +1,141 @@
-# seqcli
-Seq client command-line
+# `seqcli` [![Build status](https://ci.appveyor.com/api/projects/status/sc3iacxwxqqfjgdh?svg=true)](https://ci.appveyor.com/project/datalust/seqcli) [![GitHub release](https://img.shields.io/github/release/datalust/seqcli.svg)](https://github.com/datalust/seqcli/releases)
+
+The [Seq](https://getseq.net) client command-line app. Supports logging (`seqcli log`), searching (`search`), tailing (`tail`), querying (`query`) and [JSON log file](https://github.com/serilog/serilog-formatting-compact) ingestion (`ingest`).
+
+![SeqCli Screenshot](https://raw.githubusercontent.com/datalust/seqcli/dev/asset/SeqCli.png)
+
+## Getting started
+
+Install or unzip the [release for your operating system](https://github.com/datalust/seqcli/releases).
+
+To set a default server URL, run:
+
+```
+seqcli config -k connection.serverUrl -v https://your-seq-server
+```
+
+This will create `SeqConfig.json` in your home directory. A default API key can also be set by providing the `connection.apiKey` setting name.
+
+## Commands
+
+Usage:
+
+```
+seqcli <command> [<args>]
+```
+
+### `config`
+
+View and set fields in the `SeqCli.json` file; run with no arguments to list all fields.
+
+| Option | Description |
+| ------ | ----------- |
+| `-k`, `--key=VALUE` | The field, for example `connection.serverUrl` |
+| `-v`, `--value=VALUE` | The field value; if not specified, the command will print the current value |
+| `-c`, `--clear` | Clear the field |
+
+### `help`
+
+Show information about available commands.
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--markdown` | Generate markdown for use in documentation |
+
+### `ingest`
+
+Send JSON log events from a file or `STDIN`.
+
+Example:
+
+```
+seqcli ingest -i events.clef --filter="@Level <> 'Debug'" -p Environment=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-i`, `--input=VALUE` | CLEF file to ingest; if not specified, `STDIN` will be used |
+| `--invalid-data=VALUE` | Specify how invalid data is handled: fail (default) or ignore |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-f`, `--filter=VALUE` | Filter expression to select a subset of events |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `log`
+
+Send a structured log event to the server.
+
+Example:
+
+```
+seqcli log -m 'Hello, {Name}!' -p Name=World -p App=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--message=VALUE` | A message to associate with the event (the default is to send no message); https://messagetemplates.org syntax is supported |
+| `-l`, `--level=VALUE` | The level or severity of the event (the default is `Information`) |
+| `-t`, `--timestamp=VALUE` | The event timestamp as ISO-8601 (the current UTC timestamp will be used by default) |
+| `-x`, `--exception=VALUE` | Additional exception or error information to send, if any |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `query`
+
+Execute an SQL query and receive results in CSV format.
+
+Example:
+
+```
+seqcli query -q "select count(*) from stream group by @Level" --start="2018-02-28T13:00Z"
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-q`, `--query=VALUE` | The query to execute |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `--timeout=VALUE` | The query execution timeout in milliseconds |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `search`
+
+Retrieve log events that match a given filter.
+
+Example:
+
+```
+seqcli search -f "@Exception like '%TimeoutException%'" -c 30
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | A filter to apply to the search, for example `Host = 'xmpweb-01.example.com'` |
+| `-c`, `--count=VALUE` | The maximum number of events to retrieve; the default is 1 |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `tail`
+
+Stream log events matching a filter.
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | An optional server-side filter to apply to the stream, for example `@Level = 'Error'` |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `version`
+
+Print the current executable version.

appveyor.yml

@@ -0,0 +1,17 @@
+version: 0.1.{build}
+skip_tags: true
+image: Visual Studio 2017
+build_script:
+- ps: ./Build.ps1
+test: off
+artifacts:
+- path: artifacts/seqcli-*.msi
+- path: artifacts/seqcli-*.tar.gz
+deploy:
+- provider: GitHub
+ auth_token:
+ secure: Bo3ypKpKFxinjR9ShkNekNvkob2iklHJU+UlYyfHtcFFIAa58SV2TkEd0xWxz633
+ artifact: /seqcli-.*\.(msi|tar\.gz)/
+ tag: v$(appveyor_build_version)
+ on:
+ branch: master

Build.ps1

@@ -0,0 +1,70 @@
+$ErrorActionPreference = 'Stop'
+
+function Clean-Output
+{
+	if(Test-Path ./artifacts) { rm ./artifacts -Force -Recurse }
+}
+
+function Restore-Packages
+{
+	& dotnet restore
+}
+
+function Execute-Tests
+{
+ & dotnet test ./test/SeqCli.Tests/SeqCli.Tests.csproj -c Release /p:Configuration=Release /p:Platform=x64 /p:VersionPrefix=$version
+ if($LASTEXITCODE -ne 0) { exit 3 }
+}
+
+function Create-ArtifactDir
+{
+	mkdir ./artifacts
+}
+
+function Publish-Gzips($version)
+{
+	$rids = @("linux-x64", "osx-x64")
+	foreach ($rid in $rids) {
+ & dotnet publish src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r $rid /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+ if($LASTEXITCODE -ne 0) { exit 4 }
+
+ # Make sure the archive contains a reasonable root filename
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+
+ & ./build/7-zip/7za.exe a -ttar seqcli-$version-$rid.tar ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+ if($LASTEXITCODE -ne 0) { exit 5 }
+
+ # Back to the original directory name
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/
+
+ & ./build/7-zip/7za.exe a -tgzip ./artifacts/seqcli-$version-$rid.tar.gz seqcli-$version-$rid.tar
+ if($LASTEXITCODE -ne 0) { exit 6 }
+
+ rm seqcli-$version-$rid.tar
+	}
+}
+
+function Publish-Msi($version)
+{
+	& dotnet publish ./src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r win-x64 /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+	if($LASTEXITCODE -ne 0) { exit 7 }
+
+	& msbuild ./setup/SeqCli.Setup/SeqCli.Setup.wixproj /t:Build /p:Configuration=Release /p:Platform=x64 /p:Version=$version /p:BuildProjectReferences=false
+	if($LASTEXITCODE -ne 0) { exit 8 }
+
+	mv ./setup/SeqCli.Setup/bin/Release/seqcli.msi ./artifacts/seqcli-$version.msi
+}
+
+Push-Location $PSScriptRoot
+
+$version = @{ $true = $env:APPVEYOR_BUILD_VERSION; $false = "99.99.99" }[$env:APPVEYOR_BUILD_VERSION -ne $NULL];
+Write-Output "Building version $version"
+
+Clean-Output
+Create-ArtifactDir
+Restore-Packages
+Publish-Msi($version)
+Publish-Gzips($version)
+Execute-Tests
+
+Pop-Location

LICENSE

@@ -178,15 +178,15 @@
  APPENDIX: How to apply the Apache License to your work.
 
  To apply the Apache License to your work, attach the following
- boilerplate notice, with the fields enclosed by brackets "[]"
+ boilerplate notice, with the fields enclosed by brackets "{}"
  replaced with your own identifying information. (Don't include
  the brackets!) The text should be enclosed in the appropriate
  comment syntax for the file format. We also recommend that a
  file or class name and description of purpose be included on the
  same "printed page" as the copyright notice for easier
  identification within third-party archives.
 
- Copyright [yyyy] [name of copyright owner]
+ Copyright {yyyy} {name of copyright owner}
 
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.

README.md

@@ -1,2 +1,141 @@
-# seqcli
-Seq client command-line
+# `seqcli` [![Build status](https://ci.appveyor.com/api/projects/status/sc3iacxwxqqfjgdh?svg=true)](https://ci.appveyor.com/project/datalust/seqcli) [![GitHub release](https://img.shields.io/github/release/datalust/seqcli.svg)](https://github.com/datalust/seqcli/releases)
+
+The [Seq](https://getseq.net) client command-line app. Supports logging (`seqcli log`), searching (`search`), tailing (`tail`), querying (`query`) and [JSON log file](https://github.com/serilog/serilog-formatting-compact) ingestion (`ingest`).
+
+![SeqCli Screenshot](https://raw.githubusercontent.com/datalust/seqcli/dev/asset/SeqCli.png)
+
+## Getting started
+
+Install or unzip the [release for your operating system](https://github.com/datalust/seqcli/releases).
+
+To set a default server URL, run:
+
+```
+seqcli config -k connection.serverUrl -v https://your-seq-server
+```
+
+This will create `SeqConfig.json` in your home directory. A default API key can also be set by providing the `connection.apiKey` setting name.
+
+## Commands
+
+Usage:
+
+```
+seqcli <command> [<args>]
+```
+
+### `config`
+
+View and set fields in the `SeqCli.json` file; run with no arguments to list all fields.
+
+| Option | Description |
+| ------ | ----------- |
+| `-k`, `--key=VALUE` | The field, for example `connection.serverUrl` |
+| `-v`, `--value=VALUE` | The field value; if not specified, the command will print the current value |
+| `-c`, `--clear` | Clear the field |
+
+### `help`
+
+Show information about available commands.
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--markdown` | Generate markdown for use in documentation |
+
+### `ingest`
+
+Send JSON log events from a file or `STDIN`.
+
+Example:
+
+```
+seqcli ingest -i events.clef --filter="@Level <> 'Debug'" -p Environment=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-i`, `--input=VALUE` | CLEF file to ingest; if not specified, `STDIN` will be used |
+| `--invalid-data=VALUE` | Specify how invalid data is handled: fail (default) or ignore |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-f`, `--filter=VALUE` | Filter expression to select a subset of events |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `log`
+
+Send a structured log event to the server.
+
+Example:
+
+```
+seqcli log -m 'Hello, {Name}!' -p Name=World -p App=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--message=VALUE` | A message to associate with the event (the default is to send no message); https://messagetemplates.org syntax is supported |
+| `-l`, `--level=VALUE` | The level or severity of the event (the default is `Information`) |
+| `-t`, `--timestamp=VALUE` | The event timestamp as ISO-8601 (the current UTC timestamp will be used by default) |
+| `-x`, `--exception=VALUE` | Additional exception or error information to send, if any |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `query`
+
+Execute an SQL query and receive results in CSV format.
+
+Example:
+
+```
+seqcli query -q "select count(*) from stream group by @Level" --start="2018-02-28T13:00Z"
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-q`, `--query=VALUE` | The query to execute |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `--timeout=VALUE` | The query execution timeout in milliseconds |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `search`
+
+Retrieve log events that match a given filter.
+
+Example:
+
+```
+seqcli search -f "@Exception like '%TimeoutException%'" -c 30
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | A filter to apply to the search, for example `Host = 'xmpweb-01.example.com'` |
+| `-c`, `--count=VALUE` | The maximum number of events to retrieve; the default is 1 |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `tail`
+
+Stream log events matching a filter.
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | An optional server-side filter to apply to the stream, for example `@Level = 'Error'` |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `version`
+
+Print the current executable version.

appveyor.yml

@@ -0,0 +1,17 @@
+version: 0.1.{build}
+skip_tags: true
+image: Visual Studio 2017
+build_script:
+- ps: ./Build.ps1
+test: off
+artifacts:
+- path: artifacts/seqcli-*.msi
+- path: artifacts/seqcli-*.tar.gz
+deploy:
+- provider: GitHub
+ auth_token:
+ secure: Bo3ypKpKFxinjR9ShkNekNvkob2iklHJU+UlYyfHtcFFIAa58SV2TkEd0xWxz633
+ artifact: /seqcli-.*\.(msi|tar\.gz)/
+ tag: v$(appveyor_build_version)
+ on:
+ branch: master

Build.ps1

@@ -0,0 +1,70 @@
+$ErrorActionPreference = 'Stop'
+
+function Clean-Output
+{
+	if(Test-Path ./artifacts) { rm ./artifacts -Force -Recurse }
+}
+
+function Restore-Packages
+{
+	& dotnet restore
+}
+
+function Execute-Tests
+{
+ & dotnet test ./test/SeqCli.Tests/SeqCli.Tests.csproj -c Release /p:Configuration=Release /p:Platform=x64 /p:VersionPrefix=$version
+ if($LASTEXITCODE -ne 0) { exit 3 }
+}
+
+function Create-ArtifactDir
+{
+	mkdir ./artifacts
+}
+
+function Publish-Gzips($version)
+{
+	$rids = @("linux-x64", "osx-x64")
+	foreach ($rid in $rids) {
+ & dotnet publish src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r $rid /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+ if($LASTEXITCODE -ne 0) { exit 4 }
+
+ # Make sure the archive contains a reasonable root filename
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+
+ & ./build/7-zip/7za.exe a -ttar seqcli-$version-$rid.tar ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+ if($LASTEXITCODE -ne 0) { exit 5 }
+
+ # Back to the original directory name
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/
+
+ & ./build/7-zip/7za.exe a -tgzip ./artifacts/seqcli-$version-$rid.tar.gz seqcli-$version-$rid.tar
+ if($LASTEXITCODE -ne 0) { exit 6 }
+
+ rm seqcli-$version-$rid.tar
+	}
+}
+
+function Publish-Msi($version)
+{
+	& dotnet publish ./src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r win-x64 /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+	if($LASTEXITCODE -ne 0) { exit 7 }
+
+	& msbuild ./setup/SeqCli.Setup/SeqCli.Setup.wixproj /t:Build /p:Configuration=Release /p:Platform=x64 /p:Version=$version /p:BuildProjectReferences=false
+	if($LASTEXITCODE -ne 0) { exit 8 }
+
+	mv ./setup/SeqCli.Setup/bin/Release/seqcli.msi ./artifacts/seqcli-$version.msi
+}
+
+Push-Location $PSScriptRoot
+
+$version = @{ $true = $env:APPVEYOR_BUILD_VERSION; $false = "99.99.99" }[$env:APPVEYOR_BUILD_VERSION -ne $NULL];
+Write-Output "Building version $version"
+
+Clean-Output
+Create-ArtifactDir
+Restore-Packages
+Publish-Msi($version)
+Publish-Gzips($version)
+Execute-Tests
+
+Pop-Location

LICENSE

@@ -178,15 +178,15 @@
  APPENDIX: How to apply the Apache License to your work.
 
  To apply the Apache License to your work, attach the following
- boilerplate notice, with the fields enclosed by brackets "[]"
+ boilerplate notice, with the fields enclosed by brackets "{}"
  replaced with your own identifying information. (Don't include
  the brackets!) The text should be enclosed in the appropriate
  comment syntax for the file format. We also recommend that a
  file or class name and description of purpose be included on the
  same "printed page" as the copyright notice for easier
  identification within third-party archives.
 
- Copyright [yyyy] [name of copyright owner]
+ Copyright {yyyy} {name of copyright owner}
 
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.

README.md

@@ -1,2 +1,141 @@
-# seqcli
-Seq client command-line
+# `seqcli` [![Build status](https://ci.appveyor.com/api/projects/status/sc3iacxwxqqfjgdh?svg=true)](https://ci.appveyor.com/project/datalust/seqcli) [![GitHub release](https://img.shields.io/github/release/datalust/seqcli.svg)](https://github.com/datalust/seqcli/releases)
+
+The [Seq](https://getseq.net) client command-line app. Supports logging (`seqcli log`), searching (`search`), tailing (`tail`), querying (`query`) and [JSON log file](https://github.com/serilog/serilog-formatting-compact) ingestion (`ingest`).
+
+![SeqCli Screenshot](https://raw.githubusercontent.com/datalust/seqcli/dev/asset/SeqCli.png)
+
+## Getting started
+
+Install or unzip the [release for your operating system](https://github.com/datalust/seqcli/releases).
+
+To set a default server URL, run:
+
+```
+seqcli config -k connection.serverUrl -v https://your-seq-server
+```
+
+This will create `SeqConfig.json` in your home directory. A default API key can also be set by providing the `connection.apiKey` setting name.
+
+## Commands
+
+Usage:
+
+```
+seqcli <command> [<args>]
+```
+
+### `config`
+
+View and set fields in the `SeqCli.json` file; run with no arguments to list all fields.
+
+| Option | Description |
+| ------ | ----------- |
+| `-k`, `--key=VALUE` | The field, for example `connection.serverUrl` |
+| `-v`, `--value=VALUE` | The field value; if not specified, the command will print the current value |
+| `-c`, `--clear` | Clear the field |
+
+### `help`
+
+Show information about available commands.
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--markdown` | Generate markdown for use in documentation |
+
+### `ingest`
+
+Send JSON log events from a file or `STDIN`.
+
+Example:
+
+```
+seqcli ingest -i events.clef --filter="@Level <> 'Debug'" -p Environment=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-i`, `--input=VALUE` | CLEF file to ingest; if not specified, `STDIN` will be used |
+| `--invalid-data=VALUE` | Specify how invalid data is handled: fail (default) or ignore |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-f`, `--filter=VALUE` | Filter expression to select a subset of events |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `log`
+
+Send a structured log event to the server.
+
+Example:
+
+```
+seqcli log -m 'Hello, {Name}!' -p Name=World -p App=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--message=VALUE` | A message to associate with the event (the default is to send no message); https://messagetemplates.org syntax is supported |
+| `-l`, `--level=VALUE` | The level or severity of the event (the default is `Information`) |
+| `-t`, `--timestamp=VALUE` | The event timestamp as ISO-8601 (the current UTC timestamp will be used by default) |
+| `-x`, `--exception=VALUE` | Additional exception or error information to send, if any |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `query`
+
+Execute an SQL query and receive results in CSV format.
+
+Example:
+
+```
+seqcli query -q "select count(*) from stream group by @Level" --start="2018-02-28T13:00Z"
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-q`, `--query=VALUE` | The query to execute |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `--timeout=VALUE` | The query execution timeout in milliseconds |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `search`
+
+Retrieve log events that match a given filter.
+
+Example:
+
+```
+seqcli search -f "@Exception like '%TimeoutException%'" -c 30
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | A filter to apply to the search, for example `Host = 'xmpweb-01.example.com'` |
+| `-c`, `--count=VALUE` | The maximum number of events to retrieve; the default is 1 |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `tail`
+
+Stream log events matching a filter.
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | An optional server-side filter to apply to the stream, for example `@Level = 'Error'` |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `version`
+
+Print the current executable version.

appveyor.yml

@@ -0,0 +1,17 @@
+version: 0.1.{build}
+skip_tags: true
+image: Visual Studio 2017
+build_script:
+- ps: ./Build.ps1
+test: off
+artifacts:
+- path: artifacts/seqcli-*.msi
+- path: artifacts/seqcli-*.tar.gz
+deploy:
+- provider: GitHub
+ auth_token:
+ secure: Bo3ypKpKFxinjR9ShkNekNvkob2iklHJU+UlYyfHtcFFIAa58SV2TkEd0xWxz633
+ artifact: /seqcli-.*\.(msi|tar\.gz)/
+ tag: v$(appveyor_build_version)
+ on:
+ branch: master

Build.ps1

@@ -0,0 +1,70 @@
+$ErrorActionPreference = 'Stop'
+
+function Clean-Output
+{
+	if(Test-Path ./artifacts) { rm ./artifacts -Force -Recurse }
+}
+
+function Restore-Packages
+{
+	& dotnet restore
+}
+
+function Execute-Tests
+{
+ & dotnet test ./test/SeqCli.Tests/SeqCli.Tests.csproj -c Release /p:Configuration=Release /p:Platform=x64 /p:VersionPrefix=$version
+ if($LASTEXITCODE -ne 0) { exit 3 }
+}
+
+function Create-ArtifactDir
+{
+	mkdir ./artifacts
+}
+
+function Publish-Gzips($version)
+{
+	$rids = @("linux-x64", "osx-x64")
+	foreach ($rid in $rids) {
+ & dotnet publish src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r $rid /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+ if($LASTEXITCODE -ne 0) { exit 4 }
+
+ # Make sure the archive contains a reasonable root filename
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+
+ & ./build/7-zip/7za.exe a -ttar seqcli-$version-$rid.tar ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+ if($LASTEXITCODE -ne 0) { exit 5 }
+
+ # Back to the original directory name
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/
+
+ & ./build/7-zip/7za.exe a -tgzip ./artifacts/seqcli-$version-$rid.tar.gz seqcli-$version-$rid.tar
+ if($LASTEXITCODE -ne 0) { exit 6 }
+
+ rm seqcli-$version-$rid.tar
+	}
+}
+
+function Publish-Msi($version)
+{
+	& dotnet publish ./src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r win-x64 /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+	if($LASTEXITCODE -ne 0) { exit 7 }
+
+	& msbuild ./setup/SeqCli.Setup/SeqCli.Setup.wixproj /t:Build /p:Configuration=Release /p:Platform=x64 /p:Version=$version /p:BuildProjectReferences=false
+	if($LASTEXITCODE -ne 0) { exit 8 }
+
+	mv ./setup/SeqCli.Setup/bin/Release/seqcli.msi ./artifacts/seqcli-$version.msi
+}
+
+Push-Location $PSScriptRoot
+
+$version = @{ $true = $env:APPVEYOR_BUILD_VERSION; $false = "99.99.99" }[$env:APPVEYOR_BUILD_VERSION -ne $NULL];
+Write-Output "Building version $version"
+
+Clean-Output
+Create-ArtifactDir
+Restore-Packages
+Publish-Msi($version)
+Publish-Gzips($version)
+Execute-Tests
+
+Pop-Location

LICENSE

@@ -178,15 +178,15 @@
  APPENDIX: How to apply the Apache License to your work.
 
  To apply the Apache License to your work, attach the following
- boilerplate notice, with the fields enclosed by brackets "[]"
+ boilerplate notice, with the fields enclosed by brackets "{}"
  replaced with your own identifying information. (Don't include
  the brackets!) The text should be enclosed in the appropriate
  comment syntax for the file format. We also recommend that a
  file or class name and description of purpose be included on the
  same "printed page" as the copyright notice for easier
  identification within third-party archives.
 
- Copyright [yyyy] [name of copyright owner]
+ Copyright {yyyy} {name of copyright owner}
 
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.

README.md

@@ -1,2 +1,141 @@
-# seqcli
-Seq client command-line
+# `seqcli` [![Build status](https://ci.appveyor.com/api/projects/status/sc3iacxwxqqfjgdh?svg=true)](https://ci.appveyor.com/project/datalust/seqcli) [![GitHub release](https://img.shields.io/github/release/datalust/seqcli.svg)](https://github.com/datalust/seqcli/releases)
+
+The [Seq](https://getseq.net) client command-line app. Supports logging (`seqcli log`), searching (`search`), tailing (`tail`), querying (`query`) and [JSON log file](https://github.com/serilog/serilog-formatting-compact) ingestion (`ingest`).
+
+![SeqCli Screenshot](https://raw.githubusercontent.com/datalust/seqcli/dev/asset/SeqCli.png)
+
+## Getting started
+
+Install or unzip the [release for your operating system](https://github.com/datalust/seqcli/releases).
+
+To set a default server URL, run:
+
+```
+seqcli config -k connection.serverUrl -v https://your-seq-server
+```
+
+This will create `SeqConfig.json` in your home directory. A default API key can also be set by providing the `connection.apiKey` setting name.
+
+## Commands
+
+Usage:
+
+```
+seqcli <command> [<args>]
+```
+
+### `config`
+
+View and set fields in the `SeqCli.json` file; run with no arguments to list all fields.
+
+| Option | Description |
+| ------ | ----------- |
+| `-k`, `--key=VALUE` | The field, for example `connection.serverUrl` |
+| `-v`, `--value=VALUE` | The field value; if not specified, the command will print the current value |
+| `-c`, `--clear` | Clear the field |
+
+### `help`
+
+Show information about available commands.
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--markdown` | Generate markdown for use in documentation |
+
+### `ingest`
+
+Send JSON log events from a file or `STDIN`.
+
+Example:
+
+```
+seqcli ingest -i events.clef --filter="@Level <> 'Debug'" -p Environment=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-i`, `--input=VALUE` | CLEF file to ingest; if not specified, `STDIN` will be used |
+| `--invalid-data=VALUE` | Specify how invalid data is handled: fail (default) or ignore |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-f`, `--filter=VALUE` | Filter expression to select a subset of events |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `log`
+
+Send a structured log event to the server.
+
+Example:
+
+```
+seqcli log -m 'Hello, {Name}!' -p Name=World -p App=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--message=VALUE` | A message to associate with the event (the default is to send no message); https://messagetemplates.org syntax is supported |
+| `-l`, `--level=VALUE` | The level or severity of the event (the default is `Information`) |
+| `-t`, `--timestamp=VALUE` | The event timestamp as ISO-8601 (the current UTC timestamp will be used by default) |
+| `-x`, `--exception=VALUE` | Additional exception or error information to send, if any |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `query`
+
+Execute an SQL query and receive results in CSV format.
+
+Example:
+
+```
+seqcli query -q "select count(*) from stream group by @Level" --start="2018-02-28T13:00Z"
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-q`, `--query=VALUE` | The query to execute |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `--timeout=VALUE` | The query execution timeout in milliseconds |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `search`
+
+Retrieve log events that match a given filter.
+
+Example:
+
+```
+seqcli search -f "@Exception like '%TimeoutException%'" -c 30
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | A filter to apply to the search, for example `Host = 'xmpweb-01.example.com'` |
+| `-c`, `--count=VALUE` | The maximum number of events to retrieve; the default is 1 |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `tail`
+
+Stream log events matching a filter.
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | An optional server-side filter to apply to the stream, for example `@Level = 'Error'` |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `version`
+
+Print the current executable version.

appveyor.yml

@@ -0,0 +1,17 @@
+version: 0.1.{build}
+skip_tags: true
+image: Visual Studio 2017
+build_script:
+- ps: ./Build.ps1
+test: off
+artifacts:
+- path: artifacts/seqcli-*.msi
+- path: artifacts/seqcli-*.tar.gz
+deploy:
+- provider: GitHub
+ auth_token:
+ secure: Bo3ypKpKFxinjR9ShkNekNvkob2iklHJU+UlYyfHtcFFIAa58SV2TkEd0xWxz633
+ artifact: /seqcli-.*\.(msi|tar\.gz)/
+ tag: v$(appveyor_build_version)
+ on:
+ branch: master

Build.ps1

@@ -0,0 +1,70 @@
+$ErrorActionPreference = 'Stop'
+
+function Clean-Output
+{
+	if(Test-Path ./artifacts) { rm ./artifacts -Force -Recurse }
+}
+
+function Restore-Packages
+{
+	& dotnet restore
+}
+
+function Execute-Tests
+{
+ & dotnet test ./test/SeqCli.Tests/SeqCli.Tests.csproj -c Release /p:Configuration=Release /p:Platform=x64 /p:VersionPrefix=$version
+ if($LASTEXITCODE -ne 0) { exit 3 }
+}
+
+function Create-ArtifactDir
+{
+	mkdir ./artifacts
+}
+
+function Publish-Gzips($version)
+{
+	$rids = @("linux-x64", "osx-x64")
+	foreach ($rid in $rids) {
+ & dotnet publish src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r $rid /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+ if($LASTEXITCODE -ne 0) { exit 4 }
+
+ # Make sure the archive contains a reasonable root filename
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+
+ & ./build/7-zip/7za.exe a -ttar seqcli-$version-$rid.tar ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/
+ if($LASTEXITCODE -ne 0) { exit 5 }
+
+ # Back to the original directory name
+ mv ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/seqcli-$version-$rid/ ./src/SeqCli/bin/Release/netcoreapp2.0/$rid/publish/
+
+ & ./build/7-zip/7za.exe a -tgzip ./artifacts/seqcli-$version-$rid.tar.gz seqcli-$version-$rid.tar
+ if($LASTEXITCODE -ne 0) { exit 6 }
+
+ rm seqcli-$version-$rid.tar
+	}
+}
+
+function Publish-Msi($version)
+{
+	& dotnet publish ./src/SeqCli/SeqCli.csproj -c Release -f netcoreapp2.0 -r win-x64 /p:VersionPrefix=$version /p:ShowLinkerSizeComparison=true
+	if($LASTEXITCODE -ne 0) { exit 7 }
+
+	& msbuild ./setup/SeqCli.Setup/SeqCli.Setup.wixproj /t:Build /p:Configuration=Release /p:Platform=x64 /p:Version=$version /p:BuildProjectReferences=false
+	if($LASTEXITCODE -ne 0) { exit 8 }
+
+	mv ./setup/SeqCli.Setup/bin/Release/seqcli.msi ./artifacts/seqcli-$version.msi
+}
+
+Push-Location $PSScriptRoot
+
+$version = @{ $true = $env:APPVEYOR_BUILD_VERSION; $false = "99.99.99" }[$env:APPVEYOR_BUILD_VERSION -ne $NULL];
+Write-Output "Building version $version"
+
+Clean-Output
+Create-ArtifactDir
+Restore-Packages
+Publish-Msi($version)
+Publish-Gzips($version)
+Execute-Tests
+
+Pop-Location

LICENSE

@@ -178,15 +178,15 @@
  APPENDIX: How to apply the Apache License to your work.
 
  To apply the Apache License to your work, attach the following
- boilerplate notice, with the fields enclosed by brackets "[]"
+ boilerplate notice, with the fields enclosed by brackets "{}"
  replaced with your own identifying information. (Don't include
  the brackets!) The text should be enclosed in the appropriate
  comment syntax for the file format. We also recommend that a
  file or class name and description of purpose be included on the
  same "printed page" as the copyright notice for easier
  identification within third-party archives.
 
- Copyright [yyyy] [name of copyright owner]
+ Copyright {yyyy} {name of copyright owner}
 
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.

README.md

@@ -1,2 +1,141 @@
-# seqcli
-Seq client command-line
+# `seqcli` [![Build status](https://ci.appveyor.com/api/projects/status/sc3iacxwxqqfjgdh?svg=true)](https://ci.appveyor.com/project/datalust/seqcli) [![GitHub release](https://img.shields.io/github/release/datalust/seqcli.svg)](https://github.com/datalust/seqcli/releases)
+
+The [Seq](https://getseq.net) client command-line app. Supports logging (`seqcli log`), searching (`search`), tailing (`tail`), querying (`query`) and [JSON log file](https://github.com/serilog/serilog-formatting-compact) ingestion (`ingest`).
+
+![SeqCli Screenshot](https://raw.githubusercontent.com/datalust/seqcli/dev/asset/SeqCli.png)
+
+## Getting started
+
+Install or unzip the [release for your operating system](https://github.com/datalust/seqcli/releases).
+
+To set a default server URL, run:
+
+```
+seqcli config -k connection.serverUrl -v https://your-seq-server
+```
+
+This will create `SeqConfig.json` in your home directory. A default API key can also be set by providing the `connection.apiKey` setting name.
+
+## Commands
+
+Usage:
+
+```
+seqcli <command> [<args>]
+```
+
+### `config`
+
+View and set fields in the `SeqCli.json` file; run with no arguments to list all fields.
+
+| Option | Description |
+| ------ | ----------- |
+| `-k`, `--key=VALUE` | The field, for example `connection.serverUrl` |
+| `-v`, `--value=VALUE` | The field value; if not specified, the command will print the current value |
+| `-c`, `--clear` | Clear the field |
+
+### `help`
+
+Show information about available commands.
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--markdown` | Generate markdown for use in documentation |
+
+### `ingest`
+
+Send JSON log events from a file or `STDIN`.
+
+Example:
+
+```
+seqcli ingest -i events.clef --filter="@Level <> 'Debug'" -p Environment=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-i`, `--input=VALUE` | CLEF file to ingest; if not specified, `STDIN` will be used |
+| `--invalid-data=VALUE` | Specify how invalid data is handled: fail (default) or ignore |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-f`, `--filter=VALUE` | Filter expression to select a subset of events |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `log`
+
+Send a structured log event to the server.
+
+Example:
+
+```
+seqcli log -m 'Hello, {Name}!' -p Name=World -p App=Test
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-m`, `--message=VALUE` | A message to associate with the event (the default is to send no message); https://messagetemplates.org syntax is supported |
+| `-l`, `--level=VALUE` | The level or severity of the event (the default is `Information`) |
+| `-t`, `--timestamp=VALUE` | The event timestamp as ISO-8601 (the current UTC timestamp will be used by default) |
+| `-x`, `--exception=VALUE` | Additional exception or error information to send, if any |
+| `-p`, `--property=VALUE1=VALUE2` | Specify event properties, e.g. `-p Customer=C123 -p Environment=Production` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `query`
+
+Execute an SQL query and receive results in CSV format.
+
+Example:
+
+```
+seqcli query -q "select count(*) from stream group by @Level" --start="2018-02-28T13:00Z"
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-q`, `--query=VALUE` | The query to execute |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `--timeout=VALUE` | The query execution timeout in milliseconds |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `search`
+
+Retrieve log events that match a given filter.
+
+Example:
+
+```
+seqcli search -f "@Exception like '%TimeoutException%'" -c 30
+```
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | A filter to apply to the search, for example `Host = 'xmpweb-01.example.com'` |
+| `-c`, `--count=VALUE` | The maximum number of events to retrieve; the default is 1 |
+| `--start=VALUE` | ISO 8601 date/time to query from |
+| `--end=VALUE` | Date/time to query to |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `tail`
+
+Stream log events matching a filter.
+
+| Option | Description |
+| ------ | ----------- |
+| `-f`, `--filter=VALUE` | An optional server-side filter to apply to the stream, for example `@Level = 'Error'` |
+| `--json` | Print events in newline-delimited JSON (the default is plain text) |
+| `--no-color` | Don't colorize text output |
+| `--signal=VALUE` | A signal expression or list of intersected signal ids to apply, for example `signal-1,signal-2` |
+| `-s`, `--server=VALUE` | The URL of the Seq server; by default the `connection.serverUrl` value will be used |
+| `-a`, `--apikey=VALUE` | The API key to use when connecting to the server; by default `config.apiKey` value will be used |
+
+### `version`
+
+Print the current executable version.

appveyor.yml

@@ -0,0 +1,17 @@
+version: 0.1.{build}
+skip_tags: true
+image: Visual Studio 2017
+build_script:
+- ps: ./Build.ps1
+test: off
+artifacts:
+- path: artifacts/seqcli-*.msi
+- path: artifacts/seqcli-*.tar.gz
+deploy:
+- provider: GitHub
+ auth_token:
+ secure: Bo3ypKpKFxinjR9ShkNekNvkob2iklHJU+UlYyfHtcFFIAa58SV2TkEd0xWxz633
+ artifact: /seqcli-.*\.(msi|tar\.gz)/
+ tag: v$(appveyor_build_version)
+ on:
+ branch: master