{-# LANGUAGE DeriveGeneric #-}
{-# LANGUAGE DuplicateRecordFields #-}
{-# LANGUAGE NamedFieldPuns #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE RecordWildCards #-}
{-# LANGUAGE StrictData #-}
{-# LANGUAGE NoImplicitPrelude #-}
{-# OPTIONS_GHC -fno-warn-unused-imports #-}
{-# OPTIONS_GHC -fno-warn-unused-matches #-}

-- Derived from AWS service descriptions, licensed under Apache 2.0.

-- |
-- Module      : Amazonka.S3.Types.CSVOutput
-- Copyright   : (c) 2013-2021 Brendan Hay
-- License     : Mozilla Public License, v. 2.0.
-- Maintainer  : Brendan Hay <brendan.g.hay+amazonka@gmail.com>
-- Stability   : auto-generated
-- Portability : non-portable (GHC extensions)
module Amazonka.S3.Types.CSVOutput where

import qualified Amazonka.Core as Core
import qualified Amazonka.Lens as Lens
import qualified Amazonka.Prelude as Prelude
import Amazonka.S3.Internal
import Amazonka.S3.Types.QuoteFields

-- | Describes how uncompressed comma-separated values (CSV)-formatted
-- results are formatted.
--
-- /See:/ 'newCSVOutput' smart constructor.
data CSVOutput = CSVOutput'
  { -- | A single character used for escaping when the field delimiter is part of
    -- the value. For example, if the value is @a, b@, Amazon S3 wraps this
    -- field value in quotation marks, as follows: @\" a , b \"@.
    CSVOutput -> Maybe Text
quoteCharacter :: Prelude.Maybe Prelude.Text,
    -- | Indicates whether to use quotation marks around output fields.
    --
    -- -   @ALWAYS@: Always use quotation marks for output fields.
    --
    -- -   @ASNEEDED@: Use quotation marks for output fields when needed.
    CSVOutput -> Maybe QuoteFields
quoteFields :: Prelude.Maybe QuoteFields,
    -- | A single character used to separate individual records in the output.
    -- Instead of the default value, you can specify an arbitrary delimiter.
    CSVOutput -> Maybe Text
recordDelimiter :: Prelude.Maybe Prelude.Text,
    -- | The single character used for escaping the quote character inside an
    -- already escaped value.
    CSVOutput -> Maybe Text
quoteEscapeCharacter :: Prelude.Maybe Prelude.Text,
    -- | The value used to separate individual fields in a record. You can
    -- specify an arbitrary delimiter.
    CSVOutput -> Maybe Text
fieldDelimiter :: Prelude.Maybe Prelude.Text
  }
  deriving (CSVOutput -> CSVOutput -> Bool
(CSVOutput -> CSVOutput -> Bool)
-> (CSVOutput -> CSVOutput -> Bool) -> Eq CSVOutput
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: CSVOutput -> CSVOutput -> Bool
$c/= :: CSVOutput -> CSVOutput -> Bool
== :: CSVOutput -> CSVOutput -> Bool
$c== :: CSVOutput -> CSVOutput -> Bool
Prelude.Eq, ReadPrec [CSVOutput]
ReadPrec CSVOutput
Int -> ReadS CSVOutput
ReadS [CSVOutput]
(Int -> ReadS CSVOutput)
-> ReadS [CSVOutput]
-> ReadPrec CSVOutput
-> ReadPrec [CSVOutput]
-> Read CSVOutput
forall a.
(Int -> ReadS a)
-> ReadS [a] -> ReadPrec a -> ReadPrec [a] -> Read a
readListPrec :: ReadPrec [CSVOutput]
$creadListPrec :: ReadPrec [CSVOutput]
readPrec :: ReadPrec CSVOutput
$creadPrec :: ReadPrec CSVOutput
readList :: ReadS [CSVOutput]
$creadList :: ReadS [CSVOutput]
readsPrec :: Int -> ReadS CSVOutput
$creadsPrec :: Int -> ReadS CSVOutput
Prelude.Read, Int -> CSVOutput -> ShowS
[CSVOutput] -> ShowS
CSVOutput -> String
(Int -> CSVOutput -> ShowS)
-> (CSVOutput -> String)
-> ([CSVOutput] -> ShowS)
-> Show CSVOutput
forall a.
(Int -> a -> ShowS) -> (a -> String) -> ([a] -> ShowS) -> Show a
showList :: [CSVOutput] -> ShowS
$cshowList :: [CSVOutput] -> ShowS
show :: CSVOutput -> String
$cshow :: CSVOutput -> String
showsPrec :: Int -> CSVOutput -> ShowS
$cshowsPrec :: Int -> CSVOutput -> ShowS
Prelude.Show, (forall x. CSVOutput -> Rep CSVOutput x)
-> (forall x. Rep CSVOutput x -> CSVOutput) -> Generic CSVOutput
forall x. Rep CSVOutput x -> CSVOutput
forall x. CSVOutput -> Rep CSVOutput x
forall a.
(forall x. a -> Rep a x) -> (forall x. Rep a x -> a) -> Generic a
$cto :: forall x. Rep CSVOutput x -> CSVOutput
$cfrom :: forall x. CSVOutput -> Rep CSVOutput x
Prelude.Generic)

-- |
-- Create a value of 'CSVOutput' with all optional fields omitted.
--
-- Use <https://hackage.haskell.org/package/generic-lens generic-lens> or <https://hackage.haskell.org/package/optics optics> to modify other optional fields.
--
-- The following record fields are available, with the corresponding lenses provided
-- for backwards compatibility:
--
-- 'quoteCharacter', 'cSVOutput_quoteCharacter' - A single character used for escaping when the field delimiter is part of
-- the value. For example, if the value is @a, b@, Amazon S3 wraps this
-- field value in quotation marks, as follows: @\" a , b \"@.
--
-- 'quoteFields', 'cSVOutput_quoteFields' - Indicates whether to use quotation marks around output fields.
--
-- -   @ALWAYS@: Always use quotation marks for output fields.
--
-- -   @ASNEEDED@: Use quotation marks for output fields when needed.
--
-- 'recordDelimiter', 'cSVOutput_recordDelimiter' - A single character used to separate individual records in the output.
-- Instead of the default value, you can specify an arbitrary delimiter.
--
-- 'quoteEscapeCharacter', 'cSVOutput_quoteEscapeCharacter' - The single character used for escaping the quote character inside an
-- already escaped value.
--
-- 'fieldDelimiter', 'cSVOutput_fieldDelimiter' - The value used to separate individual fields in a record. You can
-- specify an arbitrary delimiter.
newCSVOutput ::
  CSVOutput
newCSVOutput :: CSVOutput
newCSVOutput =
  CSVOutput' :: Maybe Text
-> Maybe QuoteFields
-> Maybe Text
-> Maybe Text
-> Maybe Text
-> CSVOutput
CSVOutput'
    { $sel:quoteCharacter:CSVOutput' :: Maybe Text
quoteCharacter = Maybe Text
forall a. Maybe a
Prelude.Nothing,
      $sel:quoteFields:CSVOutput' :: Maybe QuoteFields
quoteFields = Maybe QuoteFields
forall a. Maybe a
Prelude.Nothing,
      $sel:recordDelimiter:CSVOutput' :: Maybe Text
recordDelimiter = Maybe Text
forall a. Maybe a
Prelude.Nothing,
      $sel:quoteEscapeCharacter:CSVOutput' :: Maybe Text
quoteEscapeCharacter = Maybe Text
forall a. Maybe a
Prelude.Nothing,
      $sel:fieldDelimiter:CSVOutput' :: Maybe Text
fieldDelimiter = Maybe Text
forall a. Maybe a
Prelude.Nothing
    }

-- | A single character used for escaping when the field delimiter is part of
-- the value. For example, if the value is @a, b@, Amazon S3 wraps this
-- field value in quotation marks, as follows: @\" a , b \"@.
cSVOutput_quoteCharacter :: Lens.Lens' CSVOutput (Prelude.Maybe Prelude.Text)
cSVOutput_quoteCharacter :: (Maybe Text -> f (Maybe Text)) -> CSVOutput -> f CSVOutput
cSVOutput_quoteCharacter = (CSVOutput -> Maybe Text)
-> (CSVOutput -> Maybe Text -> CSVOutput)
-> Lens CSVOutput CSVOutput (Maybe Text) (Maybe Text)
forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\CSVOutput' {Maybe Text
quoteCharacter :: Maybe Text
$sel:quoteCharacter:CSVOutput' :: CSVOutput -> Maybe Text
quoteCharacter} -> Maybe Text
quoteCharacter) (\s :: CSVOutput
s@CSVOutput' {} Maybe Text
a -> CSVOutput
s {$sel:quoteCharacter:CSVOutput' :: Maybe Text
quoteCharacter = Maybe Text
a} :: CSVOutput)

-- | Indicates whether to use quotation marks around output fields.
--
-- -   @ALWAYS@: Always use quotation marks for output fields.
--
-- -   @ASNEEDED@: Use quotation marks for output fields when needed.
cSVOutput_quoteFields :: Lens.Lens' CSVOutput (Prelude.Maybe QuoteFields)
cSVOutput_quoteFields :: (Maybe QuoteFields -> f (Maybe QuoteFields))
-> CSVOutput -> f CSVOutput
cSVOutput_quoteFields = (CSVOutput -> Maybe QuoteFields)
-> (CSVOutput -> Maybe QuoteFields -> CSVOutput)
-> Lens CSVOutput CSVOutput (Maybe QuoteFields) (Maybe QuoteFields)
forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\CSVOutput' {Maybe QuoteFields
quoteFields :: Maybe QuoteFields
$sel:quoteFields:CSVOutput' :: CSVOutput -> Maybe QuoteFields
quoteFields} -> Maybe QuoteFields
quoteFields) (\s :: CSVOutput
s@CSVOutput' {} Maybe QuoteFields
a -> CSVOutput
s {$sel:quoteFields:CSVOutput' :: Maybe QuoteFields
quoteFields = Maybe QuoteFields
a} :: CSVOutput)

-- | A single character used to separate individual records in the output.
-- Instead of the default value, you can specify an arbitrary delimiter.
cSVOutput_recordDelimiter :: Lens.Lens' CSVOutput (Prelude.Maybe Prelude.Text)
cSVOutput_recordDelimiter :: (Maybe Text -> f (Maybe Text)) -> CSVOutput -> f CSVOutput
cSVOutput_recordDelimiter = (CSVOutput -> Maybe Text)
-> (CSVOutput -> Maybe Text -> CSVOutput)
-> Lens CSVOutput CSVOutput (Maybe Text) (Maybe Text)
forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\CSVOutput' {Maybe Text
recordDelimiter :: Maybe Text
$sel:recordDelimiter:CSVOutput' :: CSVOutput -> Maybe Text
recordDelimiter} -> Maybe Text
recordDelimiter) (\s :: CSVOutput
s@CSVOutput' {} Maybe Text
a -> CSVOutput
s {$sel:recordDelimiter:CSVOutput' :: Maybe Text
recordDelimiter = Maybe Text
a} :: CSVOutput)

-- | The single character used for escaping the quote character inside an
-- already escaped value.
cSVOutput_quoteEscapeCharacter :: Lens.Lens' CSVOutput (Prelude.Maybe Prelude.Text)
cSVOutput_quoteEscapeCharacter :: (Maybe Text -> f (Maybe Text)) -> CSVOutput -> f CSVOutput
cSVOutput_quoteEscapeCharacter = (CSVOutput -> Maybe Text)
-> (CSVOutput -> Maybe Text -> CSVOutput)
-> Lens CSVOutput CSVOutput (Maybe Text) (Maybe Text)
forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\CSVOutput' {Maybe Text
quoteEscapeCharacter :: Maybe Text
$sel:quoteEscapeCharacter:CSVOutput' :: CSVOutput -> Maybe Text
quoteEscapeCharacter} -> Maybe Text
quoteEscapeCharacter) (\s :: CSVOutput
s@CSVOutput' {} Maybe Text
a -> CSVOutput
s {$sel:quoteEscapeCharacter:CSVOutput' :: Maybe Text
quoteEscapeCharacter = Maybe Text
a} :: CSVOutput)

