tcms.testplans.models module¶

class tcms.testplans.models.PlanType(id, name, description)[source]¶

Bases: django.db.models.base.Model, tcms.core.models.base.UrlMixin

exception DoesNotExist¶: Bases: django.core.exceptions.ObjectDoesNotExist

exception MultipleObjectsReturned¶: Bases: django.core.exceptions.MultipleObjectsReturned

description¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

id¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

name¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

objects = <django.db.models.manager.Manager object>¶

testplan_set¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

class tcms.testplans.models.TestPlan(*args, **kwargs)[source]¶

Bases: tree_queries.models.TreeNode, tcms.core.models.base.UrlMixin

A plan within the TCMS

exception DoesNotExist¶: Bases: django.core.exceptions.ObjectDoesNotExist

exception MultipleObjectsReturned¶: Bases: django.core.exceptions.MultipleObjectsReturned

add_case(case, sortkey=None)[source]¶

add_tag(tag)[source]¶

author¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

author_id¶

cases¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

children¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

clone(name=None, product=None, version=None, new_author=None, set_parent=False, copy_testcases=False, **_kwargs)[source]¶

Clone this plan

Parameters:	name (str) – New name of cloned plan. If not passed, make_cloned_name is called to generate a default one. product (`tcms.management.models.Product`) – Product of cloned plan. If not passed, original plan’s product is used. version (`tcms.management.models.Version`) – Product version of cloned plan. If not passed use from source plan. new_author (settings.AUTH_USER_MODEL) – New author of cloned plan. If not passed, original plan’s author is used. set_parent (bool) – Whether to set original plan as parent of cloned plan. Default is False. copy_testcases (bool) – Whether to copy cases to cloned plan instead of just linking them. Default is False. **_kwargs – Unused catch-all variable container for any extra input which may be present
Returns:	cloned plan
Return type:	`tcms.testplans.models.TestPlan`

create_date¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

delete_case(case)[source]¶

email_settings¶

Accessor to the related object on the reverse side of a one-to-one relation.

In the example:

class Restaurant(Model):
    place = OneToOneField(Place, related_name='restaurant')

Place.restaurant is a ReverseOneToOneDescriptor instance.

emailing¶

extra_link¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

get_absolute_url()[source]¶

get_full_url()[source]¶

get_next_by_create_date(*, field=<django.db.models.fields.DateTimeField: create_date>, is_next=True, **kwargs)¶

get_previous_by_create_date(*, field=<django.db.models.fields.DateTimeField: create_date>, is_next=False, **kwargs)¶

history = <django.db.models.manager.HistoryManagerFromHistoricalQuerySet object>¶

id¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

is_active¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

make_cloned_name()[source]¶: Make default name of cloned plan

name¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

parent¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

parent_id¶

product¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

product_id¶

product_version¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

product_version_id¶

remove_tag(tag)[source]¶

run¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

save_without_historical_record(*args, **kwargs)¶

Save model without saving a historical record

Make sure you know what you’re doing before you use this method.

tag¶

Accessor to the related objects manager on the forward and reverse sides of a many-to-many relation.

In the example:

class Pizza(Model):
    toppings = ManyToManyField(Topping, related_name='pizzas')

Pizza.toppings and Topping.pizzas are ManyToManyDescriptor instances.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

testcaseplan_set¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

testplantag_set¶

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

text¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

tree_as_list()[source]¶: Returns the entire tree family as a list of TestPlan object with additional fields from tree_queries!

tree_view_html()[source]¶: Returns nested tree structure represented as Patterfly TreeView! Relies on the fact that tree nodes are returned in DFS order!

type¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

type_id¶

class tcms.testplans.models.TestPlanEmailSettings(id, plan, auto_to_plan_author, auto_to_case_owner, auto_to_case_default_tester, notify_on_plan_update, notify_on_case_update)[source]¶

Bases: django.db.models.base.Model

exception DoesNotExist¶: Bases: django.core.exceptions.ObjectDoesNotExist

exception MultipleObjectsReturned¶: Bases: django.core.exceptions.MultipleObjectsReturned

auto_to_case_default_tester¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

auto_to_case_owner¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

auto_to_plan_author¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

id¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

notify_on_case_update¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

notify_on_plan_update¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

objects = <django.db.models.manager.Manager object>¶

plan¶

Accessor to the related object on the forward side of a one-to-one relation.

In the example:

class Restaurant(Model):
    place = OneToOneField(Place, related_name='restaurant')

Restaurant.place is a ForwardOneToOneDescriptor instance.

plan_id¶

class tcms.testplans.models.TestPlanTag(id, tag, plan)[source]¶

Bases: django.db.models.base.Model

exception DoesNotExist¶: Bases: django.core.exceptions.ObjectDoesNotExist

exception MultipleObjectsReturned¶: Bases: django.core.exceptions.MultipleObjectsReturned

id¶: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

objects = <django.db.models.manager.Manager object>¶

plan¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

plan_id¶

tag¶

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

tag_id¶