2025-02-03 - Breaking Changes in Lemmy 1.0
join-lemmy.org
  • db0English
    44•1 day ago

    Oof, lots of work to do for everyone.

    If anyone can figure out all the non-mentioned API changes and write them here it would be useful for people like me to avoid having to reverse engineer things

  • BinetteEnglish
    32•1 day ago

    I can say I was there when Lemmy 1.0 released!

  • davel [he/him]English
    12•21 hours ago

    A lot of these should not be called breaking changes. A new API is not a breaking change if the old API remains.

    • DessalinesMEnglish
      43•23 hours ago

      Lots of things, but mainly that lemmy is pretty stable, and its been a year since the last breaking changes release.

      I was also kind of opposed to a v1.0, and wanted lemmy to be considered alpha/beta level software, because I know when we release a v.1.0, people are going to expect the same enterprise-level and bug-free software from a ~4 person dev team as they do from a multi-million dollar company. Also it gives us less freedom to make breaking changes, which can be restrictive for back-end devs.

      But now we can just adopt proper semver, and the next breaking changes releases can upgrade the MAJOR version.

      • @nutomic@lemmy.mlOPMEnglish
        7•19 hours ago

        On the other hand it gives an indication to client developers that such big breaking changes wont be a regular occurence. So they have a reason to upgrade and then keep using 1.0 long-term. I believe that practically all the needed breaking changes are already implemented, and remaining issues are mostly new feature requests which can be added as new api endpoints or parameters.

  • BinetteEnglish
    11•24 hours ago

    Will the new lemmy ui be ready for 1.0?

    • DessalinesMEnglish
      17•23 hours ago

      Can’t give an ETA yet. I’ve got a few more back-end things to finish up, then @sleeplessone1917 and I will work on lemmy-ui.

      Then I also gotta work on getting jerboa updated also. So much work and so few developers.

  • db0English
    8•1 day ago

    Does this mean you renamed just the DB columns, but not the API keys?

      • db0English
        4•23 hours ago

        Ah, good to know before I start developing. Can you let me know when we can start the development as I don’t want to use the API and then discover it’s missing more PRs?

        • DessalinesMEnglish
          1•23 hours ago

          I can’t say yet, as we’re still adding things. If you’re not using lemmy-js-client, then as long as your types are generated from it’s main branch directly, then you should be fine.

          • db0English
            3•23 hours ago

            I’m not using the js-client. I’m updating pythorhead so I need to make sure the API is at the final version before I can match it. And to match it I need the patches to be in so I can read the doc, and/or import the swagger.

            I will do what I can in advance, but to do the pre-development you asked for, we do need the final version up somewhere.

            • @nutomic@lemmy.mlOPMEnglish
              3•19 hours ago

              The final api version would probably be in 1.0-beta.0, which will still take a few months. But at this time you can already start to adapt for the major changes like combined endpoints, and give feedback if anything else in the api needs changing.

            • DessalinesMEnglish
              0•22 hours ago

              The updated spec should be at https://join-lemmy.org/api/main , and it gives you an option to download the .json file

              Or you can use the lemmy-js-client main branch, and run pnpm tsoa to generate a swagger.json file.

      • @aeharding@vger.socialEnglish
        7•20 hours ago

        Awesome works!

        Only thing I’ve noticed so far is the old v3 profile API response doesn’t have posts/comments attached

        • DessalinesMEnglish
          5•20 hours ago

          Yep I think we note that in the breaking changes post. We only serve the combined responses now.

  • AdemirEnglish
    5•24 hours ago

    wow! Huge, just when I am back to the saddle