Compsci 101, Fall 2014, Totem Howto

In this howto there's a discussion about getting started, Totem standards you must adhere to, raw strings, and random/if.

Getting Started

Create a new Pydev project. You can call the project by any name, but we suggest compsci101-totem to help you identify the project in your workspace. You must create a Python module named Totem.py and write functions in that module. The code you write must conform to the totem standards below. When you create the module, let Eclipse create the __name__ == '__main__' boilerplate for you.

Totem Standards

  1. Each function that you write to draw a part of a totem should have one of the following labels as the first part of the function name. Every function you write should begin with one of these strings. Please do not write helper functions that these call, even if such functions would make it simpler for you to write these functions. Please do not write nested/inner functions either. Each function you write should start with one of the labels below, then have an underscore character, then some "meaningful" description of the function.

    For example function names can be chin_cleft, hair_bald, mouth_open, or mouth_v1. You cannot use a name like mouth or earClogged because these don't conform to the naming specification. The "meaningful" description can be anything.

  2. Each function must return a string that is thirteen characters "wide". The string can be a mult-line string, where each line is thirteen characters in length. e.g., you can write the function hair_part below: def hair_part(): a1 = r"1234567890123" a2 = r"|||||||||||||" a3 = r"\\\\\\|||||||" return a2 + "\n" + a3 To be more precise, the string returned by each of these functions must have length 13*k + (k-1) where k is the number of lines represented by the string. A one-line string will be exactly 13-characters, a two-line string will be two lines of 13 separated by one new line character so it's length will be 27 = 13*2 + (2-1) characters

    Some of the characters in each line can be spaces, but each must have length thirteen as a string (again, multi-line strings are fine).

  3. Each of the functions whose name is based on one of the parts above must return a string. You will write two functions that don't return strings, but instead print the strings that make up a totem-pole. One of these functions should be named totem and another should be named randompole. The first will print the same totem-pole each time it is called. The totem-pole must consist of at least three different "heads". You can also write functions to create individual heads that print the values returned by the so-called parts functions.

    The function, randompole, should create different poles each time it is called based on using the Python random module and using if/elif statements. Hats should be randomly added to the head or not added. (so not all heads may have a hat on).

  4. According to the instructions in the assignment, you must have one function named totem that results in generating three totem heads.

  5. You should use the main Python idiom we've seen to run either totem or randompole when the program is run, e.g., from Eclipse: if __name__ == "__main__": randompole() However you should test your totem function as well, not just the randompole function.

Creating and Printing Strings

All strings you return and print should use what Python calls "raw" Strings. Strings preceded by a letter r before the double quote that begins the string will result in the string being printed without the need for any escape backslashes. For example: print "\" generates an error in Python because the second quote has been escaped, however print "\\" will print one backslash. To avoid the need to line things up when backslashes are escaped, use raw strings as shown in the example below. print r"| \\// |" print r"| --- |" the letter 'r' before the string means that whatever follows the 'r' will be printed exactly as shown, no characters will be interpreted as escape characters or in any other way, they'll simply be printed. You can combine raw strings with other characters by concatenting them in one line as shown below for the function hair_parted that conforms to the totem standards. 
    def hair_parted():
        return " "*3 + r"\\\\\\\\//"
Note that in this example, 3 spaces are concatenated to 10 characters in a raw string because " "*3 is a three-space string.

NOTE ADDED SEPT 10 at 11:45am:

There is one exception to using raw strings. You cannot end the string with a single backslash (or actually an odd number of backslashes). If you want to end the string with a single backslash (or odd number of backslashes) then add a blank at the end and it is ok to be of length 13+1 blank, so length 14 for that string. Here is an example. Use the second a2 line. 

   def hair_pointy():
       a1 = r"1234567890123"
       a2 = r"/\/\/\_/\/\/\"    # THIS GIVES A SYNTAX ERROR because it ends
                                # in a single backslash
       a2 = r"/\/\/\_/\/\/\ "   # Instead use this line which has a 14th 
                                # character that is a blank after the backslash
       a3 = r"|           |"
       return a2 + "\n" + a3

Random if/else

NOTE: THIS SECTION MODIFIED on SEPT 7, 11am to fix the typo, the function used should be randint. Also best to put import statements at the top of the file before any python code.

To use random numbers you must import the random library and then call the function random.randint(low,high).

When you use an import statement, it is best to put them near the top of the file before any defs or other code so that any of your code can use the imports.

The example below returns three different strings with equal probability.

def random_chin(): choice = random.randint(1,3) if choice == 1: return chin_cleft() elif choice == 2: return chin_beard() else: return chin_pointy()

NOTE: BELOW HERE ADDED SEPT 7, 11pm

What does Totem() look like:

Totem should print three heads and might look like (assuming these are functions you wrote): 

def totem():
    # head 1
    print hat_tall()
    print hair_plain()
    print eyes_slanted()
    print nose_big()
    print mouth_small()
    print chin_plain()
    # heads 2 and 3 follow and are not shown

if __name__ == '__main__':
    totem()

OR ANOTHER WAY. You might have created functions for each head called head1(), head2() and head3(). Then you might have: 

def head1():
    print hat_tall()
    print hair_plain()
    print eyes_slanted()
    print nose_big()
    print mouth_small()
    print chin_plain()
    
def totem():
    head1()
    [rest of code not shown]


if __name__ == '__main__':
    totem()