Difference between revisions of "Pc2submit"

From PC2wiki
Jump to: navigation, search
m (See Also: add command line link)
m (See also: rename cat)
 
(20 intermediate revisions by the same user not shown)
Line 1: Line 1:
pc2submit and pc2submit shows contest information and allow a user to submit a [[Run]].
+
pc2submit and pc2submit shows contest information and allow a user to submit a [[Run]] of [[Clarification]].
  
==Usage==
+
==Usage 1 - PC²==
  
 
To produce usage use the command
 
To produce usage use the command
  
  pc2report --help
+
  pc2submit --help
 +
 
 +
The pc2submit like all other pc2 scripts, supports the -F option to specify
 +
some or all command line options in a file. 
 +
 
 +
===Features===
 +
 
 +
The submit script does more than just submit runs, it can also:
 +
 
 +
# list information about the contest useful in submitting the run (--list option)
 +
# list run information for previous runs (--listruns)
 +
# check the syntax and content of a submission without sending the run to the server (--check)
 +
# allow the user to specify less information and the submit script will infer the rest
 +
 
 +
===Submit Run Examples (pc2)===
 +
 
 +
To submit a run the user needs to specify their login, password, problem, language and filename(s).
 +
 
 +
A full command for a run submission could be
 +
 
 +
pc2submit --login team5 --password 5pass42x A.java "All the king's men" Java
 +
 
 +
Or the user can use the command to submit a run
 +
 
 +
pc2submit --login team5 --password 5pass42x A.java
 +
 
 +
The filename is used to determine which language and problem.  In this case the first
 +
problem for the contest is named "All the kings's men"
 +
 
 +
pc2submit -F authinfo C.c inc2.h
 +
 
 +
where authinfo contains
 +
--login team5
 +
--password 5pass42x
 +
 
 +
would be the same as this command (if problem C title is "Clear day fever")
 +
 
 +
  pc2submit --login team5 --password 5pass42x C.c,inc2.h "Clear day fever" C
 +
 
 +
Also in this example it shows how to specify multiple files on the command line.
 +
[[TODO]] (Does the -F also handle filenames, and if so, how?)
 +
 
 +
===Submit Run Examples (CCS)===
 +
 
 +
Another run submission syntax is supported, the CCS syntax
 +
pc2submit -u <team_id> -w <team_password> -p <problem_short_name> -l <language_name> -m <main_source_filename>
  
 
For example
 
For example
 +
pc2submit -u team5 -w 5pass42x -l Java -m A.java -p "All the kings's men"
 +
 +
===Submit Clarification Examples===
 +
 +
Staring with [[Version 9.3]] Build 2591 a clarification can be submitted.
 +
 +
Usage
 +
pc2submit [-F propfile] --clar problem question
 +
pc2submit [-F propfile] --clar problem @filename
 +
 +
where filename is the name of a file that contains a clarification question.
 +
 +
Submit clar examples
 +
 +
pc2submit --clar --login team5 --password 5pass42x Squares "How many squares are there?"
 +
 +
pc2submit --clar --login team5 --password 5pass42x C "How many squares are there?"
 +
 +
pc2submit --clar --login team5 --password 5pass42x C @clar1.txt
 +
 +
===Usage Example===
  
 
  Usage Submitter [--help|--list|--listruns|--check] --login loginname [--password password] filename [problem [language]]
 
  Usage Submitter [--help|--list|--listruns|--check] --login loginname [--password password] filename [problem [language]]
 
  Usage Submitter [-F propfile] [--help|--list|--listruns|--check] filename [problem [language]]
 
  Usage Submitter [-F propfile] [--help|--list|--listruns|--check] filename [problem [language]]
 +
Usage Submitter [options] filename1[,filename2[,filename3[,...]]] [problem [language]]
 
   
 
   
 
  Submit filename for problem and language.  If problem or language
 
  Submit filename for problem and language.  If problem or language
