Configuration options

See also

The nbgrader_config.py file

Details on how to setup the nbgrader_config.py file.

These options can be set in nbgrader_config.py, or at the command line when you start it.

Application.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

Application.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

Application.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

Application.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

Application.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

JupyterApp.answer_yesBool

Default: False

Answer yes to any prompts.

JupyterApp.config_fileUnicode

Default: ''

Full path of a config file.

JupyterApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

JupyterApp.generate_configBool

Default: False

Generate default config file.

JupyterApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

JupyterApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

JupyterApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

JupyterApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

JupyterApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

NbGrader.answer_yesBool

Default: False

Answer yes to any prompts.

NbGrader.config_fileUnicode

Default: ''

Full path of a config file.

NbGrader.config_file_nameUnicode

Default: ''

Specify a config file to load.

NbGrader.generate_configBool

Default: False

Generate default config file.

NbGrader.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

NbGrader.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

NbGrader.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

NbGrader.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

NbGrader.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

NbGrader.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

NbGraderApp.answer_yesBool

Default: False

Answer yes to any prompts.

NbGraderApp.config_fileUnicode

Default: ''

Full path of a config file.

NbGraderApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

NbGraderApp.generate_configBool

Default: False

Generate default config file.

NbGraderApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

NbGraderApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

NbGraderApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

NbGraderApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

NbGraderApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

NbGraderApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

ExchangeFactory.collectType

Default: 'nbgrader.exchange.default.collect.ExchangeCollect'

A plugin for collecting assignments.

ExchangeFactory.exchangeType

Default: 'nbgrader.exchange.default.exchange.Exchange'

A plugin for exchange.

ExchangeFactory.fetch_assignmentType

Default: 'nbgrader.exchange.default.fetch_assignment.ExchangeFetchAssi...

A plugin for fetching assignments.

ExchangeFactory.fetch_feedbackType

Default: 'nbgrader.exchange.default.fetch_feedback.ExchangeFetchFeedback'

A plugin for fetching feedback.

ExchangeFactory.listType

Default: 'nbgrader.exchange.default.list.ExchangeList'

A plugin for listing exchange files.

ExchangeFactory.release_assignmentType

Default: 'nbgrader.exchange.default.release_assignment.ExchangeRelease...

A plugin for releasing assignments.

ExchangeFactory.release_feedbackType

Default: 'nbgrader.exchange.default.release_feedback.ExchangeReleaseFe...

A plugin for releasing feedback.

ExchangeFactory.submitType

Default: 'nbgrader.exchange.default.submit.ExchangeSubmit'

A plugin for submitting assignments.

CourseDirectory.assignment_idUnicode

Default: ''

The assignment name. This MUST be specified, either by setting the config option, passing an argument on the command line, or using the –assignment option on the command line.

CourseDirectory.autograded_directoryUnicode

Default: 'autograded'

The name of the directory that contains assignment submissions after they have been autograded. This corresponds to the nbgrader_step variable in the directory_structure config option.

CourseDirectory.course_idUnicode

Default: ''

A key that is unique per instructor and course. This can be specified, either by setting the config option, or using the –course option on the command line.

CourseDirectory.db_urlUnicode

Default: ''

URL to the database. Defaults to sqlite:///<root>/gradebook.db, where <root> is another configurable variable.

CourseDirectory.directory_structureUnicode

Default: '{nbgrader_step}/{student_id}/{assignment_id}'

Format string for the directory structure that nbgrader works over during the grading process. This MUST contain named keys for ‘nbgrader_step’, ‘student_id’, and ‘assignment_id’. It SHOULD NOT contain a key for ‘notebook_id’, as this will be automatically joined with the rest of the path.

CourseDirectory.feedback_directoryUnicode

Default: 'feedback'

The name of the directory that contains assignment feedback after grading has been completed. This corresponds to the nbgrader_step variable in the directory_structure config option.

CourseDirectory.groupsharedBool

Default: False

Make all instructor files group writeable (g+ws, default g+r only) and exchange directories group readable/writeable (g+rws, default g=nothing only ) by default. This should only be used if you carefully set the primary groups of your notebook servers and fully understand the unix permission model. This changes the default permissions from 444 (unwriteable) to 664 (writeable), so that other instructors are able to delete/overwrite files.

CourseDirectory.ignoreList

Default: ['.ipynb_checkpoints', '*.pyc', '__pycache__', 'feedback']

List of file names or file globs. Upon copying directories recursively, matching files and directories will be ignored with a debug message.

CourseDirectory.includeList

Default: ['*']

List of file names or file globs. Upon copying directories recursively, non matching files will be ignored with a debug message.

CourseDirectory.max_file_sizeInt

Default: 100000

Maximum size of files (in kilobytes; default: 100Mb). Upon copying directories recursively, larger files will be ignored with a warning.

CourseDirectory.notebook_idUnicode

Default: '*'

File glob to match notebook names, excluding the ‘.ipynb’ extension. This can be changed to filter by notebook.

CourseDirectory.release_directoryUnicode

Default: 'release'

The name of the directory that contains the version of the assignment that will be released to students. This corresponds to the nbgrader_step variable in the directory_structure config option.

CourseDirectory.rootUnicode

Default: ''

The root directory for the course files (that includes the source, release, submitted, autograded, etc. directories). Defaults to the current working directory.

CourseDirectory.solution_directoryUnicode

Default: 'solution'

The name of the directory that contains the assignment solution after grading has been completed. This corresponds to the nbgrader_step variable in the directory_structure config option.

CourseDirectory.source_directoryUnicode

Default: 'source'

The name of the directory that contains the master/instructor version of assignments. This corresponds to the nbgrader_step variable in the directory_structure config option.

