Naming Scheme

Some BookieSports files (in particular name and description fields) allow the use of variables. Those are dynamic and filled in by bookie-sync, automatically.
As an example, the file MLB_ML_1.yaml defines betting markets for a Moneyline market group. The betting markets carry the name of the event participants. We encode this in BookieSports using variables:
- description:
en: '{teams.away}'
- description:
en: '{teams.home}'

Overview of variables

  • teams:
    • {teams.home}: Home team
    • {teams.away}: Away team
  • result:
    • {teams.home}: Points for home team
    • {teams.away}: Points for away team
    • {teams.hometeam}: Points for home team
    • {teams.awayteam}: Points for away team
    • {}: Total Points
  • handicaps:
    • {teams.home}: Comparative (symmetric) Handicaps (e.g., +-2) for home team
    • {teams.away}: Comparative (symmetric) Handicaps (e.g., +-2) for away team
    • {teams.home_score}: Absolute handicap for home team (e.g., 2)
    • {teams.away_score}: Absolute handicap for away team (e.g., 0)
  • overunder:
    • {teams.value}: The over-/under value

Internal Processing

The variable parsing is done in bos-sync ( and work through decode_variables and a few classes that deal with the variables. This allows us to have complex variable substitutions.
The variables all consist of a module identifier and the actual member variable:
All modules are listed in the substitutions variable in decode_variables::
substitutions = {
"teams": Teams,
"result": Result,
"handicaps": Handicaps,
"overunder": OverUnder,
The modules themselves (capitalized first letter) are defined in the same file and can be as easy as:
class Result:
""" Defines a few variables to be used in conjuctions with {result.X}
def __init__(self, **kwargs):
result = kwargs.get("result", [0, 0]) or [0, 0]
self.hometeam = result[0]
self.awayteam = result[1] = sum([float(x) for x in result])
# aliases
self.home = self.hometeam
self.away = self.awayteam
or as complex as:
class Teams:
""" Defines a few variables to be used in conjuctions with {teams.X}
def __init__(self, **kwargs):
teams = kwargs.get("teams", ["", ""]) or ["", ""]
self.home = " ".join([
x.capitalize() for x in teams[0].split(" ")])
self.away = " ".join([
x.capitalize() for x in teams[1].split(" ")])