Merge pull request #1621 from EvilBeaver/feture/publish-dev

публикация rc.9

Author: EvilBeaver

.cursor/rules/langversion.mdc

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+---
+
+Проект использует .net 8.0 и LangVersion 8, поэтому при генерации кода не используй языковые фичи C#, которые отсутствуют в C# 8.

.cursor/rules/runbsltests.mdc

@@ -0,0 +1,34 @@
+---
+description: When you need to run main tests
+alwaysApply: false
+---
+
+Когда тебе потребуется запустить приемочные тесты всего проекта, убедиться что ничего не сломано, тебе потребуется запустить bsl тесты. Для этого используются готовые скрипты:
+
+1. **ОБЯЗАТЕЛЬНО** собери консольное приложение oscript из исходников с последними изменениями:
+   
+   ```
+   dotnet build src/oscript/oscript.csproj
+   ```
+   
+   После сборки движок будет находиться здесь:
+   - Windows: `src\oscript\bin\Debug\net8.0\oscript.exe`
+   - Linux/macOS: `src/oscript/bin/Debug/net8.0/oscript`
+   
+   **КРИТИЧЕСКИ ВАЖНО**: Тесты должны запускаться только на свежесобранном oscript, а не на версии из системы! Это гарантирует, что тесты валидируют актуальный код после внесённых изменений.
+
+2. Запусти нужный скрипт, **ЯВНО** передав путь к свежесобранному движку:
+   - Windows: `tests\run-bsl-tests.cmd src\oscript\bin\Debug\net8.0\oscript.exe`
+   - Linux/macOS: `tests/run-bsl-tests.sh src/oscript/bin/Debug/net8.0/oscript`
+   
+   **ВАЖНО**: Не полагайся на автоматический поиск oscript в PATH — всегда указывай путь к свежесобранному бинарнику первым параметром!
+   
+   Оба скрипта автоматически:
+   - Устанавливают путь к библиотекам OVM через переменную `OVM_LIB_PATH` (по умолчанию `%USERPROFILE%\AppData\Local\ovm\current\lib` для Windows и `$HOME/.local/share/ovm/current/lib` для Linux/macOS)
+   - Настраивают `OSCRIPT_CONFIG=lib.system=<OVM_LIB_PATH>`, если эта переменная не была задана заранее
+   - Переходят в каталог `tests` и выполняют `testrunner.os -runAll .`
+
+3. Для запуска одного теста также используй свежесобранный oscript.exe: `<путь\к\собранному\oscript.exe> testrunner.os -run <имя файла теста.os>`.
+4. Всегда используй для запуска тестов новую консоль, не переиспользуй консоль от предыдущих запусков.
+5. Если ошибка запуска тестов связана с Component.dll или NativeApi (эти dll упоминаются в ошибках тестов), то такие тесты следует игнорировать и смотреть только на другие ошибки тестов.
+6. Ошибки теста http.os и "Тест_ДолженПроверитьЧтоПеремещениеФайлаРаботаетПоHTTP" следует игнорировать.

.github/workflows/copilot-setup-steps.yml

@@ -17,13 +17,13 @@ jobs:
     # Setup steps for OneScript development environment
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - run: git config --global core.quotepath false
 
-      - uses: actions/setup-dotnet@v4
+      - uses: actions/setup-dotnet@v5
         with:
-          dotnet-version: '6.0.x'
+          dotnet-version: '8.0.x'
 
       - name: Установка OneScript
         uses: otymko/[email protected]

.github/workflows/rebase.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout the latest code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           fetch-depth: 0 # otherwise, you will fail to push refs to dest repo

.github/workflows/sonar.yml

@@ -11,11 +11,11 @@ jobs:
     if: (github.repository == 'EvilBeaver/OneScript' ) && (github.event_name == 'push' || github.event.pull_request.head.repo.full_name == github.event.repository.full_name)
     steps:
       - name: Set up JDK 17
-        uses: actions/setup-java@v4
+        uses: actions/setup-java@v5
         with:
           java-version: 17
           distribution: temurin
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0  # Shallow clones should be disabled for a better relevancy of analysis
       - name: Cache SonarQube packages

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "dotnet.defaultSolution": "src/1Script.sln"
+}

Build.csproj