CourseDirectory.student_idUnicode

Default: '*'

File glob to match student IDs. This can be changed to filter by student. Note: this is always changed to ‘.’ when running nbgrader assign, as the assign step doesn’t have any student ID associated with it. With nbgrader submit, this instead forces the use of an alternative student ID for the submission. See nbgrader submit –help.

If the ID is purely numeric and you are passing it as a flag on the command line, you will need to escape the quotes in order to have it detected as a string, for example –student=””12345””. See:

for more details.

CourseDirectory.student_id_excludeUnicode

Default: ''

Comma-separated list of student IDs to exclude. Counterpart of student_id.

This is useful when running commands on all students, but certain students cause errors or otherwise must be left out. Works at least for autograde, generate_feedback, and release_feedback.

CourseDirectory.submitted_directoryUnicode

Default: 'submitted'

The name of the directory that contains assignments that have been submitted by students for grading. This corresponds to the nbgrader_step variable in the directory_structure config option.

Authenticator.plugin_classType

Default: 'nbgrader.auth.base.NoAuthPlugin'

A plugin for different authentication methods.

GenerateAssignmentApp.answer_yesBool

Default: False

Answer yes to any prompts.

GenerateAssignmentApp.config_fileUnicode

Default: ''

Full path of a config file.

GenerateAssignmentApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

GenerateAssignmentApp.generate_configBool

Default: False

Generate default config file.

GenerateAssignmentApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

GenerateAssignmentApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

GenerateAssignmentApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

GenerateAssignmentApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

GenerateAssignmentApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

GenerateAssignmentApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

AssignApp.answer_yesBool

Default: False

Answer yes to any prompts.

AssignApp.config_fileUnicode

Default: ''

Full path of a config file.

AssignApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

AssignApp.generate_configBool

Default: False

Generate default config file.

AssignApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

AssignApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

AssignApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

AssignApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

AssignApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

AssignApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

AutogradeApp.answer_yesBool

Default: False

Answer yes to any prompts.

AutogradeApp.config_fileUnicode

Default: ''

Full path of a config file.

AutogradeApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

AutogradeApp.generate_configBool

Default: False

Generate default config file.

AutogradeApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

AutogradeApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

AutogradeApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

AutogradeApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

AutogradeApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

AutogradeApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

FormgradeApp.answer_yesBool

Default: False

Answer yes to any prompts.

FormgradeApp.config_fileUnicode

Default: ''

Full path of a config file.

FormgradeApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

FormgradeApp.generate_configBool

Default: False

Generate default config file.

FormgradeApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

FormgradeApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

FormgradeApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

FormgradeApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

FormgradeApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

FormgradeApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

GenerateFeedbackApp.answer_yesBool

Default: False

Answer yes to any prompts.

GenerateFeedbackApp.config_fileUnicode

Default: ''

Full path of a config file.

GenerateFeedbackApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

GenerateFeedbackApp.generate_configBool

Default: False

Generate default config file.

GenerateFeedbackApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

GenerateFeedbackApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

GenerateFeedbackApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

GenerateFeedbackApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

GenerateFeedbackApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

GenerateFeedbackApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

FeedbackApp.answer_yesBool

Default: False

Answer yes to any prompts.

FeedbackApp.config_fileUnicode

Default: ''

Full path of a config file.

FeedbackApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

FeedbackApp.generate_configBool

Default: False

Generate default config file.

FeedbackApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

FeedbackApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

FeedbackApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

FeedbackApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

FeedbackApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

FeedbackApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

ValidateApp.answer_yesBool

Default: False

Answer yes to any prompts.

ValidateApp.config_fileUnicode

Default: ''

Full path of a config file.

ValidateApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

ValidateApp.generate_configBool

Default: False

Generate default config file.

ValidateApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

ValidateApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

ValidateApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

ValidateApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

ValidateApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

ValidateApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

ReleaseAssignmentApp.answer_yesBool

Default: False

Answer yes to any prompts.

ReleaseAssignmentApp.config_fileUnicode

Default: ''

Full path of a config file.

ReleaseAssignmentApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

ReleaseAssignmentApp.generate_configBool

Default: False

Generate default config file.

ReleaseAssignmentApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

ReleaseAssignmentApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

ReleaseAssignmentApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

ReleaseAssignmentApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

ReleaseAssignmentApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

ReleaseAssignmentApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

ReleaseApp.answer_yesBool

Default: False

Answer yes to any prompts.

ReleaseApp.config_fileUnicode

Default: ''

Full path of a config file.

ReleaseApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

ReleaseApp.generate_configBool

Default: False

Generate default config file.

ReleaseApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

ReleaseApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

ReleaseApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

ReleaseApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

ReleaseApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

ReleaseApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

ReleaseFeedbackApp.answer_yesBool

Default: False

Answer yes to any prompts.

ReleaseFeedbackApp.config_fileUnicode

Default: ''

Full path of a config file.

ReleaseFeedbackApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

ReleaseFeedbackApp.generate_configBool

Default: False

Generate default config file.

ReleaseFeedbackApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

ReleaseFeedbackApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

ReleaseFeedbackApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

ReleaseFeedbackApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

ReleaseFeedbackApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

ReleaseFeedbackApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

CollectApp.answer_yesBool

Default: False

Answer yes to any prompts.

CollectApp.config_fileUnicode

Default: ''

Full path of a config file.

CollectApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

CollectApp.generate_configBool

Default: False

Generate default config file.

CollectApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

CollectApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

CollectApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

CollectApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

CollectApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

CollectApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

ZipCollectApp.answer_yesBool

Default: False

Answer yes to any prompts.

ZipCollectApp.archive_directoryUnicode

Default: 'archive'

The name of the directory that contains assignment submission files and/or archives (zip) files manually downloaded from a LMS. This corresponds to the collect_step variable in the collect_structure config option.

ZipCollectApp.collect_directory_structureUnicode

Default: '{downloaded}/{assignment_id}/{collect_step}'

Format string for the directory structure that nbgrader works over during the zip collect process. This MUST contain named keys for ‘downloaded’, ‘assignment_id’, and ‘collect_step’.

ZipCollectApp.collector_pluginType

Default: 'nbgrader.plugins.zipcollect.FileNameCollectorPlugin'

The plugin class for processing the submitted file names after they have been extracted into the extracted_directory.

ZipCollectApp.config_fileUnicode

Default: ''

Full path of a config file.

ZipCollectApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

ZipCollectApp.downloaded_directoryUnicode

Default: 'downloaded'

The main directory that corresponds to the downloaded variable in the collect_structure config option.

ZipCollectApp.extracted_directoryUnicode

Default: 'extracted'

The name of the directory that contains assignment submission files extracted or copied from the archive_directory. This corresponds to the collect_step variable in the collect_structure config option.

ZipCollectApp.extractor_pluginType

Default: 'nbgrader.plugins.zipcollect.ExtractorPlugin'

The plugin class for extracting the archive files in the archive_directory.

ZipCollectApp.forceBool

Default: False

Force overwrite of existing files.

ZipCollectApp.generate_configBool

Default: False

Generate default config file.

ZipCollectApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

ZipCollectApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

ZipCollectApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

ZipCollectApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

ZipCollectApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

ZipCollectApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

ZipCollectApp.strictBool

Default: False

Skip submitted notebooks with invalid names.

FetchAssignmentApp.answer_yesBool

Default: False

Answer yes to any prompts.

FetchAssignmentApp.config_fileUnicode

Default: ''

Full path of a config file.

FetchAssignmentApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

FetchAssignmentApp.generate_configBool

Default: False

Generate default config file.

FetchAssignmentApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

FetchAssignmentApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

FetchAssignmentApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

FetchAssignmentApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

FetchAssignmentApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

FetchAssignmentApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

FetchApp.answer_yesBool

Default: False

Answer yes to any prompts.

FetchApp.config_fileUnicode

Default: ''

Full path of a config file.

FetchApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

FetchApp.generate_configBool

Default: False

Generate default config file.

FetchApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

FetchApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

FetchApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

FetchApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

FetchApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

FetchApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

FetchFeedbackApp.answer_yesBool

Default: False

Answer yes to any prompts.

FetchFeedbackApp.config_fileUnicode

Default: ''

Full path of a config file.

FetchFeedbackApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

FetchFeedbackApp.generate_configBool

Default: False

Generate default config file.

FetchFeedbackApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

FetchFeedbackApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

FetchFeedbackApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

FetchFeedbackApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

FetchFeedbackApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

FetchFeedbackApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

SubmitApp.answer_yesBool

Default: False

Answer yes to any prompts.

SubmitApp.config_fileUnicode

Default: ''

Full path of a config file.

SubmitApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

SubmitApp.generate_configBool

Default: False

Generate default config file.

SubmitApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

SubmitApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

SubmitApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

SubmitApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

SubmitApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

SubmitApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

ListApp.answer_yesBool

Default: False

Answer yes to any prompts.

ListApp.config_fileUnicode

Default: ''

Full path of a config file.

ListApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

ListApp.generate_configBool

Default: False

Generate default config file.

ListApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

ListApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

ListApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

ListApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

ListApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

ListApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

ExtensionApp.answer_yesBool

Default: False

Answer yes to any prompts.

ExtensionApp.config_fileUnicode

Default: ''

Full path of a config file.

ExtensionApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

ExtensionApp.generate_configBool

Default: False

Generate default config file.

ExtensionApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

ExtensionApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

ExtensionApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

ExtensionApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

ExtensionApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

ExtensionApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

QuickStartApp.answer_yesBool

Default: False

Answer yes to any prompts.

QuickStartApp.config_fileUnicode

Default: ''

Full path of a config file.

QuickStartApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

QuickStartApp.forceBool

Default: False

Whether to overwrite existing files

QuickStartApp.generate_configBool

Default: False

Generate default config file.

QuickStartApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

QuickStartApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

QuickStartApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

QuickStartApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

QuickStartApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

QuickStartApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

ExportApp.answer_yesBool

Default: False

Answer yes to any prompts.

ExportApp.config_fileUnicode

Default: ''

Full path of a config file.

ExportApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

ExportApp.generate_configBool

Default: False

Generate default config file.

ExportApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

ExportApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

ExportApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

ExportApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

ExportApp.plugin_classType

Default: 'nbgrader.plugins.export.CsvExportPlugin'

The plugin class for exporting the grades.

ExportApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

ExportApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

DbBaseApp.answer_yesBool

Default: False

Answer yes to any prompts.

DbBaseApp.config_fileUnicode

Default: ''

Full path of a config file.

DbBaseApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

DbBaseApp.generate_configBool

Default: False

Generate default config file.

DbBaseApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

DbBaseApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

DbBaseApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

DbBaseApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

DbBaseApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

DbBaseApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

DbApp.answer_yesBool

Default: False

Answer yes to any prompts.

DbApp.config_fileUnicode

Default: ''

