18 ms·

For anyone who's looking for the changelog, it's at the bottom of the page so it's easy to miss. * Made the return values of Collection's set, add, remove, and

For anyone who's looking for the changelog, it's at the bottom of the page so it's easy to miss. * Made the return values of Collection's set, add, remove, and reset more useful. Instead of returning this, they now return the changed (added, removed or updated) model or list of models. * Backbone Views no longer automatically attach options passed to the constructor as this.options, but you can do it yourself if you prefer. * All "invalid" events now pass consistent arguments. First the model in question, then the error object, then options. * You are no longer permitted to change the id of your model during parse. Use idAttribute instead. * On the other hand, parse is now an excellent place to extract and vivify incoming nested JSON into associated submodels. * Many tweaks, optimizations and bugfixes relating to Backbone 1.0, including URL overrides, mutation of options, bulk ordering, trailing slashes, edge-case listener leaks, nested model parsing...

byroot 13y ago
I don't think I'm very picky about versions meanings. But still the first two items are huge breaking changes for a dot release... If I hadn't left my previous job, It would take me a day or two to upgrade. Even Rails 3.2 => 4 is more straightforward.
- look_lookatme 13y ago
  I can't speak to the Backbone.js changes, but isn't one of the odd things about Rails versioning the fact that 3.x -> 4.0 is essentially a dot release upgrade, but 4.0 to 4.1 a full version upgrade (many things are deprecated from 3.x to 4.0, and 4.1 will remove them entirely?)
  - steveklabnik 13y ago
    That was the plan, but now we are planning to make 4.1 an easy upgrade as well, and not remove deprecations that were originally planned on being removed.
    - look_lookatme 13y ago
      Oh that's awesome. Thanks for the info.
