lotto

FDJ-SDK-LOTTO

This package is a sdk of the lotto (FRANCAISE DES JEUX) and could get the full draws history. It get the draws history provided from any csv files and convert them in a standardized Draw format.

This project will undergo a refactoring in the coming months, which will cause significant break-in changes. The goal is to be able to add all types of FDJ games. It's not an urgent matter at the time of this commit, but keep it in mind.

Installation

Download fdj-sdk-lotto:

$ go get -u github.com/winning-number/fdj-sdk-lotto@latest
# go: downloading github.com/winning-number/fdj-sdk-lotto ...
# go: added github.com/winning-number/fdj-sdk-lotto ...

Usage

Read the godoc documentation

They are two way for use this sdk. You can get directly the history from the FRANCAISE DES JEUX or directly by providing a CSV file (in this case, you need to know all type of Draw)

• From the FRANCAISE DES JEUX api

package main

import (
    "context"
    "github.com/winning-number/fdj-sdk-lotto"
)

func main() {
    var err error
    var driver lotto.API

    if driver, err = lotto.NewAPI(); err != nil {
        panic(err)
    }
    // get all by default
    sources := SourceInfoAll(APIVersion3)
    if err = driver.LoadSource(context.Background(), sources); err != nil {
        panic(err)
    }
    draws := driver.Draws(lotto.Filter{
        SuperLotto:   true
        GrandLotto:   true
        XmasLotto:    true
        ClassicLotto: true
        OldLotto:     true
    }, draw.OrderNone)
}

• From your csv files

package main

import (
    "context"
    "github.com/winning-number/fdj-sdk-lotto"
)

func main() {
    var err error
    var driver lotto.API
    var file *os.File

    if file, err = os.Open("your_filepath.csv"); err != nil {
        panic(err)
    }
    defer file.Close()
    if driver, err = lotto.NewAPI(); err != nil {
        panic(err)
    }
    // get all by default
    if err = driver.LoadFile(file, lotto.GetSourceInfo(lotto.Loto201911)); err != nil {
        panic(err)
    }
    draws := driver.Draws(lotto.Filter{
        SuperLotto:   true
        GrandLotto:   true
        XmasLotto:    true
        ClassicLotto: true
        OldLotto:     true
    })
}

Type of DRAW

From the begin of the lotto, the rules are been updated any time. So, to exploit the full history, each version are interpreting like a global Draw type.

V0

• Concern only the super lotto type before 2008 october. They was 6 balls between 1 and 49 included and one lucky ball between 1 and 49 included. All balls are added inside the global slice of ball inside the Draw type. Result is provinding in a pick order and number order.
• Only one a joker+ picked by draw.
• 7 Winners Rank by Draw.

V1

• Concern only the classic lotto type before 2008 october. They was 6 balls between 1 and 49 included and one lucky ball between 1 and 49 included. All balls are added inside the global slice of ball inside the Draw type. Result is provinding in a pick order and number order.
• They was one a joker+ and one joker number picked by draw.
• 7 Winners Rank by Draw.

V2

• Concern the classic lotto and the super lotto type between 2008 october and 2017 march. They was 5 balls between 1 and 49 included and one lucky ball between 1 and 9 included. these 5 balls are added inside the global slice of ball inside the Draw type and the lucky ball is added inside a LuckyBall field (int32).
• Only one a joker+ picked by draw.
• 6 Winners Rank by Draw.

V3

• Concern the classic lotto, the super lotto, the grand lotto and the grand lotto (xmas) type between 2017 march and 2019 november. They was 5 balls between 1 and 49 included and one lucky ball between 1 and 9 included. these 5 balls are added inside the global slice of ball inside the Draw type and the lucky ball is added inside a LuckyBall field (int32). Result is provinding in a pick order and number order.
• Only one a joker+ picked by draw.
• 9 Winners Rank by Draw.
• Add Winning number (any by draw depends of type of draw).

V4

• Concern the classic lotto type from 2019 november. They was 5 balls between 1 and 49 included and one lucky ball between 1 and 9 included. these 5 balls are added inside the global slice of ball inside the Draw type and the lucky ball is added inside a LuckyBall field (int32). Result is provinding in a pick order and number order.
• Only one a joker+ picked by draw.
• 9 Winners Rank by Draw.
• Add Winning number (any by draw depends of type of draw).
• Add a Second Roll with 5 balls between 1 and 49 included (no lucky ball). Result is providing in only in a number order.
• 4 Winners Rank for the second Roll

Contributing

 ❕  Use issues for everything

Read more informations with the CONTRIBUTING_GUIDE

For all changes, please update the CHANGELOG.txt file by replacing the existant content.

Thank you  🙏  👍 

Made with contrib.rocks.

License

GNU GPL v3