Full path of a config file.

DbApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

DbApp.generate_configBool

Default: False

Generate default config file.

DbApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

DbApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

DbApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

DbApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

DbApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

DbApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

UpdateApp.answer_yesBool

Default: False

Answer yes to any prompts.

UpdateApp.config_fileUnicode

Default: ''

Full path of a config file.

UpdateApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

UpdateApp.generate_configBool

Default: False

Generate default config file.

UpdateApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

UpdateApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

UpdateApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

UpdateApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

UpdateApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

UpdateApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

UpdateApp.validateBool

Default: True

whether to validate metadata after updating it

GenerateConfigApp.answer_yesBool

Default: False

Answer yes to any prompts.

GenerateConfigApp.config_fileUnicode

Default: ''

Full path of a config file.

GenerateConfigApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

GenerateConfigApp.filenameUnicode

Default: 'nbgrader_config.py'

The name of the configuration file to generate.

GenerateConfigApp.generate_configBool

Default: False

Generate default config file.

GenerateConfigApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

GenerateConfigApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

GenerateConfigApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

GenerateConfigApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

GenerateConfigApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

GenerateConfigApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

GenerateSolutionApp.answer_yesBool

Default: False

Answer yes to any prompts.

GenerateSolutionApp.config_fileUnicode

Default: ''

Full path of a config file.

GenerateSolutionApp.config_file_nameUnicode

Default: ''

Specify a config file to load.

GenerateSolutionApp.generate_configBool

Default: False

Generate default config file.

GenerateSolutionApp.log_datefmtUnicode

Default: '%Y-%m-%d %H:%M:%S'

The date format used by logging formatters for %(asctime)s

GenerateSolutionApp.log_formatUnicode

Default: '[%(name)s]%(highlevel)s %(message)s'

The Logging format template

GenerateSolutionApp.log_levelany of 0``|``10``|``20``|``30``|``40``|``50``|’DEBUG’|’INFO’|’WARN’|’ERROR’|’CRITICAL’``

Default: 30

Set the log level by value or name.

GenerateSolutionApp.logfileUnicode

Default: ''

Name of the logfile to log to. By default, log output is not written to any file.

GenerateSolutionApp.show_configBool

Default: False

Instead of starting the Application, dump configuration to stdout

GenerateSolutionApp.show_config_jsonBool

Default: False

Instead of starting the Application, dump configuration to stdout (as JSON)

ExportPlugin.assignmentList

Default: []

list of assignments to export

ExportPlugin.studentList

Default: []

list of students to export

ExportPlugin.toUnicode

Default: ''

destination to export to

CsvExportPlugin.assignmentList

Default: []

list of assignments to export

CsvExportPlugin.studentList

Default: []

list of students to export

CsvExportPlugin.toUnicode

Default: ''

destination to export to

ExtractorPlugin.forceBool

Default: False

Force overwrite of existing files.

ExtractorPlugin.zip_extList

Default: ['.zip', '.gz']

List of valid archive (zip) filename extensions to extract. Any archive (zip) files with an extension not in this list are copied to the extracted_directory.

FileNameCollectorPlugin.named_regexpUnicode

Default: ''

This regular expression is applied to each submission filename and MUST be supplied by the instructor. This regular expression MUST provide the (?P<student_id>…) and (?P<file_id>…) named group expressions. Optionally this regular expression can also provide the (?P<first_name>…), (?P<last_name>…), (?P<email>…), and (?P<timestamp>…) named group expressions. For example if the filename is:

ps1_bitdiddle_attempt_2016-01-30-15-00-00_problem1.ipynb

then this named_regexp could be:

“.*_(?P<student_id>w+)_attempt_(?P<timestamp>[0-9-]+)_(?P<file_id>w+)”

For named group regular expression examples see https://docs.python.org/3/howto/regex.html

FileNameCollectorPlugin.valid_extList

Default: ['.ipynb']

List of valid submission filename extensions to collect. Any submitted file with an extension not in this list is skipped.

LateSubmissionPlugin.penalty_methodany of 'none'``|’zero’``

Default: 'none'

The method for assigning late submission penalties:

‘none’: do nothing (no penalty assigned) ‘zero’: assign an overall score of zero (penalty = score)

NbConvertBase.default_languageUnicode

Default: 'ipython'

Deprecated default highlight language as of 5.0, please use language_info metadata instead

NbConvertBase.display_data_priorityList

