Metadata-Version: 2.1
Name: leapseconddata
Version: 4.0.0
Summary: Use the list of known and scheduled leap seconds
Home-page: https://github.com/jepler/leapseconddata
Author: Jeff Epler
Author-email: jepler@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: click

<!--
SPDX-FileCopyrightText: 2021 Jeff Epler

SPDX-License-Identifier: GPL-3.0-only
-->
[![Test leapseconddata](https://github.com/jepler/leapseconddata/actions/workflows/test.yml/badge.svg)](https://github.com/jepler/leapseconddata/actions/workflows/test.yml)
[![PyPI](https://img.shields.io/pypi/v/leapseconddata)](https://pypi.org/project/leapseconddata)
[![Documentation Status](https://readthedocs.org/projects/leapseconddata/badge/?version=latest)](https://leapseconddata.readthedocs.io/en/latest/?badge=latest)

# Python Leap Second List

Leap seconds are corrections applied irregularly so that the UTC day stays
fixed to the earth's rotation.

This module provides a class for parsing and validating the standard
`leap-seconds.list` file.  Once parsed, it is possible to retrieve the
full list of leap seconds, or find the TAI-UTC offset for any UTC time.

# `leapsecond` program

Access leap second data from the command line.

```
Usage: leapsecond [OPTIONS] COMMAND [ARGS]...

  Access leap second database information

Options:
  --url TEXT            URL for leap second data (unspecified to use default
                        source
  --debug / --no-debug
  --help                Show this message and exit.

Commands:
  convert              Convert timestamps between TAI and UTC
  info                 Show information about leap second database
  next-leapsecond      Get the next leap second after a given UTC timestamp
  offset               Get the UTC offset for a given moment, in seconds
  previous-leapsecond  Get the last leap second before a given UTC timestamp
  table                Print information about leap seconds
```
