summaryrefslogtreecommitdiff
path: root/HTTP.cabal
blob: 4a2c50d4ad318689151243c7e43762706099e3c3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
Name: HTTP
Version: 4000.3.13
Cabal-Version: >= 1.8
Build-type: Simple
License: BSD3
License-file: LICENSE
Author: Warrick Gray <warrick.gray@hotmail.com>
Maintainer: Ganesh Sittampalam <ganesh@earth.li>
Homepage: https://github.com/haskell/HTTP
Category: Network
Synopsis: A library for client-side HTTP
Description:

 The HTTP package supports client-side web programming in Haskell. It lets you set up
 HTTP connections, transmitting requests and processing the responses coming back, all
 from within the comforts of Haskell. It's dependent on the network package to operate,
 but other than that, the implementation is all written in Haskell.
 .
 A basic API for issuing single HTTP requests + receiving responses is provided. On top
 of that, a session-level abstraction is also on offer  (the @BrowserAction@ monad);
 it taking care of handling the management of persistent connections, proxies,
 state (cookies) and authentication credentials required to handle multi-step
 interactions with a web server.
 .
 The representation of the bytes flowing across is extensible via the use of a type class,
 letting you pick the representation of requests and responses that best fits your use.
 Some pre-packaged, common instances are provided for you (@ByteString@, @String@).
 .
 Here's an example use:
 .
 >
 >    do
 >      rsp <- Network.HTTP.simpleHTTP (getRequest "http://www.haskell.org/")
 >              -- fetch document and return it (as a 'String'.)
 >      fmap (take 100) (getResponseBody rsp)
 >
 >    do
 >      (_, rsp)
 >         <- Network.Browser.browse $ do
 >               setAllowRedirects True -- handle HTTP redirects
 >               request $ getRequest "http://www.haskell.org/"
 >      return (take 100 (rspBody rsp))
 .
 __Note:__ This package does not support HTTPS connections.
 If you need HTTPS, take a look at the following packages:
 .
 * <http://hackage.haskell.org/package/http-streams http-streams>
 .
 * <http://hackage.haskell.org/package/http-client http-client> (in combination with
 <http://hackage.haskell.org/package/http-client-tls http-client-tls>)
 .
 * <http://hackage.haskell.org/package/req req>
 .
 * <http://hackage.haskell.org/package/wreq wreq>
 .

Extra-Source-Files: CHANGES

tested-with: GHC==8.6.3, GHC==8.4.4, GHC==8.2.2, GHC==8.0.2, GHC==7.10.3, GHC==7.8.4, GHC==7.6.3, GHC==7.4.2, GHC==7.2.2, GHC==7.0.4

Source-Repository head
  type: git
  location: https://github.com/haskell/HTTP.git

Flag mtl1
  description: Use the old mtl version 1.
  default: False

Flag warn-as-error
  default:     False
  description: Build with warnings-as-errors
  manual:      True

Flag conduit10
  description: Use version 1.0.x or below of the conduit package (for the test suite)
  default: False

Flag warp-tests
  description: Test against warp
  default:     False
  manual:      True

flag network-uri
  description: Get Network.URI from the network-uri package
  default: True

Library
  Exposed-modules:
                 Network.BufferType,
                 Network.Stream,
                 Network.StreamDebugger,
                 Network.StreamSocket,
                 Network.TCP,
                 Network.HTTP,
                 Network.HTTP.Headers,
                 Network.HTTP.Base,
                 Network.HTTP.Stream,
                 Network.HTTP.Auth,
                 Network.HTTP.Cookie,
                 Network.HTTP.Proxy,
                 Network.HTTP.HandleStream,
                 Network.Browser
  Other-modules:
                 Network.HTTP.Base64,
                 Network.HTTP.MD5Aux,
                 Network.HTTP.Utils
                 Paths_HTTP
  GHC-options: -fwarn-missing-signatures -Wall

  -- note the test harness constraints should be kept in sync with these
  -- where dependencies are shared
  Build-depends: base >= 4.3.0.0 && < 4.13, parsec >= 2.0 && < 3.2
  Build-depends: array >= 0.3.0.2 && < 0.6, bytestring >= 0.9.1.5 && < 0.11
  Build-depends: time >= 1.1.2.3 && < 1.10

  Extensions: FlexibleInstances

  if flag(mtl1)
    Build-depends: mtl >= 1.1.1.0 && < 1.2
    CPP-Options: -DMTL1
  else
    Build-depends: mtl >= 2.0 && < 2.3

  if flag(network-uri)
    Build-depends: network-uri == 2.6.*, network >= 2.6 && < 3.1
  else
    Build-depends: network >= 2.4 && < 2.6

  if flag(warn-as-error)
    ghc-options:      -Werror

  if os(windows)
    Build-depends: Win32 >= 2.2.0.0 && < 2.9

Test-Suite test
  type: exitcode-stdio-1.0

  hs-source-dirs: test
  main-is: httpTests.hs

  other-modules:
    Httpd
    UnitTests

  -- note: version constraints for dependencies shared with the library
  -- should be the same
  build-depends:     HTTP,
                     HUnit >= 1.2.0.1 && < 1.7,
                     httpd-shed >= 0.4 && < 0.5,
                     mtl >= 1.1.1.0 && < 2.3,
                     bytestring >= 0.9.1.5 && < 0.11,
                     deepseq >= 1.3.0.0 && < 1.5,
                     pureMD5 >= 0.2.4 && < 2.2,
                     base >= 4.3.0.0 && < 4.13,
                     split >= 0.1.3 && < 0.3,
                     test-framework >= 0.2.0 && < 0.9,
                     test-framework-hunit >= 0.3.0 && <0.4

  if flag(network-uri)
    Build-depends: network-uri == 2.6.*, network >= 2.6 && < 3.1
  else
    Build-depends: network >= 2.3 && < 2.6

  if flag(warp-tests)
    CPP-Options: -DWARP_TESTS
    build-depends:
                       case-insensitive >= 0.4.0.1 && < 1.3,
                       http-types >= 0.8.0 && < 1.0,
                       wai >= 2.1.0 && < 3.3,
                       warp >= 2.1.0 && < 3.3

    if flag(conduit10)
      build-depends:
                         conduit >= 1.0.8 && < 1.1
    else
      build-depends:
                         conduit >= 1.1 && < 1.4,
                         conduit-extra >= 1.1 && < 1.4