parol 4.5.0

LL(k) and LALR(1) parser generator for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

<#
.SYNOPSIS
This script synchronizes README files with the CommonReadMe.md.

.DESCRIPTION
This script inserts the content of the CommonReadMe.md into the two README files in
    * crates/parol/README.md
    * README.md

.PARAMETER ParameterName
The script takes no parameters.

.INPUTS
No input objects are needed.

.OUTPUTS
The script does not return any output.

.EXAMPLE
./crates/parol/sync_readmes.ps1
Runs the script from the root of the repository.

.NOTES
I wrote this script because I wanted to have a common README file for the crate and the repository.
The crate README file is located in the crates/parol/README.md file and the repository README file
is located in the README.md file.
Unfortunately there is no include directive available in Markdown, so I had to write this script to
synchronize the two files.
#>


$scriptPath = [System.IO.Path]::GetDirectoryName($MyInvocation.MyCommand.Path)
$filePath = [System.IO.Path]::Combine($scriptPath, "CommonReadMe.md")

$nl = [Environment]::NewLine

$commonContentTemplate = Get-Content $filePath -Raw -Encoding UTF8

$repoSupplementPath = [System.IO.Path]::Combine($scriptPath, "RepositoryReadMeSupplement.md")
$repoSupplement = if (Test-Path $repoSupplementPath) {
    (Get-Content $repoSupplementPath -Raw -Encoding UTF8).Trim()
}
else {
    ""
}

$repoSupplementMarker = "<!-- REPO_README_SUPPLEMENT -->"
$crateContent = $commonContentTemplate.Replace($repoSupplementMarker + $nl, "")
$repoContent = if ([string]::IsNullOrWhiteSpace($repoSupplement)) {
    $commonContentTemplate.Replace($repoSupplementMarker + $nl, "")
}
else {
    $commonContentTemplate.Replace($repoSupplementMarker, $repoSupplement)
}

# CommonReadMe uses crate-local links. Rewrite them for the repository README.
$repoContent = $repoContent.Replace("(../../book/src/ExportModelContract.md)", "(./book/src/ExportModelContract.md)")
$repoContent = $repoContent.Replace("(./schemas/parser-export-model.v2.schema.json)", "(./crates/parol/schemas/parser-export-model.v2.schema.json)")

$startPattern = "Unfortunately there is no include directive available in Markdown -->"

$crateCommonContent = $startPattern + $nl + $nl + $crateContent
$repoCommonContent = $startPattern + $nl + $nl + $repoContent

$crateReadme = [System.IO.Path]::Combine($scriptPath, "README.md")
$repoReadme = [System.IO.Path]::Combine($scriptPath, "..", "..", "README.md")

function takeWhile {
    param (
        [Parameter(Mandatory = $true, ValueFromPipeline = $true)]
        [object[]]$InputObject,
        [Parameter(Mandatory = $true)]
        [scriptblock]$Predicate
    )

    begin {
        $found = $false
    }

    process {
        if (!$found) {
            if (& $Predicate $_) {
                $_
            }
            else {
                $found = $true
            }
        }
    }
}

@(@{ Path = $crateReadme; Content = $crateCommonContent }, @{ Path = $repoReadme; Content = $repoCommonContent }) | ForEach-Object {
    $readmeContent = Get-Content $_.Path  | takeWhile -Predicate { $_ -ne $startPattern }
    
    Set-Content $_.Path $readmeContent -Encoding UTF8
    Add-Content $_.Path $_.Content -Encoding UTF8
}