Metadata-Version: 2.1
Name: tartiflette-plugin-isodatenow
Version: 0.2.2
Summary: ISO Date Formatter for Tartiflette
Home-page: https://github.com/briggleman/tartiflette-plugin-isodate
License: MIT
Keywords: api,graphql,tartiflette,iso8601,directive
Author: Ben Riggleman
Author-email: ben.riggleman@gmail.com
Requires-Python: >=3.6,<4.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Software Development :: Libraries
Requires-Dist: tartiflette (>=0.12.5,<0.13.0)
Project-URL: Repository, https://github.com/briggleman/tartiflette-plugin-isodate
Description-Content-Type: text/markdown

# tartiflette-plugin-isodatenow

<a href="https://buddy.works"><img src="https://assets.buddy.works/automated-dark.svg" alt="Buddy.Works logo."></img></a>

[![buddy pipeline](https://app.buddy.works/benriggleman/tartiflette-plugin-isodate/pipelines/pipeline/208276/badge.svg?token=ff05a3fb6bb08b48350b4170e0c447aa3ccc198abbddd48c222205c3c61a7cff "buddy pipeline")](https://app.buddy.works/benriggleman/tartiflette-plugin-isodate/pipelines/pipeline/208276)

ISO Date Format Directive for Tartiflette

## TOC
- [Overview](#overview)
- [Installation](#install)
- [Usage](#usage)
    - [Options](#usage-options)
        - [microseconds](#usage-options-microseconds)
        - [timezone](#usage-options-timezone)
        - [utc](#usage-options-utc)


## [Overview](#overview)

The `tartiflette-plugin-isodatenow` plugin adds an `@isoDateNow` directive to [tartiflette](https://github.com/tartiflette/tartiflette).  It sets the field that it is on with the current time in [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601).
It is primarly intended for use in mutations as the directive overrides any value sent though it can be used in queries where a `createdAt` or response timestamp is required.

## [Installation](#install)

To install with [poetry](https://poetry.eustace.io):

```sh
$ poetry add tartiflette-plugin-isodatenow
```

To install with pip:

```sh
$ pip install tartiflette-plugin-isodatenow
```

## [Usage](#usage)

```graphql
type Example {
    createdAt: String @isoDateNow
}
```

Querying `createdAt` would return the following:

```json
{
    "data": {
        "example": {
            "createdAt": "2019-09-04T13:49:12.585158+00:00"
        }
    }
}
```


### [Options](#usage-options)

The `@isoDateNow` also takes the following optional arguments:

#### [@isoDateNow(microseconds: false)](#usage-options-microseconds)

Returns date and time _without_ microseconds.

```graphql
type Example {
    createdAt: String @isoDateNow(microseconds: false)
}
```

Querying `createdAt` would return the following:

```json
{
    "data": {
        "example": {
            "createdAt": "2019-09-04T13:49:12+00:00"
        }
    }
}
```

#### [@isoDateNow(timezone: false)](#usage-options-timezone)

Returns date and time _without_ timezone.

```graphql
type Example {
    createdAt: String @isoDateNow(timezone: false)
}
```

Querying `createdAt` would return the following:

```json
{
    "data": {
        "example": {
            "createdAt": "2019-09-04T13:49:12.585158"
        }
    }
}
```

#### [@isoDateNow(utc: false)](#usage-options-utc)

Returns date and time in the _local_ timezone.

```graphql
type Example {
    createdAt: String @isoDateNow(utc: false)
}
```

Querying `createdAt` would return the following:

```json
{
    "data": {
        "example": {
            "createdAt": "2019-09-04T09:49:12.585158-04:00"
        }
    }
}
```


The arguments can be used in any combination and will return an [ISO8601 compliant date](https://en.wikipedia.org/wiki/ISO_8601).

For example settings `microseconds` to `false` and `timezone` to `true` would yield: 2019-09-04T13:49:12+00:00.

Possible combinations:

- `@isoDateNow` >> "2019-09-04T13:49:12.585158+00:00"
- `@isoDateNow(timezone: false)` >> "2019-09-04T13:52:43.476260"
- `@isoDateNow(microseconds: false)` >> "2019-09-04T13:50:02+00:00"
- `@isoDateNow(microseconds: false, timezone: false)` >> "2019-09-04T13:53:31"

The time can also be set to the `local` time by setting `utc` to `false`.  

`@isoDateNow(utc: false)` >> "2019-09-04T09:50:02+00:00"

Using the `@isoDateNow` directive will override any value sent.
