ppl 4.0.3 → 4.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.editorconfig +4 -0
- data/.github/workflows/build.yml +7 -23
- data/.gitignore +0 -4
- data/.ruby-version +1 -0
- data/Gemfile +0 -1
- data/Rakefile +2 -2
- data/code_of_conduct.md +1 -1
- data/demo.svg +1 -0
- data/lib/ppl/adapter/storage/disk.rb +2 -2
- data/lib/ppl/adapter/storage/factory.rb +1 -1
- data/lib/ppl/application/configuration.rb +2 -2
- data/lib/ppl/command/completion.rb +1 -1
- data/lib/ppl/command/shell.rb +1 -1
- data/lib/ppl/command/version.rb +1 -1
- data/lib/ppl/version.rb +5 -0
- data/lib/ppl.rb +1 -4
- data/makefile +12 -1
- data/ppl.gemspec +12 -5
- data/ppl.svg +12 -0
- data/readme.md +4 -4
- data/spec/ppl/adapter/storage/disk_spec.rb +2 -2
- data/spec/ppl/command/completion_spec.rb +2 -2
- data/spec/ppl/command/shell_spec.rb +1 -1
- data/spec/ppl/command/version_spec.rb +1 -1
- metadata +56 -164
- data/.eleventy.js +0 -86
- data/.eleventyignore +0 -1
- data/gh-pages/Gemfile +0 -2
- data/gh-pages/Gemfile.lock +0 -238
- data/gh-pages/_config.yml +0 -5
- data/gh-pages/_includes/changelog.html +0 -23
- data/gh-pages/_includes/development-sidebar.html +0 -25
- data/gh-pages/_includes/footer.html +0 -22
- data/gh-pages/_includes/header.html +0 -43
- data/gh-pages/_includes/news.html +0 -36
- data/gh-pages/_includes/tip.html +0 -54
- data/gh-pages/_layouts/changelog.html +0 -1
- data/gh-pages/_layouts/command.html +0 -104
- data/gh-pages/_layouts/configuration.html +0 -71
- data/gh-pages/_layouts/development.html +0 -20
- data/gh-pages/_layouts/frontpage.html +0 -6
- data/gh-pages/_layouts/integration.html +0 -44
- data/gh-pages/_layouts/news.html +0 -2
- data/gh-pages/_layouts/page.html +0 -6
- data/gh-pages/_layouts/tip.html +0 -2
- data/gh-pages/_posts/2012-01-15-first-post.md +0 -16
- data/gh-pages/_posts/2012-12-20-1.0.0.md +0 -19
- data/gh-pages/_posts/2012-12-20-1.1.0.md +0 -28
- data/gh-pages/_posts/2012-12-20-1.2.0.md +0 -18
- data/gh-pages/_posts/2012-12-21-1.3.0.md +0 -20
- data/gh-pages/_posts/2012-12-21-thank-you-for-your-all-your-feedback.md +0 -26
- data/gh-pages/_posts/2012-12-22-1.4.1.md +0 -21
- data/gh-pages/_posts/2012-12-22-1.5.0.md +0 -17
- data/gh-pages/_posts/2012-12-23-1.5.1.md +0 -13
- data/gh-pages/_posts/2012-12-23-1.5.2.md +0 -15
- data/gh-pages/_posts/2012-12-26-1.5.3.md +0 -19
- data/gh-pages/_posts/2012-12-27-1.6.0.md +0 -18
- data/gh-pages/_posts/2012-12-29-1.7.0.md +0 -18
- data/gh-pages/_posts/2013-01-05-1.8.0.md +0 -18
- data/gh-pages/_posts/2013-01-06-1.9.0.md +0 -20
- data/gh-pages/_posts/2013-01-10-1.10.0.md +0 -18
- data/gh-pages/_posts/2013-01-20-1.11.0.md +0 -14
- data/gh-pages/_posts/2013-02-16-1.12.0.md +0 -14
- data/gh-pages/_posts/2013-02-17-1.13.0.md +0 -29
- data/gh-pages/_posts/2013-02-17-1.14.0.md +0 -15
- data/gh-pages/_posts/2013-02-17-1.14.1.md +0 -18
- data/gh-pages/_posts/2013-02-17-two-months-in.md +0 -27
- data/gh-pages/_posts/2013-03-16-1.15.0.md +0 -28
- data/gh-pages/_posts/2013-03-16-coloured-output-released.md +0 -27
- data/gh-pages/_posts/2013-04-10-ruby-2.0-compatibility.md +0 -28
- data/gh-pages/_posts/2013-04-11-1.15.1.md +0 -13
- data/gh-pages/_posts/2013-04-12-1.16.0.md +0 -22
- data/gh-pages/_posts/2013-04-14-1.17.0.md +0 -15
- data/gh-pages/_posts/2013-04-14-1.17.1.md +0 -20
- data/gh-pages/_posts/2013-04-14-1.17.2.md +0 -13
- data/gh-pages/_posts/2013-04-15-sync-alias.md +0 -31
- data/gh-pages/_posts/2013-04-15-utf8-fixed-and-more.md +0 -37
- data/gh-pages/_posts/2013-04-16-1.18.0.md +0 -15
- data/gh-pages/_posts/2013-04-16-set-up-color-output.md +0 -47
- data/gh-pages/_posts/2013-04-19-1.19.0.md +0 -13
- data/gh-pages/_posts/2013-04-19-1.20.0.md +0 -15
- data/gh-pages/_posts/2013-04-20-1.21.0.md +0 -16
- data/gh-pages/_posts/2013-04-20-1.22.0.md +0 -14
- data/gh-pages/_posts/2013-04-20-1.22.1.md +0 -13
- data/gh-pages/_posts/2013-04-21-1.22.2.md +0 -15
- data/gh-pages/_posts/2013-04-21-1.23.0.md +0 -35
- data/gh-pages/_posts/2013-04-23-1.24.0.md +0 -16
- data/gh-pages/_posts/2013-04-24-1.25.0.md +0 -21
- data/gh-pages/_posts/2013-05-09-2.0.0.md +0 -33
- data/gh-pages/_posts/2013-05-09-version-2.0.0-released.md +0 -32
- data/gh-pages/_posts/2013-07-20-2.1.0.md +0 -36
- data/gh-pages/_posts/2013-07-20-2.2.0.md +0 -20
- data/gh-pages/_posts/2013-10-12-2.3.0.md +0 -19
- data/gh-pages/_posts/2014-03-30-2.3.1.md +0 -25
- data/gh-pages/_posts/2015-01-05-2.3.2.md +0 -18
- data/gh-pages/_posts/2015-12-03-get-involved.md +0 -29
- data/gh-pages/_posts/2015-12-05-2.3.3.md +0 -16
- data/gh-pages/_posts/2016-01-02-2.4.0.md +0 -19
- data/gh-pages/_posts/2017-05-01-2.4.1.md +0 -12
- data/gh-pages/_posts/2017-10-23-sleep-mode.md +0 -18
- data/gh-pages/_posts/2018-01-03-3.0.1.md +0 -12
- data/gh-pages/_stylesheets/ppl/color.less +0 -119
- data/gh-pages/_stylesheets/ppl/layout.less +0 -54
- data/gh-pages/_stylesheets/ppl/style.less +0 -185
- data/gh-pages/_stylesheets/ppl/typography.less +0 -59
- data/gh-pages/development/changelog/index.md +0 -18
- data/gh-pages/development/changelog/split.rb +0 -51
- data/gh-pages/development/index.html +0 -32
- data/gh-pages/development/roadmap/index.md +0 -15
- data/gh-pages/documentation/about/index.html +0 -63
- data/gh-pages/documentation/commands/add/index.md +0 -43
- data/gh-pages/documentation/commands/age/add/index.md +0 -40
- data/gh-pages/documentation/commands/age/index.md +0 -38
- data/gh-pages/documentation/commands/bday/index.md +0 -44
- data/gh-pages/documentation/commands/completion/index.md +0 -38
- data/gh-pages/documentation/commands/email/index.md +0 -64
- data/gh-pages/documentation/commands/grep/index.md +0 -32
- data/gh-pages/documentation/commands/init/index.md +0 -28
- data/gh-pages/documentation/commands/ls/index.md +0 -55
- data/gh-pages/documentation/commands/mutt/index.md +0 -36
- data/gh-pages/documentation/commands/mv/index.md +0 -26
- data/gh-pages/documentation/commands/name/index.md +0 -45
- data/gh-pages/documentation/commands/nick/index.md +0 -44
- data/gh-pages/documentation/commands/org/index.md +0 -45
- data/gh-pages/documentation/commands/phone/index.md +0 -56
- data/gh-pages/documentation/commands/post/index.md +0 -61
- data/gh-pages/documentation/commands/pull/index.md +0 -39
- data/gh-pages/documentation/commands/push/index.md +0 -36
- data/gh-pages/documentation/commands/remote/index.md +0 -40
- data/gh-pages/documentation/commands/rm/index.md +0 -23
- data/gh-pages/documentation/commands/scrape/index.md +0 -38
- data/gh-pages/documentation/commands/shell/index.md +0 -39
- data/gh-pages/documentation/commands/show/index.md +0 -33
- data/gh-pages/documentation/commands/url/index.md +0 -44
- data/gh-pages/documentation/commands/version/index.md +0 -27
- data/gh-pages/documentation/configuration/address_book/index.md +0 -22
- data/gh-pages/documentation/configuration/alias/index.md +0 -45
- data/gh-pages/documentation/configuration/color/index.md +0 -47
- data/gh-pages/documentation/configuration/color_age/index.md +0 -20
- data/gh-pages/documentation/configuration/color_bday/index.md +0 -20
- data/gh-pages/documentation/configuration/color_email/index.md +0 -21
- data/gh-pages/documentation/configuration/color_ls/index.md +0 -21
- data/gh-pages/documentation/configuration/color_name/index.md +0 -20
- data/gh-pages/documentation/configuration/color_nick/index.md +0 -20
- data/gh-pages/documentation/configuration/color_org/index.md +0 -20
- data/gh-pages/documentation/configuration/color_phone/index.md +0 -22
- data/gh-pages/documentation/configuration/color_post/index.md +0 -20
- data/gh-pages/documentation/configuration/color_url/index.md +0 -20
- data/gh-pages/documentation/configuration/index.html +0 -8
- data/gh-pages/documentation/index.html +0 -183
- data/gh-pages/documentation/integration/bash/index.md +0 -23
- data/gh-pages/documentation/integration/google/index.md +0 -26
- data/gh-pages/documentation/integration/index.html +0 -8
- data/gh-pages/documentation/integration/mutt/index.md +0 -35
- data/gh-pages/documentation/integration/zsh/index.md +0 -19
- data/gh-pages/documentation/quick-start/index.html +0 -88
- data/gh-pages/documentation/tips/index.html +0 -9
- data/gh-pages/index.html +0 -108
- data/gh-pages/news/index.html +0 -9
- data/gh-pages/robots.txt +0 -3
- data/gh-pages/stylesheets/flatstrap.css +0 -10
- data/gh-pages/stylesheets/ppl.scss +0 -235
- data/gh-pages/wiki.png +0 -0
- data/package.json +0 -23
- data/site/_data/url.js +0 -4
- data/site/casts/hero.cast +0 -189
- data/site/development.njk +0 -6
- data/site/documentation.njk +0 -6
- data/site/index.njk +0 -75
- data/site/news.njk +0 -6
- data/site/style.scss +0 -140
- data/spec/ppl/adapter/color_spec.rb +0 -14
- data/spec/ppl/adapter/email_scraper_spec.rb +0 -14
- data/spec/ppl/adapter/vcard_spec.rb +0 -23
- data/spec/ppl/format/address_book_spec.rb +0 -17
- data/spec/ppl/format/contact_spec.rb +0 -16
- data/spec/ppl/format/name_spec.rb +0 -17
- data/spec/ppl/format/postal_address_spec.rb +0 -17
- data/yarn.lock +0 -3605
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 1.17.1
|
|
3
|
-
summary: Mutt integration tweaks
|
|
4
|
-
date: 2013-04-14
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/1.17.1.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
Two fairly minor issues are fixed in this version. The first is a tweak to the
|
|
12
|
-
output of the [mutt](/documentation/commands/mutt) command, improving the
|
|
13
|
-
[understandability and usefulness of the user-facing
|
|
14
|
-
text](https://github.com/hnrysmth/ppl/issues/20#issuecomment-16302428). The second is
|
|
15
|
-
a bit of output sanitisation to help out people unlucky enough to have an
|
|
16
|
-
address book where some of the contacts' fields contain `^M` [carriage return
|
|
17
|
-
characters](https://github.com/hnrysmth/ppl/issues/27).
|
|
18
|
-
|
|
19
|
-
* Tweaked the output of the [mutt](/documentation/commands/mutt) command
|
|
20
|
-
* Add output sanitisation removing all `^M` characters from all output
|
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 1.17.2
|
|
3
|
-
summary: Fix for minor release bugs
|
|
4
|
-
date: 2013-04-14
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/1.17.2.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
An embarrassing "quick follow-up" release, this unbreaks a couple of things that
|
|
12
|
-
1.17.1 broke. Displaying the "Contact '%s' not found" message has been fixed, as
|
|
13
|
-
has the command list help text displayed by `ppl` and `ppl help`.
|
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: Sync Alias
|
|
3
|
-
date: 2013-04-15
|
|
4
|
-
layout: tip
|
|
5
|
-
categories: [tips]
|
|
6
|
-
permalink: /documentation/tips/sync-alias
|
|
7
|
-
author_name: hnrysmth
|
|
8
|
-
author_url: http://henrysmith.org/
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
If your ppl address book is cloned on multiple computers, you're probably
|
|
12
|
-
accustomed to using [pull](/documentation/commands/pull/) and
|
|
13
|
-
[push](/documentation/commands/pull/) to synchronise your data using Git. If so,
|
|
14
|
-
that's great. You're making the most of ppl's core functionality. But you could
|
|
15
|
-
probably be making more of its convenience-oriented features.
|
|
16
|
-
|
|
17
|
-
ppl allows you to configure [aliases](/documentation/configuration/alias/) as
|
|
18
|
-
shorcuts for often-used commands, or as a way of composing commands together.
|
|
19
|
-
Here's an alias called `sync` which does the latter.
|
|
20
|
-
|
|
21
|
-
sync = !ppl pull origin master && ppl push origin master
|
|
22
|
-
|
|
23
|
-
This allows you to execute `git pull origin master` and then `git push origin
|
|
24
|
-
master` in your address book directory by simply entering `ppl sync`. For most
|
|
25
|
-
users, this probably automates the entire synchronisation process.
|
|
26
|
-
|
|
27
|
-
Bear in mind that this alias will only work if you keep your contacts on the
|
|
28
|
-
`master` branch and have a remote called `origin`. If your setup is more complex
|
|
29
|
-
than that, you may have to get creative with your aliases to achieve this level
|
|
30
|
-
of laziness.
|
|
31
|
-
|
|
@@ -1,37 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: UTF-8 Fixed And More
|
|
3
|
-
date: 2013-04-15
|
|
4
|
-
layout: news
|
|
5
|
-
section: news
|
|
6
|
-
categories: [news]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
Over the weekend, in an uncharacteristically late night of coding, I finally put
|
|
10
|
-
an end to that UTF-8 issue that had been preventing the [use of ppl with
|
|
11
|
-
non-ASCII characters](https://github.com/hnrysmth/ppl/issues/17) such as ß or ñ. My
|
|
12
|
-
apologies to anyone who wanted to try ppl and couldn't during the *two entire
|
|
13
|
-
months* that issue sat open. If it's any consolation, fixing it gave me many
|
|
14
|
-
headaches.
|
|
15
|
-
|
|
16
|
-
Even though it's only been a few days since the previous news post, there has
|
|
17
|
-
been a lot of progress in that time, thanks largely to the involvement and
|
|
18
|
-
encouragement of [@pigmonkey](https://github.com/pigmonkey) and
|
|
19
|
-
[@shushcat](https://github.com/shushcat) on GitHub. Some good refinements to the
|
|
20
|
-
[mutt integration](/documentation/integration/mutt/) have already made it into
|
|
21
|
-
recent versions of ppl, and there's some good discussion happening about what
|
|
22
|
-
needs doing to keep improving ppl in the near future.
|
|
23
|
-
|
|
24
|
-
The [documentation](/documentation) has had some much-needed attention invested
|
|
25
|
-
in it, too. A few bits and pieces have been tidied up, and a couple of entirely
|
|
26
|
-
new sections have been added as well. The [Integration
|
|
27
|
-
Guide](/documentation/integration/bash/) covers the growing number of ways of
|
|
28
|
-
using ppl with other software, and the [Tips Section](documentation/tips/)
|
|
29
|
-
should prove to be a good catch-all place for helpful advice about using ppl.
|
|
30
|
-
|
|
31
|
-
Contributions are welcome, so get in touch if you spot any mistakes, have any
|
|
32
|
-
tips to contribute, or know of any tools for integrating ppl into other
|
|
33
|
-
software. Big thanks to everyone for your input so far. Shout out to
|
|
34
|
-
[@alexGschaider](https://github.com/axelGschaider),
|
|
35
|
-
[@matthewp](https://github.com/matthewp/), and
|
|
36
|
-
[@storge](https://github.com/storge) for their help as well.
|
|
37
|
-
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 1.18.0
|
|
3
|
-
summary: ppl completion added
|
|
4
|
-
date: 2013-04-16
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/1.18.0.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
With the intention of streamlining the integration process with
|
|
12
|
-
[Bash](/documentation/integration/bash), and
|
|
13
|
-
[ZSH](/documentation/integration/zsh), this release adds the
|
|
14
|
-
[completion](/documentation/commands/completion) command. This new command
|
|
15
|
-
simply outputs the chosen shell autocompletion function to stdout.
|
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: Set Up Color Output
|
|
3
|
-
date: 2013-04-16
|
|
4
|
-
layout: tip
|
|
5
|
-
categories: [tips]
|
|
6
|
-
permalink: /documentation/tips/set-up-color-output
|
|
7
|
-
author_name: hnrysmth
|
|
8
|
-
author_url: http://henrysmith.org/
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
ppl provides a system for configuring the output of many of its commands in a
|
|
12
|
-
way that's almost identical to git's color output configuration. While not an
|
|
13
|
-
essential piece of functionality, a small amount of color can go a long way
|
|
14
|
-
towards improving your experience using ppl.
|
|
15
|
-
|
|
16
|
-
Personally, I try to rein in the temptation to go to town and assign a color to
|
|
17
|
-
absolutely everything. My `~/.pplconfig` simply colorizes all contact IDs in all
|
|
18
|
-
output, highlighting them in cyan to maximize their visibility.
|
|
19
|
-
|
|
20
|
-
<pre><code>$ ppl ls</code>
|
|
21
|
-
<code><span style="color: #2AA198;">alice:</span> Alice alice@example.org</code>
|
|
22
|
-
<code><span style="color: #2AA198;">bob:</span> Bob bob@example.org</code>
|
|
23
|
-
<code><span style="color: #2AA198;">eve:</span> Eve eve@example.org</code></pre>
|
|
24
|
-
|
|
25
|
-
Configuring ppl to colorize the output of ls like in the above example is
|
|
26
|
-
extremely easy, and will be especially familiar to you if you're already used to
|
|
27
|
-
configuring git. Here are the exact config file contents necesssary to show
|
|
28
|
-
contact IDs in cyan in the output of [ppl ls](/documentation/commands/ls).
|
|
29
|
-
|
|
30
|
-
[color]
|
|
31
|
-
ls = true
|
|
32
|
-
|
|
33
|
-
[color "ls"]
|
|
34
|
-
id = cyan
|
|
35
|
-
|
|
36
|
-
Simply add the above to your `~/.pplconfig`, run `ppl ls`, and you should see
|
|
37
|
-
contact IDs in cyan. If not, double-check whether you're running an up-to-date
|
|
38
|
-
version of ppl. This feature has been supported since `1.15.0`, making it only
|
|
39
|
-
about a month old at the time of writing.
|
|
40
|
-
|
|
41
|
-
Now that you know the basic gist of how to configure color, you'll probably be
|
|
42
|
-
glad to know that there's some fairly extensive [reference documentation for this
|
|
43
|
-
functionality](/documentation/configuration/color), including a [list of
|
|
44
|
-
supported colors](/documentation/configuration/color/#list_of_supported_colors)
|
|
45
|
-
and an example for each command which shows the [full list of configurable text
|
|
46
|
-
elements](/documentation/configuration/color_ls).
|
|
47
|
-
|
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 1.19.0
|
|
3
|
-
summary: ppl scrape added
|
|
4
|
-
date: 2013-04-19
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/1.19.0.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
Following a [feature request](https://github.com/hnrysmth/ppl/issues/23) on GitHub,
|
|
12
|
-
this release adds the [scrape](/documentation/commands/scrape) command for
|
|
13
|
-
automatically adding contacts to an address book from an email message.
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 1.20.0
|
|
3
|
-
summary: ppl nick --no-color added
|
|
4
|
-
date: 2013-04-19
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/1.20.0.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
In order to fix a [compatibility issue with OS
|
|
12
|
-
X](https://github.com/hnrysmth/ppl/issues/22#issuecomment-16622923), the usage of sed
|
|
13
|
-
to strip ANSI color escape codes in the autocompletion functions has been
|
|
14
|
-
replaced with a `--no-color` option which has been added to [ppl
|
|
15
|
-
nick](/documentation/commands/nick).
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 1.21.0
|
|
3
|
-
summary: ppl phone --type added
|
|
4
|
-
date: 2013-04-20
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/1.21.0.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
Further increasing the expressiveness of ppl's commands, this release brings the
|
|
12
|
-
`--type` option to [ppl phone](/documentation/commands/phone). With this option,
|
|
13
|
-
the vCard format's `TYPE` parameter in the `TEL` field is now exposed to users.
|
|
14
|
-
This allows you to label phone numbers in a way that doesn't [break
|
|
15
|
-
compatibility with other
|
|
16
|
-
software](https://github.com/hnrysmth/ppl/issues/24#issuecomment-16623136).
|
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 1.22.0
|
|
3
|
-
summary: Noticeable performance optimization
|
|
4
|
-
date: 2013-04-20
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/1.22.0.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
In this version of ppl, one particularly egregious performance issue has been
|
|
12
|
-
fixed. Upgrading is *highly* recommended. Even if you haven't noticed any
|
|
13
|
-
problems worth complaining about, you should hopefully enjoy quite a boost with
|
|
14
|
-
this new version.
|
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 1.22.1
|
|
3
|
-
summary: Fix minor output formatting bug
|
|
4
|
-
date: 2013-04-20
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/1.22.1.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
This version simply fixes a minor bug in the outputting format code, which was
|
|
12
|
-
introduced in `1.21.0`. Nothing serious, but a warning sign that I need to slow
|
|
13
|
-
myself down and perhaps look at automating more of the testing process.
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 1.22.2
|
|
3
|
-
summary: Fix for broken --delete option
|
|
4
|
-
date: 2013-04-21
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/1.22.2.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
See the [Bash integration guide](/documentation/integration/bash) for details of
|
|
12
|
-
how to install the updated completion function to your system. Another bugfix
|
|
13
|
-
release, fixing the [broken `--delete`
|
|
14
|
-
option](https://github.com/hnrysmth/ppl/issues/33) of [`ppl
|
|
15
|
-
phone`](/documentation/commands/phone).
|
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 1.23.0
|
|
3
|
-
summary: Bash completion enhancements
|
|
4
|
-
date: 2013-04-21
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/1.23.0.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
Unusually for a ppl release, this one doesn't add any new core functionality or
|
|
12
|
-
fix any bugs. Instead, this release is solely an update to the [Bash
|
|
13
|
-
integration](/documentation/integration/bash/). The following improvements have
|
|
14
|
-
been made to the bash completion.
|
|
15
|
-
|
|
16
|
-
* It now returns command name suggestions much more quickly
|
|
17
|
-
* It can autocomplete email addresses for use with [`ppl
|
|
18
|
-
email`](/documentation/commands/email)
|
|
19
|
-
* It can autocomplete nicknames for use with [`ppl
|
|
20
|
-
nick`](/documentation/commands/nick)
|
|
21
|
-
* It can autocomplete organizations for use with [`ppl
|
|
22
|
-
org`](/documentation/commands/org)
|
|
23
|
-
* It can autocomplete phone numbers for use with [`ppl
|
|
24
|
-
phone`](/documentation/commands/phone)
|
|
25
|
-
* It can autocomplete URLs for use with [`ppl url`](/documentation/commands/url)
|
|
26
|
-
* It can autocomplete git remotes for use with
|
|
27
|
-
[`pull`](/documentation/commands/pull) and
|
|
28
|
-
[`push`](/documentation/commands/push)
|
|
29
|
-
|
|
30
|
-
For example, if you're attempting to amend the `--type` of a contact's phone
|
|
31
|
-
number, you can now enter `ppl phone adam 071<Tab>` and Bash will autocomplete
|
|
32
|
-
the rest of the phone number.
|
|
33
|
-
|
|
34
|
-
See the [Bash integration guide](/documentation/integration/bash) for details of
|
|
35
|
-
how to install the updated completion function to your system.
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 1.24.0
|
|
3
|
-
summary: Preferred email addresses
|
|
4
|
-
date: 2013-04-23
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/1.24.0.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
Preferred email addresses and phone numbers can be marked as such as of
|
|
12
|
-
`1.24.0`. This is good news if you have contacts with several similar addresses
|
|
13
|
-
or numbers who only tend to check one of them. Now you can mark their preferred
|
|
14
|
-
contact details with the `--preferred` flag and ppl will remember this
|
|
15
|
-
preferential status for you. Preferred numbers and addresses are displayed with
|
|
16
|
-
a `*` before them.
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 1.25.0
|
|
3
|
-
summary: Customizable Output
|
|
4
|
-
date: 2013-04-24
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/1.25.0.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
This release brings the very basic first customizability to the output of ppl's
|
|
12
|
-
commands. As of this version, it's possible to pass a `--format` option to [`ppl
|
|
13
|
-
email`](/documentation/commands/email) and [`ppl
|
|
14
|
-
ls`](/documentation/commands/ls) to specify the exact nature of the output
|
|
15
|
-
required. Also part of this new version is the ability to configure preset
|
|
16
|
-
format strings for [`ppl ls`](/documentation/commands/ls) in `~/.pplconfig` and
|
|
17
|
-
invoke them by name using the `--pretty` option.
|
|
18
|
-
|
|
19
|
-
Obviously, this type of functionality has the potential to be added to just
|
|
20
|
-
about all of ppl's output. In time, that will happen. For now, this gets the
|
|
21
|
-
basic functionality out there for use.
|
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 2.0.0
|
|
3
|
-
summary: ppl post overhaul
|
|
4
|
-
date: 2013-05-09
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/2.0.0.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
As a result of its backwards compatibility breaking changes, the overhaul of
|
|
12
|
-
[ppl post](/documentation/commands/post) brings us to version 2.0.0. The
|
|
13
|
-
behaviour and usage of this command have changed completely in order to cope
|
|
14
|
-
with storing multiple postal addresses per contact.
|
|
15
|
-
|
|
16
|
-
Here is a short summary of what has changed:
|
|
17
|
-
|
|
18
|
-
* Running `ppl post` no longer lists contacts' full addresses.
|
|
19
|
-
Instead it lists contacts' address *IDs*.
|
|
20
|
-
* Running `ppl post <contact>` no longer shows that contact's single postal
|
|
21
|
-
address. Instead it lists *all* that contact's postal addresses.
|
|
22
|
-
* Postal address now have their own IDs. In order to change a postal address,
|
|
23
|
-
the ID of both the contact and the address itself must be given.
|
|
24
|
-
* It is now possible to mark a postal address as "preferred", similarly to email
|
|
25
|
-
addresses and phone numbers.
|
|
26
|
-
|
|
27
|
-
From a technical point of view, the downside of this release is the minor
|
|
28
|
-
violation of [RFC2426](http://www.ietf.org/rfc/rfc2426.txt) that it introduces.
|
|
29
|
-
The `ADR` field's `TYPE` attribute is intended as a means of tagging addresses
|
|
30
|
-
with extra information such as "home" or "work", but as of 2.0.0, ppl
|
|
31
|
-
misappropriates this attribute as the home of the unique ID of each postal
|
|
32
|
-
address.
|
|
33
|
-
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: ppl 2.0.0 released
|
|
3
|
-
date: 2013-05-09
|
|
4
|
-
layout: news
|
|
5
|
-
section: news
|
|
6
|
-
categories: [news]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
It's been almost exactly six months since the very [first
|
|
10
|
-
commit](https://github.com/hnrysmth/ppl/commit/e45917e06afd255271bad51ce216642e7277ce86),
|
|
11
|
-
and I'm proud to announce that ppl has now reached the dizzy heights of version
|
|
12
|
-
2.0.0! This is a milestone release for more than one reason, and I'm very happy
|
|
13
|
-
that this project has made it to this point.
|
|
14
|
-
|
|
15
|
-
Most important of all, the reason for the major version bump is that [ppl
|
|
16
|
-
post](/documentation/commands/post) has been overhauled to support storing
|
|
17
|
-
multiple postal addresses per contact. This overhaul introduced a number of
|
|
18
|
-
backwards-incompatible changes to the behaviour of that command and ppl's
|
|
19
|
-
underlying vCard integration, hence the bump to 2.0.0.
|
|
20
|
-
|
|
21
|
-
The other reason why this is quite a milestone release is that support for
|
|
22
|
-
multiple postal addresses was really the last major missing piece of the puzzle
|
|
23
|
-
in terms of core ppl functionality. There are still some bits and pieces of
|
|
24
|
-
vCard functionality that aren't yet exposed, but those that remain now are
|
|
25
|
-
mostly edge cases. It's satisfying to see ppl approach the functionality goals I
|
|
26
|
-
had for it when I started.
|
|
27
|
-
|
|
28
|
-
This is by no means the end of the development process. There's a long way to go
|
|
29
|
-
still in terms of ppl's flexibility for integration with other software. In the
|
|
30
|
-
meantime, this version represents a big step forward, and the culmination of six
|
|
31
|
-
months of hard work.
|
|
32
|
-
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 2.1.0
|
|
3
|
-
summary: Better name management
|
|
4
|
-
date: 2013-07-20
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/2.1.0.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
With thanks to [@pigmonkey](https://github.com/pigmonkey) for raising this as
|
|
12
|
-
[issue #42](https://github.com/hnrysmth/ppl/issues/42) on GitHub, version 2.1.0
|
|
13
|
-
brings increased control over the names of contacts. This is intended to improve
|
|
14
|
-
interoperability with other address book software, including the Android
|
|
15
|
-
system's contact list.
|
|
16
|
-
|
|
17
|
-
Short, lower case contact IDs are great for a CLI program, but on a phone, you
|
|
18
|
-
probably want to see full names. This update provides full access to all the
|
|
19
|
-
bits & pieces of vCard's `N` (name) field:
|
|
20
|
-
|
|
21
|
-
* Family name(s)
|
|
22
|
-
* Middle name(s)
|
|
23
|
-
* Given name(s)
|
|
24
|
-
* Prefix
|
|
25
|
-
* Suffix
|
|
26
|
-
|
|
27
|
-
See the documentation of [ppl name](/documentation/commands/name/) for more
|
|
28
|
-
details on how to use this new functionality.
|
|
29
|
-
|
|
30
|
-
Also included is some slightly different behaviour under the hood of [ppl
|
|
31
|
-
add](/documentation/commands/name/). This command now attempts to "have a
|
|
32
|
-
guess" at the structure of the name of a newly-added contact. It'll treat the
|
|
33
|
-
first word of the full name as the contact's given name, and the rest of the
|
|
34
|
-
string as their family name. This is a shamefully anglocentric approach to name
|
|
35
|
-
parsing, but at least it's a start.
|
|
36
|
-
|
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 2.2.0
|
|
3
|
-
summary: ppl scrape overwrite prevention
|
|
4
|
-
date: 2013-07-20
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/2.2.0.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
Thanks again to [@pigmonkey](https://github.com/pigmonkey) for [issue #32](https://github.com/hnrysmth/ppl/issues/32),
|
|
12
|
-
reporting some unhelpful destructive behaviour in [ppl
|
|
13
|
-
scrape](/documentation/commands/scrape/). In this version, some additional
|
|
14
|
-
checking has been added to that command to prevent it from overwriting existing
|
|
15
|
-
contacts.
|
|
16
|
-
|
|
17
|
-
In the event that the scraped contact ID happens to match that of an existing
|
|
18
|
-
contact, ppl scrape will now notice this collision and append numbers to the new
|
|
19
|
-
ID until it no longer matches any existing contact's IDs.
|
|
20
|
-
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 2.3.0
|
|
3
|
-
summary: ppl grep
|
|
4
|
-
date: 2013-10-12
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/2.3.0.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
With thanks to [@ajford](https://github.com/ajford) for the excellent [feature
|
|
12
|
-
request](https://github.com/hnrysmth/ppl/issues/43), version 2.3.0 brings a new
|
|
13
|
-
command: [ppl grep](/documentation/commands/grep/). This command leverages the
|
|
14
|
-
extremely high speed search `git grep` repository search in order to provide
|
|
15
|
-
near-instant search results.
|
|
16
|
-
|
|
17
|
-
$ ppl grep smith
|
|
18
|
-
john.vcf:EMAIL:john.smith@example.org
|
|
19
|
-
|
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 2.3.1
|
|
3
|
-
summary: Simple Bug Fixes
|
|
4
|
-
date: 2014-03-30
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/2.3.1.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
Once again, I'm grateful to [@alexGschaider] for his patience. This minor
|
|
12
|
-
version fixes a couple of annoying little problems that he's bumped into.
|
|
13
|
-
|
|
14
|
-
The first problem was a pretty terrible error message which was displayed when a
|
|
15
|
-
`.vcf` file contains invalid vCard data. This has now been fixed, and the error
|
|
16
|
-
message replaced with something much more sensible.
|
|
17
|
-
|
|
18
|
-
$ ppl show badcontact
|
|
19
|
-
ppl: badcontact.vcf contains invalid data
|
|
20
|
-
|
|
21
|
-
The second was yet another `Encoding::CompatibilityError`, just like back in the
|
|
22
|
-
bad old days before ppl even supported UTF-8 at all. Hopefully this will be the
|
|
23
|
-
last one of those now!
|
|
24
|
-
|
|
25
|
-
[@alexGschaider]: https://github.com/axelGschaider
|
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 2.3.2
|
|
3
|
-
summary: scrape output fix
|
|
4
|
-
date: 2015-01-05
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/2.3.2.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
I'm very grateful to [@hobarrera](https://github.com/hobarrera) for contributing
|
|
12
|
-
this fix to [ppl scrape](/documentation/commands/scrape/). A simple mistake in
|
|
13
|
-
the output formatting code was causing it to appear slightly garbled, like this:
|
|
14
|
-
|
|
15
|
-
Add "Hugo Osvaldo Barrera #<Ppl::Entity::EmailAddress:0x00000001ffbd28>>"
|
|
16
|
-
to your address book [Y/n]?
|
|
17
|
-
|
|
18
|
-
So thanks for fixing that, Hugo!
|
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: Get Involved!
|
|
3
|
-
date: 2015-12-03
|
|
4
|
-
layout: news
|
|
5
|
-
section: news
|
|
6
|
-
categories: [news]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
The time has come to give this project a nudge into a slightly different mode of
|
|
10
|
-
operation. Enough people are interested in the long term health of this little
|
|
11
|
-
CLI app that I think it'd benefit from opening the doors a bit to potential
|
|
12
|
-
collaborators and maintainers. So I've converted the project into a proper
|
|
13
|
-
[GitHub organization](https://github.com/hnrysmth) and I'm inviting you to
|
|
14
|
-
come and join it.
|
|
15
|
-
|
|
16
|
-
I see lots of people come and go with great ideas for this project. I love 99%
|
|
17
|
-
of the ideas and suggestions that pop up but I just can't keep up with all the
|
|
18
|
-
different demands on my time. That's the bottleneck that's holding the project
|
|
19
|
-
back and it's silly, really.
|
|
20
|
-
|
|
21
|
-
For a while I've been wanting to do something about this. If you want to help
|
|
22
|
-
out in any way, however small, speak up on GitHub, [email me](mailto:henry@henrysmith.org),
|
|
23
|
-
or get in touch on [Twitter](https://twitter.com/hnrysmth). I'd love to add you
|
|
24
|
-
to the organization and let you *just get started* making your ideas happen.
|
|
25
|
-
Even if you just like the project, but don't have any immediate plans to do
|
|
26
|
-
anything in particular, that's fine! If you've never contributed to an open
|
|
27
|
-
source project before, don't let that put you off. Everyone's welcome!
|
|
28
|
-
|
|
29
|
-
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 2.3.3
|
|
3
|
-
summary: non-ASCII input fix
|
|
4
|
-
date: 2015-12-05
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/2.3.3.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
This release is [@tba](https://github.com/tba)'s [non-ASCII input fix PR](https://github.com/hnrysmth/ppl/pull/56)
|
|
12
|
-
|
|
13
|
-
It's a fix enabling ppl to save non-ASCII names when scraping contact data
|
|
14
|
-
from emails.
|
|
15
|
-
|
|
16
|
-
It took altogether too long for me to merge this and I apologise!
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 2.4.0
|
|
3
|
-
summary: Better commit author
|
|
4
|
-
date: 2016-01-12
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/2.4.0.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
If you've ever looked at the commit history that ppl generates in your address
|
|
12
|
-
book you'll have noticed the ugly-looking commit author. [@drewbug] certainly
|
|
13
|
-
noticed and took the time to do something about it.
|
|
14
|
-
|
|
15
|
-
As of this version, ppl pulls in your Git config and uses your `user.name` and
|
|
16
|
-
`user.email` if available. If not, it falls back to the old (ugly) author
|
|
17
|
-
generation.
|
|
18
|
-
|
|
19
|
-
[@drewbug]: https://github.com/drewbug
|
|
@@ -1,12 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 2.4.1
|
|
3
|
-
summary: Upgrade to rugged ~> v0.24.0
|
|
4
|
-
date: 2017-05-01
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/2.4.1.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
This release is just a merge of one PR from [@acant](https://github.com/acant). It upgrades to a much more
|
|
12
|
-
modern version of the rugged gem.
|
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: Sleep Mode
|
|
3
|
-
date: 2017-10-23
|
|
4
|
-
layout: news
|
|
5
|
-
section: news
|
|
6
|
-
categories: [news]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
This project seems to be in a good stable state. There's a small active
|
|
10
|
-
userbase who are mostly content with the software as-is. Not a lot of
|
|
11
|
-
maintenance or feature work is necessary these days and I can't justify
|
|
12
|
-
spending money on a domain for a project that's just chilling like this.
|
|
13
|
-
|
|
14
|
-
I'm converting the whole thing into a single, easy-to-look-after repo in my
|
|
15
|
-
own personal GitHub account and disabling autorenew on `ppladdressbook.org`.
|
|
16
|
-
Wanna make it clear that I consider this a fairly decent set of circumstances
|
|
17
|
-
for the project to be in btw. It mostly just works and that's for the best
|
|
18
|
-
cos I don't really have a lot of time to maintain and fix it any more.
|
|
@@ -1,12 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: 3.0.1
|
|
3
|
-
summary: Fix name deletion bug
|
|
4
|
-
date: 2018-01-03
|
|
5
|
-
layout: changelog
|
|
6
|
-
section: development
|
|
7
|
-
categories: [changelog]
|
|
8
|
-
permalink: /development/changelog/3.0.1.html
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
Fix for a [name deletion bug](https://github.com/hnrysmth/ppl/issues/74) reported by [@the-reverend](https://github.com/the-reverend).
|
|
12
|
-
|