Skip to content

alexhsamuel/ora

Repository files navigation

Documentation Status

Ora is a freestanding time and date implementation for C++ and Python.

Docs at http://ora.readthedocs.io/en/latest/.

Motivation

Many Python time libraries already exist, including the standard library datetime module.

Ora provides:

  • An opinionated, concise API centered around physical times.
  • Built-in time zones.
  • High performance for all operations.
  • Multiple widths and precisions for times and dates.
  • Rich C++ interoperability.

Ora is not a drop-in replacement for datetime or other Python time libraries, but supports easy interoperability.

Limitations

Ora is currently prerelease software; bugs are plentiful, and APIs are subject to change.

Scope

Similar to datetime, Ora uses the (proleptic) Gregorian calendar, for years 1 – 9999 only. Alternate calendars and B.C.E. dates are not provided. There is no support for leap seconds, relativistic effects, or astronomical times. However, time precision of 1 ns or smaller is supported.

Platform

  • Requires C++17 and Python 3.6+.
  • Tested on Linux and MacOS. Currently no Windows support.
  • Tested on x86-64 only.

Installation

Ora is distributed:

  • On PyPI, as source and Linux x64 / MacOS binary wheels:

    pip install ora
    
  • On Anaconda, as Linux x64 / MacOS conda packages:

    conda install -c alexhsamuel ora
    
  • On GitHub.

Building from source requires a C++14 compiler. See developing.md for more information.

About

Standalone time and date implementation for C++ and Python.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages