Recover Data from Production Backups with ActiveRecord

Sometimes things go awry with production data and you need to recover. Here’s one way to do it.

Bundling JavaScript With Your Gem? Make It Contributor-Friendly!

April 2, 2012

Many Rails gems these days bundle third-party assets, JavaScript assets in particular.

Oftentimes gem authors simply dump .js files into their repository, sometimes even concatenated build products. It’s a simple solution, and with tools like Vendorer it doesn’t have to turn into a maintenance headache.

But this makes it hard for users of your gem to contribute to your asset upstream (that is, to the third-party code that you include). Imagine I am a user of your gem: If I want to fix a bug in your gem code, it’s easy: I can clone your repository, point the gem in my Gemfile at my checkout or fork (with :path or :git), hack away at your code, and send you pull requests, while all my changes are instantly live in my app. But I cannot do the same to fix a bug in the third-party code you are shipping, since the version you ship is almost never up-to-date with the upstream master. And if I cloned the upstream, I would have trouble getting my fix back into your gem so I can use it in my app immediately. By losing that instant gratification, I’m much less likely to contribute to the upstream.

Luckily, this is easy to fix: Include the upstream using a Git submodule. Then add a Rake task that copies or builds the files into vendor/assets.

Now it’s easy to contribute: I simply clone your repository and set :path as before, and then check out the master branch on the submodule. I can hack away and send pull requests to the upstream straight from the submodule, while at the same time my changes to the upstream will be live in my app through your gem.

I call this quality contributor-friendliness. It’s not so much a service to your users – most won’t even care – as it is to the upstream project. By making it easy to contribute through your gem, you have expanded the upstream’s base of potential contributors with your users.

I think making open source work better is worth the overhead of using submodules, even if dumping vendor files might be easier sometimes. Our upstream maintainers provide all this awesome code. Let’s be nice to them and make our gems contributor-friendly.

Update June 2012:

This has been used in practice in Konacha and jquery-ui-rails. It seems to be working well so far.

To see a working Rake task, check the :assets task in Konacha’s Rakefile.

One insight we’ve had is to always check in the generated asset files. This is necessary so your library can be used in Bundler like so:

1	`gem 'foo', :git => '...'`

Bundler obviously won’t run your build step, so everything needs to be checked in.

[…]

The CODE Keyboard

August 27, 2013

What would you do, if you could do anything?

I don't mean in a fantasy superhero way, but in terms of resources. If someone told you that you now had the resources to attempt to make one thing happen in the world, one real thing, what would that be?

If you're Elon Musk, the patron saint of Hacker News, then you create an electric car and rocket ships. And then propose a hyperloop. Not bad. Not bad at all.

My dream is more modest. I decided to create a keyboard.

I've talked about keyboards here for years, but The CODE Keyboard is the only simple, clean, beautiful backlit mechanical keyboard I've ever found. Because we built it that way.

The name is of course a homage to one of my favorite books.

That's what I've always loved about programming, the thrill of discovering that communicating with other human beings in their code is the true secret to success in writing code for computers. It's all just … code.

CODE
/kōd/
A system of words, letters, figures, or other symbols used to represent others

The projects I've worked on for the last eight years are first and foremost systems for efficiently communicating with other human beings, not computers. Both Stack Exchange and Discourse are deeply concerned with people and words and the code they use to talk to each other. The only way those words arrive on your screen is because someone, somewhere typed them. Now, I've grown to begrudgingly accept the fact that touchscreen keyboards are here to stay, largely because the average person just doesn't need to produce much written communication in a given day. So the on-screen keyboard, along with a generous dollop of autocomplete and autofix, suffices.

But I'm not an average person. You aren't an average person. We aren't average people. We know how to use the most powerful tool on the web – words. Strip away the images and gradients and vectors from even the fanciest web page, and you'll find that the web is mostly words. If you believe, as I do, in the power of words, then keyboards have to be one of the most amazing tools mankind has ever created. Nothing lets you get your thoughts out of your brain and into words faster and more efficiently than a well made keyboard. It's the most subversive thing we've invented since the pen and the printing press, and probably will remain so until we perfect direct brain interfaces.

I was indoctrinated into the keyboard cult when I bought my first computer. But I didn't appreciate it. Few do. The world is awash in terrible, crappy, no name how-cheap-can-we-make-it keyboards. There are a few dozen better mechanical keyboard options out there. I've owned and used at least six different expensive mechanical keyboards, but I wasn't satisfied with any of them, either: they didn't have backlighting, were ugly, had terrible design, or were missing basic functions like media keys.

That's why I originally contacted Weyman Kwong of WASD Keyboards way back in early 2012.* I told him that the state of keyboards was unacceptable to me as a geek, and I proposed a partnership wherein I was willing to work with him to do whatever it takes to produce a truly great mechanical keyboard. Weyman is a hard core keyboard nut who absolutely knows his stuff – I mean, he runs a whole company that sells custom high end mechanical keyboards – but I don't think he had ever met anyone like me before, a guy who was willing to do a no strings attached deal just for the love of an idealized keyboard. At one point over a lunch meeting, he paused, thought a bit, and said:

So … you're like … some kind of geek humanitarian?

I don't know about that.

But I'm not here to sell you a keyboard. Buy, don't buy. It doesn't matter. I'm just happy to live in a world where the first truly great mechanical keyboard finally exists now, in exactly the form it needed to, with every detail just so, and I can type this very post on it. As glorious as that may be, I'm here to sell you on something much more dangerous: the power of words. So whether you decide to use the CODE Keyboard, or any keyboard at all, I'm glad you're thinking about writing words with us.

* Yep, we software guys are spoiled – hardware takes forever.

[advertisement] How are you showing off your awesome? Create a Stack Overflow Careers profile and show off all of your hard work from Stack Overflow, Github, and virtually every other coding site. Who knows, you might even get recruited for a great new position!

[…]

The Ruby Rails Aggregator