behat_generator_base Class Reference

Inheritance diagram for behat_generator_base:

Public Member Functions
	__construct (string $component)
	Constructor. More...
	generate_items (string $generatortype, TableNode $data, bool $singular=false)
	Do the work to generate an entity. More...

Protected Member Functions
	get_category_id ($idnumber)
	Gets the category id from it's idnumber. More...
	get_cohort_id ($idnumber)
	Gets the cohort id from it's idnumber. More...
	get_contact_id ($username)
	Gets the contact id from it's username. More...
	get_context ($levelname, $contextref)
	Gets the internal context id from the context reference. More...
	get_course_id ($shortname)
	Gets the course id from it's shortname. More...
	get_creatable_entities ()
	Get a list of the entities that can be created for this component. More...
	get_gradecategory_id ($fullname)
	Gets the grade category id from the grade category fullname. More...
	get_group_id ($idnumber)
	Gets the group id from it's idnumber. More...
	get_grouping_id ($idnumber)
	Gets the grouping id from it's idnumber. More...
	get_outcome_id ($shortname)
	Gets the outcome item id from its shortname. More...
	get_questioncategory_id ($name)
	Get the id of a named question category (must be globally unique). More...
	get_role_id ($roleshortname)
	Gets the role id from it's shortname. More...
	get_scale_id ($name)
	Get the id of a named scale. More...
	get_user_id ($username)
	Gets the user id from it's username. More...
	name_for_errors (string $entitytype)
	Helper for formatting error messages. More...

Protected Attributes
string	$component
	the name of the component we belong to. More...
testing_data_generator	$componentdatagenerator
	the data generator for this component.
testing_data_generator	$datagenerator
	the core data generator

Constructor & Destructor Documentation

__construct()

behat_generator_base::__construct

(

string

$component

)

Constructor.

Parameters

string

$component

component name, to make error messages more readable.

Member Function Documentation

generate_items()

behat_generator_base::generate_items	(	string	$generatortype,
		TableNode	$data,
		bool	$singular = false
	)

Do the work to generate an entity.

This is called by behat_data_generators::the_following_entities_exist().

Parameters

string	$generatortype	The name of the entity to create.
TableNode	$data	from the step.
bool	$singular	Whether there is only one record and it is pivotted

get_category_id()

behat_generator_base::get_category_id (   $idnumber )

protected

Gets the category id from it's idnumber.

Exceptions

Exception

Parameters

string

$idnumber

Return values

int

get_cohort_id()

behat_generator_base::get_cohort_id (   $idnumber )

protected

Gets the cohort id from it's idnumber.

Exceptions

Exception

Parameters

string

$idnumber

Return values

int

get_contact_id()

behat_generator_base::get_contact_id (   $username )

protected

Gets the contact id from it's username.

Exceptions

Exception

Parameters

string

$username

Return values

int

get_context()

behat_generator_base::get_context (   $levelname,   $contextref  )

protected

Gets the internal context id from the context reference.

The context reference changes depending on the context level, it can be the system, a user, a category, a course or a module.

Exceptions

Exception

Parameters

string	$levelname	The context level string introduced by the test writer
string	$contextref	The context reference introduced by the test writer

Return values

context

get_course_id()

behat_generator_base::get_course_id (   $shortname )

protected

Gets the course id from it's shortname.

Exceptions

Exception

Parameters

string

$shortname

Return values

int

get_creatable_entities()

behat_generator_base::get_creatable_entities ( )

abstractprotected

Get a list of the entities that can be created for this component.

This function must be overridden in subclasses. See class comment above for a description of the data structure. See behat_core_generator for an example.

Return values

array

entity name => information about how to generate.

Reimplemented in behat_core_question_generator, behat_mod_quiz_generator, and behat_core_generator.

get_gradecategory_id()

behat_generator_base::get_gradecategory_id (   $fullname )

protected

Gets the grade category id from the grade category fullname.

Parameters

string

$fullname

the grade category name.

Return values

int	corresponding id.

get_group_id()

behat_generator_base::get_group_id (   $idnumber )

protected

Gets the group id from it's idnumber.

Exceptions

Exception

Parameters

string

$idnumber

Return values

int

get_grouping_id()

behat_generator_base::get_grouping_id (   $idnumber )

protected

Gets the grouping id from it's idnumber.

Exceptions

Exception

Parameters

string

$idnumber

Return values

int

get_outcome_id()

behat_generator_base::get_outcome_id (   $shortname )

protected

Gets the outcome item id from its shortname.

Exceptions

Exception

Parameters

string

$shortname

Return values

int

get_questioncategory_id()

behat_generator_base::get_questioncategory_id (   $name )

protected

Get the id of a named question category (must be globally unique).

Note that 'Top' is a special value, used when setting the parent of another category, meaning top-level.

Parameters

string

$name

the question category name.

Return values

int	the question category id.

get_role_id()

behat_generator_base::get_role_id (   $roleshortname )

protected

Gets the role id from it's shortname.

Exceptions

Exception

Parameters

string

$roleshortname

Return values

int

get_scale_id()

behat_generator_base::get_scale_id (   $name )

protected

Get the id of a named scale.

Parameters

string

$name

the name of the scale.

Return values

int	the scale id.

get_user_id()

behat_generator_base::get_user_id (   $username )

protected

Gets the user id from it's username.

Exceptions

Exception

Parameters

string

$username

Return values

int

name_for_errors()

behat_generator_base::name_for_errors ( string  $entitytype )

protected

Helper for formatting error messages.

Parameters

string

$entitytype

entity type without prefix, e.g. 'frog'.

Return values

string

either 'frog' for core entities, or 'mod_mymod > frog' for components.

Member Data Documentation

$component

string behat_generator_base::$component

protected

the name of the component we belong to.

This should probably only be used to make error messages clearer.

---

The documentation for this class was generated from the following file:

• lib/behat/classes/behat_generator_base.php