Minimalist web application to conjugate Norwegian verbs.
Ruby
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
data
lib
spec
util
.gitignore
Gemfile
Gemfile.lock
LICENCE
README.md
config.ru

README.md

Grokily

A minimalist web application to help you conjugate Norwegian Bokmål verbs.

Installation

Grab a copy of the source by cloning the repo or downloading a zip. Next, install dependencies using bundler:

$ bundle install 

That's all the setup you need to do. To run the application, just type:

$ rackup -p4567

Usage

Assuming that you're running Grokily using the above command, all URLs start with http://localhost:4567/.

You can see a list of availabe languages at:

http://localhost:4567/languages
http://localhost:4567/languages.json

You can see a list of supported verbs for any given language (using Norsk as an example) at:

http://localhost:4567/norsk/verbs
http://localhost:4567/norsk/verbs.json

You can see a list of available tenses for any given language (using Norsk as an example) at:

http://localhost:4567/norsk/tenses
http://localhost:4567/norsk/tenses.json

Tenses can be specified using English tense names or those of the target language.

You can see a list of available subject for any given language (using Norsk as an example) at:

http://localhost:4567/norsk/subjects
http://localhost:4567/norsk/subjects.json

Once you've picked a language, verb and tense, you can ask Grokily to conjugate it. To do so, start with http://localhost:4567/norsk/ followed by the infinitive, the tense and (optionally) a subject. For example, you could try:

http://localhost:4567/norsk/be/presens

http://localhost:4567/norsk/begynne/futurum/jeg

http://localhost:4567/norsk/arbeide/imperative

http://localhost:4567/norsk/glede/present/det

As before, you can append .json to any of the aforementioned URLs to get a JSON response rather than plain text.

Roadmap

At present, available tenses are:

  • present / presens
  • past / fortid
  • future / futurum
  • stem / demme
  • imperative / viktig

In due course, the API will be extended to include additional tenses:

  • present-perfect / presens-perfekt
  • past-perfect / fortid-perfekt
  • future-perfect / futurum-perfekt

Improvements? Ideas?

This API is primarily intended to help me hone my Ruby skills and learn a little more Norwegian. But if you have a specific feature request or if you found a bug, please give me a shout. And of course, please feel free to fork the code or the data and send a pull request with improvements.

Skål!

"Grokily Code Climate Rating"