Skip to main content

Python Flask - Hinting Developers Input and Return Types - Best Practice

Use 'typing' library to hint co-developers reading the code to understand what datatype will a function return.

To hint input types

Example 1

def __init__(self, name: str, price: float, store_id: int):
self.name = name
self.price = price
self.store_id = store_id

Example 2

@classmethod
def find_by_name(cls, name: str) -> "ItemModel": # classmethod to search item in database by name
return cls.query.filter_by(name=name).first()

Example 3

@classmethod
def find_by_id(cls, _id: int) -> "UserModel": # classmethod to search store in database by id
return cls.query.filter_by(id=_id).first()
adding ":str" or ":int" or ":float" in front of the parameter only tells other developers about what is the expected input. It does not actually participate in giving errors when user actually does that.

To hint return types

This requires to import typing library
from typing import Dict, List, Union

When indicating the return type to be Dict

Example 1

Create a new variable that will explain how this particular Dict datatype is designed. Which means, what datatype will be the key and what datatype will be the value.
ItemJSON = Dict[str, Union[int, str, float]]
Then use it in the function to indicate that this is the data type the function would return
def json(self) -> ItemJSON:
return {"id": self.id, "name": self.name, "price": self.price, "store_id": self.store_id}

Example 2

Use previously defined variable for defining the 'Dict' into a new variable to define a new 'Dict', which includes a 'List' of previously defined 'Dict'
StoreJSON = Dict[str, Union[int, str, List[ItemJSON]]]
Then use it in the function to indicate that this is the data type the function would return
def json(self) -> StoreJSON:
return {"id": self.id, "name": self.name, "items": [item.json() for item in self.items.all()]}

When indicating the return type to be a class

Example 1

To indicate that the returning object is a class
@classmethod
def find_by_name(cls, name: str) -> "ItemModel": # classmethod to search in database by name
return cls.query.filter_by(name=name).first()
Example 2
And there could be a list of objects of a class type
@classmethod
def find_all(cls) -> List["ItemModel"]:
return cls.query.all()

Comments

Post a Comment

Popular posts from this blog

Difference between .exec() and .execPopulate() in Mongoose?

Here I answer what is the difference between .exec() and .execPopulate() in Mongoose? .exec() is used with a query while .execPopulate() is used with a document Syntax for .exec() is as follows: Model.query() . populate ( 'field' ) . exec () // returns promise . then ( function ( document ) { console . log ( document ); }); Syntax for .execPopulate() is as follows: fetchedDocument . populate ( 'field' ) . execPopulate () // returns promise . then ( function ( document ) { console . log ( document ); }); When working with individual document use .execPopulate(), for model query use .exec(). Both returns a promise. One can do without .exec() or .execPopulate() but then has to pass a callback in populate.
1 comment
Read more

Machine Learning — Supervised, Unsupervised, and Reinforcement — Explanation with Example

🤖 Let's take an example of machine learning and see how it can be performed in three different ways — Supervised, Unsupervised, and Reinforcement. We want a program to be able to identify apple in pictures Supervised Learning You will create or use a model that takes a set of pictures of apple and it analyses the commonality in those pictures. Now when you show a new picture to the program, it will identify whether it has an apple or not. It can also provide details on how confident is the program about it. Unsupervised Learning In this method, you create or use a model that goes through some images and tries to group them as per the commonalities it observes such as color, shape, size, partern, etc. And now you can go through the groups and inform the program what to call them. So, you can inform the program about the group that is apple mostly. Next time you show a picture, it can tell if an apple is there or not. Reinforcement Learning Here the model you create or...
Post a Comment
Read more

269. Alien Dictionary

  Solution This article assumes you already have some confidence with  graph algorithms , such as  breadth-first search  and  depth-first searching . If you're familiar with those, but not with  topological sort  (the topic tag for this problem), don't panic, as you should still be able to make sense of it. It is one of the many more advanced algorithms that keen programmers tend to "invent" themselves before realizing it's already a widely known and used algorithm. There are a couple of approaches to topological sort;  Kahn's Algorithm  and DFS. A few things to keep in mind: The letters  within a word  don't tell us anything about the relative order. For example, the presence of the word  kitten  in the list does  not  tell us that the letter  k  is before the letter  i . The input can contain words followed by their prefix, for example,  abcd  and then  ab . These cases will never ...
Post a Comment
Read more