Compare commits
	
		
			5 Commits
		
	
	
		
			v1.1.0
			...
			74a724c287
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
| 74a724c287 | |||
| 6c3889d2a0 | |||
| dcaa4a7365 | |||
| 3e48f9c97c | |||
| 8402546cf8 | 
							
								
								
									
										90
									
								
								README.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										90
									
								
								README.md
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,90 @@ | |||||||
|  | <h1>SpyglassMC Action</h1> | ||||||
|  |  | ||||||
|  | This action lets you validate your Minecraft datapack using [SpyglassMC](https://spyglassmc.com/). | ||||||
|  | All JSON and MCFunction files are checked for syntax errors. | ||||||
|  |  | ||||||
|  | <details> | ||||||
|  | <summary><strong>Table of Contents</strong></summary> | ||||||
|  |  | ||||||
|  | --- | ||||||
|  | - [Basic workflow](#basic-workflow) | ||||||
|  | - [Input parameters](#input-parameters) | ||||||
|  | - [GitHub vs. Gitea](#github-vs-gitea) | ||||||
|  |   - [Gitea](#gitea) | ||||||
|  |   - [GitHub](#github) | ||||||
|  | --- | ||||||
|  |  | ||||||
|  | </details> | ||||||
|  |  | ||||||
|  |  | ||||||
|  | ## Basic workflow | ||||||
|  | Here is a simple example showing how to use this action: | ||||||
|  |  | ||||||
|  | ```yaml | ||||||
|  | name: Check datapack | ||||||
|  | on: | ||||||
|  |   pull_request: | ||||||
|  |     branches: | ||||||
|  |       - main | ||||||
|  | jobs: | ||||||
|  |   check: | ||||||
|  |     runs-on: ubuntu-latest | ||||||
|  |     steps: | ||||||
|  |       - name: Checkout code | ||||||
|  |         uses: actions/checkout@v4 | ||||||
|  |  | ||||||
|  |       - name: Check syntax and schemas | ||||||
|  |         uses: https://git.kb28.ch/HEL/spyglassmc-action@v1.1.3 | ||||||
|  | ``` | ||||||
|  |  | ||||||
|  | ## Input parameters | ||||||
|  | The following parameters can be passed using the `with` section: | ||||||
|  | |Parameter|Type|Default|Description| | ||||||
|  | |:---|:---|:---:|:---| | ||||||
|  | |`rootDir`        |Path   |`./`   |Root datapack directory (containing the data folder and pack.mcmeta file)| | ||||||
|  | |`version`        |String |`auto` |The Minecraft version to use. If not specified or set to 'auto', will try to use the version indicated in `pack.mcmeta`| | ||||||
|  | |`reportAllErrors`|Boolean|`false`|Whether to report all errors or only the first one| | ||||||
|  | |`verbose`        |Boolean|`false`|Whether to provide details on errors or just the number of errors| | ||||||
|  |  | ||||||
|  |  | ||||||
|  | ## GitHub vs. Gitea | ||||||
|  |  | ||||||
|  | Depending on where you want to execute this action, you should be mindful of the following points | ||||||
|  |  | ||||||
|  | ### Gitea | ||||||
|  | If your workflow will be running on Gitea, you might need to set a specific runner image (see https://gitea.com/gitea/runner-images#migration). For example: | ||||||
|  | ```yaml | ||||||
|  | ... | ||||||
|  | jobs: | ||||||
|  |   check: | ||||||
|  |     runs-on: ubuntu-latest | ||||||
|  |     container: catthehacker/ubuntu:act-latest | ||||||
|  | ... | ||||||
|  | ``` | ||||||
|  |  | ||||||
|  | ### GitHub | ||||||
|  | If your workflow will be running on GitHub, you will not be able to simply use the action from this Gitea repository.\ | ||||||
|  | Instead, you need to add a step to clone this repository, and use the action locally | ||||||
|  |  | ||||||
|  | ```yaml | ||||||
|  | name: Check datapack | ||||||
|  | on: | ||||||
|  |   pull_request: | ||||||
|  |     branches: | ||||||
|  |       - main | ||||||
|  | jobs: | ||||||
|  |   deploy: | ||||||
|  |     runs-on: ubuntu-latest | ||||||
|  |     steps: | ||||||
|  |       - name: Checkout code | ||||||
|  |         uses: actions/checkout@v4 | ||||||
|  |  | ||||||
|  |       - name: Checkout action | ||||||
|  |         run: | | ||||||
|  |           git clone https://git.kb28.ch/HEL/spyglassmc-action ./.github/actions/spyglassmc-action | ||||||
|  |  | ||||||
|  |       - name: Check syntax and schemas | ||||||
|  |         uses: ./.github/actions/spyglassmc-action | ||||||
|  | ``` | ||||||
|  |  | ||||||
|  | You might also want to `git checkout` a specific tagged version | ||||||
							
								
								
									
										10
									
								
								action.yml
									
									
									
									
									
								
							
							
						
						
									
										10
									
								
								action.yml
									
									
									
									
									
								
							| @@ -15,7 +15,15 @@ inputs: | |||||||
|     description: The Minecraft version to use. If not specified or set to 'auto', will try to use the version indicated in `pack.mcmeta` |     description: The Minecraft version to use. If not specified or set to 'auto', will try to use the version indicated in `pack.mcmeta` | ||||||
|     required: false |     required: false | ||||||
|     default: 'auto' |     default: 'auto' | ||||||
|  |   reportAllErrors: | ||||||
|  |     description: Whether to report all errors or only the first one | ||||||
|  |     required: false | ||||||
|  |     default: 'false' | ||||||
|  |   verbose: | ||||||
|  |     description: Whether to provide details on errors or just the number of errors | ||||||
|  |     required: false | ||||||
|  |     default: 'false' | ||||||
|  |  | ||||||
| runs: | runs: | ||||||
|   using: 'node24' |   using: 'node20' | ||||||
|   main: 'dist/index.js' |   main: 'dist/index.js' | ||||||
|   | |||||||
							
								
								
									
										4
									
								
								dist/index.js
									
									
									
									
										vendored
									
									
								
							
							
						
						
									
										4
									
								
								dist/index.js
									
									
									
									
										vendored
									
									
								
							| @@ -87625,7 +87625,7 @@ class CustomService extends Service { | |||||||
|             `- Function: ${funcFiles.length}`); |             `- Function: ${funcFiles.length}`); | ||||||
|         let success = true; |         let success = true; | ||||||
|         for (const jsonFile of jsonFiles) { |         for (const jsonFile of jsonFiles) { | ||||||
|             if (!this.checkFile(jsonFile, "json")) { |             if (!(await this.checkFile(jsonFile, "json"))) { | ||||||
|                 success = false; |                 success = false; | ||||||
|                 if (!this.options.reportAllErrors) { |                 if (!this.options.reportAllErrors) { | ||||||
|                     return false; |                     return false; | ||||||
| @@ -87633,7 +87633,7 @@ class CustomService extends Service { | |||||||
|             } |             } | ||||||
|         } |         } | ||||||
|         for (const funcFile of funcFiles) { |         for (const funcFile of funcFiles) { | ||||||
|             if (!this.checkFile(funcFile, "mcfunction")) { |             if (!(await this.checkFile(funcFile, "mcfunction"))) { | ||||||
|                 success = false; |                 success = false; | ||||||
|                 if (!this.options.reportAllErrors) { |                 if (!this.options.reportAllErrors) { | ||||||
|                     return false; |                     return false; | ||||||
|   | |||||||
| @@ -125,26 +125,27 @@ export class CustomService extends core.Service { | |||||||
|         } |         } | ||||||
|     } |     } | ||||||
|  |  | ||||||
|     async checkFile(path: string, lang: string): Promise<boolean> { |     async checkFile(filePath: string, lang: string): Promise<boolean> { | ||||||
|         const url = this.makeFileUrl(path) |         const url = this.makeFileUrl(filePath) | ||||||
|         const content = this.getFileContent(path) |         const content = this.getFileContent(filePath) | ||||||
|         this.project.onDidOpen(url, lang, 0, content) |         this.project.onDidOpen(url, lang, 0, content) | ||||||
|         const docAndNode = this.project.getClientManaged(url) |         const docAndNode = this.project.getClientManaged(url) | ||||||
|         if (!docAndNode) { |         if (!docAndNode) { | ||||||
|             action.error(`File ${path} is not loaded`) |             action.error(`File ${filePath} is not loaded`) | ||||||
|             return false |             return false | ||||||
|         } |         } | ||||||
|         const { node } = docAndNode |         const { node } = docAndNode | ||||||
|         const errors = core.FileNode.getErrors(node) |         const errors = core.FileNode.getErrors(node) | ||||||
|         if (errors.length !== 0) { |         if (errors.length !== 0) { | ||||||
|             const msg = `${errors.length} error${errors.length > 1 ? "s" : ""} in ${path}` |             const relPath = path.relative(this.rootDir, filePath) | ||||||
|  |             const msg = `${errors.length} error${errors.length > 1 ? "s" : ""} in ${relPath}` | ||||||
|              |              | ||||||
|             if (this.options.verbose) { |             if (this.options.verbose) { | ||||||
|                 action.startGroup(msg) |                 action.startGroup(msg) | ||||||
|                 for (const err of errors) { |                 for (const err of errors) { | ||||||
|                     action.error( |                     action.error( | ||||||
|                         err.message, |                         err.message, | ||||||
|                         this.getErrorProperties(err, path, content) |                         this.getErrorProperties(err, filePath, content) | ||||||
|                     ) |                     ) | ||||||
|                 } |                 } | ||||||
|                 action.endGroup() |                 action.endGroup() | ||||||
| @@ -166,7 +167,7 @@ export class CustomService extends core.Service { | |||||||
|         ) |         ) | ||||||
|         let success = true |         let success = true | ||||||
|         for (const jsonFile of jsonFiles) { |         for (const jsonFile of jsonFiles) { | ||||||
|             if (!this.checkFile(jsonFile, "json")) { |             if (!(await this.checkFile(jsonFile, "json"))) { | ||||||
|                 success = false |                 success = false | ||||||
|                 if (!this.options.reportAllErrors) { |                 if (!this.options.reportAllErrors) { | ||||||
|                     return false |                     return false | ||||||
| @@ -174,7 +175,7 @@ export class CustomService extends core.Service { | |||||||
|             } |             } | ||||||
|         } |         } | ||||||
|         for (const funcFile of funcFiles) { |         for (const funcFile of funcFiles) { | ||||||
|             if (!this.checkFile(funcFile, "mcfunction")) { |             if (!(await this.checkFile(funcFile, "mcfunction"))) { | ||||||
|                 success = false |                 success = false | ||||||
|                 if (!this.options.reportAllErrors) { |                 if (!this.options.reportAllErrors) { | ||||||
|                     return false |                     return false | ||||||
|   | |||||||
		Reference in New Issue
	
	Block a user