nim-extensions

Extensions for the Nim programming language.

These extensions aim to improve the usability of Nim in practical applications.

Extensions so far include:

OOP macro

This module was modified from the OOP section on the excellent website http://nim-by-example.github.io/

Usage:

import extensions / oop

class BaseObject: # inherits from RootObj
  # attributes/properties
  var
    x: int
    y: float
    
  method override_me(argx: float): int =
    result = int(argx) + self.x
    
class ClassName of BaseObject:
    method method_name(arg1: int, arg2: float=0.3): float =
      ## do stuff here
      result = arg2
      
    method override_me(argx: float): int =
      result = int(self.y) + int(argx) + self.x

There's also an example in the code that demonstrates the inheritance that can be run by executing:

nim c -r tests/test1.nim

Enumerate

This macro is useful for enumerating on any iterator. It will autodetect which iterator you want to use and give you a useful enumeration.

Usage:

import os
import extensions / enumerate

for i, line in enumerate(lines, "file.txt"):
    echo i, " ", line

for i, tup in enumerate(walkDir, "."):
    echo i, " ", tup

Objprint

These printing procs are useful for printing objects and their types.

import extensions / objprint

type Unit = ref object
  name: string

echo Unit(name: "Ref")
echo Unit(name: "Non-ref")[]
echo (str: "value")

# Prints:
#  ref Unit(name: "Ref")
#  Unit(name: "Non-ref")
#  tuple[str: string](str: "value")