ppl 4.0.3 → 4.0.5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (180) hide show
  1. checksums.yaml +4 -4
  2. data/.editorconfig +4 -0
  3. data/.github/workflows/build.yml +7 -23
  4. data/.gitignore +0 -4
  5. data/.ruby-version +1 -0
  6. data/Gemfile +0 -1
  7. data/Rakefile +2 -2
  8. data/code_of_conduct.md +1 -1
  9. data/demo.svg +1 -0
  10. data/lib/ppl/adapter/storage/disk.rb +2 -2
  11. data/lib/ppl/adapter/storage/factory.rb +1 -1
  12. data/lib/ppl/application/configuration.rb +2 -2
  13. data/lib/ppl/command/completion.rb +1 -1
  14. data/lib/ppl/command/shell.rb +1 -1
  15. data/lib/ppl/command/version.rb +1 -1
  16. data/lib/ppl/version.rb +5 -0
  17. data/lib/ppl.rb +1 -4
  18. data/makefile +12 -1
  19. data/ppl.gemspec +12 -5
  20. data/ppl.svg +12 -0
  21. data/readme.md +4 -4
  22. data/spec/ppl/adapter/storage/disk_spec.rb +2 -2
  23. data/spec/ppl/command/completion_spec.rb +2 -2
  24. data/spec/ppl/command/shell_spec.rb +1 -1
  25. data/spec/ppl/command/version_spec.rb +1 -1
  26. metadata +56 -164
  27. data/.eleventy.js +0 -86
  28. data/.eleventyignore +0 -1
  29. data/gh-pages/Gemfile +0 -2
  30. data/gh-pages/Gemfile.lock +0 -238
  31. data/gh-pages/_config.yml +0 -5
  32. data/gh-pages/_includes/changelog.html +0 -23
  33. data/gh-pages/_includes/development-sidebar.html +0 -25
  34. data/gh-pages/_includes/footer.html +0 -22
  35. data/gh-pages/_includes/header.html +0 -43
  36. data/gh-pages/_includes/news.html +0 -36
  37. data/gh-pages/_includes/tip.html +0 -54
  38. data/gh-pages/_layouts/changelog.html +0 -1
  39. data/gh-pages/_layouts/command.html +0 -104
  40. data/gh-pages/_layouts/configuration.html +0 -71
  41. data/gh-pages/_layouts/development.html +0 -20
  42. data/gh-pages/_layouts/frontpage.html +0 -6
  43. data/gh-pages/_layouts/integration.html +0 -44
  44. data/gh-pages/_layouts/news.html +0 -2
  45. data/gh-pages/_layouts/page.html +0 -6
  46. data/gh-pages/_layouts/tip.html +0 -2
  47. data/gh-pages/_posts/2012-01-15-first-post.md +0 -16
  48. data/gh-pages/_posts/2012-12-20-1.0.0.md +0 -19
  49. data/gh-pages/_posts/2012-12-20-1.1.0.md +0 -28
  50. data/gh-pages/_posts/2012-12-20-1.2.0.md +0 -18
  51. data/gh-pages/_posts/2012-12-21-1.3.0.md +0 -20
  52. data/gh-pages/_posts/2012-12-21-thank-you-for-your-all-your-feedback.md +0 -26
  53. data/gh-pages/_posts/2012-12-22-1.4.1.md +0 -21
  54. data/gh-pages/_posts/2012-12-22-1.5.0.md +0 -17
  55. data/gh-pages/_posts/2012-12-23-1.5.1.md +0 -13
  56. data/gh-pages/_posts/2012-12-23-1.5.2.md +0 -15
  57. data/gh-pages/_posts/2012-12-26-1.5.3.md +0 -19
  58. data/gh-pages/_posts/2012-12-27-1.6.0.md +0 -18
  59. data/gh-pages/_posts/2012-12-29-1.7.0.md +0 -18
  60. data/gh-pages/_posts/2013-01-05-1.8.0.md +0 -18
  61. data/gh-pages/_posts/2013-01-06-1.9.0.md +0 -20
  62. data/gh-pages/_posts/2013-01-10-1.10.0.md +0 -18
  63. data/gh-pages/_posts/2013-01-20-1.11.0.md +0 -14
  64. data/gh-pages/_posts/2013-02-16-1.12.0.md +0 -14
  65. data/gh-pages/_posts/2013-02-17-1.13.0.md +0 -29
  66. data/gh-pages/_posts/2013-02-17-1.14.0.md +0 -15
  67. data/gh-pages/_posts/2013-02-17-1.14.1.md +0 -18
  68. data/gh-pages/_posts/2013-02-17-two-months-in.md +0 -27
  69. data/gh-pages/_posts/2013-03-16-1.15.0.md +0 -28
  70. data/gh-pages/_posts/2013-03-16-coloured-output-released.md +0 -27
  71. data/gh-pages/_posts/2013-04-10-ruby-2.0-compatibility.md +0 -28
  72. data/gh-pages/_posts/2013-04-11-1.15.1.md +0 -13
  73. data/gh-pages/_posts/2013-04-12-1.16.0.md +0 -22
  74. data/gh-pages/_posts/2013-04-14-1.17.0.md +0 -15
  75. data/gh-pages/_posts/2013-04-14-1.17.1.md +0 -20
  76. data/gh-pages/_posts/2013-04-14-1.17.2.md +0 -13
  77. data/gh-pages/_posts/2013-04-15-sync-alias.md +0 -31
  78. data/gh-pages/_posts/2013-04-15-utf8-fixed-and-more.md +0 -37
  79. data/gh-pages/_posts/2013-04-16-1.18.0.md +0 -15
  80. data/gh-pages/_posts/2013-04-16-set-up-color-output.md +0 -47
  81. data/gh-pages/_posts/2013-04-19-1.19.0.md +0 -13
  82. data/gh-pages/_posts/2013-04-19-1.20.0.md +0 -15
  83. data/gh-pages/_posts/2013-04-20-1.21.0.md +0 -16
  84. data/gh-pages/_posts/2013-04-20-1.22.0.md +0 -14
  85. data/gh-pages/_posts/2013-04-20-1.22.1.md +0 -13
  86. data/gh-pages/_posts/2013-04-21-1.22.2.md +0 -15
  87. data/gh-pages/_posts/2013-04-21-1.23.0.md +0 -35
  88. data/gh-pages/_posts/2013-04-23-1.24.0.md +0 -16
  89. data/gh-pages/_posts/2013-04-24-1.25.0.md +0 -21
  90. data/gh-pages/_posts/2013-05-09-2.0.0.md +0 -33
  91. data/gh-pages/_posts/2013-05-09-version-2.0.0-released.md +0 -32
  92. data/gh-pages/_posts/2013-07-20-2.1.0.md +0 -36
  93. data/gh-pages/_posts/2013-07-20-2.2.0.md +0 -20
  94. data/gh-pages/_posts/2013-10-12-2.3.0.md +0 -19
  95. data/gh-pages/_posts/2014-03-30-2.3.1.md +0 -25
  96. data/gh-pages/_posts/2015-01-05-2.3.2.md +0 -18
  97. data/gh-pages/_posts/2015-12-03-get-involved.md +0 -29
  98. data/gh-pages/_posts/2015-12-05-2.3.3.md +0 -16
  99. data/gh-pages/_posts/2016-01-02-2.4.0.md +0 -19
  100. data/gh-pages/_posts/2017-05-01-2.4.1.md +0 -12
  101. data/gh-pages/_posts/2017-10-23-sleep-mode.md +0 -18
  102. data/gh-pages/_posts/2018-01-03-3.0.1.md +0 -12
  103. data/gh-pages/_stylesheets/ppl/color.less +0 -119
  104. data/gh-pages/_stylesheets/ppl/layout.less +0 -54
  105. data/gh-pages/_stylesheets/ppl/style.less +0 -185
  106. data/gh-pages/_stylesheets/ppl/typography.less +0 -59
  107. data/gh-pages/development/changelog/index.md +0 -18
  108. data/gh-pages/development/changelog/split.rb +0 -51
  109. data/gh-pages/development/index.html +0 -32
  110. data/gh-pages/development/roadmap/index.md +0 -15
  111. data/gh-pages/documentation/about/index.html +0 -63
  112. data/gh-pages/documentation/commands/add/index.md +0 -43
  113. data/gh-pages/documentation/commands/age/add/index.md +0 -40
  114. data/gh-pages/documentation/commands/age/index.md +0 -38
  115. data/gh-pages/documentation/commands/bday/index.md +0 -44
  116. data/gh-pages/documentation/commands/completion/index.md +0 -38
  117. data/gh-pages/documentation/commands/email/index.md +0 -64
  118. data/gh-pages/documentation/commands/grep/index.md +0 -32
  119. data/gh-pages/documentation/commands/init/index.md +0 -28
  120. data/gh-pages/documentation/commands/ls/index.md +0 -55
  121. data/gh-pages/documentation/commands/mutt/index.md +0 -36
  122. data/gh-pages/documentation/commands/mv/index.md +0 -26
  123. data/gh-pages/documentation/commands/name/index.md +0 -45
  124. data/gh-pages/documentation/commands/nick/index.md +0 -44
  125. data/gh-pages/documentation/commands/org/index.md +0 -45
  126. data/gh-pages/documentation/commands/phone/index.md +0 -56
  127. data/gh-pages/documentation/commands/post/index.md +0 -61
  128. data/gh-pages/documentation/commands/pull/index.md +0 -39
  129. data/gh-pages/documentation/commands/push/index.md +0 -36
  130. data/gh-pages/documentation/commands/remote/index.md +0 -40
  131. data/gh-pages/documentation/commands/rm/index.md +0 -23
  132. data/gh-pages/documentation/commands/scrape/index.md +0 -38
  133. data/gh-pages/documentation/commands/shell/index.md +0 -39
  134. data/gh-pages/documentation/commands/show/index.md +0 -33
  135. data/gh-pages/documentation/commands/url/index.md +0 -44
  136. data/gh-pages/documentation/commands/version/index.md +0 -27
  137. data/gh-pages/documentation/configuration/address_book/index.md +0 -22
  138. data/gh-pages/documentation/configuration/alias/index.md +0 -45
  139. data/gh-pages/documentation/configuration/color/index.md +0 -47
  140. data/gh-pages/documentation/configuration/color_age/index.md +0 -20
  141. data/gh-pages/documentation/configuration/color_bday/index.md +0 -20
  142. data/gh-pages/documentation/configuration/color_email/index.md +0 -21
  143. data/gh-pages/documentation/configuration/color_ls/index.md +0 -21
  144. data/gh-pages/documentation/configuration/color_name/index.md +0 -20
  145. data/gh-pages/documentation/configuration/color_nick/index.md +0 -20
  146. data/gh-pages/documentation/configuration/color_org/index.md +0 -20
  147. data/gh-pages/documentation/configuration/color_phone/index.md +0 -22
  148. data/gh-pages/documentation/configuration/color_post/index.md +0 -20
  149. data/gh-pages/documentation/configuration/color_url/index.md +0 -20
  150. data/gh-pages/documentation/configuration/index.html +0 -8
  151. data/gh-pages/documentation/index.html +0 -183
  152. data/gh-pages/documentation/integration/bash/index.md +0 -23
  153. data/gh-pages/documentation/integration/google/index.md +0 -26
  154. data/gh-pages/documentation/integration/index.html +0 -8
  155. data/gh-pages/documentation/integration/mutt/index.md +0 -35
  156. data/gh-pages/documentation/integration/zsh/index.md +0 -19
  157. data/gh-pages/documentation/quick-start/index.html +0 -88
  158. data/gh-pages/documentation/tips/index.html +0 -9
  159. data/gh-pages/index.html +0 -108
  160. data/gh-pages/news/index.html +0 -9
  161. data/gh-pages/robots.txt +0 -3
  162. data/gh-pages/stylesheets/flatstrap.css +0 -10
  163. data/gh-pages/stylesheets/ppl.scss +0 -235
  164. data/gh-pages/wiki.png +0 -0
  165. data/package.json +0 -23
  166. data/site/_data/url.js +0 -4
  167. data/site/casts/hero.cast +0 -189
  168. data/site/development.njk +0 -6
  169. data/site/documentation.njk +0 -6
  170. data/site/index.njk +0 -75
  171. data/site/news.njk +0 -6
  172. data/site/style.scss +0 -140
  173. data/spec/ppl/adapter/color_spec.rb +0 -14
  174. data/spec/ppl/adapter/email_scraper_spec.rb +0 -14
  175. data/spec/ppl/adapter/vcard_spec.rb +0 -23
  176. data/spec/ppl/format/address_book_spec.rb +0 -17
  177. data/spec/ppl/format/contact_spec.rb +0 -16
  178. data/spec/ppl/format/name_spec.rb +0 -17
  179. data/spec/ppl/format/postal_address_spec.rb +0 -17
  180. 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
-