@jutge.org/toolkit 4.4.5 → 4.4.7

package/docs/getting-started-guide.md

@@ -254,7 +254,7 @@ jtk verify <program>                # Test a solution
 jtk upload                          # Upload to Jutge.org
 jtk submit -l <language> <solution> # Submit a solution to Jutge.org
 jtk clean                           # Clean temporary files
-jtk passcode                        # Manage problem passcode
+jtk share                           # Update and show sharing settings (passcode, testcases, solutions)
 
 jtk doctor                          # Check system dependencies
 ```

package/docs/problem-anatomy.md

@@ -169,7 +169,7 @@ The `\Link{...}` macro provides a hyperlink to another problem (without specifie
 
 ## The `problem.yml` file
 
-Once a problem is uploaded to Jutge.org, a `problem.yml` file is automatically created in the root of the problem folder. This file contains metadata about the problem that is used by the system. **The fields of this file should not be modified by hand**. In it, you will find fields such as the problem identifier (e.g., X12345), its passcode, the time of creation, and the time of the last modification. Importantly, the presence of this file indicates that the problem has already been uploaded to Jutge.org.
+Once a problem is uploaded to Jutge.org, a `problem.yml` file is automatically created in the root of the problem folder. This file contains metadata about the problem that is used by the system. **The fields of this file should not be modified by hand**. In it, you will find fields such as the problem identifier (e.g., X12345), its sharing settings (passcode, shared testcases, shared solutions), the time of creation, and the time of the last modification. You can view and update these sharing settings with the `jtk share` command. Importantly, the presence of this file indicates that the problem has already been uploaded to Jutge.org.
 
 If you are creating a problem from a copy of an existing problem, be sure to delete the `problem.yml` file before uploading it to Jutge.org to avoid interfering with the existing problem.
 
@@ -178,6 +178,8 @@ Here is an example of a `problem.yml` file:
 ```yml
 problem_nm: X12345
 passcode: 16PbADb1qfDj
+shared_testcases: false
+shared_solutions: false
 created_at: 2016-01-13T11:33:16.187Z
 updated_at: 2026-01-13T12:47:12.884Z
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@jutge.org/toolkit",
     "description": "Toolkit to prepare problems for Jutge.org",
