[
{
"path": ".editorconfig",
"content": "# To learn more about .editorconfig see https://aka.ms/editorconfigdocs\n###############################\n# Core EditorConfig Options #\n###############################\nroot = true\n\n# All files\n[*]\nindent_style = space\n\n# Code files\n[*.{cs,csx,vb,vbx}]\nindent_size = 4\ninsert_final_newline = true\ncharset = utf-8\n\n[*.md]\ncharset = utf-8\n\n###############################\n# .NET Coding Conventions #\n###############################\n[*.{cs,vb}]\n# Organize usings\ndotnet_sort_system_directives_first = true\n# this. preferences\ndotnet_style_qualification_for_field = false:silent\ndotnet_style_qualification_for_property = false:silent\ndotnet_style_qualification_for_method = false:silent\ndotnet_style_qualification_for_event = false:silent\n# Language keywords vs BCL types preferences\ndotnet_style_predefined_type_for_locals_parameters_members = true:silent\ndotnet_style_predefined_type_for_member_access = true:silent\n# Parentheses preferences\ndotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity:silent\ndotnet_style_parentheses_in_relational_binary_operators = always_for_clarity:silent\ndotnet_style_parentheses_in_other_binary_operators = always_for_clarity:silent\ndotnet_style_parentheses_in_other_operators = never_if_unnecessary:silent\n# Modifier preferences\ndotnet_style_require_accessibility_modifiers = for_non_interface_members:silent\ndotnet_style_readonly_field = true:suggestion\n# Expression-level preferences\ndotnet_style_object_initializer = true:suggestion\ndotnet_style_collection_initializer = true:suggestion\ndotnet_style_explicit_tuple_names = true:suggestion\ndotnet_style_null_propagation = true:suggestion\ndotnet_style_coalesce_expression = true:suggestion\ndotnet_style_prefer_is_null_check_over_reference_equality_method = true:silent\ndotnet_style_prefer_inferred_tuple_names = true:suggestion\ndotnet_style_prefer_inferred_anonymous_type_member_names = true:suggestion\ndotnet_style_prefer_auto_properties = true:silent\ndotnet_style_prefer_conditional_expression_over_assignment = true:silent\ndotnet_style_prefer_conditional_expression_over_return = true:silent\n###############################\n# Naming Conventions #\n###############################\n# Style Definitions\ndotnet_naming_style.pascal_case_style.capitalization = pascal_case\n# Use PascalCase for constant fields \ndotnet_naming_rule.constant_fields_should_be_pascal_case.severity = suggestion\ndotnet_naming_rule.constant_fields_should_be_pascal_case.symbols = constant_fields\ndotnet_naming_rule.constant_fields_should_be_pascal_case.style = pascal_case_style\ndotnet_naming_symbols.constant_fields.applicable_kinds = field\ndotnet_naming_symbols.constant_fields.applicable_accessibilities = *\ndotnet_naming_symbols.constant_fields.required_modifiers = const\n###############################\n# C# Coding Conventions #\n###############################\n[*.cs]\n# var preferences\ncsharp_style_var_for_built_in_types = true:silent\ncsharp_style_var_when_type_is_apparent = true:silent\ncsharp_style_var_elsewhere = true:silent\n# Expression-bodied members\ncsharp_style_expression_bodied_methods = false:silent\ncsharp_style_expression_bodied_constructors = false:silent\ncsharp_style_expression_bodied_operators = false:silent\ncsharp_style_expression_bodied_properties = true:silent\ncsharp_style_expression_bodied_indexers = true:silent\ncsharp_style_expression_bodied_accessors = true:silent\n# Pattern matching preferences\ncsharp_style_pattern_matching_over_is_with_cast_check = true:suggestion\ncsharp_style_pattern_matching_over_as_with_null_check = true:suggestion\n# Null-checking preferences\ncsharp_style_throw_expression = true:suggestion\ncsharp_style_conditional_delegate_call = true:suggestion\n# Modifier preferences\ncsharp_preferred_modifier_order = public,private,protected,internal,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,volatile,async:suggestion\n# Expression-level preferences\ncsharp_prefer_braces = true:silent\ncsharp_style_deconstructed_variable_declaration = true:suggestion\ncsharp_prefer_simple_default_expression = true:suggestion\ncsharp_style_pattern_local_over_anonymous_function = true:suggestion\ncsharp_style_inlined_variable_declaration = true:suggestion\n###############################\n# C# Formatting Rules #\n###############################\n# New line preferences\ncsharp_new_line_before_open_brace = all\ncsharp_new_line_before_else = true\ncsharp_new_line_before_catch = true\ncsharp_new_line_before_finally = true\ncsharp_new_line_before_members_in_object_initializers = true\ncsharp_new_line_before_members_in_anonymous_types = true\ncsharp_new_line_between_query_expression_clauses = true\n# Indentation preferences\ncsharp_indent_case_contents = true\ncsharp_indent_switch_labels = true\ncsharp_indent_labels = flush_left\n# Space preferences\ncsharp_space_after_cast = false\ncsharp_space_after_keywords_in_control_flow_statements = true\ncsharp_space_between_method_call_parameter_list_parentheses = false\ncsharp_space_between_method_declaration_parameter_list_parentheses = false\ncsharp_space_between_parentheses = false\ncsharp_space_before_colon_in_inheritance_clause = true\ncsharp_space_after_colon_in_inheritance_clause = true\ncsharp_space_around_binary_operators = before_and_after\ncsharp_space_between_method_declaration_empty_parameter_list_parentheses = false\ncsharp_space_between_method_call_name_and_opening_parenthesis = false\ncsharp_space_between_method_call_empty_parameter_list_parentheses = false\n# Wrapping preferences\ncsharp_preserve_single_line_statements = true\ncsharp_preserve_single_line_blocks = true"
},
{
"path": ".gitattributes",
"content": "###############################################################################\n# Set default behavior to automatically normalize line endings.\n###############################################################################\n* text=auto\n\n*.sh text eol=lf\n\n###############################################################################\n# Set default behavior for command prompt diff.\n#\n# This is need for earlier builds of msysgit that does not have it on by\n# default for csharp files.\n# Note: This is only used by command line\n###############################################################################\n#*.cs diff=csharp\n\n###############################################################################\n# Set the merge driver for project and solution files\n#\n# Merging from the command prompt will add diff markers to the files if there\n# are conflicts (Merging from VS is not affected by the settings below, in VS\n# the diff markers are never inserted). Diff markers may cause the following \n# file extensions to fail to load in VS. An alternative would be to treat\n# these files as binary and thus will always conflict and require user\n# intervention with every merge. To do so, just uncomment the entries below\n###############################################################################\n#*.sln merge=binary\n#*.csproj merge=binary\n#*.vbproj merge=binary\n#*.vcxproj merge=binary\n#*.vcproj merge=binary\n#*.dbproj merge=binary\n#*.fsproj merge=binary\n#*.lsproj merge=binary\n#*.wixproj merge=binary\n#*.modelproj merge=binary\n#*.sqlproj merge=binary\n#*.wwaproj merge=binary\n\n###############################################################################\n# behavior for image files\n#\n# image files are treated as binary by default.\n###############################################################################\n#*.jpg binary\n#*.png binary\n#*.gif binary\n\n###############################################################################\n# diff behavior for common document formats\n# \n# Convert binary document formats to text before diffing them. This feature\n# is only available from the command line. Turn it on by uncommenting the \n# entries below.\n###############################################################################\n#*.doc diff=astextplain\n#*.DOC diff=astextplain\n#*.docx diff=astextplain\n#*.DOCX diff=astextplain\n#*.dot diff=astextplain\n#*.DOT diff=astextplain\n#*.pdf diff=astextplain\n#*.PDF diff=astextplain\n#*.rtf diff=astextplain\n#*.RTF diff=astextplain\n"
},
{
"path": ".github/workflows/build.yaml",
"content": "name: Build-Development\n\non:\n push:\n branches:\n - main\n - master\n pull_request:\n types:\n - opened\n - synchronize\n\njobs:\n Build:\n runs-on: ${{ matrix.os }}\n strategy:\n matrix:\n os: [windows-latest, ubuntu-latest, macos-latest]\n env:\n DOTNET_NOLOGO: true\n steps:\n - uses: actions/checkout@v1\n - uses: actions/setup-dotnet@v1\n with:\n dotnet-version: '5.0.x'\n\n # Build\n - run: dotnet restore\n - run: dotnet build -c Release\n\n # Run Unit tests\n - run: dotnet test -c Release --no-build --logger trx --results-directory $GITHUB_WORKSPACE/artifacts\n\n # Packaging\n - name: dotnet pack\n run: dotnet pack -c Release --no-build -p:IncludeSymbols=true -p:SymbolPackageFormat=snupkg --output $GITHUB_WORKSPACE/artifacts\n shell: bash\n\n # Upload & Publish\n - uses: actions/upload-artifact@master\n with:\n name: Packages\n path: artifacts"
},
{
"path": ".github/workflows/release.yaml",
"content": "name: Build-Release\n\non:\n push:\n tags:\n - v*\n\njobs:\n Release:\n if: \"contains(github.ref, 'refs/tags')\"\n runs-on: ubuntu-latest\n env:\n DOTNET_NOLOGO: true\n steps:\n - uses: actions/checkout@v1\n - uses: actions/setup-dotnet@v1\n with:\n dotnet-version: '5.0.x'\n\n - name: \"Set VersionSuffix for Preview\"\n if: \"contains(github.ref, 'refs/tags') && contains(github.ref, 'preview')\"\n run: |\n echo \"VERSION_SUFFIX=preview.`date '+%Y%m%d-%H%M%S'`+${GITHUB_SHA:0:6}\" >> $GITHUB_ENV\n - name: \"Get git tag\"\n if: \"contains(github.ref, 'refs/tags')\"\n run: echo \"GIT_TAG=${GITHUB_REF#refs/tags/}\" >> $GITHUB_ENV\n\n # Build\n - run: dotnet restore\n - run: dotnet build -c Release\n\n # Packaging\n - name: dotnet pack\n run: dotnet pack -c Release --no-build --version-suffix \"$VERSION_SUFFIX\" -p:IncludeSymbols=true -p:SymbolPackageFormat=snupkg --output $GITHUB_WORKSPACE/artifacts\n\n # Upload & Publish\n - uses: actions/upload-artifact@master\n with:\n name: Packages\n path: artifacts\n\n - name: \"Push to NuGet.org\"\n run: |\n dotnet nuget push \"$GITHUB_WORKSPACE/artifacts/*.nupkg\" --skip-duplicate -k ${{ secrets.NUGET_KEY }} -s https://api.nuget.org/v3/index.json"
},
{
"path": ".gitignore",
"content": "## Ignore Visual Studio temporary files, build results, and\n## files generated by popular Visual Studio add-ons.\n##\n## Get latest from https://github.com/github/gitignore/blob/master/VisualStudio.gitignore\n\n.DS_Store\n\n# User-specific files\n*.rsuser\n*.suo\n*.user\n*.userosscache\n*.sln.docstates\n\n# User-specific files (MonoDevelop/Xamarin Studio)\n*.userprefs\n\n# Build results\n[Dd]ebug/\n[Dd]ebugPublic/\n[Rr]elease/\n[Rr]eleases/\nx64/\nx86/\n[Aa][Rr][Mm]/\n[Aa][Rr][Mm]64/\nbld/\n[Bb]in/\n[Oo]bj/\n[Ll]og/\n\n# Visual Studio 2015/2017 cache/options directory\n.vs/\n# Uncomment if you have tasks that create the project's static files in wwwroot\n#wwwroot/\n\n# Visual Studio 2017 auto generated files\nGenerated\\ Files/\n\n# MSTest test Results\n[Tt]est[Rr]esult*/\n[Bb]uild[Ll]og.*\n\n# NUNIT\n*.VisualState.xml\nTestResult.xml\n\n# Build Results of an ATL Project\n[Dd]ebugPS/\n[Rr]eleasePS/\ndlldata.c\n\n# Benchmark Results\nBenchmarkDotNet.Artifacts/\n\n# .NET Core\nproject.lock.json\nproject.fragment.lock.json\nartifacts/\n\n# StyleCop\nStyleCopReport.xml\n\n# Files built by Visual Studio\n*_i.c\n*_p.c\n*_h.h\n*.ilk\n*.meta\n*.obj\n*.iobj\n*.pch\n*.pdb\n*.ipdb\n*.pgc\n*.pgd\n*.rsp\n*.sbr\n*.tlb\n*.tli\n*.tlh\n*.tmp\n*.tmp_proj\n*_wpftmp.csproj\n*.log\n*.vspscc\n*.vssscc\n.builds\n*.pidb\n*.svclog\n*.scc\n\n# Chutzpah Test files\n_Chutzpah*\n\n# Visual C++ cache files\nipch/\n*.aps\n*.ncb\n*.opendb\n*.opensdf\n*.sdf\n*.cachefile\n*.VC.db\n*.VC.VC.opendb\n\n# Visual Studio profiler\n*.psess\n*.vsp\n*.vspx\n*.sap\n\n# Visual Studio Trace Files\n*.e2e\n\n# TFS 2012 Local Workspace\n$tf/\n\n# Guidance Automation Toolkit\n*.gpState\n\n# ReSharper is a .NET coding add-in\n_ReSharper*/\n*.[Rr]e[Ss]harper\n*.DotSettings.user\n\n# JustCode is a .NET coding add-in\n.JustCode\n\n# TeamCity is a build add-in\n_TeamCity*\n\n# DotCover is a Code Coverage Tool\n*.dotCover\n\n# AxoCover is a Code Coverage Tool\n.axoCover/*\n!.axoCover/settings.json\n\n# Visual Studio code coverage results\n*.coverage\n*.coveragexml\n\n# NCrunch\n_NCrunch_*\n.*crunch*.local.xml\nnCrunchTemp_*\n\n# MightyMoose\n*.mm.*\nAutoTest.Net/\n\n# Web workbench (sass)\n.sass-cache/\n\n# Installshield output folder\n[Ee]xpress/\n\n# DocProject is a documentation generator add-in\nDocProject/buildhelp/\nDocProject/Help/*.HxT\nDocProject/Help/*.HxC\nDocProject/Help/*.hhc\nDocProject/Help/*.hhk\nDocProject/Help/*.hhp\nDocProject/Help/Html2\nDocProject/Help/html\n\n# Click-Once directory\npublish/\n\n# Publish Web Output\n*.[Pp]ublish.xml\n*.azurePubxml\n# Note: Comment the next line if you want to checkin your web deploy settings,\n# but database connection strings (with potential passwords) will be unencrypted\n*.pubxml\n*.publishproj\n\n# Microsoft Azure Web App publish settings. Comment the next line if you want to\n# checkin your Azure Web App publish settings, but sensitive information contained\n# in these scripts will be unencrypted\nPublishScripts/\n\n# NuGet Packages\n*.nupkg\n*.snupkg\n# The packages folder can be ignored because of Package Restore\n**/[Pp]ackages/*\n# except build/, which is used as an MSBuild target.\n!**/[Pp]ackages/build/\n# Uncomment if necessary however generally it will be regenerated when needed\n#!**/[Pp]ackages/repositories.config\n# NuGet v3's project.json files produces more ignorable files\n*.nuget.props\n*.nuget.targets\n\n# Microsoft Azure Build Output\ncsx/\n*.build.csdef\n\n# Microsoft Azure Emulator\necf/\nrcf/\n\n# Windows Store app package directories and files\nAppPackages/\nBundleArtifacts/\nPackage.StoreAssociation.xml\n_pkginfo.txt\n*.appx\n\n# Visual Studio cache files\n# files ending in .cache can be ignored\n*.[Cc]ache\n# but keep track of directories ending in .cache\n!?*.[Cc]ache/\n\n# Others\nClientBin/\n~$*\n*~\n*.dbmdl\n*.dbproj.schemaview\n*.jfm\n*.pfx\n*.publishsettings\norleans.codegen.cs\n\n# Including strong name files can present a security risk\n# (https://github.com/github/gitignore/pull/2483#issue-259490424)\n#*.snk\n\n# Since there are multiple workflows, uncomment next line to ignore bower_components\n# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)\n#bower_components/\n\n# RIA/Silverlight projects\nGenerated_Code/\n\n# Backup & report files from converting an old project file\n# to a newer Visual Studio version. Backup files are not needed,\n# because we have git ;-)\n_UpgradeReport_Files/\nBackup*/\nUpgradeLog*.XML\nUpgradeLog*.htm\nServiceFabricBackup/\n*.rptproj.bak\n\n# SQL Server files\n*.mdf\n*.ldf\n*.ndf\n\n# Business Intelligence projects\n*.rdl.data\n*.bim.layout\n*.bim_*.settings\n*.rptproj.rsuser\n*- Backup*.rdl\n\n# Microsoft Fakes\nFakesAssemblies/\n\n# GhostDoc plugin setting file\n*.GhostDoc.xml\n\n# Node.js Tools for Visual Studio\n.ntvs_analysis.dat\nnode_modules/\n\n# Visual Studio 6 build log\n*.plg\n\n# Visual Studio 6 workspace options file\n*.opt\n\n# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)\n*.vbw\n\n# Visual Studio LightSwitch build output\n**/*.HTMLClient/GeneratedArtifacts\n**/*.DesktopClient/GeneratedArtifacts\n**/*.DesktopClient/ModelManifest.xml\n**/*.Server/GeneratedArtifacts\n**/*.Server/ModelManifest.xml\n_Pvt_Extensions\n\n# Paket dependency manager\n.paket/paket.exe\npaket-files/\n\n# FAKE - F# Make\n.fake/\n\n# JetBrains Rider\n.idea/\n*.sln.iml\n\n# CodeRush personal settings\n.cr/personal\n\n# Python Tools for Visual Studio (PTVS)\n__pycache__/\n*.pyc\n\n# Cake - Uncomment if you are using it\n# tools/**\n# !tools/packages.config\n\n# Tabs Studio\n*.tss\n\n# Telerik's JustMock configuration file\n*.jmconfig\n\n# BizTalk build output\n*.btp.cs\n*.btm.cs\n*.odx.cs\n*.xsd.cs\n\n# OpenCover UI analysis results\nOpenCover/\n\n# Azure Stream Analytics local run output\nASALocalRun/\n\n# MSBuild Binary and Structured Log\n*.binlog\n\n# NVidia Nsight GPU debugger configuration file\n*.nvuser\n\n# MFractors (Xamarin productivity tool) working folder\n.mfractor/\n\n# Local History for Visual Studio\n.localhistory/\n\n# BeatPulse healthcheck temp database\nhealthchecksdb\n\n# .NET Launch Profiles\nlaunchSettings.json"
},
{
"path": "Chell.sln",
"content": "\nMicrosoft Visual Studio Solution File, Format Version 12.00\n# Visual Studio Version 16\nVisualStudioVersion = 16.0.30114.105\nMinimumVisualStudioVersion = 10.0.40219.1\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Chell\", \"src\\Chell\\Chell.csproj\", \"{6BE659EC-A00D-4148-B19D-B5478DE001FA}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Chell.Run\", \"src\\Chell.Run\\Chell.Run.csproj\", \"{893D8C70-3C13-47D6-987F-C099C6161D7E}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"Chell.Tests\", \"tests\\Chell.Tests\\Chell.Tests.csproj\", \"{1FBAA8ED-438E-498C-AB1F-29429550DC21}\"\nEndProject\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"Solution Items\", \"Solution Items\", \"{EBB92712-D878-48FD-8E31-E577AABDC0FB}\"\n\tProjectSection(SolutionItems) = preProject\n\t\t.gitignore = .gitignore\n\t\t.github\\workflows\\build.yaml = .github\\workflows\\build.yaml\n\t\tDirectory.Build.props = Directory.Build.props\n\t\tREADME.md = README.md\n\t\t.github\\workflows\\release.yaml = .github\\workflows\\release.yaml\n\tEndProjectSection\nEndProject\nProject(\"{2150E333-8FDC-42A3-9474-1A3956D46DE8}\") = \"Samples\", \"Samples\", \"{AF454F92-8B84-446B-B0E2-9BA8887B09CC}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"GettingStarted.Basic.Windows\", \"samples\\GettingStarted.Basic.Windows\\GettingStarted.Basic.Windows.csproj\", \"{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5}\"\nEndProject\nProject(\"{9A19103F-16F7-4668-BE54-9A1E7A4F7556}\") = \"GettingStarted.Basic.Unix\", \"samples\\GettingStarted.Basic.Unix\\GettingStarted.Basic.Unix.csproj\", \"{69DC1056-843E-4980-908A-5DB4ADA95460}\"\nEndProject\nGlobal\n\tGlobalSection(SolutionConfigurationPlatforms) = preSolution\n\t\tDebug|Any CPU = Debug|Any CPU\n\t\tDebug|x64 = Debug|x64\n\t\tDebug|x86 = Debug|x86\n\t\tRelease|Any CPU = Release|Any CPU\n\t\tRelease|x64 = Release|x64\n\t\tRelease|x86 = Release|x86\n\tEndGlobalSection\n\tGlobalSection(ProjectConfigurationPlatforms) = postSolution\n\t\t{6BE659EC-A00D-4148-B19D-B5478DE001FA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{6BE659EC-A00D-4148-B19D-B5478DE001FA}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{6BE659EC-A00D-4148-B19D-B5478DE001FA}.Debug|x64.ActiveCfg = Debug|Any CPU\n\t\t{6BE659EC-A00D-4148-B19D-B5478DE001FA}.Debug|x64.Build.0 = Debug|Any CPU\n\t\t{6BE659EC-A00D-4148-B19D-B5478DE001FA}.Debug|x86.ActiveCfg = Debug|Any CPU\n\t\t{6BE659EC-A00D-4148-B19D-B5478DE001FA}.Debug|x86.Build.0 = Debug|Any CPU\n\t\t{6BE659EC-A00D-4148-B19D-B5478DE001FA}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{6BE659EC-A00D-4148-B19D-B5478DE001FA}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{6BE659EC-A00D-4148-B19D-B5478DE001FA}.Release|x64.ActiveCfg = Release|Any CPU\n\t\t{6BE659EC-A00D-4148-B19D-B5478DE001FA}.Release|x64.Build.0 = Release|Any CPU\n\t\t{6BE659EC-A00D-4148-B19D-B5478DE001FA}.Release|x86.ActiveCfg = Release|Any CPU\n\t\t{6BE659EC-A00D-4148-B19D-B5478DE001FA}.Release|x86.Build.0 = Release|Any CPU\n\t\t{893D8C70-3C13-47D6-987F-C099C6161D7E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{893D8C70-3C13-47D6-987F-C099C6161D7E}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{893D8C70-3C13-47D6-987F-C099C6161D7E}.Debug|x64.ActiveCfg = Debug|Any CPU\n\t\t{893D8C70-3C13-47D6-987F-C099C6161D7E}.Debug|x64.Build.0 = Debug|Any CPU\n\t\t{893D8C70-3C13-47D6-987F-C099C6161D7E}.Debug|x86.ActiveCfg = Debug|Any CPU\n\t\t{893D8C70-3C13-47D6-987F-C099C6161D7E}.Debug|x86.Build.0 = Debug|Any CPU\n\t\t{893D8C70-3C13-47D6-987F-C099C6161D7E}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{893D8C70-3C13-47D6-987F-C099C6161D7E}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{893D8C70-3C13-47D6-987F-C099C6161D7E}.Release|x64.ActiveCfg = Release|Any CPU\n\t\t{893D8C70-3C13-47D6-987F-C099C6161D7E}.Release|x64.Build.0 = Release|Any CPU\n\t\t{893D8C70-3C13-47D6-987F-C099C6161D7E}.Release|x86.ActiveCfg = Release|Any CPU\n\t\t{893D8C70-3C13-47D6-987F-C099C6161D7E}.Release|x86.Build.0 = Release|Any CPU\n\t\t{1FBAA8ED-438E-498C-AB1F-29429550DC21}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{1FBAA8ED-438E-498C-AB1F-29429550DC21}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{1FBAA8ED-438E-498C-AB1F-29429550DC21}.Debug|x64.ActiveCfg = Debug|Any CPU\n\t\t{1FBAA8ED-438E-498C-AB1F-29429550DC21}.Debug|x64.Build.0 = Debug|Any CPU\n\t\t{1FBAA8ED-438E-498C-AB1F-29429550DC21}.Debug|x86.ActiveCfg = Debug|Any CPU\n\t\t{1FBAA8ED-438E-498C-AB1F-29429550DC21}.Debug|x86.Build.0 = Debug|Any CPU\n\t\t{1FBAA8ED-438E-498C-AB1F-29429550DC21}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{1FBAA8ED-438E-498C-AB1F-29429550DC21}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{1FBAA8ED-438E-498C-AB1F-29429550DC21}.Release|x64.ActiveCfg = Release|Any CPU\n\t\t{1FBAA8ED-438E-498C-AB1F-29429550DC21}.Release|x64.Build.0 = Release|Any CPU\n\t\t{1FBAA8ED-438E-498C-AB1F-29429550DC21}.Release|x86.ActiveCfg = Release|Any CPU\n\t\t{1FBAA8ED-438E-498C-AB1F-29429550DC21}.Release|x86.Build.0 = Release|Any CPU\n\t\t{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5}.Debug|x64.ActiveCfg = Debug|Any CPU\n\t\t{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5}.Debug|x64.Build.0 = Debug|Any CPU\n\t\t{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5}.Debug|x86.ActiveCfg = Debug|Any CPU\n\t\t{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5}.Debug|x86.Build.0 = Debug|Any CPU\n\t\t{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5}.Release|x64.ActiveCfg = Release|Any CPU\n\t\t{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5}.Release|x64.Build.0 = Release|Any CPU\n\t\t{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5}.Release|x86.ActiveCfg = Release|Any CPU\n\t\t{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5}.Release|x86.Build.0 = Release|Any CPU\n\t\t{69DC1056-843E-4980-908A-5DB4ADA95460}.Debug|Any CPU.ActiveCfg = Debug|Any CPU\n\t\t{69DC1056-843E-4980-908A-5DB4ADA95460}.Debug|Any CPU.Build.0 = Debug|Any CPU\n\t\t{69DC1056-843E-4980-908A-5DB4ADA95460}.Debug|x64.ActiveCfg = Debug|Any CPU\n\t\t{69DC1056-843E-4980-908A-5DB4ADA95460}.Debug|x64.Build.0 = Debug|Any CPU\n\t\t{69DC1056-843E-4980-908A-5DB4ADA95460}.Debug|x86.ActiveCfg = Debug|Any CPU\n\t\t{69DC1056-843E-4980-908A-5DB4ADA95460}.Debug|x86.Build.0 = Debug|Any CPU\n\t\t{69DC1056-843E-4980-908A-5DB4ADA95460}.Release|Any CPU.ActiveCfg = Release|Any CPU\n\t\t{69DC1056-843E-4980-908A-5DB4ADA95460}.Release|Any CPU.Build.0 = Release|Any CPU\n\t\t{69DC1056-843E-4980-908A-5DB4ADA95460}.Release|x64.ActiveCfg = Release|Any CPU\n\t\t{69DC1056-843E-4980-908A-5DB4ADA95460}.Release|x64.Build.0 = Release|Any CPU\n\t\t{69DC1056-843E-4980-908A-5DB4ADA95460}.Release|x86.ActiveCfg = Release|Any CPU\n\t\t{69DC1056-843E-4980-908A-5DB4ADA95460}.Release|x86.Build.0 = Release|Any CPU\n\tEndGlobalSection\n\tGlobalSection(SolutionProperties) = preSolution\n\t\tHideSolutionNode = FALSE\n\tEndGlobalSection\n\tGlobalSection(NestedProjects) = preSolution\n\t\t{9BE2CB2C-D6F2-429A-A00F-CF30CAEF28B5} = {AF454F92-8B84-446B-B0E2-9BA8887B09CC}\n\t\t{69DC1056-843E-4980-908A-5DB4ADA95460} = {AF454F92-8B84-446B-B0E2-9BA8887B09CC}\n\tEndGlobalSection\n\tGlobalSection(ExtensibilityGlobals) = postSolution\n\t\tSolutionGuid = {5B16EB0E-5342-4D93-9FA2-8327FF69A276}\n\tEndGlobalSection\nEndGlobal\n"
},
{
"path": "Directory.Build.props",
"content": "\n\n \n 1.0.0\n latest\n enable\n true\n $(NoWarn);1591;1587;1574\n\n \n Write scripts with the power of .NET. Provides a shell script-like (bash, cmd, ...) experience to .NET application.\n Mayuki Sawatari\n Copyright © Mayuki Sawatari\n https://github.com/mayuki/Chell\n https://github.com/mayuki/Chell\n \n CommandLine Shell Process\n MIT\n\n \n\n"
},
{
"path": "LICENSE",
"content": "MIT License\n\nCopyright © Mayuki Sawatari \n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE."
},
{
"path": "README.md",
"content": "# Chell\nWrite scripts with the power of C# and .NET.\n\nChell is a library and execution tool for providing a shell script-like (bash, cmd, ...) experience to .NET applications.\n\n```csharp\nvar branch = await Run($\"git branch --show-current\");\nawait Run($\"git archive {branch} -o {branch}.zip\");\n```\n\n.NET applications are great for complex tasks, but executing processes can be boring. Chell brings the experience closer to shell scripting. This library is heavily influenced by [google/zx](https://github.com/google/zx).\n\n## When should I use Chell?\n- **Write better shell scripts**: Write a complex script and use the power of .NET and C#\n- **Write multi-platform shell scripts**: As an alternative to scripts that work on multiple platforms\n- **Run a process quickly in your app**: As .NET library for easy handling of process launch and output\n- **All developers in the project are .NET developers**: 🙃\n\nOf course, if the shell script is already working fine and you don't have any problems, then there is no need to use Chell.\n\n## Chell at a glance\nUsing Chell makes the code feel more like a script by taking advantage of C# 9's top-level statements and C# 6's `using static`.\n\n```csharp\n// Chell.Exports exposes a variety of functions and properties\nusing Chell;\nusing static Chell.Exports;\n```\n```csharp\n// Move the current directory with Cd method\nCd(\"/tmp\");\n\n// Dispose the return value of Cd method to return to the previous directory\nusing (Cd(\"/usr/local/bin\"))\n{\n // The current directory is \"/usr/local/bin\".\n}\n// The current directory is \"/\" again.\n```\n```csharp\n// You can run the process by passing a string to Run method\nawait Run($\"ls -lFa\");\n```\n```csharp\n// An interpolated string passed to Run method will be escaped and expanded if it is an array\nvar newDirs = new [] { \"foo\", \"bar\", \"my app\", \"your;app\" };\nawait Run($\"mkdir {newDirs}\"); // $ mkdir foo bar \"my app\" \"your;app\"\n```\n```csharp\n// Run method returns the result object of the command (ProcessOutput class)\nvar result = await Run($\"ls -lFa\");\n// You can read stdout & stderr line by line\nforeach (var line in result)\n{\n Echo(line);\n}\n\n// Allows to get stdout & stderr with implicit conversion to `string`\nstring output = result;\n// You can also get stdout as bytes (ReadOnlyMemory)\nvar binary = result.OutputBinary;\n```\n```csharp\n// Provides convenient extension methods for parsing JSON.\nvar images = await Run($\"docker image ls --format {\"{{json .}}\"}\").SuppressConsoleOutputs();\nforeach (var image in images.AsJsonLines(new { Repository = \"\", ID = \"\", Tag = \"\"}))\n{\n Echo(image);\n}\n// $ docker image ls --format \"{{json .}}\"\n// { Repository = mcr.microsoft.com/dotnet/sdk, ID = b160c8f3dbd6, Tag = 5.0 }\n// { Repository = , ID = 3ee645b4a3bd, Tag = }\n```\n```csharp\n// Standard input/output of process tasks can be connected by pipes\nawait (Run($\"ls -lFa\") | Run($\"grep dotnet\"));\n// The difference with `await (Run($\"ls -lFa | grep dotnet\"));` is that the shell can pipe or not.\n\n// You can also specify a Stream as input or output\n// Write ffmpeg output to a Stream.\nawait (Run($\"ffmpeg ...\") | destinationStream);\n// Write a Stream to ffmpeg process.\nawait (srcStream | Run($\"ffmpeg ...\"));\n```\n\nJust want to make it easy for your app to handle processes? If you don't use `Chell.Exports`, you won't get any unnecessary methods or properties, and you'll get the same functions by `new Run(...)`.\n\n```csharp\nusing Chell;\nvar result = await new Run($\"ls -lF\");\n```\n\nWant to run it like a scripting language? Install [Chell.Run](#chellrun), and you can run it like a script.\n\n```bash\n% dotnet tool install -g Chell.Run\n\n% chell -e \"Echo(DateTime.Now)\"\n9/1/2021 0:00:00 PM\n\n% cat <<__EOF__ > MyScript.cs\nvar dirs = new [] { \"foo bar\", \"baz\" };\nawait Run($\"mkdir {dirs}\");\nawait Run($\"ls -l\");\n__EOF__\n\n% chell MyScript.cs\n$ mkdir \"foo bar\" \"baz\"\n$ ls -l\ntotal 8\ndrwxr-xr-x 2 mayuki mayuki 4096 Sep 1 00:00 baz/\ndrwxr-xr-x 2 mayuki mayuki 4096 Sep 1 00:00 'foo bar'/\n```\n\n\n## Features\n- Automatic shell character escaping and array expansion\n- Stream and Process Pipes\n- Provide utilities and shortcuts useful for scripting.\n- Simple shell script-like execution tools\n- Multi-platform (Windows, Linux, macOS)\n- LINQPad friendly\n\n## Install\n```\ndotnet package add Chell\n```\n### Requirements\n.NET Standard 2.1, .NET 5 or higher\n\n## Chell.Exports\nChell.Exports class exposes a variety of utilities and shortcuts to make writing feel like shell scripting. It is recommended to include this class in your scripts with `static using`.\n\n### Methods (Functions)\n#### `Run`\nStarts a process using the specified command-line and returns a `ProcessTask`.\n\n```csharp\nawait Run($\"ls -lF\");\n\n// The followings are equivalent to calling Run method\nawait (Run)$\"ls -lF\";\nawait new Run($\"ls -lF\");\n```\n\nThe process will be launched asynchronously and can wait for completion by `await`. And you can `await` to get a `ProcessOutput` object with its output.\n\nIf the exit code of the process returns non-zero, it will throw an exception. To suppress this exception, see `NoThrow`.\n\nAn interpolated string passed to Run method will be escaped and expanded if it is an array.\n\n```csharp\nvar newDirs = new [] { \"foo\", \"bar\", \"my app\", \"your;app\" };\nawait Run($\"mkdir {newDirs}\"); // equivalent to `mkdir foo bar \"my app\" \"your;app\"`\n```\n\nYou can also pass an execution options (`ProcessTaskOptions`) to Run method.\n\n```csharp\nawait Run($\"ping -t localhost\", new ProcessTaskOptions(\n workingDirectory: @\"C:\\Windows\",\n timeout: TimeSpan.FromSeconds(1)\n));\n```\n\n#### `Cd(string)`\n```csharp\nCd(\"/usr/local/bin\"); // equivalent to `Environment.CurrentDirectory = \"/usr/local/bin\";`\n```\n\nDispose the return value of `Cd` method to return to the previous directory.\n\n```csharp\nCd(\"/\"); // The current directory is \"/\".\nusing (Cd(\"/usr/local/bin\"))\n{\n // The current directory is \"/usr/local/bin\".\n}\n// The current directory is \"/\" again.\n```\n\n#### `Mkdirp(string path)`\nSame as `mkdir -p`. Creates a new directory and any necessary sub-directories in the specified path.\n\n#### `Dump(T value)`\nFormats the object and write it to the console.\n\n```csharp\nDump(new { Foo = 123, Bar = \"Baz\" }); // => \"{ Foo = 123, Bar = \"Baz\" }\"\n```\n\n#### `Which(string name)`, `TryWhich(string name, out string path)`\nReturns a path of the specified command.\n\n```csharp\nvar dotnetPath = Which(\"dotnet\");\nawait Run($\"{dotnetPath} run\");\n```\n\n#### `Echo(object message = default)`\n`Echo` method is equivalent to Console.WriteLine.\n\n```csharp\nEcho(\"Hello World!\"); // equivalent to Console.WriteLine(\"Hello World!\");\n```\n\n#### `Sleep(int duration)`, `Sleep(TimeSpan duration)`\nReturns a Task that waits for the specified duration.\n\n```csharp\nawait Sleep(10); // Sleep for 10 seconds.\n```\n\n#### `Exit(int exitCode)`\nTerminates the application with an exit code.\n\n```csharp\nExit(1);\n```\n\n### Properties\n\n#### `Env.Vars`\n\nExposes the environment variables as `IDictionary`.\n\n```csharp\nEnv.Vars[\"PATH\"] = Env.Vars[\"PATH\"] + \":/path/to/\";\n```\n\n#### `Env.IsWindows`\nReturns whether the running operating system is Windows or not. If it returns `false`, the operating system is Linux or macOS.\n\n```csharp\nif (Env.IsWindows) { /* Something to do for Windows */ }\n```\n\n#### `Env.Shell`\nSpecify explicitly which shell to use, or set to not use a shell.\n\n```csharp\nEnv.Shell.UseBash();\nEnv.Shell.NoUseShell();\nEnv.Shell.UseCmd();\n```\n\n#### `Env.Verbosity`\nSets or gets the output level when executing a command/process.\n\n- `Verbosity.All`: Displays both the command line and the output of the command\n- `Verbosity.CommandLine`: Displays the command line\n- `Verbosity.Output`: Displays the output of the command\n- `Verbosity.Silent`: No display\n\n#### `Env.ProcessTimeout`\n\nSets the timeout for running the process. The default value is `0` (disabled).\n\n```csharp\nEnv.ProcessTimeout = TimeSpan.FromSecond(1);\n\n// OperationCanceledException will be thrown after 1s.\nawait Run($\"ping -t localhost\");\n```\n\n#### `Arguments`\nGets the arguments passed to the current application.\n\n```csharp\n// $ myapp foo bar baz => new [] { \"foo\", \"bar\", \"baz\" };\nforeach (var arg in Arguments) { /* ... */ }\n```\n#### `CurrentDirectory`, `ExecutableDirectory`, `ExecutableName`, `ExecutablePath`\nGets the current directory and the application directory or name or path.\n\n```csharp\n// C:\\> cd C:\\Users\\Alice\n// C:\\Users\\Alice> Downloads\\MyApp.exe\n\nEcho(CurrentDirectory); // C:\\Users\\Alice\nEcho(ExecutableDirectory); // C:\\Users\\Alice\\Downloads\nEcho(ExecutableName); // MyApp.exe\nEcho(ExecutablePath); // C:\\Users\\Alice\\Downloads\\MyApp.exe\n```\n\n#### `HomeDirectory`\nGets the path of the current user's home directory.\n\n```csharp\n// Windows: C:/Users/\n// Linux: /home/\n// macOS: /Users/\nEcho(HomeDirectory);\n```\n\n#### `StdIn`, `StdOut`, `StdErr`\nProvides the wrapper with methods useful for reading and writing to the standard input/output/error streams.\n\n```csharp\n// Reads data from standard input.\nawait StdIn.ReadToEndAsync();\n\n// Writes data to standard output or error.\nStdOut.WriteLine(\"FooBar\");\nStdErr.WriteLine(\"Oops!\");\n```\n\n## ProcessTask class\nRepresents the execution task of the process started by `Run`.\n\n\n### `Pipe`\nConnects the standard output of the process to another `ProcessTask` or `Stream`.\n\n```csharp\nawait (Run($\"ls -lF\") | Run($\"grep .dll\"));\n\n// The followings are equivalent to using '|'.\nvar procTask1 = Run($\"ls -lF\");\nvar procTask2 = Run($\"grep .dll\");\nprocTask1.Pipe(procTask2);\n```\n\nA `Stream` can also be passed to Pipe. If the ProcessTask has connected to the `Stream`, it will not write to `ProcessOutput`.\n\n```csharp\nvar memStream = new MemoryStream();\nawait Run($\"ls -lF\").Pipe(memStream);\n```\n\n### `ConnectStreamToStandardInput`\nConnects the Stream to the standard input of the process. The method can be called only once before the process starts.\n\n```csharp\nawait (myStream | Run($\"grep .dll\"));\n\n// The followings are equivalent to using '|'.\nvar procTask = Run($\"grep .dll\");\nprocTask.ConnectStreamToStandardInput(myStream);\n```\n\n### `NoThrow`\nSuppresses exception throwing when the exit code is non-zero.\n\n```csharp\nawait Run($\"AppReturnsExitCodeNonZero\").NoThrow();\n```\n\n### `SuppressConsoleOutputs`\nSuppresses the writing of command execution results to the standard output.\n\n```csharp\n// equivalent to \"Env.Verbosity = Verbosity.Silent\" or pipe to null.\nawait Run($\"ls -lF\").SuppressConsoleOutputs();\n\n```\n### `ExitCode`\nReturns a `Task` to get the exit code of the process. This is equivalent to waiting for a `ProcessTask` with `NoThrow`.\n\n```csharp\nvar proc = Run($\"ls -lF\");\nif (await proc.ExitCode != 0)\n{\n ...\n}\n\n// equivalent to `(await Run($\"ls -lF\").NoThrow()).ExitCode`\n```\n\n## ProcessOutput class\nProvides the results of the process execution.\n\n### `Combined`, `CombinedBinary`\nGets the combined standard output and error as a string or byte array.\n\n### `Output`, `OutputBinary`\nGets the standard output as a string or byte array.\n\n### `Error`, `ErrorBinary`\nGets the standard error as a string or byte array.\n\n### `AsLines(bool trimEnd = false)`, `GetEnumerator()`\nGets the combined standard output and error as a per-line `IEnumerable`.\n\n```csharp\n// equivalent to `foreach (var line in procOutput.AsLines())`\nforeach (var line in procOutput) { ... }\n```\n\n### `ToString()`\nThe method equivalent to `Combined` property.\n\n### `ExitCode`\nGets the exit code of the process.\n\n## Utilities and shortcuts\nChell.Exports class also exposes a variety of useful utilities and shortcuts to libraries.\n\n### `Prompt`\nPrompts the user for input and gets it.\n\n```csharp\nvar name = await Prompt(\"What's your name? \");\n```\n\n### `Chalk`: Kokuban: Terminal string styling\nProvides a shortcut to [mayuki/Kokuban](https://github.com/mayuki/Kokuban). You can easily style the text on the terminal.\n\n```csharp\n// \"Error: \" will be colored.\nEcho((Chalk.Red + \"Error: \") + \"Something went wrong.\");\n```\n\n### `Glob`\nProvides a shortcut to `Microsoft.Extensions.FileSystemGlobbing`.\n\n- `Glob(params string[] patterns)`\n- `Glob(string baseDir, string[] patterns)`\n\n```csharp\n// Glob patterns starting with '!' will be treated as excludes.\nforeach (var path in Glob(\"**/*.cs\", \"!**/*.vb\"))\n{\n ...\n}\n```\n\n### JSON serialize/deserialize (System.Text.Json)\nProvides shortcuts to `System.Text.Json`.\n\n- `ToJson(T obj)`\n```csharp\nvar obj = new { Name = \"Alice\", Age = 18 };\nvar json = ToJson(obj);\nEcho(json); // {\"Name\":\"Alice\",\"Age\":18}\n```\n\n- `FromJson(string json)`\n- `FromJson(string json, T shape)`\n```csharp\nvar json = \"{ \\\"foo\\\": 123 }\";\nvar obj = FromJson(json, new { Foo = 0 });\nDump(obj); // { Foo = 123 }\n```\n\n- `AsJson`\n- `AsJsonLines`\n```csharp\nusing Chell;\nvar output = await Run($\"docker image ls --format {\"{{json .}}\"}\");\nforeach (var image in output.AsJsonLines(new { Repository = \"\", ID = \"\", Tag = \"\"}))\n{\n // ...\n}\n```\n```csharp\nusing Chell;\nvar output = await Run($\"kubectl version --client -o json\");\nvar obj = output.AsJson(new { clientVersion = new { major = \"\", minor = \"\", gitVersion = \"\" } });\nEcho(obj); // { clientVersion = { major = 1, minor = 21, gitVersion = v1.21.2 } }\n```\n\n### HTTP acccess (System.Net.Http)\nProvides shortcuts to `System.Net.Http.HttpClient`.\n\n- `FetchAsync`\n- `FetchByteArrayAsync`\n- `FetchStreamAsync`\n- `FetchStringAsync`\n\n## Chell as a Library\nChell can also be used as a utility library to run processes.\n\nIf you don't use `Chell.Exports`, you won't get any unnecessary methods or properties, and you can use `Run` and `ChellEnvironment`, `Exports` class.\n\n```csharp\nusing Chell;\n\nvar results = await new Run($\"ls -lF\");\n\n// ChellEnvironment.Current is equivalent to `Env` on `Chell.Exports`.\nConsole.WriteLine(ChellEnvironment.Current.ExecutablePath);\nConsole.WriteLine(ChellEnvironment.Current.ExecutableName);\nConsole.WriteLine(ChellEnvironment.Current.Arguments);\nConsole.WriteLine(ChellEnvironment.Current.Vars[\"PATH\"]);\n```\n\n## Chell.Run\nChell.Run executes the input source code in an environment where Chell and some libraries are available.\n\nIt does not perform any NuGet package resolution, so we recommend creating a typical C# project if you need to handle such complexities.\n\n```\n$ dotnet tool install -g Chell.Run\n```\n```bash\n$ chell -e \"Echo(123);\"\n$ chell <\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n```\n"
},
{
"path": "samples/GettingStarted.Basic.Unix/GettingStarted.Basic.Unix.csproj",
"content": "\n\n \n Exe\n net5.0\n false\n \n\n \n \n \n\n\n"
},
{
"path": "samples/GettingStarted.Basic.Unix/Program.cs",
"content": "using System;\nusing System.Linq;\nusing static Chell.Exports;\n\n// Starts a process.\n// The array will be expanded and the elements will be escaped\nvar dirs = new[] { \"/\", \"/usr\", \"/bin\" };\nvar results = await Run($\"ls -l {dirs}\");\n\n// Enumerates the results to retrieve the standard output line by line.\nforeach (var line in results)\n{\n Echo($\"Result> {line}\");\n}\nEcho();\n\n// Built-in Variables\nEcho((Chalk.Green + \"ExecutableName: \") + string.Join(' ', ExecutableName));\nEcho((Chalk.Green + \"ExecutableDirectory: \") + string.Join(' ', ExecutableDirectory));\nEcho((Chalk.Green + \"Arguments: \") + string.Join(' ', Arguments));\nEcho((Chalk.Green + \"CurrentDirectory: \") + string.Join(' ', CurrentDirectory));\nEcho();\n\n// Environment Variables\nEcho((Chalk.Green + \"Env.Vars[\\\"PATH\\\"]: \") + Env.Vars[\"PATH\"]);\nEcho();\n\n// Standard Input/Error as Stream + Utility methods.\nStdOut.WriteLine(\"Hello World!\");\nStdErr.WriteLine(\"Hello World! (Error)\");\nEcho();\n\n// Get the data from network and pipe it to the process\nawait (await FetchByteArrayAsync(\"http://www.example.com/\") | Run(\"grep title\"));\n\n\n// Temporarily change the current directory.\nusing (Cd(\"/\"))\n{\n await Run($\"dir\");\n}\n\nExit(1);\n"
},
{
"path": "samples/GettingStarted.Basic.Windows/GettingStarted.Basic.Windows.csproj",
"content": "\n\n \n Exe\n net5.0\n false\n \n\n \n \n \n\n\n"
},
{
"path": "samples/GettingStarted.Basic.Windows/Program.cs",
"content": "using System;\nusing System.Linq;\nusing Chell;\nusing static Chell.Exports;\n\n// Starts a process.\n// The array will be expanded and the elements will be escaped\nvar dirs = new[] { @\"C:\\Windows\\Microsoft.NET\", @\"C:\\Program Files\" };\nvar results = await Run($\"dir {dirs}\"); // \n\n// Enumerates the results to retrieve the standard output line by line.\nforeach (var line in results.Where(x => x.Contains(\"Windows\")))\n{\n Echo($\"Result> {line}\");\n}\nEcho();\n\n// Built-in Variables\nEcho((Chalk.Green + \"ExecutableName: \") + string.Join(' ', ExecutableName));\nEcho((Chalk.Green + \"ExecutableDirectory: \") + string.Join(' ', ExecutableDirectory));\nEcho((Chalk.Green + \"Arguments: \") + string.Join(' ', Arguments));\nEcho((Chalk.Green + \"CurrentDirectory: \") + string.Join(' ', CurrentDirectory));\nEcho();\n\n// Environment Variables\nEcho((Chalk.Green + \"Env.Vars[\\\"PATH\\\"]: \") + Env.Vars[\"PATH\"]);\nEcho();\n\n// Standard Input/Error as Stream + Utility methods.\nStdOut.WriteLine(\"Hello World!\");\nStdErr.WriteLine(\"Hello World! (Error)\");\nEcho();\n\n// Get the data from network and pipe it to the process\nawait (await FetchByteArrayAsync(\"http://www.example.com/\") | Run(\"findstr title\"));\n\n// Temporarily change the current directory.\nusing (Cd(\"C:\\\\Users\"))\n{\n await Run($\"dir\");\n}\n\nExit(1);\n"
},
{
"path": "src/.editorconfig",
"content": "###############################\n# C# Nullability #\n###############################\n[*.cs]\n# CS8618: Non-nullable field is uninitialized. Consider declaring as nullable.\ndotnet_diagnostic.CS8618.severity = error\n# CS8604: Possible null reference argument.\ndotnet_diagnostic.CS8604.severity = error\n# CS8629: Nullable value type may be null.\ndotnet_diagnostic.CS8629.severity = error\n# CS8600: Converting null literal or possible null value to non-nullable type.\ndotnet_diagnostic.CS8600.severity = error\n# CS8603: Possible null reference return.\ndotnet_diagnostic.CS8603.severity = error\n# CS8610: Nullability of reference types in type of parameter doesn't match overridden member.\ndotnet_diagnostic.CS8610.severity = error\n# CS8625: Cannot convert null literal to non-nullable reference type.\ndotnet_diagnostic.CS8625.severity = error\n# CS8606: Possible null reference assignment to iteration variable\ndotnet_diagnostic.CS8606.severity = error\n# CS8602: Dereference of a possibly null reference.\ndotnet_diagnostic.CS8602.severity = error\n# CS8601: Possible null reference assignment.\ndotnet_diagnostic.CS8601.severity = error\n# CS8614: Nullability of reference types in type of parameter doesn't match implicitly implemented member.\ndotnet_diagnostic.CS8614.severity = error"
},
{
"path": "src/Chell/Chell.csproj",
"content": "\n\n \n netstandard2.1;netcoreapp3.1;net5.0\n latest\n enable\n true\n \n\n \n \n \n \n \n\n \n \n \n\n \n \n TextTemplatingFileGenerator\n ProcessTaskExtensions.Generated.cs\n \n \n TextTemplatingFileGenerator\n ChellWritableStream.Generated.cs\n \n \n\n \n \n \n\n \n \n True\n True\n ProcessTaskExtensions.tt\n \n \n True\n True\n ChellWritableStream.tt\n \n \n\n\n"
},
{
"path": "src/Chell/ChellEnvironment.cs",
"content": "using System;\nusing System.Collections.Generic;\nusing System.ComponentModel;\nusing System.Diagnostics;\nusing System.IO;\nusing System.IO.Pipes;\nusing System.Linq;\nusing System.Runtime.InteropServices;\nusing System.Threading;\nusing Chell.Internal;\nusing Chell.IO;\nusing Chell.Shell;\n\nnamespace Chell\n{\n [Flags]\n public enum ChellVerbosity\n {\n /// \n /// By default, no output is written to the console.\n /// \n Silent = 0,\n\n /// \n /// Writes a executing command line to the console.\n /// \n CommandLine = 1 << 0,\n\n /// \n /// Writes a command output to the console.\n /// \n ConsoleOutputs = 1 << 1,\n\n /// \n /// Writes all command lines and command outputs.\n /// \n Full = CommandLine | ConsoleOutputs,\n\n [EditorBrowsable(EditorBrowsableState.Never)]\n Debug = Full | 1 << 31,\n }\n\n public class ChellEnvironment\n {\n public static ChellEnvironment Current { get; set; } = new ChellEnvironment();\n \n private string[] _arguments;\n private string? _executablePath;\n private string _executableName;\n private string _executableDirectory;\n\n public ChellEnvironment()\n {\n var args = Environment.GetCommandLineArgs();\n var path = args[0];\n _arguments = args.Skip(1).ToArray();\n _executablePath = path;\n _executableName = Path.GetFileName(path);\n _executableDirectory = Path.GetDirectoryName(path)!;\n }\n\n /// \n /// Gets or sets the verbosity.\n /// \n public ChellVerbosity Verbosity { get; set; } = ChellVerbosity.Full;\n\n public ShellExecutorProvider Shell { get; } = new ShellExecutorProvider();\n public IConsoleProvider Console { get; set; } =\n LINQPadHelper.RunningOnLINQPad\n ? new LINQPadConsoleProvider()\n : SystemConsoleProvider.Instance;\n\n /// \n /// Gets the identifier for the current application process.\n /// \n public int ProcessId =>\n#if NET5_0_OR_GREATER\n Environment.ProcessId\n#else\n Process.GetCurrentProcess().Id\n#endif\n ;\n\n /// \n /// Gets whether the current application is running on Windows.\n /// \n public bool IsWindows => RuntimeInformation.IsOSPlatform(OSPlatform.Windows);\n\n /// \n /// Gets the command line arguments. like args of a entry point.\n /// \n public IReadOnlyList Arguments => _arguments;\n\n /// \n /// Gets the path of the executing application. like argv[0]. (e.g. C:\\\\Path\\To\\App.exe, /path/to/app)\n /// \n /// \n /// The path may be null when running a inline script.\n /// \n public string? ExecutablePath => _executablePath;\n\n /// \n /// Gets the name of the executing application. like argv[0]. (e.g. App.exe, app)\n /// \n public string ExecutableName => _executableName;\n\n /// \n /// Gets the directory of the executing application. like argv[0]. (e.g. C:\\\\Path\\To, /path/to)\n /// \n public string ExecutableDirectory => _executableDirectory;\n\n /// \n /// Gets or sets the path of the current working directory.\n /// \n public string CurrentDirectory\n {\n get => Environment.CurrentDirectory;\n set => Environment.CurrentDirectory = value;\n }\n\n /// \n /// Gets the path of the current user's home directory.\n /// \n public string HomeDirectory => Environment.GetFolderPath(Environment.SpecialFolder.UserProfile);\n\n /// \n /// Gets the environment variables as representation.\n /// \n public IDictionary Vars { get; } = new EnvironmentVariables();\n\n /// \n /// Gets the standard input stream.\n /// \n public ChellReadableStream StdIn => new ChellReadableStream(this.Console.OpenStandardInput(), this.Console.InputEncoding);\n\n /// \n /// Gets the standard output stream.\n /// \n public ChellWritableStream StdOut => new ChellWritableStream(this.Console.OpenStandardOutput(), this.Console.OutputEncoding);\n\n /// \n /// Gets the standard output stream.\n /// \n public ChellWritableStream StdErr => new ChellWritableStream(this.Console.OpenStandardError(), this.Console.OutputEncoding);\n\n /// \n /// Gets or sets the default timeout for the process. The value affects the current application. The default value is .\n /// \n /// \n /// If the value is or , the process will not be timed out.\n /// \n public TimeSpan ProcessTimeout { get; set; } = TimeSpan.Zero;\n\n [EditorBrowsable(EditorBrowsableState.Never)]\n public void SetCommandLineArgs(string? executablePath, string executableName, string executableDirectory, string[] args)\n {\n _arguments = args.ToArray();\n _executableName = executableName;\n _executablePath = executablePath;\n _executableDirectory = executableDirectory;\n }\n }\n}\n"
},
{
"path": "src/Chell/CommandLineString.cs",
"content": "using System;\nusing System.ComponentModel;\nusing System.Diagnostics;\n\nnamespace Chell\n{\n /// \n /// Workaround for string/FormattableString overload issues\n /// \n [EditorBrowsable(EditorBrowsableState.Never)]\n [DebuggerDisplay(\"CommandLineString: String={StringValue,nq}; FormattableString={FormattableStringValue,nq}\")]\n public readonly struct CommandLineString\n {\n public string? StringValue { get; }\n public FormattableString? FormattableStringValue { get; }\n\n public CommandLineString(string value)\n {\n StringValue = value;\n FormattableStringValue = null;\n }\n\n public CommandLineString(FormattableString value)\n {\n StringValue = null;\n FormattableStringValue = value;\n }\n\n public static implicit operator CommandLineString(string value)\n {\n return new CommandLineString(value);\n }\n\n public static implicit operator CommandLineString(FormattableString value)\n {\n return new CommandLineString(value);\n }\n }\n}"
},
{
"path": "src/Chell/Exports.cs",
"content": "using Microsoft.Extensions.FileSystemGlobbing;\nusing Microsoft.Extensions.FileSystemGlobbing.Abstractions;\nusing System;\nusing System.Collections.Generic;\nusing System.IO;\nusing System.Linq;\nusing System.Net.Http;\nusing System.Text.Json;\nusing System.Threading;\nusing System.Threading.Tasks;\nusing Chell.Internal;\nusing Chell.IO;\nusing Kokuban;\nusing Kokuban.AnsiEscape;\n\nnamespace Chell\n{\n public static class Exports\n {\n public static class Verbosity\n {\n /// \n /// By default, no output is written to the console.\n /// \n public const ChellVerbosity Silent = ChellVerbosity.Silent;\n\n /// \n /// Writes a executing command line to the console.\n /// \n public const ChellVerbosity CommandLine = ChellVerbosity.CommandLine;\n\n /// \n /// Writes a command output to the console.\n /// \n public const ChellVerbosity ConsoleOutputs = ChellVerbosity.ConsoleOutputs;\n\n /// \n /// Writes all command lines and command outputs.\n /// \n public const ChellVerbosity Full = ChellVerbosity.Full;\n }\n\n /// \n /// Gets the current environment.\n /// \n public static ChellEnvironment Env => ChellEnvironment.Current;\n\n /// \n /// Gets the standard input stream.\n /// \n public static ChellReadableStream StdIn => Env.StdIn;\n\n /// \n /// Gets the standard output stream.\n /// \n public static ChellWritableStream StdOut => Env.StdOut;\n\n /// \n /// Gets the standard error stream.\n /// \n public static ChellWritableStream StdErr => Env.StdErr;\n\n /// \n /// Gets the command line arguments. like args of a entry point.\n /// \n public static IReadOnlyList Arguments => Env.Arguments;\n\n /// \n /// Gets the path of the executing application. like argv[0]. (e.g. C:\\\\Path\\To\\App.exe, /path/to/app)\n /// \n /// \n /// The path may be null when running a inline script.\n /// \n public static string? ExecutablePath => Env.ExecutablePath;\n\n /// \n /// Gets the name of the executing application. like argv[0]. (e.g. App.exe, app)\n /// \n public static string ExecutableName => Env.ExecutableName;\n\n /// \n /// Gets the directory of the executing application. like argv[0]. (e.g. C:\\\\Path\\To, /path/to)\n /// \n public static string ExecutableDirectory => Env.ExecutableDirectory;\n\n /// \n /// Gets or sets the path of the current working directory.\n /// \n public static string CurrentDirectory\n {\n get => Env.CurrentDirectory;\n set => Env.CurrentDirectory = value;\n }\n\n /// \n /// Gets the identifier for the current application process.\n /// \n public static int ProcessId => Env.ProcessId;\n\n /// \n /// Gets the Kokuban ANSI style builder to decorate texts.\n /// \n public static AnsiStyle Chalk => Kokuban.Chalk.Create(KokubanOptions.Default);\n\n /// \n /// Starts the process task with the specified command line.\n /// \n /// \n /// \n /// \n public static ProcessTask Run(FormattableString commandLine, ProcessTaskOptions? options = default)\n => new ProcessTask(commandLine, options);\n\n /// \n /// Starts the process task with the specified command line.\n /// \n /// \n /// \n /// \n public static ProcessTask Run(CommandLineString commandLine, ProcessTaskOptions? options = default)\n => new ProcessTask(commandLine, options);\n\n /// \n /// Starts the process task with the specified command line.\n /// \n /// The data to be passed to the standard input of the process.\n /// \n /// \n /// \n public static ProcessTask Run(Stream inputStream, FormattableString commandLine, ProcessTaskOptions? options = default)\n => new ProcessTask(inputStream, commandLine, options);\n\n /// \n /// Starts the process task with the specified command line.\n /// \n /// The data to be passed to the standard input of the process.\n /// \n /// \n /// \n public static ProcessTask Run(Stream inputStream, CommandLineString commandLine, ProcessTaskOptions? options = default)\n => new ProcessTask(inputStream, commandLine, options);\n\n /// \n /// Starts the process task with the specified command line.\n /// \n /// The data to be passed to the standard input of the process.\n /// \n /// \n /// \n public static ProcessTask Run(ReadOnlyMemory inputData, FormattableString commandLine, ProcessTaskOptions? options = default)\n => new ProcessTask(inputData, commandLine, options);\n\n /// \n /// Starts the process task with the specified command line.\n /// \n /// The data to be passed to the standard input of the process.\n /// \n /// \n /// \n public static ProcessTask Run(ReadOnlyMemory inputData, CommandLineString commandLine, ProcessTaskOptions? options = default)\n => new ProcessTask(inputData, commandLine, options);\n\n /// \n /// Writes the message to the console.\n /// \n /// \n public static void Echo(object? message = default)\n => ChellEnvironment.Current.Console.Out.WriteLine(message);\n\n /// \n /// Writes the object details to the console.\n /// \n /// \n /// \n public static void Dump(T obj)\n => ObjectDumper.Dump(obj);\n\n /// \n /// Converts the object to a JSON.\n /// \n /// \n public static string ToJson(T obj, JsonSerializerOptions? options = default)\n => JsonSerializer.Serialize(obj, options);\n\n /// \n /// Converts the JSON to an object.\n /// \n /// \n public static T? FromJson(string json, T shape)\n => FromJson(json);\n\n /// \n /// Converts the JSON to an object.\n /// \n /// \n public static T? FromJson(string json)\n => Chell.Extensions.StringExtensions.AsJson(json);\n\n /// \n /// Changes the current directory to the specified path.\n /// \n /// \n /// Dispose the return value to return to the previous directory.\n /// \n /// \n public static IDisposable Cd(string path)\n => new ChangeDirectoryScope(path);\n\n private class ChangeDirectoryScope : IDisposable\n {\n private readonly string _previousCurrentDirectory;\n\n public ChangeDirectoryScope(string newCurrentDirectory)\n {\n _previousCurrentDirectory = Environment.CurrentDirectory;\n ChangeDirectory(newCurrentDirectory);\n }\n\n public void Dispose()\n {\n ChangeDirectory(_previousCurrentDirectory);\n }\n\n private void ChangeDirectory(string path)\n {\n CommandLineHelper.WriteCommandLineToConsole(ChellEnvironment.Current.Console, $\"cd {path}\");\n Environment.CurrentDirectory = path;\n }\n }\n\n /// \n /// Sleeps for the specified time.\n /// \n /// \n /// \n public static Task Sleep(TimeSpan timeSpan)\n => Task.Delay(timeSpan);\n\n /// \n /// Sleeps for the specified time.\n /// \n /// \n /// \n public static Task Sleep(int seconds)\n => Task.Delay(TimeSpan.FromSeconds(seconds));\n\n /// \n /// Get the task to ignore the exception and return .\n /// \n /// \n /// \n public static Task NoThrow(ProcessTask task)\n => task.NoThrow();\n\n /// \n /// Terminates the current process with specified exit code.\n /// \n /// \n public static void Exit(int exitCode = 0)\n => Environment.Exit(exitCode);\n\n /// \n /// Creates a new directory and any necessary sub-directories in the specified path.\n /// \n /// \n public static void Mkdirp(string path)\n => Directory.CreateDirectory(path);\n\n /// \n /// Fetches the content of the specified URL using GET method.\n /// \n /// \n /// \n /// \n public static Task FetchAsync(string requestUri, CancellationToken cancellationToken = default)\n {\n CommandLineHelper.WriteCommandLineToConsole(ChellEnvironment.Current.Console, $\"{nameof(FetchAsync)} {requestUri}\");\n var httpClient = new HttpClient();\n return httpClient.SendAsync(new HttpRequestMessage(HttpMethod.Get, requestUri), cancellationToken);\n }\n\n /// \n /// Fetches the content of the specified URL as string using GET method.\n /// \n /// \n /// \n /// \n public static async Task FetchStringAsync(string requestUri, CancellationToken cancellationToken = default)\n {\n CommandLineHelper.WriteCommandLineToConsole(ChellEnvironment.Current.Console, $\"{nameof(FetchStringAsync)} {requestUri}\");\n var httpClient = new HttpClient();\n var res = await httpClient.SendAsync(new HttpRequestMessage(HttpMethod.Get, requestUri), cancellationToken);\n res.EnsureSuccessStatusCode();\n\n#if NET5_0_OR_GREATER\n return await res.Content.ReadAsStringAsync(cancellationToken);\n#else\n return await res.Content.ReadAsStringAsync();\n#endif\n }\n\n /// \n /// Fetches the content of the specified URL as byte[] using GET method.\n /// \n /// \n /// \n /// \n public static async Task FetchByteArrayAsync(string requestUri, CancellationToken cancellationToken = default)\n {\n CommandLineHelper.WriteCommandLineToConsole(ChellEnvironment.Current.Console, $\"{nameof(FetchByteArrayAsync)} {requestUri}\");\n var httpClient = new HttpClient();\n var res = await httpClient.SendAsync(new HttpRequestMessage(HttpMethod.Get, requestUri), cancellationToken);\n res.EnsureSuccessStatusCode();\n\n#if NET5_0_OR_GREATER\n return await res.Content.ReadAsByteArrayAsync(cancellationToken);\n#else\n return await res.Content.ReadAsByteArrayAsync();\n#endif\n }\n\n /// \n /// Fetches the content of the specified URL as Stream using GET method.\n /// \n /// \n /// \n /// \n public static async Task FetchStreamAsync(string requestUri, CancellationToken cancellationToken = default)\n {\n CommandLineHelper.WriteCommandLineToConsole(ChellEnvironment.Current.Console, $\"{nameof(FetchStreamAsync)} {requestUri}\");\n var httpClient = new HttpClient();\n var res = await httpClient.SendAsync(new HttpRequestMessage(HttpMethod.Get, requestUri), cancellationToken);\n res.EnsureSuccessStatusCode();\n\n#if NET5_0_OR_GREATER\n return await res.Content.ReadAsStreamAsync(cancellationToken);\n#else\n return await res.Content.ReadAsStreamAsync();\n#endif\n }\n\n /// \n /// Gets the full path to a command, similar to the `which` command on Unix.\n /// \n /// \n /// \n public static string Which(string commandName)\n => Internal.Which.TryGetPath(commandName, out var matchedPath)\n ? matchedPath\n : throw new FileNotFoundException($\"Command '{commandName}' is not found.\");\n\n /// \n /// Gets the full path to a command, similar to the `which` command on Unix.\n /// \n /// \n /// \n /// \n public static bool TryWhich(string commandName, out string matchedPath)\n => Internal.Which.TryGetPath(commandName, out matchedPath);\n\n /// \n /// Enumerates paths under the current directory that match the specified glob pattern.\n /// \n /// \n /// A glob pattern accepts * and ** (e.g. **/*.cs). If the specify a pattern is started with '!', it will be treated as an excluded pattern.\n /// \n /// \n /// \n public static IEnumerable Glob(params string[] patterns)\n => Glob(Environment.CurrentDirectory, patterns);\n\n /// \n /// Enumerates paths under the specified directory that match the specified glob pattern.\n /// \n /// \n /// A glob pattern accepts * and ** (e.g. **/*.cs). If the specify a pattern is started with '!', it will be treated as an excluded pattern.\n /// \n /// \n /// \n /// \n public static IEnumerable Glob(string baseDir, string[] patterns)\n {\n var matcher = new Matcher();\n\n foreach (var pattern in patterns)\n {\n if (pattern.StartsWith(\"!\"))\n {\n matcher.AddExclude(pattern.Substring(1));\n }\n else\n {\n matcher.AddInclude(pattern);\n }\n }\n\n var result = matcher.Execute(new DirectoryInfoWrapper(new DirectoryInfo(baseDir)));\n return result.Files\n .Select(x => Path.GetFullPath(Path.Combine(baseDir, x.Stem))); // NOTE: Microsoft.Extensions.FileSystemGlobbing 5.0.0 does not reflect the root directory in `Path`.\n }\n\n /// \n /// Displays the message and reads lines entered by the user from the console.\n /// \n /// \n /// \n public static async Task Prompt(string message)\n {\n Console.Write(message);\n return await Console.In.ReadLineAsync();\n }\n }\n}\n"
},
{
"path": "src/Chell/Extensions/ChellExtensions.cs",
"content": "using System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Reflection;\nusing System.Text;\nusing System.Threading.Tasks;\nusing Chell.Internal;\n\nnamespace Chell.Extensions\n{\n public static class ChellExtensions\n {\n /// \n /// Writes a object details to the output.\n /// \n /// \n /// \n /// \n public static T Dump(this T value)\n {\n return ObjectDumper.Dump(value);\n }\n\n /// \n /// Writes a object details to the output.\n /// \n /// \n /// \n /// \n public static async Task Dump(this Task task)\n {\n var result = await task.ConfigureAwait(false);\n ObjectDumper.Dump(result);\n return result;\n }\n }\n}\n"
},
{
"path": "src/Chell/Extensions/ProcessOutputExtensions.cs",
"content": "using System.Collections.Generic;\nusing System.Text.Json;\n\nnamespace Chell\n{\n public static class ProcessOutputExtensions\n {\n /// \n /// Enumerates lines by converting them to objects as JSON.\n /// \n /// \n /// Converts to the anonymous type specified in argument.\n /// \n public static IEnumerable AsJsonLines(this ProcessOutput processOutput, T shape, bool skipEmptyLine = true, JsonSerializerOptions? options = null)\n => Chell.Extensions.StringExtensions.AsJsonLines(processOutput.AsLines(), skipEmptyLine, options);\n\n /// \n /// Enumerates lines by converting them to objects as JSON.\n /// \n public static IEnumerable AsJsonLines(this ProcessOutput processOutput, bool skipEmptyLine = true, JsonSerializerOptions? options = null)\n => Chell.Extensions.StringExtensions.AsJsonLines(processOutput.AsLines(), skipEmptyLine, options);\n\n /// \n /// Converts the output string to an object as JSON.\n /// \n /// \n /// Converts to the anonymous type specified in argument.\n /// \n public static T? AsJson(this ProcessOutput processOutput, T shape, JsonSerializerOptions? options = null)\n => AsJson(processOutput, options);\n\n /// \n /// Converts the output string to an object as JSON.\n /// \n public static T? AsJson(this ProcessOutput processOutput, JsonSerializerOptions? options = null)\n => JsonSerializer.Deserialize(processOutput.ToString(), options);\n }\n}"
},
{
"path": "src/Chell/Extensions/ProcessTaskExtensions.Generated.cs",
"content": "/// \nusing System.Threading.Tasks;\n\nnamespace Chell\n{\n public static partial class ProcessTaskExtensions\n {\n public static System.Runtime.CompilerServices.TaskAwaiter<(ProcessOutput Result1, ProcessOutput Result2)> GetAwaiter(this (ProcessTask T1, ProcessTask T2) tasks)\n {\n static async Task<(ProcessOutput Result1, ProcessOutput Result2)> WhenAllAsync(ProcessTask t1, ProcessTask t2)\n {\n var results = await Task.WhenAll(t1, t2).ConfigureAwait(false);\n return (results[0], results[1]);\n }\n return WhenAllAsync(tasks.T1, tasks.T2).GetAwaiter();\n }\n public static System.Runtime.CompilerServices.TaskAwaiter<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3)> GetAwaiter(this (ProcessTask T1, ProcessTask T2, ProcessTask T3) tasks)\n {\n static async Task<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3)> WhenAllAsync(ProcessTask t1, ProcessTask t2, ProcessTask t3)\n {\n var results = await Task.WhenAll(t1, t2, t3).ConfigureAwait(false);\n return (results[0], results[1], results[2]);\n }\n return WhenAllAsync(tasks.T1, tasks.T2, tasks.T3).GetAwaiter();\n }\n public static System.Runtime.CompilerServices.TaskAwaiter<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4)> GetAwaiter(this (ProcessTask T1, ProcessTask T2, ProcessTask T3, ProcessTask T4) tasks)\n {\n static async Task<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4)> WhenAllAsync(ProcessTask t1, ProcessTask t2, ProcessTask t3, ProcessTask t4)\n {\n var results = await Task.WhenAll(t1, t2, t3, t4).ConfigureAwait(false);\n return (results[0], results[1], results[2], results[3]);\n }\n return WhenAllAsync(tasks.T1, tasks.T2, tasks.T3, tasks.T4).GetAwaiter();\n }\n public static System.Runtime.CompilerServices.TaskAwaiter<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4, ProcessOutput Result5)> GetAwaiter(this (ProcessTask T1, ProcessTask T2, ProcessTask T3, ProcessTask T4, ProcessTask T5) tasks)\n {\n static async Task<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4, ProcessOutput Result5)> WhenAllAsync(ProcessTask t1, ProcessTask t2, ProcessTask t3, ProcessTask t4, ProcessTask t5)\n {\n var results = await Task.WhenAll(t1, t2, t3, t4, t5).ConfigureAwait(false);\n return (results[0], results[1], results[2], results[3], results[4]);\n }\n return WhenAllAsync(tasks.T1, tasks.T2, tasks.T3, tasks.T4, tasks.T5).GetAwaiter();\n }\n public static System.Runtime.CompilerServices.TaskAwaiter<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4, ProcessOutput Result5, ProcessOutput Result6)> GetAwaiter(this (ProcessTask T1, ProcessTask T2, ProcessTask T3, ProcessTask T4, ProcessTask T5, ProcessTask T6) tasks)\n {\n static async Task<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4, ProcessOutput Result5, ProcessOutput Result6)> WhenAllAsync(ProcessTask t1, ProcessTask t2, ProcessTask t3, ProcessTask t4, ProcessTask t5, ProcessTask t6)\n {\n var results = await Task.WhenAll(t1, t2, t3, t4, t5, t6).ConfigureAwait(false);\n return (results[0], results[1], results[2], results[3], results[4], results[5]);\n }\n return WhenAllAsync(tasks.T1, tasks.T2, tasks.T3, tasks.T4, tasks.T5, tasks.T6).GetAwaiter();\n }\n public static System.Runtime.CompilerServices.TaskAwaiter<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4, ProcessOutput Result5, ProcessOutput Result6, ProcessOutput Result7)> GetAwaiter(this (ProcessTask T1, ProcessTask T2, ProcessTask T3, ProcessTask T4, ProcessTask T5, ProcessTask T6, ProcessTask T7) tasks)\n {\n static async Task<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4, ProcessOutput Result5, ProcessOutput Result6, ProcessOutput Result7)> WhenAllAsync(ProcessTask t1, ProcessTask t2, ProcessTask t3, ProcessTask t4, ProcessTask t5, ProcessTask t6, ProcessTask t7)\n {\n var results = await Task.WhenAll(t1, t2, t3, t4, t5, t6, t7).ConfigureAwait(false);\n return (results[0], results[1], results[2], results[3], results[4], results[5], results[6]);\n }\n return WhenAllAsync(tasks.T1, tasks.T2, tasks.T3, tasks.T4, tasks.T5, tasks.T6, tasks.T7).GetAwaiter();\n }\n public static System.Runtime.CompilerServices.TaskAwaiter<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4, ProcessOutput Result5, ProcessOutput Result6, ProcessOutput Result7, ProcessOutput Result8)> GetAwaiter(this (ProcessTask T1, ProcessTask T2, ProcessTask T3, ProcessTask T4, ProcessTask T5, ProcessTask T6, ProcessTask T7, ProcessTask T8) tasks)\n {\n static async Task<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4, ProcessOutput Result5, ProcessOutput Result6, ProcessOutput Result7, ProcessOutput Result8)> WhenAllAsync(ProcessTask t1, ProcessTask t2, ProcessTask t3, ProcessTask t4, ProcessTask t5, ProcessTask t6, ProcessTask t7, ProcessTask t8)\n {\n var results = await Task.WhenAll(t1, t2, t3, t4, t5, t6, t7, t8).ConfigureAwait(false);\n return (results[0], results[1], results[2], results[3], results[4], results[5], results[6], results[7]);\n }\n return WhenAllAsync(tasks.T1, tasks.T2, tasks.T3, tasks.T4, tasks.T5, tasks.T6, tasks.T7, tasks.T8).GetAwaiter();\n }\n public static System.Runtime.CompilerServices.TaskAwaiter<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4, ProcessOutput Result5, ProcessOutput Result6, ProcessOutput Result7, ProcessOutput Result8, ProcessOutput Result9)> GetAwaiter(this (ProcessTask T1, ProcessTask T2, ProcessTask T3, ProcessTask T4, ProcessTask T5, ProcessTask T6, ProcessTask T7, ProcessTask T8, ProcessTask T9) tasks)\n {\n static async Task<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4, ProcessOutput Result5, ProcessOutput Result6, ProcessOutput Result7, ProcessOutput Result8, ProcessOutput Result9)> WhenAllAsync(ProcessTask t1, ProcessTask t2, ProcessTask t3, ProcessTask t4, ProcessTask t5, ProcessTask t6, ProcessTask t7, ProcessTask t8, ProcessTask t9)\n {\n var results = await Task.WhenAll(t1, t2, t3, t4, t5, t6, t7, t8, t9).ConfigureAwait(false);\n return (results[0], results[1], results[2], results[3], results[4], results[5], results[6], results[7], results[8]);\n }\n return WhenAllAsync(tasks.T1, tasks.T2, tasks.T3, tasks.T4, tasks.T5, tasks.T6, tasks.T7, tasks.T8, tasks.T9).GetAwaiter();\n }\n public static System.Runtime.CompilerServices.TaskAwaiter<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4, ProcessOutput Result5, ProcessOutput Result6, ProcessOutput Result7, ProcessOutput Result8, ProcessOutput Result9, ProcessOutput Result10)> GetAwaiter(this (ProcessTask T1, ProcessTask T2, ProcessTask T3, ProcessTask T4, ProcessTask T5, ProcessTask T6, ProcessTask T7, ProcessTask T8, ProcessTask T9, ProcessTask T10) tasks)\n {\n static async Task<(ProcessOutput Result1, ProcessOutput Result2, ProcessOutput Result3, ProcessOutput Result4, ProcessOutput Result5, ProcessOutput Result6, ProcessOutput Result7, ProcessOutput Result8, ProcessOutput Result9, ProcessOutput Result10)> WhenAllAsync(ProcessTask t1, ProcessTask t2, ProcessTask t3, ProcessTask t4, ProcessTask t5, ProcessTask t6, ProcessTask t7, ProcessTask t8, ProcessTask t9, ProcessTask t10)\n {\n var results = await Task.WhenAll(t1, t2, t3, t4, t5, t6, t7, t8, t9, t10).ConfigureAwait(false);\n return (results[0], results[1], results[2], results[3], results[4], results[5], results[6], results[7], results[8], results[9]);\n }\n return WhenAllAsync(tasks.T1, tasks.T2, tasks.T3, tasks.T4, tasks.T5, tasks.T6, tasks.T7, tasks.T8, tasks.T9, tasks.T10).GetAwaiter();\n }\n\n }\n}"
},
{
"path": "src/Chell/Extensions/ProcessTaskExtensions.cs",
"content": "using System.Threading.Tasks;\n\nnamespace Chell\n{\n public static partial class ProcessTaskExtensions\n {\n }\n}"
},
{
"path": "src/Chell/Extensions/ProcessTaskExtensions.tt",
"content": "<#@ template debug=\"false\" hostspecific=\"false\" language=\"C#\" #>\n<#@ assembly name=\"System.Core\" #>\n<#@ import namespace=\"System.Linq\" #>\n<#@ import namespace=\"System.Text\" #>\n<#@ import namespace=\"System.Collections.Generic\" #>\n<#@ output extension=\".Generated.cs\" #>\n/// \nusing System.Threading.Tasks;\n\nnamespace Chell\n{\n public static partial class ProcessTaskExtensions\n {\n<# for (var i = 2; i <= 10; i++) {\n var inTuple = string.Join(\", \", Enumerable.Range(1, i).Select(x => $\"ProcessTask T{x}\"));\n var outTuple = string.Join(\", \", Enumerable.Range(1, i).Select(x => $\"ProcessOutput Result{x}\"));\n#>\n public static System.Runtime.CompilerServices.TaskAwaiter<(<#= outTuple #>)> GetAwaiter(this (<#= inTuple #>) tasks)\n {\n static async Task<(<#= outTuple #>)> WhenAllAsync(<#= string.Join(\", \", Enumerable.Range(1, i).Select(x => $\"ProcessTask t{x}\")) #>)\n {\n var results = await Task.WhenAll(<#= string.Join(\", \", Enumerable.Range(1, i).Select(x => $\"t{x}\")) #>).ConfigureAwait(false);\n return (<#= string.Join(\", \", Enumerable.Range(0, i).Select(x => $\"results[{x}]\")) #>);\n }\n return WhenAllAsync(<#= string.Join(\", \", Enumerable.Range(1, i).Select(x => $\"tasks.T{x}\")) #>).GetAwaiter();\n }\n<# } #>\n\n }\n}"
},
{
"path": "src/Chell/Extensions/StringExtensions.cs",
"content": "using System;\nusing System.Collections.Generic;\nusing System.Linq;\nusing System.Text;\nusing System.Text.Json;\nusing System.Threading.Tasks;\n\nnamespace Chell.Extensions\n{\n public static class StringExtensions\n {\n /// \n /// Enumerates lines by converting them to objects as JSON.\n /// \n /// \n /// Converts to the anonymous type specified in argument.\n /// \n public static IEnumerable AsJsonLines(this IEnumerable lines, T shape, bool skipEmptyLine = true, JsonSerializerOptions? options = null)\n {\n return AsJsonLines(lines, skipEmptyLine, options);\n }\n\n /// \n /// Enumerates lines by converting them to objects as JSON.\n /// \n public static IEnumerable AsJsonLines(this IEnumerable lines, bool skipEmptyLine = true, JsonSerializerOptions? options = null)\n {\n return lines.Where(x => !skipEmptyLine || !string.IsNullOrWhiteSpace(x)).Select(x => JsonSerializer.Deserialize(x, options));\n }\n\n /// \n /// Converts the output string to an object as JSON.\n /// \n /// \n /// Converts to the anonymous type specified in argument.\n /// \n public static T? AsJson(this string json, T shape, JsonSerializerOptions? options = null)\n => AsJson(json, options);\n\n /// \n /// Converts the output string to an object as JSON.\n /// \n public static T? AsJson(this string json, JsonSerializerOptions? options = null)\n => JsonSerializer.Deserialize(json.ToString(), options);\n }\n}\n"
},
{
"path": "src/Chell/IO/ChellWrappedStream.cs",
"content": "using System;\nusing System.Buffers;\nusing System.Collections.Generic;\nusing System.IO;\nusing System.Linq;\nusing System.Text;\nusing System.Threading;\nusing System.Threading.Tasks;\n\nnamespace Chell.IO\n{\n public partial class ChellWritableStream : ChellWrappedStream\n {\n private readonly StreamWriter _writer;\n\n public ChellWritableStream(Stream baseStream, Encoding encoding)\n : base(baseStream)\n {\n _writer = new StreamWriter(baseStream, encoding);\n _writer.AutoFlush = true;\n }\n\n public void Write(byte[] value) => BaseStream.Write(value);\n public new void Write(ReadOnlySpan value) => BaseStream.Write(value);\n public ValueTask WriteAsync(byte[] value, CancellationToken cancellationToken = default) => BaseStream.WriteAsync(value, cancellationToken);\n public new ValueTask WriteAsync(ReadOnlyMemory value, CancellationToken cancellationToken = default) => BaseStream.WriteAsync(value, cancellationToken);\n\n protected override void Dispose(bool disposing)\n {\n _writer.Dispose();\n base.Dispose(disposing);\n }\n\n public override async ValueTask DisposeAsync()\n {\n await _writer.DisposeAsync();\n await base.DisposeAsync();\n }\n }\n\n public partial class ChellReadableStream : ChellWrappedStream\n {\n private readonly StreamReader _reader;\n\n public ChellReadableStream(Stream baseStream, Encoding encoding)\n : base(baseStream)\n {\n _reader = new StreamReader(baseStream, encoding);\n }\n\n public async Task ReadAllBytesAsync(CancellationToken cancellationToken = default)\n {\n var bufferWriter = new ArrayBufferWriter();\n while (true)\n {\n cancellationToken.ThrowIfCancellationRequested();\n var readLen = await BaseStream.ReadAsync(bufferWriter.GetMemory(1024 * 32), cancellationToken);\n if (readLen == 0)\n {\n return bufferWriter.WrittenMemory.ToArray();\n }\n bufferWriter.Advance(readLen);\n }\n }\n\n public byte[] ReadAllBytes()\n {\n var bufferWriter = new ArrayBufferWriter();\n while (true)\n {\n var readLen = BaseStream.Read(bufferWriter.GetSpan(1024 * 32));\n if (readLen == 0)\n {\n return bufferWriter.WrittenMemory.ToArray();\n }\n bufferWriter.Advance(readLen);\n }\n }\n\n public async Task ReadToEndAsync()\n {\n return await _reader.ReadToEndAsync();\n }\n\n public string ReadToEnd()\n {\n return _reader.ReadToEnd();\n }\n\n public IEnumerable ReadAllLines()\n {\n while (!_reader.EndOfStream)\n {\n var line = _reader.ReadLine();\n if (line is null) yield break;\n\n yield return line;\n }\n }\n\n public async IAsyncEnumerable ReadAllLinesAsync()\n {\n while (!_reader.EndOfStream)\n {\n var line = await _reader.ReadLineAsync();\n if (line is null) yield break;\n\n yield return line;\n }\n }\n\n protected override void Dispose(bool disposing)\n {\n _reader.Dispose();\n base.Dispose(disposing);\n }\n }\n\n public abstract class ChellWrappedStream : Stream\n {\n private readonly Stream _baseStream;\n\n protected Stream BaseStream => _baseStream;\n\n protected ChellWrappedStream(Stream baseStream)\n {\n _baseStream = baseStream;\n }\n\n #region Stream Implementation\n public override void Flush()\n {\n _baseStream.Flush();\n }\n\n public override int Read(byte[] buffer, int offset, int count)\n {\n return _baseStream.Read(buffer, offset, count);\n }\n\n public override int Read(Span buffer)\n {\n return _baseStream.Read(buffer);\n }\n\n public override Task ReadAsync(byte[] buffer, int offset, int count, CancellationToken cancellationToken)\n {\n return _baseStream.ReadAsync(buffer, offset, count, cancellationToken);\n }\n\n public override ValueTask ReadAsync(Memory buffer, CancellationToken cancellationToken = new CancellationToken())\n {\n return _baseStream.ReadAsync(buffer, cancellationToken);\n }\n\n public override long Seek(long offset, SeekOrigin origin)\n {\n return _baseStream.Seek(offset, origin);\n }\n\n public override void SetLength(long value)\n {\n _baseStream.SetLength(value);\n }\n\n public override void Write(byte[] buffer, int offset, int count)\n {\n _baseStream.Write(buffer, offset, count);\n }\n\n public override void Write(ReadOnlySpan buffer)\n {\n _baseStream.Write(buffer);\n }\n\n public override Task WriteAsync(byte[] buffer, int offset, int count, CancellationToken cancellationToken)\n {\n return _baseStream.WriteAsync(buffer, offset, count, cancellationToken);\n }\n\n public override ValueTask WriteAsync(ReadOnlyMemory buffer, CancellationToken cancellationToken = new CancellationToken())\n {\n return _baseStream.WriteAsync(buffer, cancellationToken);\n }\n\n public override bool CanRead => _baseStream.CanRead;\n\n public override bool CanSeek => _baseStream.CanSeek;\n\n public override bool CanWrite => _baseStream.CanWrite;\n\n public override long Length => _baseStream.Length;\n\n public override long Position\n {\n get => _baseStream.Position;\n set => _baseStream.Position = value;\n }\n #endregion\n }\n}\n"
},
{
"path": "src/Chell/IO/ChellWritableStream.Generated.cs",
"content": "#nullable enable\n/// \nusing System;\nusing System.IO;\nusing System.Threading.Tasks;\n\nnamespace Chell.IO\n{\n public partial class ChellWritableStream\n {\n public void Write(string? value) => _writer.Write(value);\n public void WriteLine(string? value) => _writer.WriteLine(value);\n public Task WriteAsync(string? value) => _writer.WriteAsync(value);\n public Task WriteLineAsync(string? value) => _writer.WriteLineAsync(value);\n public void Write(char value) => _writer.Write(value);\n public void WriteLine(char value) => _writer.WriteLine(value);\n public Task WriteAsync(char value) => _writer.WriteAsync(value);\n public Task WriteLineAsync(char value) => _writer.WriteLineAsync(value);\n public void Write(char[]? value) => _writer.Write(value);\n public void WriteLine(char[]? value) => _writer.WriteLine(value);\n public Task WriteAsync(char[]? value) => _writer.WriteAsync(value);\n public Task WriteLineAsync(char[]? value) => _writer.WriteLineAsync(value);\n public void Write(object? value) => _writer.Write(value);\n public void WriteLine(object? value) => _writer.WriteLine(value);\n public void Write(double value) => _writer.Write(value);\n public void WriteLine(double value) => _writer.WriteLine(value);\n public void Write(float value) => _writer.Write(value);\n public void WriteLine(float value) => _writer.WriteLine(value);\n public void Write(long value) => _writer.Write(value);\n public void WriteLine(long value) => _writer.WriteLine(value);\n public void Write(int value) => _writer.Write(value);\n public void WriteLine(int value) => _writer.WriteLine(value);\n public void Write(ReadOnlySpan value) => _writer.Write(value);\n public void WriteLine(ReadOnlySpan value) => _writer.WriteLine(value);\n public Task WriteAsync(ReadOnlyMemory value) => _writer.WriteAsync(value);\n public Task WriteLineAsync(ReadOnlyMemory value) => _writer.WriteLineAsync(value);\n }\n}"
},
{
"path": "src/Chell/IO/ChellWritableStream.tt",
"content": "<#@ template debug=\"false\" hostspecific=\"false\" language=\"C#\" #>\n<#@ assembly name=\"System.Core\" #>\n<#@ import namespace=\"System.Linq\" #>\n<#@ import namespace=\"System.Text\" #>\n<#@ import namespace=\"System.Collections.Generic\" #>\n<#@ output extension=\".Generated.cs\" #>\n<#\nvar types = new []\n{\n (0, \"string?\"),\n (0, \"char\"),\n (0, \"char[]?\"),\n (1, \"object?\"),\n (1, \"double\"),\n (1, \"float\"),\n (1, \"long\"),\n (1, \"int\"),\n (1, \"ReadOnlySpan\"),\n (2, \"ReadOnlyMemory\"),\n};\n#>\n#nullable enable\n/// \nusing System;\nusing System.IO;\nusing System.Threading.Tasks;\n\nnamespace Chell.IO\n{\n public partial class ChellWritableStream\n {\n<# foreach (var (target, type) in types) { #>\n<# if (target == 0 || target == 1) { #>\n public void Write(<#= type #> value) => _writer.Write(value);\n public void WriteLine(<#= type #> value) => _writer.WriteLine(value);\n<# } #>\n<# if (target == 0 || target == 2) { #>\n public Task WriteAsync(<#= type #> value) => _writer.WriteAsync(value);\n public Task WriteLineAsync(<#= type #> value) => _writer.WriteLineAsync(value);\n<# } #>\n<# } #>\n }\n}"
},
{
"path": "src/Chell/IO/IConsoleProvider.cs",
"content": "using System.Collections.Generic;\nusing System.IO;\nusing System.Text;\n\nnamespace Chell.IO\n{\n public interface IConsoleProvider\n {\n Stream OpenStandardInput();\n Stream OpenStandardOutput();\n Stream OpenStandardError();\n Encoding InputEncoding { get; }\n Encoding OutputEncoding { get; }\n bool IsInputRedirected { get; }\n bool IsOutputRedirected { get; }\n bool IsErrorRedirected { get; }\n\n TextWriter Out { get; }\n TextWriter Error { get; }\n }\n}\n"
},
{
"path": "src/Chell/IO/LINQPadConsoleProvider.cs",
"content": "using System;\nusing System.Buffers;\nusing System.Collections.Generic;\nusing System.IO;\nusing System.IO.Pipelines;\nusing System.Text;\nusing System.Threading.Tasks;\n\nnamespace Chell.IO\n{\n public class LINQPadConsoleProvider : IConsoleProvider\n {\n private readonly Pipe _pipe;\n\n public Encoding InputEncoding => Console.InputEncoding;\n public Encoding OutputEncoding => Console.OutputEncoding;\n public bool IsInputRedirected => Console.IsInputRedirected;\n public bool IsOutputRedirected => Console.IsOutputRedirected;\n public bool IsErrorRedirected => Console.IsErrorRedirected;\n\n public TextWriter Out { get; }\n public TextWriter Error { get; }\n\n public LINQPadConsoleProvider()\n {\n _pipe = new Pipe();\n Out = new PipeTextWriter(_pipe.Writer, OutputEncoding);\n Error = new PipeTextWriter(_pipe.Writer, OutputEncoding);\n\n var reader = new StreamReader(_pipe.Reader.AsStream());\n _ = Task.Run(async () =>\n {\n Memory buffer = new char[1024];\n while (true)\n {\n var read = await reader.ReadAsync(buffer, default);\n if (read != 0)\n {\n Console.Out.Write(buffer.Span.Slice(0, read));\n }\n }\n });\n }\n\n public Stream OpenStandardInput()\n => Console.OpenStandardInput();\n\n public Stream OpenStandardOutput()\n => _pipe.Writer.AsStream(leaveOpen: true);\n\n public Stream OpenStandardError()\n => _pipe.Writer.AsStream(leaveOpen: true);\n\n private class PipeTextWriter : TextWriter\n {\n private readonly PipeWriter _writer;\n public override Encoding Encoding { get; }\n\n public PipeTextWriter(PipeWriter writer, Encoding encoding)\n {\n _writer = writer;\n Encoding = encoding;\n }\n\n public override void Write(char value)\n {\n Span buffer = stackalloc byte[4];\n Span c = stackalloc char[1];\n c[0] = value;\n\n var written = Encoding.GetBytes(c, buffer);\n _writer.Write(buffer.Slice(0, written));\n _ = _writer.FlushAsync();\n }\n }\n }\n}\n"
},
{
"path": "src/Chell/IO/SystemConsoleProvider.cs",
"content": "using System;\nusing System.IO;\nusing System.Text;\n\nnamespace Chell.IO\n{\n /// \n /// Encapsulates console intrinsic members as object.\n /// \n public sealed class SystemConsoleProvider : IConsoleProvider\n {\n public static IConsoleProvider Instance { get; } = new SystemConsoleProvider();\n\n private SystemConsoleProvider()\n {}\n\n public Stream OpenStandardInput()\n => Console.OpenStandardInput();\n\n public Stream OpenStandardOutput()\n => Console.OpenStandardOutput();\n\n public Stream OpenStandardError()\n => Console.OpenStandardError();\n\n public Encoding InputEncoding => Console.InputEncoding;\n public Encoding OutputEncoding => Console.OutputEncoding;\n\n public bool IsInputRedirected => Console.IsInputRedirected;\n public bool IsOutputRedirected => Console.IsOutputRedirected;\n public bool IsErrorRedirected => Console.IsErrorRedirected;\n\n public TextWriter Out => Console.Out;\n public TextWriter Error => Console.Error;\n }\n}\n"
},
{
"path": "src/Chell/Internal/CommandLineHelper.cs",
"content": "using System;\nusing System.Collections;\nusing System.Linq;\nusing Chell.IO;\nusing Chell.Shell;\nusing Kokuban;\n\n// ReSharper disable CoVariantArrayConversion\n\nnamespace Chell.Internal\n{\n internal class CommandLineHelper\n {\n public static void WriteCommandLineToConsole(IConsoleProvider console, string commandLine, ChellVerbosity? verbosity = default)\n {\n verbosity ??= ChellEnvironment.Current.Verbosity;\n if (verbosity.Value.HasFlag(ChellVerbosity.CommandLine))\n {\n var parts = commandLine.Split(' ', 2);\n if (LINQPadHelper.RunningOnLINQPad)\n {\n LINQPadHelper.WriteRawHtml(\n $\"$ {EscapeHtml(parts[0])}{EscapeHtml((parts.Length > 1 ? \" \" + parts[1] : string.Empty))}\");\n }\n else\n {\n console.Out.WriteLine(\"$ \" + (Chalk.BrightGreen + parts[0]) + (parts.Length > 1 ? \" \" + parts[1] : string.Empty));\n }\n }\n\n static string EscapeHtml(string s)\n => s.Replace(\"&\", \"&\").Replace(\"\\\"\", \""\").Replace(\"<\", \">\");\n }\n\n public static string Expand(FormattableString commandLine, IShellExecutor shellExecutor)\n {\n return string.Format(commandLine.Format.Trim(), commandLine.GetArguments().Select(x =>\n {\n return x switch\n {\n ProcessOutput procOutput => shellExecutor.Escape(procOutput.Output.TrimEnd('\\n')),\n string s => shellExecutor.Escape(s),\n IEnumerable enumerable => string.Join(\" \", enumerable.OfType