ppl 4.0.2 → 4.0.3

data/gh-pages/_posts/2012-12-21-1.3.0.md

@@ -0,0 +1,20 @@
+---
+title: 1.3.0
+summary: XDG-compatible configuration
+date: 2012-12-21
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.3.0.html
+---
+
+Adds support for XDG-compatible configuration. Many thanks to
+[@tijn](https://github.com/hnrysmth/ppl/issues/4) on GitHub for [recommending this
+functionality](https://github.com/hnrysmth/ppl/issues/4).
+
+This means ppl can now be alternatively configured using a file at
+`~/.config/ppl/config`. If you like keeping your `~/` free of dotfile clutter
+then this is good news. If not, don't worry, `~/.pplconfig` continues working as
+normal.
+
+* Add support for XDG-compatible configuration file location

data/gh-pages/_posts/2012-12-21-thank-you-for-your-all-your-feedback.md

@@ -0,0 +1,26 @@
+---
+title: Thanks For All Your Feedback
+date: 2012-12-21
+layout: news
+section: news
+categories: [news]
+---
+
+Yesterday I worked up the courage to submit this project to Hacker News under
+the usual [Show HN](http://news.ycombinator.com/item?id=4947047) format. I was
+pleasantly surprised by how positive the feedback was overall. It was especially
+heartening to confirm that I'm not the only person out there who would be
+interested in using a command line address book!
+
+As a result of all the attention that came flooding in, questions were asked and
+answered, bugs were reported and fixed, and features were suggested and
+implemented. It was a really fun day.
+
+The elephant in the room is obviously sync functionality at this point.  Lots
+and lots of people have made it very clear that even though they think this
+project is a great idea it is useless in the extreme to them unless it can sync
+with their GMail or iCloud. Rest assured that [this has not gone
+unnoticed](https://github.com/hnrysmth/ppl/issues/5).
+
+Stay tuned!
+

data/gh-pages/_posts/2012-12-22-1.4.1.md

@@ -0,0 +1,21 @@
+---
+title: 1.4.1
+summary: Multiple email addresses per contact
+date: 2012-12-22
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.4.1.html
+---
+
+This version is a first step towards removing the annoying limitation of one
+email address, postal address and so on per contact. This isn't glamorous work
+but it's vital functionality.
+
+The ability to add more than one email address to a contact has been added. This
+is not 100% complete: email addresses cannot yet be deleted, for example. And
+[ppl show](/documentation/commands/show) does not yet show all the addresses
+(only [ppl email](/documentation/commands/email) does for now). But at least
+it's now possible to store the data
+
+* Contacts can now have more than one email address

data/gh-pages/_posts/2012-12-22-1.5.0.md

@@ -0,0 +1,17 @@
+---
+title: 1.5.0
+summary: ppl shell
+date: 2012-12-22
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.5.0.html
+---
+
+The addition of "interactive mode" in the form of [ppl
+shell](/documentation/commands/shell). Thanks to
+[@axelGschaider](https://github.com/axelGschaider) on GitHub for [the
+suggestion](https://github.com/hnrysmth/ppl/issues/7). This ought to make life a lot
+easier for people entering lots of commands at once!
+
+* Added `ppl shell` command

data/gh-pages/_posts/2012-12-23-1.5.1.md

@@ -0,0 +1,13 @@
+---
+title: 1.5.1
+summary: ppl post bugfix
+date: 2012-12-23
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.5.1.html
+---
+
+This is a very small release to fix one very small bug.
+
+* Fix fatal error in `ppl post <contact>` when contact has no address

data/gh-pages/_posts/2012-12-23-1.5.2.md

@@ -0,0 +1,15 @@
+---
+title: 1.5.2
+summary: ppl shell usability tweaks
+date: 2012-12-23
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.5.2.html
+---
+
+Another very small, very minor release addressing a usability issue with [ppl
+shell](/documentation/commands/shell).
+
+* Add "welcome" message to `ppl shell` explaining how to quit
+* Don't show "ppl>" prompt in `ppl shell` if stdin isn't a tty

data/gh-pages/_posts/2012-12-26-1.5.3.md

@@ -0,0 +1,19 @@
+---
+title: 1.5.3
+summary: Better 'no such contact' error message
+date: 2012-12-26
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.5.3.html
+---
+
+There have been a lot of internal changes in this release, and one user-facing
+change to improve the error message when a non-existent contact is specified in
+a command.
+
+Before this change, non-existent contacts resulted in a fairly cryptic error
+message consisting only of the given non-existent contact ID. From now on the
+problem is actually explained to the user.
+
+* Added a proper error message when a non-existent contact is specified

data/gh-pages/_posts/2012-12-27-1.6.0.md

@@ -0,0 +1,18 @@
+---
+title: 1.6.0
+summary: ppl email --delete and bugfix
+date: 2012-12-27
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.6.0.html
+---
+
+This release contains a bugfix and the means for users to undo the minor damage
+caused by the bug. The bug was causing every new email address added by users to
+be saved against the contact *twice*. The fix stops that from happening. And a
+new feature has been added in the form of a `--delete` flag for [ppl
+email](/documentation/commands/email) so that dupliate addresses can be removed.
+
+* Fixed a bug causing duplicate email addresses to be saved
+* Added `--delete` flag to `ppl email`

data/gh-pages/_posts/2012-12-29-1.7.0.md

@@ -0,0 +1,18 @@
+---
+title: 1.7.0
+summary: ppl show output overhaul
+date: 2012-12-29
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.7.0.html
+---
+
+This version contains some fairly substantial changes to the way the [ppl
+show](/documentation/commands/show) command formats its output. The need for
+this change was unearthed by a [question from
+@storge](https://github.com/hnrysmth/ppl/issues/14) on GitHub. In short, the command
+was only showing one of the given contact's email addresses, giving the
+impression that this was all that ppl supported storing.
+
+* Improved the output format of `ppl show`

data/gh-pages/_posts/2013-01-05-1.8.0.md

@@ -0,0 +1,18 @@
+---
+title: 1.8.0
+summary: ppl url
+date: 2013-01-05
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.8.0.html
+---
+
+Added another attribute that contacts often have: URLs. For example, a given
+contact may have a profile page on some social network, a personal website, or
+any number of different possibilities. The new comand, [ppl
+url](/documentation/commands/url), works similarly to [ppl
+email](/documentation/commands/email) and allows you to store these URLs in your
+address book.
+
+* Added `ppl url` command

data/gh-pages/_posts/2013-01-06-1.9.0.md

@@ -0,0 +1,20 @@
+---
+title: 1.9.0
+summary: Aliases and ppl version
+date: 2013-01-06
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.9.0.html
+---
+
+This release adds two new features: the [version
+command](/documentation/commands/version), and support for
+[aliases](/documentation/configuration/alias). Both features function similarly
+to their git counterparts, albeit in a less complete way. For now the aliasing
+only supports simple aliasing of plain command names, and doesn't allow things
+like aliasing long chains of arguments or git's `!f() {}` style commands. These
+things will come in time.
+
+* Added `ppl version` command
+* Added rudimentary alias support

data/gh-pages/_posts/2013-01-10-1.10.0.md

@@ -0,0 +1,18 @@
+---
+title: 1.10.0
+summary: Multiple organizations and phone numbers
+date: 2013-01-10
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.10.0.html
+---
+
+A lot of the work in this release went into some much-needed refactoring as a
+precautionary measure against accumulating too much technical debt early on. The
+code reuse enabled by this refactor facilitated the addition of some key
+functionality, too.
+
+* Added support for storing multiple organizations with `ppl org` command
+* Added support for storing multiple phone numbers with `ppl phone` command
+* Added support for deleting phone numbers with `ppl phone` command

data/gh-pages/_posts/2013-01-20-1.11.0.md

@@ -0,0 +1,14 @@
+---
+title: 1.11.0
+summary: ppl nick
+date: 2013-01-20
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.11.0.html
+---
+
+This is a simple release that just adds new functionality in the form of support
+for another vCard property: [nicknames](/documentation/commands/nick).
+
+* Added `ppl nick` command

data/gh-pages/_posts/2013-02-16-1.12.0.md

@@ -0,0 +1,14 @@
+---
+title: 1.12.0
+summary: ppl age
+date: 2013-02-16
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.12.0.html
+---
+
+This release adds the [age](/documentation/commands/age) command, which provides
+easy access to the ages of all contacts based on their dates of birth.
+
+* Added `ppl age` command

data/gh-pages/_posts/2013-02-17-1.13.0.md

@@ -0,0 +1,29 @@
+---
+title: 1.13.0
+summary: ppl push, pull and remote
+date: 2013-02-17
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.13.0.html
+---
+
+The result of a lot of thought, this is the long-awaited git synchronisation
+functionality. What's been added are three new commands,
+[pull](/documentation/commands/pull), [push](/documentation/commands/push), and
+[remote](/documentation/commands/remote). These commands have no behaviour of
+their own, and are effectively aliases that execute their git counterparts
+inside the address book's directory.
+
+I think that this functionality is a good compromise: synchronising address book
+data can be accomplished using simple, familiar commands such as `ppl pull
+origin master`, and ppl itself is not unduly burdened with duplicating any git
+functionality.
+
+Another positive outcome of this work is that it brings proper git-style "bang"
+aliases closer to being a reality. The code changes required for these three
+commands lay a lot of the foundations necessary for bang aliases.
+
+* Added `ppl pull` command
+* Added `ppl push` command
+* Added `ppl remote` command

data/gh-pages/_posts/2013-02-17-1.14.0.md

@@ -0,0 +1,15 @@
+---
+title: 1.14.0
+summary: Bang aliases
+date: 2013-02-17
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.14.0.html
+---
+
+Hot on the heels of `1.13.0`, this release brings the git-style bang alias
+functionality facilitated by the previous release's code changes. This allows
+the creation of aliases which execute a shell command.
+
+* Add bang alias support

data/gh-pages/_posts/2013-02-17-1.14.1.md

@@ -0,0 +1,18 @@
+---
+title: 1.14.1
+summary: Removes discrepancy with documentation
+date: 2013-02-17
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.14.1.html
+---
+
+The release of `1.14.0` exposed a small screw-up in ppl's alias support. The
+`[alias]` section of the `~/.pplconfig` file was not being picked up at all.
+Instead it was looking for a section called `[aliases]`, which was insconsistent
+with the documentation and with git, on which the functionality is based. This
+release, therefore, is a fix for this issue: an `[alias]` section in
+`.pplconfig` should now work as described.
+
+* Fixed `[alias]` configuration

data/gh-pages/_posts/2013-02-17-two-months-in.md

@@ -0,0 +1,27 @@
+---
+title: Two Months In
+date: 2013-02-17
+layout: news
+section: news
+categories: [news]
+---
+
+It's been almost two months now since the big day of [ppl's public
+release](news/thank-you-for-your-all-your-feedback/). In that time, development
+has continued at a more steady, sustainable pace than during the period leading
+up to the release itself. New functionality has been added, and a few bugs have
+been fixed, as [the changelog](/development/changelog) will attest.
+
+One particularly nasty bug has been reported whose solution eludes me for the
+moment. It seems ppl does not cope well with [non-ASCII
+characters](https://github.com/hnrysmth/ppl/issues/17). The error itself is coming
+from within vpim - although it is almost certainly not a vpim bug - and is
+proving a tough nut to crack. Encodings in Ruby 1.9 are [fraught with
+complexity](http://yehudakatz.com/2010/05/05/ruby-1-9-encodings-a-primer-and-the-solution-for-rails/),
+but I'm optimistic about the existence of a simple solution.
+
+On a more positive note, it's worth mentioning that the overall health of the
+project seems to be good. I continue to enjoy building and maintaining ppl, and
+public interest in a command-line address book is as strong as could be expected
+for such a niche piece of software. Thanks for all your patience and support!
+

data/gh-pages/_posts/2013-03-16-1.15.0.md

@@ -0,0 +1,28 @@
+---
+title: 1.15.0
+summary: Color output added
+date: 2013-03-16
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/1.15.0.html
+---
+
+This adds support for colourised output to most ppl commands. The following
+commands are affected by this change:
+
+* [age](/documentation/configuration/color_age)
+* [bday](/documentation/configuration/color_bday)
+* [email](/documentation/configuration/color_email)
+* [ls](/documentation/configuration/color_ls)
+* [name](/documentation/configuration/color_name)
+* [nick](/documentation/configuration/color_nick)
+* [org](/documentation/configuration/color_org)
+* [phone](/documentation/configuration/color_phone)
+* [post](/documentation/configuration/color_post)
+* [url](/documentation/configuration/color_url)
+
+Internally, this release depends on two new gems:
+
+* [morphine](https://github.com/bkeepers/morphine)
+* [colored](https://github.com/defunkt/colored)

data/gh-pages/_posts/2013-03-16-coloured-output-released.md

@@ -0,0 +1,27 @@
+---
+title: Coloured Output Released
+date: 2013-03-16
+layout: news
+section: news
+categories: [news]
+---
+
+It's been about a month since the last release, but that's not because of any
+lack of internal activity. Today marks the release of support for git-style
+coloured output, configurable in `~/.pplconfig`.
+
+This has taken a while to achieve just because I wanted to take my time over it
+and try to really get it right the first time. Some refactoring was necessary in
+order to get config data into the code responsible for formatting output, but
+hopefully the resulting usage of the
+[morphine](https://github.com/bkeepers/morphine) dependency injection container
+should reduce such code churn in future.
+
+In other news, the [UTF-8 bug](https://github.com/hnrysmth/ppl/issues/17) mentioned
+in [last month's update](/news/two-months-in/) should be gone soon. I've spoken
+to the maintainer of vpim about it, and [his
+response](http://rubyforge.org/pipermail/vpim-talk/2013/000185.html) was
+positive. Apparently vpim just doesn't quite support Ruby 1.9.1's String class
+yet, but will do soon.
+
+

data/gh-pages/_posts/2013-04-10-ruby-2.0-compatibility.md

@@ -0,0 +1,28 @@
+---
+title: Ruby 2.0 Compatibility
+date: 2013-04-10
+layout: news
+section: news
+categories: [news]
+---
+
+The latest version of ppl is available now, and it's one of those tiny,
+pointless-sounding ones: `1.15.1`. This release is all about Ruby 2.0
+compatibility.  A recent issue reported on GitHub by
+[@pigmonkey](https://github.com/pigmonkey) brought to my attention that vpim,
+ppl's underlying vCard library, [doesn't work at all in Ruby
+2.0](https://github.com/hnrysmth/ppl/issues/19).
+
+    invalid multibyte escape: /^\xFF\xFE/
+
+This is all better now, and ppl works as well in Ruby 2.0 as it does in the
+1.9.\* range. This was a bit of a seismic change behind the scenes, and it
+almost seems misleading to increment only the patch version number.
+
+Essentially, I forked vpim in order to get this done. While this is an
+unexpected turn of events, it does mean I'm now quite well-placed to fix its
+UTF-8 issues myself instead of depending on the mercy of upstream. By the way,
+if you're interested in helping with this, go take a look at
+[greencard](https://github.com/hnrysmth/greencard). It's vpim stripped down to just
+the vCard functionality used by ppl. Go fork it!
+