scribu

Posts 2 Posts: Version 1.6

2013-05-10T00:00:00+03:00

There were some improvements commited to the development version of the plugin for a while and I thought I’d do a quick release, to get them in the hands of users.

With version 1.6, P2P development will effectively be entering hibernation mode. I won’t be working on any new features or bug fixes, since the plugin already works well enough on the single site where I use it. Also, I won’t be answering support questions anymore; sorry.

Of course, I’d be happy to review and merge pull requests that people open and still hope that I’ll eventually be able to hand it off to someone else.

Ruby equivalents to PHP’s foreach

2013-05-07T00:00:00+03:00

In PHP, array keys can be either numbers or strings, whereas in Ruby associative arrays are a separate data type, called a hash.

Here’s a cheatsheet for various foreach variants, translated into idiomatic Ruby:

Looping over a numeric array (PHP)

$items = array( 'orange', 'pear', 'banana' );

# without indexes
foreach ( $items as $item ) {
    echo $item;
}

# with indexes
foreach ( $items as $i => $item ) {
    echo $i, $item;
}

Looping over an array (Ruby)

items = ['orange', 'pear', 'banana']

# without indexes
items.each do |item|
    puts item
end

# with indexes
items.each_with_index do |item, i|
    puts i, item
end

Looping over an associative array (PHP)

$continents = array(
    'africa' => 'Africa',
    'europe' => 'Europe',
    'north-america' => 'North America'
);

# without keys
foreach ( $continents as $continent ) {
    echo $continent;
}

# with keys
foreach ( $continents as $slug => $title ) {
    echo $slug, $title;
}

Looping over a hash (Ruby)

continents = {
    'africa' => 'Africa',
    'europe' => 'Europe',
    'north-america' => 'North America'
}

# without keys
continents.each do |_, continent|
    puts continent
end

# with keys
continents.each do |slug, title|
    puts slug, title
end

Important note: Unlike in PHP associative arrays, elements inside a Ruby hash are not ordered.

If you’re having a sense of déjà vu, it’s probably because I wrote a similar post a while ago, but for Python.

On Being An Open-Source Pragmatist

2013-04-13T00:00:00+03:00