@@ -14,6 +14,8 @@
         <Configuration>Release</Configuration>
         <Solution>$(MSBuildProjectDirectory)/src/1Script.sln</Solution>
 
+        <ActiveFramework>net8.0</ActiveFramework>
+        
     </PropertyGroup>
 
     <ItemGroup>
@@ -30,11 +32,11 @@
     <ItemGroup>
         <PublishProjects Include="oscript">
             <ProjectFile>oscript.csproj</ProjectFile>
-            <Framework>net6.0</Framework>
+            <Framework>$(ActiveFramework)</Framework>
         </PublishProjects>
         <PublishProjects Include="TestApp">
             <ProjectFile>TestApp.csproj</ProjectFile>
-            <Framework>net6.0-windows</Framework>
+            <Framework>$(ActiveFramework)-windows</Framework>
         </PublishProjects>
     </ItemGroup>
 
@@ -106,7 +108,7 @@
         </ItemGroup>
 
         <Exec Command="dotnet publish &quot;src/oscript/oscript.csproj&quot; -r %(RuntimeID.Identity) --self-contained -c $(Configuration) -o &quot;$(ArtifactsRoot)/%(RuntimeID.Identity)/bin&quot;" UseUtf8Encoding="Always"/>
-        <Exec Command="dotnet publish &quot;src/TestApp/TestApp.csproj&quot; -f net6.0-windows -c $(Configuration) -p:Platform=%(PlatformItem.MSBuildName) -p:UseAppHost=true -o &quot;$(ArtifactsRoot)/win-%(PlatformItem.Identity)/bin&quot;" UseUtf8Encoding="Always"/>
+        <Exec Command="dotnet publish &quot;src/TestApp/TestApp.csproj&quot; -f $(ActiveFramework)-windows -c $(Configuration) -p:Platform=%(PlatformItem.MSBuildName) -p:UseAppHost=true -o &quot;$(ArtifactsRoot)/win-%(PlatformItem.Identity)/bin&quot;" UseUtf8Encoding="Always"/>
 
         <PropertyGroup>
             <CppBinPrefix>$(MSBuildProjectDirectory)/src/ScriptEngine.NativeApi/bin/$(Configuration)</CppBinPrefix>
@@ -162,11 +164,9 @@
     </Target>
 
     <Target Name="BuildWithCpp" DependsOnTargets="CleanAll;MakeCPP;MakeFDD;MakeSCD;BuildDebugger">
-        <CallTarget Targets="CleanIntermediates"/>
     </Target>
 
     <Target Name="BuildWithoutCpp" DependsOnTargets="CleanAll;MakeFDD;MakeSCD;BuildDebugger">
-        <CallTarget Targets="CleanIntermediates"/>
     </Target>
 
     <!-- Используется для поиска первого собранного oscript.exe -->
@@ -225,7 +225,7 @@
 
     </Target>
 
-    <Target Name="ComposeDistributionFolders">
+    <Target Name="ComposeDistributionFolders" DependsOnTargets="CleanIntermediates">
         <ItemGroup>
             <TargetDir Include="fdd-x64"/>
             <TargetDir Include="fdd-x86"/>
@@ -261,7 +261,7 @@
         <Delete Files="@(TempFiles)"/>
     </Target>
 
-	<Target Name="PrepareDistributionFiles" DependsOnTargets="CleanAll;BuildAll;GatherLibrary;ComposeDistributionFolders"/>
+	<Target Name="PrepareDistributionFiles" DependsOnTargets="CleanAll;BuildAll;GatherLibrary;BuildDocumentation;ComposeDistributionFolders"/>
 
     <Target Name="Test">
         <CallTarget Targets="UnitTests;ScriptedTests" />
@@ -373,5 +373,35 @@
             Command="dotnet nuget push %(NugetAbleProject.Identity) -k $(NugetToken) -s https://api.nuget.org/v3/index.json" UseUtf8Encoding="Always"/>
 
     </Target>
