W3911 Sudoku Server

Within these castle walls be forged Mavens of Computer Science ...

— Merlin, The Coder

Background A Sudoku board is made up of nine boxes. Boxes (container for nine cells) are listed from top-to-bottom, left-to-right indexed from zero. Cells are listed from top-to-bottom, left-to-right, indexed from zero. All valid payloads and responses must use well-formed JSON. “cells” is returned as follows: “cells”: [[<nine values from top-left>], [<nine values from top-middle>], …]

End Points

POST /games?difficulty=<difficulty>

Creates a new game and associated board

   Parameters: 
   difficulty: easy | medium | hard | hell

   Body: none

   Status code: 201 Created

   Response: ID (integer) of newly created game
   {"id":<id>}
   

   {"id": 728134}

   Errors:
   

   {{{errors}}}

GET /games/<id>/cells

Returns the current cells for the specified game

   Parameters: 
   none

   Body: none

   Status code: 200 OK

   Response: Cells
   {"id":<id>}
   

   {"id": 728134}

   Errors:
   

   {{{errors}}}

PUT /games/<id>/cells/<boxIndex>/<cellIndex>

Place specified value at in game at boxIndex, cellIndex

   Parameters: 
   none

   Body: value (null for removing value)

   Status code: 200 OK

   Response: none
   

   none

   Errors:
   

   {{{errors}}}

JSON Encoding

CoderMerlin™ Code Explorer: W0000 (1) 🟢

Assembly

C

C++

Java

Python

Swift

import Foundation struct Cell: Codable { let value: Int? } let cell = Cell(value: 17) let encoder = JSONEncoder() guard let data = try? encoder.encode(cell), let json = String(data: data, encoding: .utf8) else { fatalError("Failed to encode data into json.") } print(json)

Hide Compilation Output Sync  

Broadcast  

JSON Decoding

CoderMerlin™ Code Explorer: W0000 (2) 🟢

Assembly

C

C++

Java

Python

Swift

import Foundation struct Cell: Codable { let value: Int? } let json = #"{"value":17}"# let decoder = JSONDecoder() guard let data = json.data(using: .utf8), let cell: Cell = try? decoder.decode(Cell.self, from: data) else { fatalError("Failed to decode json into cell.") } dump(cell)

Hide Compilation Output Sync  

Broadcast  

Issue Request from Client to Server

CoderMerlin™ Code Explorer: W0000 (3) 🟢

Assembly

C

C++

Java

Python

Swift

import Foundation import FoundationNetworking // Form the request var request = URLRequest(url: URL(string: "https://language-server.codermerlin.com/now")!) request.httpMethod = "GET" // Execute synchronously (uses extension in code below) let (data, response, error) = URLSession.shared.syncRequest(with: request) if let data = data, let string = String(data: data, encoding: .utf8) { print(string) } else if let error = error { print("Error: \(error)") } else { print("An unexpected error occurred.") } // Reference: https://stackoverflow.com/questions/26784315/can-i-somehow-do-a-synchronous-http-request-via-nsurlsession-in-swift extension URLSession { func syncRequest(with request: URLRequest) -> (Data?, URLResponse?, Error?) { var data: Data? var response: URLResponse? var error: Error? let dispatchGroup = DispatchGroup() let task = dataTask(with: request) { data = $0 response = $1 error = $2 dispatchGroup.leave() } dispatchGroup.enter() task.resume() dispatchGroup.wait() return (data, response, error) } }

Hide Compilation Output Sync  

Broadcast