- masterj 13y ago
  How? * Made the return values of Collection's set, add, remove, and reset more useful. Instead of returning this, they now return the changed (added, removed or updated) model or list of models. Given that calling `collection.add(foo)` returned `collection`, when were you ever using the return value for anything? Going forward you might, but I would be very surprised if much if any code was broken by this. * Backbone Views no longer automatically attach options passed to the constructor as this.options, but you can do it yourself if you prefer. This might require going through your code base, but it's just adding one line in the `initialize` function: initialize: function(options) { this.options = options; Annoying if you have hundreds of views that directly extend Backbone.View, but not something that should take a day to fix? Am I missing something?
  - tbranyen 13y ago
    You're missing a lot, but you would have had to peruse the commits that have been happening over the past year to know how much has changed. I'm not sure how to proceed with my own LayoutManager plugin. Hoping someone will PR a fix making it compatible, because my initial attempt told me it wasn't going to be trivial.
    - masterj 13y ago
      What are the issues you're seeing with LayoutManager? Are they reflected in the changelog or hidden in commit messages?
    - masterj 13y ago
      Looking into it, it seems like most of your issues stem from the fact that you depended on View._configure being called during initialization. You overwrite it here: https://github.com/tbranyen/backbone.layoutmanager/blob/master/backbone.layoutmanager.js#L855 https://github.com/tbranyen/backbone.layoutmanager/blob/mast... but this was completely removed with the update: https://github.com/jashkenas/backbone/compare/1.0.0...1.1.0#diff-0d56d0d310de7ff18b3cef9c2f8f75dcL983 https://github.com/jashkenas/backbone/compare/1.0.0...1.1.0#... In backbone's defense, that wasn't part of its public API, but it does make updating challenging. I'll give it a try and see if I can be of some help.
- pselbert 13y ago
  That is precisely why our apps are currently "stuck" on 0.9.10. The upgrade process for backbone is rather painful, as you end up hunting for "undefined" issues all over the place. Any change that renders my entire application broken should be a major version bump.
roryokane 13y ago
Direct link to the changelog you quote: http://backbonejs.org/#changelog http://backbonejs.org/#changelog
jashkenas 13y ago
Here's a direct link to the actual net changes: https://github.com/jashkenas/backbone/compare/1.0.0...1.1.0#diff-5 https://github.com/jashkenas/backbone/compare/1.0.0...1.1.0#...
danabramov 13y ago
Where can I read more about changes related to nested model parsing and submodels? This is something I had to implement just a week ago, and I resorted to overriding `set`. I wonder if they made it easier, or if there is a builtin support for nested models of some kind.
- jashkenas 13y ago
  Happy to oblige. There's no built-in convention for it, but you can do something like this: parse: function(attrs) { this.friends = new PeopleCollection(attrs.friends); delete attrs.friends; return attrs; } ... assuming that friends is an array of JSON objects suitable to be transformed into Person models.
  - danabramov 13y ago
    Jeremy, thanks! I tried overriding Model's `parse` in 1.0 but wasn't satisfied because it seems to be called in some cases but not the others. (I can't recall a specific example right now; maybe it was parsing the collection from server, or creating a collection using constructor). Do you think there are drawbacks to overriding `set`? It seems to work well for me but I'd love to hear your opinion: https://gist.github.com/gaearon/6689379 https://gist.github.com/gaearon/6689379
- philfreo 13y ago
  If you want something lightweight I'd go with the approach @jashkenas mentioned. But also might want to checkout: https://github.com/PaulUithol/Backbone-relational https://github.com/PaulUithol/Backbone-relational

byroot 13y ago

I don't think I'm very picky about versions meanings. But still the first two items are huge breaking changes for a dot release... If I hadn't left my previous job, It would take me a day or two to upgrade. Even Rails 3.2 => 4 is more straightforward.

look_lookatme 13y ago
I can't speak to the Backbone.js changes, but isn't one of the odd things about Rails versioning the fact that 3.x -> 4.0 is essentially a dot release upgrade, but 4.0 to 4.1 a full version upgrade (many things are deprecated from 3.x to 4.0, and 4.1 will remove them entirely?)
- steveklabnik 13y ago
  That was the plan, but now we are planning to make 4.1 an easy upgrade as well, and not remove deprecations that were originally planned on being removed.
  - look_lookatme 13y ago
    Oh that's awesome. Thanks for the info.
masterj 13y ago
How? * Made the return values of Collection's set, add, remove, and reset more useful. Instead of returning this, they now return the changed (added, removed or updated) model or list of models. Given that calling `collection.add(foo)` returned `collection`, when were you ever using the return value for anything? Going forward you might, but I would be very surprised if much if any code was broken by this. * Backbone Views no longer automatically attach options passed to the constructor as this.options, but you can do it yourself if you prefer. This might require going through your code base, but it's just adding one line in the `initialize` function: initialize: function(options) { this.options = options; Annoying if you have hundreds of views that directly extend Backbone.View, but not something that should take a day to fix? Am I missing something?
- tbranyen 13y ago
  You're missing a lot, but you would have had to peruse the commits that have been happening over the past year to know how much has changed. I'm not sure how to proceed with my own LayoutManager plugin. Hoping someone will PR a fix making it compatible, because my initial attempt told me it wasn't going to be trivial.
  - masterj 13y ago
    What are the issues you're seeing with LayoutManager? Are they reflected in the changelog or hidden in commit messages?
  - masterj 13y ago
    Looking into it, it seems like most of your issues stem from the fact that you depended on View._configure being called during initialization. You overwrite it here: https://github.com/tbranyen/backbone.layoutmanager/blob/master/backbone.layoutmanager.js#L855 https://github.com/tbranyen/backbone.layoutmanager/blob/mast... but this was completely removed with the update: https://github.com/jashkenas/backbone/compare/1.0.0...1.1.0#diff-0d56d0d310de7ff18b3cef9c2f8f75dcL983 https://github.com/jashkenas/backbone/compare/1.0.0...1.1.0#... In backbone's defense, that wasn't part of its public API, but it does make updating challenging. I'll give it a try and see if I can be of some help.
pselbert 13y ago
That is precisely why our apps are currently "stuck" on 0.9.10. The upgrade process for backbone is rather painful, as you end up hunting for "undefined" issues all over the place. Any change that renders my entire application broken should be a major version bump.

roryokane 13y ago

Direct link to the changelog you quote: http://backbonejs.org/#changelog http://backbonejs.org/#changelog

jashkenas 13y ago

Here's a direct link to the actual net changes: https://github.com/jashkenas/backbone/compare/1.0.0...1.1.0#diff-5 https://github.com/jashkenas/backbone/compare/1.0.0...1.1.0#...

danabramov 13y ago

Where can I read more about changes related to nested model parsing and submodels? This is something I had to implement just a week ago, and I resorted to overriding `set`. I wonder if they made it easier, or if there is a builtin support for nested models of some kind.

jashkenas 13y ago
Happy to oblige. There's no built-in convention for it, but you can do something like this: parse: function(attrs) { this.friends = new PeopleCollection(attrs.friends); delete attrs.friends; return attrs; } ... assuming that friends is an array of JSON objects suitable to be transformed into Person models.
- danabramov 13y ago
  Jeremy, thanks! I tried overriding Model's `parse` in 1.0 but wasn't satisfied because it seems to be called in some cases but not the others. (I can't recall a specific example right now; maybe it was parsing the collection from server, or creating a collection using constructor). Do you think there are drawbacks to overriding `set`? It seems to work well for me but I'd love to hear your opinion: https://gist.github.com/gaearon/6689379 https://gist.github.com/gaearon/6689379
philfreo 13y ago
If you want something lightweight I'd go with the approach @jashkenas mentioned. But also might want to checkout: https://github.com/PaulUithol/Backbone-relational https://github.com/PaulUithol/Backbone-relational