+
+    <Target Name="BuildDocumenter">
+        <Exec Command="dotnet publish &quot;$(MSBuildProjectDirectory)/src/OneScriptDocumenter/OneScriptDocumenter.csproj&quot; -c Release -o &quot;$(ArtifactsRoot)/tools/documenter&quot;" UseUtf8Encoding="Always"/>
+    </Target>
+    
+    <Target Name="BuildDocumentation" DependsOnTargets="MakeSCD;BuildDocumenter">
+        <PropertyGroup>
+            <DocInputDir>$(ArtifactsRoot)/win-x64/bin</DocInputDir>
+            <DocsRoot>$(ArtifactsRoot)/docs</DocsRoot>
+            <DocumenterToolDir>$(ArtifactsRoot)/tools/documenter</DocumenterToolDir>
+        </PropertyGroup>
+        <ItemGroup>
+            <DocAssemblies Include="$(DocInputDir)/ScriptEngine.HostedScript.dll"/>
+            <DocAssemblies Include="$(DocInputDir)/ScriptEngine.dll"/>
+            <DocAssemblies Include="$(DocInputDir)/OneScript.StandardLibrary.dll"/>
+            <DocAssemblies Include="$(DocInputDir)/OneScript.Web.Server.dll"/>
+            <DocAssemblies Include="$(DocInputDir)/oscript.dll"/>
+        </ItemGroup>
+
+        <Error Condition="'@(DocAssemblies)' == ''" Text="No input assemblies found in $(DocInputDir) for documentation generation" />
+        
+        <MakeDir Directories="$(DocsRoot)"/>
+        <MakeDir Directories="$(DocsRoot)/markdown"/>
+        <MakeDir Directories="$(DocsRoot)/json"/>
+        <Exec Command="dotnet &quot;$(DocumenterToolDir)/OneScriptDocumenter.dll&quot; @(DocAssemblies->'%(FullPath)', ' ') -t &quot;$(MSBuildProjectDirectory)/src/OneScriptDocumenter/default_toc.json&quot; -m &quot;$(DocsRoot)/markdown&quot; -j &quot;$(DocsRoot)/json/syntax-helper.json&quot;" UseUtf8Encoding="Always"/>
+        
+        <RemoveDir Directories="$(DocumenterToolDir)" Condition="Exists($(DocumenterToolDir))"/>
+        
+    </Target>
 
+
 </Project>

Jenkinsfile

@@ -5,7 +5,7 @@ pipeline {
 
     environment {
         VersionPrefix = '2.0.0'
-        VersionSuffix = 'rc.8'
+        VersionSuffix = 'rc.9'
         outputEnc = '65001'
     }
 
@@ -199,8 +199,9 @@ pipeline {
         }
 
         stage ('Publishing night-build') {
-            when { anyOf {
-                branch 'develop';
+            when { 
+                anyOf {
+                    branch 'develop';
                 }
             }
             agent { label 'master' }
@@ -217,8 +218,9 @@ pipeline {
         }
 
         stage ('Publishing preview') {
-            when { anyOf {
-                branch 'release/preview';
+            when { 
+                anyOf {
+                    branch 'release/preview';
                 }
             }
             agent { label 'master' }
@@ -257,6 +259,46 @@ pipeline {
                 }
             }
         }
+
+        stage ('Publishing docker-images') {
+            parallel {
+                stage('Build v1') {
+                    agent { label 'linux' }
+                    when { 
+                        anyOf {
+                            branch 'release/latest'
+                            expression { 
+                                return env.TAG_NAME && env.TAG_NAME.startsWith('v1.')
+                            }
+                        }
+                    }
+                    steps {
+                        script {
+                            def codename = env.TAG_NAME ? env.TAG_NAME : 'latest'
+                            publishDockerImage('v1', codename)
+                        }
+                    }
+                }
+
+                stage('Build v2') {
+                    agent { label 'linux' }
+                    when { 
+                        anyOf {
+                            branch 'develop'
+                            expression { 
+                                return env.TAG_NAME && env.TAG_NAME.startsWith('v2.')
+                            }
+                        }
+                    }
+                    steps {
+                        script {
+                            def codename = env.TAG_NAME ? env.TAG_NAME : 'dev'
+                            publishDockerImage('v2', codename)
+                        }
+                    }
+                }
+            }
+        }
     }
 }
 
@@ -300,3 +342,12 @@ def publishReleaseNotes(codename) {
     }
 }
 
+def publishDockerImage(flavour, codename) {
+    def imageName = "evilbeaver/onescript:${codename}"
+
+    docker.build(
+        imageName,
+        "--load -f install/builders/base-image/Dockerfile_${flavour} ."
+    ).push()
+}
+