OPEN SOURCE

Shape the next
facet.

Facets was made by Rubyists sharing useful ideas. There is room for better methods, better tests, clearer docs, and thoughtful bug reports.

GET INVOLVED

Start where you are.

Browse the source to see how extensions are organized, or open an issue when something could work better.

Explore the code

See the core, standard, and developing Rails-compatible libraries, plus tests and demos, in the GitHub repository.

Report an issue

Share a reproducible bug, a documentation gap, or an idea for a generally useful extension.

Read the guide

Learn the project's conventions for method files, tests, demos, and pull requests.

DEVELOP LOCALLY

From idea
to test.

Core extensions live under lib/core/facets, standard library extensions under lib/standard/facets, and unreleased Rails-compatible helpers under lib/rails/facets. Keep focused changes close to their tests and demos.

Contribution conventions

TERMINAL

git clone https://github.com/rubyworks/facets.git
cd facets
bundle install
bundle exec rake test

PEOPLE & LICENSE

Built together.

Thomas Sawyer began Facets in 2004, building on a methods library he started in 2002. Many contributors have shaped its methods, tests, and documentation since then. Credits for individual pieces appear in the source, and the collection is distributed under the BSD 2-Clause License.

Read the license

Shape the nextfacet.