# Tutorial Tweeting Game Stats


This tutorial will create a simple script that will send a tweet to your already configured twitter
account. Please see: [How to connect Evennia to Twitter](./How-to-connect-Evennia-to-Twitter.md) if you
haven't already done so.

The script could be expanded to cover a variety of statistics you might wish to tweet about
regularly, from player deaths to how much currency is in the economy etc.

```python
# evennia/typeclasses/tweet_stats.py

import twitter
from random import randint
from django.conf import settings
from evennia import ObjectDB
from evennia import spawner
from evennia import logger
from evennia import DefaultScript

class TweetStats(DefaultScript):
    """
    This implements the tweeting of stats to a registered twitter account
    """

    # standard Script hooks

    def at_script_creation(self):
        "Called when script is first created"

        self.key = "tweet_stats"
        self.desc = "Tweets interesting stats about the game"
        self.interval = 86400  # 1 day timeout
        self.start_delay = False
        
    def at_repeat(self):
        """
        This is called every self.interval seconds to tweet interesting stats about the game.
        """
        
        api = twitter.Api(consumer_key='consumer_key',
          consumer_secret='consumer_secret',
          access_token_key='access_token_key',
          access_token_secret='access_token_secret')
        
        number_tweet_outputs = 2

        tweet_output = randint(1, number_tweet_outputs)

        if tweet_output == 1:
        ##Game Chars, Rooms, Objects taken from @stats command
            nobjs = ObjectDB.objects.count()
            base_char_typeclass = settings.BASE_CHARACTER_TYPECLASS
            nchars = ObjectDB.objects.filter(db_typeclass_path=base_char_typeclass).count()
            nrooms = ObjectDB.objects.filter(db_location__isnull=True).exclude(db_typeclass_path=bas
e_char_typeclass).count()
            nexits = ObjectDB.objects.filter(db_location__isnull=False,
db_destination__isnull=False).count()
            nother = nobjs - nchars - nrooms - nexits
            tweet = "Chars: %s, Rooms: %s, Objects: %s" %(nchars, nrooms, nother)
        else:
            if tweet_output == 2: ##Number of prototypes and 3 random keys - taken from @spawn
command
                prototypes = spawner.spawn(return_prototypes=True)
            
                keys = prototypes.keys()
                nprots = len(prototypes)
                tweet = "Prototype Count: %s  Random Keys: " % nprots

                tweet += " %s" % keys[randint(0,len(keys)-1)]
                for x in range(0,2): ##tweet 3
                    tweet += ", %s" % keys[randint(0,len(keys)-1)]
        # post the tweet
        try:
            response = api.PostUpdate(tweet)
        except:
            logger.log_trace("Tweet Error: When attempting to tweet %s" % tweet)
```

In the `at_script_creation` method, we configure the script to fire immediately (useful for testing)
and setup the delay (1 day) as well as script information seen when you use `@scripts`

In the `at_repeat` method (which is called immediately and then at interval seconds later) we setup
the Twitter API (just like in the initial configuration of twitter).  numberTweetOutputs is used to
show how many different types of outputs we have (in this case 2).  We then build the tweet based on
randomly choosing between these outputs.

1. Shows the number of Player Characters, Rooms and Other/Objects
2. Shows the number of prototypes currently in the game and then selects 3 random keys to show

[Scripts Information](./Scripts.md) will show you how to add it as a Global script, however, for testing
it may be useful to start/stop it quickly from within the game.  Assuming that you create the file
as `mygame/typeclasses/tweet_stats.py` it can be started by using the following command

    @script Here = tweet_stats.TweetStats