temper

temper

Hello,

I have a question that is probably not limited only to Elixir, but I would like to have your opinion about ‘Elixir’-like, or ‘Elixir way’ solution to the question.

The problem I would like to discuss is the application of the ‘design by contract’ software design principle. In short, when designing a data exchange protocol, both sides of the interface agree on the data types and the boundaries of values used when calling the interface/protocol methods. And in the implementation the caller of the function ensures that the protocol is not violated.
I am coming from a world of languages like C++, Java, Python where design by contract is (at least in theory) applied quite often and to some degree supported by the compilers (C++/Java), Despite this fact, the actual implementations of the protocol are full of checks of the potential protocol violations to ensure that the program will not crash (a classical example is checking for the null value of variables passed as parameters to the method/function calls).

Although I am new to Elixir I feel that this problem can be solved quite elegant in many cases by clever application of proper data structures. But I am curious whether there are some best practices established in Elixir.

I have one concrete example illustrating the problem and the possible (as far as I can see) solutions:

  1. The business logic of my application operates on the data structure representing a week. I encoded it as
defmodule WeeklyTimeDistribution do
  defstruct ~w[mo tu we th fr sa su]a
end
  1. The business logic fills each entry of the WeeklyTimeDistribution with a struct, containing, between other the date of a specific day.

  2. At the end of the processing I store the WeeklyTimeDistribution to external data storage via some boundary module. The module defines a protocol, that operates on the instance of the WeeklyTimeDistribution struct.

  3. The API implementation takes days of the struct and tries to store them. Sometimes however, the storage is not allowed, so I need to exclude some days from storing (I know, it sounds a bit strange, but it is something I cannot change - without going into details: days of the week with dates in the future cannot be stored).

From this point I believe there are two choices:

  1. Setup a ‘contract’ where I set the nil values for the days of the week not to be stored and implement the storage API to skip the days with ‘nil’ values from storing.
  2. Change the data type used between the business logic and storage API by passing a map or a list of only valid days of the week (excluding the days in the future). So the contract says in this case: whatever I pass is “legal” and the boundary shall just store it without any checking.

The 2nd option looks more appealing to me because it makes the boundary (data storage module) simple (no checks for ‘nil’ prior to writing. The storage API just iterates over the passed data structure and stores the data.

Is there a common Elixir design pattern for this problem? Shall the boundary classes be just plain absorbers of the data? Or does some defensive programming still make sense in Elixir? What do you think?

Showing Posts 1 to 8

ityonemo

ityonemo

I am not a design by contract expert but i feel like 1) is better. It lets you keep strong typing on the week data structure. You can then typespec the week data structure to have it’s fields be nil or Day.t and in your typedoc specify that nil is only valid for future dates (you could probably even write a runtime check for that in your Week consumer).

lud

lud

Defensive programming is discouraged because we have other ways, but defensive data checking a.k.a. validation is still a thing. So I would say 1. too.

gregvaughn

gregvaughn

One compromise is to write some sort of

WeeklyTimeDistribution.persistable_values(%__MODULE__{} = wtd)

function which could return something like a keyword list of the non-nil values. Then your peristence module can remain ignorant about avoiding nil values. It just prepares the values by calling that function.

dimitarvp

dimitarvp

Coding style nitpick: better don’t do this. When working in teams, most people I worked with found it really hard to follow and track in the code.

Better invest in some code snippets software (or VSCode / Emacs / VIM plugin) to just do this:

defstruct [:mo, :tu, :we, :th, :fr, :sa, :su]
temper

temper OP

Thanks for the advice @ityonemo.

temper

temper OP

Thanks @lud for the advice

temper

temper OP

Thanks for the tip @gregvaughn. I find it interesting approach. It keeps the logic completely at the business logic side. Probably I will need to try the both approaches as a small exercise and see which looks better

temper

temper OP

Thanks for the tip @dimitarvp. Indeed, the project I am working on is the one-man initiative, and also language exploration exercise for me. So I play with some less popular language constructions to see what works and what not.

— All posts loaded —

Where Next? Top

Trending in Discussions Top

AstonJ
As the title says, please share what you’ve been up to with Elixir. Whether that’s been learning it, looking into it, making stuff with i...
2977 92995 915
New
caslu
I want to open this thread for you all to discuss and help those who really like Ash but are still hesitant to use it in a real project. ...
New
mudasobwa
I am happy to introduce the very α version of the new programming language compiled to BEAM. Welcome Cure. It has literally three kille...
New
Herve37
We’re evaluating API mocking tools for OpenAPI-based projects and would love to hear what other teams are using. We’re particularly inte...
New
GES233
I’m posting this in response to Jose’s recent tweet (Cr. link) : People are sleeping on Elixir for a coding harness: Hot-code swappi...
New
_mfierro
Hello, I wrote Stop My Hand, a Scattergories-like web application using Phoenix/LiveView as my learning project for Elixir (after readin...
New
nseaSeb
AcmeScript — Writing JS hooks as if I were still using Elixir I’ve been having fun building a little something over the last few days: Ac...
New

Other Trending Topics Top

garrison
Hobbes is a low-level distributed database for the Elixir programming language. Hobbes provides a simple, safe, and scalable storage lay...
New
mcass19
ExRatatui lets you cook up rich terminal UIs in Elixir, powered by Rust’s ratatui via Rustler NIFs. Build interactive terminal applicatio...
New
Damirados
Hello everyone. After busy few months I am happy to announce v0.1.0 of Emerge & Solve. They are GUI (Emerge) and State management (S...
New
netoum
Corex is an accessible, unstyled UI component library for Phoenix that integrates Zag.js state machines using Vanilla JavaScript and Live...
New
wintermeyer
There are three potential reasons for members of this forum to have a look at https://vutuv.de You are tired or annoyed of LinkedIn. Yo...
New
webofbits
Aludel - LLM Evaluation Workbench Aludel is an embeddable Phoenix LiveView dashboard for evaluating and comparing LLM prompts across mult...
New

We're in Beta

About us Mission Statement

Options

Thread Display Mode




Thread Preview

Skip Thread Previews