Termonad.Types

Documentation

data TMTerm

A wrapper around a VTE Terminal. This also stores the process ID of the process running on this terminal, as well as a Unique that can be used for comparing terminals.

Constructors

TMTerm

Fields

• term :: !Terminal

  The actual Terminal.

• pid :: !Int

  The process ID of the process running in term.

• unique :: !Unique

  A Unique for comparing different TMTerm for uniqueness.

Instances

Eq TMTerm

Defined in Termonad.Types

Methods

(==) :: TMTerm -> TMTerm -> Bool

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

Show TMTerm

Defined in Termonad.Types

Methods

showsPrec :: Int -> TMTerm -> ShowS

show :: TMTerm -> String

showList :: [TMTerm] -> ShowS

data TMNotebookTab

A container that holds everything in a given terminal window. The term in the TMTerm is inside the tmNotebookTabTermContainer ScrolledWindow. The notebook tab Label is also available.

Constructors

TMNotebookTab

Fields

• tmNotebookTabTermContainer :: !ScrolledWindow

  The ScrolledWindow holding the VTE Terminal.

• tmNotebookTabTerm :: !TMTerm

  The Terminal insidie the ScrolledWindow.

• tmNotebookTabLabel :: !Label

  The Label holding the title of the Terminal in the Notebook tab.

Instances

Eq TMNotebookTab

Defined in Termonad.Types

Methods

(==) :: TMNotebookTab -> TMNotebookTab -> Bool

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

Show TMNotebookTab

Defined in Termonad.Types

Methods

showsPrec :: Int -> TMNotebookTab -> ShowS

show :: TMNotebookTab -> String

showList :: [TMNotebookTab] -> ShowS

data TMNotebook

This holds the GTK Notebook containing multiple tabs of Terminals. We keep a separate list of terminals in tmNotebookTabs.

Constructors

TMNotebook

Fields

• tmNotebook :: !Notebook

  This is the GTK Notebook that holds multiple tabs of Terminals.

• tmNotebookTabs :: !(FocusList TMNotebookTab)

  A FocusList containing references to each individual TMNotebookTab.

Instances

Show TMNotebook

Defined in Termonad.Types

Methods

showsPrec :: Int -> TMNotebook -> ShowS

show :: TMNotebook -> String

showList :: [TMNotebook] -> ShowS

data TMState'

Constructors

TMState

Fields

• tmStateApp :: !Application
• tmStateAppWin :: !ApplicationWindow
• tmStateNotebook :: !TMNotebook
• tmStateFontDesc :: !FontDescription
• tmStateConfig :: !TMConfig

Instances

Show TMState'

Defined in Termonad.Types

Methods

showsPrec :: Int -> TMState' -> ShowS

show :: TMState' -> String

