keera-hails-mvc-view (empty) → 0.0.3.3

raw patch · 4 files changed

+131/−0 lines, 4 filesdep +basesetup-changed

Dependencies added: base

Files

• LICENSE +30/−0
• Setup.hs +2/−0
• keera-hails-mvc-view.cabal +57/−0
• src/Hails/MVC/View.hs +42/−0

@@ -0,0 +1,30 @@+Copyright (c)2012, Ivan Perez++All rights reserved.++Redistribution and use in source and binary forms, with or without+modification, are permitted provided that the following conditions are met:++    * Redistributions of source code must retain the above copyright+      notice, this list of conditions and the following disclaimer.++    * Redistributions in binary form must reproduce the above+      copyright notice, this list of conditions and the following+      disclaimer in the documentation and/or other materials provided+      with the distribution.++    * Neither the name of Ivan Perez nor the names of other+      contributors may be used to endorse or promote products derived+      from this software without specific prior written permission.++THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

@@ -0,0 +1,2 @@+import Distribution.Simple+main = defaultMain

@@ -0,0 +1,57 @@+-- hails.cabal auto-generated by cabal init. For additional options,+-- see+-- http://www.haskell.org/cabal/release/cabal-latest/doc/users-guide/authors.html#pkg-descr.+-- The name of the package.+Name:                keera-hails-mvc-view++-- The package version. See the Haskell package versioning policy+-- (http://www.haskell.org/haskellwiki/Package_versioning_policy) for+-- standards guiding when and how versions should be incremented.+Version:             0.0.3.3++-- A short (one-line) description of the package.+Synopsis:            Haskell on Gtk rails - Generic View for MVC applications++-- A longer description of the package.+-- Description:         ++-- URL for the project homepage or repository.+Homepage:            http://www.keera.es/blog/community/++-- The license under which the package is released.+License:             BSD3++-- The file containing the license text.+License-file:        LICENSE++-- The package author(s).+Author:              Ivan Perez++-- An email address to which users can send suggestions, bug reports,+-- and patches.+Maintainer:          ivan.perez@keera.es++-- A copyright notice.+-- Copyright:           ++Category:            Development++Build-type:          Simple++-- Extra files to be distributed with the package, such as examples or+-- a README.+-- Extra-source-files:  ++-- Constraint on the version of Cabal needed to build this package.+Cabal-version:       >=1.2++Library+  hs-source-dirs: src/+  +  ghc-options: -Wall -fno-warn-unused-do-bind -O2++  -- Modules exported by the library.+  Exposed-modules: Hails.MVC.View+  +  -- Packages needed in order to build this package.+  Build-depends: base >= 4 && < 5

@@ -0,0 +1,42 @@+-- | This class encapsulates GUI apis with some basic common operations:+-- initialise the GUI, destroy the GUI, execute in the GUI Thread, etc.++-- NOTE: This code is stable, but the design is experimental.+-- It works fine, but I doubt it's a good solution in the long term. In+-- particular, I do not like having to use the dummy type Null to define the+-- Class.++module Hails.MVC.View where++-- | Null is a parametric datatype with a non-parametric constructor.++-- NOTE: IT simplifies the class definition.+data Null a = Null++-- | A Class for View (GUI) managers. GUI managers usually have similar+-- operations: initialise, destroy, run operation in the GUI thread, etc.+-- This class encapsulates all these operations to provide a unique interface.+class View a where+  initView    :: Null a -> IO ()+  createView  :: IO a+  startView   :: a -> IO ()+  onViewSync  :: a -> IO b -> IO b+  onViewAsync :: a -> IO () -> IO ()+  destroyView :: a -> IO ()++-- | An Element Accessor to access elements of kind+-- b from Views of kind a is a function that takes an+-- a and returns a b.+--+-- This type is defined to make signatures shorter+-- and more declarative.+type ViewElementAccessor a b = (a -> b)++-- | An Element Accessor to access elements of kind+-- b from Views of kind a is a function that takes an+-- a and returns an IO b.+--+-- This is the IO counterpart of the previous type. It is+-- used more often because most element accessors run+-- inside the IO monad.+type ViewElementAccessorIO a b = ViewElementAccessor a (IO b)