Line 18: Line 85:
 
  --help  this listing
 
  --help  this listing
 
   
 
   
  --check  check parameters, list filename, problem and language
+
--helpCCS  CCS testing usage info
 +
 +
  --check  login and check parameters: list problem, language and files that would be submitted.
 
   
 
   
 
  --list  list problem and languages
 
  --list  list problem and languages
Line 27: Line 96:
 
  On failure exit code will be non-zero
 
  On failure exit code will be non-zero
 
   
 
   
  $Id: Submitter.java 2312 2011-09-07 18:52:57Z laned $
+
  $Id: Submitter.java 2463 2012-02-18 05:49:43Z laned $
  
 +
==Usage 2 - CCS ==
  
[[Category:Version 9.3]]
+
The standard command line for CCS is
 +
 
 +
Submitter [-t timestamp] [-i runid] -u loginname -w password -p problem -l language -m mainfile filelist
 +
 
 +
The system supports both that command line and other command line options.
 +
 
 +
===Submit Run Usage===
 +
 
 +
Usage Submitter [--help|--list|--listruns|--check] options
 +
Usage Submitter [-t timestamp] [-i runid] -u loginname -w password -p problem -l language -m mainfile filelist
 +
Usage Submitter [-F propfile] [--help|--list|--listruns|--check]
 +
 +
Submit filename for problem and language. 
 +
 +
--helpCCS      - this listing
 +
 +
-p problem    - contest problem letter or name
 +
 +
-l language    - contest language
 +
 +
-u loginname  - user login
 +
 +
-w password    - user password
 +
 +
-m filename    - main source file name in directory specified by -d option
 +
 +
-i runid      - (optional) run id for submission 
 +
 +
-t timestamp  - (optional)  contest time for submission 
 +
 +
--list        - list problem and languages
 +
 +
--listruns    - list run info for the user
 +
 +
filelist      - list of files including main file
 +
 +
On success exit code will be 0
 +
On failure exit code will be non-zero
 +
 +
$Id: Submitter.java 2463 2012-02-18 05:49:43Z laned $
 +
 
 +
===Submit Clarification Usage===
 +
 
 +
There is no submit clarification support/defined in the [[CCS]].
 +
 
 +
==Error messages/Diagnostics==
 +
 
 +
Unable to submit run: Contest is STOPPED - no runs accepted.
 +
 
 +
Meaning: runs can only be submitted when the [[Contest clock]] is started. 
 +
 
 +
Unable to submit run: Timed out (6515 ms) waiting for run submission confirm - contact staff
 +
 
 +
Meaning: the run was not added by the server.
 +
 
 +
The submitter will wait for 6 seconds for a run confirmation.  If the run confirmation does
 +
not happen within that time, the message above will be displayed for the user.
  
 
==See Also==
 
==See Also==
 
* [[PC&sup2; scripts]]
 