Default: ['text/html', 'application/pdf', 'text/latex', 'image/svg+xml...

An ordered list of preferred output type, the first encountered will usually be used when converting discarding the others.

Preprocessor.default_languageUnicode

Default: 'ipython'

Deprecated default highlight language as of 5.0, please use language_info metadata instead

Preprocessor.display_data_priorityList

Default: ['text/html', 'application/pdf', 'text/latex', 'image/svg+xml...

An ordered list of preferred output type, the first encountered will usually be used when converting discarding the others.

Preprocessor.enabledBool

Default: False

No description

NbGraderPreprocessor.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

AssignLatePenalties.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

AssignLatePenalties.plugin_classType

Default: 'nbgrader.plugins.latesubmission.LateSubmissionPlugin'

The plugin class for assigning the late penalty for each notebook.

IncludeHeaderFooter.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

IncludeHeaderFooter.footerUnicode

Default: ''

Path to footer notebook, relative to the root of the course directory

IncludeHeaderFooter.headerUnicode

Default: ''

Path to header notebook, relative to the root of the course directory

LockCells.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

LockCells.lock_all_cellsBool

Default: False

Whether all assignment cells are locked (non-deletable and non-editable)

LockCells.lock_grade_cellsBool

Default: True

Whether grade cells are locked (non-deletable)

LockCells.lock_readonly_cellsBool

Default: True

Whether readonly cells are locked (non-deletable and non-editable)

LockCells.lock_solution_cellsBool

Default: True

Whether solution cells are locked (non-deletable and non-editable)

ClearSolutions.begin_solution_delimeterUnicode

Default: 'BEGIN SOLUTION'

The delimiter marking the beginning of a solution

ClearSolutions.code_stubDict

Default: {'python': '# YOUR CODE HERE\\nraise NotImplementedError()', '...

The code snippet that will replace code solutions

ClearSolutions.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

ClearSolutions.end_solution_delimeterUnicode

Default: 'END SOLUTION'

The delimiter marking the end of a solution

ClearSolutions.enforce_metadataBool

Default: True

Whether or not to complain if cells containing solutions regions are not marked as solution cells. WARNING: this will potentially cause things to break if you are using the full nbgrader pipeline. ONLY disable this option if you are only ever planning to use nbgrader assign.

ClearSolutions.text_stubUnicode

Default: 'YOUR ANSWER HERE'

The text snippet that will replace written solutions

SaveAutoGrades.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

ComputeChecksums.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

SaveCells.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

OverwriteCells.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

CheckCellMetadata.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

ExecutePreprocessor.allow_errorsBool

Default: False

If False (default), when a cell raises an error the execution is stopped and a CellExecutionError is raised. If True, execution errors are ignored and the execution is continued until the end of the notebook. Output from exceptions is included in the cell output in both cases.

ExecutePreprocessor.default_languageUnicode

Default: 'ipython'

Deprecated default highlight language as of 5.0, please use language_info metadata instead

ExecutePreprocessor.display_data_priorityList

Default: ['text/html', 'application/pdf', 'text/latex', 'image/svg+xml...

An ordered list of preferred output type, the first encountered will usually be used when converting discarding the others.

ExecutePreprocessor.enabledBool

Default: False

No description

ExecutePreprocessor.force_raise_errorsBool

Default: False

If False (default), errors from executing the notebook can be allowed with a raises-exception tag on a single cell, or the allow_errors configurable option for all cells. An allowed error will be recorded in notebook output, and execution will continue. If an error occurs when it is not explicitly allowed, a CellExecutionError will be raised. If True, CellExecutionError will be raised for any error that occurs while executing the notebook. This overrides both the allow_errors option and the raises-exception cell tag.

ExecutePreprocessor.interrupt_on_timeoutBool

Default: False

If execution of a cell times out, interrupt the kernel and continue executing other cells rather than throwing an error and stopping.

ExecutePreprocessor.iopub_timeoutInt

Default: 4

The time to wait (in seconds) for IOPub output. This generally doesn’t need to be set, but on some slow networks (such as CI systems) the default timeout might not be long enough to get all messages.

ExecutePreprocessor.ipython_hist_fileUnicode

Default: ':memory:'

Path to file to use for SQLite history database for an IPython kernel.

The specific value :memory: (including the colon at both end but not the back ticks), avoids creating a history file. Otherwise, IPython will create a history file for each kernel.

When running kernels simultaneously (e.g. via multiprocessing) saving history a single SQLite file can result in database errors, so using :memory: is recommended in non-interactive contexts.

ExecutePreprocessor.kernel_manager_classType

Default: 'builtins.object'

The kernel manager class to use.

ExecutePreprocessor.kernel_nameUnicode

Default: ''

Name of kernel to use to execute the cells. If not set, use the kernel_spec embedded in the notebook.

ExecutePreprocessor.raise_on_iopub_timeoutBool

Default: False

If False (default), then the kernel will continue waiting for iopub messages until it receives a kernel idle message, or until a timeout occurs, at which point the currently executing cell will be skipped. If True, then an error will be raised after the first timeout. This option generally does not need to be used, but may be useful in contexts where there is the possibility of executing notebooks with memory-consuming infinite loops.

ExecutePreprocessor.shutdown_kernelany of 'graceful'``|’immediate’``

Default: 'graceful'

If graceful (default), then the kernel is given time to clean up after executing all cells, e.g., to execute its atexit hooks. If immediate, then the kernel is signaled to immediately terminate.

ExecutePreprocessor.startup_timeoutInt

Default: 60

The time to wait (in seconds) for the kernel to start. If kernel startup takes longer, a RuntimeError is raised.

ExecutePreprocessor.store_widget_stateBool

Default: True

If True (default), then the state of the Jupyter widgets created at the kernel will be stored in the metadata of the notebook.

ExecutePreprocessor.timeoutInt

Default: 30

The time to wait (in seconds) for output from executions. If a cell execution takes longer, an exception (TimeoutError on python 3+, RuntimeError on python 2) is raised.

None or -1 will disable the timeout. If timeout_func is set, it overrides timeout.

ExecutePreprocessor.timeout_funcAny

Default: None

A callable which, when given the cell source as input, returns the time to wait (in seconds) for output from cell executions. If a cell execution takes longer, an exception (TimeoutError on python 3+, RuntimeError on python 2) is raised.

Returning None or -1 will disable the timeout for the cell. Not setting timeout_func will cause the preprocessor to default to using the timeout trait for all cells. The timeout_func trait overrides timeout if it is not None.

Execute.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

Execute.execute_retriesInt

Default: 0

The number of times to try re-executing the notebook before throwing an error. Generally, this shouldn’t need to be set, but might be useful for CI environments when tests are flaky.

Execute.extra_argumentsList

Default: []

A list of extra arguments to pass to the kernel. For python kernels, this defaults to --HistoryManager.hist_file=:memory:. For other kernels this is just an empty list.

Execute.force_raise_errorsBool

Default: False

If False (default), errors from executing the notebook can be allowed with a raises-exception tag on a single cell, or the allow_errors configurable option for all cells. An allowed error will be recorded in notebook output, and execution will continue. If an error occurs when it is not explicitly allowed, a CellExecutionError will be raised. If True, CellExecutionError will be raised for any error that occurs while executing the notebook. This overrides both the allow_errors option and the raises-exception cell tag.

Execute.iopub_timeoutInt

Default: 4

The time to wait (in seconds) for IOPub output. This generally doesn’t need to be set, but on some slow networks (such as CI systems) the default timeout might not be long enough to get all messages.

Execute.ipython_hist_fileUnicode

Default: ':memory:'

Path to file to use for SQLite history database for an IPython kernel.

The specific value :memory: (including the colon at both end but not the back ticks), avoids creating a history file. Otherwise, IPython will create a history file for each kernel.

When running kernels simultaneously (e.g. via multiprocessing) saving history a single SQLite file can result in database errors, so using :memory: is recommended in non-interactive contexts.

Execute.kernel_manager_classType

Default: 'builtins.object'

The kernel manager class to use.

Execute.kernel_nameUnicode

Default: ''

Name of kernel to use to execute the cells. If not set, use the kernel_spec embedded in the notebook.

Execute.shutdown_kernelany of 'graceful'``|’immediate’``

Default: 'graceful'

If graceful (default), then the kernel is given time to clean up after executing all cells, e.g., to execute its atexit hooks. If immediate, then the kernel is signaled to immediately terminate.

Execute.startup_timeoutInt

Default: 60

The time to wait (in seconds) for the kernel to start. If kernel startup takes longer, a RuntimeError is raised.

Execute.store_widget_stateBool

Default: True

If True (default), then the state of the Jupyter widgets created at the kernel will be stored in the metadata of the notebook.

Execute.timeoutInt

Default: 30

The time to wait (in seconds) for output from executions. If a cell execution takes longer, an exception (TimeoutError on python 3+, RuntimeError on python 2) is raised.

None or -1 will disable the timeout. If timeout_func is set, it overrides timeout.

Execute.timeout_funcAny

Default: None

A callable which, when given the cell source as input, returns the time to wait (in seconds) for output from cell executions. If a cell execution takes longer, an exception (TimeoutError on python 3+, RuntimeError on python 2) is raised.

Returning None or -1 will disable the timeout for the cell. Not setting timeout_func will cause the preprocessor to default to using the timeout trait for all cells. The timeout_func trait overrides timeout if it is not None.

GetGrades.display_data_priorityList

Default: ['text/html', 'application/pdf', 'text/latex', 'image/svg+xml...

No description

GetGrades.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

ClearOutputPreprocessor.default_languageUnicode

Default: 'ipython'

Deprecated default highlight language as of 5.0, please use language_info metadata instead

ClearOutputPreprocessor.display_data_priorityList

Default: ['text/html', 'application/pdf', 'text/latex', 'image/svg+xml...

An ordered list of preferred output type, the first encountered will usually be used when converting discarding the others.

ClearOutputPreprocessor.enabledBool

Default: False

No description

ClearOutputPreprocessor.remove_metadata_fieldsSet

Default: {'collapsed', 'scrolled'}

No description

ClearOutput.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

ClearOutput.remove_metadata_fieldsSet

Default: {'collapsed', 'scrolled'}

No description

LimitOutput.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

LimitOutput.max_linesInt

Default: 1000

maximum number of lines of output (-1 means no limit)

LimitOutput.max_tracebackInt

Default: 100

maximum number of traceback lines (-1 means no limit)

DeduplicateIds.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

ClearHiddenTests.begin_test_delimeterUnicode

Default: 'BEGIN HIDDEN TESTS'

The delimiter marking the beginning of hidden tests cases

ClearHiddenTests.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

ClearHiddenTests.end_test_delimeterUnicode

Default: 'END HIDDEN TESTS'

The delimiter marking the end of hidden tests cases

ClearHiddenTests.enforce_metadataBool

Default: True

Whether or not to complain if cells containing hidden test regions are not marked as grade cells. WARNING: this will potentially cause things to break if you are using the full nbgrader pipeline. ONLY disable this option if you are only ever planning to use nbgrader assign.

ClearMarkScheme.begin_mark_scheme_delimeterUnicode

Default: 'BEGIN MARK SCHEME'

The delimiter marking the beginning of hidden tests cases

ClearMarkScheme.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

ClearMarkScheme.end_mark_scheme_delimeterUnicode

Default: 'END MARK SCHEME'

The delimiter marking the end of hidden tests cases

ClearMarkScheme.enforce_metadataBool

Default: True

Whether or not to complain if cells containing marking scheme regions are not marked as task cells. WARNING: this will potentially cause things to break if you are using the full nbgrader pipeline. ONLY disable this option if you are only ever planning to use nbgrader assign.

OverwriteKernelspec.enabledBool

Default: True

Whether to use this preprocessor when running nbgrader

Exchange.assignment_dirUnicode

Default: '.'

Local path for storing student assignments. Defaults to ‘.’ which is normally Jupyter’s notebook_dir.

Exchange.timestamp_formatUnicode

Default: '%Y-%m-%d %H:%M:%S.%f %Z'

Format string for timestamps

Exchange.timezoneUnicode

Default: 'UTC'

Timezone for recording timestamps

ExchangeCollect.assignment_dirUnicode

Default: '.'

Local path for storing student assignments. Defaults to ‘.’ which is normally Jupyter’s notebook_dir.

ExchangeCollect.before_duedateBool

Default: False

Collect the last submission before due date or the last submission if no submission before due date.

ExchangeCollect.check_ownerBool

Default: True

Whether to cross-check the student_id with the UNIX-owner of the submitted directory.

ExchangeCollect.timestamp_formatUnicode

Default: '%Y-%m-%d %H:%M:%S.%f %Z'

Format string for timestamps

ExchangeCollect.timezoneUnicode

Default: 'UTC'

Timezone for recording timestamps

ExchangeCollect.updateBool

Default: False

Update existing submissions with ones that have newer timestamps.

ExchangeFetchAssignment.assignment_dirUnicode

Default: '.'

Local path for storing student assignments. Defaults to ‘.’ which is normally Jupyter’s notebook_dir.

ExchangeFetchAssignment.replace_missing_filesBool

Default: False

Whether to replace missing files on fetch

ExchangeFetchAssignment.timestamp_formatUnicode

Default: '%Y-%m-%d %H:%M:%S.%f %Z'

Format string for timestamps

ExchangeFetchAssignment.timezoneUnicode

Default: 'UTC'

Timezone for recording timestamps

ExchangeFetch.assignment_dirUnicode

Default: '.'

Local path for storing student assignments. Defaults to ‘.’ which is normally Jupyter’s notebook_dir.

ExchangeFetch.replace_missing_filesBool

Default: False

Whether to replace missing files on fetch

ExchangeFetch.timestamp_formatUnicode

Default: '%Y-%m-%d %H:%M:%S.%f %Z'

Format string for timestamps

ExchangeFetch.timezoneUnicode

Default: 'UTC'

Timezone for recording timestamps

ExchangeFetchFeedback.assignment_dirUnicode

Default: '.'

Local path for storing student assignments. Defaults to ‘.’ which is normally Jupyter’s notebook_dir.

ExchangeFetchFeedback.timestamp_formatUnicode

Default: '%Y-%m-%d %H:%M:%S.%f %Z'

Format string for timestamps

ExchangeFetchFeedback.timezoneUnicode

Default: 'UTC'

Timezone for recording timestamps

ExchangeList.assignment_dirUnicode

Default: '.'

Local path for storing student assignments. Defaults to ‘.’ which is normally Jupyter’s notebook_dir.

ExchangeList.cachedBool

Default: False

List assignments in submission cache.

ExchangeList.inboundBool

Default: False

List inbound files rather than outbound.

ExchangeList.removeBool

Default: False

Remove, rather than list files.

ExchangeList.timestamp_formatUnicode

Default: '%Y-%m-%d %H:%M:%S.%f %Z'

Format string for timestamps

ExchangeList.timezoneUnicode

Default: 'UTC'

Timezone for recording timestamps

ExchangeReleaseAssignment.assignment_dirUnicode

Default: '.'

Local path for storing student assignments. Defaults to ‘.’ which is normally Jupyter’s notebook_dir.

ExchangeReleaseAssignment.forceBool

Default: False

Force overwrite existing files in the exchange.

ExchangeReleaseAssignment.timestamp_formatUnicode

Default: '%Y-%m-%d %H:%M:%S.%f %Z'

Format string for timestamps

ExchangeReleaseAssignment.timezoneUnicode

Default: 'UTC'

Timezone for recording timestamps

ExchangeRelease.assignment_dirUnicode

Default: '.'

Local path for storing student assignments. Defaults to ‘.’ which is normally Jupyter’s notebook_dir.

ExchangeRelease.forceBool

Default: False

Force overwrite existing files in the exchange.

ExchangeRelease.timestamp_formatUnicode

Default: '%Y-%m-%d %H:%M:%S.%f %Z'

Format string for timestamps

ExchangeRelease.timezoneUnicode

Default: 'UTC'

Timezone for recording timestamps

ExchangeReleaseFeedback.assignment_dirUnicode

Default: '.'

Local path for storing student assignments. Defaults to ‘.’ which is normally Jupyter’s notebook_dir.

ExchangeReleaseFeedback.timestamp_formatUnicode

Default: '%Y-%m-%d %H:%M:%S.%f %Z'

Format string for timestamps

ExchangeReleaseFeedback.timezoneUnicode

Default: 'UTC'

Timezone for recording timestamps

ExchangeSubmit.assignment_dirUnicode

Default: '.'

Local path for storing student assignments. Defaults to ‘.’ which is normally Jupyter’s notebook_dir.

ExchangeSubmit.strictBool

Default: False

Whether or not to submit the assignment if there are missing notebooks from the released assignment notebooks.

ExchangeSubmit.timestamp_formatUnicode

Default: '%Y-%m-%d %H:%M:%S.%f %Z'

Format string for timestamps

ExchangeSubmit.timezoneUnicode

Default: 'UTC'

Timezone for recording timestamps

BaseConverter.exporter_classType

Default: 'nbconvert.exporters.notebook.NotebookExporter'

No description

BaseConverter.forceBool

Default: False

Whether to overwrite existing assignments/submissions

BaseConverter.permissionsInt

Default: 0

Permissions to set on files output by nbgrader. The default is generally read-only (444), with the exception of nbgrader generate_assignment and nbgrader generate_feedback, in which case the user also has write permission.

BaseConverter.post_convert_hookAny

Default: None

An optional hook function that you can implement to do some work after converting. This function is called after the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)
BaseConverter.pre_convert_hookAny

Default: None

An optional hook function that you can implement to do some bootstrapping work before converting. This function is called before the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)
GenerateAssignment.create_assignmentBool

Default: True

Whether to create the assignment at runtime if it does not already exist.

GenerateAssignment.exporter_classType

Default: 'nbconvert.exporters.notebook.NotebookExporter'

No description

GenerateAssignment.forceBool

Default: False

Whether to overwrite existing assignments/submissions

GenerateAssignment.no_databaseBool

Default: False

Do not save information about the assignment into the database.

GenerateAssignment.permissionsInt

Default: 0

Permissions to set on files output by nbgrader. The default is generally read-only (444), with the exception of nbgrader generate_assignment and nbgrader generate_feedback, in which case the user also has write permission.

GenerateAssignment.post_convert_hookAny

Default: None

An optional hook function that you can implement to do some work after converting. This function is called after the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)
GenerateAssignment.pre_convert_hookAny

Default: None

An optional hook function that you can implement to do some bootstrapping work before converting. This function is called before the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)
GenerateAssignment.preprocessorsList

Default: [<class 'nbgrader.preprocessors.headerfooter.IncludeHeaderFoo...

No description

Assign.create_assignmentBool

Default: True

Whether to create the assignment at runtime if it does not already exist.

Assign.exporter_classType

Default: 'nbconvert.exporters.notebook.NotebookExporter'

No description

Assign.forceBool

Default: False

Whether to overwrite existing assignments/submissions

Assign.no_databaseBool

Default: False

Do not save information about the assignment into the database.

Assign.permissionsInt

Default: 0

Permissions to set on files output by nbgrader. The default is generally read-only (444), with the exception of nbgrader generate_assignment and nbgrader generate_feedback, in which case the user also has write permission.

Assign.post_convert_hookAny

Default: None

An optional hook function that you can implement to do some work after converting. This function is called after the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)
Assign.pre_convert_hookAny

Default: None

An optional hook function that you can implement to do some bootstrapping work before converting. This function is called before the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)
Assign.preprocessorsList

Default: [<class 'nbgrader.preprocessors.headerfooter.IncludeHeaderFoo...

No description

Autograde.autograde_preprocessorsList

Default: [<class 'nbgrader.preprocessors.execute.Execute'>, <class 'nb...

No description

Autograde.create_studentBool

Default: True

Whether to create the student at runtime if it does not already exist.

Autograde.exclude_overwritingDict

Default: {}

A dictionary with keys corresponding to assignment names and values being a list of filenames (relative to the assignment’s source directory) that should NOT be overwritten with the source version. This is to allow students to e.g. edit a python file and submit it alongside the notebooks in their assignment.

Autograde.exporter_classType

Default: 'nbconvert.exporters.notebook.NotebookExporter'

No description

Autograde.forceBool

Default: False

Whether to overwrite existing assignments/submissions

Autograde.permissionsInt

Default: 0

Permissions to set on files output by nbgrader. The default is generally read-only (444), with the exception of nbgrader generate_assignment and nbgrader generate_feedback, in which case the user also has write permission.

Autograde.post_convert_hookAny

Default: None

An optional hook function that you can implement to do some work after converting. This function is called after the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)
Autograde.pre_convert_hookAny

Default: None

An optional hook function that you can implement to do some bootstrapping work before converting. This function is called before the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)
Autograde.sanitize_preprocessorsList

Default: [<class 'nbgrader.preprocessors.clearoutput.ClearOutput'>, <c...

No description

GenerateFeedback.exporter_classType

Default: 'nbconvert.exporters.notebook.NotebookExporter'

No description

GenerateFeedback.forceBool

Default: False

Whether to overwrite existing assignments/submissions

GenerateFeedback.permissionsInt

Default: 0

Permissions to set on files output by nbgrader. The default is generally read-only (444), with the exception of nbgrader generate_assignment and nbgrader generate_feedback, in which case the user also has write permission.

GenerateFeedback.post_convert_hookAny

Default: None

An optional hook function that you can implement to do some work after converting. This function is called after the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)
GenerateFeedback.pre_convert_hookAny

Default: None

An optional hook function that you can implement to do some bootstrapping work before converting. This function is called before the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)
GenerateFeedback.preprocessorsList