-- | The value used to separate individual fields in a record. You can
-- specify an arbitrary delimiter.
cSVOutput_fieldDelimiter :: Lens.Lens' CSVOutput (Prelude.Maybe Prelude.Text)
cSVOutput_fieldDelimiter :: (Maybe Text -> f (Maybe Text)) -> CSVOutput -> f CSVOutput
cSVOutput_fieldDelimiter = (CSVOutput -> Maybe Text)
-> (CSVOutput -> Maybe Text -> CSVOutput)
-> Lens CSVOutput CSVOutput (Maybe Text) (Maybe Text)
forall s a b t. (s -> a) -> (s -> b -> t) -> Lens s t a b
Lens.lens (\CSVOutput' {Maybe Text
fieldDelimiter :: Maybe Text
$sel:fieldDelimiter:CSVOutput' :: CSVOutput -> Maybe Text
fieldDelimiter} -> Maybe Text
fieldDelimiter) (\s :: CSVOutput
s@CSVOutput' {} Maybe Text
a -> CSVOutput
s {$sel:fieldDelimiter:CSVOutput' :: Maybe Text
fieldDelimiter = Maybe Text
a} :: CSVOutput)

instance Prelude.Hashable CSVOutput

instance Prelude.NFData CSVOutput

instance Core.ToXML CSVOutput where
  toXML :: CSVOutput -> XML
