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.
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
-