~launchpad-pqm/launchpad/devel

« back to all changes in this revision

Viewing changes to lib/lp/registry/doc/distroseries.txt

Change all uses of 'initialise' to 'initialize'.

Show diffs side-by-side

added added

removed removed

Lines of Context:
294
294
    partner
295
295
 
296
296
 
297
 
DistroSeries can be initialised from their parents
 
297
DistroSeries can be initialized from their parents
298
298
--------------------------------------------------
299
299
 
300
300
When a distroseries is derived from another distroseries (be it a
301
301
derivative distribution, or simply the next release in a sequence from
302
 
Ubuntu) we need to initialise the new release with quite a lot of
 
302
Ubuntu) we need to initialize the new release with quite a lot of
303
303
information. Not least of which is the section and component
304
304
selections and the publishing information for the distroseries.
305
305
 
308
308
thousands of rows around in order to set up a distroseries.
309
309
 
310
310
IDistroSeries lists a series of preconditions for performing an
311
 
initialisation. In particular the initialiser won't overwrite
 
311
initialization. In particular the initializer won't overwrite
312
312
publishing records etc. Essentially this is a "Do not push this button
313
313
again" type set of assertions.
314
314
 
315
 
    >>> from lp.soyuz.scripts.initialise_distroseries import (
316
 
    ...     InitialiseDistroSeries)
 
315
    >>> from lp.soyuz.scripts.initialize_distroseries import (
 
316
    ...     InitializeDistroSeries)
317
317
    >>> login("foo.bar@canonical.com")
318
318
    >>> humpy = ubuntu.newSeries('humpy', 'Humpy Hippo',
319
319
    ...                          'The Humpy Hippo', 'Fat', 'Yo Momma',
320
320
    ...                          '99.2', None, hoary.owner)
321
 
    >>> ids = InitialiseDistroSeries(humpy, [hoary.id])
322
 
    >>> ids.initialise()
 
321
    >>> ids = InitializeDistroSeries(humpy, [hoary.id])
 
322
    >>> ids.initialize()
323
323
    >>> hoary.getPublishedSources('pmount').count()
324
324
    1
325
325
    >>> humpy.getPublishedSources('pmount').count()
329
329
    >>> len(humpy['i386'].getReleasedPackages('pmount'))
330
330
    1
331
331
 
332
 
Check if the attributes of an DRSPR instance for the just initialised
 
332
Check if the attributes of an DRSPR instance for the just initialized
333
333
distroseries are sane. A DRSPR instance should filter attributes of
334
334
a SPR according the distroseries in question (practically according
335
335
what is published in this distrorelelase)
336
336
 
337
 
Since the initialise-from-parent procedure copies the latest
 
337
Since the initialize-from-parent procedure copies the latest
338
338
publications from the parent IDRSPR.builds should be empty, reflecting
339
339
that there are no builds for this SPR in this DistroSeries.
340
340
IDRSPR.builds will be non-empty after a developer submits a new SPR
346
346
resulted of the sourcepackagerelease in question, but built anywhere.
347
347
(fix bug #52938)
348
348
 
349
 
Initialise a new distroseries based on warty (since it has, at least
 
349
Initialize a new distroseries based on warty (since it has, at least
350
350
one coherent published source + binary, mozilla-firefox)
351
351
 
352
352
    >>> bumpy = ubuntu.newSeries('bumpy', 'Bumpy',
353
353
    ...                          'The Bumpy', 'Fat', 'Boom',
354
354
    ...                          '99.3', None, warty.owner)
355
 
    >>> ids = InitialiseDistroSeries(bumpy, [warty.id])
356
 
    >>> ids.initialise()
 
355
    >>> ids = InitializeDistroSeries(bumpy, [warty.id])
 
356
    >>> ids.initialize()
357
357
 
358
358
Build a new ISourcePackage based in the new distroseries:
359
359