1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
= Code Import Results =
A CodeImportResult is a record of a completed code import job. They
are accessed via a utility registered for the ICodeImportResultSet
interface.
>>> from lp.code.interfaces.codeimportresult import (
... ICodeImportResult, ICodeImportResultSet)
>>> result_set = getUtility(ICodeImportResultSet)
>>> from canonical.launchpad.webapp.testing import verifyObject
>>> verifyObject(ICodeImportResultSet, result_set)
True
The ICodeImportResultSet interface defines methods for creating and
retrieving CodeImportResult objects.
CodeImports are hidden from regular users currently. David Allouche is a
member of the vcs-imports team and can access the objects freely.
>>> login('david.allouche@canonical.com')
== Creating CodeImportResults ==
Creating CodeImportResult objects is usually done by the finishJob()
method of the CodeImportWorkflow utility, but here we use the object
factory.
>>> log_data = 'several\nlines\nof\nlog data'
>>> log_excerpt = log_data.splitlines()[-1]
>>> log_alias = factory.makeLibraryFileAlias(content=log_data)
>>> log_alias_id = log_alias.id
Then commit the transaction, so the external librarian process can see
it.
>>> from transaction import commit
>>> commit()
>>> from canonical.launchpad.interfaces.librarian import (
... ILibraryFileAliasSet)
>>> log_alias = getUtility(ILibraryFileAliasSet)[log_alias_id]
>>> sample_import = factory.makeCodeImport()
Then create a result object.
>>> from lp.testing import time_counter
>>> from pytz import UTC
>>> from datetime import datetime, timedelta
>>> time_source = time_counter(
... datetime(2008, 1, 1, tzinfo=UTC),
... timedelta(days=1))
>>> odin = factory.makeCodeImportMachine(hostname="odin")
>>> from lp.code.enums import CodeImportResultStatus
>>> new_result = factory.makeCodeImportResult(
... sample_import, result_status=CodeImportResultStatus.SUCCESS,
... date_started=time_source.next(), log_excerpt=log_excerpt,
... log_alias=log_alias, machine=odin)
>>> verifyObject(ICodeImportResult, new_result)
True
CodeImportResult objects themselves have no behaviour, they are just
read-only records of what happened.
>>> print new_result.machine.hostname
odin
>>> print new_result.requesting_user
None
>>> print new_result.log_excerpt
log data
In order to read the actual log file, the transaction needs to be committed
for the Librarian to save the file.
>>> print new_result.log_file.read()
several
lines
of
log data
>>> print new_result.status.name
SUCCESS
>>> from canonical.launchpad.ftests import print_date_attribute
>>> print_date_attribute(new_result, 'date_job_started')
2008-01-01 00:00:00+00:00
The code import result date_job_finished does not exist in the DB but
instead is an alias to date_created.
>>> print_date_attribute(new_result, 'date_created')
2008-01-01 04:00:00+00:00
>>> print new_result.date_job_finished
2008-01-01 04:00:00+00:00
A helper property exists to give the duration of the job run.
>>> print new_result.job_duration
4:00:00
== Retrieving CodeImportResults ==
The CodeImportResult objects for a given import can be retrieved in
reverse chronological order with the results attribute on a code import.
We need to create a few result objects before we can test that this
method works as expected.
>>> oldest_result = new_result
>>> middle_result = factory.makeCodeImportResult(
... sample_import, date_started = time_source.next())
>>> newest_result = factory.makeCodeImportResult(
... sample_import, date_started = time_source.next())
Results for other imports of course should not be present in the
results, so we should create one of those just to be sure that it's
not present.
>>> result_for_other_import = factory.makeCodeImportResult()
Then we can test that the results are in the order expected.
>>> results = list(sample_import.results)
>>> len(results)
3
>>> results.index(newest_result)
0
>>> results.index(middle_result)
1
>>> results.index(oldest_result)
2
|