| Alphare |
| hg-reviewers |
| Automatic diff as part of commit; lint not applicable. |
| Automatic diff as part of commit; unit tests not applicable. |
| Path | Packages | |||
|---|---|---|---|---|
| M | mercurial/dirstateutils/timestamp.py (8 lines) |
| Status | Author | Revision | |
|---|---|---|---|
| Closed | SimonSapin | ||
| Closed | SimonSapin |
| @functools.total_ordering | @functools.total_ordering | ||||
| class timestamp(tuple): | class timestamp(tuple): | ||||
| """ | """ | ||||
| A Unix timestamp with optional nanoseconds precision, | A Unix timestamp with optional nanoseconds precision, | ||||
| modulo 2**31 seconds. | modulo 2**31 seconds. | ||||
| A 2-tuple containing: | A 3-tuple containing: | ||||
| `truncated_seconds`: seconds since the Unix epoch, | `truncated_seconds`: seconds since the Unix epoch, | ||||
| truncated to its lower 31 bits | truncated to its lower 31 bits | ||||
| `subsecond_nanoseconds`: number of nanoseconds since `truncated_seconds`. | `subsecond_nanoseconds`: number of nanoseconds since `truncated_seconds`. | ||||
| When this is zero, the sub-second precision is considered unknown. | When this is zero, the sub-second precision is considered unknown. | ||||
| `second_ambiguous`: whether this timestamp is still "reliable" | |||||
| (see `reliable_mtime_of`) if we drop its sub-second component. | |||||
| """ | """ | ||||
| def __new__(cls, value): | def __new__(cls, value): | ||||
| truncated_seconds, subsec_nanos, second_ambiguous = value | truncated_seconds, subsec_nanos, second_ambiguous = value | ||||
| value = (truncated_seconds & rangemask, subsec_nanos, second_ambiguous) | value = (truncated_seconds & rangemask, subsec_nanos, second_ambiguous) | ||||
| return super(timestamp, cls).__new__(cls, value) | return super(timestamp, cls).__new__(cls, value) | ||||
| def __eq__(self, other): | def __eq__(self, other): | ||||
| billion = int(1e9) | billion = int(1e9) | ||||
| secs = nanos // billion | secs = nanos // billion | ||||
| subsec_nanos = nanos % billion | subsec_nanos = nanos % billion | ||||
| return timestamp((secs, subsec_nanos, False)) | return timestamp((secs, subsec_nanos, False)) | ||||
| def reliable_mtime_of(stat_result, present_mtime): | def reliable_mtime_of(stat_result, present_mtime): | ||||
| """same as `mtime_of`, but return None if the date might be ambiguous | """Same as `mtime_of`, but return `None` or a `Timestamp` with | ||||
| `second_ambiguous` set if the date might be ambiguous. | |||||
| A modification time is reliable if it is older than "present_time" (or | A modification time is reliable if it is older than "present_time" (or | ||||
| sufficiently in the future). | sufficiently in the future). | ||||
| Otherwise a concurrent modification might happens with the same mtime. | Otherwise a concurrent modification might happens with the same mtime. | ||||
| """ | """ | ||||
| file_mtime = mtime_of(stat_result) | file_mtime = mtime_of(stat_result) | ||||
| file_second = file_mtime[0] | file_second = file_mtime[0] | ||||