blubparadox

blubparadox

Forgive me, this could be answered somewhere but “t” and “t()” are difficult to get to work in search.

When writing types for your code, especially the module types, is it “better” to use t or t() when writing and using types? I’ve seen both used, with no explanation as to why. If both are conventions, which convention is more used?

Even the built-in types aren’t helpful, I’ve seen String.t and String.t() used in examples.

Showing Posts 1 to 4

stefanluptak

stefanluptak

Isn’t the formatter (running mix format) converting t into t() automatically?

sodapopcan

sodapopcan

It’s really totally up to you, both are correct and don’t let anyone tell you otherwise :slight_smile: But as @stefanluptak says, it you use the formatter it’s decided for you.

blubparadox

blubparadox OP

My Elixir code has been dynamic up to now, but I’ve been watching DDD videos and other sources that are convincing me to start using types in some places. I didn’t even know a formatter would do that.
I write my code in VS Code with ElixirLS installed. Will it be formatted automatically?

arcanemachine

arcanemachine

I think this is one of those ambiguous things that doesn’t have a definite answer (much to my chagrin… I hate having to make meaningless design decisions).

I follow the convention for functions as defined in some of the style guides I’ve come across (here’s one by the Credo folks, and here’s some implicit examples from another style guide), which is: When defining a zero-arity function (or type, in this case), I omit the brackets, and when calling the function (or referencing a type), I always include the brackets.

For example:

Define a type

@type t :: String.t()

Use the type in a spec

@spec hello_world :: t()
def hello_world, do: "Hello world!"

@spec say_your_age(integer()) :: t()
def say_your_age(age), do: "You are #{age} years old."

For me, this is the most consistent way to do things, while still matching the spirit of the style guides I’ve seen.

Personally, I dislike the omission of the brackets in zero-arity functions. It’s a function, just give it the damn brackets. But I think it’s a holdover from the early days, when brackets were not required at all.

— All posts loaded —

Where Next? Top

Trending in Questions Top

RSP87
I’m working on a project that simulates the bumbl example in the programming phoenix book. It acts almost like an email client. We have a...
New
kpanic
Hi everyone, I am toying with the idea of building a “match maker” for giving personal help to people that wants to start coding. I sta...
New
nseaSeb
Hello, I know there is an approach for handling lists that allows for optimized traversal, but I can’t recall the specific method (somet...
New
brecabral
Documentation While reading the Scoped Routes section, I noticed that the documentation currently refers to a problem without explainin...
New
velrest
So my question is quite simple and i have found no conclusive answer on forum, google or AI. Should we use :erlang.float for Integer to ...
New
asweet-confluent
I recently noticed that Elixir’s Logger defaults its primary log level to :debug when no :logger, :level application configuration is pre...
New
ryanwinchester
apply_graft/2 doesn’t rewrite an add_many sub-workflow’s deps on an add step. Grafted jobs cancel with “upstream job was deleted” Version...
New

Other Trending Topics Top

JesseHerrick
Hey, I’m Jesse and I’m the main contributor behind Dexter, a full-featured, lightning-fast Elixir LSP optimized for large codebases. It s...
New
marciok
Hi there! We created Gust: A task orchestrator inspired by Airflow. For those who have never heard about Aiflow, it’s a Python-based wor...
New
mhanberg
Hi everyone! The first release candidate for the Expert language server project is now available! We’ve published a press release detai...
New
jimsynz
Beam Bots (or just BB for short) is a framework for building fault-tolerant robotics applications in Elixir using familiar OTP patterns. ...
New
Dmk
Xamal is a deployment tool for Elixir apps that deploys native releases to bare metal servers over SSH. It’s a port of GitHub - basecamp/...
New
webofbits
With AI doing more of the implementation work, I’ve been wondering how much coding I should deliberately keep doing myself. My main conc...
#ai
New

We're in Beta

About us Mission Statement

Options

Thread Display Mode




Thread Preview

Skip Thread Previews