readme fixed.

Author: dapper91

README.rst

@@ -2,6 +2,23 @@
 crontools
 =========
 
+.. image:: https://github.com/dapper91/crontools/actions/workflows/test.yml/badge.svg
+    :target: https://github.com/dapper91/crontools/actions/workflows/test.yml
+    :alt: Build status
+.. image:: https://img.shields.io/pypi/l/crontools.svg
+    :target: https://pypi.org/project/crontools
+    :alt: License
+.. image:: https://img.shields.io/pypi/pyversions/crontools.svg
+    :target: https://pypi.org/project/crontools
+    :alt: Supported Python versions
+.. image:: https://codecov.io/gh/dapper91/crontools/branch/master/graph/badge.svg
+    :target: https://codecov.io/gh/dapper91/crontools
+    :alt: Code coverage
+
+
+``crontools`` is a library that allows you to parse crontab expression and iterate over scheduled fire times.
+
+
 Features:
 
 - crontab expression parser
@@ -22,28 +39,49 @@ You can install crontools with pip:
 Quickstart
 ----------
 
-On the server side everything is also pretty straightforward:
+
+Get next cron fire time:
+________________________
 
 .. code-block:: python
 
-    import datetime as dt
-    import crontools as ct
+    >>> import datetime as dt
+    >>> import crontools as ct
+    >>>
+    >>> tz = dt.timezone.utc
+    >>> now = dt.datetime.fromisoformat('2020-02-29 23:59:59.999+00:00')
+    >>> ct = ct.Crontab.parse(
+    ...     '* * * * * * *',
+    ...     seconds_ext=True,
+    ...     years_ext=True,
+    ...     tz=tz,
+    ... )
+    >>>
+    >>> print(f"Next fire time: {ct.next_fire_time(now=now)}")
+    Next fire time: 2020-03-01 00:00:00+00:00
 
-    tz = dt.timezone.utc
-    now = dt.datetime.fromisoformat('2021-02-01 00:00:00+00:00')
-    ct = ct.Crontab.parse(
-        '30 30 12-16/2 1,2 JAN SAT,SUN *',
-        seconds_ext=True,
-        years_ext=True,
-        tz=tz,
-    )
 
-    cron_iter = ct.iter(start_from=now)
-    for n, fire_datetime in zip(range(1, 31), cron_iter):
-        print("{n:2}: {dt}".format(n=n, dt=fire_datetime))
+Iteration over cron fire times starting from now:
+_________________________________________________
 
-    output:
+.. code-block:: python
 
+    >>> import crontools as ct
+    >>>
+    >>> tz = dt.timezone.utc
+    >>> now = dt.datetime.fromisoformat('2021-02-01 00:00:00+00:00')
+    >>> ct = ct.Crontab.parse(
+    ...     '30 30 12-16/2 1,2 JAN SAT,SUN *',
+    ...     seconds_ext=True,
+    ...     years_ext=True,
+    ...     tz=tz,
+    ... )
+    >>>
+    >>> cron_iter = ct.iter(start_from=now)
+    >>> for n, fire_datetime in zip(range(1, 31), cron_iter):
+    ...     print("{n:2}: {dt}".format(n=n, dt=fire_datetime))
+    ...
+    ...
      1: 2022-01-01 12:30:30+00:00
      2: 2022-01-01 14:30:30+00:00
      3: 2022-01-01 16:30:30+00:00