ppl 4.0.3 → 4.0.5
Sign up to get free protection for your applications and to get access to all the features.
- 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
|
-
|