What I Wish I Knew When Learning Haskell

Total Page:16

File Type:pdf, Size:1020Kb

What I Wish I Knew When Learning Haskell What I Wish I Knew When Learning Haskell Stephen Diehl 2 Version This is the fifth major draft of this document since 2009. All versions of this text are freely available onmywebsite: 1. HTML Version ­ http://dev.stephendiehl.com/hask/index.html 2. PDF Version ­ http://dev.stephendiehl.com/hask/tutorial.pdf 3. EPUB Version ­ http://dev.stephendiehl.com/hask/tutorial.epub 4. Kindle Version ­ http://dev.stephendiehl.com/hask/tutorial.mobi Pull requests are always accepted for fixes and additional content. The only way this document will stayupto date and accurate through the kindness of readers like you and community patches and pull requests on Github. https://github.com/sdiehl/wiwinwlh Publish Date: March 3, 2020 Git Commit: 77482103ff953a8f189a050c4271919846a56612 Author This text is authored by Stephen Diehl. 1. Web: www.stephendiehl.com 2. Twitter: https://twitter.com/smdiehl 3. Github: https://github.com/sdiehl Special thanks to Erik Aker for copyediting assistance. Copyright © 2009­2020 Stephen Diehl This code included in the text is dedicated to the public domain. You can copy, modify, distribute and perform thecode, even for commercial purposes, all without asking permission. You may distribute this text in its full form freely, but may not reauthor or sublicense this work. Any reproductions of major portions of the text must include attribution. The software is provided ”as is”, without warranty of any kind, express or implied, including But not limitedtothe warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authorsor copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, Arising from, out of or in connection with the software or the use or other dealings in the software. Contents 1 Basics 13 What is Haskell? ................................................ 13 How to Read .................................................. 14 GHC ...................................................... 14 ghcup ..................................................... 15 Package Managers ............................................... 16 Project Structure ................................................ 16 Cabal ..................................................... 17 Cabal New­Build ............................................... 20 Local Packages ................................................. 22 Version Bounds ................................................ 22 Stack ...................................................... 23 Hpack ..................................................... 24 Base ...................................................... 25 Prelude ..................................................... 26 Modern Haskell ................................................ 26 Flags ...................................................... 26 Hackage .................................................... 27 Stackage .................................................... 28 GHCi ..................................................... 28 .ghci.conf ................................................... 31 Editor Integration ............................................... 32 Linux Packages ................................................. 33 Names ..................................................... 33 Modules .................................................... 34 Functions ................................................... 35 Types ...................................................... 35 Type Signatures ................................................ 36 Currying .................................................... 38 Algebraic Datatypes .............................................. 38 Lists ...................................................... 40 Pattern Matching ............................................... 41 Guards ..................................................... 43 Operators and Sections ............................................. 43 Tuples ..................................................... 44 Where & Let Clauses ............................................. 45 Conditionals .................................................. 45 Function Composition ............................................. 46 List Comprehensions .............................................. 47 Comments ................................................... 49 Typeclasses ................................................... 50 Side Effects ................................................... 52 3 CONTENTS 4 Records .................................................... 52 Pragmas .................................................... 53 Newtypes ................................................... 53 Bottoms .................................................... 54 Exhaustiveness ................................................. 57 Debugger ................................................... 58 Stack Traces .................................................. 58 Printf Tracing ................................................. 59 Type Inference ................................................. 60 Type Holes ................................................... 61 Deferred Type Errors .............................................. 63 Name Conventions .............................................. 64 ghcid ...................................................... 65 HLint ..................................................... 65 Docker Images ................................................. 66 Continuous Integration ............................................ 66 Ormolu .................................................... 67 Haddock .................................................... 67 Unsafe Functions ................................................ 70 2 Monads 71 Eightfold Path to Monad Satori ........................................ 71 Monad Myths ................................................. 71 Monad Methods ................................................ 72 Monad Laws .................................................. 72 Do Notation .................................................. 73 Maybe Monad ................................................. 75 List Monad .................................................. 77 IO Monad ................................................... 78 What’s the point? ............................................... 80 Reader Monad ................................................. 81 Writer Monad ................................................. 82 State Monad .................................................. 83 Why are monads confusing? .......................................... 84 3 Monad Transformers 87 mtl / transformers ............................................... 87 Transformers .................................................. 88 Basics ..................................................... 88 mtl ....................................................... 89 ReaderT .................................................... 90 Newtype Deriving ............................................... 90 Efficiency ................................................... 93 Monad Morphisms ............................................... 93 Effect Systems ................................................. 94 Polysemy .................................................... 95 Fused Effects .................................................. 98 4 Language Extensions 101 Philosophy ................................................... 101 Classes ..................................................... 101 Extension Dependencies ............................................ 103 The Benign ................................................... 104 The Advanced ................................................. 104 The Lowlevel .................................................. 105 5 CONTENTS The Dangerous ................................................. 105 NoMonomorphismRestriction ......................................... 105 ExtendedDefaultRules ............................................. 106 Safe Haskell .................................................. 107 PartialTypeSignatures ............................................. 107 RecursiveDo .................................................. 108 ApplicativeDo ................................................. 108 PatternGuards ................................................. 109 ViewPatterns .................................................. 109 TupleSections ................................................. 109 Postfix Operators ................................................ 110 MultiWayIf .................................................. 110 EmptyCase ................................................... 110 LambdaCase .................................................. 111 NumDecimals ................................................. 111 PackageImports ................................................ 111 RecordWildCards ............................................... 112 NamedFieldPuns ................................................ 112 PatternSynonyms ............................................... 113 DeriveFunctor ................................................. 114 DeriveFoldable ................................................. 114 DeriveTraversable ............................................... 115 DeriveGeneric ................................................. 115 DeriveAnyClass ................................................ 116 DuplicateRecordFields ............................................
Recommended publications
  • What I Wish I Knew When Learning Haskell
    What I Wish I Knew When Learning Haskell Stephen Diehl 2 Version This is the fifth major draft of this document since 2009. All versions of this text are freely available onmywebsite: 1. HTML Version ­ http://dev.stephendiehl.com/hask/index.html 2. PDF Version ­ http://dev.stephendiehl.com/hask/tutorial.pdf 3. EPUB Version ­ http://dev.stephendiehl.com/hask/tutorial.epub 4. Kindle Version ­ http://dev.stephendiehl.com/hask/tutorial.mobi Pull requests are always accepted for fixes and additional content. The only way this document will stayupto date and accurate through the kindness of readers like you and community patches and pull requests on Github. https://github.com/sdiehl/wiwinwlh Publish Date: March 3, 2020 Git Commit: 77482103ff953a8f189a050c4271919846a56612 Author This text is authored by Stephen Diehl. 1. Web: www.stephendiehl.com 2. Twitter: https://twitter.com/smdiehl 3. Github: https://github.com/sdiehl Special thanks to Erik Aker for copyediting assistance. Copyright © 2009­2020 Stephen Diehl This code included in the text is dedicated to the public domain. You can copy, modify, distribute and perform thecode, even for commercial purposes, all without asking permission. You may distribute this text in its full form freely, but may not reauthor or sublicense this work. Any reproductions of major portions of the text must include attribution. The software is provided ”as is”, without warranty of any kind, express or implied, including But not limitedtothe warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authorsor copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, Arising from, out of or in connection with the software or the use or other dealings in the software.
    [Show full text]
  • Commonspad Ocaml Library Programmer’S Manual
    Commonspad OCaml Library Programmer’s manual Yoann Padioleau [email protected] December 29, 2009 Copyright c 2009 Yoann Padioleau. Permission is granted to copy, distribute and/or modify this doc- ument under the terms of the GNU Free Documentation License, Version 1.3. 1 Short Contents 1 Introduction 4 I Common 7 2 Overview 8 3 Basic 14 4 Basic types 31 5 Collection 46 6 Misc 61 II OCommon 66 7 Overview 67 8 Ocollection 68 9 Oset 71 10 Oassoc 73 11 Osequence 74 12 Oarray 75 13 Ograph 77 14 Odb 81 2 III Extra Common 82 15 Interface 84 16 Concurrency 89 17 Distribution 90 18 Graphic 91 19 OpenGL 92 20 GUI 93 21 ParserCombinators 94 22 Backtrace 100 23 Glimpse 101 24 Regexp 103 25 Sexp and binio 104 26 Python 105 Conclusion 106 A Indexes 107 B References 108 3 Contents 1 Introduction 4 1.1 Features . 4 1.2 Copyright . 5 1.3 Source organization . 6 1.4 API organization . 6 1.5 Acknowledgements . 6 I Common 7 2 Overview 8 3 Basic 14 3.1 Pervasive types and operators . 14 3.2 Debugging, logging . 15 3.3 Profiling . 17 3.4 Testing . 18 3.5 Persitence . 20 3.6 Counter . 21 3.7 Stringof . 21 3.8 Macro . 22 3.9 Composition and control . 22 3.10 Concurrency . 24 3.11 Error management . 24 3.12 Environment . 25 3.13 Arguments . 28 3.14 Equality . 29 4 Basic types 31 4.1 Bool . 31 4.2 Char . 31 4.3 Num .
    [Show full text]
  • The Glasgow Haskell Compiler User's Guide, Version 4.08
    The Glasgow Haskell Compiler User's Guide, Version 4.08 The GHC Team The Glasgow Haskell Compiler User's Guide, Version 4.08 by The GHC Team Table of Contents The Glasgow Haskell Compiler License ........................................................................................... 9 1. Introduction to GHC ....................................................................................................................10 1.1. The (batch) compilation system components.....................................................................10 1.2. What really happens when I “compile” a Haskell program? .............................................11 1.3. Meta-information: Web sites, mailing lists, etc. ................................................................11 1.4. GHC version numbering policy .........................................................................................12 1.5. Release notes for version 4.08 (July 2000) ........................................................................13 1.5.1. User-visible compiler changes...............................................................................13 1.5.2. User-visible library changes ..................................................................................14 1.5.3. Internal changes.....................................................................................................14 2. Installing from binary distributions............................................................................................16 2.1. Installing on Unix-a-likes...................................................................................................16
    [Show full text]
  • Haskell Quick Syntax Reference
    Haskell Quick Syntax Reference A Pocket Guide to the Language, APIs, and Library — Stefania Loredana Nita Marius Mihailescu www.allitebooks.com Haskell Quick Syntax Reference A Pocket Guide to the Language, APIs, and Library Stefania Loredana Nita Marius Mihailescu www.allitebooks.com Haskell Quick Syntax Reference: A Pocket Guide to the Language, APIs, and Library Stefania Loredana Nita Marius Mihailescu Bucharest, Romania Bucharest, Romania ISBN-13 (pbk): 978-1-4842-4506-4 ISBN-13 (electronic): 978-1-4842-4507-1 https://doi.org/10.1007/978-1-4842-4507-1 Copyright © 2019 by Stefania Loredana Nita and Marius Mihailescu This work is subject to copyright. All rights are reserved by the Publisher, whether the whole or part of the material is concerned, specifically the rights of translation, reprinting, reuse of illustrations, recitation, broadcasting, reproduction on microfilms or in any other physical way, and transmission or information storage and retrieval, electronic adaptation, computer software, or by similar or dissimilar methodology now known or hereafter developed. Trademarked names, logos, and images may appear in this book. Rather than use a trademark symbol with every occurrence of a trademarked name, logo, or image we use the names, logos, and images only in an editorial fashion and to the benefit of the trademark owner, with no intention of infringement of the trademark. The use in this publication of trade names, trademarks, service marks, and similar terms, even if they are not identified as such, is not to be taken as an expression of opinion as to whether or not they are subject to proprietary rights.
    [Show full text]
  • Pcl: a Robust Monadic Parser Combinator Library for Ocaml
    Motivation Basic Monadic Parser Combinators Writing pcl pcl: A Robust Monadic Parser Combinator Library for OCaml Chris Casinghino [email protected] OCaml Summer Project Meeting Chris Casinghino pcl: A Robust Monadic Parser Combinator Library for OCaml Motivation Basic Monadic Parser Combinators Writing pcl Outline 1 Motivation 2 Basic Monadic Parser Combinators What Is A Parser? Building Bigger Parsers 3 Writing pcl Chris Casinghino pcl: A Robust Monadic Parser Combinator Library for OCaml Motivation Basic Monadic Parser Combinators Writing pcl Outline 1 Motivation 2 Basic Monadic Parser Combinators What Is A Parser? Building Bigger Parsers 3 Writing pcl Chris Casinghino pcl: A Robust Monadic Parser Combinator Library for OCaml Motivation Basic Monadic Parser Combinators Writing pcl Benefits of Parser Combinators Parsers are specified directly in target language. No need to learn seperate grammar specification language. Parser may be modified on the fly, no seperate building process. Parsers are typechecked. Easy to extend set of available combinators. Lexer and parser may be written with the same tool. Chris Casinghino pcl: A Robust Monadic Parser Combinator Library for OCaml Motivation Basic Monadic Parser Combinators Writing pcl Parsec: Parser Combinators for Haskell Parsec is a popular monadic parser combinator library for Haskell. Parsec has been around for years, and is widely used. Large combinator library, including parsers for lexing, expressions, etc. Expressive error reporting, efficient. pcl is, in large part, a port of Parsec
    [Show full text]
  • The Λ Abroad a Functional Approach to Software Components
    The ¸ Abroad A Functional Approach To Software Components Een functionele benadering van software componenten (met een samenvatting in het Nederlands) Proefschrift ter verkrijging van de graad van doctor aan de Universiteit Utrecht op gezag van de Rector Magni¯cus, Prof. dr W.H. Gispen, ingevolge het besluit van het College voor Promoties in het openbaar te verdedigen op dinsdag 4 november 2003 des middags te 12.45 uur door Daniel Johannes Pieter Leijen geboren op 7 Juli 1973, te Alkmaar promotor: Prof. dr S.D. Swierstra, Universiteit Utrecht. co-promotor: dr H.J.M. Meijer, Microsoft Research. The work in this thesis has been carried out under the auspices of the research school IPA (Institute for Programming research and Algorithmics), and has been ¯nanced by Ordina. Printed by Febodruk 2003. Cover illustration shows the heavily cratered surface of the planet Mercury, photographed by the mariner 10. ISBN 90-9017528-8 Contents Dankwoord ix 1 Overview 1 2 H/Direct: a binary language interface for Haskell 5 2.1 Introduction ................................ 5 2.2 Background ................................ 6 2.2.1 Using the host or foreign language ............... 7 2.2.2 Using an IDL ........................... 8 2.2.3 Overview ............................. 9 2.3 The Foreign Function Interface ..................... 12 2.3.1 Foreign static import and export ................ 12 2.3.2 Variations on the theme ..................... 13 2.3.3 Stable pointers and foreign objects ............... 14 2.3.4 Dynamic import ......................... 15 2.3.5 Dynamic export ......................... 15 2.3.6 Implementing dynamic export .................. 18 2.3.7 Related work ........................... 19 iv Contents 2.4 Translating IDL to Haskell ......................
    [Show full text]
  • PARSEC3.0: a Multicore Benchmark Suite with Network Stacks and SPLASH-2X
    PARSEC3.0: A Multicore Benchmark Suite with Network Stacks and SPLASH-2X Xusheng Zhan1,2, Yungang Bao1, Christian Bienia3, and Kai Li3 1State Key Laboratory of Computer Architecture, ICT, CAS 2University of Chinese Academy of Sciences 3Department of Computer Science, Princeton University Abstract Benchmarks play a very important role in accelerating the development and research of CMP. As one of them, the PARSEC suite continues to be updated and revised over and over again so that it can offer better support for researchers. The former versions of PARSEC have enough workloads to evaluate the property of CMP about CPU, cache and memory, but it lacks of applications based on network stack to assess the performance of CMPs in respect of network. In this work, we introduce PARSEC3.0, a new version of PARSEC suite that implements a user-level network stack and generates three network workloads with this stack to cover network domain. We explore the input sets of splash-2 and expand them to multiple scales, a.k.a, splash-2x. We integrate splash-2 and splash-2x into PARSEC framework so that researchers use these benchmark suite conveniently. Finally, we evaluate the u-TCP/IP stack and new network workloads, and analyze the characterizes of splash-2 and splash-2x. 1. Introduction Benchmarking is a fundamental methodology for computer architecture research. Architects evaluate their new design using benchmark suites that usually consist of multiple programs selected out from a diversity of domains. The PARSEC benchmark suite, containing 13 applications from six emerging domains, has been widely used for evaluating chip multiprocessors (CMPs) systems since it is released in 2008.
    [Show full text]
  • Languageext Documentation Release Latest
    LanguageExt Documentation Release latest March 31, 2016 Contents 1 C# Functional Language Extensions3 1.1 Introduction...............................................3 1.1.1 Getting started.........................................4 1.1.2 Features.............................................5 1.2 Poor tuple support............................................5 1.3 Null reference problem..........................................6 1.4 Option..................................................6 1.4.1 Option monad - gasp! Not the M word!............................9 1.5 if( arg == null ) throw new ArgumentNullException(“arg”)....................... 10 1.6 Lack of lambda and expression inference................................ 12 1.7 Void isn’t a real type........................................... 12 1.8 Mutable lists and dictionaries...................................... 13 1.8.1 Lists............................................... 13 1.8.2 List pattern matching...................................... 14 1.8.3 Maps.............................................. 15 1.8.4 Map transformers........................................ 17 1.9 The awful out parameter........................................ 18 2 ‘Erlang like’ concurrency 21 2.1 Distributed................................................ 22 2.2 How?................................................... 22 2.3 Functions if you want them....................................... 23 2.4 Classes if you want them......................................... 25 2.5 Publish system.............................................
    [Show full text]
  • Functional Programming Paradigm for Machine Learning Algorithms in Data Mining
    UNIVERSIDAD AUTÓNOMA DE MADRID ESCUELA POLITÉCNICA SUPERIOR Degree as DEGREE WORK Functional Programming Paradigm for Machine Learning Algorithms in Data Mining Author: Miguel Fernández de Alarcón Gervás Advisor: Francisco Saiz López junio 2019 All rights reserved. No reproduction in any form of this book, in whole or in part (except for brief quotation in critical articles or reviews), may be made without written authorization from the publisher. © 20th June 2019 by UNIVERSIDAD AUTÓNOMA DE MADRID Francisco Tomás y Valiente, no 1 Madrid, 28049 Spain Miguel Fernández de Alarcón Gervás Functional Programming Paradigm for Machine Learning Algorithms in Data Mining Miguel Fernández de Alarcón Gervás C\ Francisco Tomás y Valiente Nº 11 PRINTED IN SPAIN Agradecimientos Quiero agradecerles el trabajo que han realizado conmigo y el tiempo que me han dedicado mis tutores Francisco Saiz y David Camacho. A mi familia por su apoyo, a mis compañeros de clase por hacer las jornadas en la biblioteca más pasables. A Roberto por ayudarme cuano estaba empezando, a Merel por sus conversaciones en los momentos en los que necesitaba desconectar, a Suso por sus descansos de 5 minutos que se alargaban otros 5 o 40 minutos. Quiero agradecerle especialmente a Emily y Lisa, por haberme ayudado en la corrección de erratas y expresiones en el documento y a todos los que han estado conmigo en este proceso. iii Resumen La minería de datos y el aprendizaje automático han visto un auge en las últimas décadas, con or- denadores cada vez más potentes y, principalmente, debido a la cantidad de datos a los que se puede acceder en la actualidad.
    [Show full text]
  • Table of Contents
    Contents Table of contents Room Page Chairs’ Welcome 5 Main Conference (Monday – Wednesday) H1+H2 International Conference on Functional Programming, Day 1 6 H1+H2 International Conference on Functional Programming, Day 2 7 H1+H2 International Conference on Functional Programming, Day 3 8 Sunday R22+23 Workshop on Higher-Order Programming with E↵ects (HOPE) 9 R2 Workshop on Generic Programming (WGP) 10 Thursday J1 Haskell Symposium, Day 1 11 J2 ML Family Workshop 12 R24+25 Workshop on Functional High-Performance Computing (FHPC) 13 R2,R4,R26 CUFP Tutorials, Day 1 14 Friday J1 Haskell Symposium, Day 2 15 J2 OCaml Workshop 16 R2 Erlang Workshop 17 R24–26 CUFP Tutorials, Day 2 18 Saturday J2 Commercial Users of Functional Programming (CUFP), Talks 19 R2 Haskell Implementors’ Workshop (HIW) 20 R24+25 Workshop on Functional Art, Music, Modeling and Design (FARM) 21 Social events 22 –3– This page is intentionally left blank. –4– Welcome Chairs’ Welcome It is our great pleasure to welcome you to Gothenburg for the 19th ACM SIGPLAN International Conference on Functional Programming: ICFP 2014. This year’s conference continues its tradition as a forum for researchers, developers, and students to discuss the latest work on the design, implementation, principles, and use of functional programming. The conference covers the entire spectrum, from theory to practice. This year’s call for papers attracted 97 submissions: 85 regular research papers, 9 functional pearls and 3 experience reports. Out of these, the program committee accepted 28 papers, two of which are functional pearls and another two are experience reports.
    [Show full text]
  • Indentation-Sensitive Parsing for Parsec
    Indentation-Sensitive Parsing for Parsec Michael D. Adams Ömer S. Agacan˘ University of Illinois at Urbana/Champaign TOBB University of Economics and Technology http://michaeldadams.org/ http://osa1.net/ Abstract The indentation of the bindings after each where keyword de- Several popular languages including Haskell and Python use the termines the structure of this code. For example, the indentation of indentation and layout of code as an essential part of their syntax. the last line determines that it is part of the bindings introduced by In the past, implementations of these languages used ad hoc tech- the first where instead of the second where. niques to implement layout. Recent work has shown that a simple While Haskell and Python are well known for being indenta- extension to context-free grammars can replace these ad hoc tech- tion sensitive, a large number of other languages also use indenta- niques and provide both formal foundations and efficient parsing tion. These include ISWIM (Landin 1966), occam (INMOS Lim- algorithms for indentation sensitivity. ited 1984), Orwell (Wadler 1985), Miranda (Turner 1989), SRFI-49 However, that previous work is limited to bottom-up, LR(k) (Möller 2005), Curry (Hanus (ed.) 2006), YAML (Ben-Kiki et al. parsing, and many combinator-based parsing frameworks including 2009), Habit (HASP Project 2010), F# (Syme et al. 2010), Mark- Parsec use top-down algorithms that are outside its scope. This down (Gruber), reStructuredText (Goodger 2012), and Idris (Brady paper remedies this by showing how to add indentation sensitivity 2013a). Unfortunately, implementations of these languages often to parsing frameworks like Parsec.
    [Show full text]
  • Lightweight Multi-Language Syntax Transformation with Parser Parser
    Lightweight Multi-Language Syntax Transformation with Parser Parser Combinators Rijnard van Tonder Claire Le Goues School of Computer Science School of Computer Science Carnegie Mellon University Carnegie Mellon University USA USA [email protected] [email protected] Abstract CCS Concepts • Software and its engineering → Syn- Automatically transforming programs is hard, yet critical tax; Translator writing systems and compiler genera- for automated program refactoring, rewriting, and repair. tors; Parsers; General programming languages; Domain spe- Multi-language syntax transformation is especially hard due cific languages. to heterogeneous representations in syntax, parse trees, and Keywords syntax, transformation, parsers, rewriting abstract syntax trees (ASTs). Our insight is that the prob- lem can be decomposed such that (1) a common grammar ACM Reference Format: expresses the central context-free language (CFL) proper- Rijnard van Tonder and Claire Le Goues. 2019. Lightweight Multi- Language Syntax Transformation with Parser Parser Combinators. ties shared by many contemporary languages and (2) open In Proceedings of the 40th ACM SIGPLAN Conference on Programming extension points in the grammar allow customizing syntax Language Design and Implementation (PLDI ’19), June 22–26, 2019, (e.g., for balanced delimiters) and hooks in smaller parsers Phoenix, AZ, USA. ACM, New York, NY, USA, 16 pages. https://doi. to handle language-specific syntax (e.g., for comments). Our org/10.1145/3314221.3314589 key contribution operationalizes this decomposition using a Parser Parser combinator (PPC), a mechanism that gen- 1 Introduction erates parsers for matching syntactic fragments in source Automatically transforming programs is hard, yet critical for code by parsing declarative user-supplied templates.
    [Show full text]