toXML CSVOutput' {Maybe Text
Maybe QuoteFields
fieldDelimiter :: Maybe Text
quoteEscapeCharacter :: Maybe Text
recordDelimiter :: Maybe Text
quoteFields :: Maybe QuoteFields
quoteCharacter :: Maybe Text
$sel:fieldDelimiter:CSVOutput' :: CSVOutput -> Maybe Text
$sel:quoteEscapeCharacter:CSVOutput' :: CSVOutput -> Maybe Text
$sel:recordDelimiter:CSVOutput' :: CSVOutput -> Maybe Text
$sel:quoteFields:CSVOutput' :: CSVOutput -> Maybe QuoteFields
$sel:quoteCharacter:CSVOutput' :: CSVOutput -> Maybe Text
..} =
    [XML] -> XML
forall a. Monoid a => [a] -> a
Prelude.mconcat
      [ Name
"QuoteCharacter" Name -> Maybe Text -> XML
forall a. ToXML a => Name -> a -> XML
Core.@= Maybe Text
quoteCharacter,
        Name
"QuoteFields" Name -> Maybe QuoteFields -> XML
forall a. ToXML a => Name -> a -> XML
Core.@= Maybe QuoteFields
quoteFields,
        Name
"RecordDelimiter" Name -> Maybe Text -> XML
forall a. ToXML a => Name -> a -> XML
Core.@= Maybe Text
recordDelimiter,
        Name
"QuoteEscapeCharacter" Name -> Maybe Text -> XML
forall a. ToXML a => Name -> a -> XML
Core.@= Maybe Text
quoteEscapeCharacter,
        Name
"FieldDelimiter" Name -> Maybe Text -> XML
forall a. ToXML a => Name -> a -> XML
Core.@= Maybe Text
fieldDelimiter
      ]