Skip to content

receivers

delete_markov_models_before_orphaning 

delete_markov_models_before_orphaning(
    sender, instance, *args, **kwargs
)

When deleting a source or source group, ensure that its text_model is deleted first.

Source code in src/django_quotes/receivers.py 
113
114
115
116
117
118
@receiver(pre_delete, sender=Source)
@receiver(pre_delete, sender=SourceGroup)
def delete_markov_models_before_orphaning(sender, instance, *args, **kwargs):
    """When deleting a source or source group, ensure that its text_model is deleted first."""
    if instance.text_model is not None:
        instance.text_model.delete()

initialize_grouping_stat_object 

initialize_grouping_stat_object(
    sender, instance, created, *args, **kwargs
)

Creates the initial stat objects in the database.

Source code in src/django_quotes/receivers.py 
36
37
38
39
40
41
42
43
44
45
46
47
48
49
@receiver(post_save, sender=SourceGroup)
@receiver(post_save, sender=Source)
@receiver(post_save, sender=Quote)
def initialize_grouping_stat_object(sender, instance, created, *args, **kwargs):
    """
    Creates the initial stat objects in the database.
    """
    if created:
        if sender == SourceGroup:
            GroupStats.objects.create(group=instance)
        elif sender == Source:
            SourceStats.objects.create(source=instance)
        elif sender == Quote:
            QuoteStats.objects.create(quote=instance)

initialize_markov_object 

initialize_markov_object(sender, instance, *args, **kwargs)

Creates the one-to-one object for the group markov model.

Source code in src/django_quotes/receivers.py 
26
27
28
29
30
31
32
33
@receiver(pre_save, sender=SourceGroup)
@receiver(pre_save, sender=Source)
def initialize_markov_object(sender, instance, *args, **kwargs):
    """
    Creates the one-to-one object for the group markov model.
    """
    if not instance.text_model:
        instance.text_model = MarkovTextModel.objects.create()

update_markov_model_for_character_enabling_markov 

update_markov_model_for_character_enabling_markov(
    sender, instance, *args, **kwargs
)

When updating a source to allow_markov, trigger markov model updates.

Source code in src/django_quotes/receivers.py 
100
101
102
103
104
105
106
107
108
109
110
@receiver(pre_save, sender=Source)
def update_markov_model_for_character_enabling_markov(sender, instance, *args, **kwargs):
    """
    When updating a source to allow_markov, trigger markov model updates.
    """
    if instance.id and instance.allow_markov:
        old_version = Source.objects.get(id=instance.id)
        if not old_version.allow_markov:
            instance.update_markov_model()
            instance.text_model.refresh_from_db()
            instance.group.update_markov_model(additional_model=instance.text_model)

update_stats_for_markov 

update_stats_for_markov(
    sender, instance, char_limit, sentence, *args, **kwargs
)

For a given source, update the stats on the Source and SourceGroup for markov requests. :param sender: The requesting class, usually Source. :param instance: The specific source requested. :param char_limit: The character limit used when generating the sentence. :param sentence: The sentence that was generated. :return: None

Source code in src/django_quotes/receivers.py 
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
@receiver(sentence_generated, sender=MarkovTextModel)
def update_stats_for_markov(sender, instance, char_limit, sentence, *args, **kwargs):
    """
    For a given source, update the stats on the Source and SourceGroup for markov requests.
    :param sender: The requesting class, usually Source.
    :param instance: The specific source requested.
    :param char_limit: The character limit used when generating the sentence.
    :param sentence: The sentence that was generated.
    :return: None
    """
    try:
        source = Source.objects.get(text_model__pk=instance.pk)
        group = source.group
    except ObjectDoesNotExist:
        # this is a group model
        source = None
        group = SourceGroup.objects.get(text_model__pk=instance.pk)
    group_stats = group.stats
    source_stats = source.stats if source else None
    with transaction.atomic():
        group_stats.quotes_generated = F("quotes_generated") + 1
        group_stats.save()
        if source_stats is not None:
            source_stats.quotes_generated = F("quotes_generated") + 1
            source_stats.save()

update_stats_for_quote_character 

update_stats_for_quote_character(
    sender, instance, quote_retrieved, *args, **kwargs
)

Update the stats for the source, source group, and quote for a random retrieval. :param sender: Usually a source or sourcegroup class. :param instance: The source this was generated for. :param quote_retrieved: The quote that was returned. :return: None

Source code in src/django_quotes/receivers.py 
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
@receiver(quote_random_retrieved, sender=Source)
def update_stats_for_quote_character(sender, instance, quote_retrieved, *args, **kwargs):
    """
    Update the stats for the source, source group, and quote for a random retrieval.
    :param sender: Usually a source or sourcegroup class.
    :param instance: The source this was generated for.
    :param quote_retrieved: The quote that was returned.
    :return: None
    """
    group_stats = instance.group.stats
    character_stats = instance.stats
    quote_stats = quote_retrieved.stats
    with transaction.atomic():
        group_stats.quotes_requested = F("quotes_requested") + 1
        group_stats.save()
        character_stats.quotes_requested = F("quotes_requested") + 1
        character_stats.save()
        quote_stats.times_used = F("times_used") + 1
        quote_stats.save()