sabi 0.1.1

A simple module to translate plain English to Nigerian (Naija) pidgin English.

A simple module to translate plain English to Nigerian (Naija) pidgin English.

I had been planning on writing a Python package (academic reasons) and had been researching. Then I encountered arrr.py while doing some Python study - so I decided, why not? And the result? na you SABI.

There is the pidginUNMT project, which is more than capable for the job, but then - there’s numpy and there’s pandas.

sabi - tok like sabi pesin

Installation

To install using pip, run:

$ pip install sabi

Usage Example

Here are some examples of how to use the sabi package:

• A simple translation

  from sabi import translate
  
  text = "Hello World"
  pidgin = translate(text)
  print(pidgin)

• Translating from a file into another file

  from sabi import Translator
  
  with Translator('english.txt', 'pidgin.txt', ajasa=False) as translated:
      if translated is True:
          print('Translated!')

• Using a decorator

  from sabi import translator
  
  @translator(ajasa=True)
  def word(text: str) -> str:
      return text
  
  word("How are you")

Trivial right? Uuugh! I know.

Command-line Usage

After installing sabi, you can run it from your shell as follows:

• Translate text

  $ sabi --oyinbo 'how are you'

  This command will translate the text how are you into its pidgin equivalent.

• Translate a file

  $ sabi --long-tok english.txt

  This command translates the entire file english.txt located in the current working directory.

• Help text

  To print the help text, use:

  $ sabi -h
  $ sabi --help

  And for the sabi specific help text, use:

  $ sabi

Contribution

This project is still quite buggy and is under active development. Contributing to this project would be greatly appreciated. Currently, there are no codes of conduct (working on it).

The source code for this project is hosted on GitHub: https://github.com/techkaduna/sabi. Everyone is free to contribute, and I’d really appreciate it.

Authors

• Kolawole Olalekan ([e-mail])