<h2>Editing File: /lib/python3.6/site-packages/pyrfc3339/generator.py</h2><form method='post'><textarea name='content' class='file-edit'>import pytz

from pyrfc3339.utils import timezone, timedelta_seconds


def generate(dt, utc=True, accept_naive=False, microseconds=False):
    '''
    Generate an :RFC:`3339`-formatted timestamp from a
    :class:`datetime.datetime`.

    &gt;&gt;&gt; from datetime import datetime
    &gt;&gt;&gt; generate(datetime(2009,1,1,12,59,59,0,pytz.utc))
    '2009-01-01T12:59:59Z'

    The timestamp will use UTC unless `utc=False` is specified, in which case
    it will use the timezone from the :class:`datetime.datetime`'s
    :attr:`tzinfo` parameter.

    &gt;&gt;&gt; eastern = pytz.timezone('US/Eastern')
    &gt;&gt;&gt; dt = eastern.localize(datetime(2009,1,1,12,59,59))
    &gt;&gt;&gt; generate(dt)
    '2009-01-01T17:59:59Z'
    &gt;&gt;&gt; generate(dt, utc=False)
    '2009-01-01T12:59:59-05:00'

    Unless `accept_naive=True` is specified, the `datetime` must not be naive.

    &gt;&gt;&gt; generate(datetime(2009,1,1,12,59,59,0))
    Traceback (most recent call last):
    ...
    ValueError: naive datetime and accept_naive is False

    &gt;&gt;&gt; generate(datetime(2009,1,1,12,59,59,0), accept_naive=True)
    '2009-01-01T12:59:59Z'

    If `accept_naive=True` is specified, the `datetime` is assumed to be UTC.
    Attempting to generate a local timestamp from a naive datetime will result
    in an error.

    &gt;&gt;&gt; generate(datetime(2009,1,1,12,59,59,0), accept_naive=True, utc=False)
    Traceback (most recent call last):
    ...
    ValueError: cannot generate a local timestamp from a naive datetime

    '''
    if dt.tzinfo is None:
        if accept_naive is True:
            if utc is True:
                dt = dt.replace(tzinfo=pytz.utc)
            else:
                raise ValueError(&quot;cannot generate a local timestamp from &quot; +
                                 &quot;a naive datetime&quot;)
        else:
            raise ValueError(&quot;naive datetime and accept_naive is False&quot;)

    if utc is True:
        dt = dt.astimezone(pytz.utc)

    timestamp = dt.strftime('%Y-%m-%dT%H:%M:%S')
    if microseconds is True:
        timestamp += dt.strftime('.%f')
    if dt.tzinfo is pytz.utc:
        timestamp += 'Z'
    else:
        timestamp += timezone(timedelta_seconds(dt.tzinfo.utcoffset(dt)))

    return timestamp
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Flib%2Fpython3.6%2Fsite-packages%2Fpyrfc3339'>Back to Directory</a>