Simply add minio-hs to your project's .cabal dependencies section or if you are using hpack, to your package.yaml file as usual.
Try it out directly with ghci
From your home folder or any non-haskell project directory, just run:
stack install minio-hs
Then start an interpreter session and browse the available APIs with:
$ stack ghci
> :browse Network.Minio
Examples
The examples folder contains many examples that you can try out and use to learn and to help with developing your own projects.
Quick-Start Example - File Uploader
This example program connects to a MinIO object storage server, makes a bucket on the server and then uploads a file to the bucket.
We will use the MinIO server running at https://play.min.io in this example. Feel free to use this service for testing and development. Access credentials are present in the library and are open to the public.
FileUploader.hs
#!/usr/bin/env stack
-- stack --resolver lts-14.11 runghc --package minio-hs --package optparse-applicative --package filepath---- MinIO Haskell SDK, (C) 2017-2019 MinIO, Inc.---- Licensed under the Apache License, Version 2.0 (the "License");-- you may not use this file except in compliance with the License.-- You may obtain a copy of the License at---- http://www.apache.org/licenses/LICENSE-2.0---- Unless required by applicable law or agreed to in writing, software-- distributed under the License is distributed on an "AS IS" BASIS,-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.-- See the License for the specific language governing permissions and-- limitations under the License.--
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE ScopedTypeVariables #-}
importNetwork.MinioimportData.Monoid ((<>))
importData.Text (pack)
importOptions.ApplicativeimportSystem.FilePath.PosiximportUnliftIO (throwIO, try)
importPrelude--| The following example uses minio's play server at-- https://play.min.io. The endpoint and associated-- credentials are provided via the libary constant,---- > minioPlayCI :: ConnectInfo---- optparse-applicative package based command-line parsing.fileNameArgs::ParserFilePath
fileNameArgs = strArgument
(metavar "FILENAME"<> help "Name of file to upload to AWS S3 or a MinIO server")
cmdParser = info
(helper <*> fileNameArgs)
(fullDesc
<> progDesc "FileUploader"<> header
"FileUploader - a simple file-uploader program using minio-hs")
main::IO()
main =dolet bucket ="my-bucket"-- Parse command line argument
filepath <- execParser cmdParser
let object = pack $ takeBaseName filepath
res <- runMinio minioPlayCI $do-- Make a bucket; catch bucket already exists exception if thrown.
bErr <- try $ makeBucket bucket Nothing-- If the bucket already exists, we would get a specific-- `ServiceErr` exception thrown.case bErr ofLeftBucketAlreadyOwnedByYou->return()Left e -> throwIO e
Right _ ->return()-- Upload filepath to bucket; object name is derived from filepath.
fPutObject bucket object filepath defaultPutObjectOptions
case res ofLeft e ->putStrLn$"file upload failed due to "++show e
Right()->putStrLn"file upload succeeded."
git clone https://github.com/minio/minio-hs.git
cd minio-hs/
stack install
Tests can be run with:
stack test
A section of the tests use the remote MinIO Play server at https://play.min.io by default. For library development, using this remote server maybe slow. To run the tests against a locally running MinIO live server at http://localhost:9000, just set the environment MINIO_LOCAL to any value (and unset it to switch back to Play).
To run the live server tests, set a build flag as shown below:
stack test --flag minio-hs:live-test
# OR against a local MinIO server with:
MINIO_LOCAL=1 stack test --flag minio-hs:live-test
The configured CI system always runs both test-suites for every change.
请发表评论