5 Tips To Write Better Python Functions

  Рет қаралды 61,143

Indently

Indently

Күн бұрын

In this video I’m going to be showing you 5 tips and tricks that can help you write better Python functions in 2024.
Sphinx: www.sphinx-doc.org/en/master/...
▶ Become job-ready with Python:
www.indently.io
▶ Follow me on Instagram:
/ indentlyreels
00:00 Learning Python made simple
00:05 Tip #1
01:45 Tip #2
06:32 Tip #3
10:04 Tip #4
12:31 Tip #5
15:43 Your thoughts

Пікірлер: 116
@shakapaker
@shakapaker Ай бұрын
1. raise NotImplementedError instead of "pass" or "..." 2. always specify return types 3. use docstrings for extra info 4. force keyword args for complex functions with *, 5. use *args to collect variable arguments
@Swampy293
@Swampy293 Ай бұрын
thx, saved me 15 minutes
@kezif
@kezif Ай бұрын
thanks, 15 minutes saved
@user-iy6dt4xp5o
@user-iy6dt4xp5o 27 күн бұрын
*1. raise NotImplementedError instead of … *EDIT: this was fixed*
@xsamueljr
@xsamueljr 27 күн бұрын
*args instead of *strings
@entreprenewer
@entreprenewer 18 күн бұрын
Not all heroes wear capes
@hellNo116
@hellNo116 Ай бұрын
as a c/c++ enjoyer i must say that it warms my heart that specifying the return type not only is a thing, but a recommended practice
@vamastah1737
@vamastah1737 18 күн бұрын
I am a C/C++ enjoyer and I do not like that. If you need a statically typed language, you should just use one instead changing Python to resemble C++.
@hellNo116
@hellNo116 18 күн бұрын
@@vamastah1737 i don't want a statically typed python. i want to force typing on input variables and return. it just makes debugging developing and documentation easier. i have used python, but only in a project for my master (i don't count the projects in which you use python to do ai or image processing and similar things, i am talking about application development). i like the language. it is easy to work with. easy to prototype. it is a great language. however the amount of times that i have suffered debugging line 1003 on a random library because i was allowed to call a function with the wrong input variables is let's say not zero. having the ability to force the type of variables in when a function expect specific function from the object in the input is a good thing, that makes the code more readable
@vamastah1737
@vamastah1737 17 күн бұрын
@@hellNo116 well, true, but there are more issues like that in Python and they are solved in statically typed languages by simple syntax checking before actual run. Python got adopted to applications it was not designed in the first place and hence the issue.
@hellNo116
@hellNo116 17 күн бұрын
@@vamastah1737i will not argue on that. it is true python was not meant to be a application language. however it happened to be because of circumstances. and it is really strong and capable. so i don't know if we can simply ignore it. also its syntax and some other feature that are inherited to the language seem to be the favorites of many python programmers. all i am trying to say is that python has legs and it is not the worst language for what we are using it for.
@DrDeuteron
@DrDeuteron Ай бұрын
Since you didn't ask, here are my tips for functions: docstring for users comment for devs pass arguments as keywords (for devs--from Raymond Hettinger--If you don't know who that is, you're not a pystro) single point return for successful use-cases use guard clause to catch errors early and raise/return early minimize branches (cyclic complexity). only ONE purpose per function: break it down, use private helpers if needed) so devs never scroll to see the whole function. all functions should be PURE: if it depends on state or mutates parameters, make it a class method....and don't mutate someone else's state. only 'type(self) should mutate 'self's attributes.
@FighterAceee94
@FighterAceee94 Ай бұрын
raise NotImplementedError("Too drunk to think this through atm")
@hriscuvalerica4814
@hriscuvalerica4814 Ай бұрын
Most of the time i use an iterable instead of the *args and **kwargs thingy in those types of situations.I feel it's more readable. I used *args , **kwargs when i needed to pass a function and some of it's arguments to a class instance to execute while a method was sleeping .
@Indently
@Indently Ай бұрын
Do you mind sharing a snippet here regarding what you mean? I didn't quite understand, but am curious to see what it looks like!
@heljhumenad
@heljhumenad Ай бұрын
yes please I also curious about that thing how you use the iterable. ?
@CrYpt001
@CrYpt001 Ай бұрын
​ @Indently Basically I would rather use "strings : typing.Iterable[str]" instead of "*strings" because it's less complicated and I think it's more readable . As for the second part of my comment I just wanted to ramble about how I last used the *args thingy .Not actually relevant to the discussion..... I automated some browser game and i wanted to be able to do thing while the program was executing a "time.sleep" . So the easiest way to do it that came to my mind was "a="spU9INjHN " . And i generate those functions this way : b="7XDxKTXWN" .Links on "onlinegdb" because i have no idea how to link stuff on yt .
@hriscuvalerica4814
@hriscuvalerica4814 Ай бұрын
It means I would rather use "strings :typing.Iterable[str]" instead of "*strings" because it is more readable in my opinion . As for the second part of my comment it's kind of irrelevant , i just wanted to talk about how i last used the feature . I automated some browser game and i wanted to do something while the code was executing a time.sleep . So i wrote this : oEOt6J0JM . And i generate the code this way az2r951Ss . The code snippet is hosted on onlinegdb , i dunno how to share links on yt.
@souris_a_boule5695
@souris_a_boule5695 Ай бұрын
​@@IndentlyI think @hriscuvalerica4814 want to say that its more readable when a function accept a list for example instead of accepting an infinite amount of arguments because it is more explicit for the user
@romy4romy4
@romy4romy4 25 күн бұрын
1. Disagree about pass. Using it is very helpful if you want to prepare a mocked business logics without skipping any required function which will be much more terrific if you lose something. Logic debugging sometimes very dufficult. So i would say do using pass ever. Searching by word pass is simple, but it impossible if you lose logic call because you go step by step implementation.
@ritikraj26_
@ritikraj26_ 24 күн бұрын
Finally people are realising that a proper syntax with explicit variable types, return types, etc actually makes programming easy.
@dipeshsamrawat7957
@dipeshsamrawat7957 Ай бұрын
Excellent! 💯
@Websitedr
@Websitedr Ай бұрын
I'm always trying to find more "pythonic" ways to do things since behavior is different in C or Java. Even a simple for loop isn't the same in Python it's a "for each" and so much easier to use than for(i==0,i
@Jeb74_
@Jeb74_ Ай бұрын
It is not always the best idea to use a for-each approach. I developed on python for 2 years and this type of loops implies that you cannot use the full potential of a condition. For example: if you want to execute a for loop only on certain conditions you can't do that in python without declaring before or inside the loop an if statement. This could seem better in terms of readability but if you want efficient code this is not the best. I had to solve this problem with a function called takewhile that takes a predicate and the list of items, but calling a function everytime i need a value is not a good option if I already have all data
@ChrisJones-hv7mo
@ChrisJones-hv7mo Ай бұрын
Good stuff. For docstring Sphinx conformant :param: or :return: statements I wouldn't just repeat the type hint you put in the def statement as it is generally redundant, and even if it wasn't the place that should go is in :type: or :rtype:. The only time you might want :type: or :rtype: there is if you want to add ",optional" just in case you didn't want to use the type hint typing.Optional[] in the def statement. Pycharm and for that matter Sphinx generated documentation picks everything up well if you have type hints in the def and ignore :type: + :rtype:. Oh, for up to date versions of Sphinx, at the end of the :param:, use for default values ", defaults to [DefaultParamVal]". The older syntax was something like (Default: ``'Default Value'``). I'm sure everyone can handle that, as we are all coping with how type hinting has changed from Python 3.6 to 3.12.
@gksculpture
@gksculpture 6 күн бұрын
I must say I love your tutorial so many new concept I thought that never exist 👌🏽
@oSpam
@oSpam Ай бұрын
Great vid. We need a video on naming things. So different case styles for variables, function names, classes etc, to be more descriptive in the names, and just common practices for naming things. So many people name things with the wrong case, a video would help clear them up 😊
@replikvltyoutube3727
@replikvltyoutube3727 Ай бұрын
Pep8
@oSpam
@oSpam Ай бұрын
@@replikvltyoutube3727 but so are all of his other videos. Doesnt make a difference. A video form of ideas reaches more beginners then pep8
@DrDeuteron
@DrDeuteron Ай бұрын
@@replikvltyoutube3727 *a summary of PEP 8.
@benjamingeiger
@benjamingeiger 17 күн бұрын
I wish the ellipsis would raise NotImplementedError (the way ??? does in Scala) instead of effectively being a synonym for "pass" when outside slice context.
@mohdaman7228
@mohdaman7228 Ай бұрын
Your videos are really helpful. As you are always stressing for annotations could you point me to any video of yours where you have discussed about the annotations of async await and other complex return type and variables. If you have not talked about it a new video on it would be great
@sebastienollquist1318
@sebastienollquist1318 Ай бұрын
Yesss, it's fundamental to add typing in Python, or as a matter of fact, in any programming language (yes including you Javascript :o)
@kumaranb8702
@kumaranb8702 Ай бұрын
Very nice 🙂
@phaedrus2633
@phaedrus2633 Ай бұрын
Great tutorial videos. You really get me thinking. My head hurts!
@godwinv4838
@godwinv4838 Ай бұрын
thanks
@senzmaki4890
@senzmaki4890 Ай бұрын
9:14 I see no point in specifying types in docstrings when your function is already type annotated, not only is it redundant but it makes the codebase less maintainable since if the function's arguments and return types were to ever change you might fail to update the documentation
@lydellackerman800
@lydellackerman800 Ай бұрын
some documentation generators cant infer types based on hints, and you have bigger issues if you forget to update docs accordingly, in my opinion.
@senzmaki4890
@senzmaki4890 Ай бұрын
@@lydellackerman800 That's a really niche case for whoever uses the subpar docgen specifically. It's not so much to do with forgetting to update documentation but more so propagating bad practices, it's like specifying the types in documentation in a statically typed language it's just redundant, remember DRY.
@lydellackerman800
@lydellackerman800 Ай бұрын
@@senzmaki4890thats a fair point. I was wrong
@sdmagic
@sdmagic Ай бұрын
Very useful. Thanks!
@bendirval3612
@bendirval3612 25 күн бұрын
Those were some great tips. Thanks!
@tigidou3344
@tigidou3344 14 күн бұрын
Know args typing it's NOT saving time. Exemple : you know to pass a int, but which value can have ? Absolute ? maximun ? Return type... help for IDE but... can be the same problem that args if native type (int, str, dict, etc.).
@user-cx6rg6mr7d
@user-cx6rg6mr7d 20 күн бұрын
thank you so much!
@7thAttempt
@7thAttempt 28 күн бұрын
Excellent!
@Sailesh_Bhoite
@Sailesh_Bhoite Ай бұрын
I noticed that you have a codeium AI attached, right? Does it explain 400-500 lines of code or more than that? I haven't tried it yet. And is that enough for most of the cases or other AI are better?
@Carberra
@Carberra 14 күн бұрын
I like to write all my functions as classes that define the call dunder; just makes it more explicit.
@Indently
@Indently 13 күн бұрын
word
@dionnix
@dionnix 7 күн бұрын
​@@Indentlysentence
@supermalavox
@supermalavox Ай бұрын
When is it a good practice to put a slash after the arguments you want to pass instead of an asterisk?
@vytah
@vytah Ай бұрын
Slash means that the name of arguments after the slash don't matter. I'd use it for anywhere the names do not provide any meaning, like for example with mathematical functions: while the argument is typically named x, a, val, arg etc., this name is completely useless for the caller. exp(x=2) is much worse than simple exp(2)
@supermalavox
@supermalavox Ай бұрын
Thanks, @@vytah.
@rugikex
@rugikex Ай бұрын
Hello, nice video! For the last function "joint_text", how do you type "*strings"? object , strings or maybe something in the typing library?
@dragweb7725
@dragweb7725 Ай бұрын
generally when using this you don't type annotate it, but if you want to, i guess you can just type it as typing.Tuple[str]
@Drk950
@Drk950 24 күн бұрын
*strings: str (answer)
@tarakeshnc7417
@tarakeshnc7417 Ай бұрын
Nice tips. Python is comment oriented language. What I mean is code should look like comments or easily readable. Extra commenting should be less. By looking at code, you should be able to make out what is happening.
@DrDeuteron
@DrDeuteron Ай бұрын
which is why you should never write a function that returns a complicated interface, unless it has a leading underbar in its name, and even then....
@vytah
@vytah Ай бұрын
Python is executable pseudocode. Same with Haskell.
@TigerWalts
@TigerWalts 27 күн бұрын
You can avoid putting what a variable is into a docstring by creating aliases for even the simplest types. You can get away with just assigning types to a variable if you are on a version of Python that doesn't support some of the newer type aliasing methods): from typing import Tuple Vec2 = Tuple[int, int] You can go a bit further and say: Xint = Yint = int Vec2 = Tuple[Xint, Yint] Why do this? Well maybe you are working with a different convention. e.g. when working with output to the terminal you often have rows as the leading axis: Loc = Tuple[Yint, Xint] Now when an argument expects a Loc, you know which way around the values inside need to be. Loc and Vec2 are the same type, but you are signalling to the reader of the code their context. And if you ever change it, there's no docstring(s) to keep up to date and you can easily find all the places in the code that the change needs to be checked (provided you named the alias sensibly).
@AGENT_V-252
@AGENT_V-252 11 күн бұрын
What's the editor you using?
@rondamon4408
@rondamon4408 Ай бұрын
Nice
@SolathPrime
@SolathPrime Ай бұрын
[ 11:04]: Why private cat video? Now me angry! Me want cat!
@exkalybur_dev
@exkalybur_dev 25 күн бұрын
I'm learning English. I'd like to know where are you or where come from your accent. Please. Thanks a lot.
@Mefodii
@Mefodii 29 күн бұрын
Most of the time I get an analysis paralysis because of the docstrings. Here is a example. A function returns dict[int, str] (as in video). Why does it matter to duplicate the same ":return: dict[int, str]"? In my vision it clutters the code. Is there any value to do that duplication? Or, if function name is already self explanatory, why to paraphrase the same words which makes up the function name in the docstring?
@Indently
@Indently 29 күн бұрын
What's important is that you return something meaningful. dict[int, str] might have been a bad example :)
@Mefodii
@Mefodii 28 күн бұрын
@@Indently Sorry for using your example as my example. I understood your point about commenting. What bothers me more that I cant formulate a coherent rule of when documenting a function is redundant. Or, does it bring some kind of help somewhere I'm not aware of?
@archardor3392
@archardor3392 19 күн бұрын
@@Mefodii Documenting a function is never redundant. Think of it that way. You have a very simple function and you think it is obvious what it does, right? Well, from experience, to some people, it really isn't that obvious and they really do need that documentation in a language they are more accustomed to (beginners, usually). It also teaches them how to start documenting their own code as they read simple functions and progress to more difficult ones. Basically, you aren't documenting a function for yourself, but for others, who might not be on your level of coding knowledge. *P.S. Documenting variables is always important, even for you. User_info might be clear enough now, but if you come back to it some time later... @param user_info: Dictionary with personal information, example (example has to be valid): { name: Tony, age: 23, address: USA} is much clearer than no info at all and a debugging session. (For other people as well!) P.S.2. This now means that you have a lot of stuff to update if you change something...so as always, its about tradeoffs. In a team, it is usually very much worth it.
@SolathPrime
@SolathPrime Ай бұрын
12:26 Yay
@Indently
@Indently Ай бұрын
It had to be made public eventually
@Hnxzx_gt
@Hnxzx_gt 14 күн бұрын
Question why do you write users: dict[int, str] = {1: ‘bob’, 2: ‘jeff ’, 3: ‘tom’} when I think you could just write this users = {1: ‘bob’, 2: ‘jeff ’, 3: ‘tom’} I’m new to python btw
@Nova3803
@Nova3803 6 күн бұрын
He's using type hints. Lookup explicit typing for more in depth information. But by specifying the types within this dictionary you can gain af advantages. First. The code becomes easier you read. You explicitly stated what the types of variable will be, instead of letting python infer it at runtime and thus it never being mentioned directly in your code. Second, if you were to screw up later and try to pass a string into the dictionary key, (where an int was specified) a good modern IDE should warn you about it. Potentially saving debug time later. I'm probably missing more stuff but that's what comes to mind.
@theforcedad
@theforcedad 29 күн бұрын
I feel silly asking this, and I'm sure the answer is obvious ... but I've searched high and low and can't find the answer: How did you get your editor to show the usage count next to the function def? Also, how did you get your VSCode layout to look like this (especially the split sidebar)? I see you are using a Mac - perhaps this is the difference? I am on Windows. Grateful for your help! :)
@himmelsdemon
@himmelsdemon 29 күн бұрын
That is not VSCode, it's PyCharm or IntelliJ Idea. I think the usages come default in that editor.
@Indently
@Indently 29 күн бұрын
Inlay hints on PyCharm
@theforcedad
@theforcedad 29 күн бұрын
Thanks. I found your setup video.
@mohamed_rida_b1304
@mohamed_rida_b1304 Ай бұрын
🥇🎉🎉🎉
@hansmaulwurf8337
@hansmaulwurf8337 Ай бұрын
Can someone explain this: >>> def p(*v: str, s: int): ... print(s.join(v)) ... >>> p("a", "5", s='/') a/5 Why isn’t the type int for s enforced?
@nobugsnohugs6040
@nobugsnohugs6040 29 күн бұрын
It's type hints Just hints, they do not provide any contact over the actual variable type
@PritamWaiba-vu1fj
@PritamWaiba-vu1fj Ай бұрын
how to give type annotation for return self object in method? class MyClass: def func1(self) : return self
@archardor3392
@archardor3392 19 күн бұрын
def func1(self) -> MyClass: return self
@exploringMyself998
@exploringMyself998 19 күн бұрын
@@archardor3392 It gives not implemented error
@marlan__
@marlan__ Ай бұрын
You should use abstract method and ABC instead of NotImplementedErrors.
@Indently
@Indently Ай бұрын
Would be nice, but that's only valid if you're using an OOP approach.
@DrDeuteron
@DrDeuteron Ай бұрын
for the last one, I think I prefer the code: >>>join_text = str.join it's more pythonic, since functions are 1st class, and: don't reinvent the wheel.
@Indently
@Indently Ай бұрын
That's absolutely fair, but as usual, my example was just for demonstration purposes.
@pfizerpflanze
@pfizerpflanze 11 күн бұрын
Can you explain the **kwargs thing?
@dionnix
@dionnix 7 күн бұрын
kwargs allows you to pass a variable number of arguments that you haven't explicitly defined in your code yet
@darcash1738
@darcash1738 28 күн бұрын
#1 Ctrl f pass later if this becomes an issue for you
@DrDeuteron
@DrDeuteron Ай бұрын
which code do you find clearer: A: numbers: dict[str: int] = {'one': 1, 'two': 2} B: numbers = dict(one=1, two=2)
@Indently
@Indently Ай бұрын
Well, considering A has an invalid type annotation "dict[str: int]", I'd have to select B in this case (if you're curious about how annotations work I recommend checking out the Mypy docs for correct typing :) ).
@DrDeuteron
@DrDeuteron Ай бұрын
@@Indently thx, but I'm secure af and only use 3.8 on the job. Higher version aren't approved so I can't check the newer features. Haven't had the time to get 3 on the to-be-replaced Mac at home, since my personal lib in 2x is huge.
@Indently
@Indently Ай бұрын
That's completely fair, if I had your certainty I'd probably also skip on annotations completely.
@DrDeuteron
@DrDeuteron Ай бұрын
@@Indently Well I use them in 3.8, just the nested ones aren't implemented. I think they are good if you have functiond that takes a custom class, but that really only happens when two classes are cooperating (dangers of inappropriate intimacy notwithstanding), since classes have method to work with their attributes. So far, I'm 30/70 on whether to use them with primitives.
@Oldclunker-ge5zp
@Oldclunker-ge5zp Ай бұрын
Is there a way of declaring a type like the typedef in C ? E.g. typedef mytype1 dict[str: int]; Then you could refer to mytype1 in all relevant places...
@devamthakar3829
@devamthakar3829 24 күн бұрын
What ide is that
@realdotty5356
@realdotty5356 24 күн бұрын
Pycharm
@casperghst42
@casperghst42 Ай бұрын
"pro tip" comes across as bring the exact opposite.
@GonnaLoveThis
@GonnaLoveThis 15 күн бұрын
what does it mean?
@Nerdimo
@Nerdimo Ай бұрын
If you pass a function and never implement it, did you even need it in the first place?
@dragweb7725
@dragweb7725 Ай бұрын
He didn't mean that you never implement it, just that you can have defined several empty functions, for example to name them in the main function and have a global picture of the code in it, and after you write the code of each function independently to make them reusable. It is then possible to forget implementing one of the functions in the process, it is then useful to have the code tell you that when testing
@Nerdimo
@Nerdimo Ай бұрын
@@dragweb7725 When testing, won’t the expected value not be present because you passed the function and therefore the test would fail causing you to inspect the function causing the failed test?
@juanjosefarina
@juanjosefarina Ай бұрын
@@Nerdimo it's not that easy sometimes, I've seen functions using either "pass" or "..." in an SDK of my company, which in turn uses some third party APIs, and debugging that can get hard since there are many layers and you don't know what kind of error is gonna be raised (if any).
@Nerdimo
@Nerdimo Ай бұрын
@@juanjosefarina Aha, so it's really an issue as a code base grows larger and larger. I can see how that gets annoying. I've only used NotImplementedError for abstract classes, but I can see we're it's useful in general SWE.
@lonely_0fficial
@lonely_0fficial 8 күн бұрын
where was all that hiding from me all the time?
@lhard123l
@lhard123l 14 күн бұрын
not none but NoReturn if no retyrning
Is "finally" Useless In Python?
7:02
Indently
Рет қаралды 45 М.
All 39 Python Keywords Explained
34:08
Indently
Рет қаралды 44 М.
КАРМАНЧИК 2 СЕЗОН 4 СЕРИЯ
24:05
Inter Production
Рет қаралды 524 М.
And what’s your age? 🥰 @karina-kola
00:12
Andrey Grechka
Рет қаралды 6 МЛН
5 Good Python Habits
17:35
Indently
Рет қаралды 266 М.
Debugging 101: Replace print() with icecream ic()
12:36
NeuralNine
Рет қаралды 338 М.
5 Useful Dunder Methods In Python
16:10
Indently
Рет қаралды 41 М.
Python Classes Tutorial #5 | Advanced Concepts
10:08
Aikonic
Рет қаралды 2,3 М.
5 Useful F-String Tricks In Python
10:02
Indently
Рет қаралды 216 М.
Python's 5 Worst Features
19:44
Indently
Рет қаралды 36 М.
Why I Quit Copilot | Prime Reacts
35:56
ThePrimeTime
Рет қаралды 232 М.
This Is Why Python Data Classes Are Awesome
22:19
ArjanCodes
Рет қаралды 782 М.
5 Useful Python Decorators (ft. Carberra)
14:34
Indently
Рет қаралды 75 М.
How Fast can Python Parse 1 Billion Rows of Data?
16:31
Doug Mercer
Рет қаралды 121 М.
КАРМАНЧИК 2 СЕЗОН 4 СЕРИЯ
24:05
Inter Production
Рет қаралды 524 М.