# 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: 
  
  ```nim
  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:
  ```bash
  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:

  ```nim
  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.

```nim
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")
```