• sbv@sh.itjust.works
    link
    fedilink
    English
    arrow-up
    67
    arrow-down
    1
    ·
    3 months ago

    I love shitting on Python, but I feel like all those problems are present in libraries for other languages as well. There’s a tonne of that crap for JS/TS.

    Similarly, I find a fair number of Rust crates (that I want to use) have virtually no doc or inline examples, and use weird metaprogramming that I can’t wrap my head around.

    • The Bard in Green@lemmy.starlightkel.xyz
      link
      fedilink
      English
      arrow-up
      56
      ·
      3 months ago

      Are we living in a world in which the JS/TS ecosystem is the yardstick by which we measure well written code? I mean… Wait a minute! I figured it out! This is the Bad Place!

    • Ephera@lemmy.ml
      link
      fedilink
      arrow-up
      24
      arrow-down
      1
      ·
      3 months ago

      I mean, if we’re talking about all those problems, the no-type-annotations issue is rather specific for Python, JS/TS and Ruby.

      But in general, I feel like there’s somewhat of an old world vs. new world divide, which happened when package registries started accepting libraries from everyone and their cat.

      In C, for example, most libraries you’ll use will be quite well-documented, but you’ll also never hear of the library that Greg’s cat started writing for the niche thing that you’re trying to do.

      Unfortunately, Greg’s cat got distracted by a ball of yarn rolling by and then that was more fun than writing documentation.
      That’s the tradeoff, you get access to more libraries, but you just can’t expect all of them to be extremely high-quality…

    • Pacmanlives@lemmy.world
      link
      fedilink
      arrow-up
      10
      ·
      3 months ago

      You should look at some old Perl or C code. I have even seen some shell code that makes me want to bash my head in till death with an IBM Model M Keyboard

    • leisesprecher@feddit.org
      link
      fedilink
      arrow-up
      4
      ·
      3 months ago

      I feel like there’s a very fine balance for the effort required to publish a package.

      Too easy and you get npm.

      Too hard and you get an empty repo.

      I feel like Java is actually doing a relatively good job here. Most packages are at least documented a bit, though obviously many are outdated.

      • expr@programming.dev
        link
        fedilink
        arrow-up
        3
        arrow-down
        1
        ·
        3 months ago

        Uh, there are an absolute fuckload of Java libs out there with nothing more than auto-generated garbage Javadocs.

    • Preston Maness ☭@lemmygrad.ml
      link
      fedilink
      English
      arrow-up
      4
      ·
      3 months ago

      Similarly, I find a fair number of Rust crates (that I want to use) have virtually no doc or inline examples, and use weird metaprogramming that I can’t wrap my head around.

      Is it really a true rust crate if it doesn’t contain at least one inscrutable macro?

  • sus@programming.devOP
    link
    fedilink
    arrow-up
    41
    ·
    3 months ago

    bonus points if you’re using a statically typed language but the library uses extensive metaprogramming seemingly for the sole purpose of hiding what types you actually need

  • JackbyDev@programming.dev
    link
    fedilink
    English
    arrow-up
    12
    ·
    3 months ago

    This is probably my biggest complaint about trying to learn Python past the beginner level and into intermediate and beyond. This is also one of my strongest arguments in favor of static type systems over dynamic ones.

  • dudinax@programming.dev
    link
    fedilink
    arrow-up
    12
    arrow-down
    1
    ·
    3 months ago

    Rust crates have the second and third problems.

    Rust at least has type annotation.

    The type has private fields. There’s no constructor. There’s no implementation of the From trait except on itself. You can’t find a function anywhere that returns the type.

  • Evil_Shrubbery@lemm.ee
    link
    fedilink
    arrow-up
    9
    ·
    edit-2
    3 months ago

    Using cryptic parameter names is just nonsense when you can obviously use lewd cryptic parameter names instead.

  • AVincentInSpace@pawb.social
    link
    fedilink
    English
    arrow-up
    8
    arrow-down
    2
    ·
    3 months ago

    you should learn Rust. the type system is so comprehensive that half the time you can guess what a function does (or at the very least what you’re supposed to pass to it) without a single line of human written documentation.

  • mvirts@lemmy.world
    link
    fedilink
    arrow-up
    5
    ·
    3 months ago

    And now we have free threads so I can’t say at least you don’t have normal concurrency problems 🤣

  • kaffiene@lemmy.world
    link
    fedilink
    English
    arrow-up
    3
    ·
    3 months ago

    I really like Python. The only thing I don’t want to do with Python is support a large code base. Lack of strict typing makes refactoring awful

  • Reptorian@programming.dev
    link
    fedilink
    arrow-up
    1
    ·
    edit-2
    3 months ago

    I’m just glad I have other options than just Python. Am not afraid of writing my solutions either. I rarely use Python these day.