Python allows programmers to pass additional arguments to functions via comments. Now armed with this knowledge head out and spread it to all code bases.

Feel free to use the code I wrote in your projects.

Link to the source code: https://github.com/raldone01/python_lessons_py/blob/main/lesson_0_comments.ipynb

Image transcription:

from lib import add

# Go ahead and change the comments.
# See how python uses them as arguments.

result = add()  # 1 2
print(result)
result = add()  # 3 4
print(result)
result = add()  # 3 4 5 20
print(result)

Output:

3
7
32
  • drathvedro@lemm.ee
    link
    fedilink
    arrow-up
    11
    ·
    22 hours ago

    I hate this shit being routinely used in PHP. Symfony uses those functional comments for routing, essentially scanning every controller file as text on every visit, to gather the url patterns above functions. Laravel uses Reflection, which is functionally the same thing, to provide arguments to controller functions. Also, kind of related, the project I’m working now has few functions that use backtrace to return different results based on where they are called from. It is indeed very cursed and I’m ripping out any usages of them whenever I see one.

    • piccolo@sh.itjust.works
      link
      fedilink
      arrow-up
      2
      ·
      15 hours ago

      Comment Annotations were a nessecary thing as php did not support a native way to do it. However, since php 8, there is now native attributes.