Web.Telegraph.Types

Type definitions, note that all fields are strict

Documentation

data Account

A Telegraph account

Constructors

Account

Fields

• shortName :: Text

  Account name, helps users with several accounts remember which they are currently using

  Displayed to the user above the "Edit/Publish" button on Telegra.ph, other users don't see this name

• authorName :: Text

  Default author name used when creating new articles

• authorUrl :: Text

  Profile link, opened when users click on the author's name below the title

  Can be any link, not necessarily to a Telegram profile or channel

• accessToken :: Maybe Text

  Access token of the Telegraph account

• authUrl :: Maybe Text

  URL to authorize a browser on telegra.ph and connect it to a Telegraph account

  This URL is valid for only one use and for 5 minutes only

• pageCount :: Maybe Int

  Number of pages belonging to the Telegraph account

Instances

Eq Account

Defined in Web.Telegraph.Types

Methods

(==) :: Account -> Account -> Bool

(/=) :: Account -> Account -> Bool

Show Account

Defined in Web.Telegraph.Types

Methods

showsPrec :: Int -> Account -> ShowS

show :: Account -> String

showList :: [Account] -> ShowS

Generic Account

Defined in Web.Telegraph.Types

Associated Types

type Rep Account :: Type -> Type

Methods

from :: Account -> Rep Account x

to :: Rep Account x -> Account

ToJSON Account

Defined in Web.Telegraph.Types

Methods

toJSON :: Account -> Value

toEncoding :: Account -> Encoding

toJSONList :: [Account] -> Value

toEncodingList :: [Account] -> Encoding

FromJSON Account

Defined in Web.Telegraph.Types

Methods

parseJSON :: Value -> Parser Account

parseJSONList :: Value -> Parser [Account]

type Rep Account

Defined in Web.Telegraph.Types