Default: [<class 'nbgrader.preprocessors.getgrades.GetGrades'>, <class...

No description

Feedback.exporter_classType

Default: 'nbconvert.exporters.notebook.NotebookExporter'

No description

Feedback.forceBool

Default: False

Whether to overwrite existing assignments/submissions

Feedback.permissionsInt

Default: 0

Permissions to set on files output by nbgrader. The default is generally read-only (444), with the exception of nbgrader generate_assignment and nbgrader generate_feedback, in which case the user also has write permission.

Feedback.post_convert_hookAny

Default: None

An optional hook function that you can implement to do some work after converting. This function is called after the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)
Feedback.pre_convert_hookAny

Default: None

An optional hook function that you can implement to do some bootstrapping work before converting. This function is called before the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)
Feedback.preprocessorsList

Default: [<class 'nbgrader.preprocessors.getgrades.GetGrades'>, <class...

No description

GenerateSolution.create_assignmentBool

Default: True

Whether to create the assignment at runtime if it does not already exist.

GenerateSolution.exporter_classType

Default: 'nbconvert.exporters.notebook.NotebookExporter'

No description

GenerateSolution.forceBool

Default: False

Whether to overwrite existing assignments/submissions

GenerateSolution.permissionsInt

Default: 0

Permissions to set on files output by nbgrader. The default is generally read-only (444), with the exception of nbgrader generate_assignment and nbgrader generate_feedback, in which case the user also has write permission.

GenerateSolution.post_convert_hookAny

Default: None

An optional hook function that you can implement to do some work after converting. This function is called after the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)
GenerateSolution.pre_convert_hookAny

Default: None

An optional hook function that you can implement to do some bootstrapping work before converting. This function is called before the notebooks are converted and should be used for specific converters such as Autograde, GenerateAssignment or GenerateFeedback.

It will be called as (all arguments are passed as keywords):

hook(assignment=assignment, student=student, notebooks=notebooks)