To pragmatists the GPL is important as a tool, rather than as an end in itself. Its main value is not as a weapon against `hoarding’, but as a tool for encouraging software sharing and the growth of bazaar-mode development communities. The pragmatist values having good tools and toys more than he dislikes commercialism, and may use high-quality commercial software without ideological discomfort. At the same time, his open-source experience has taught him standards of technical quality that very little closed software can meet.

On Plugin Support

2013-04-10T00:00:00+03:00

When I started developing WordPress plugins, most people asking questions in the support forums seemed like hobbyists building sites for themselves. Since then, I’ve noticed two trends that irk me.

Freelancers

Nowadays, there seem to be a lot more people that get paid to build WordPress sites for others. There’s nothing wrong with that, until you ask me to do your work for free.

I’m not talking about the “Hey, this feature doesn’t work.” type of requests; I’m talking about people dumping some code and asking how to make it do a very specific thing that their client requested.

If you are getting paid to do something, you should either already know how to do it, or spend the time needed to learn how to do it, instead of relying on the kindness of ~~suckers~~ strangers.

Commercial software

Commercial themes are booming and paid plugins are also becoming common. Again, there’s nothing wrong with that, but don’t expect much sympathy from me when the premium theme you’re using conflicts with my plugin. I know my code is solid, so why should I spend my free time debugging someone else’s product that they charge money to support?

Post in their support forums; if it turns out there’s an issue with my plugin, they should be competent enough to fix it and send a patch, or at least explain it to you. ¹

Whenever money enters the picture, the gift economy goes out the window; you can’t have it both ways.

This would be the part where I suggest you hire me, but I’m currently not taking on WordPress consultancy work. Sorry.↩

Yay Data Portability

2013-04-01T00:00:00+03:00

In the following post, I will attempt to chronicle how I came to believe that having your content in a portable format is more valuable than having an open source project to manipulate that content.

I accidentally jump-started my programming career by working on an open-source project (WordPress) and I use many other open-source applications and libraries every day, so I certainly see the value in that, as a developer.

As a user, I care more about my data. For example, if LibreOffice goes bust, I’m not going to start working on my own document editor, but I would definitely like to be able to open my documents with some other tool.

Two weeks ago, after a kernel upgrade, Ubuntu started crashing on my Macbook Air. After a few days of trouble, I decided that this would be a good opportunity to give OS X an honest try. I was using Tomboy before, on Ubuntu, to take notes. I had them backed up via Ubuntu One, so it was easy enough to compile Tomboy under OS X and copy over the data.

Even if Tomboy or Ubuntu One didn’t work on OS X for whatever reason, I could still access my notes, since they were stored as simple XML files.

By contrast, Mountain Lion’s Notes.app uses a weird binary format and to get your notes out of it, you have to go through Gmail and Mail.app.

In general, I think Apple is the worst offender when it comes to data portability. It’s aggressively trying to hide the filesystem from the user; in the name of simplicity and ubiquity, it shoves everything into iCloud, which I’m pretty sure won’t see major adoption from anything other than OS X or iOS apps, if that.

Google, with its Data Liberation Front, is on the opposite side of the spectrum. Immediately after the announcement that Google Reader would be discontinued, I was able to export my subscriptions and import them into a Tiny Tiny RSS instance on my own server.

After a while, attracted by the shiny interface, I switched to Feedly, an ad-supported hosted service. While writing this post, I discovered that Feedly itself doesn’t have an option to export my list of feeds. If it doesn’t add one soon, I will just have to find some other service that will, before Google Reader shuts down and my feed list becomes a hostage in Feedly’s walled garden.

Going forward, whenever I start using a new application or service, I will make sure there’s a sane exit strategy. I should be able to leave and take my data with me at any time, with no questions asked.

The Last Psychiastrist On College

2013-03-26T00:00:00+02:00

“I’m not a vicious capitalist, I don’t always have to get paid for what I do. I like to participate in the public debate.” I. I. I. Stop it, look around! This isn’t charity, the Times is a billion dollar corporation and Princeton is in actuality a gigantic hedge fund – why are you giving them your work for free? “That’s the system, I can’t change it.” Exactly.

Plugin Help Wanted

2013-03-23T00:00:00+02:00

I have released or adopted a bunch of plugins over the years. Some of them are obsolete, while some are still quite popular.

I’ve made a spreadsheet with the list of plugins, which I’ll update as new maintainers are found.

For each plugin in that spreadsheet:

if you’re willing and able to answer support questions about it on a consistent basis, let me know; I’ll add you to the team.
if you’re a developer and would be interested in maintaining it, let me know and read on.

Each plugin has its own Github repository, which is then deployed to wordpress.org via a script. I can continue taking care of deployments, if you don’t want to or we’ll figure something out.

The more complex plugins use scbFramework, which is pretty stable.

To signal your interest, either leave a comment here or send an email to mail@scribu.net, mentioning your wordpress.org username (and github account, if you have one).

Taking A Stab At Go

2013-03-19T00:00:00+02:00

I’ve had this idea for a fun weekend project for a while: generate the WP-CLI manual concurrently, instead of one page at a time.

All I needed was the right programming language ¹. Since I’ve heard good things about Go, I decided to give it a try. I took the Go Tour and then just started hacking.

A WP-CLI manual page is generated by:

collecting data from inline PHP docComents
reading a markdown file with additional documentation
running everything through ronn to generate the final ROFF output

At first, I tried to do all these steps in Go, but soon discovered that it would duplicate too much code. Eventually, I settled on just letting WP-CLI generate each page, using the existing logic.

So, I ended up with less than 100 lines of Go code:

I’ve tried on several occasions to use threads in various programming languages, but never felt I really mastered them. By contrast, I was able to grok goroutines and channels in a weekend; they just made sense.

In general, the Go documentation is the best I’ve seen so far. For instance, when you look up a function from the standard library, besides a helpful example, there’s also a link to its source code.

I also like go fmt, which takes care of formatting your code; no more worrying about spaces vs. tabs etc.

Even if it yielded a modest 23% speedup (from 17 seconds down to 13 seconds to compile all the pages), it was a worthwhile experiment.

PHP doesn’t have any support for concurrency.↩

Getting The Tiny Tiny RSS Daemon Working

2013-03-14T00:00:00+02:00

As you probably know, Google Reader will be shutting down, come July, 2013. Instead of looking for a different hosted service to migrate to, I thought it would be better to use a self-hosted solution. I picked a PHP application called Tiny Tiny RSS.

After I set up a new subdomain and an nginx config file, the installation instructions were pretty easy to follow, except the part about setting up the script responsible for updating the feeds.

Starting The Daemon

Since I’m hosting this on a VPS, I have the possibility of running the updater as a daemon (a process that runs continually in the background). After a bit of googling and some trial and error, I came up with the following command to start it up:

sudo -u www-data nohup php ./update.php -daemon > /dev/null &

The sudo -u www-data part makes it so that the process is owned by the www-data user, instead of my user or root.

By using nohup, the process will continue to run even after I end the SSH session.

Stopping The Daemon

If I ever want to terminate the daemon, I just need to find it’s process ID and send it the kill signal:

pgrep './update.php' | xargs kill -9

Also, it seems I need to delete the ./lock/update_daemon.lock file, to avoid getting a nag in the UI.

Being A Couch Potato Or Exercising Your Emotional Muscles?

2013-03-10T00:00:00+02:00

A while ago I read “Amusing Ourselves To Death”, by Neil Postman, who’s main premise is that television is responsible for the dumbing down of public discourse and for the decline of culture in general.

Then I read “Everything Bad Is Good For You”, by Steven Johnson, who shows that people are objectively smarter today, on average, than they were in previous decades. He makes a convincing argument that the main cause is TV shows, video games and other forms of entertainment becoming more mentally engaging over time. He then explains what economic incentives drive this phenomenon.

Another interesting insight was that the Internet has become the main medium through which people acquire factual information, allowing television to focus on what it does best, i.e. storytelling and conveying people’s characters.

If you’re at all interested in the current media landscape, I highly recommend both books.