* [[PC&sup2; scripts]]
* PC&sup2; [[Property]] file, -F [[Command Line]] option
+
* For command line options from a file see article [[Command_Line#-F_option| -F option on the command line]]
 
* [[Command Line]] format/options
 
* [[Command Line]] format/options
 +
* [[CCS]]
 +
 +
[[Category:Version 9.3]] [[Category:CLICS]]
  
[[Category:Version 9.3]]
+
[[Category:Import and Export]]

Latest revision as of 10:25, 3 December 2016

pc2submit and pc2submit shows contest information and allow a user to submit a Run of Clarification.

Usage 1 - PC²

To produce usage use the command

pc2submit --help

The pc2submit like all other pc2 scripts, supports the -F option to specify some or all command line options in a file.

Features

The submit script does more than just submit runs, it can also:

  1. list information about the contest useful in submitting the run (--list option)
  2. list run information for previous runs (--listruns)
  3. check the syntax and content of a submission without sending the run to the server (--check)
  4. allow the user to specify less information and the submit script will infer the rest

Submit Run Examples (pc2)

To submit a run the user needs to specify their login, password, problem, language and filename(s).

A full command for a run submission could be

pc2submit --login team5 --password 5pass42x A.java "All the king's men" Java

Or the user can use the command to submit a run

pc2submit --login team5 --password 5pass42x A.java

The filename is used to determine which language and problem. In this case the first problem for the contest is named "All the kings's men"

pc2submit -F authinfo C.c inc2.h

where authinfo contains

--login team5
--password 5pass42x

would be the same as this command (if problem C title is "Clear day fever")

 pc2submit --login team5 --password 5pass42x C.c,inc2.h "Clear day fever" C

Also in this example it shows how to specify multiple files on the command line. TODO (Does the -F also handle filenames, and if so, how?)

Submit Run Examples (CCS)

Another run submission syntax is supported, the CCS syntax

pc2submit -u <team_id> -w <team_password> -p <problem_short_name> -l <language_name> -m <main_source_filename> 

For example

pc2submit -u team5 -w 5pass42x -l Java -m A.java -p "All the kings's men"

Submit Clarification Examples

Staring with Version 9.3 Build 2591 a clarification can be submitted.

Usage

pc2submit [-F propfile] --clar problem question
pc2submit [-F propfile] --clar problem @filename

where filename is the name of a file that contains a clarification question.

Submit clar examples

pc2submit --clar --login team5 --password 5pass42x Squares "How many squares are there?"
pc2submit --clar --login team5 --password 5pass42x C "How many squares are there?"
pc2submit --clar --login team5 --password 5pass42x C @clar1.txt

Usage Example

Usage Submitter [--help|--list|--listruns|--check] --login loginname [--password password] filename [problem [language]]
Usage Submitter [-F propfile] [--help|--list|--listruns|--check] filename [problem [language]]
Usage Submitter [options] filename1[,filename2[,filename3[,...]]] [problem [language]]

Submit filename for problem and language.  If problem or language
not specified the program will guess which problem and language
based on the file name.

--help   this listing

--helpCCS  CCS testing usage info

--check  login and check parameters: list problem, language and files that would be submitted.

--list   list problem and languages

--listruns list run info for the user

On success exit code will be 0
On failure exit code will be non-zero

$Id: Submitter.java 2463 2012-02-18 05:49:43Z laned $

Usage 2 - CCS

The standard command line for CCS is

Submitter [-t timestamp] [-i runid] -u loginname -w password -p problem -l language -m mainfile filelist

The system supports both that command line and other command line options.

Submit Run Usage

Usage Submitter [--help|--list|--listruns|--check] options
Usage Submitter [-t timestamp] [-i runid] -u loginname -w password -p problem -l language -m mainfile filelist
Usage Submitter [-F propfile] [--help|--list|--listruns|--check] 

Submit filename for problem and language.  

--helpCCS      - this listing

-p problem     - contest problem letter or name

-l language    - contest language

-u loginname   - user login 

-w password    - user password

-m filename    - main source file name in directory specified by -d option

-i runid       - (optional) run id for submission  

-t timestamp   - (optional)  contest time for submission  

--list         - list problem and languages

--listruns     - list run info for the user

filelist       - list of files including main file

On success exit code will be 0
On failure exit code will be non-zero

$Id: Submitter.java 2463 2012-02-18 05:49:43Z laned $

Submit Clarification Usage

There is no submit clarification support/defined in the CCS.

Error messages/Diagnostics

Unable to submit run: Contest is STOPPED - no runs accepted.

Meaning: runs can only be submitted when the Contest clock is started.

Unable to submit run: Timed out (6515 ms) waiting for run submission confirm - contact staff

Meaning: the run was not added by the server.

The submitter will wait for 6 seconds for a run confirmation. If the run confirmation does not happen within that time, the message above will be displayed for the user.

See Also