Overview

Enhances and extends Alfred by providing a Ruby command line interface (CLI).

Features

• Adds Ruby support to Alfred.
• Adds the following Alfred Workflows:
  • Pennyworth String Upcase
  • Pennyworth String Length
  • Pennyworth String Downcase
  • Pennyworth String Capitalize
  • Ruby on Rails Kit

Requirements

1. OSX.
2. Alfred (Version 2.x.x or higher).
3. Alfred Powerpack.
4. rbenv.
5. Any of the following Ruby VMs:
   • MRI 2.x.x
   • JRuby 1.x.x

Setup

For a secure install, type the following from the command line (recommended):

gem cert --add <(curl -Ls https://www.alchemists.io/gem-public.pem)
gem install pennyworth --trust-policy MediumSecurity

NOTE: A HighSecurity trust policy would be best but MediumSecurity enables signed gem verification while allowing the installation of unsigned dependencies since they are beyond the scope of this gem.

For an insecure install, type the following (not recommended):

gem install pennyworth

You can configure common settings for future gem builds by creating the following file:

~/.pennyworth/settings.yml

...using the following settings (for example):

 ---
 :alfred_settings_root: "/Users/bkuhlmann/Dropbox/Cache/Alfred/Alfred.alfredpreferences"

Usage

From the command line, type: pennyworth

pennyworth -e, [edit]     # Edit gem settings in default editor (assumes $EDITOR environment variable).
pennyworth -h, [help]     # Show this message.
pennyworth -i, [install]  # Install Alfred Workflows.
pennyworth -s, [string]   # Manipulate strings.
pennyworth -v, [version]  # Show version.

For string options, type: pennyworth help string

-d, [--downcase=one two three]    # Downcase a string.
-u, [--upcase=one two three]      # Upcase a string.
-c, [--capitalize=one two three]  # Capitalize words in a string.
-l, [--length=one two three]      # Answer the length of a string.

While the command line options are nice, the real power comes from running the following command:

pennyworth -i

...which installs the Alfred Workflows to support this gem. You can use the Alfred commands provided by each workflow instead of the CLI. Check each workflows documentation for details by opening Alfred preferences and clicking on the Workflows tab. Each workflow associated with this gem is prefixed with Pennyworth.

Tests

To test, run:

bundle exec rspec spec

Versioning

Read Semantic Versioning for details. Briefly, it means:

• Patch (x.y.Z) - Incremented for small, backwards compatible bug fixes.
• Minor (x.Y.z) - Incremented for new, backwards compatible public API enhancements and/or bug fixes.
• Major (X.y.z) - Incremented for any backwards incompatible public API changes.

Contributions

Read CONTRIBUTING for details.

Credits

Developed by Brooke Kuhlmann at Alchemists

License

Copyright (c) 2012 Alchemists. Read the LICENSE for details.

History

Read the CHANGELOG for details. Built with Gemsmith.