-    "version": "4.4.5",
+    "version": "4.4.7",
     "homepage": "https://jutge.org",
     "author": {
         "name": "Jutge.org",

package/toolkit/index.ts

@@ -17,7 +17,7 @@ import { makeCmd } from './make'
 import { quizCmd } from './quiz'
 import { upgradeCmd } from './upgrade'
 import { uploadCmd } from './upload'
-import { cmdPasscode } from './passcode'
+import { cmdShare } from './share'
 import { submitCmd } from './submit'
 import { askCmd } from './ask'
 import { convertCmd } from './convert'
@@ -34,7 +34,7 @@ program.addHelpText('after', '\nMore documentation:\n  https://github.com/jutge-
 
 program.addCommand(makeCmd)
 program.addCommand(uploadCmd)
-program.addCommand(cmdPasscode)
+program.addCommand(cmdShare)
 program.addCommand(cleanCmd)
 program.addCommand(cloneCmd)
 program.addCommand(generateCmd)

package/toolkit/share.ts

@@ -0,0 +1,49 @@
+import { password } from '@inquirer/prompts'
+import { Command } from '@commander-js/extra-typings'
+import { updateSharingSettings } from '../lib/share'
+
+
+export const cmdShare = new Command('share')
+    .summary('Update and show sharing settings')
+
+    .description(`Update and show sharing settings
+
+First, this command updates the sharing settings in problem.yml file with the ones on Jutge.org to ensure they are consistent.
+
+Then, it updates the sharing settings in Jutge.org with the requested changes. The following options are available:
+    --passcode [code] Set a passcode (prompted if omitted)
+    --no-passcode Clear the passcode
+    --testcases Share testcases
+    --no-testcases Stop sharing testcases
+    --solutions Share solutions
+    --no-solutions Stop sharing solutions
+
+Finally, it updates problem.yml file with the current sharing settings and shows them.`)
+
+    .option('-d, --directory <directory>', 'problem directory', '.')
+    .option('--passcode [code]', 'Set a passcode (prompted if omitted)')
+    .option('--no-passcode', 'Clear the passcode')
+    .option('--testcases', 'Share testcases')
+    .option('--no-testcases', 'Stop sharing testcases')
+    .option('--solutions', 'Share solutions')
+    .option('--no-solutions', 'Stop sharing solutions')
+
+    .action(async function () {
+        const opts = this.opts()
+
+        let passcode: string | undefined | false
+        if (this.getOptionValueSource('passcode') === undefined) {
+            passcode = undefined
+        } else if (this.getOptionValueSource('passcode') === 'cli') {
+            if (opts.passcode === true) {
+                passcode = await password({ message: 'Passcode:' })
+            } else {
+                passcode = opts.passcode
+            }
+        }
+
+        const testcases = this.getOptionValueSource('testcases') !== 'default' ? opts.testcases : undefined
+        const solutions = this.getOptionValueSource('solutions') !== 'default' ? opts.solutions : undefined
+
+        await updateSharingSettings(opts.directory, { passcode, testcases, solutions })
+    })

package/toolkit/create.ts

@@ -1,36 +0,0 @@
-import { Command } from '@commander-js/extra-typings'
-import { createProblemWithJutgeAI } from '../lib/create-with-jutgeai'
-import { createProblemWithTemplate } from '../lib/create-with-template'
-import { settings } from '../lib/settings'
-
-export const createCmd = new Command('create')
-    .description('Create a new problem')
-
-    .action(() => {
-        createCmd.help()
-    })
-
-createCmd
-    .command('with-template')
-    .description('Create a problem with a template')
-
-    .argument('[template]', 'template to use (empty to interactive selection)')
-    .option('-d, --directory <path>', 'output directory', 'new-problem.pbm')
-
-    .action(async (template, { directory }) => {
-        await createProblemWithTemplate(directory, template)
-    })
-
-createCmd
-    .command('with-ai')
-    .description('Create a problem with JutgeAI')
-
-    .option('-d, --directory <path>', 'output directory', 'new-problem.pbm')
-    .option('-i, --input <path>', 'input specification file')
-    .option('-o, --output <path>', 'output specification file')
-    .option('-n, --do-not-ask', 'do not ask interactively if --input given', false)
-    .option('-m, --model <model>', 'AI model to use', settings.defaultModel)
-
-    .action(async ({ input, output, directory, model, doNotAsk }) => {
-        await createProblemWithJutgeAI(model, directory, input, output, doNotAsk)
-    })

package/toolkit/passcode.ts

@@ -1,41 +0,0 @@
-import { Command } from '@commander-js/extra-typings'
-import { removePasscodeInDirectory, setPasscodeInDirectory, showPasscodeInDirectory } from '../lib/passcode'
-
-export const cmdPasscode = new Command('passcode')
-    .summary('Show, set or remove problem passcode')
-    .description(
-        `Show, set or remove the passcode of a problem at Jutge.org.
-
-These operations require an existing problem.yml file in the problem directory.
-On success, problem.yml is updated with the new passcode (or empty for remove).`,
-    )
-
-
-cmdPasscode
-    .command('show')
-    .description('Show the passcode of the problem')
-    .option('-d, --directory <directory>', 'problem directory', '.')
-
-    .action(async ({ directory }) => {
-        await showPasscodeInDirectory(directory)
-    })
-
-cmdPasscode
-    .command('set')
-    .description('Set or update the passcode of the problem')
-
-    .option('-d, --directory <directory>', 'problem directory', '.')
-    .option('-p, --passcode <passcode>', 'passcode (if omitted, will prompt)')
-
-    .action(async ({ directory, passcode }) => {
-        await setPasscodeInDirectory(directory, passcode)
-    })
-
-cmdPasscode
-    .command('remove')
-    .description('Remove the passcode of the problem')
-    .option('-d, --directory <directory>', 'problem directory', '.')
-
-    .action(async ({ directory }) => {
-        await removePasscodeInDirectory(directory)
-    })