showList :: [TMState'] -> ShowS

type TMState = MVar TMState'

createTMTerm :: Terminal -> Int -> Unique -> TMTerm

newTMTerm :: Terminal -> Int -> IO TMTerm

getFocusedTermFromState :: TMState -> IO (Maybe Terminal)

createTMNotebookTab :: Label -> ScrolledWindow -> TMTerm -> TMNotebookTab

createTMNotebook :: Notebook -> FocusList TMNotebookTab -> TMNotebook

createEmptyTMNotebook :: Notebook -> TMNotebook

notebookToList :: Notebook -> IO [Widget]

newTMState :: TMConfig -> Application -> ApplicationWindow -> TMNotebook -> FontDescription -> IO TMState

newEmptyTMState :: TMConfig -> Application -> ApplicationWindow -> Notebook -> FontDescription -> IO TMState

newTMStateSingleTerm :: TMConfig -> Application -> ApplicationWindow -> Notebook -> Label -> ScrolledWindow -> Terminal -> Int -> FontDescription -> IO TMState

traceShowMTMState :: TMState -> IO ()

data FontSize

The font size for the Termonad terminal. There are two ways to set the fontsize, corresponding to the two different ways to set the font size in the Pango font rendering library.

If you're not sure which to use, try FontSizePoints first and see how it looks. It should generally correspond to font sizes you are used to from other applications.

Constructors

FontSizePoints Int

This sets the font size based on "points". The conversion between a point and an actual size depends on the system configuration and the output device. The function fontDescriptionSetSize is used to set the font size. See the documentation for that function for more info.

FontSizeUnits Double

This sets the font size based on "device units". In general, this can be thought of as one pixel. The function fontDescriptionSetAbsoluteSize is used to set the font size. See the documentation for that function for more info.

Instances

Eq FontSize

Defined in Termonad.Types

Methods

(==) :: FontSize -> FontSize -> Bool

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

Show FontSize

Defined in Termonad.Types

Methods

showsPrec :: Int -> FontSize -> ShowS

show :: FontSize -> String

showList :: [FontSize] -> ShowS

defaultFontSize :: FontSize

The default FontSize used if not specified.

>>> defaultFontSize
FontSizePoints 12

modFontSize :: Int -> FontSize -> FontSize

Modify a FontSize by adding some value.

>>> modFontSize 1 (FontSizePoints 13)
FontSizePoints 14
>>> modFontSize 1 (FontSizeUnits 9.0)
FontSizeUnits 10.0

You can reduce the font size by passing a negative value.

>>> modFontSize (-2) (FontSizePoints 13)
FontSizePoints 11

If you try to create a font size less than 1, then the old font size will be used.

>>> modFontSize (-10) (FontSizePoints 5)
FontSizePoints 5
>>> modFontSize (-1) (FontSizeUnits 1.0)
FontSizeUnits 1.0

data FontConfig

Settings for the font to be used in Termonad.

Constructors

FontConfig

Fields

• fontFamily :: !Text

  The font family to use. Example: "DejaVu Sans Mono" or "Source Code Pro"

• fontSize :: !FontSize

  The font size.

Instances

Eq FontConfig

Defined in Termonad.Types

Methods

(==) :: FontConfig -> FontConfig -> Bool

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

Show FontConfig

Defined in Termonad.Types

Methods

showsPrec :: Int -> FontConfig -> ShowS

show :: FontConfig -> String

showList :: [FontConfig] -> ShowS

defaultFontConfig :: FontConfig

The default FontConfig to use if not specified.

>>> defaultFontConfig == FontConfig {fontFamily = "Monospace", fontSize = defaultFontSize}
True

data Option a

This data type represents an option that can either be Option or Unset.

This data type is used in situations where leaving an option unset results in a special state that is not representable by setting any specific value.

Examples of this include the cursorFgColour and cursorBgColour options supplied by the ColourConfig ConfigExtension. By default, cursorFgColour and cursorBgColour are both Unset. However, when cursorBgColour is Option, cursorFgColour defaults to the color of the text underneath. There is no way to represent this by setting cursorFgColour.

Constructors

Unset

Set !a

Instances

Functor Option

Defined in Termonad.Types

Methods

fmap :: (a -> b) -> Option a -> Option b

(<$) :: a -> Option b -> Option a

Foldable Option

Defined in Termonad.Types

Methods

fold :: Monoid m => Option m -> m

foldMap :: Monoid m => (a -> m) -> Option a -> m

foldr :: (a -> b -> b) -> b -> Option a -> b

foldr' :: (a -> b -> b) -> b -> Option a -> b

foldl :: (b -> a -> b) -> b -> Option a -> b

foldl' :: (b -> a -> b) -> b -> Option a -> b

foldr1 :: (a -> a -> a) -> Option a -> a

foldl1 :: (a -> a -> a) -> Option a -> a

toList :: Option a -> [a]

null :: Option a -> Bool

length :: Option a -> Int

elem :: Eq a => a -> Option a -> Bool

maximum :: Ord a => Option a -> a

minimum :: Ord a => Option a -> a

sum :: Num a => Option a -> a

product :: Num a => Option a -> a

Eq a => Eq (Option a)

Defined in Termonad.Types

Methods

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

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

Ord a => Ord (Option a)

Defined in Termonad.Types

Methods

compare :: Option a -> Option a -> Ordering

(<) :: Option a -> Option a -> Bool

(<=) :: Option a -> Option a -> Bool

(>) :: Option a -> Option a -> Bool

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

max :: Option a -> Option a -> Option a

min :: Option a -> Option a -> Option a

Read a => Read (Option a)

Defined in Termonad.Types

Methods

readsPrec :: Int -> ReadS (Option a)

readList :: ReadS [Option a]

readPrec :: ReadPrec (Option a)

readListPrec :: ReadPrec [Option a]

Show a => Show (Option a)

Defined in Termonad.Types

Methods

showsPrec :: Int -> Option a -> ShowS

show :: Option a -> String

showList :: [Option a] -> ShowS

whenSet :: Monoid m => Option a -> (a -> m) -> m

Run a function over the value contained in an Option. Return mempty when Option is Unset.

>>> whenSet (Set [1,2,3]) (++ [4,5,6]) :: [Int]
[1,2,3,4,5,6]
>>> whenSet Unset (++ [4,5,6]) :: [Int]
[]

data ShowScrollbar

Whether or not to show the scroll bar in a terminal.

Constructors

ShowScrollbarNever

Never show the scroll bar, even if there are too many lines on the terminal to show all at once. You should still be able to scroll with the mouse wheel.

ShowScrollbarAlways

Always show the scrollbar, even if it is not needed.

ShowScrollbarIfNeeded

Only show the scrollbar if there are too many lines on the terminal to show all at once.

Instances

Eq ShowScrollbar

Defined in Termonad.Types

Methods

(==) :: ShowScrollbar -> ShowScrollbar -> Bool

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

Show ShowScrollbar

Defined in Termonad.Types

Methods

showsPrec :: Int -> ShowScrollbar -> ShowS

show :: ShowScrollbar -> String

showList :: [ShowScrollbar] -> ShowS

data ShowTabBar

Whether or not to show the tab bar for switching tabs.

Constructors

ShowTabBarNever

Never show the tab bar, even if there are multiple tabs open. This may be confusing if you plan on using multiple tabs.

ShowTabBarAlways

Always show the tab bar, even if you only have one tab open.

ShowTabBarIfNeeded

Only show the tab bar if you have multiple tabs open.

Instances

Eq ShowTabBar

Defined in Termonad.Types

Methods

(==) :: ShowTabBar -> ShowTabBar -> Bool

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

Show ShowTabBar

Defined in Termonad.Types

Methods

showsPrec :: Int -> ShowTabBar -> ShowS

show :: ShowTabBar -> String

showList :: [ShowTabBar] -> ShowS

data ConfigOptions

Configuration options for Termonad.

See defaultConfigOptions for the default values.

Constructors

ConfigOptions

Fields

• fontConfig :: !FontConfig

  Specific options for fonts.

• showScrollbar :: !ShowScrollbar

  When to show the scroll bar.

• scrollbackLen :: !Integer

  The number of lines to keep in the scroll back history for each terminal.

• confirmExit :: !Bool

  Whether or not to ask you for confirmation when closing individual terminals or Termonad itself. It is generally safer to keep this as True.

• wordCharExceptions :: !Text

  When double-clicking on text in the terminal with the mouse, Termonad will use this value to determine what to highlight. The individual characters in this list will be counted as part of a word.

  For instance if wordCharExceptions is "", then when you double-click on the text http://, only the http portion will be highlighted. If wordCharExceptions is ":", then the http: portion will be highlighted.

• showMenu :: !Bool

  Whether or not to show the File Edit etc menu.

• showTabBar :: !ShowTabBar

  When to show the tab bar.

• cursorBlinkMode :: !CursorBlinkMode

  How to handle cursor blink.

Instances

Eq ConfigOptions

Defined in Termonad.Types

Methods

(==) :: ConfigOptions -> ConfigOptions -> Bool

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

Show ConfigOptions

Defined in Termonad.Types

Methods

showsPrec :: Int -> ConfigOptions -> ShowS

show :: ConfigOptions -> String

showList :: [ConfigOptions] -> ShowS

defaultConfigOptions :: ConfigOptions

The default ConfigOptions.

>>> :{
  let defConfOpt =
        ConfigOptions
          { fontConfig = defaultFontConfig
          , showScrollbar = ShowScrollbarIfNeeded
          , scrollbackLen = 10000
          , confirmExit = True
          , wordCharExceptions = "-#%&+,./=?@\\_~\183:"
          , showMenu = True
          , showTabBar = ShowTabBarIfNeeded
          , cursorBlinkMode = CursorBlinkModeOn
          }
  in defaultConfigOptions == defConfOpt
:}
True

data TMConfig

The Termonad ConfigOptions along with the ConfigHooks.

Constructors

TMConfig

Fields

• options :: !ConfigOptions
• hooks :: !ConfigHooks

Instances

Show TMConfig

Defined in Termonad.Types

Methods

showsPrec :: Int -> TMConfig -> ShowS

show :: TMConfig -> String

showList :: [TMConfig] -> ShowS

defaultTMConfig :: TMConfig

The default TMConfig.

options is defaultConfigOptions and hooks is defaultConfigHooks.

data ConfigHooks

Hooks into certain termonad operations and VTE events. Used to modify termonad's behaviour in order to implement new functionality. Fields should have sane Semigroup and Monoid instances so that config extensions can be combined uniformly and new hooks can be added without incident.

Constructors

ConfigHooks

Fields

• createTermHook :: TMState -> Terminal -> IO ()

  Produce an IO action to run on creation of new Terminal, given TMState and the Terminal in question.

Instances

Show ConfigHooks

Defined in Termonad.Types

Methods

showsPrec :: Int -> ConfigHooks -> ShowS

show :: ConfigHooks -> String

showList :: [ConfigHooks] -> ShowS

defaultConfigHooks :: ConfigHooks

Default values for the ConfigHooks.

• The default function for createTermHook is defaultCreateTermHook.

defaultCreateTermHook :: TMState -> Terminal -> IO ()

Default value for createTermHook. Does nothing.

data FocusNotSameErr

Constructors

FocusListFocusExistsButNoNotebookTabWidget

NotebookTabWidgetDiffersFromFocusListFocus

NotebookTabWidgetExistsButNoFocusListFocus

Instances

Show FocusNotSameErr

Defined in Termonad.Types

Methods

showsPrec :: Int -> FocusNotSameErr -> ShowS

show :: FocusNotSameErr -> String

showList :: [FocusNotSameErr] -> ShowS

data TabsDoNotMatch

Constructors

TabLengthsDifferent Int Int

The first Int is the number of tabs in the actual GTK Notebook. The second Int is the number of tabs in the FocusList.

TabAtIndexDifferent Int

The tab at index Int is different between the actual GTK Notebook and the FocusList.

Instances

Show TabsDoNotMatch

Defined in Termonad.Types

Methods

showsPrec :: Int -> TabsDoNotMatch -> ShowS

show :: TabsDoNotMatch -> String

showList :: [TabsDoNotMatch] -> ShowS

data TMStateInvariantErr

Constructors

FocusNotSame FocusNotSameErr Int

TabsDoNotMatch TabsDoNotMatch

Instances

Show TMStateInvariantErr

Defined in Termonad.Types

Methods

showsPrec :: Int -> TMStateInvariantErr -> ShowS

show :: TMStateInvariantErr -> String

showList :: [TMStateInvariantErr] -> ShowS

invariantTMState' :: TMState' -> IO [TMStateInvariantErr]

Gather up the invariants for TMState' and return them as a list.

If no invariants have been violated, then this function should return an empty list.

assertInvariantTMState :: TMState -> IO ()

Check the invariants for TMState', and call fail if we find that they have been violated.

pPrintTMState :: TMState -> IO ()