type Rep Account = D1 ('MetaData "Account" "Web.Telegraph.Types" "telegraph-1.0.0-inplace" 'False) (C1 ('MetaCons "Account" 'PrefixI 'True) ((S1 ('MetaSel ('Just "shortName") 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: (S1 ('MetaSel ('Just "authorName") 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "authorUrl") 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))) :*: (S1 ('MetaSel ('Just "accessToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "authUrl") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "pageCount") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int))))))

data PageList

A list of Telegraph articles belonging to an account

Most recently created articles first

Constructors

PageList

Fields

• totalCount :: Int

  Total number of pages belonging to the target Telegraph account

• pages :: [Page]

  Requested pages of the target Telegraph account

Instances

Eq PageList

Defined in Web.Telegraph.Types

Methods

(==) :: PageList -> PageList -> Bool

(/=) :: PageList -> PageList -> Bool

Show PageList

Defined in Web.Telegraph.Types

Methods

showsPrec :: Int -> PageList -> ShowS

show :: PageList -> String

showList :: [PageList] -> ShowS

Generic PageList

Defined in Web.Telegraph.Types

Associated Types

type Rep PageList :: Type -> Type

Methods

from :: PageList -> Rep PageList x

to :: Rep PageList x -> PageList

ToJSON PageList

Defined in Web.Telegraph.Types

Methods

toJSON :: PageList -> Value

toEncoding :: PageList -> Encoding

toJSONList :: [PageList] -> Value

toEncodingList :: [PageList] -> Encoding

FromJSON PageList

Defined in Web.Telegraph.Types

Methods

parseJSON :: Value -> Parser PageList

parseJSONList :: Value -> Parser [PageList]

type Rep PageList

Defined in Web.Telegraph.Types

type Rep PageList = D1 ('MetaData "PageList" "Web.Telegraph.Types" "telegraph-1.0.0-inplace" 'False) (C1 ('MetaCons "PageList" 'PrefixI 'True) (S1 ('MetaSel ('Just "totalCount") 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 Int) :*: S1 ('MetaSel ('Just "pages") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Page])))

data Page

A page on Telegraph

Constructors

Page

Fields

• path :: Text

  Path to the page

• url :: Text

  URL of the page

• title :: Text

  Title of the page

• description :: Text

  Description of the page

• authorName :: Maybe Text

  Name of the author, displayed below the title

• authorUrl :: Maybe Text

  rofile link, opened when users click on the author's name below the title

  Can be any link, not necessarily to a Telegram profile or channel

• imageUrl :: Maybe Text

  Image URL of the page

• content :: Maybe [Node]

  Content of the page

• views :: Int

  Number of page views for the page

• canEdit :: Maybe Bool

  True, if the target Telegraph account can edit the page

Instances

Eq Page

Defined in Web.Telegraph.Types

Methods

(==) :: Page -> Page -> Bool

(/=) :: Page -> Page -> Bool

Show Page

Defined in Web.Telegraph.Types

Methods

showsPrec :: Int -> Page -> ShowS

show :: Page -> String

showList :: [Page] -> ShowS

Generic Page

Defined in Web.Telegraph.Types

Associated Types

type Rep Page :: Type -> Type

Methods

from :: Page -> Rep Page x

to :: Rep Page x -> Page

ToJSON Page

Defined in Web.Telegraph.Types

Methods

toJSON :: Page -> Value

toEncoding :: Page -> Encoding

toJSONList :: [Page] -> Value

toEncodingList :: [Page] -> Encoding

FromJSON Page

Defined in Web.Telegraph.Types

Methods

parseJSON :: Value -> Parser Page

parseJSONList :: Value -> Parser [Page]

type Rep Page

Defined in Web.Telegraph.Types

type Rep Page = D1 ('MetaData "Page" "Web.Telegraph.Types" "telegraph-1.0.0-inplace" 'False) (C1 ('MetaCons "Page" 'PrefixI 'True) (((S1 ('MetaSel ('Just "path") 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "url") 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)) :*: (S1 ('MetaSel ('Just "title") 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: (S1 ('MetaSel ('Just "description") 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "authorName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))) :*: ((S1 ('MetaSel ('Just "authorUrl") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "imageUrl") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "content") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Node])) :*: (S1 ('MetaSel ('Just "views") 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 Int) :*: S1 ('MetaSel ('Just "canEdit") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)))))))

newtype PageViews

The number of page views for a Telegraph article

Constructors

PageViews

Fields

• views :: Int

Instances

Eq PageViews

Defined in Web.Telegraph.Types

Methods

(==) :: PageViews -> PageViews -> Bool

(/=) :: PageViews -> PageViews -> Bool

Show PageViews

Defined in Web.Telegraph.Types

Methods

showsPrec :: Int -> PageViews -> ShowS

show :: PageViews -> String

showList :: [PageViews] -> ShowS

Generic PageViews

Defined in Web.Telegraph.Types

Associated Types

type Rep PageViews :: Type -> Type

Methods

from :: PageViews -> Rep PageViews x

to :: Rep PageViews x -> PageViews

ToJSON PageViews

Defined in Web.Telegraph.Types

Methods

toJSON :: PageViews -> Value

toEncoding :: PageViews -> Encoding

toJSONList :: [PageViews] -> Value

toEncodingList :: [PageViews] -> Encoding

FromJSON PageViews

Defined in Web.Telegraph.Types

Methods

parseJSON :: Value -> Parser PageViews

parseJSONList :: Value -> Parser [PageViews]

type Rep PageViews

Defined in Web.Telegraph.Types

type Rep PageViews = D1 ('MetaData "PageViews" "Web.Telegraph.Types" "telegraph-1.0.0-inplace" 'True) (C1 ('MetaCons "PageViews" 'PrefixI 'True) (S1 ('MetaSel ('Just "views") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Int)))

data Node

A DOM Node

Constructors

Content Text

Element NodeElement

Instances

Eq Node

Defined in Web.Telegraph.Types

Methods

(==) :: Node -> Node -> Bool

(/=) :: Node -> Node -> Bool

Show Node

Defined in Web.Telegraph.Types

Methods

showsPrec :: Int -> Node -> ShowS

show :: Node -> String

showList :: [Node] -> ShowS

Generic Node

Defined in Web.Telegraph.Types

Associated Types

type Rep Node :: Type -> Type

Methods

from :: Node -> Rep Node x

to :: Rep Node x -> Node

ToJSON Node

Defined in Web.Telegraph.Types

Methods

toJSON :: Node -> Value

toEncoding :: Node -> Encoding

toJSONList :: [Node] -> Value

toEncodingList :: [Node] -> Encoding

FromJSON Node

Defined in Web.Telegraph.Types

Methods

parseJSON :: Value -> Parser Node

parseJSONList :: Value -> Parser [Node]

type Rep Node

Defined in Web.Telegraph.Types

type Rep Node = D1 ('MetaData "Node" "Web.Telegraph.Types" "telegraph-1.0.0-inplace" 'False) (C1 ('MetaCons "Content" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)) :+: C1 ('MetaCons "Element" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 NodeElement)))

data NodeElement

A DOM elemen node

Constructors

NodeElement

Fields

• tag :: Text

  Name of the DOM element

  Available tags: a, aside, b, blockquote, br, code, em, figcaption, figure, h3, h4, hr, i, iframe, img, li, ol, p, pre, s, strong, u, ul, video

• attrs :: [(Text, [Text])]

  Attributes of the DOM element

  Key of object represents name of attribute, value represents value of attribute

  Available attributes: href, src

• children :: [Node]

  List of child nodes for the DOM element

Instances

Eq NodeElement

Defined in Web.Telegraph.Types

Methods

(==) :: NodeElement -> NodeElement -> Bool

(/=) :: NodeElement -> NodeElement -> Bool

Show NodeElement

Defined in Web.Telegraph.Types

Methods

showsPrec :: Int -> NodeElement -> ShowS

show :: NodeElement -> String

showList :: [NodeElement] -> ShowS

Generic NodeElement

Defined in Web.Telegraph.Types

Associated Types

type Rep NodeElement :: Type -> Type

Methods

from :: NodeElement -> Rep NodeElement x

to :: Rep NodeElement x -> NodeElement

ToJSON NodeElement

Defined in Web.Telegraph.Types

Methods

toJSON :: NodeElement -> Value

toEncoding :: NodeElement -> Encoding

toJSONList :: [NodeElement] -> Value

toEncodingList :: [NodeElement] -> Encoding

FromJSON NodeElement

Defined in Web.Telegraph.Types

Methods

parseJSON :: Value -> Parser NodeElement

parseJSONList :: Value -> Parser [NodeElement]

type Rep NodeElement

Defined in Web.Telegraph.Types

type Rep NodeElement = D1 ('MetaData "NodeElement" "Web.Telegraph.Types" "telegraph-1.0.0-inplace" 'False) (C1 ('MetaCons "NodeElement" 'PrefixI 'True) (S1 ('MetaSel ('Just "tag") 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: (S1 ('MetaSel ('Just "attrs") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [(Text, [Text])]) :*: S1 ('MetaSel ('Just "children") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Node]))))

data Result a

The result of an API call

Constructors

Error Text

Result a

Instances

Eq a => Eq (Result a)

Defined in Web.Telegraph.Types

Methods

(==) :: Result a -> Result a -> Bool

(/=) :: Result a -> Result a -> Bool

Show a => Show (Result a)

Defined in Web.Telegraph.Types

Methods

showsPrec :: Int -> Result a -> ShowS

show :: Result a -> String

showList :: [Result a] -> ShowS

Generic (Result a)

Defined in Web.Telegraph.Types

Associated Types

type Rep (Result a) :: Type -> Type

Methods

from :: Result a -> Rep (Result a) x

to :: Rep (Result a) x -> Result a

FromJSON a => FromJSON (Result a)

Defined in Web.Telegraph.Types

Methods

parseJSON :: Value -> Parser (Result a)

parseJSONList :: Value -> Parser [Result a]

type Rep (Result a)

Defined in Web.Telegraph.Types

type Rep (Result a) = D1 ('MetaData "Result" "Web.Telegraph.Types" "telegraph-1.0.0-inplace" 'False) (C1 ('MetaCons "Error" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)) :+: C1 ('MetaCons "Result" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 a)))

newtype Image

An image uploaded to Telegraph

Constructors

Image

Fields

• src :: Text

  The path to the image

Instances

Eq Image

Defined in Web.Telegraph.Types

Methods

(==) :: Image -> Image -> Bool

(/=) :: Image -> Image -> Bool

Show Image

Defined in Web.Telegraph.Types

Methods

showsPrec :: Int -> Image -> ShowS

show :: Image -> String

showList :: [Image] -> ShowS

Generic Image

Defined in Web.Telegraph.Types

Associated Types

type Rep Image :: Type -> Type

Methods

from :: Image -> Rep Image x

to :: Rep Image x -> Image

ToJSON Image

Defined in Web.Telegraph.Types

Methods

toJSON :: Image -> Value

toEncoding :: Image -> Encoding

toJSONList :: [Image] -> Value

toEncodingList :: [Image] -> Encoding

FromJSON Image

Defined in Web.Telegraph.Types

Methods

parseJSON :: Value -> Parser Image

parseJSONList :: Value -> Parser [Image]

type Rep Image

Defined in Web.Telegraph.Types

type Rep Image = D1 ('MetaData "Image" "Web.Telegraph.Types" "telegraph-1.0.0-inplace" 'True) (C1 ('MetaCons "Image" 'PrefixI 'True) (S1 ('MetaSel ('Just "src") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Text)))

data UploadResult

The result of an image upload

Constructors

UploadError

Fields

• error :: Text

Sources [Image]

Instances

Eq UploadResult

Defined in Web.Telegraph.Types

Methods

(==) :: UploadResult -> UploadResult -> Bool

(/=) :: UploadResult -> UploadResult -> Bool

Show UploadResult

Defined in Web.Telegraph.Types

Methods

showsPrec :: Int -> UploadResult -> ShowS

show :: UploadResult -> String

showList :: [UploadResult] -> ShowS

Generic UploadResult

Defined in Web.Telegraph.Types

Associated Types

type Rep UploadResult :: Type -> Type

Methods

from :: UploadResult -> Rep UploadResult x

to :: Rep UploadResult x -> UploadResult

ToJSON UploadResult

Defined in Web.Telegraph.Types

Methods

toJSON :: UploadResult -> Value

toEncoding :: UploadResult -> Encoding

toJSONList :: [UploadResult] -> Value

toEncodingList :: [UploadResult] -> Encoding

FromJSON UploadResult

Defined in Web.Telegraph.Types

Methods

parseJSON :: Value -> Parser UploadResult

parseJSONList :: Value -> Parser [UploadResult]

type Rep UploadResult

Defined in Web.Telegraph.Types

type Rep UploadResult = D1 ('MetaData "UploadResult" "Web.Telegraph.Types" "telegraph-1.0.0-inplace" 'False) (C1 ('MetaCons "UploadError" 'PrefixI 'True) (S1 ('MetaSel ('Just "error") 'SourceUnpack 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)) :+: C1 ('MetaCons "Sources" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [Image])))

newtype TelegraphError

Constructors

APICallFailure Text

An api call has failed, we cannot distinguish between minor errors (such as illformed author urls) and much serious errors, such as invalid accessTokens, so we always throw exceptions

Instances

Eq TelegraphError

Defined in Web.Telegraph.Types

Methods

(==) :: TelegraphError -> TelegraphError -> Bool

(/=) :: TelegraphError -> TelegraphError -> Bool

Show TelegraphError

Defined in Web.Telegraph.Types

Methods

showsPrec :: Int -> TelegraphError -> ShowS

show :: TelegraphError -> String

showList :: [TelegraphError] -> ShowS

Exception TelegraphError

Defined in Web.Telegraph.Types

Methods

toException :: TelegraphError -> SomeException

fromException :: SomeException -> Maybe TelegraphError

displayException :: TelegraphError -> String