[New-bugs-announce] [issue33545] Docs for uuid don't mention that uuid1 can repeat in some circumstances

[merelymoray]

New submission from merelymoray <arcadesrofocale at yahoo.co.uk>:

https://docs.python.org/3.6/library/uuid.html#uuid.UUID

uuid.uuid1(node=None, clock_seq=None)

Generate a UUID from a host ID, sequence number, and the current time. If node is not given, getnode() is used to obtain the hardware address. If clock_seq is given, it is used as the sequence number; otherwise a random 14-bit sequence number is chosen.


^^

This neglects to mention that if you call uuid1() in quick succession with no parameters, you can get a repeat uuid.

I had a bug because of this.

It would have been nice if the docs mentioned the fact directly. 

It's only a sentence to add, and would have saved a lot of time.

----------
assignee: docs at python
components: Documentation
messages: 316844
nosy: docs at python, merelymoray
priority: normal
severity: normal
status: open
title: Docs for uuid don't mention that uuid1 can repeat in some circumstances
type: enhancement
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33545>
_______________________________________