Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 61 additions & 0 deletions .github/workflows/main.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
name: CI

on: push

# Set the GITHUB_TOKEN to a restricted permission we don't need anything else than this.
# This will disable all other permissions than metadata: read, which is always enabled.
permissions:
contents: read

jobs:
test:
runs-on: ubuntu-latest
name: OTP ${{ matrix.otp }} / Elixir ${{ matrix.elixir }}
strategy:
fail-fast: false
matrix:
otp: [26, 27, 28]
elixir: [1.17.x, 1.18.x]
exclude:
- otp: 28
elixir: 1.17.x
env:
MIX_ENV: test
cache_version: v3

steps:
- uses: actions/checkout@v4
name: Checkout

- uses: actions/cache@v4
name: Cache deps
with:
path: deps
key: deps-${{ env.cache_version }}-${{ runner.os }}-mix-${{ hashFiles('mix.lock') }}
restore-keys: deps-${{ env.cache_version }}-${{ runner.os }}

- uses: actions/cache@v4
name: Cache _build
with:
path: _build
key: build-erlef-${{ env.cache_version }}-${{ runner.os }}-${{ matrix.otp }}-${{ matrix.elixir }}-${{ hashFiles('mix.lock') }}
restore-keys: build-erlef-${{ env.cache_version }}-${{ runner.os }}-${{ matrix.otp }}-${{ matrix.elixir }}

- uses: erlef/setup-elixir@v1
name: Setup elixir
with:
otp-version: ${{matrix.otp}}
elixir-version: ${{matrix.elixir}}

- run: mix deps.get

- name: Check that no unused deps exist
run: |
mix deps.clean --unused --unlock
git diff --exit-code

- run: mix compile
- run: mix test --trace --include skip
- run: mix credo
- run: mix dialyzer
- run: mix format --check-formatted
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -5,3 +5,6 @@ erl_crash.dump
/doc
/docs
/bench/snapshots

# file created by macOS
*.DS_Store
2 changes: 2 additions & 0 deletions .tool-versions
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
elixir 1.18.4-otp-28
erlang 28.0.2
29 changes: 0 additions & 29 deletions .travis.yml

This file was deleted.

160 changes: 160 additions & 0 deletions inflex_README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,160 @@
# Inflex

<!-- MDOC !-->

[![Build Status](https://travis-ci.org/nurugger07/inflex.svg?branch=master)](https://travis-ci.org/nurugger07/inflex)
[![Module Version](https://img.shields.io/hexpm/v/inflex.svg)](https://hex.pm/packages/inflex)
[![Hex Docs](https://img.shields.io/badge/hex-docs-lightgreen.svg)](https://hexdocs.pm/inflex/)
[![Total Download](https://img.shields.io/hexpm/dt/inflex.svg)](https://hex.pm/packages/inflex)
[![License](https://img.shields.io/hexpm/l/inflex.svg)](https://github.com/nurugger07/inflex/blob/master/LICENSE)
[![Last Updated](https://img.shields.io/github/last-commit/nurugger07/inflex.svg)](https://github.com/nurugger07/inflex/commits/master)


An Elixir library for handling word inflections.

## Getting Started

You can add Inflex as a dependency in your `mix.exs` file. Since it only requires Elixir and Erlang there are no other dependencies.

```elixir
def deps do
[
{:inflex, "~> 2.0.0"}
]
end
```

If you are not using [hex](http://hex.pm) you can add the dependency using the GitHub repository.

```elixir
def deps do
[
{:inflex, github: "nurugger07/inflex"}
]
end
```

Then run `mix deps.get` in the shell to fetch and compile the dependencies.

### Requirements

Although Inflex supports Elixir 1.6, which is [compatible](https://hexdocs.pm/elixir/compatibility-and-deprecations.html#compatibility-between-elixir-and-erlang-otp) with Erlang/OTP 19–20, [Inflex requires Erlang/OTP 20+](https://github.com/nurugger07/inflex/blob/master/lib/inflex/parameterize.ex#L21).


To incorporate Inflex in your modules, use `import`.

```elixir
defmodule Blog do
import Inflex

def greeting(count), do: "You are the #{ordinalize(count)} visitor!"

end
```

## Examples

### Singularize & Pluralize

Here are some basic examples from `iex`:

```elixir

iex(1)> Inflex.singularize("dogs")
"dog"

iex(2)> Inflex.pluralize("dog")
"dogs"

iex(3)> Inflex.singularize("people")
"person"

iex(4)> Inflex.pluralize("person")
"people"
```

Some other special cases are handled for nouns ending in -o and -y

```elixir
iex(1)> Inflex.pluralize("piano")
"pianos"

iex(2)> Inflex.pluralize("hero")
"heroes"

iex(3)> Inflex.pluralize("butterfly")
"butterflies"

iex(4)> Inflex.pluralize("monkey")
"monkeys"
```

### Inflect

```elixir
iex(1)> Inflex.inflect("child", 1)
"child"

iex(2)> Inflex.inflect("child", 2)
"children"
```

### Camelize & Pascalize

Inflex also camelizes or pascalizes strings and atoms.

```elixir
iex(1)> Inflex.camelize(:upper_camel_case)
"UpperCamelCase"

iex(2)> Inflex.camelize("pascal-case", :lower)
"pascalCase"
```

### Parameterize

Strings can be parameterized easily.

```elixir
iex(1)> Inflex.parameterize("String for parameter")
"string-for-parameter"

iex(2)> Inflex.parameterize("String with underscore", "_")
"string_with_underscore"
```

### Underscore

Makes an underscored, lowercase form from a string or atom.

```elixir
iex(1)> Inflex.underscore("UpperCamelCase")
"upper_camel_case"

iex(2)> Inflex.underscore("pascalCase")
"pascal_case"

iex(3)> Inflex.underscore(UpperCamelCase)
"upper_camel_case"

iex(4)> Inflex.underscore(:pascalCase)
"pascal_case"
```

## Contributing

All pull requests will be reviewed for inclusion but must include tests.

## License

Copyright (c) 2013 Johnny Winn

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at [http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Loading