blob: 1b6d0f069ffaad083d767f1e85da408d3f6ebc8b [file] [log] [blame]
>>> import uuid
>>> import datetime
>>> from _init_environment import MTurkConnection, mturk_host
>>> from boto.mturk.question import Question, QuestionContent, AnswerSpecification, FreeTextAnswer
>>>
>>> conn = MTurkConnection(host=mturk_host)
>>> keywords=['boto', 'test', 'doctest']
>>> hit_type_rs = conn.register_hit_type('Boto Test HIT type',
... 'HIT Type for testing Boto',
... 0.12,
... 60*6,
... keywords=keywords,
... approval_delay=60*60)
# this was a valid request
>>> hit_type_rs.status
True
# the HIT Type Id is a unicode string
>>> hit_type_id = hit_type_rs.HITTypeId
>>> hit_type_id # doctest: +ELLIPSIS
u'...'
# create content for a question
>>> qn_content = QuestionContent()
>>> qn_content.append_field('Title', 'Boto question content create_hit_from_hit_type')
>>> qn_content.append_field('Text', 'What is a boto create_hit_from_hit_type?')
# create the question specification
>>> qn = Question(identifier=str(uuid.uuid4()),
... content=qn_content,
... answer_spec=AnswerSpecification(FreeTextAnswer()))
# now, create the actual HIT for the question using the HIT type
# NOTE - the response_groups are specified to get back additional information for testing
>>> create_hit_rs = conn.create_hit(hit_type=hit_type_rs.HITTypeId,
... question=qn,
... lifetime=60*65,
... max_assignments=2,
... annotation='An annotation from boto create_hit_from_hit_type test',
... response_groups=['Minimal',
... 'HITDetail',
... 'HITQuestion',
... 'HITAssignmentSummary',])
# this is a valid request
>>> create_hit_rs.status
True
>>> len(create_hit_rs)
1
>>> hit = create_hit_rs[0]
# for the requested hit type id
>>> hit.HITTypeId == hit_type_id
True
# with the correct number of maximum assignments
>>> hit.MaxAssignments
u'2'
# and the approval delay
>>> hit.AutoApprovalDelayInSeconds
u'3600'
# expiration should be very close to now + the lifetime in seconds
>>> expected_datetime = datetime.datetime.utcnow() + datetime.timedelta(seconds=3900)
>>> expiration_datetime = datetime.datetime.strptime(hit.Expiration, '%Y-%m-%dT%H:%M:%SZ')
>>> delta = expected_datetime - expiration_datetime
>>> abs(delta).seconds < 5
True
# duration is as specified for the HIT type
>>> hit.AssignmentDurationInSeconds
u'360'
# the reward has been set correctly
>>> float(hit.Amount) == 0.12
True
>>> hit.FormattedPrice
u'$0.12'
# only US currency supported at present
>>> hit.CurrencyCode
u'USD'
# title is the HIT type title
>>> hit.Title
u'Boto Test HIT type'
# title is the HIT type description
>>> hit.Description
u'HIT Type for testing Boto'
# annotation is correct
>>> hit.RequesterAnnotation
u'An annotation from boto create_hit_from_hit_type test'
# not reviewed yet
>>> hit.HITReviewStatus
u'NotReviewed'